diff options
Diffstat (limited to 'doc/ref')
-rw-r--r-- | doc/ref/ChangeLog | 7 | ||||
-rwxr-xr-x | doc/ref/api-data.texi | 10 |
2 files changed, 17 insertions, 0 deletions
diff --git a/doc/ref/ChangeLog b/doc/ref/ChangeLog index a64e4361f..d2a6dfa21 100644 --- a/doc/ref/ChangeLog +++ b/doc/ref/ChangeLog @@ -1,3 +1,10 @@ + +2005-12-19 Ludovic Courtès <ludovic.courtes@laas.fr> + + * api-data.texi (Operations Related to Symbols): + Documented `scm_take_locale_symbol ()'. + + 2005-12-15 Kevin Ryde <user42@zip.com.au> * api-evaluation.texi (Fly Evaluation): Add scm_call_4, suggested by 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: |