]> git.donarmstrong.com Git - lilypond.git/blob - lily/lily-guile.cc
a5cd70e2e9f92ebacd1b3642e9438d121af5b3b8
[lilypond.git] / lily / lily-guile.cc
1 /*
2   lily-guile.cc -- implement assorted guile functions
3
4   source file of the GNU LilyPond music typesetter
5
6   (c) 1998--2004 Jan Nieuwenhuizen <janneke@gnu.org>
7                  Han-Wen Nienhuys <hanwen@cs.uu.nl>
8 */
9
10 #include "lily-guile.hh"
11
12 #include <cstdio>
13 #include <cstdlib>
14 #include <math.h>   /* isinf */
15 #include <cstring> /* strdup, strchr */
16 #include <cctype>
17
18 #include <libintl.h>            // gettext on macos x
19
20 #include "version.hh"
21
22 /* MacOS S fix:
23    source-file.hh includes cmath which undefines isinf and isnan
24 */
25 #ifdef __APPLE__
26 inline int my_isinf (Real r) { return isinf (r); }
27 inline int my_isnan (Real r) { return isnan (r); }
28 #endif
29
30 #include "libc-extension.hh"
31 #include "main.hh"
32 #include "file-path.hh"
33 #include "warn.hh"
34 #include "direction.hh"
35 #include "offset.hh"
36 #include "pitch.hh"
37 #include "dimensions.hh"
38 #include "source-file.hh"
39
40 // #define TEST_GC
41
42 SCM
43 ly_to_symbol (SCM scm)
44 {
45   return scm_string_to_symbol (ly_to_string (scm));
46 }
47
48 SCM
49 ly_to_string (SCM scm)
50 {
51   return scm_call_3 (ly_scheme_function ("format"), SCM_BOOL_F,
52                      scm_makfrom0str ("~S"), scm);
53 }
54
55 SCM
56 ly_last (SCM list)
57 {
58   return scm_car (scm_last_pair (list));
59 }
60
61 SCM
62 ly_write2scm (SCM s)
63 {
64   SCM port = scm_mkstrport (SCM_INUM0, 
65                             scm_make_string (SCM_INUM0, SCM_UNDEFINED),
66                             SCM_OPN | SCM_WRTNG,
67                             "ly_write2string");
68   //  SCM write = scm_eval_3 (ly_symbol2scm ("write"), s, SCM_EOL);
69   SCM write = scm_primitive_eval (ly_symbol2scm ("write"));
70   
71   // scm_apply (write, port, SCM_EOL);
72   scm_call_2 (write, s, port);
73   return scm_strport_to_string (port);
74 }
75
76 SCM
77 ly_quote_scm (SCM s)
78 {
79   return scm_list_n (ly_symbol2scm ("quote"), s, SCM_UNDEFINED);
80 }
81
82 String
83 ly_symbol2string (SCM s)
84 {
85   /*
86     Ugh. this is not very efficient.
87    */
88   SCM str = scm_symbol_to_string (s);
89   return ly_scm2string (str);
90 }
91
92 String
93 gulp_file_to_string (String fn, bool must_exist)
94 {
95   String s = global_path.find (fn);
96   if (s == "")
97     {
98       if (must_exist)
99         {
100           String e = _f ("can't find file: `%s'", fn);
101           e += " ";
102           e += _f ("(load path: `%s')", global_path.to_string ());
103           error (e);
104           /* unreachable */
105         }
106       return s;
107     }
108
109   if (verbose_global_b)
110     progress_indication ("[" + s);
111
112   int n;
113   char *str = gulp_file (s, &n);
114   String result ((Byte*) str, n);
115   delete[] str;
116   
117   if (verbose_global_b)
118     progress_indication ("]");
119
120   return result;
121 }
122
123 LY_DEFINE (ly_gulp_file, "ly:gulp-file",
124            1, 0, 0, (SCM name),
125            "Read the file @var{name}, and return its contents in a string.  "
126            "The file is looked up using the search path.")
127 {
128   SCM_ASSERT_TYPE (scm_is_string (name), name, SCM_ARG1, __FUNCTION__, "string");
129   String contents = gulp_file_to_string (ly_scm2string (name), true);
130   return scm_from_locale_stringn (contents.get_str0 (), contents.length ());
131 }
132
133
134 extern "C" {
135   // maybe gdb 5.0 becomes quicker if it doesn't do fancy C++ typing?
136 void
137 ly_display_scm (SCM s)
138 {
139   scm_display (s, scm_current_output_port ());
140   scm_newline (scm_current_output_port ());
141 }
142 };
143
144 String
145 ly_scm2string (SCM str)
146 {
147   assert (scm_is_string (str));
148   return String ((Byte*)scm_i_string_chars (str),
149                  (int) scm_i_string_length (str));
150 }
151
152 char *
153 ly_scm2newstr (SCM str, size_t *lenp)
154 {
155   SCM_ASSERT_TYPE (scm_is_string (str), str, SCM_ARG1, __FUNCTION__, "string");
156
157   size_t len = SCM_STRING_LENGTH (str);
158   if (char *new_str = (char *) malloc ((len + 1) * sizeof (char)))
159     {
160       memcpy (new_str, scm_i_string_chars (str), len);
161       new_str[len] = '\0';
162
163       if (lenp)
164         *lenp = len;
165       
166       return new_str;
167     }
168   return 0;
169 }
170
171 SCM
172 index_get_cell (SCM s, Direction d)
173 {
174   
175   assert (d);
176   return (d == LEFT) ? scm_car (s) : scm_cdr (s);
177 }
178
179 SCM
180 index_set_cell (SCM s, Direction d, SCM v)
181 {
182   if (d == LEFT)
183     scm_set_car_x (s, v);
184   else if (d == RIGHT)
185     scm_set_cdr_x (s, v);
186   return s;
187 }
188   
189 LY_DEFINE (ly_warn, "ly:warn",
190            1, 0, 1, (SCM str, SCM rest),
191            "Scheme callable function to issue the warning @code{msg}. "
192            "The message is formatted with @code{format} and @code{rest}.")
193 {
194   SCM_ASSERT_TYPE (scm_is_string (str), str, SCM_ARG1, __FUNCTION__, "string");
195   progress_indication ("\n");
196
197   str = scm_simple_format (SCM_BOOL_F, str, rest);
198   warning ("lily-guile: " + ly_scm2string (str));
199   return SCM_UNSPECIFIED;
200 }
201
202 LY_DEFINE (ly_programming_error, "ly:programming-error",
203            1, 0, 1, (SCM str, SCM rest),
204            "Scheme callable function to issue the warning @code{msg}. "
205            "The message is formatted with @code{format} and @code{rest}.")
206 {
207   SCM_ASSERT_TYPE (scm_is_string (str), str, SCM_ARG1, __FUNCTION__, "string");
208   progress_indication ("\n");
209
210   str = scm_simple_format (SCM_BOOL_F, str, rest);
211   programming_error (ly_scm2string (str));
212   return SCM_UNSPECIFIED;
213 }
214
215 LY_DEFINE (ly_dir_p, "ly:dir?",
216            1, 0, 0, (SCM s),
217           "type predicate. A direction is @code{-1}, @code{0} or "
218            "@code{1}, where @code{-1} represents "
219           "left or down and @code{1} represents right or up.")
220 {
221   if (scm_is_number (s))
222     {
223       int i = scm_to_int (s);
224       return (i>= -1 && i <= 1)  ? SCM_BOOL_T : SCM_BOOL_F; 
225     }
226   return SCM_BOOL_F;
227 }
228
229 bool
230 is_number_pair (SCM p)
231 {
232   return scm_is_pair (p)
233     && scm_is_number (scm_car (p)) && scm_is_number (scm_cdr (p));
234 }
235
236 typedef void (*Void_fptr) ();
237 Array<Void_fptr> *scm_init_funcs_;
238
239 void add_scm_init_func (void (*f) ())
240 {
241   if (!scm_init_funcs_)
242     scm_init_funcs_ = new Array<Void_fptr>;
243
244   scm_init_funcs_->push (f);
245 }
246
247 void
248 ly_init_ly_module (void *)
249 {
250   for (int i = scm_init_funcs_->size () ; i--;)
251     (scm_init_funcs_->elem (i)) ();
252
253   if (verbose_global_b)
254     progress_indication ("\n");
255   
256   scm_primitive_load_path (scm_makfrom0str ("lily.scm"));
257 }
258
259 SCM global_lily_module;
260
261 void
262 ly_c_init_guile ()
263 {
264   global_lily_module = scm_c_define_module ("lily", ly_init_ly_module, 0);
265   scm_c_use_module ("lily");
266 }
267
268 unsigned int
269 ly_scm_hash (SCM s)
270 {
271   return scm_ihashv (s, ~1u);
272 }
273
274 bool
275 is_direction (SCM s)
276 {
277   if (scm_is_number (s))
278     {
279       int i = scm_to_int (s);
280       return i>= -1 && i <= 1; 
281     }
282   return false;
283 }
284
285 LY_DEFINE (ly_assoc_get, "ly:assoc-get",
286            2, 1, 0,
287            (SCM key, SCM alist, SCM default_value),
288            "Return value if KEY in ALIST, else DEFAULT-VALUE "
289            "(or #f if not specified).")
290 {
291   SCM handle = scm_assoc (key, alist);
292
293   if (default_value == SCM_UNDEFINED)
294     default_value = SCM_BOOL_F;
295   
296   if (scm_is_pair (handle))
297     return scm_cdr (handle);
298   else
299     return default_value;
300 }
301
302 bool
303 is_axis (SCM s)
304 {
305   if (scm_is_number (s))
306     {
307       int i = scm_to_int (s);
308       return i == 0 || i == 1;
309     }
310   return false;
311 }
312
313 Direction
314 to_dir (SCM s)
315 {
316   return scm_is_integer (s) ? (Direction) scm_to_int (s) : CENTER;
317 }
318
319 Interval
320 ly_scm2interval (SCM p)
321 {
322   return Interval (scm_to_double (scm_car (p)), scm_to_double (scm_cdr (p)));
323 }
324
325 Drul_array<Real>
326 ly_scm2realdrul (SCM p)
327 {
328   return Drul_array<Real> (scm_to_double (scm_car (p)),
329                            scm_to_double (scm_cdr (p)));
330 }
331
332 SCM
333 ly_interval2scm (Drul_array<Real> i)
334 {
335   return scm_cons (scm_make_real (i[LEFT]), scm_make_real (i[RIGHT]));
336 }
337
338 bool
339 to_boolean (SCM s)
340 {
341   return scm_is_bool (s) && ly_scm2bool (s);
342 }
343
344 /* Appendable list L: the cdr contains the list, the car the last cons
345    in the list.  */
346 SCM
347 appendable_list ()
348 {
349   SCM s = scm_cons (SCM_EOL, SCM_EOL);
350   scm_set_car_x (s, s);
351   
352   return s;
353 }
354
355 void
356 appendable_list_append (SCM l, SCM elt)
357 {
358   SCM newcons = scm_cons (elt, SCM_EOL);
359   
360   scm_set_cdr_x (scm_car (l), newcons);      
361   scm_set_car_x (l, newcons);
362 }
363
364 SCM
365 ly_offset2scm (Offset o)
366 {
367   return scm_cons (scm_make_real (o[X_AXIS]), scm_make_real (o[Y_AXIS]));
368 }
369
370 Offset
371 ly_scm2offset (SCM s)
372 {
373   return Offset (scm_to_double (scm_car (s)),
374                  scm_to_double (scm_cdr (s)));
375 }
376
377 LY_DEFINE (ly_number2string, "ly:number->string",
378            1, 0, 0, (SCM s),
379            "Convert @var{num} to a string without generating many decimals.")
380 {
381   SCM_ASSERT_TYPE (scm_is_number (s), s, SCM_ARG1, __FUNCTION__, "number");
382
383   char str[400];                        // ugh.
384
385   if (scm_exact_p (s) == SCM_BOOL_F)
386     {
387       Real r (scm_to_double (s));
388 #ifdef __APPLE__
389       if (my_isinf (r) || my_isnan (r))
390 #else
391       if (isinf (r) || isnan (r))
392 #endif
393         {
394           programming_error ("Infinity or NaN encountered while converting Real number; setting to zero.");
395           r = 0.0;
396         }
397
398       sprintf (str, "%08.4f", r);
399     }
400   else
401     sprintf (str, "%d", scm_to_int (s));
402
403   return scm_makfrom0str (str);
404 }
405
406
407
408 LY_DEFINE (ly_version,  "ly:version", 0, 0, 0, (),
409           "Return the current lilypond version as a list, e.g. @code{(1 3 127 uu1)}. ")
410 {
411   char const* vs = "\'(" MAJOR_VERSION " " MINOR_VERSION " "  PATCH_LEVEL " " MY_PATCH_LEVEL ")" ;
412   
413   return scm_c_eval_string ((char*)vs);
414 }
415
416 LY_DEFINE (ly_unit,  "ly:unit", 0, 0, 0, (),
417           "Return the unit used for lengths as a string.")
418 {
419   return scm_makfrom0str (INTERNAL_UNIT);
420 }
421
422
423
424 LY_DEFINE (ly_dimension_p,  "ly:dimension?", 1, 0, 0, (SCM d),
425           "Return @var{d} is a number. Used to distinguish length "
426           "variables from normal numbers.")
427 {
428   return scm_number_p (d);
429 }
430
431 SCM
432 ly_deep_copy (SCM src)
433 {
434   if (scm_is_pair (src))
435     return scm_cons (ly_deep_copy (scm_car (src)), ly_deep_copy (scm_cdr (src)));
436   else if (ly_c_vector_p (src))
437     {
438       int len = SCM_VECTOR_LENGTH (src);
439       SCM nv = scm_c_make_vector (len, SCM_UNDEFINED);
440       for (int i = 0 ;i < len ; i++)
441         {
442           SCM si = scm_int2num (i);
443           scm_vector_set_x (nv, si, ly_deep_copy (scm_vector_ref (src, si))); 
444         }
445     }
446   return src;
447 }
448
449 SCM
450 ly_chain_assoc_get (SCM key, SCM achain, SCM dfault)
451 {
452   if (scm_is_pair (achain))
453     {
454       SCM handle = scm_assoc (key, scm_car (achain));
455       if (scm_is_pair (handle))
456         return scm_cdr (handle);
457       else
458         return ly_chain_assoc (key, scm_cdr (achain));
459     }
460   else
461     return dfault;
462 }
463
464 SCM
465 ly_chain_assoc (SCM key, SCM achain)
466 {
467   if (scm_is_pair (achain))
468     {
469       SCM handle = scm_assoc (key, scm_car (achain));
470       if (scm_is_pair (handle))
471         return handle;
472       else
473         return ly_chain_assoc (key, scm_cdr (achain));
474     }
475   else
476     return SCM_BOOL_F;
477 }
478
479 /* looks the key up in the cdrs of the alist-keys
480    - ignoring the car and ignoring non-pair keys.
481    Returns first match found, i.e.
482
483    alist = ((1 . 10)
484                    ((1 . 2) . 11)
485                    ((2 . 1) . 12)
486                    ((3 . 0) . 13)
487                    ((4 . 1) . 14) )
488
489 I would like (ly_assoc_cdr 1) to return 12 - because it's the first
490 element with the cdr of the key = 1.  In other words (alloc_cdr key)
491 corresponds to call
492
493 (alloc (anything . key))
494
495
496
497 */
498 SCM
499 ly_assoc_cdr (SCM key, SCM alist)
500 {
501   if (scm_is_pair (alist))
502     {
503       SCM trykey = scm_caar (alist);
504       if (scm_is_pair (trykey) && to_boolean (scm_equal_p (key, scm_cdr (trykey))))
505         return scm_car (alist);
506       else
507         return ly_assoc_cdr (key, scm_cdr (alist));
508     }
509   return SCM_BOOL_F;
510 }
511
512 /* LST has the form "sym1 sym2 sym3\nsym4\nsym5"
513    i.e. \n and ' ' can be used interchangeably as separators.  */
514 SCM
515 parse_symbol_list (char const *lst)
516 {
517   char *s = strdup (lst);
518   char *orig = s;
519   SCM create_list = SCM_EOL;
520
521   char * e = s + strlen (s) - 1;
522   while (e >= s && isspace (*e))
523     *e-- = 0;
524
525   for (char * p = s; *p; p++)
526     if (*p == '\n')
527       *p = ' ';
528   
529   if (!s[0])
530     s = 0;
531   
532   while (s)
533     {
534       char *next = strchr (s, ' ');
535       if (next)
536         *next++ = 0;
537
538       create_list = scm_cons (ly_symbol2scm (s), create_list);
539       s = next;
540     }
541
542   free (orig);
543   return create_list;
544 }
545
546 SCM
547 ly_truncate_list (int k, SCM lst)
548 {
549   if (k == 0)
550     lst = SCM_EOL;
551   else
552     {
553       SCM s = lst;
554       k--;
555       for (; scm_is_pair (s) && k--; s = scm_cdr (s))
556         ;
557
558       if (scm_is_pair (s))
559         scm_set_cdr_x (s, SCM_EOL);
560     }
561   return lst;
562 }
563
564 String
565 print_scm_val (SCM val)
566 {
567   String realval = ly_scm2string (ly_write2scm (val));
568   if (realval.length () > 200)
569     realval = realval.left_string (100)
570       + "\n :\n :\n"
571       + realval.right_string (100);
572   return realval;        
573 }
574
575 bool
576 type_check_assignment (SCM sym, SCM val,  SCM type_symbol) 
577 {
578   bool ok = true;
579
580   /*
581     Always succeeds.
582
583
584     TODO: should remove #f from allowed vals?
585    */
586   if (val == SCM_EOL || val == SCM_BOOL_F)
587     return ok;
588
589   if (!scm_is_symbol (sym))
590 #if 0
591     return false;
592 #else
593   /*
594     This is used for autoBeamSettings.
595
596     TODO: deprecate the use of \override and \revert for
597     autoBeamSettings?
598
599     or use a symbol autoBeamSettingS?  
600    */
601   return true; 
602 #endif
603   
604   SCM type = scm_object_property (sym, type_symbol);
605
606   if (type != SCM_EOL && !ly_c_procedure_p (type))
607       {
608         warning (_f ("Can't find property type-check for `%s' (%s).",
609                      ly_symbol2string (sym).to_str0 (),
610                      ly_symbol2string (type_symbol).to_str0 ())
611                  + "  " + _ ("Perhaps you made a typing error?"));
612
613         /* Be strict when being anal :) */
614         if (internal_type_checking_global_b)
615           abort ();
616         
617         warning (_ ("Doing assignment anyway."));
618       }
619   else
620     {
621       if (val != SCM_EOL
622           && ly_c_procedure_p (type)
623           && scm_call_1 (type, val) == SCM_BOOL_F)
624         {
625           SCM errport = scm_current_error_port ();
626           ok = false;
627           SCM typefunc = ly_scheme_function ("type-name");
628           SCM type_name = scm_call_1 (typefunc, type);
629
630          
631           scm_puts (_f ("Type check for `%s' failed; value `%s' must be of type `%s'",
632                         ly_symbol2string (sym).to_str0 (),
633                         print_scm_val (val),
634                         ly_scm2string (type_name).to_str0 ()).to_str0 (),
635                     errport);
636           scm_puts ("\n", errport);                   
637         }
638     }
639   return ok;
640 }
641
642
643 /* some SCM abbrevs
644
645    zijn deze nou handig?
646    zijn ze er al in scheme, maar heten ze anders? */
647
648
649 /* Remove doubles from (sorted) list */
650 SCM
651 ly_unique (SCM list)
652 {
653   SCM unique = SCM_EOL;
654   for (SCM i = list; scm_is_pair (i); i = scm_cdr (i))
655     {
656       if (!scm_is_pair (scm_cdr (i))
657           || !ly_c_equal_p (scm_car (i), scm_cadr (i)))
658         unique = scm_cons (scm_car (i), unique);
659     }
660   return scm_reverse_x (unique, SCM_EOL);
661 }
662
663
664 static int
665 scm_default_compare (void const *a, void const *b)
666 {
667   SCM pa = *(SCM*) a;
668   SCM pb = *(SCM*) b;
669   if (pa == pb)
670     return 0;
671   return pa < pb ? -1 : 1;
672 }
673
674 /*  Modify LST in place: qsort it.  */
675 SCM
676 ly_list_qsort_uniq_x (SCM lst)
677 {
678   int len = scm_ilength (lst);
679   SCM *arr = new SCM[len];
680   int k = 0;
681   for (SCM s = lst; SCM_NNULLP (s); s = scm_cdr (s))
682     arr[k++] = scm_car (s);
683
684   assert (k == len);
685   qsort (arr, len, sizeof (SCM), &scm_default_compare);
686
687   SCM *tail = &lst;
688   for (int i = 0; i < len; i++)
689     if (!i || arr[i] != arr[i - 1])
690       {
691         SCM_SETCAR (*tail, arr[i]);
692         tail = SCM_CDRLOC (*tail);
693       }
694
695   *tail = SCM_EOL;
696   delete[] arr;
697
698   return lst; 
699 }
700
701
702 /* tail add */
703 SCM
704 ly_snoc (SCM s, SCM list)
705 {
706   return ly_append2 (list, scm_list_n (s, SCM_UNDEFINED));
707 }
708
709 /* Split list at member s, removing s.
710    Return (BEFORE . AFTER)  */
711 SCM
712 ly_split_list (SCM s, SCM list)
713 {
714   SCM before = SCM_EOL;
715   SCM after = list;
716   for (; scm_is_pair (after);)
717     {
718       SCM i = scm_car (after);
719       after = scm_cdr (after);
720       if (ly_c_equal_p (i, s))
721         break;
722       before = scm_cons (i, before);
723     }
724   return scm_cons ( scm_reverse_x (before, SCM_EOL),  after);
725   
726 }
727
728
729 void
730 taint (SCM *)
731 {
732   /*
733     nop.
734    */
735 }
736
737 /*
738   display stuff without using stack
739  */
740 SCM
741 display_list (SCM s)
742 {
743   SCM p = scm_current_output_port ();
744
745   scm_puts ("(", p);
746   for (; scm_is_pair (s); s = scm_cdr (s))
747     {
748       scm_display (scm_car (s), p);
749       scm_puts (" ", p);      
750     }
751   scm_puts (")", p);
752   return SCM_UNSPECIFIED;
753 }
754
755 Slice
756 int_list_to_slice (SCM l)
757 {
758   Slice s;
759   s.set_empty ();
760   for (; scm_is_pair (l); l = scm_cdr (l))
761     if (scm_is_number (scm_car (l)))
762       s.add_point (scm_to_int (scm_car (l))); 
763   return s;
764 }
765
766 /* Return I-th element, or last elt L. If I < 0, then we take the first
767    element.
768    
769    PRE: length (L) > 0  */
770 SCM
771 robust_list_ref (int i, SCM l)
772 {
773   while (i-- > 0 && scm_is_pair (scm_cdr (l)))
774     l = scm_cdr (l);
775   return scm_car (l);
776 }
777
778 Real
779 robust_scm2double (SCM k, double x)
780 {
781   if (scm_is_number (k))
782     x = scm_to_double (k);
783   return x;
784 }
785
786 Interval
787 robust_scm2interval (SCM k, Drul_array<Real> v)
788 {
789   Interval i;
790   i[LEFT]= v[LEFT];
791   i[RIGHT]= v[RIGHT];
792   if (is_number_pair (k))
793     i = ly_scm2interval (k);
794   return i;
795 }
796
797 Drul_array<Real>
798 robust_scm2drul (SCM k, Drul_array<Real> v)
799 {
800   if (is_number_pair (k))
801     v = ly_scm2interval (k);
802   return v;
803 }
804
805 Offset
806 robust_scm2offset (SCM k, Offset o)
807 {
808   if (is_number_pair (k))
809     o = ly_scm2offset (k);
810   return o;
811 }
812
813 int
814 robust_scm2int (SCM k, int o)
815 {
816   if (scm_integer_p (k) == SCM_BOOL_T)
817     o = scm_to_int (k);
818   return o;
819 }
820
821 SCM
822 alist_to_hashq (SCM alist)
823 {
824   int i = scm_ilength (alist);
825   if (i < 0)
826     return scm_c_make_hash_table (0);
827           
828   SCM tab = scm_c_make_hash_table (i);
829   for (SCM s = alist; scm_is_pair (s); s = scm_cdr (s))
830     {
831       SCM pt = scm_cdar (s);
832       scm_hashq_set_x (tab, scm_caar (s), pt);
833     }
834   return tab; 
835 }
836
837 /*
838   Debugging mem leaks:
839  */
840 LY_DEFINE (ly_protects, "ly:protects",
841            0, 0, 0, (),
842           "Return hash of protected objects.")
843 {
844   return scm_protects;
845 }
846
847 LY_DEFINE (ly_gettext, "ly:gettext",
848            1, 0, 0, (SCM string),
849            "Gettext wrapper.")
850 {
851   SCM_ASSERT_TYPE (scm_is_string (string), string, SCM_ARG1,
852                    __FUNCTION__, "string");
853   return scm_makfrom0str (gettext (scm_i_string_chars (string)));
854 }
855