1 /* Lisp parsing and input streams.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989,
3 1993, 1994, 1995 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
25 #include <sys/types.h>
36 #include "termhooks.h"
40 #include <sys/inode.h>
45 #include <unistd.h> /* to get X_OK */
54 #ifdef LISP_FLOAT_TYPE
60 #endif /* LISP_FLOAT_TYPE */
64 #endif /* HAVE_SETLOCALE */
72 Lisp_Object Qread_char
, Qget_file_char
, Qstandard_input
, Qcurrent_load_list
;
73 Lisp_Object Qvariable_documentation
, Vvalues
, Vstandard_input
, Vafter_load_alist
;
74 Lisp_Object Qascii_character
, Qload
, Qload_file_name
;
75 Lisp_Object Qbackquote
, Qcomma
, Qcomma_at
, Qcomma_dot
, Qfunction
;
77 extern Lisp_Object Qevent_symbol_element_mask
;
79 /* non-zero if inside `load' */
82 /* Directory in which the sources were found. */
83 Lisp_Object Vsource_directory
;
85 /* Search path for files to be loaded. */
86 Lisp_Object Vload_path
;
88 /* This is the user-visible association list that maps features to
89 lists of defs in their load files. */
90 Lisp_Object Vload_history
;
92 /* This is used to build the load history. */
93 Lisp_Object Vcurrent_load_list
;
95 /* Name of file actually being read by `load'. */
96 Lisp_Object Vload_file_name
;
98 /* Function to use for reading, in `load' and friends. */
99 Lisp_Object Vload_read_function
;
101 /* Nonzero means load should forcibly load all dynamic doc strings. */
102 static int load_force_doc_strings
;
104 /* List of descriptors now open for Fload. */
105 static Lisp_Object load_descriptor_list
;
107 /* File for get_file_char to read from. Use by load. */
108 static FILE *instream
;
110 /* When nonzero, read conses in pure space */
111 static int read_pure
;
113 /* For use within read-from-string (this reader is non-reentrant!!) */
114 static int read_from_string_index
;
115 static int read_from_string_limit
;
117 /* This contains the last string skipped with #@. */
118 static char *saved_doc_string
;
119 /* Length of buffer allocated in saved_doc_string. */
120 static int saved_doc_string_size
;
121 /* Length of actual data in saved_doc_string. */
122 static int saved_doc_string_length
;
123 /* This is the file position that string came from. */
124 static int saved_doc_string_position
;
126 /* Nonzero means inside a new-style backquote
127 with no surrounding parentheses.
128 Fread initializes this to zero, so we need not specbind it
129 or worry about what happens to it when there is an error. */
130 static int new_backquote_flag
;
132 /* Handle unreading and rereading of characters.
133 Write READCHAR to read a character,
134 UNREAD(c) to unread c to be read again. */
136 #define READCHAR readchar (readcharfun)
137 #define UNREAD(c) unreadchar (readcharfun, c)
140 readchar (readcharfun
)
141 Lisp_Object readcharfun
;
144 register struct buffer
*inbuffer
;
145 register int c
, mpos
;
147 if (BUFFERP (readcharfun
))
149 inbuffer
= XBUFFER (readcharfun
);
151 if (BUF_PT (inbuffer
) >= BUF_ZV (inbuffer
))
153 c
= *(unsigned char *) BUF_CHAR_ADDRESS (inbuffer
, BUF_PT (inbuffer
));
154 SET_BUF_PT (inbuffer
, BUF_PT (inbuffer
) + 1);
158 if (MARKERP (readcharfun
))
160 inbuffer
= XMARKER (readcharfun
)->buffer
;
162 mpos
= marker_position (readcharfun
);
164 if (mpos
> BUF_ZV (inbuffer
) - 1)
166 c
= *(unsigned char *) BUF_CHAR_ADDRESS (inbuffer
, mpos
);
167 if (mpos
!= BUF_GPT (inbuffer
))
168 XMARKER (readcharfun
)->bufpos
++;
170 Fset_marker (readcharfun
, make_number (mpos
+ 1),
171 Fmarker_buffer (readcharfun
));
174 if (EQ (readcharfun
, Qget_file_char
))
178 /* Interrupted reads have been observed while reading over the network */
179 while (c
== EOF
&& ferror (instream
) && errno
== EINTR
)
188 if (STRINGP (readcharfun
))
191 /* This used to be return of a conditional expression,
192 but that truncated -1 to a char on VMS. */
193 if (read_from_string_index
< read_from_string_limit
)
194 c
= XSTRING (readcharfun
)->data
[read_from_string_index
++];
200 tem
= call0 (readcharfun
);
207 /* Unread the character C in the way appropriate for the stream READCHARFUN.
208 If the stream is a user function, call it with the char as argument. */
211 unreadchar (readcharfun
, c
)
212 Lisp_Object readcharfun
;
216 /* Don't back up the pointer if we're unreading the end-of-input mark,
217 since readchar didn't advance it when we read it. */
219 else if (BUFFERP (readcharfun
))
221 if (XBUFFER (readcharfun
) == current_buffer
)
224 SET_BUF_PT (XBUFFER (readcharfun
), BUF_PT (XBUFFER (readcharfun
)) - 1);
226 else if (MARKERP (readcharfun
))
227 XMARKER (readcharfun
)->bufpos
--;
228 else if (STRINGP (readcharfun
))
229 read_from_string_index
--;
230 else if (EQ (readcharfun
, Qget_file_char
))
231 ungetc (c
, instream
);
233 call1 (readcharfun
, make_number (c
));
236 static Lisp_Object
read0 (), read1 (), read_list (), read_vector ();
238 /* get a character from the tty */
240 extern Lisp_Object
read_char ();
242 /* Read input events until we get one that's acceptable for our purposes.
244 If NO_SWITCH_FRAME is non-zero, switch-frame events are stashed
245 until we get a character we like, and then stuffed into
248 If ASCII_REQUIRED is non-zero, we check function key events to see
249 if the unmodified version of the symbol has a Qascii_character
250 property, and use that character, if present.
252 If ERROR_NONASCII is non-zero, we signal an error if the input we
253 get isn't an ASCII character with modifiers. If it's zero but
254 ASCII_REQUIRED is non-zero, we just re-read until we get an ASCII
258 read_filtered_event (no_switch_frame
, ascii_required
, error_nonascii
)
259 int no_switch_frame
, ascii_required
, error_nonascii
;
262 return make_number (getchar ());
264 register Lisp_Object val
, delayed_switch_frame
;
266 delayed_switch_frame
= Qnil
;
268 /* Read until we get an acceptable event. */
270 val
= read_char (0, 0, 0, Qnil
, 0);
275 /* switch-frame events are put off until after the next ASCII
276 character. This is better than signaling an error just because
277 the last characters were typed to a separate minibuffer frame,
278 for example. Eventually, some code which can deal with
279 switch-frame events will read it and process it. */
281 && EVENT_HAS_PARAMETERS (val
)
282 && EQ (EVENT_HEAD (val
), Qswitch_frame
))
284 delayed_switch_frame
= val
;
290 /* Convert certain symbols to their ASCII equivalents. */
293 Lisp_Object tem
, tem1
, tem2
;
294 tem
= Fget (val
, Qevent_symbol_element_mask
);
297 tem1
= Fget (Fcar (tem
), Qascii_character
);
298 /* Merge this symbol's modifier bits
299 with the ASCII equivalent of its basic code. */
301 XSETFASTINT (val
, XINT (tem1
) | XINT (Fcar (Fcdr (tem
))));
305 /* If we don't have a character now, deal with it appropriately. */
310 Vunread_command_events
= Fcons (val
, Qnil
);
311 error ("Non-character input-event");
318 if (! NILP (delayed_switch_frame
))
319 unread_switch_frame
= delayed_switch_frame
;
325 DEFUN ("read-char", Fread_char
, Sread_char
, 0, 0, 0,
326 "Read a character from the command input (keyboard or macro).\n\
327 It is returned as a number.\n\
328 If the user generates an event which is not a character (i.e. a mouse\n\
329 click or function key event), `read-char' signals an error. As an\n\
330 exception, switch-frame events are put off until non-ASCII events can\n\
332 If you want to read non-character events, or ignore them, call\n\
333 `read-event' or `read-char-exclusive' instead.")
336 return read_filtered_event (1, 1, 1);
339 DEFUN ("read-event", Fread_event
, Sread_event
, 0, 0, 0,
340 "Read an event object from the input stream.")
343 return read_filtered_event (0, 0, 0);
346 DEFUN ("read-char-exclusive", Fread_char_exclusive
, Sread_char_exclusive
, 0, 0, 0,
347 "Read a character from the command input (keyboard or macro).\n\
348 It is returned as a number. Non-character events are ignored.")
351 return read_filtered_event (1, 1, 0);
354 DEFUN ("get-file-char", Fget_file_char
, Sget_file_char
, 0, 0, 0,
355 "Don't use this yourself.")
358 register Lisp_Object val
;
359 XSETINT (val
, getc (instream
));
363 static void readevalloop ();
364 static Lisp_Object
load_unwind ();
365 static Lisp_Object
load_descriptor_unwind ();
367 DEFUN ("load", Fload
, Sload
, 1, 4, 0,
368 "Execute a file of Lisp code named FILE.\n\
369 First try FILE with `.elc' appended, then try with `.el',\n\
370 then try FILE unmodified.\n\
371 This function searches the directories in `load-path'.\n\
372 If optional second arg NOERROR is non-nil,\n\
373 report no error if FILE doesn't exist.\n\
374 Print messages at start and end of loading unless\n\
375 optional third arg NOMESSAGE is non-nil.\n\
376 If optional fourth arg NOSUFFIX is non-nil, don't try adding\n\
377 suffixes `.elc' or `.el' to the specified name FILE.\n\
378 Return t if file exists.")
379 (file
, noerror
, nomessage
, nosuffix
)
380 Lisp_Object file
, noerror
, nomessage
, nosuffix
;
382 register FILE *stream
;
383 register int fd
= -1;
384 register Lisp_Object lispstream
;
385 int count
= specpdl_ptr
- specpdl
;
389 /* 1 means we printed the ".el is newer" message. */
391 /* 1 means we are loading a compiled file. */
395 char *dosmode
= "rt";
398 CHECK_STRING (file
, 0);
400 /* If file name is magic, call the handler. */
401 handler
= Ffind_file_name_handler (file
, Qload
);
403 return call5 (handler
, Qload
, file
, noerror
, nomessage
, nosuffix
);
405 /* Do this after the handler to avoid
406 the need to gcpro noerror, nomessage and nosuffix.
407 (Below here, we care only whether they are nil or not.) */
408 file
= Fsubstitute_in_file_name (file
);
410 /* Avoid weird lossage with null string as arg,
411 since it would try to load a directory as a Lisp file */
412 if (XSTRING (file
)->size
> 0)
415 fd
= openp (Vload_path
, file
, !NILP (nosuffix
) ? "" : ".elc:.el:",
424 Fsignal (Qfile_error
, Fcons (build_string ("Cannot open load file"),
425 Fcons (file
, Qnil
)));
430 if (!bcmp (&(XSTRING (found
)->data
[XSTRING (found
)->size
- 4]),
441 stat ((char *)XSTRING (found
)->data
, &s1
);
442 XSTRING (found
)->data
[XSTRING (found
)->size
- 1] = 0;
443 result
= stat ((char *)XSTRING (found
)->data
, &s2
);
444 if (result
>= 0 && (unsigned) s1
.st_mtime
< (unsigned) s2
.st_mtime
)
446 /* Make the progress messages mention that source is newer. */
449 /* If we won't print another message, mention this anyway. */
450 if (! NILP (nomessage
))
451 message ("Source file `%s' newer than byte-compiled file",
452 XSTRING (found
)->data
);
454 XSTRING (found
)->data
[XSTRING (found
)->size
- 1] = 'c';
459 stream
= fopen ((char *) XSTRING (found
)->data
, dosmode
);
460 #else /* not DOS_NT */
461 stream
= fdopen (fd
, "r");
462 #endif /* not DOS_NT */
466 error ("Failure to create stdio stream for %s", XSTRING (file
)->data
);
469 if (NILP (nomessage
))
472 message ("Loading %s... (compiled; note, source file is newer)",
473 XSTRING (file
)->data
);
475 message ("Loading %s... (compiled)", XSTRING (file
)->data
);
477 message ("Loading %s...", XSTRING (file
)->data
);
481 lispstream
= Fcons (Qnil
, Qnil
);
482 XSETFASTINT (XCONS (lispstream
)->car
, (EMACS_UINT
)stream
>> 16);
483 XSETFASTINT (XCONS (lispstream
)->cdr
, (EMACS_UINT
)stream
& 0xffff);
484 record_unwind_protect (load_unwind
, lispstream
);
485 record_unwind_protect (load_descriptor_unwind
, load_descriptor_list
);
486 specbind (Qload_file_name
, found
);
488 = Fcons (make_number (fileno (stream
)), load_descriptor_list
);
490 readevalloop (Qget_file_char
, stream
, file
, Feval
, 0);
491 unbind_to (count
, Qnil
);
493 /* Run any load-hooks for this file. */
494 temp
= Fassoc (file
, Vafter_load_alist
);
496 Fprogn (Fcdr (temp
));
499 if (saved_doc_string
)
500 free (saved_doc_string
);
501 saved_doc_string
= 0;
502 saved_doc_string_size
= 0;
504 if (!noninteractive
&& NILP (nomessage
))
507 message ("Loading %s...done (compiled; note, source file is newer)",
508 XSTRING (file
)->data
);
510 message ("Loading %s...done (compiled)", XSTRING (file
)->data
);
512 message ("Loading %s...done", XSTRING (file
)->data
);
518 load_unwind (stream
) /* used as unwind-protect function in load */
521 fclose ((FILE *) (XFASTINT (XCONS (stream
)->car
) << 16
522 | XFASTINT (XCONS (stream
)->cdr
)));
523 if (--load_in_progress
< 0) load_in_progress
= 0;
528 load_descriptor_unwind (oldlist
)
531 load_descriptor_list
= oldlist
;
535 /* Close all descriptors in use for Floads.
536 This is used when starting a subprocess. */
543 for (tail
= load_descriptor_list
; !NILP (tail
); tail
= XCONS (tail
)->cdr
)
544 close (XFASTINT (XCONS (tail
)->car
));
549 complete_filename_p (pathname
)
550 Lisp_Object pathname
;
552 register unsigned char *s
= XSTRING (pathname
)->data
;
553 return (IS_DIRECTORY_SEP (s
[0])
554 || (XSTRING (pathname
)->size
> 2
555 && IS_DEVICE_SEP (s
[1]) && IS_DIRECTORY_SEP (s
[2]))
565 /* Search for a file whose name is STR, looking in directories
566 in the Lisp list PATH, and trying suffixes from SUFFIX.
567 SUFFIX is a string containing possible suffixes separated by colons.
568 On success, returns a file descriptor. On failure, returns -1.
570 EXEC_ONLY nonzero means don't open the files,
571 just look for one that is executable. In this case,
572 returns 1 on success.
574 If STOREPTR is nonzero, it points to a slot where the name of
575 the file actually found should be stored as a Lisp string.
576 Nil is stored there on failure. */
579 openp (path
, str
, suffix
, storeptr
, exec_only
)
580 Lisp_Object path
, str
;
582 Lisp_Object
*storeptr
;
588 register char *fn
= buf
;
591 register Lisp_Object filename
;
599 if (complete_filename_p (str
))
602 for (; !NILP (path
); path
= Fcdr (path
))
606 filename
= Fexpand_file_name (str
, Fcar (path
));
607 if (!complete_filename_p (filename
))
608 /* If there are non-absolute elts in PATH (eg ".") */
609 /* Of course, this could conceivably lose if luser sets
610 default-directory to be something non-absolute... */
612 filename
= Fexpand_file_name (filename
, current_buffer
->directory
);
613 if (!complete_filename_p (filename
))
614 /* Give up on this path element! */
618 /* Calculate maximum size of any filename made from
619 this path element/specified file name and any possible suffix. */
620 want_size
= strlen (suffix
) + XSTRING (filename
)->size
+ 1;
621 if (fn_size
< want_size
)
622 fn
= (char *) alloca (fn_size
= 100 + want_size
);
626 /* Loop over suffixes. */
629 char *esuffix
= (char *) index (nsuffix
, ':');
630 int lsuffix
= esuffix
? esuffix
- nsuffix
: strlen (nsuffix
);
632 /* Concatenate path element/specified name with the suffix. */
633 strncpy (fn
, XSTRING (filename
)->data
, XSTRING (filename
)->size
);
634 fn
[XSTRING (filename
)->size
] = 0;
635 if (lsuffix
!= 0) /* Bug happens on CCI if lsuffix is 0. */
636 strncat (fn
, nsuffix
, lsuffix
);
638 /* Ignore file if it's a directory. */
639 if (stat (fn
, &st
) >= 0
640 && (st
.st_mode
& S_IFMT
) != S_IFDIR
)
642 /* Check that we can access or open it. */
644 fd
= (access (fn
, X_OK
) == 0) ? 1 : -1;
646 fd
= open (fn
, O_RDONLY
, 0);
650 /* We succeeded; return this descriptor and filename. */
652 *storeptr
= build_string (fn
);
658 /* Advance to next suffix. */
661 nsuffix
+= lsuffix
+ 1;
672 /* Merge the list we've accumulated of globals from the current input source
673 into the load_history variable. The details depend on whether
674 the source has an associated file name or not. */
677 build_load_history (stream
, source
)
681 register Lisp_Object tail
, prev
, newelt
;
682 register Lisp_Object tem
, tem2
;
683 register int foundit
, loading
;
685 /* Don't bother recording anything for preloaded files. */
686 if (!NILP (Vpurify_flag
))
689 loading
= stream
|| !NARROWED
;
691 tail
= Vload_history
;
698 /* Find the feature's previous assoc list... */
699 if (!NILP (Fequal (source
, Fcar (tem
))))
703 /* If we're loading, remove it. */
707 Vload_history
= Fcdr (tail
);
709 Fsetcdr (prev
, Fcdr (tail
));
712 /* Otherwise, cons on new symbols that are not already members. */
715 tem2
= Vcurrent_load_list
;
719 newelt
= Fcar (tem2
);
721 if (NILP (Fmemq (newelt
, tem
)))
722 Fsetcar (tail
, Fcons (Fcar (tem
),
723 Fcons (newelt
, Fcdr (tem
))));
736 /* If we're loading, cons the new assoc onto the front of load-history,
737 the most-recently-loaded position. Also do this if we didn't find
738 an existing member for the current source. */
739 if (loading
|| !foundit
)
740 Vload_history
= Fcons (Fnreverse (Vcurrent_load_list
),
745 unreadpure () /* Used as unwind-protect function in readevalloop */
752 readevalloop (readcharfun
, stream
, sourcename
, evalfun
, printflag
)
753 Lisp_Object readcharfun
;
755 Lisp_Object sourcename
;
756 Lisp_Object (*evalfun
) ();
760 register Lisp_Object val
;
761 int count
= specpdl_ptr
- specpdl
;
763 struct buffer
*b
= 0;
765 if (BUFFERP (readcharfun
))
766 b
= XBUFFER (readcharfun
);
767 else if (MARKERP (readcharfun
))
768 b
= XMARKER (readcharfun
)->buffer
;
770 specbind (Qstandard_input
, readcharfun
);
771 specbind (Qcurrent_load_list
, Qnil
);
775 LOADHIST_ATTACH (sourcename
);
779 if (b
!= 0 && NILP (b
->name
))
780 error ("Reading from killed buffer");
786 while ((c
= READCHAR
) != '\n' && c
!= -1);
791 /* Ignore whitespace here, so we can detect eof. */
792 if (c
== ' ' || c
== '\t' || c
== '\n' || c
== '\f' || c
== '\r')
795 if (!NILP (Vpurify_flag
) && c
== '(')
797 int count1
= specpdl_ptr
- specpdl
;
798 record_unwind_protect (unreadpure
, Qnil
);
799 val
= read_list (-1, readcharfun
);
800 unbind_to (count1
, Qnil
);
805 if (NILP (Vload_read_function
))
806 val
= read0 (readcharfun
);
808 val
= call1 (Vload_read_function
, readcharfun
);
811 val
= (*evalfun
) (val
);
814 Vvalues
= Fcons (val
, Vvalues
);
815 if (EQ (Vstandard_output
, Qt
))
822 build_load_history (stream
, sourcename
);
825 unbind_to (count
, Qnil
);
830 DEFUN ("eval-buffer", Feval_buffer
, Seval_buffer
, 0, 2, "",
831 "Execute the current buffer as Lisp code.\n\
832 Programs can pass two arguments, BUFFER and PRINTFLAG.\n\
833 BUFFER is the buffer to evaluate (nil means use current buffer).\n\
834 PRINTFLAG controls printing of output:\n\
835 nil means discard it; anything else is stream for print.\n\
837 If there is no error, point does not move. If there is an error,\n\
838 point remains at the end of the last character read from the buffer.")
840 Lisp_Object buffer
, printflag
;
842 int count
= specpdl_ptr
- specpdl
;
843 Lisp_Object tem
, buf
;
846 buf
= Fcurrent_buffer ();
848 buf
= Fget_buffer (buffer
);
850 error ("No such buffer.");
852 if (NILP (printflag
))
856 specbind (Qstandard_output
, tem
);
857 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
858 BUF_SET_PT (XBUFFER (buf
), BUF_BEGV (XBUFFER (buf
)));
859 readevalloop (buf
, 0, XBUFFER (buf
)->filename
, Feval
, !NILP (printflag
));
860 unbind_to (count
, Qnil
);
866 DEFUN ("eval-current-buffer", Feval_current_buffer
, Seval_current_buffer
, 0, 1, "",
867 "Execute the current buffer as Lisp code.\n\
868 Programs can pass argument PRINTFLAG which controls printing of output:\n\
869 nil means discard it; anything else is stream for print.\n\
871 If there is no error, point does not move. If there is an error,\n\
872 point remains at the end of the last character read from the buffer.")
874 Lisp_Object printflag
;
876 int count
= specpdl_ptr
- specpdl
;
877 Lisp_Object tem
, cbuf
;
879 cbuf
= Fcurrent_buffer ()
881 if (NILP (printflag
))
885 specbind (Qstandard_output
, tem
);
886 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
888 readevalloop (cbuf
, 0, XBUFFER (cbuf
)->filename
, Feval
, !NILP (printflag
));
889 return unbind_to (count
, Qnil
);
893 DEFUN ("eval-region", Feval_region
, Seval_region
, 2, 3, "r",
894 "Execute the region as Lisp code.\n\
895 When called from programs, expects two arguments,\n\
896 giving starting and ending indices in the current buffer\n\
897 of the text to be executed.\n\
898 Programs can pass third argument PRINTFLAG which controls output:\n\
899 nil means discard it; anything else is stream for printing it.\n\
901 If there is no error, point does not move. If there is an error,\n\
902 point remains at the end of the last character read from the buffer.")
903 (start
, end
, printflag
)
904 Lisp_Object start
, end
, printflag
;
906 int count
= specpdl_ptr
- specpdl
;
907 Lisp_Object tem
, cbuf
;
909 cbuf
= Fcurrent_buffer ();
911 if (NILP (printflag
))
915 specbind (Qstandard_output
, tem
);
917 if (NILP (printflag
))
918 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
919 record_unwind_protect (save_restriction_restore
, save_restriction_save ());
921 /* This both uses start and checks its type. */
923 Fnarrow_to_region (make_number (BEGV
), end
);
924 readevalloop (cbuf
, 0, XBUFFER (cbuf
)->filename
, Feval
, !NILP (printflag
));
926 return unbind_to (count
, Qnil
);
929 #endif /* standalone */
931 DEFUN ("read", Fread
, Sread
, 0, 1, 0,
932 "Read one Lisp expression as text from STREAM, return as Lisp object.\n\
933 If STREAM is nil, use the value of `standard-input' (which see).\n\
934 STREAM or the value of `standard-input' may be:\n\
935 a buffer (read from point and advance it)\n\
936 a marker (read from where it points and advance it)\n\
937 a function (call it with no arguments for each character,\n\
938 call it with a char as argument to push a char back)\n\
939 a string (takes text from string, starting at the beginning)\n\
940 t (read text line using minibuffer and use it).")
944 extern Lisp_Object
Fread_minibuffer ();
947 stream
= Vstandard_input
;
951 new_backquote_flag
= 0;
954 if (EQ (stream
, Qread_char
))
955 return Fread_minibuffer (build_string ("Lisp expression: "), Qnil
);
958 if (STRINGP (stream
))
959 return Fcar (Fread_from_string (stream
, Qnil
, Qnil
));
961 return read0 (stream
);
964 DEFUN ("read-from-string", Fread_from_string
, Sread_from_string
, 1, 3, 0,
965 "Read one Lisp expression which is represented as text by STRING.\n\
966 Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).\n\
967 START and END optionally delimit a substring of STRING from which to read;\n\
968 they default to 0 and (length STRING) respectively.")
970 Lisp_Object string
, start
, end
;
972 int startval
, endval
;
975 CHECK_STRING (string
,0);
978 endval
= XSTRING (string
)->size
;
980 { CHECK_NUMBER (end
,2);
982 if (endval
< 0 || endval
> XSTRING (string
)->size
)
983 args_out_of_range (string
, end
);
989 { CHECK_NUMBER (start
,1);
990 startval
= XINT (start
);
991 if (startval
< 0 || startval
> endval
)
992 args_out_of_range (string
, start
);
995 read_from_string_index
= startval
;
996 read_from_string_limit
= endval
;
998 new_backquote_flag
= 0;
1000 tem
= read0 (string
);
1001 return Fcons (tem
, make_number (read_from_string_index
));
1004 /* Use this for recursive reads, in contexts where internal tokens
1008 Lisp_Object readcharfun
;
1010 register Lisp_Object val
;
1013 val
= read1 (readcharfun
, &c
, 0);
1015 Fsignal (Qinvalid_read_syntax
, Fcons (make_string (&c
, 1), Qnil
));
1020 static int read_buffer_size
;
1021 static char *read_buffer
;
1024 read_escape (readcharfun
)
1025 Lisp_Object readcharfun
;
1027 register int c
= READCHAR
;
1031 error ("End of file");
1057 error ("Invalid escape character syntax");
1060 c
= read_escape (readcharfun
);
1061 return c
| meta_modifier
;
1066 error ("Invalid escape character syntax");
1069 c
= read_escape (readcharfun
);
1070 return c
| shift_modifier
;
1075 error ("Invalid escape character syntax");
1078 c
= read_escape (readcharfun
);
1079 return c
| hyper_modifier
;
1084 error ("Invalid escape character syntax");
1087 c
= read_escape (readcharfun
);
1088 return c
| alt_modifier
;
1093 error ("Invalid escape character syntax");
1096 c
= read_escape (readcharfun
);
1097 return c
| super_modifier
;
1102 error ("Invalid escape character syntax");
1106 c
= read_escape (readcharfun
);
1107 if ((c
& 0177) == '?')
1109 /* ASCII control chars are made from letters (both cases),
1110 as well as the non-letters within 0100...0137. */
1111 else if ((c
& 0137) >= 0101 && (c
& 0137) <= 0132)
1112 return (c
& (037 | ~0177));
1113 else if ((c
& 0177) >= 0100 && (c
& 0177) <= 0137)
1114 return (c
& (037 | ~0177));
1116 return c
| ctrl_modifier
;
1126 /* An octal escape, as in ANSI C. */
1128 register int i
= c
- '0';
1129 register int count
= 0;
1132 if ((c
= READCHAR
) >= '0' && c
<= '7')
1147 /* A hex escape, as in ANSI C. */
1153 if (c
>= '0' && c
<= '9')
1158 else if ((c
>= 'a' && c
<= 'f')
1159 || (c
>= 'A' && c
<= 'F'))
1162 if (c
>= 'a' && c
<= 'f')
1181 /* If the next token is ')' or ']' or '.', we store that character
1182 in *PCH and the return value is not interesting. Else, we store
1183 zero in *PCH and we read and return one lisp object.
1185 FIRST_IN_LIST is nonzero if this is the first element of a list. */
1188 read1 (readcharfun
, pch
, first_in_list
)
1189 register Lisp_Object readcharfun
;
1199 if (c
< 0) return Fsignal (Qend_of_file
, Qnil
);
1204 return read_list (0, readcharfun
);
1207 return read_vector (readcharfun
);
1224 tmp
= read_vector (readcharfun
);
1225 if (XVECTOR (tmp
)->size
< CHAR_TABLE_STANDARD_SLOTS
1226 || XVECTOR (tmp
)->size
> CHAR_TABLE_STANDARD_SLOTS
+ 10)
1227 error ("Invalid size char-table");
1228 XSETCHAR_TABLE (tmp
, XCHAR_TABLE (tmp
));
1231 Fsignal (Qinvalid_read_syntax
, Fcons (make_string ("#^", 2), Qnil
));
1236 length
= read1 (readcharfun
, pch
, first_in_list
);
1240 Lisp_Object tmp
, val
;
1241 int size_in_chars
= ((XFASTINT (length
) + BITS_PER_CHAR
)
1245 tmp
= read1 (readcharfun
, pch
, first_in_list
);
1246 if (size_in_chars
!= XSTRING (tmp
)->size
)
1247 Fsignal (Qinvalid_read_syntax
,
1248 Fcons (make_string ("#&", 2), Qnil
));
1250 val
= Fmake_bool_vector (length
, Qnil
);
1251 bcopy (XSTRING (tmp
)->data
, XBOOL_VECTOR (val
)->data
,
1255 Fsignal (Qinvalid_read_syntax
, Fcons (make_string ("#&", 2), Qnil
));
1259 /* Accept compiled functions at read-time so that we don't have to
1260 build them using function calls. */
1262 tmp
= read_vector (readcharfun
);
1263 return Fmake_byte_code (XVECTOR (tmp
)->size
,
1264 XVECTOR (tmp
)->contents
);
1266 #ifdef USE_TEXT_PROPERTIES
1270 struct gcpro gcpro1
;
1273 /* Read the string itself. */
1274 tmp
= read1 (readcharfun
, &ch
, 0);
1275 if (ch
!= 0 || !STRINGP (tmp
))
1276 Fsignal (Qinvalid_read_syntax
, Fcons (make_string ("#", 1), Qnil
));
1278 /* Read the intervals and their properties. */
1281 Lisp_Object beg
, end
, plist
;
1283 beg
= read1 (readcharfun
, &ch
, 0);
1287 end
= read1 (readcharfun
, &ch
, 0);
1289 plist
= read1 (readcharfun
, &ch
, 0);
1291 Fsignal (Qinvalid_read_syntax
,
1292 Fcons (build_string ("invalid string property list"),
1294 Fset_text_properties (beg
, end
, plist
, tmp
);
1300 /* #@NUMBER is used to skip NUMBER following characters.
1301 That's used in .elc files to skip over doc strings
1302 and function definitions. */
1307 /* Read a decimal integer. */
1308 while ((c
= READCHAR
) >= 0
1309 && c
>= '0' && c
<= '9')
1317 #ifndef DOS_NT /* I don't know if filepos works right on MSDOS and Windoze. */
1318 if (load_force_doc_strings
&& EQ (readcharfun
, Qget_file_char
))
1320 /* If we are supposed to force doc strings into core right now,
1321 record the last string that we skipped,
1322 and record where in the file it comes from. */
1323 if (saved_doc_string_size
== 0)
1325 saved_doc_string_size
= nskip
+ 100;
1326 saved_doc_string
= (char *) xmalloc (saved_doc_string_size
);
1328 if (nskip
> saved_doc_string_size
)
1330 saved_doc_string_size
= nskip
+ 100;
1331 saved_doc_string
= (char *) xrealloc (saved_doc_string
,
1332 saved_doc_string_size
);
1335 saved_doc_string_position
= ftell (instream
);
1337 /* Copy that many characters into saved_doc_string. */
1338 for (i
= 0; i
< nskip
&& c
>= 0; i
++)
1339 saved_doc_string
[i
] = c
= READCHAR
;
1341 saved_doc_string_length
= i
;
1344 #endif /* not DOS_NT */
1346 /* Skip that many characters. */
1347 for (i
= 0; i
< nskip
&& c
>= 0; i
++)
1353 return Vload_file_name
;
1355 return Fcons (Qfunction
, Fcons (read0 (readcharfun
), Qnil
));
1359 Fsignal (Qinvalid_read_syntax
, Fcons (make_string ("#", 1), Qnil
));
1362 while ((c
= READCHAR
) >= 0 && c
!= '\n');
1367 return Fcons (Qquote
, Fcons (read0 (readcharfun
), Qnil
));
1377 new_backquote_flag
= 1;
1378 value
= read0 (readcharfun
);
1379 new_backquote_flag
= 0;
1381 return Fcons (Qbackquote
, Fcons (value
, Qnil
));
1385 if (new_backquote_flag
)
1387 Lisp_Object comma_type
= Qnil
;
1392 comma_type
= Qcomma_at
;
1394 comma_type
= Qcomma_dot
;
1397 if (ch
>= 0) UNREAD (ch
);
1398 comma_type
= Qcomma
;
1401 new_backquote_flag
= 0;
1402 value
= read0 (readcharfun
);
1403 new_backquote_flag
= 1;
1404 return Fcons (comma_type
, Fcons (value
, Qnil
));
1411 register Lisp_Object val
;
1414 if (c
< 0) return Fsignal (Qend_of_file
, Qnil
);
1417 XSETINT (val
, read_escape (readcharfun
));
1426 register char *p
= read_buffer
;
1427 register char *end
= read_buffer
+ read_buffer_size
;
1431 while ((c
= READCHAR
) >= 0
1436 char *new = (char *) xrealloc (read_buffer
, read_buffer_size
*= 2);
1437 p
+= new - read_buffer
;
1438 read_buffer
+= new - read_buffer
;
1439 end
= read_buffer
+ read_buffer_size
;
1442 c
= read_escape (readcharfun
);
1443 /* c is -1 if \ newline has just been seen */
1446 if (p
== read_buffer
)
1451 /* Allow `\C- ' and `\C-?'. */
1452 if (c
== (CHAR_CTL
| ' '))
1454 else if (c
== (CHAR_CTL
| '?'))
1458 /* Move the meta bit to the right place for a string. */
1459 c
= (c
& ~CHAR_META
) | 0x80;
1461 error ("Invalid modifier in string");
1465 if (c
< 0) return Fsignal (Qend_of_file
, Qnil
);
1467 /* If purifying, and string starts with \ newline,
1468 return zero instead. This is for doc strings
1469 that we are really going to find in etc/DOC.nn.nn */
1470 if (!NILP (Vpurify_flag
) && NILP (Vdoc_file_name
) && cancel
)
1471 return make_number (0);
1474 return make_pure_string (read_buffer
, p
- read_buffer
);
1476 return make_string (read_buffer
, p
- read_buffer
);
1481 #ifdef LISP_FLOAT_TYPE
1482 /* If a period is followed by a number, then we should read it
1483 as a floating point number. Otherwise, it denotes a dotted
1485 int next_char
= READCHAR
;
1488 if (! (next_char
>= '0' && next_char
<= '9'))
1495 /* Otherwise, we fall through! Note that the atom-reading loop
1496 below will now loop at least once, assuring that we will not
1497 try to UNREAD two characters in a row. */
1501 if (c
<= 040) goto retry
;
1503 register char *p
= read_buffer
;
1507 register char *end
= read_buffer
+ read_buffer_size
;
1510 !(c
== '\"' || c
== '\'' || c
== ';' || c
== '?'
1511 || c
== '(' || c
== ')'
1512 #ifndef LISP_FLOAT_TYPE
1513 /* If we have floating-point support, then we need
1514 to allow <digits><dot><digits>. */
1516 #endif /* not LISP_FLOAT_TYPE */
1517 || c
== '[' || c
== ']' || c
== '#'
1522 register char *new = (char *) xrealloc (read_buffer
, read_buffer_size
*= 2);
1523 p
+= new - read_buffer
;
1524 read_buffer
+= new - read_buffer
;
1525 end
= read_buffer
+ read_buffer_size
;
1538 char *new = (char *) xrealloc (read_buffer
, read_buffer_size
*= 2);
1539 p
+= new - read_buffer
;
1540 read_buffer
+= new - read_buffer
;
1541 /* end = read_buffer + read_buffer_size; */
1551 register Lisp_Object val
;
1553 if (*p1
== '+' || *p1
== '-') p1
++;
1554 /* Is it an integer? */
1557 while (p1
!= p
&& (c
= *p1
) >= '0' && c
<= '9') p1
++;
1558 #ifdef LISP_FLOAT_TYPE
1559 /* Integers can have trailing decimal points. */
1560 if (p1
> read_buffer
&& p1
< p
&& *p1
== '.') p1
++;
1563 /* It is an integer. */
1565 #ifdef LISP_FLOAT_TYPE
1569 if (sizeof (int) == sizeof (EMACS_INT
))
1570 XSETINT (val
, atoi (read_buffer
));
1571 else if (sizeof (long) == sizeof (EMACS_INT
))
1572 XSETINT (val
, atol (read_buffer
));
1578 #ifdef LISP_FLOAT_TYPE
1579 if (isfloat_string (read_buffer
))
1580 return make_float (atof (read_buffer
));
1584 return intern (read_buffer
);
1589 #ifdef LISP_FLOAT_TYPE
1604 if (*cp
== '+' || *cp
== '-')
1607 if (*cp
>= '0' && *cp
<= '9')
1610 while (*cp
>= '0' && *cp
<= '9')
1618 if (*cp
>= '0' && *cp
<= '9')
1621 while (*cp
>= '0' && *cp
<= '9')
1628 if (*cp
== '+' || *cp
== '-')
1632 if (*cp
>= '0' && *cp
<= '9')
1635 while (*cp
>= '0' && *cp
<= '9')
1638 return (((*cp
== 0) || (*cp
== ' ') || (*cp
== '\t') || (*cp
== '\n') || (*cp
== '\r') || (*cp
== '\f'))
1639 && (state
== (LEAD_INT
|DOT_CHAR
|TRAIL_INT
)
1640 || state
== (DOT_CHAR
|TRAIL_INT
)
1641 || state
== (LEAD_INT
|E_CHAR
|EXP_INT
)
1642 || state
== (LEAD_INT
|DOT_CHAR
|TRAIL_INT
|E_CHAR
|EXP_INT
)
1643 || state
== (DOT_CHAR
|TRAIL_INT
|E_CHAR
|EXP_INT
)));
1645 #endif /* LISP_FLOAT_TYPE */
1648 read_vector (readcharfun
)
1649 Lisp_Object readcharfun
;
1653 register Lisp_Object
*ptr
;
1654 register Lisp_Object tem
, vector
;
1655 register struct Lisp_Cons
*otem
;
1658 tem
= read_list (1, readcharfun
);
1659 len
= Flength (tem
);
1660 vector
= (read_pure
? make_pure_vector (XINT (len
)) : Fmake_vector (len
, Qnil
));
1663 size
= XVECTOR (vector
)->size
;
1664 ptr
= XVECTOR (vector
)->contents
;
1665 for (i
= 0; i
< size
; i
++)
1667 ptr
[i
] = read_pure
? Fpurecopy (Fcar (tem
)) : Fcar (tem
);
1675 /* flag = 1 means check for ] to terminate rather than ) and .
1676 flag = -1 means check for starting with defun
1677 and make structure pure. */
1680 read_list (flag
, readcharfun
)
1682 register Lisp_Object readcharfun
;
1684 /* -1 means check next element for defun,
1685 0 means don't check,
1686 1 means already checked and found defun. */
1687 int defunflag
= flag
< 0 ? -1 : 0;
1688 Lisp_Object val
, tail
;
1689 register Lisp_Object elt
, tem
;
1690 struct gcpro gcpro1
, gcpro2
;
1691 /* 0 is the normal case.
1692 1 means this list is a doc reference; replace it with the number 0.
1693 2 means this list is a doc reference; replace it with the doc string. */
1694 int doc_reference
= 0;
1696 /* Initialize this to 1 if we are reading a list. */
1697 int first_in_list
= flag
<= 0;
1706 elt
= read1 (readcharfun
, &ch
, first_in_list
);
1711 /* While building, if the list starts with #$, treat it specially. */
1712 if (EQ (elt
, Vload_file_name
)
1713 && !NILP (Vpurify_flag
))
1715 if (NILP (Vdoc_file_name
))
1716 /* We have not yet called Snarf-documentation, so assume
1717 this file is described in the DOC-MM.NN file
1718 and Snarf-documentation will fill in the right value later.
1719 For now, replace the whole list with 0. */
1722 /* We have already called Snarf-documentation, so make a relative
1723 file name for this file, so it can be found properly
1724 in the installed Lisp directory.
1725 We don't use Fexpand_file_name because that would make
1726 the directory absolute now. */
1727 elt
= concat2 (build_string ("../lisp/"),
1728 Ffile_name_nondirectory (elt
));
1730 else if (EQ (elt
, Vload_file_name
)
1731 && load_force_doc_strings
)
1740 Fsignal (Qinvalid_read_syntax
,
1741 Fcons (make_string (") or . in a vector", 18), Qnil
));
1749 XCONS (tail
)->cdr
= read0 (readcharfun
);
1751 val
= read0 (readcharfun
);
1752 read1 (readcharfun
, &ch
, 0);
1756 if (doc_reference
== 1)
1757 return make_number (0);
1758 if (doc_reference
== 2)
1760 /* Get a doc string from the file we are loading.
1761 If it's in saved_doc_string, get it from there. */
1762 int pos
= XINT (XCONS (val
)->cdr
);
1763 if (pos
>= saved_doc_string_position
1764 && pos
< (saved_doc_string_position
1765 + saved_doc_string_length
))
1767 int start
= pos
- saved_doc_string_position
;
1770 /* Process quoting with ^A,
1771 and find the end of the string,
1772 which is marked with ^_ (037). */
1773 for (from
= start
, to
= start
;
1774 saved_doc_string
[from
] != 037;)
1776 int c
= saved_doc_string
[from
++];
1779 c
= saved_doc_string
[from
++];
1781 saved_doc_string
[to
++] = c
;
1783 saved_doc_string
[to
++] = 0;
1785 saved_doc_string
[to
++] = 037;
1788 saved_doc_string
[to
++] = c
;
1791 return make_string (saved_doc_string
+ start
,
1795 return read_doc_string (val
);
1800 return Fsignal (Qinvalid_read_syntax
, Fcons (make_string (". in wrong context", 18), Qnil
));
1802 return Fsignal (Qinvalid_read_syntax
, Fcons (make_string ("] in a list", 11), Qnil
));
1804 tem
= (read_pure
&& flag
<= 0
1805 ? pure_cons (elt
, Qnil
)
1806 : Fcons (elt
, Qnil
));
1808 XCONS (tail
)->cdr
= tem
;
1813 defunflag
= EQ (elt
, Qdefun
);
1814 else if (defunflag
> 0)
1819 Lisp_Object Vobarray
;
1820 Lisp_Object initial_obarray
;
1822 /* oblookup stores the bucket number here, for the sake of Funintern. */
1824 int oblookup_last_bucket_number
;
1826 static int hash_string ();
1827 Lisp_Object
oblookup ();
1829 /* Get an error if OBARRAY is not an obarray.
1830 If it is one, return it. */
1833 check_obarray (obarray
)
1834 Lisp_Object obarray
;
1836 while (!VECTORP (obarray
) || XVECTOR (obarray
)->size
== 0)
1838 /* If Vobarray is now invalid, force it to be valid. */
1839 if (EQ (Vobarray
, obarray
)) Vobarray
= initial_obarray
;
1841 obarray
= wrong_type_argument (Qvectorp
, obarray
);
1846 /* Intern the C string STR: return a symbol with that name,
1847 interned in the current obarray. */
1854 int len
= strlen (str
);
1855 Lisp_Object obarray
;
1858 if (!VECTORP (obarray
) || XVECTOR (obarray
)->size
== 0)
1859 obarray
= check_obarray (obarray
);
1860 tem
= oblookup (obarray
, str
, len
);
1863 return Fintern ((!NILP (Vpurify_flag
)
1864 ? make_pure_string (str
, len
)
1865 : make_string (str
, len
)),
1869 DEFUN ("intern", Fintern
, Sintern
, 1, 2, 0,
1870 "Return the canonical symbol whose name is STRING.\n\
1871 If there is none, one is created by this function and returned.\n\
1872 A second optional argument specifies the obarray to use;\n\
1873 it defaults to the value of `obarray'.")
1875 Lisp_Object string
, obarray
;
1877 register Lisp_Object tem
, sym
, *ptr
;
1879 if (NILP (obarray
)) obarray
= Vobarray
;
1880 obarray
= check_obarray (obarray
);
1882 CHECK_STRING (string
, 0);
1884 tem
= oblookup (obarray
, XSTRING (string
)->data
, XSTRING (string
)->size
);
1885 if (!INTEGERP (tem
))
1888 if (!NILP (Vpurify_flag
))
1889 string
= Fpurecopy (string
);
1890 sym
= Fmake_symbol (string
);
1892 ptr
= &XVECTOR (obarray
)->contents
[XINT (tem
)];
1894 XSYMBOL (sym
)->next
= XSYMBOL (*ptr
);
1896 XSYMBOL (sym
)->next
= 0;
1901 DEFUN ("intern-soft", Fintern_soft
, Sintern_soft
, 1, 2, 0,
1902 "Return the canonical symbol whose name is STRING, or nil if none exists.\n\
1903 A second optional argument specifies the obarray to use;\n\
1904 it defaults to the value of `obarray'.")
1906 Lisp_Object string
, obarray
;
1908 register Lisp_Object tem
;
1910 if (NILP (obarray
)) obarray
= Vobarray
;
1911 obarray
= check_obarray (obarray
);
1913 CHECK_STRING (string
, 0);
1915 tem
= oblookup (obarray
, XSTRING (string
)->data
, XSTRING (string
)->size
);
1916 if (!INTEGERP (tem
))
1921 DEFUN ("unintern", Funintern
, Sunintern
, 1, 2, 0,
1922 "Delete the symbol named NAME, if any, from OBARRAY.\n\
1923 The value is t if a symbol was found and deleted, nil otherwise.\n\
1924 NAME may be a string or a symbol. If it is a symbol, that symbol\n\
1925 is deleted, if it belongs to OBARRAY--no other symbol is deleted.\n\
1926 OBARRAY defaults to the value of the variable `obarray'.")
1928 Lisp_Object name
, obarray
;
1930 register Lisp_Object string
, tem
;
1933 if (NILP (obarray
)) obarray
= Vobarray
;
1934 obarray
= check_obarray (obarray
);
1937 XSETSTRING (string
, XSYMBOL (name
)->name
);
1940 CHECK_STRING (name
, 0);
1944 tem
= oblookup (obarray
, XSTRING (string
)->data
, XSTRING (string
)->size
);
1947 /* If arg was a symbol, don't delete anything but that symbol itself. */
1948 if (SYMBOLP (name
) && !EQ (name
, tem
))
1951 hash
= oblookup_last_bucket_number
;
1953 if (EQ (XVECTOR (obarray
)->contents
[hash
], tem
))
1955 if (XSYMBOL (tem
)->next
)
1956 XSETSYMBOL (XVECTOR (obarray
)->contents
[hash
], XSYMBOL (tem
)->next
);
1958 XSETINT (XVECTOR (obarray
)->contents
[hash
], 0);
1962 Lisp_Object tail
, following
;
1964 for (tail
= XVECTOR (obarray
)->contents
[hash
];
1965 XSYMBOL (tail
)->next
;
1968 XSETSYMBOL (following
, XSYMBOL (tail
)->next
);
1969 if (EQ (following
, tem
))
1971 XSYMBOL (tail
)->next
= XSYMBOL (following
)->next
;
1980 /* Return the symbol in OBARRAY whose names matches the string
1981 of SIZE characters at PTR. If there is no such symbol in OBARRAY,
1984 Also store the bucket number in oblookup_last_bucket_number. */
1987 oblookup (obarray
, ptr
, size
)
1988 Lisp_Object obarray
;
1994 register Lisp_Object tail
;
1995 Lisp_Object bucket
, tem
;
1997 if (!VECTORP (obarray
)
1998 || (obsize
= XVECTOR (obarray
)->size
) == 0)
2000 obarray
= check_obarray (obarray
);
2001 obsize
= XVECTOR (obarray
)->size
;
2003 /* This is sometimes needed in the middle of GC. */
2004 obsize
&= ~ARRAY_MARK_FLAG
;
2005 /* Combining next two lines breaks VMS C 2.3. */
2006 hash
= hash_string (ptr
, size
);
2008 bucket
= XVECTOR (obarray
)->contents
[hash
];
2009 oblookup_last_bucket_number
= hash
;
2010 if (XFASTINT (bucket
) == 0)
2012 else if (!SYMBOLP (bucket
))
2013 error ("Bad data in guts of obarray"); /* Like CADR error message */
2015 for (tail
= bucket
; ; XSETSYMBOL (tail
, XSYMBOL (tail
)->next
))
2017 if (XSYMBOL (tail
)->name
->size
== size
2018 && !bcmp (XSYMBOL (tail
)->name
->data
, ptr
, size
))
2020 else if (XSYMBOL (tail
)->next
== 0)
2023 XSETINT (tem
, hash
);
2028 hash_string (ptr
, len
)
2032 register unsigned char *p
= ptr
;
2033 register unsigned char *end
= p
+ len
;
2034 register unsigned char c
;
2035 register int hash
= 0;
2040 if (c
>= 0140) c
-= 40;
2041 hash
= ((hash
<<3) + (hash
>>28) + c
);
2043 return hash
& 07777777777;
2047 map_obarray (obarray
, fn
, arg
)
2048 Lisp_Object obarray
;
2053 register Lisp_Object tail
;
2054 CHECK_VECTOR (obarray
, 1);
2055 for (i
= XVECTOR (obarray
)->size
- 1; i
>= 0; i
--)
2057 tail
= XVECTOR (obarray
)->contents
[i
];
2058 if (XFASTINT (tail
) != 0)
2062 if (XSYMBOL (tail
)->next
== 0)
2064 XSETSYMBOL (tail
, XSYMBOL (tail
)->next
);
2069 mapatoms_1 (sym
, function
)
2070 Lisp_Object sym
, function
;
2072 call1 (function
, sym
);
2075 DEFUN ("mapatoms", Fmapatoms
, Smapatoms
, 1, 2, 0,
2076 "Call FUNCTION on every symbol in OBARRAY.\n\
2077 OBARRAY defaults to the value of `obarray'.")
2079 Lisp_Object function
, obarray
;
2083 if (NILP (obarray
)) obarray
= Vobarray
;
2084 obarray
= check_obarray (obarray
);
2086 map_obarray (obarray
, mapatoms_1
, function
);
2090 #define OBARRAY_SIZE 1511
2095 Lisp_Object oblength
;
2099 XSETFASTINT (oblength
, OBARRAY_SIZE
);
2101 Qnil
= Fmake_symbol (make_pure_string ("nil", 3));
2102 Vobarray
= Fmake_vector (oblength
, make_number (0));
2103 initial_obarray
= Vobarray
;
2104 staticpro (&initial_obarray
);
2105 /* Intern nil in the obarray */
2106 /* These locals are to kludge around a pyramid compiler bug. */
2107 hash
= hash_string ("nil", 3);
2108 /* Separate statement here to avoid VAXC bug. */
2109 hash
%= OBARRAY_SIZE
;
2110 tem
= &XVECTOR (Vobarray
)->contents
[hash
];
2113 Qunbound
= Fmake_symbol (make_pure_string ("unbound", 7));
2114 XSYMBOL (Qnil
)->function
= Qunbound
;
2115 XSYMBOL (Qunbound
)->value
= Qunbound
;
2116 XSYMBOL (Qunbound
)->function
= Qunbound
;
2119 XSYMBOL (Qnil
)->value
= Qnil
;
2120 XSYMBOL (Qnil
)->plist
= Qnil
;
2121 XSYMBOL (Qt
)->value
= Qt
;
2123 /* Qt is correct even if CANNOT_DUMP. loadup.el will set to nil at end. */
2126 Qvariable_documentation
= intern ("variable-documentation");
2128 read_buffer_size
= 100;
2129 read_buffer
= (char *) malloc (read_buffer_size
);
2134 struct Lisp_Subr
*sname
;
2137 sym
= intern (sname
->symbol_name
);
2138 XSETSUBR (XSYMBOL (sym
)->function
, sname
);
2141 #ifdef NOTDEF /* use fset in subr.el now */
2143 defalias (sname
, string
)
2144 struct Lisp_Subr
*sname
;
2148 sym
= intern (string
);
2149 XSETSUBR (XSYMBOL (sym
)->function
, sname
);
2153 /* Define an "integer variable"; a symbol whose value is forwarded
2154 to a C variable of type int. Sample call: */
2155 /* DEFVAR_INT ("indent-tabs-mode", &indent_tabs_mode, "Documentation"); */
2157 defvar_int (namestring
, address
)
2161 Lisp_Object sym
, val
;
2162 sym
= intern (namestring
);
2163 val
= allocate_misc ();
2164 XMISCTYPE (val
) = Lisp_Misc_Intfwd
;
2165 XINTFWD (val
)->intvar
= address
;
2166 XSYMBOL (sym
)->value
= val
;
2169 /* Similar but define a variable whose value is T if address contains 1,
2170 NIL if address contains 0 */
2172 defvar_bool (namestring
, address
)
2176 Lisp_Object sym
, val
;
2177 sym
= intern (namestring
);
2178 val
= allocate_misc ();
2179 XMISCTYPE (val
) = Lisp_Misc_Boolfwd
;
2180 XBOOLFWD (val
)->boolvar
= address
;
2181 XSYMBOL (sym
)->value
= val
;
2184 /* Similar but define a variable whose value is the Lisp Object stored
2185 at address. Two versions: with and without gc-marking of the C
2186 variable. The nopro version is used when that variable will be
2187 gc-marked for some other reason, since marking the same slot twice
2188 can cause trouble with strings. */
2190 defvar_lisp_nopro (namestring
, address
)
2192 Lisp_Object
*address
;
2194 Lisp_Object sym
, val
;
2195 sym
= intern (namestring
);
2196 val
= allocate_misc ();
2197 XMISCTYPE (val
) = Lisp_Misc_Objfwd
;
2198 XOBJFWD (val
)->objvar
= address
;
2199 XSYMBOL (sym
)->value
= val
;
2203 defvar_lisp (namestring
, address
)
2205 Lisp_Object
*address
;
2207 defvar_lisp_nopro (namestring
, address
);
2208 staticpro (address
);
2213 /* Similar but define a variable whose value is the Lisp Object stored in
2214 the current buffer. address is the address of the slot in the buffer
2215 that is current now. */
2218 defvar_per_buffer (namestring
, address
, type
, doc
)
2220 Lisp_Object
*address
;
2224 Lisp_Object sym
, val
;
2226 extern struct buffer buffer_local_symbols
;
2228 sym
= intern (namestring
);
2229 val
= allocate_misc ();
2230 offset
= (char *)address
- (char *)current_buffer
;
2232 XMISCTYPE (val
) = Lisp_Misc_Buffer_Objfwd
;
2233 XBUFFER_OBJFWD (val
)->offset
= offset
;
2234 XSYMBOL (sym
)->value
= val
;
2235 *(Lisp_Object
*)(offset
+ (char *)&buffer_local_symbols
) = sym
;
2236 *(Lisp_Object
*)(offset
+ (char *)&buffer_local_types
) = type
;
2237 if (XINT (*(Lisp_Object
*)(offset
+ (char *)&buffer_local_flags
)) == 0)
2238 /* Did a DEFVAR_PER_BUFFER without initializing the corresponding
2239 slot of buffer_local_flags */
2243 #endif /* standalone */
2245 /* Similar but define a variable whose value is the Lisp Object stored
2246 at a particular offset in the current kboard object. */
2249 defvar_kboard (namestring
, offset
)
2253 Lisp_Object sym
, val
;
2254 sym
= intern (namestring
);
2255 val
= allocate_misc ();
2256 XMISCTYPE (val
) = Lisp_Misc_Kboard_Objfwd
;
2257 XKBOARD_OBJFWD (val
)->offset
= offset
;
2258 XSYMBOL (sym
)->value
= val
;
2261 /* Record the value of load-path used at the start of dumping
2262 so we can see if the site changed it later during dumping. */
2263 static Lisp_Object dump_path
;
2268 int turn_off_warning
= 0;
2270 #ifdef HAVE_SETLOCALE
2271 /* Make sure numbers are parsed as we expect. */
2272 setlocale (LC_NUMERIC
, "C");
2273 #endif /* HAVE_SETLOCALE */
2275 /* Compute the default load-path. */
2277 normal
= PATH_LOADSEARCH
;
2278 Vload_path
= decode_env_path (0, normal
);
2280 if (NILP (Vpurify_flag
))
2281 normal
= PATH_LOADSEARCH
;
2283 normal
= PATH_DUMPLOADSEARCH
;
2285 /* In a dumped Emacs, we normally have to reset the value of
2286 Vload_path from PATH_LOADSEARCH, since the value that was dumped
2287 uses ../lisp, instead of the path of the installed elisp
2288 libraries. However, if it appears that Vload_path was changed
2289 from the default before dumping, don't override that value. */
2292 if (! NILP (Fequal (dump_path
, Vload_path
)))
2294 Vload_path
= decode_env_path (0, normal
);
2295 if (!NILP (Vinstallation_directory
))
2297 /* Add to the path the lisp subdir of the
2298 installation dir, if it exists. */
2299 Lisp_Object tem
, tem1
;
2300 tem
= Fexpand_file_name (build_string ("lisp"),
2301 Vinstallation_directory
);
2302 tem1
= Ffile_exists_p (tem
);
2305 if (NILP (Fmember (tem
, Vload_path
)))
2307 turn_off_warning
= 1;
2308 Vload_path
= nconc2 (Vload_path
, Fcons (tem
, Qnil
));
2312 /* That dir doesn't exist, so add the build-time
2313 Lisp dirs instead. */
2314 Vload_path
= nconc2 (Vload_path
, dump_path
);
2316 /* Add site-list under the installation dir, if it exists. */
2317 tem
= Fexpand_file_name (build_string ("site-lisp"),
2318 Vinstallation_directory
);
2319 tem1
= Ffile_exists_p (tem
);
2322 if (NILP (Fmember (tem
, Vload_path
)))
2323 Vload_path
= nconc2 (Vload_path
, Fcons (tem
, Qnil
));
2330 /* ../lisp refers to the build directory.
2331 NORMAL refers to the lisp dir in the source directory. */
2332 Vload_path
= Fcons (build_string ("../lisp"),
2333 decode_env_path (0, normal
));
2334 dump_path
= Vload_path
;
2339 /* When Emacs is invoked over network shares on NT, PATH_LOADSEARCH is
2340 almost never correct, thereby causing a warning to be printed out that
2341 confuses users. Since PATH_LOADSEARCH is always overridden by the
2342 EMACSLOADPATH environment variable below, disable the warning on NT. */
2344 /* Warn if dirs in the *standard* path don't exist. */
2345 if (!turn_off_warning
)
2347 Lisp_Object path_tail
;
2349 for (path_tail
= Vload_path
;
2351 path_tail
= XCONS (path_tail
)->cdr
)
2353 Lisp_Object dirfile
;
2354 dirfile
= Fcar (path_tail
);
2355 if (STRINGP (dirfile
))
2357 dirfile
= Fdirectory_file_name (dirfile
);
2358 if (access (XSTRING (dirfile
)->data
, 0) < 0)
2360 "Warning: Lisp directory `%s' does not exist.\n",
2361 XSTRING (Fcar (path_tail
))->data
);
2365 #endif /* WINDOWSNT */
2367 /* If the EMACSLOADPATH environment variable is set, use its value.
2368 This doesn't apply if we're dumping. */
2370 if (NILP (Vpurify_flag
)
2371 && egetenv ("EMACSLOADPATH"))
2373 Vload_path
= decode_env_path ("EMACSLOADPATH", normal
);
2377 load_in_progress
= 0;
2378 Vload_file_name
= Qnil
;
2380 load_descriptor_list
= Qnil
;
2387 defsubr (&Sread_from_string
);
2389 defsubr (&Sintern_soft
);
2390 defsubr (&Sunintern
);
2392 defsubr (&Seval_buffer
);
2393 defsubr (&Seval_region
);
2394 defsubr (&Sread_char
);
2395 defsubr (&Sread_char_exclusive
);
2396 defsubr (&Sread_event
);
2397 defsubr (&Sget_file_char
);
2398 defsubr (&Smapatoms
);
2400 DEFVAR_LISP ("obarray", &Vobarray
,
2401 "Symbol table for use by `intern' and `read'.\n\
2402 It is a vector whose length ought to be prime for best results.\n\
2403 The vector's contents don't make sense if examined from Lisp programs;\n\
2404 to find all the symbols in an obarray, use `mapatoms'.");
2406 DEFVAR_LISP ("values", &Vvalues
,
2407 "List of values of all expressions which were read, evaluated and printed.\n\
2408 Order is reverse chronological.");
2410 DEFVAR_LISP ("standard-input", &Vstandard_input
,
2411 "Stream for read to get input from.\n\
2412 See documentation of `read' for possible values.");
2413 Vstandard_input
= Qt
;
2415 DEFVAR_LISP ("load-path", &Vload_path
,
2416 "*List of directories to search for files to load.\n\
2417 Each element is a string (directory name) or nil (try default directory).\n\
2418 Initialized based on EMACSLOADPATH environment variable, if any,\n\
2419 otherwise to default specified by file `paths.h' when Emacs was built.");
2421 DEFVAR_BOOL ("load-in-progress", &load_in_progress
,
2422 "Non-nil iff inside of `load'.");
2424 DEFVAR_LISP ("after-load-alist", &Vafter_load_alist
,
2425 "An alist of expressions to be evalled when particular files are loaded.\n\
2426 Each element looks like (FILENAME FORMS...).\n\
2427 When `load' is run and the file-name argument is FILENAME,\n\
2428 the FORMS in the corresponding element are executed at the end of loading.\n\n\
2429 FILENAME must match exactly! Normally FILENAME is the name of a library,\n\
2430 with no directory specified, since that is how `load' is normally called.\n\
2431 An error in FORMS does not undo the load,\n\
2432 but does prevent execution of the rest of the FORMS.");
2433 Vafter_load_alist
= Qnil
;
2435 DEFVAR_LISP ("load-history", &Vload_history
,
2436 "Alist mapping source file names to symbols and features.\n\
2437 Each alist element is a list that starts with a file name,\n\
2438 except for one element (optional) that starts with nil and describes\n\
2439 definitions evaluated from buffers not visiting files.\n\
2440 The remaining elements of each list are symbols defined as functions\n\
2441 or variables, and cons cells `(provide . FEATURE)' and `(require . FEATURE)'.");
2442 Vload_history
= Qnil
;
2444 DEFVAR_LISP ("load-file-name", &Vload_file_name
,
2445 "Full name of file being loaded by `load'.");
2446 Vload_file_name
= Qnil
;
2448 DEFVAR_LISP ("current-load-list", &Vcurrent_load_list
,
2449 "Used for internal purposes by `load'.");
2450 Vcurrent_load_list
= Qnil
;
2452 DEFVAR_LISP ("load-read-function", &Vload_read_function
,
2453 "Function used by `load' and `eval-region' for reading expressions.\n\
2454 The default is nil, which means use the function `read'.");
2455 Vload_read_function
= Qnil
;
2457 DEFVAR_BOOL ("load-force-doc-strings", &load_force_doc_strings
,
2458 "Non-nil means `load' should force-load all dynamic doc strings.\n\
2459 This is useful when the file being loaded is a temporary copy.");
2460 load_force_doc_strings
= 0;
2462 DEFVAR_LISP ("source-directory", &Vsource_directory
,
2463 "Directory in which Emacs sources were found when Emacs was built.\n\
2464 You cannot count on them to still be there!");
2466 = Fexpand_file_name (build_string ("../"),
2467 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH
)));
2469 /* Vsource_directory was initialized in init_lread. */
2471 load_descriptor_list
= Qnil
;
2472 staticpro (&load_descriptor_list
);
2474 Qcurrent_load_list
= intern ("current-load-list");
2475 staticpro (&Qcurrent_load_list
);
2477 Qstandard_input
= intern ("standard-input");
2478 staticpro (&Qstandard_input
);
2480 Qread_char
= intern ("read-char");
2481 staticpro (&Qread_char
);
2483 Qget_file_char
= intern ("get-file-char");
2484 staticpro (&Qget_file_char
);
2486 Qbackquote
= intern ("`");
2487 staticpro (&Qbackquote
);
2488 Qcomma
= intern (",");
2489 staticpro (&Qcomma
);
2490 Qcomma_at
= intern (",@");
2491 staticpro (&Qcomma_at
);
2492 Qcomma_dot
= intern (",.");
2493 staticpro (&Qcomma_dot
);
2495 Qascii_character
= intern ("ascii-character");
2496 staticpro (&Qascii_character
);
2498 Qfunction
= intern ("function");
2499 staticpro (&Qfunction
);
2501 Qload
= intern ("load");
2504 Qload_file_name
= intern ("load-file-name");
2505 staticpro (&Qload_file_name
);
2507 staticpro (&dump_path
);