mirror/guile
mirror/guile
1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-05-31 01:10:24 +02:00
Code Activity

Document scm_str2symbol and scm_mem2symbol.

Browse source
This commit is contained in:
Neil Jerram 2003-04-26 15:30:59 +00:00
parent 63bf8015ab
commit d513f5c6b3
2 changed files with 15 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

3
doc/ref/ChangeLog
View file

@ -1,5 +1,8 @@
2003-04-26 Neil Jerram <neil@ossau.uklinux.net> 2003-04-26 Neil Jerram <neil@ossau.uklinux.net>
* scheme-data.texi (Symbol Primitives): Document scm_str2symbol
and scm_mem2symbol.
* data-rep.texi (Describing a New Type): Clarify that * data-rep.texi (Describing a New Type): Clarify that
scm_make_smob_type_mfpe is deprecated. (Thanks to scm_make_smob_type_mfpe is deprecated. (Thanks to
tomas@fabula.de.) tomas@fabula.de.)

12
doc/ref/scheme-data.texi
View file

@ -2692,6 +2692,18 @@ the case-sensitivity of symbols:
(string->symbol "K. Harper, M.D."))) @result{} #t (string->symbol "K. Harper, M.D."))) @result{} #t
@end lisp @end lisp
From C, there are lower level functions that construct a Scheme symbol
from a null terminated C string or from a sequence of bytes whose length
is specified explicitly.
@deffn {C Function} scm_str2symbol (const char * name)
@deffnx {C Function} scm_mem2symbol (const char * name, size_t len)
Construct and return a Scheme symbol whose name is specified by
@var{name}. For @code{scm_str2symbol} @var{name} must be null
terminated; For @code{scm_mem2symbol} the length of @var{name} is
specified explicitly by @var{len}.
@end deffn
Finally, some applications, especially those that generate new Scheme Finally, some applications, especially those that generate new Scheme
code dynamically, need to generate symbols for use in the generated code dynamically, need to generate symbols for use in the generated
code. The @code{gensym} primitive meets this need: code. The @code{gensym} primitive meets this need: