ffi: new buf-carray function.

* ffi.c (buf_carray): New function.
(ffi_init): Registered buf-carray intrinsic.

* ffi.c (buf_carray): Declared.

* txr.1: Documented.

1 files changed, 18 insertions, 0 deletions

diff --git a/txr.1 b/txr.1
index e005a34b..d3ea01b9 100644
--- a/txr.1
+++ b/txr.1
@@ -58598,6 +58598,24 @@ length of
 .meta carray
 are altered to reflect the current state of the buffer.
 
+.coNP Function @ buf-carray
+.synb
+.mets (buf-carray << carray )
+.syne
+.desc
+The
+.code buf-carray
+function duplicates the underlying storage of
+.meta carray
+and returns that storage represented as an object of
+.code buf
+type.
+
+The storage size is calculated by multiplying the
+.code carray
+object's element size by the number of elements.
+Only that extent of the storage is duplicated.
+
 .coNP Function @ carray-cptr
 .synb
 .mets (carray-cptr < cptr < type <> [ length ])