* Replace function scm_makstr with new function scm_allocate_string.
[bpt/guile.git] / libguile / read.c
index a2caccb..221035f 100644 (file)
@@ -1,4 +1,4 @@
-/*     Copyright (C) 1995,1996,1997, 1999, 2000 Free Software Foundation, Inc.
+/* Copyright (C) 1995,1996,1997,1999,2000,2001 Free Software Foundation, Inc.
  * 
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -79,7 +79,9 @@ scm_option scm_read_opts[] = {
 
 SCM_DEFINE (scm_read_options, "read-options-interface", 0, 1, 0, 
             (SCM setting),
-"")
+           "Option interface for the read options. Instead of using\n"
+           "this procedure directly, use the procedures @code{read-enable},\n"
+           "@code{read-disable}, @code{read-set!} and @var{read-options}.")
 #define FUNC_NAME s_scm_read_options
 {
   SCM ans = scm_options (setting,
@@ -97,7 +99,9 @@ static SCM *scm_read_hash_procedures;
 
 SCM_DEFINE (scm_read, "read", 0, 1, 0, 
             (SCM port),
-"")
+           "Read an s-expression from the input port @var{port}, or from\n"
+           "the current input port if @var{port} is not specified.\n"
+           "Any whitespace before the next token is discarded.")
 #define FUNC_NAME s_scm_read
 {
   int c;
@@ -112,7 +116,7 @@ SCM_DEFINE (scm_read, "read", 0, 1, 0,
     return SCM_EOF_VAL;
   scm_ungetc (c, port);
 
-  tok_buf = scm_makstr (30L, 0);
+  tok_buf = scm_allocate_string (30);
   return scm_lreadr (&tok_buf, port, &copy);
 }
 #undef FUNC_NAME
@@ -123,7 +127,7 @@ char *
 scm_grow_tok_buf (SCM *tok_buf)
 {
   unsigned long int oldlen = SCM_STRING_LENGTH (*tok_buf);
-  SCM newstr = scm_makstr (2 * oldlen, 0);
+  SCM newstr = scm_allocate_string (2 * oldlen);
   unsigned long int i;
 
   for (i = 0; i != oldlen; ++i)
@@ -146,7 +150,7 @@ scm_flush_ws (SCM port, const char *eoferr)
       goteof:
        if (eoferr)
          {
-           if (SCM_FILENAME (port) != SCM_BOOL_F)
+           if (!SCM_FALSEP (SCM_FILENAME (port)))
              scm_misc_error (eoferr,
                              "end of file in ~A",
                              SCM_LIST1 (SCM_FILENAME (port)));
@@ -251,6 +255,7 @@ recsexpr (SCM obj,int line,int column,SCM filename)
 
 static void
 skip_scsh_block_comment (SCM port)
+#define FUNC_NAME "skip_scsh_block_comment"
 {
   /* Is this portable?  Dear God, spare me from the non-eight-bit
      characters.  But is it tasteful?  */
@@ -261,8 +266,7 @@ skip_scsh_block_comment (SCM port)
       int c = scm_getc (port);
 
       if (c == EOF)
-       scm_wta (SCM_UNDEFINED,
-                "unterminated `#! ... !#' comment", "read");
+       SCM_MISC_ERROR ("unterminated `#! ... !#' comment", SCM_EOL);
       history = ((history << 8) | (c & 0xff)) & 0xffffffff;
 
       /* Were the last four characters read "\n!#\n"?  */
@@ -270,6 +274,8 @@ skip_scsh_block_comment (SCM port)
        return;
     }
 }
+#undef FUNC_NAME
+
 
 static SCM scm_get_hash_procedure(int c);
 
@@ -277,6 +283,7 @@ static char s_list[]="list";
 
 SCM 
 scm_lreadr (SCM *tok_buf,SCM port,SCM *copy)
+#define FUNC_NAME "scm_lreadr"
 {
   int c;
   scm_sizet j;
@@ -295,7 +302,7 @@ tryagain_no_flush_ws:
             ? scm_lreadrecparen (tok_buf, port, s_list, copy)
             : scm_lreadparen (tok_buf, port, s_list, copy);
     case ')':
-      scm_wta (SCM_UNDEFINED, "unexpected \")\"", "read");
+      SCM_MISC_ERROR ("unexpected \")\"", SCM_EOL);
       goto tryagain;
     
     case '\'':
@@ -381,8 +388,7 @@ tryagain_no_flush_ws:
 
        case '{':
          j = scm_read_token (c, tok_buf, port, 1);
-         p = scm_intern (SCM_STRING_CHARS (*tok_buf), j);
-         return SCM_CAR (p);
+         return scm_mem2symbol (SCM_STRING_CHARS (*tok_buf), j);
 
        case '\\':
          c = scm_getc (port);
@@ -399,13 +405,13 @@ tryagain_no_flush_ws:
            if (scm_charnames[c]
                && (scm_casei_streq (scm_charnames[c], SCM_STRING_CHARS (*tok_buf))))
              return SCM_MAKE_CHAR (scm_charnums[c]);
-         scm_wta (SCM_UNDEFINED, "unknown # object: #\\", SCM_STRING_CHARS (*tok_buf));
+         SCM_MISC_ERROR ("unknown # object", SCM_EOL);
 
          /* #:SYMBOL is a syntax for keywords supported in all contexts.  */
        case ':':
          j = scm_read_token ('-', tok_buf, port, 0);
-         p = scm_intern (SCM_STRING_CHARS (*tok_buf), j);
-         return scm_make_keyword_from_dash_symbol (SCM_CAR (p));
+         p = scm_mem2symbol (SCM_STRING_CHARS (*tok_buf), j);
+         return scm_make_keyword_from_dash_symbol (p);
 
        default:
        callshrp:
@@ -432,14 +438,15 @@ tryagain_no_flush_ws:
          }
        unkshrp:
          scm_misc_error (s_scm_read, "Unknown # object: ~S",
-                         scm_listify (SCM_MAKE_CHAR (c), SCM_UNDEFINED));
+                         SCM_LIST1 (SCM_MAKE_CHAR (c)));
        }
 
     case '"':
       j = 0;
       while ('"' != (c = scm_getc (port)))
        {
-         SCM_ASSERT (EOF != c, SCM_UNDEFINED, "end of file in ", "string");
+         if (c == EOF)
+           SCM_MISC_ERROR ("end of file in string constant", SCM_EOL);
 
          while (j + 2 >= SCM_STRING_LENGTH (*tok_buf))
            scm_grow_tok_buf (tok_buf);
@@ -501,7 +508,7 @@ tryagain_no_flush_ws:
              c = SCM_STRING_CHARS (*tok_buf)[1];
              goto callshrp;
            }
-         scm_wta (SCM_UNDEFINED, "unknown # object", SCM_STRING_CHARS (*tok_buf));
+         SCM_MISC_ERROR ("unknown # object", SCM_EOL);
        }
       goto tok;
 
@@ -509,8 +516,8 @@ tryagain_no_flush_ws:
       if (SCM_EQ_P (SCM_PACK (SCM_KEYWORD_STYLE), scm_keyword_prefix))
        {
          j = scm_read_token ('-', tok_buf, port, 0);
-         p = scm_intern (SCM_STRING_CHARS (*tok_buf), j);
-         return scm_make_keyword_from_dash_symbol (SCM_CAR (p));
+         p = scm_mem2symbol (SCM_STRING_CHARS (*tok_buf), j);
+         return scm_make_keyword_from_dash_symbol (p);
        }
       /* fallthrough */
     default:
@@ -518,10 +525,11 @@ tryagain_no_flush_ws:
       /* fallthrough */
 
     tok:
-      p = scm_intern (SCM_STRING_CHARS (*tok_buf), j);
-      return SCM_CAR (p);
+      return scm_mem2symbol (SCM_STRING_CHARS (*tok_buf), j);
     }
 }
+#undef FUNC_NAME
+
 
 #ifdef _UNICOS
 _Pragma ("noopt");             /* # pragma _CRI noopt */
@@ -615,6 +623,7 @@ _Pragma ("opt");            /* # pragma _CRI opt */
 
 SCM 
 scm_lreadparen (SCM *tok_buf, SCM port, char *name, SCM *copy)
+#define FUNC_NAME "scm_lreadparen"
 {
   SCM tmp;
   SCM tl;
@@ -630,7 +639,7 @@ scm_lreadparen (SCM *tok_buf, SCM port, char *name, SCM *copy)
       ans = scm_lreadr (tok_buf, port, copy);
     closeit:
       if (')' != (c = scm_flush_ws (port, name)))
-       scm_wta (SCM_UNDEFINED, "missing close paren", "");
+       SCM_MISC_ERROR ("missing close paren", SCM_EOL);
       return ans;
     }
   ans = tl = scm_cons (tmp, SCM_EOL);
@@ -647,10 +656,12 @@ scm_lreadparen (SCM *tok_buf, SCM port, char *name, SCM *copy)
     }
   return ans;
 }
+#undef FUNC_NAME
 
 
 SCM 
 scm_lreadrecparen (SCM *tok_buf, SCM port, char *name, SCM *copy)
+#define FUNC_NAME "scm_lreadrecparen"
 {
   register int c;
   register SCM tmp;
@@ -668,7 +679,7 @@ scm_lreadrecparen (SCM *tok_buf, SCM port, char *name, SCM *copy)
     {
       ans = scm_lreadr (tok_buf, port, copy);
       if (')' != (c = scm_flush_ws (port, name)))
-       scm_wta (SCM_UNDEFINED, "missing close paren", "");
+       SCM_MISC_ERROR ("missing close paren", SCM_EOL);
       return ans;
     }
   /* Build the head of the list structure. */
@@ -692,7 +703,7 @@ scm_lreadrecparen (SCM *tok_buf, SCM port, char *name, SCM *copy)
                                       : tmp,
                                       SCM_EOL));
          if (')' != (c = scm_flush_ws (port, name)))
-           scm_wta (SCM_UNDEFINED, "missing close paren", "");
+           SCM_MISC_ERROR ("missing close paren", SCM_EOL);
          goto exit;
        }
 
@@ -719,6 +730,7 @@ exit:
                                       SCM_EOL));
   return ans;
 }
+#undef FUNC_NAME
 
 
 \f
@@ -727,7 +739,11 @@ exit:
    Scheme, but maybe it will also be used by C code during initialisation.  */
 SCM_DEFINE (scm_read_hash_extend, "read-hash-extend", 2, 0, 0,
             (SCM chr, SCM proc),
-"")
+           "Install the procedure @var{proc} for reading expressions\n"
+           "starting with the character sequence @code{#} and @var{chr}.\n"
+           "@var{proc} will be called with two arguments:  the character\n"
+           "@var{chr} and the port to read further data from. The object\n"
+           "returned will be the return value of @code{read}.")
 #define FUNC_NAME s_scm_read_hash_extend
 {
   SCM this;
@@ -806,7 +822,9 @@ scm_init_read ()
     SCM_CDRLOC (scm_sysintern ("read-hash-procedures", SCM_EOL));
 
   scm_init_opts (scm_read_options, scm_read_opts, SCM_N_READ_OPTIONS);
+#ifndef SCM_MAGIC_SNARFER
 #include "libguile/read.x"
+#endif
 }
 
 /*