X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;f=doc%2Fmanual%2Fffi.texinfo;h=ea1399572d271c3c4cea4e9f6143c5a915d5f445;hb=656f994cdddc89af3a99c8af266816b09879df4a;hp=80e6a593dc4470ea706595555fc80f3f43409337;hpb=f4450bdf225af39172d05881069e65fb61a7fd84;p=sbcl.git diff --git a/doc/manual/ffi.texinfo b/doc/manual/ffi.texinfo index 80e6a59..ea13995 100644 --- a/doc/manual/ffi.texinfo +++ b/doc/manual/ffi.texinfo @@ -216,9 +216,9 @@ determine which field is active from context. @item The foreign type specifier @code{(sb-alien:enum @var{name} &rest @var{specs})} describes an enumeration type that maps between integer -values and keywords. If @var{name} is @code{nil}, then the type is +values and symbols. If @var{name} is @code{nil}, then the type is anonymous. Each element of the @var{specs} list is either a Lisp -keyword, or a list @code{(@var{keyword} @var{value})}. @var{value} is +symbol, or a list @code{(@var{symbol} @var{value})}. @var{value} is an integer. If @var{value} is not supplied, then it defaults to one greater than the value for the preceding spec (or to zero if it is the first spec). @@ -282,12 +282,14 @@ return zero values. @item The foreign type specifier @code{sb-alien:c-string} is similar to -@code{(* char)}, but is interpreted as a null-terminated string, and -is automatically converted into a Lisp string when accessed; or if the +@code{(* char)}, but is interpreted as a null-terminated string, and is +automatically converted into a Lisp string when accessed; or if the pointer is C @code{NULL} or @code{0}, then accessing it gives Lisp -@code{nil}. Lisp strings are stored with a trailing NUL -termination, so no copying (either by the user or the implementation) -is necessary when passing them to foreign code. +@code{nil}. Lisp strings of type @code{base-string} are stored with a +trailing NUL termination, so no copying (either by the user or the +implementation) is necessary when passing them to foreign code; strings +of type @code{(simple-array character (*))} are copied by the +implementation as required. Assigning a Lisp string to a @code{c-string} structure field or variable stores the contents of the string to the memory already @@ -1182,8 +1184,8 @@ routine, e.g.: @samp{cc -c test.c && ld -shared -o test.so test.o} (In order to enable incremental loading with some linkers, you may need to say @samp{cc -G 0 -c test.c}) -Once the C code has been compiled, you can start up Lisp and load it -in: @samp{sbcl} Lisp should start up with its normal prompt. +Once the C code has been compiled, you can start up Lisp and load it in: +@samp{sbcl}. Lisp should start up with its normal prompt. Within Lisp, compile the Lisp file. (This step can be done separately. You don't have to recompile every time.)