diff options
author | Julian Graham <julian.graham@aya.yale.edu> | 2011-01-26 03:32:48 -0500 |
---|---|---|
committer | Julian Graham <julian.graham@aya.yale.edu> | 2011-01-26 03:32:48 -0500 |
commit | c5fc8f8c5645b3ebd1d38320b524ea8ef2480c77 (patch) | |
tree | 151fec79c894b4cbdbdd498c181dd1fa7a6e3252 /doc/ref/api-data.texi | |
parent | a2c36371ce3de246bdb892afd50915ecf450df47 (diff) | |
download | guile-c5fc8f8c5645b3ebd1d38320b524ea8ef2480c77.tar.gz |
Additional documentation for symbol manipulation functions.
* doc/ref/api-data.texi (Symbol Primitives): Document `symbol',
`list->symbol', and `symbol-append'.
Diffstat (limited to 'doc/ref/api-data.texi')
-rwxr-xr-x | doc/ref/api-data.texi | 32 |
1 files changed, 31 insertions, 1 deletions
diff --git a/doc/ref/api-data.texi b/doc/ref/api-data.texi index e9d40bfb5..4835f3028 100755 --- a/doc/ref/api-data.texi +++ b/doc/ref/api-data.texi @@ -4864,7 +4864,37 @@ strings returned by this procedure. Most symbols are created by writing them literally in code. However it is also possible to create symbols programmatically using the following -@code{string->symbol} and @code{string-ci->symbol} procedures: +procedures: + +@deffn {Scheme Procedure} symbol char@dots{} +@rnindex symbol +Return a newly allocated symbol made from the given character arguments. + +@example +(symbol #\x #\y #\z) @result{} xyz +@end example +@end deffn + +@deffn {Scheme Procedure} list->symbol lst +@rnindex list->symbol +Return a newly allocated symbol made from a list of characters. + +@example +(list->symbol '(#\a #\b #\c)) @result{} abc +@end example +@end deffn + +@rnindex symbol-append +@deffn {Scheme Procedure} symbol-append . args +Return a newly allocated symbol whose characters form the +concatenation of the given symbols, @var{args}. + +@example +(let ((h 'hello)) + (symbol-append h 'world)) +@result{} helloworld +@end example +@end deffn @rnindex string->symbol @deffn {Scheme Procedure} string->symbol string |