summaryrefslogtreecommitdiff
path: root/doc/ref/api-data.texi
diff options
context:
space:
mode:
authorHan-Wen Nienhuys <hanwen@lilypond.org>2006-01-24 20:30:09 +0000
committerHan-Wen Nienhuys <hanwen@lilypond.org>2006-01-24 20:30:09 +0000
commitfd0a5bbcb7922fe35a13d1cc87216c6b93f2251e (patch)
tree0addd243ee1258981dae2cb0dd65a7cec391a8d3 /doc/ref/api-data.texi
parent2ca2ffe6b26556dc01677fe0e360f46f30ca8cfd (diff)
downloadguile-fd0a5bbcb7922fe35a13d1cc87216c6b93f2251e.tar.gz
patches by Ludovic Courtès for symbol generation.
Diffstat (limited to 'doc/ref/api-data.texi')
-rwxr-xr-xdoc/ref/api-data.texi10
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/ref/api-data.texi b/doc/ref/api-data.texi
index 042af4521..99cd43a3e 100755
--- a/doc/ref/api-data.texi
+++ b/doc/ref/api-data.texi
@@ -4551,6 +4551,16 @@ terminated; for @code{scm_from_locale_symboln} the length of @var{name} is
specified explicitly by @var{len}.
@end deffn
+@deftypefn {C Function} SCM scm_take_locale_symbol (char *str)
+@deftypefnx {C Function} SCM scm_take_locale_symboln (char *str, size_t len)
+Like @code{scm_from_locale_symbol} and @code{scm_from_locale_symboln},
+respectively, but also frees @var{str} with @code{free} eventually.
+Thus, you can use this function when you would free @var{str} anyway
+immediately after creating the Scheme string. In certain cases, Guile
+can then use @var{str} directly as its internal representation.
+@end deftypefn
+
+
Finally, some applications, especially those that generate new Scheme
code dynamically, need to generate symbols for use in the generated
code. The @code{gensym} primitive meets this need: