From 5c834d64a58d7176ff246431074707f4bf0f2abf Mon Sep 17 00:00:00 2001 From: Kaz Kylheku Date: Tue, 26 Apr 2022 07:53:24 -0700 Subject: doc: FFI string types map null pointer to nil. * txr.1: Document the existing behavior that the various FFI string types map between the null pointer and the nil object. --- txr.1 | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/txr.1 b/txr.1 index 02d4b686..cba901b3 100644 --- a/txr.1 +++ b/txr.1 @@ -79199,7 +79199,9 @@ to close the stream. These FFI types correspond to the C pointer type .codn "char *" , providing automatic conversion between Lisp strings and null-terminated -C strings. +C strings. The null pointer corresponds to the +.B nil +symbol. The related types .codn bstr , @@ -79320,7 +79322,8 @@ C strings, like the family, and the family members have memory management semantics similar to their .code str -counterparts. +counterparts. Likewise, under these types also, the null pointer corresponds to +.codn nil . The .code b @@ -79364,7 +79367,8 @@ The family members of .code wstr have memory management semantics similar to their .code str -counterparts, +counterparts, Likewise, under these types also, the null pointer corresponds to +.codn nil . Note: because wide characters do not require UTF-8 conversion, the .code wstr -- cgit v1.2.3