(read_escape) <\s>: Don't treat strings specially.
[emacs.git] / src / lread.c
blob5fb0a39ff03988de13888a08051cf58b01c9040f
1 /* Lisp parsing and input streams.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993, 1994, 1995,
3 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 2005 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2, or (at your option)
11 any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs; see the file COPYING. If not, write to
20 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA. */
24 #include <config.h>
25 #include <stdio.h>
26 #include <sys/types.h>
27 #include <sys/stat.h>
28 #include <sys/file.h>
29 #include <errno.h>
30 #include "lisp.h"
31 #include "intervals.h"
32 #include "buffer.h"
33 #include "charset.h"
34 #include <epaths.h>
35 #include "commands.h"
36 #include "keyboard.h"
37 #include "termhooks.h"
38 #include "coding.h"
40 #ifdef lint
41 #include <sys/inode.h>
42 #endif /* lint */
44 #ifdef MSDOS
45 #if __DJGPP__ < 2
46 #include <unistd.h> /* to get X_OK */
47 #endif
48 #include "msdos.h"
49 #endif
51 #ifdef HAVE_UNISTD_H
52 #include <unistd.h>
53 #endif
55 #ifndef X_OK
56 #define X_OK 01
57 #endif
59 #include <math.h>
61 #ifdef HAVE_SETLOCALE
62 #include <locale.h>
63 #endif /* HAVE_SETLOCALE */
65 #ifdef HAVE_FCNTL_H
66 #include <fcntl.h>
67 #endif
68 #ifndef O_RDONLY
69 #define O_RDONLY 0
70 #endif
72 #ifdef HAVE_FSEEKO
73 #define file_offset off_t
74 #define file_tell ftello
75 #else
76 #define file_offset long
77 #define file_tell ftell
78 #endif
80 #ifndef USE_CRT_DLL
81 extern int errno;
82 #endif
84 Lisp_Object Qread_char, Qget_file_char, Qstandard_input, Qcurrent_load_list;
85 Lisp_Object Qvariable_documentation, Vvalues, Vstandard_input, Vafter_load_alist;
86 Lisp_Object Qascii_character, Qload, Qload_file_name;
87 Lisp_Object Qbackquote, Qcomma, Qcomma_at, Qcomma_dot, Qfunction;
88 Lisp_Object Qinhibit_file_name_operation;
89 Lisp_Object Qeval_buffer_list, Veval_buffer_list;
91 extern Lisp_Object Qevent_symbol_element_mask;
92 extern Lisp_Object Qfile_exists_p;
94 /* non-zero iff inside `load' */
95 int load_in_progress;
97 /* Directory in which the sources were found. */
98 Lisp_Object Vsource_directory;
100 /* Search path and suffixes for files to be loaded. */
101 Lisp_Object Vload_path, Vload_suffixes, default_suffixes;
103 /* File name of user's init file. */
104 Lisp_Object Vuser_init_file;
106 /* This is the user-visible association list that maps features to
107 lists of defs in their load files. */
108 Lisp_Object Vload_history;
110 /* This is used to build the load history. */
111 Lisp_Object Vcurrent_load_list;
113 /* List of files that were preloaded. */
114 Lisp_Object Vpreloaded_file_list;
116 /* Name of file actually being read by `load'. */
117 Lisp_Object Vload_file_name;
119 /* Function to use for reading, in `load' and friends. */
120 Lisp_Object Vload_read_function;
122 /* The association list of objects read with the #n=object form.
123 Each member of the list has the form (n . object), and is used to
124 look up the object for the corresponding #n# construct.
125 It must be set to nil before all top-level calls to read0. */
126 Lisp_Object read_objects;
128 /* Nonzero means load should forcibly load all dynamic doc strings. */
129 static int load_force_doc_strings;
131 /* Nonzero means read should convert strings to unibyte. */
132 static int load_convert_to_unibyte;
134 /* Function to use for loading an Emacs lisp source file (not
135 compiled) instead of readevalloop. */
136 Lisp_Object Vload_source_file_function;
138 /* List of all DEFVAR_BOOL variables. Used by the byte optimizer. */
139 Lisp_Object Vbyte_boolean_vars;
141 /* Whether or not to add a `read-positions' property to symbols
142 read. */
143 Lisp_Object Vread_with_symbol_positions;
145 /* List of (SYMBOL . POSITION) accumulated so far. */
146 Lisp_Object Vread_symbol_positions_list;
148 /* List of descriptors now open for Fload. */
149 static Lisp_Object load_descriptor_list;
151 /* File for get_file_char to read from. Use by load. */
152 static FILE *instream;
154 /* When nonzero, read conses in pure space */
155 static int read_pure;
157 /* For use within read-from-string (this reader is non-reentrant!!) */
158 static int read_from_string_index;
159 static int read_from_string_index_byte;
160 static int read_from_string_limit;
162 /* Number of bytes left to read in the buffer character
163 that `readchar' has already advanced over. */
164 static int readchar_backlog;
165 /* Number of characters read in the current call to Fread or
166 Fread_from_string. */
167 static int readchar_count;
169 /* This contains the last string skipped with #@. */
170 static char *saved_doc_string;
171 /* Length of buffer allocated in saved_doc_string. */
172 static int saved_doc_string_size;
173 /* Length of actual data in saved_doc_string. */
174 static int saved_doc_string_length;
175 /* This is the file position that string came from. */
176 static file_offset saved_doc_string_position;
178 /* This contains the previous string skipped with #@.
179 We copy it from saved_doc_string when a new string
180 is put in saved_doc_string. */
181 static char *prev_saved_doc_string;
182 /* Length of buffer allocated in prev_saved_doc_string. */
183 static int prev_saved_doc_string_size;
184 /* Length of actual data in prev_saved_doc_string. */
185 static int prev_saved_doc_string_length;
186 /* This is the file position that string came from. */
187 static file_offset prev_saved_doc_string_position;
189 /* Nonzero means inside a new-style backquote
190 with no surrounding parentheses.
191 Fread initializes this to zero, so we need not specbind it
192 or worry about what happens to it when there is an error. */
193 static int new_backquote_flag;
195 /* A list of file names for files being loaded in Fload. Used to
196 check for recursive loads. */
198 static Lisp_Object Vloads_in_progress;
200 /* Non-zero means load dangerous compiled Lisp files. */
202 int load_dangerous_libraries;
204 /* A regular expression used to detect files compiled with Emacs. */
206 static Lisp_Object Vbytecomp_version_regexp;
208 static void to_multibyte P_ ((char **, char **, int *));
209 static void readevalloop P_ ((Lisp_Object, FILE*, Lisp_Object,
210 Lisp_Object (*) (), int,
211 Lisp_Object, Lisp_Object,
212 Lisp_Object, Lisp_Object));
213 static Lisp_Object load_unwind P_ ((Lisp_Object));
214 static Lisp_Object load_descriptor_unwind P_ ((Lisp_Object));
217 /* Handle unreading and rereading of characters.
218 Write READCHAR to read a character,
219 UNREAD(c) to unread c to be read again.
221 The READCHAR and UNREAD macros are meant for reading/unreading a
222 byte code; they do not handle multibyte characters. The caller
223 should manage them if necessary.
225 [ Actually that seems to be a lie; READCHAR will definitely read
226 multibyte characters from buffer sources, at least. Is the
227 comment just out of date?
228 -- Colin Walters <walters@gnu.org>, 22 May 2002 16:36:50 -0400 ]
231 #define READCHAR readchar (readcharfun)
232 #define UNREAD(c) unreadchar (readcharfun, c)
234 static int
235 readchar (readcharfun)
236 Lisp_Object readcharfun;
238 Lisp_Object tem;
239 register int c;
241 readchar_count++;
243 if (BUFFERP (readcharfun))
245 register struct buffer *inbuffer = XBUFFER (readcharfun);
247 int pt_byte = BUF_PT_BYTE (inbuffer);
248 int orig_pt_byte = pt_byte;
250 if (readchar_backlog > 0)
251 /* We get the address of the byte just passed,
252 which is the last byte of the character.
253 The other bytes in this character are consecutive with it,
254 because the gap can't be in the middle of a character. */
255 return *(BUF_BYTE_ADDRESS (inbuffer, BUF_PT_BYTE (inbuffer) - 1)
256 - --readchar_backlog);
258 if (pt_byte >= BUF_ZV_BYTE (inbuffer))
259 return -1;
261 readchar_backlog = -1;
263 if (! NILP (inbuffer->enable_multibyte_characters))
265 /* Fetch the character code from the buffer. */
266 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, pt_byte);
267 BUF_INC_POS (inbuffer, pt_byte);
268 c = STRING_CHAR (p, pt_byte - orig_pt_byte);
270 else
272 c = BUF_FETCH_BYTE (inbuffer, pt_byte);
273 pt_byte++;
275 SET_BUF_PT_BOTH (inbuffer, BUF_PT (inbuffer) + 1, pt_byte);
277 return c;
279 if (MARKERP (readcharfun))
281 register struct buffer *inbuffer = XMARKER (readcharfun)->buffer;
283 int bytepos = marker_byte_position (readcharfun);
284 int orig_bytepos = bytepos;
286 if (readchar_backlog > 0)
287 /* We get the address of the byte just passed,
288 which is the last byte of the character.
289 The other bytes in this character are consecutive with it,
290 because the gap can't be in the middle of a character. */
291 return *(BUF_BYTE_ADDRESS (inbuffer, XMARKER (readcharfun)->bytepos - 1)
292 - --readchar_backlog);
294 if (bytepos >= BUF_ZV_BYTE (inbuffer))
295 return -1;
297 readchar_backlog = -1;
299 if (! NILP (inbuffer->enable_multibyte_characters))
301 /* Fetch the character code from the buffer. */
302 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, bytepos);
303 BUF_INC_POS (inbuffer, bytepos);
304 c = STRING_CHAR (p, bytepos - orig_bytepos);
306 else
308 c = BUF_FETCH_BYTE (inbuffer, bytepos);
309 bytepos++;
312 XMARKER (readcharfun)->bytepos = bytepos;
313 XMARKER (readcharfun)->charpos++;
315 return c;
318 if (EQ (readcharfun, Qlambda))
319 return read_bytecode_char (0);
321 if (EQ (readcharfun, Qget_file_char))
323 c = getc (instream);
324 #ifdef EINTR
325 /* Interrupted reads have been observed while reading over the network */
326 while (c == EOF && ferror (instream) && errno == EINTR)
328 QUIT;
329 clearerr (instream);
330 c = getc (instream);
332 #endif
333 return c;
336 if (STRINGP (readcharfun))
338 if (read_from_string_index >= read_from_string_limit)
339 c = -1;
340 else
341 FETCH_STRING_CHAR_ADVANCE (c, readcharfun,
342 read_from_string_index,
343 read_from_string_index_byte);
345 return c;
348 tem = call0 (readcharfun);
350 if (NILP (tem))
351 return -1;
352 return XINT (tem);
355 /* Unread the character C in the way appropriate for the stream READCHARFUN.
356 If the stream is a user function, call it with the char as argument. */
358 static void
359 unreadchar (readcharfun, c)
360 Lisp_Object readcharfun;
361 int c;
363 readchar_count--;
364 if (c == -1)
365 /* Don't back up the pointer if we're unreading the end-of-input mark,
366 since readchar didn't advance it when we read it. */
368 else if (BUFFERP (readcharfun))
370 struct buffer *b = XBUFFER (readcharfun);
371 int bytepos = BUF_PT_BYTE (b);
373 if (readchar_backlog >= 0)
374 readchar_backlog++;
375 else
377 BUF_PT (b)--;
378 if (! NILP (b->enable_multibyte_characters))
379 BUF_DEC_POS (b, bytepos);
380 else
381 bytepos--;
383 BUF_PT_BYTE (b) = bytepos;
386 else if (MARKERP (readcharfun))
388 struct buffer *b = XMARKER (readcharfun)->buffer;
389 int bytepos = XMARKER (readcharfun)->bytepos;
391 if (readchar_backlog >= 0)
392 readchar_backlog++;
393 else
395 XMARKER (readcharfun)->charpos--;
396 if (! NILP (b->enable_multibyte_characters))
397 BUF_DEC_POS (b, bytepos);
398 else
399 bytepos--;
401 XMARKER (readcharfun)->bytepos = bytepos;
404 else if (STRINGP (readcharfun))
406 read_from_string_index--;
407 read_from_string_index_byte
408 = string_char_to_byte (readcharfun, read_from_string_index);
410 else if (EQ (readcharfun, Qlambda))
411 read_bytecode_char (1);
412 else if (EQ (readcharfun, Qget_file_char))
413 ungetc (c, instream);
414 else
415 call1 (readcharfun, make_number (c));
418 static Lisp_Object read_internal_start P_ ((Lisp_Object, Lisp_Object,
419 Lisp_Object));
420 static Lisp_Object read0 P_ ((Lisp_Object));
421 static Lisp_Object read1 P_ ((Lisp_Object, int *, int));
423 static Lisp_Object read_list P_ ((int, Lisp_Object));
424 static Lisp_Object read_vector P_ ((Lisp_Object, int));
425 static int read_multibyte P_ ((int, Lisp_Object));
427 static Lisp_Object substitute_object_recurse P_ ((Lisp_Object, Lisp_Object,
428 Lisp_Object));
429 static void substitute_object_in_subtree P_ ((Lisp_Object,
430 Lisp_Object));
431 static void substitute_in_interval P_ ((INTERVAL, Lisp_Object));
434 /* Get a character from the tty. */
436 extern Lisp_Object read_char ();
438 /* Read input events until we get one that's acceptable for our purposes.
440 If NO_SWITCH_FRAME is non-zero, switch-frame events are stashed
441 until we get a character we like, and then stuffed into
442 unread_switch_frame.
444 If ASCII_REQUIRED is non-zero, we check function key events to see
445 if the unmodified version of the symbol has a Qascii_character
446 property, and use that character, if present.
448 If ERROR_NONASCII is non-zero, we signal an error if the input we
449 get isn't an ASCII character with modifiers. If it's zero but
450 ASCII_REQUIRED is non-zero, we just re-read until we get an ASCII
451 character.
453 If INPUT_METHOD is nonzero, we invoke the current input method
454 if the character warrants that. */
456 Lisp_Object
457 read_filtered_event (no_switch_frame, ascii_required, error_nonascii,
458 input_method)
459 int no_switch_frame, ascii_required, error_nonascii, input_method;
461 register Lisp_Object val, delayed_switch_frame;
463 #ifdef HAVE_WINDOW_SYSTEM
464 if (display_hourglass_p)
465 cancel_hourglass ();
466 #endif
468 delayed_switch_frame = Qnil;
470 /* Read until we get an acceptable event. */
471 retry:
472 val = read_char (0, 0, 0,
473 (input_method ? Qnil : Qt),
476 if (BUFFERP (val))
477 goto retry;
479 /* switch-frame events are put off until after the next ASCII
480 character. This is better than signaling an error just because
481 the last characters were typed to a separate minibuffer frame,
482 for example. Eventually, some code which can deal with
483 switch-frame events will read it and process it. */
484 if (no_switch_frame
485 && EVENT_HAS_PARAMETERS (val)
486 && EQ (EVENT_HEAD (val), Qswitch_frame))
488 delayed_switch_frame = val;
489 goto retry;
492 if (ascii_required)
494 /* Convert certain symbols to their ASCII equivalents. */
495 if (SYMBOLP (val))
497 Lisp_Object tem, tem1;
498 tem = Fget (val, Qevent_symbol_element_mask);
499 if (!NILP (tem))
501 tem1 = Fget (Fcar (tem), Qascii_character);
502 /* Merge this symbol's modifier bits
503 with the ASCII equivalent of its basic code. */
504 if (!NILP (tem1))
505 XSETFASTINT (val, XINT (tem1) | XINT (Fcar (Fcdr (tem))));
509 /* If we don't have a character now, deal with it appropriately. */
510 if (!INTEGERP (val))
512 if (error_nonascii)
514 Vunread_command_events = Fcons (val, Qnil);
515 error ("Non-character input-event");
517 else
518 goto retry;
522 if (! NILP (delayed_switch_frame))
523 unread_switch_frame = delayed_switch_frame;
525 #if 0
527 #ifdef HAVE_WINDOW_SYSTEM
528 if (display_hourglass_p)
529 start_hourglass ();
530 #endif
532 #endif
534 return val;
537 DEFUN ("read-char", Fread_char, Sread_char, 0, 2, 0,
538 doc: /* Read a character from the command input (keyboard or macro).
539 It is returned as a number.
540 If the user generates an event which is not a character (i.e. a mouse
541 click or function key event), `read-char' signals an error. As an
542 exception, switch-frame events are put off until non-ASCII events can
543 be read.
544 If you want to read non-character events, or ignore them, call
545 `read-event' or `read-char-exclusive' instead.
547 If the optional argument PROMPT is non-nil, display that as a prompt.
548 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
549 input method is turned on in the current buffer, that input method
550 is used for reading a character. */)
551 (prompt, inherit_input_method)
552 Lisp_Object prompt, inherit_input_method;
554 if (! NILP (prompt))
555 message_with_string ("%s", prompt, 0);
556 return read_filtered_event (1, 1, 1, ! NILP (inherit_input_method));
559 DEFUN ("read-event", Fread_event, Sread_event, 0, 2, 0,
560 doc: /* Read an event object from the input stream.
561 If the optional argument PROMPT is non-nil, display that as a prompt.
562 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
563 input method is turned on in the current buffer, that input method
564 is used for reading a character. */)
565 (prompt, inherit_input_method)
566 Lisp_Object prompt, inherit_input_method;
568 if (! NILP (prompt))
569 message_with_string ("%s", prompt, 0);
570 return read_filtered_event (0, 0, 0, ! NILP (inherit_input_method));
573 DEFUN ("read-char-exclusive", Fread_char_exclusive, Sread_char_exclusive, 0, 2, 0,
574 doc: /* Read a character from the command input (keyboard or macro).
575 It is returned as a number. Non-character events are ignored.
577 If the optional argument PROMPT is non-nil, display that as a prompt.
578 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
579 input method is turned on in the current buffer, that input method
580 is used for reading a character. */)
581 (prompt, inherit_input_method)
582 Lisp_Object prompt, inherit_input_method;
584 if (! NILP (prompt))
585 message_with_string ("%s", prompt, 0);
586 return read_filtered_event (1, 1, 0, ! NILP (inherit_input_method));
589 DEFUN ("get-file-char", Fget_file_char, Sget_file_char, 0, 0, 0,
590 doc: /* Don't use this yourself. */)
593 register Lisp_Object val;
594 XSETINT (val, getc (instream));
595 return val;
600 /* Value is non-zero if the file asswociated with file descriptor FD
601 is a compiled Lisp file that's safe to load. Only files compiled
602 with Emacs are safe to load. Files compiled with XEmacs can lead
603 to a crash in Fbyte_code because of an incompatible change in the
604 byte compiler. */
606 static int
607 safe_to_load_p (fd)
608 int fd;
610 char buf[512];
611 int nbytes, i;
612 int safe_p = 1;
614 /* Read the first few bytes from the file, and look for a line
615 specifying the byte compiler version used. */
616 nbytes = emacs_read (fd, buf, sizeof buf - 1);
617 if (nbytes > 0)
619 buf[nbytes] = '\0';
621 /* Skip to the next newline, skipping over the initial `ELC'
622 with NUL bytes following it. */
623 for (i = 0; i < nbytes && buf[i] != '\n'; ++i)
626 if (i < nbytes
627 && fast_c_string_match_ignore_case (Vbytecomp_version_regexp,
628 buf + i) < 0)
629 safe_p = 0;
632 lseek (fd, 0, SEEK_SET);
633 return safe_p;
637 /* Callback for record_unwind_protect. Restore the old load list OLD,
638 after loading a file successfully. */
640 static Lisp_Object
641 record_load_unwind (old)
642 Lisp_Object old;
644 return Vloads_in_progress = old;
647 /* This handler function is used via internal_condition_case_1. */
649 static Lisp_Object
650 load_error_handler (data)
651 Lisp_Object data;
653 return Qnil;
656 DEFUN ("load", Fload, Sload, 1, 5, 0,
657 doc: /* Execute a file of Lisp code named FILE.
658 First try FILE with `.elc' appended, then try with `.el',
659 then try FILE unmodified (the exact suffixes are determined by
660 `load-suffixes'). Environment variable references in FILE
661 are replaced with their values by calling `substitute-in-file-name'.
662 This function searches the directories in `load-path'.
663 If optional second arg NOERROR is non-nil,
664 report no error if FILE doesn't exist.
665 Print messages at start and end of loading unless
666 optional third arg NOMESSAGE is non-nil.
667 If optional fourth arg NOSUFFIX is non-nil, don't try adding
668 suffixes `.elc' or `.el' to the specified name FILE.
669 If optional fifth arg MUST-SUFFIX is non-nil, insist on
670 the suffix `.elc' or `.el'; don't accept just FILE unless
671 it ends in one of those suffixes or includes a directory name.
673 Loading a file records its definitions, and its `provide' and
674 `require' calls, in an element of `load-history' whose
675 car is the file name loaded. See `load-history'.
677 Return t if file exists. */)
678 (file, noerror, nomessage, nosuffix, must_suffix)
679 Lisp_Object file, noerror, nomessage, nosuffix, must_suffix;
681 register FILE *stream;
682 register int fd = -1;
683 int count = SPECPDL_INDEX ();
684 Lisp_Object temp;
685 struct gcpro gcpro1, gcpro2;
686 Lisp_Object found, efound;
687 /* 1 means we printed the ".el is newer" message. */
688 int newer = 0;
689 /* 1 means we are loading a compiled file. */
690 int compiled = 0;
691 Lisp_Object handler;
692 int safe_p = 1;
693 char *fmode = "r";
694 #ifdef DOS_NT
695 fmode = "rt";
696 #endif /* DOS_NT */
698 CHECK_STRING (file);
700 /* If file name is magic, call the handler. */
701 /* This shouldn't be necessary any more now that `openp' handles it right.
702 handler = Ffind_file_name_handler (file, Qload);
703 if (!NILP (handler))
704 return call5 (handler, Qload, file, noerror, nomessage, nosuffix); */
706 /* Do this after the handler to avoid
707 the need to gcpro noerror, nomessage and nosuffix.
708 (Below here, we care only whether they are nil or not.)
709 The presence of this call is the result of a historical accident:
710 it used to be in every file-operations and when it got removed
711 everywhere, it accidentally stayed here. Since then, enough people
712 supposedly have things like (load "$PROJECT/foo.el") in their .emacs
713 that it seemed risky to remove. */
714 if (! NILP (noerror))
716 file = internal_condition_case_1 (Fsubstitute_in_file_name, file,
717 Qt, load_error_handler);
718 if (NILP (file))
719 return Qnil;
721 else
722 file = Fsubstitute_in_file_name (file);
725 /* Avoid weird lossage with null string as arg,
726 since it would try to load a directory as a Lisp file */
727 if (SCHARS (file) > 0)
729 int size = SBYTES (file);
730 Lisp_Object tmp[2];
732 found = Qnil;
733 GCPRO2 (file, found);
735 if (! NILP (must_suffix))
737 /* Don't insist on adding a suffix if FILE already ends with one. */
738 if (size > 3
739 && !strcmp (SDATA (file) + size - 3, ".el"))
740 must_suffix = Qnil;
741 else if (size > 4
742 && !strcmp (SDATA (file) + size - 4, ".elc"))
743 must_suffix = Qnil;
744 /* Don't insist on adding a suffix
745 if the argument includes a directory name. */
746 else if (! NILP (Ffile_name_directory (file)))
747 must_suffix = Qnil;
750 fd = openp (Vload_path, file,
751 (!NILP (nosuffix) ? Qnil
752 : !NILP (must_suffix) ? Vload_suffixes
753 : Fappend (2, (tmp[0] = Vload_suffixes,
754 tmp[1] = default_suffixes,
755 tmp))),
756 &found, Qnil);
757 UNGCPRO;
760 if (fd == -1)
762 if (NILP (noerror))
763 Fsignal (Qfile_error, Fcons (build_string ("Cannot open load file"),
764 Fcons (file, Qnil)));
765 else
766 return Qnil;
769 /* Tell startup.el whether or not we found the user's init file. */
770 if (EQ (Qt, Vuser_init_file))
771 Vuser_init_file = found;
773 /* If FD is -2, that means openp found a magic file. */
774 if (fd == -2)
776 if (NILP (Fequal (found, file)))
777 /* If FOUND is a different file name from FILE,
778 find its handler even if we have already inhibited
779 the `load' operation on FILE. */
780 handler = Ffind_file_name_handler (found, Qt);
781 else
782 handler = Ffind_file_name_handler (found, Qload);
783 if (! NILP (handler))
784 return call5 (handler, Qload, found, noerror, nomessage, Qt);
787 /* Check if we're stuck in a recursive load cycle.
789 2000-09-21: It's not possible to just check for the file loaded
790 being a member of Vloads_in_progress. This fails because of the
791 way the byte compiler currently works; `provide's are not
792 evaluted, see font-lock.el/jit-lock.el as an example. This
793 leads to a certain amount of ``normal'' recursion.
795 Also, just loading a file recursively is not always an error in
796 the general case; the second load may do something different. */
798 int count = 0;
799 Lisp_Object tem;
800 for (tem = Vloads_in_progress; CONSP (tem); tem = XCDR (tem))
801 if (!NILP (Fequal (found, XCAR (tem))))
802 count++;
803 if (count > 3)
804 Fsignal (Qerror, Fcons (build_string ("Recursive load"),
805 Fcons (found, Vloads_in_progress)));
806 record_unwind_protect (record_load_unwind, Vloads_in_progress);
807 Vloads_in_progress = Fcons (found, Vloads_in_progress);
810 if (!bcmp (SDATA (found) + SBYTES (found) - 4,
811 ".elc", 4))
812 /* Load .elc files directly, but not when they are
813 remote and have no handler! */
815 if (fd != -2)
817 struct stat s1, s2;
818 int result;
820 GCPRO2 (file, found);
822 if (!safe_to_load_p (fd))
824 safe_p = 0;
825 if (!load_dangerous_libraries)
827 if (fd >= 0)
828 emacs_close (fd);
829 error ("File `%s' was not compiled in Emacs",
830 SDATA (found));
832 else if (!NILP (nomessage))
833 message_with_string ("File `%s' not compiled in Emacs", found, 1);
836 compiled = 1;
838 efound = ENCODE_FILE (found);
840 #ifdef DOS_NT
841 fmode = "rb";
842 #endif /* DOS_NT */
843 stat ((char *)SDATA (efound), &s1);
844 SSET (efound, SBYTES (efound) - 1, 0);
845 result = stat ((char *)SDATA (efound), &s2);
846 SSET (efound, SBYTES (efound) - 1, 'c');
848 if (result >= 0 && (unsigned) s1.st_mtime < (unsigned) s2.st_mtime)
850 /* Make the progress messages mention that source is newer. */
851 newer = 1;
853 /* If we won't print another message, mention this anyway. */
854 if (!NILP (nomessage))
856 Lisp_Object msg_file;
857 msg_file = Fsubstring (found, make_number (0), make_number (-1));
858 message_with_string ("Source file `%s' newer than byte-compiled file",
859 msg_file, 1);
862 UNGCPRO;
865 else
867 /* We are loading a source file (*.el). */
868 if (!NILP (Vload_source_file_function))
870 Lisp_Object val;
872 if (fd >= 0)
873 emacs_close (fd);
874 val = call4 (Vload_source_file_function, found, file,
875 NILP (noerror) ? Qnil : Qt,
876 NILP (nomessage) ? Qnil : Qt);
877 return unbind_to (count, val);
881 GCPRO2 (file, found);
883 #ifdef WINDOWSNT
884 emacs_close (fd);
885 efound = ENCODE_FILE (found);
886 stream = fopen ((char *) SDATA (efound), fmode);
887 #else /* not WINDOWSNT */
888 stream = fdopen (fd, fmode);
889 #endif /* not WINDOWSNT */
890 if (stream == 0)
892 emacs_close (fd);
893 error ("Failure to create stdio stream for %s", SDATA (file));
896 if (! NILP (Vpurify_flag))
897 Vpreloaded_file_list = Fcons (file, Vpreloaded_file_list);
899 if (NILP (nomessage))
901 if (!safe_p)
902 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...",
903 file, 1);
904 else if (!compiled)
905 message_with_string ("Loading %s (source)...", file, 1);
906 else if (newer)
907 message_with_string ("Loading %s (compiled; note, source file is newer)...",
908 file, 1);
909 else /* The typical case; compiled file newer than source file. */
910 message_with_string ("Loading %s...", file, 1);
913 record_unwind_protect (load_unwind, make_save_value (stream, 0));
914 record_unwind_protect (load_descriptor_unwind, load_descriptor_list);
915 specbind (Qload_file_name, found);
916 specbind (Qinhibit_file_name_operation, Qnil);
917 load_descriptor_list
918 = Fcons (make_number (fileno (stream)), load_descriptor_list);
919 load_in_progress++;
920 readevalloop (Qget_file_char, stream, (! NILP (Vpurify_flag) ? file : found),
921 Feval, 0, Qnil, Qnil, Qnil, Qnil);
922 unbind_to (count, Qnil);
924 /* Run any load-hooks for this file. */
925 temp = Fassoc (file, Vafter_load_alist);
926 if (!NILP (temp))
927 Fprogn (Fcdr (temp));
928 UNGCPRO;
930 if (saved_doc_string)
931 free (saved_doc_string);
932 saved_doc_string = 0;
933 saved_doc_string_size = 0;
935 if (prev_saved_doc_string)
936 xfree (prev_saved_doc_string);
937 prev_saved_doc_string = 0;
938 prev_saved_doc_string_size = 0;
940 if (!noninteractive && NILP (nomessage))
942 if (!safe_p)
943 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...done",
944 file, 1);
945 else if (!compiled)
946 message_with_string ("Loading %s (source)...done", file, 1);
947 else if (newer)
948 message_with_string ("Loading %s (compiled; note, source file is newer)...done",
949 file, 1);
950 else /* The typical case; compiled file newer than source file. */
951 message_with_string ("Loading %s...done", file, 1);
954 if (!NILP (Fequal (build_string ("obsolete"),
955 Ffile_name_nondirectory
956 (Fdirectory_file_name (Ffile_name_directory (found))))))
957 message_with_string ("Package %s is obsolete", file, 1);
959 return Qt;
962 static Lisp_Object
963 load_unwind (arg) /* used as unwind-protect function in load */
964 Lisp_Object arg;
966 FILE *stream = (FILE *) XSAVE_VALUE (arg)->pointer;
967 if (stream != NULL)
968 fclose (stream);
969 if (--load_in_progress < 0) load_in_progress = 0;
970 return Qnil;
973 static Lisp_Object
974 load_descriptor_unwind (oldlist)
975 Lisp_Object oldlist;
977 load_descriptor_list = oldlist;
978 return Qnil;
981 /* Close all descriptors in use for Floads.
982 This is used when starting a subprocess. */
984 void
985 close_load_descs ()
987 #ifndef WINDOWSNT
988 Lisp_Object tail;
989 for (tail = load_descriptor_list; !NILP (tail); tail = XCDR (tail))
990 emacs_close (XFASTINT (XCAR (tail)));
991 #endif
994 static int
995 complete_filename_p (pathname)
996 Lisp_Object pathname;
998 register const unsigned char *s = SDATA (pathname);
999 return (IS_DIRECTORY_SEP (s[0])
1000 || (SCHARS (pathname) > 2
1001 && IS_DEVICE_SEP (s[1]) && IS_DIRECTORY_SEP (s[2]))
1002 #ifdef ALTOS
1003 || *s == '@'
1004 #endif
1005 #ifdef VMS
1006 || index (s, ':')
1007 #endif /* VMS */
1011 DEFUN ("locate-file-internal", Flocate_file_internal, Slocate_file_internal, 2, 4, 0,
1012 doc: /* Search for FILENAME through PATH.
1013 Returns the file's name in absolute form, or nil if not found.
1014 If SUFFIXES is non-nil, it should be a list of suffixes to append to
1015 file name when searching.
1016 If non-nil, PREDICATE is used instead of `file-readable-p'.
1017 PREDICATE can also be an integer to pass to the access(2) function,
1018 in which case file-name-handlers are ignored. */)
1019 (filename, path, suffixes, predicate)
1020 Lisp_Object filename, path, suffixes, predicate;
1022 Lisp_Object file;
1023 int fd = openp (path, filename, suffixes, &file, predicate);
1024 if (NILP (predicate) && fd > 0)
1025 close (fd);
1026 return file;
1030 /* Search for a file whose name is STR, looking in directories
1031 in the Lisp list PATH, and trying suffixes from SUFFIX.
1032 On success, returns a file descriptor. On failure, returns -1.
1034 SUFFIXES is a list of strings containing possible suffixes.
1035 The empty suffix is automatically added iff the list is empty.
1037 PREDICATE non-nil means don't open the files,
1038 just look for one that satisfies the predicate. In this case,
1039 returns 1 on success. The predicate can be a lisp function or
1040 an integer to pass to `access' (in which case file-name-handlers
1041 are ignored).
1043 If STOREPTR is nonzero, it points to a slot where the name of
1044 the file actually found should be stored as a Lisp string.
1045 nil is stored there on failure.
1047 If the file we find is remote, return -2
1048 but store the found remote file name in *STOREPTR. */
1051 openp (path, str, suffixes, storeptr, predicate)
1052 Lisp_Object path, str;
1053 Lisp_Object suffixes;
1054 Lisp_Object *storeptr;
1055 Lisp_Object predicate;
1057 register int fd;
1058 int fn_size = 100;
1059 char buf[100];
1060 register char *fn = buf;
1061 int absolute = 0;
1062 int want_size;
1063 Lisp_Object filename;
1064 struct stat st;
1065 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
1066 Lisp_Object string, tail, encoded_fn;
1067 int max_suffix_len = 0;
1069 CHECK_STRING (str);
1071 for (tail = suffixes; CONSP (tail); tail = XCDR (tail))
1073 CHECK_STRING_CAR (tail);
1074 max_suffix_len = max (max_suffix_len,
1075 SBYTES (XCAR (tail)));
1078 string = filename = Qnil;
1079 GCPRO6 (str, string, filename, path, suffixes, encoded_fn);
1081 if (storeptr)
1082 *storeptr = Qnil;
1084 if (complete_filename_p (str))
1085 absolute = 1;
1087 for (; CONSP (path); path = XCDR (path))
1089 filename = Fexpand_file_name (str, XCAR (path));
1090 if (!complete_filename_p (filename))
1091 /* If there are non-absolute elts in PATH (eg ".") */
1092 /* Of course, this could conceivably lose if luser sets
1093 default-directory to be something non-absolute... */
1095 filename = Fexpand_file_name (filename, current_buffer->directory);
1096 if (!complete_filename_p (filename))
1097 /* Give up on this path element! */
1098 continue;
1101 /* Calculate maximum size of any filename made from
1102 this path element/specified file name and any possible suffix. */
1103 want_size = max_suffix_len + SBYTES (filename) + 1;
1104 if (fn_size < want_size)
1105 fn = (char *) alloca (fn_size = 100 + want_size);
1107 /* Loop over suffixes. */
1108 for (tail = NILP (suffixes) ? default_suffixes : suffixes;
1109 CONSP (tail); tail = XCDR (tail))
1111 int lsuffix = SBYTES (XCAR (tail));
1112 Lisp_Object handler;
1113 int exists;
1115 /* Concatenate path element/specified name with the suffix.
1116 If the directory starts with /:, remove that. */
1117 if (SCHARS (filename) > 2
1118 && SREF (filename, 0) == '/'
1119 && SREF (filename, 1) == ':')
1121 strncpy (fn, SDATA (filename) + 2,
1122 SBYTES (filename) - 2);
1123 fn[SBYTES (filename) - 2] = 0;
1125 else
1127 strncpy (fn, SDATA (filename),
1128 SBYTES (filename));
1129 fn[SBYTES (filename)] = 0;
1132 if (lsuffix != 0) /* Bug happens on CCI if lsuffix is 0. */
1133 strncat (fn, SDATA (XCAR (tail)), lsuffix);
1135 /* Check that the file exists and is not a directory. */
1136 /* We used to only check for handlers on non-absolute file names:
1137 if (absolute)
1138 handler = Qnil;
1139 else
1140 handler = Ffind_file_name_handler (filename, Qfile_exists_p);
1141 It's not clear why that was the case and it breaks things like
1142 (load "/bar.el") where the file is actually "/bar.el.gz". */
1143 string = build_string (fn);
1144 handler = Ffind_file_name_handler (string, Qfile_exists_p);
1145 if ((!NILP (handler) || !NILP (predicate)) && !NATNUMP (predicate))
1147 if (NILP (predicate))
1148 exists = !NILP (Ffile_readable_p (string));
1149 else
1150 exists = !NILP (call1 (predicate, string));
1151 if (exists && !NILP (Ffile_directory_p (string)))
1152 exists = 0;
1154 if (exists)
1156 /* We succeeded; return this descriptor and filename. */
1157 if (storeptr)
1158 *storeptr = string;
1159 UNGCPRO;
1160 return -2;
1163 else
1165 const char *pfn;
1167 encoded_fn = ENCODE_FILE (string);
1168 pfn = SDATA (encoded_fn);
1169 exists = (stat (pfn, &st) >= 0
1170 && (st.st_mode & S_IFMT) != S_IFDIR);
1171 if (exists)
1173 /* Check that we can access or open it. */
1174 if (NATNUMP (predicate))
1175 fd = (access (pfn, XFASTINT (predicate)) == 0) ? 1 : -1;
1176 else
1177 fd = emacs_open (pfn, O_RDONLY, 0);
1179 if (fd >= 0)
1181 /* We succeeded; return this descriptor and filename. */
1182 if (storeptr)
1183 *storeptr = string;
1184 UNGCPRO;
1185 return fd;
1190 if (absolute)
1191 break;
1194 UNGCPRO;
1195 return -1;
1199 /* Merge the list we've accumulated of globals from the current input source
1200 into the load_history variable. The details depend on whether
1201 the source has an associated file name or not.
1203 FILENAME is the file name that we are loading from.
1204 ENTIRE is 1 if loading that entire file, 0 if evaluating part of it. */
1206 static void
1207 build_load_history (filename, entire)
1208 Lisp_Object filename;
1209 int entire;
1211 register Lisp_Object tail, prev, newelt;
1212 register Lisp_Object tem, tem2;
1213 register int foundit = 0;
1215 tail = Vload_history;
1216 prev = Qnil;
1218 while (CONSP (tail))
1220 tem = XCAR (tail);
1222 /* Find the feature's previous assoc list... */
1223 if (!NILP (Fequal (filename, Fcar (tem))))
1225 foundit = 1;
1227 /* If we're loading the entire file, remove old data. */
1228 if (entire)
1230 if (NILP (prev))
1231 Vload_history = XCDR (tail);
1232 else
1233 Fsetcdr (prev, XCDR (tail));
1236 /* Otherwise, cons on new symbols that are not already members. */
1237 else
1239 tem2 = Vcurrent_load_list;
1241 while (CONSP (tem2))
1243 newelt = XCAR (tem2);
1245 if (NILP (Fmember (newelt, tem)))
1246 Fsetcar (tail, Fcons (XCAR (tem),
1247 Fcons (newelt, XCDR (tem))));
1249 tem2 = XCDR (tem2);
1250 QUIT;
1254 else
1255 prev = tail;
1256 tail = XCDR (tail);
1257 QUIT;
1260 /* If we're loading an entire file, cons the new assoc onto the
1261 front of load-history, the most-recently-loaded position. Also
1262 do this if we didn't find an existing member for the file. */
1263 if (entire || !foundit)
1264 Vload_history = Fcons (Fnreverse (Vcurrent_load_list),
1265 Vload_history);
1268 Lisp_Object
1269 unreadpure (junk) /* Used as unwind-protect function in readevalloop */
1270 Lisp_Object junk;
1272 read_pure = 0;
1273 return Qnil;
1276 static Lisp_Object
1277 readevalloop_1 (old)
1278 Lisp_Object old;
1280 load_convert_to_unibyte = ! NILP (old);
1281 return Qnil;
1284 /* Signal an `end-of-file' error, if possible with file name
1285 information. */
1287 static void
1288 end_of_file_error ()
1290 Lisp_Object data;
1292 if (STRINGP (Vload_file_name))
1293 data = Fcons (Vload_file_name, Qnil);
1294 else
1295 data = Qnil;
1297 Fsignal (Qend_of_file, data);
1300 /* UNIBYTE specifies how to set load_convert_to_unibyte
1301 for this invocation.
1302 READFUN, if non-nil, is used instead of `read'.
1303 START, END is region in current buffer (from eval-region). */
1305 static void
1306 readevalloop (readcharfun, stream, sourcename, evalfun,
1307 printflag, unibyte, readfun, start, end)
1308 Lisp_Object readcharfun;
1309 FILE *stream;
1310 Lisp_Object sourcename;
1311 Lisp_Object (*evalfun) ();
1312 int printflag;
1313 Lisp_Object unibyte, readfun;
1314 Lisp_Object start, end;
1316 register int c;
1317 register Lisp_Object val;
1318 int count = SPECPDL_INDEX ();
1319 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1320 struct buffer *b = 0;
1321 int continue_reading_p;
1323 if (BUFFERP (readcharfun))
1324 b = XBUFFER (readcharfun);
1325 else if (MARKERP (readcharfun))
1326 b = XMARKER (readcharfun)->buffer;
1328 specbind (Qstandard_input, readcharfun); /* GCPROs readcharfun. */
1329 specbind (Qcurrent_load_list, Qnil);
1330 record_unwind_protect (readevalloop_1, load_convert_to_unibyte ? Qt : Qnil);
1331 load_convert_to_unibyte = !NILP (unibyte);
1333 readchar_backlog = -1;
1335 GCPRO4 (sourcename, readfun, start, end);
1337 LOADHIST_ATTACH (sourcename);
1339 continue_reading_p = 1;
1340 while (continue_reading_p)
1342 int count1 = SPECPDL_INDEX ();
1344 if (b != 0 && NILP (b->name))
1345 error ("Reading from killed buffer");
1347 if (!NILP (start))
1349 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1350 record_unwind_protect (save_restriction_restore, save_restriction_save ());
1351 Fgoto_char (start);
1352 Fnarrow_to_region (make_number (BEGV), end);
1355 instream = stream;
1356 read_next:
1357 c = READCHAR;
1358 if (c == ';')
1360 while ((c = READCHAR) != '\n' && c != -1);
1361 goto read_next;
1363 if (c < 0)
1365 unbind_to (count1, Qnil);
1366 break;
1369 /* Ignore whitespace here, so we can detect eof. */
1370 if (c == ' ' || c == '\t' || c == '\n' || c == '\f' || c == '\r')
1371 goto read_next;
1373 if (!NILP (Vpurify_flag) && c == '(')
1375 record_unwind_protect (unreadpure, Qnil);
1376 val = read_list (-1, readcharfun);
1378 else
1380 UNREAD (c);
1381 read_objects = Qnil;
1382 if (!NILP (readfun))
1384 val = call1 (readfun, readcharfun);
1386 /* If READCHARFUN has set point to ZV, we should
1387 stop reading, even if the form read sets point
1388 to a different value when evaluated. */
1389 if (BUFFERP (readcharfun))
1391 struct buffer *b = XBUFFER (readcharfun);
1392 if (BUF_PT (b) == BUF_ZV (b))
1393 continue_reading_p = 0;
1396 else if (! NILP (Vload_read_function))
1397 val = call1 (Vload_read_function, readcharfun);
1398 else
1399 val = read_internal_start (readcharfun, Qnil, Qnil);
1402 if (!NILP (start) && continue_reading_p)
1403 start = Fpoint_marker ();
1404 unbind_to (count1, Qnil);
1406 val = (*evalfun) (val);
1408 if (printflag)
1410 Vvalues = Fcons (val, Vvalues);
1411 if (EQ (Vstandard_output, Qt))
1412 Fprin1 (val, Qnil);
1413 else
1414 Fprint (val, Qnil);
1418 build_load_history (sourcename,
1419 stream || (INTEGERP (start) && INTEGERP (end)
1420 && XINT (start) == BEG && XINT (end) == Z));
1422 UNGCPRO;
1424 unbind_to (count, Qnil);
1427 DEFUN ("eval-buffer", Feval_buffer, Seval_buffer, 0, 5, "",
1428 doc: /* Execute the current buffer as Lisp code.
1429 Programs can pass two arguments, BUFFER and PRINTFLAG.
1430 BUFFER is the buffer to evaluate (nil means use current buffer).
1431 PRINTFLAG controls printing of output:
1432 nil means discard it; anything else is stream for print.
1434 If the optional third argument FILENAME is non-nil,
1435 it specifies the file name to use for `load-history'.
1436 The optional fourth argument UNIBYTE specifies `load-convert-to-unibyte'
1437 for this invocation.
1439 The optional fifth argument DO-ALLOW-PRINT, if non-nil, specifies that
1440 `print' and related functions should work normally even if PRINTFLAG is nil.
1442 This function preserves the position of point. */)
1443 (buffer, printflag, filename, unibyte, do_allow_print)
1444 Lisp_Object buffer, printflag, filename, unibyte, do_allow_print;
1446 int count = SPECPDL_INDEX ();
1447 Lisp_Object tem, buf;
1449 if (NILP (buffer))
1450 buf = Fcurrent_buffer ();
1451 else
1452 buf = Fget_buffer (buffer);
1453 if (NILP (buf))
1454 error ("No such buffer");
1456 if (NILP (printflag) && NILP (do_allow_print))
1457 tem = Qsymbolp;
1458 else
1459 tem = printflag;
1461 if (NILP (filename))
1462 filename = XBUFFER (buf)->filename;
1464 specbind (Qeval_buffer_list, Fcons (buf, Veval_buffer_list));
1465 specbind (Qstandard_output, tem);
1466 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1467 BUF_SET_PT (XBUFFER (buf), BUF_BEGV (XBUFFER (buf)));
1468 readevalloop (buf, 0, filename, Feval,
1469 !NILP (printflag), unibyte, Qnil, Qnil, Qnil);
1470 unbind_to (count, Qnil);
1472 return Qnil;
1475 DEFUN ("eval-region", Feval_region, Seval_region, 2, 4, "r",
1476 doc: /* Execute the region as Lisp code.
1477 When called from programs, expects two arguments,
1478 giving starting and ending indices in the current buffer
1479 of the text to be executed.
1480 Programs can pass third argument PRINTFLAG which controls output:
1481 nil means discard it; anything else is stream for printing it.
1482 Also the fourth argument READ-FUNCTION, if non-nil, is used
1483 instead of `read' to read each expression. It gets one argument
1484 which is the input stream for reading characters.
1486 This function does not move point. */)
1487 (start, end, printflag, read_function)
1488 Lisp_Object start, end, printflag, read_function;
1490 int count = SPECPDL_INDEX ();
1491 Lisp_Object tem, cbuf;
1493 cbuf = Fcurrent_buffer ();
1495 if (NILP (printflag))
1496 tem = Qsymbolp;
1497 else
1498 tem = printflag;
1499 specbind (Qstandard_output, tem);
1500 specbind (Qeval_buffer_list, Fcons (cbuf, Veval_buffer_list));
1502 /* readevalloop calls functions which check the type of start and end. */
1503 readevalloop (cbuf, 0, XBUFFER (cbuf)->filename, Feval,
1504 !NILP (printflag), Qnil, read_function,
1505 start, end);
1507 return unbind_to (count, Qnil);
1511 DEFUN ("read", Fread, Sread, 0, 1, 0,
1512 doc: /* Read one Lisp expression as text from STREAM, return as Lisp object.
1513 If STREAM is nil, use the value of `standard-input' (which see).
1514 STREAM or the value of `standard-input' may be:
1515 a buffer (read from point and advance it)
1516 a marker (read from where it points and advance it)
1517 a function (call it with no arguments for each character,
1518 call it with a char as argument to push a char back)
1519 a string (takes text from string, starting at the beginning)
1520 t (read text line using minibuffer and use it, or read from
1521 standard input in batch mode). */)
1522 (stream)
1523 Lisp_Object stream;
1525 if (NILP (stream))
1526 stream = Vstandard_input;
1527 if (EQ (stream, Qt))
1528 stream = Qread_char;
1529 if (EQ (stream, Qread_char))
1530 return Fread_minibuffer (build_string ("Lisp expression: "), Qnil);
1532 return read_internal_start (stream, Qnil, Qnil);
1535 DEFUN ("read-from-string", Fread_from_string, Sread_from_string, 1, 3, 0,
1536 doc: /* Read one Lisp expression which is represented as text by STRING.
1537 Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
1538 START and END optionally delimit a substring of STRING from which to read;
1539 they default to 0 and (length STRING) respectively. */)
1540 (string, start, end)
1541 Lisp_Object string, start, end;
1543 Lisp_Object ret;
1544 CHECK_STRING (string);
1545 /* read_internal_start sets read_from_string_index. */
1546 ret = read_internal_start (string, start, end);
1547 return Fcons (ret, make_number (read_from_string_index));
1550 /* Function to set up the global context we need in toplevel read
1551 calls. */
1552 static Lisp_Object
1553 read_internal_start (stream, start, end)
1554 Lisp_Object stream;
1555 Lisp_Object start; /* Only used when stream is a string. */
1556 Lisp_Object end; /* Only used when stream is a string. */
1558 Lisp_Object retval;
1560 readchar_backlog = -1;
1561 readchar_count = 0;
1562 new_backquote_flag = 0;
1563 read_objects = Qnil;
1564 if (EQ (Vread_with_symbol_positions, Qt)
1565 || EQ (Vread_with_symbol_positions, stream))
1566 Vread_symbol_positions_list = Qnil;
1568 if (STRINGP (stream))
1570 int startval, endval;
1571 if (NILP (end))
1572 endval = SCHARS (stream);
1573 else
1575 CHECK_NUMBER (end);
1576 endval = XINT (end);
1577 if (endval < 0 || endval > SCHARS (stream))
1578 args_out_of_range (stream, end);
1581 if (NILP (start))
1582 startval = 0;
1583 else
1585 CHECK_NUMBER (start);
1586 startval = XINT (start);
1587 if (startval < 0 || startval > endval)
1588 args_out_of_range (stream, start);
1590 read_from_string_index = startval;
1591 read_from_string_index_byte = string_char_to_byte (stream, startval);
1592 read_from_string_limit = endval;
1595 retval = read0 (stream);
1596 if (EQ (Vread_with_symbol_positions, Qt)
1597 || EQ (Vread_with_symbol_positions, stream))
1598 Vread_symbol_positions_list = Fnreverse (Vread_symbol_positions_list);
1599 return retval;
1602 /* Use this for recursive reads, in contexts where internal tokens
1603 are not allowed. */
1605 static Lisp_Object
1606 read0 (readcharfun)
1607 Lisp_Object readcharfun;
1609 register Lisp_Object val;
1610 int c;
1612 val = read1 (readcharfun, &c, 0);
1613 if (c)
1614 Fsignal (Qinvalid_read_syntax, Fcons (Fmake_string (make_number (1),
1615 make_number (c)),
1616 Qnil));
1618 return val;
1621 static int read_buffer_size;
1622 static char *read_buffer;
1624 /* Read multibyte form and return it as a character. C is a first
1625 byte of multibyte form, and rest of them are read from
1626 READCHARFUN. */
1628 static int
1629 read_multibyte (c, readcharfun)
1630 register int c;
1631 Lisp_Object readcharfun;
1633 /* We need the actual character code of this multibyte
1634 characters. */
1635 unsigned char str[MAX_MULTIBYTE_LENGTH];
1636 int len = 0;
1637 int bytes;
1639 if (c < 0)
1640 return c;
1642 str[len++] = c;
1643 while ((c = READCHAR) >= 0xA0
1644 && len < MAX_MULTIBYTE_LENGTH)
1646 str[len++] = c;
1647 readchar_count--;
1649 UNREAD (c);
1650 if (UNIBYTE_STR_AS_MULTIBYTE_P (str, len, bytes))
1651 return STRING_CHAR (str, len);
1652 /* The byte sequence is not valid as multibyte. Unread all bytes
1653 but the first one, and return the first byte. */
1654 while (--len > 0)
1655 UNREAD (str[len]);
1656 return str[0];
1659 /* Read a \-escape sequence, assuming we already read the `\'.
1660 If the escape sequence forces unibyte, store 1 into *BYTEREP.
1661 If the escape sequence forces multibyte, store 2 into *BYTEREP.
1662 Otherwise store 0 into *BYTEREP. */
1664 static int
1665 read_escape (readcharfun, stringp, byterep)
1666 Lisp_Object readcharfun;
1667 int stringp;
1668 int *byterep;
1670 register int c = READCHAR;
1672 *byterep = 0;
1674 switch (c)
1676 case -1:
1677 end_of_file_error ();
1679 case 'a':
1680 return '\007';
1681 case 'b':
1682 return '\b';
1683 case 'd':
1684 return 0177;
1685 case 'e':
1686 return 033;
1687 case 'f':
1688 return '\f';
1689 case 'n':
1690 return '\n';
1691 case 'r':
1692 return '\r';
1693 case 't':
1694 return '\t';
1695 case 'v':
1696 return '\v';
1697 case '\n':
1698 return -1;
1699 case ' ':
1700 if (stringp)
1701 return -1;
1702 return ' ';
1704 case 'M':
1705 c = READCHAR;
1706 if (c != '-')
1707 error ("Invalid escape character syntax");
1708 c = READCHAR;
1709 if (c == '\\')
1710 c = read_escape (readcharfun, 0, byterep);
1711 return c | meta_modifier;
1713 case 'S':
1714 c = READCHAR;
1715 if (c != '-')
1716 error ("Invalid escape character syntax");
1717 c = READCHAR;
1718 if (c == '\\')
1719 c = read_escape (readcharfun, 0, byterep);
1720 return c | shift_modifier;
1722 case 'H':
1723 c = READCHAR;
1724 if (c != '-')
1725 error ("Invalid escape character syntax");
1726 c = READCHAR;
1727 if (c == '\\')
1728 c = read_escape (readcharfun, 0, byterep);
1729 return c | hyper_modifier;
1731 case 'A':
1732 c = READCHAR;
1733 if (c != '-')
1734 error ("Invalid escape character syntax");
1735 c = READCHAR;
1736 if (c == '\\')
1737 c = read_escape (readcharfun, 0, byterep);
1738 return c | alt_modifier;
1740 case 's':
1741 c = READCHAR;
1742 if (c != '-')
1744 UNREAD (c);
1745 return ' ';
1747 c = READCHAR;
1748 if (c == '\\')
1749 c = read_escape (readcharfun, 0, byterep);
1750 return c | super_modifier;
1752 case 'C':
1753 c = READCHAR;
1754 if (c != '-')
1755 error ("Invalid escape character syntax");
1756 case '^':
1757 c = READCHAR;
1758 if (c == '\\')
1759 c = read_escape (readcharfun, 0, byterep);
1760 if ((c & ~CHAR_MODIFIER_MASK) == '?')
1761 return 0177 | (c & CHAR_MODIFIER_MASK);
1762 else if (! SINGLE_BYTE_CHAR_P ((c & ~CHAR_MODIFIER_MASK)))
1763 return c | ctrl_modifier;
1764 /* ASCII control chars are made from letters (both cases),
1765 as well as the non-letters within 0100...0137. */
1766 else if ((c & 0137) >= 0101 && (c & 0137) <= 0132)
1767 return (c & (037 | ~0177));
1768 else if ((c & 0177) >= 0100 && (c & 0177) <= 0137)
1769 return (c & (037 | ~0177));
1770 else
1771 return c | ctrl_modifier;
1773 case '0':
1774 case '1':
1775 case '2':
1776 case '3':
1777 case '4':
1778 case '5':
1779 case '6':
1780 case '7':
1781 /* An octal escape, as in ANSI C. */
1783 register int i = c - '0';
1784 register int count = 0;
1785 while (++count < 3)
1787 if ((c = READCHAR) >= '0' && c <= '7')
1789 i *= 8;
1790 i += c - '0';
1792 else
1794 UNREAD (c);
1795 break;
1799 *byterep = 1;
1800 return i;
1803 case 'x':
1804 /* A hex escape, as in ANSI C. */
1806 int i = 0;
1807 while (1)
1809 c = READCHAR;
1810 if (c >= '0' && c <= '9')
1812 i *= 16;
1813 i += c - '0';
1815 else if ((c >= 'a' && c <= 'f')
1816 || (c >= 'A' && c <= 'F'))
1818 i *= 16;
1819 if (c >= 'a' && c <= 'f')
1820 i += c - 'a' + 10;
1821 else
1822 i += c - 'A' + 10;
1824 else
1826 UNREAD (c);
1827 break;
1831 *byterep = 2;
1832 return i;
1835 default:
1836 if (BASE_LEADING_CODE_P (c))
1837 c = read_multibyte (c, readcharfun);
1838 return c;
1843 /* Read an integer in radix RADIX using READCHARFUN to read
1844 characters. RADIX must be in the interval [2..36]; if it isn't, a
1845 read error is signaled . Value is the integer read. Signals an
1846 error if encountering invalid read syntax or if RADIX is out of
1847 range. */
1849 static Lisp_Object
1850 read_integer (readcharfun, radix)
1851 Lisp_Object readcharfun;
1852 int radix;
1854 int ndigits = 0, invalid_p, c, sign = 0;
1855 EMACS_INT number = 0;
1857 if (radix < 2 || radix > 36)
1858 invalid_p = 1;
1859 else
1861 number = ndigits = invalid_p = 0;
1862 sign = 1;
1864 c = READCHAR;
1865 if (c == '-')
1867 c = READCHAR;
1868 sign = -1;
1870 else if (c == '+')
1871 c = READCHAR;
1873 while (c >= 0)
1875 int digit;
1877 if (c >= '0' && c <= '9')
1878 digit = c - '0';
1879 else if (c >= 'a' && c <= 'z')
1880 digit = c - 'a' + 10;
1881 else if (c >= 'A' && c <= 'Z')
1882 digit = c - 'A' + 10;
1883 else
1885 UNREAD (c);
1886 break;
1889 if (digit < 0 || digit >= radix)
1890 invalid_p = 1;
1892 number = radix * number + digit;
1893 ++ndigits;
1894 c = READCHAR;
1898 if (ndigits == 0 || invalid_p)
1900 char buf[50];
1901 sprintf (buf, "integer, radix %d", radix);
1902 Fsignal (Qinvalid_read_syntax, Fcons (build_string (buf), Qnil));
1905 return make_number (sign * number);
1909 /* Convert unibyte text in read_buffer to multibyte.
1911 Initially, *P is a pointer after the end of the unibyte text, and
1912 the pointer *END points after the end of read_buffer.
1914 If read_buffer doesn't have enough room to hold the result
1915 of the conversion, reallocate it and adjust *P and *END.
1917 At the end, make *P point after the result of the conversion, and
1918 return in *NCHARS the number of characters in the converted
1919 text. */
1921 static void
1922 to_multibyte (p, end, nchars)
1923 char **p, **end;
1924 int *nchars;
1926 int nbytes;
1928 parse_str_as_multibyte (read_buffer, *p - read_buffer, &nbytes, nchars);
1929 if (read_buffer_size < 2 * nbytes)
1931 int offset = *p - read_buffer;
1932 read_buffer_size = 2 * max (read_buffer_size, nbytes);
1933 read_buffer = (char *) xrealloc (read_buffer, read_buffer_size);
1934 *p = read_buffer + offset;
1935 *end = read_buffer + read_buffer_size;
1938 if (nbytes != *nchars)
1939 nbytes = str_as_multibyte (read_buffer, read_buffer_size,
1940 *p - read_buffer, nchars);
1942 *p = read_buffer + nbytes;
1946 /* If the next token is ')' or ']' or '.', we store that character
1947 in *PCH and the return value is not interesting. Else, we store
1948 zero in *PCH and we read and return one lisp object.
1950 FIRST_IN_LIST is nonzero if this is the first element of a list. */
1952 static Lisp_Object
1953 read1 (readcharfun, pch, first_in_list)
1954 register Lisp_Object readcharfun;
1955 int *pch;
1956 int first_in_list;
1958 register int c;
1959 int uninterned_symbol = 0;
1961 *pch = 0;
1963 retry:
1965 c = READCHAR;
1966 if (c < 0)
1967 end_of_file_error ();
1969 switch (c)
1971 case '(':
1972 return read_list (0, readcharfun);
1974 case '[':
1975 return read_vector (readcharfun, 0);
1977 case ')':
1978 case ']':
1980 *pch = c;
1981 return Qnil;
1984 case '#':
1985 c = READCHAR;
1986 if (c == '^')
1988 c = READCHAR;
1989 if (c == '[')
1991 Lisp_Object tmp;
1992 tmp = read_vector (readcharfun, 0);
1993 if (XVECTOR (tmp)->size < CHAR_TABLE_STANDARD_SLOTS
1994 || XVECTOR (tmp)->size > CHAR_TABLE_STANDARD_SLOTS + 10)
1995 error ("Invalid size char-table");
1996 XSETCHAR_TABLE (tmp, XCHAR_TABLE (tmp));
1997 XCHAR_TABLE (tmp)->top = Qt;
1998 return tmp;
2000 else if (c == '^')
2002 c = READCHAR;
2003 if (c == '[')
2005 Lisp_Object tmp;
2006 tmp = read_vector (readcharfun, 0);
2007 if (XVECTOR (tmp)->size != SUB_CHAR_TABLE_STANDARD_SLOTS)
2008 error ("Invalid size char-table");
2009 XSETCHAR_TABLE (tmp, XCHAR_TABLE (tmp));
2010 XCHAR_TABLE (tmp)->top = Qnil;
2011 return tmp;
2013 Fsignal (Qinvalid_read_syntax,
2014 Fcons (make_string ("#^^", 3), Qnil));
2016 Fsignal (Qinvalid_read_syntax, Fcons (make_string ("#^", 2), Qnil));
2018 if (c == '&')
2020 Lisp_Object length;
2021 length = read1 (readcharfun, pch, first_in_list);
2022 c = READCHAR;
2023 if (c == '"')
2025 Lisp_Object tmp, val;
2026 int size_in_chars
2027 = ((XFASTINT (length) + BOOL_VECTOR_BITS_PER_CHAR - 1)
2028 / BOOL_VECTOR_BITS_PER_CHAR);
2030 UNREAD (c);
2031 tmp = read1 (readcharfun, pch, first_in_list);
2032 if (size_in_chars != SCHARS (tmp)
2033 /* We used to print 1 char too many
2034 when the number of bits was a multiple of 8.
2035 Accept such input in case it came from an old version. */
2036 && ! (XFASTINT (length)
2037 == (SCHARS (tmp) - 1) * BOOL_VECTOR_BITS_PER_CHAR))
2038 Fsignal (Qinvalid_read_syntax,
2039 Fcons (make_string ("#&...", 5), Qnil));
2041 val = Fmake_bool_vector (length, Qnil);
2042 bcopy (SDATA (tmp), XBOOL_VECTOR (val)->data,
2043 size_in_chars);
2044 /* Clear the extraneous bits in the last byte. */
2045 if (XINT (length) != size_in_chars * BOOL_VECTOR_BITS_PER_CHAR)
2046 XBOOL_VECTOR (val)->data[size_in_chars - 1]
2047 &= (1 << (XINT (length) % BOOL_VECTOR_BITS_PER_CHAR)) - 1;
2048 return val;
2050 Fsignal (Qinvalid_read_syntax, Fcons (make_string ("#&...", 5),
2051 Qnil));
2053 if (c == '[')
2055 /* Accept compiled functions at read-time so that we don't have to
2056 build them using function calls. */
2057 Lisp_Object tmp;
2058 tmp = read_vector (readcharfun, 1);
2059 return Fmake_byte_code (XVECTOR (tmp)->size,
2060 XVECTOR (tmp)->contents);
2062 if (c == '(')
2064 Lisp_Object tmp;
2065 struct gcpro gcpro1;
2066 int ch;
2068 /* Read the string itself. */
2069 tmp = read1 (readcharfun, &ch, 0);
2070 if (ch != 0 || !STRINGP (tmp))
2071 Fsignal (Qinvalid_read_syntax, Fcons (make_string ("#", 1), Qnil));
2072 GCPRO1 (tmp);
2073 /* Read the intervals and their properties. */
2074 while (1)
2076 Lisp_Object beg, end, plist;
2078 beg = read1 (readcharfun, &ch, 0);
2079 end = plist = Qnil;
2080 if (ch == ')')
2081 break;
2082 if (ch == 0)
2083 end = read1 (readcharfun, &ch, 0);
2084 if (ch == 0)
2085 plist = read1 (readcharfun, &ch, 0);
2086 if (ch)
2087 Fsignal (Qinvalid_read_syntax,
2088 Fcons (build_string ("invalid string property list"),
2089 Qnil));
2090 Fset_text_properties (beg, end, plist, tmp);
2092 UNGCPRO;
2093 return tmp;
2096 /* #@NUMBER is used to skip NUMBER following characters.
2097 That's used in .elc files to skip over doc strings
2098 and function definitions. */
2099 if (c == '@')
2101 int i, nskip = 0;
2103 /* Read a decimal integer. */
2104 while ((c = READCHAR) >= 0
2105 && c >= '0' && c <= '9')
2107 nskip *= 10;
2108 nskip += c - '0';
2110 if (c >= 0)
2111 UNREAD (c);
2113 if (load_force_doc_strings && EQ (readcharfun, Qget_file_char))
2115 /* If we are supposed to force doc strings into core right now,
2116 record the last string that we skipped,
2117 and record where in the file it comes from. */
2119 /* But first exchange saved_doc_string
2120 with prev_saved_doc_string, so we save two strings. */
2122 char *temp = saved_doc_string;
2123 int temp_size = saved_doc_string_size;
2124 file_offset temp_pos = saved_doc_string_position;
2125 int temp_len = saved_doc_string_length;
2127 saved_doc_string = prev_saved_doc_string;
2128 saved_doc_string_size = prev_saved_doc_string_size;
2129 saved_doc_string_position = prev_saved_doc_string_position;
2130 saved_doc_string_length = prev_saved_doc_string_length;
2132 prev_saved_doc_string = temp;
2133 prev_saved_doc_string_size = temp_size;
2134 prev_saved_doc_string_position = temp_pos;
2135 prev_saved_doc_string_length = temp_len;
2138 if (saved_doc_string_size == 0)
2140 saved_doc_string_size = nskip + 100;
2141 saved_doc_string = (char *) xmalloc (saved_doc_string_size);
2143 if (nskip > saved_doc_string_size)
2145 saved_doc_string_size = nskip + 100;
2146 saved_doc_string = (char *) xrealloc (saved_doc_string,
2147 saved_doc_string_size);
2150 saved_doc_string_position = file_tell (instream);
2152 /* Copy that many characters into saved_doc_string. */
2153 for (i = 0; i < nskip && c >= 0; i++)
2154 saved_doc_string[i] = c = READCHAR;
2156 saved_doc_string_length = i;
2158 else
2160 /* Skip that many characters. */
2161 for (i = 0; i < nskip && c >= 0; i++)
2162 c = READCHAR;
2165 goto retry;
2167 if (c == '!')
2169 /* #! appears at the beginning of an executable file.
2170 Skip the first line. */
2171 while (c != '\n' && c >= 0)
2172 c = READCHAR;
2173 goto retry;
2175 if (c == '$')
2176 return Vload_file_name;
2177 if (c == '\'')
2178 return Fcons (Qfunction, Fcons (read0 (readcharfun), Qnil));
2179 /* #:foo is the uninterned symbol named foo. */
2180 if (c == ':')
2182 uninterned_symbol = 1;
2183 c = READCHAR;
2184 goto default_label;
2186 /* Reader forms that can reuse previously read objects. */
2187 if (c >= '0' && c <= '9')
2189 int n = 0;
2190 Lisp_Object tem;
2192 /* Read a non-negative integer. */
2193 while (c >= '0' && c <= '9')
2195 n *= 10;
2196 n += c - '0';
2197 c = READCHAR;
2199 /* #n=object returns object, but associates it with n for #n#. */
2200 if (c == '=')
2202 /* Make a placeholder for #n# to use temporarily */
2203 Lisp_Object placeholder;
2204 Lisp_Object cell;
2206 placeholder = Fcons(Qnil, Qnil);
2207 cell = Fcons (make_number (n), placeholder);
2208 read_objects = Fcons (cell, read_objects);
2210 /* Read the object itself. */
2211 tem = read0 (readcharfun);
2213 /* Now put it everywhere the placeholder was... */
2214 substitute_object_in_subtree (tem, placeholder);
2216 /* ...and #n# will use the real value from now on. */
2217 Fsetcdr (cell, tem);
2219 return tem;
2221 /* #n# returns a previously read object. */
2222 if (c == '#')
2224 tem = Fassq (make_number (n), read_objects);
2225 if (CONSP (tem))
2226 return XCDR (tem);
2227 /* Fall through to error message. */
2229 else if (c == 'r' || c == 'R')
2230 return read_integer (readcharfun, n);
2232 /* Fall through to error message. */
2234 else if (c == 'x' || c == 'X')
2235 return read_integer (readcharfun, 16);
2236 else if (c == 'o' || c == 'O')
2237 return read_integer (readcharfun, 8);
2238 else if (c == 'b' || c == 'B')
2239 return read_integer (readcharfun, 2);
2241 UNREAD (c);
2242 Fsignal (Qinvalid_read_syntax, Fcons (make_string ("#", 1), Qnil));
2244 case ';':
2245 while ((c = READCHAR) >= 0 && c != '\n');
2246 goto retry;
2248 case '\'':
2250 return Fcons (Qquote, Fcons (read0 (readcharfun), Qnil));
2253 case '`':
2254 if (first_in_list)
2255 goto default_label;
2256 else
2258 Lisp_Object value;
2260 new_backquote_flag++;
2261 value = read0 (readcharfun);
2262 new_backquote_flag--;
2264 return Fcons (Qbackquote, Fcons (value, Qnil));
2267 case ',':
2268 if (new_backquote_flag)
2270 Lisp_Object comma_type = Qnil;
2271 Lisp_Object value;
2272 int ch = READCHAR;
2274 if (ch == '@')
2275 comma_type = Qcomma_at;
2276 else if (ch == '.')
2277 comma_type = Qcomma_dot;
2278 else
2280 if (ch >= 0) UNREAD (ch);
2281 comma_type = Qcomma;
2284 new_backquote_flag--;
2285 value = read0 (readcharfun);
2286 new_backquote_flag++;
2287 return Fcons (comma_type, Fcons (value, Qnil));
2289 else
2290 goto default_label;
2292 case '?':
2294 int discard;
2295 int next_char;
2296 int ok;
2298 c = READCHAR;
2299 if (c < 0)
2300 end_of_file_error ();
2302 /* Accept `single space' syntax like (list ? x) where the
2303 whitespace character is SPC or TAB.
2304 Other literal whitespace like NL, CR, and FF are not accepted,
2305 as there are well-established escape sequences for these. */
2306 if (c == ' ' || c == '\t')
2307 return make_number (c);
2309 if (c == '\\')
2310 c = read_escape (readcharfun, 0, &discard);
2311 else if (BASE_LEADING_CODE_P (c))
2312 c = read_multibyte (c, readcharfun);
2314 next_char = READCHAR;
2315 if (next_char == '.')
2317 /* Only a dotted-pair dot is valid after a char constant. */
2318 int next_next_char = READCHAR;
2319 UNREAD (next_next_char);
2321 ok = (next_next_char <= 040
2322 || (next_next_char < 0200
2323 && (index ("\"';([#?", next_next_char)
2324 || (!first_in_list && next_next_char == '`')
2325 || (new_backquote_flag && next_next_char == ','))));
2327 else
2329 ok = (next_char <= 040
2330 || (next_char < 0200
2331 && (index ("\"';()[]#?", next_char)
2332 || (!first_in_list && next_char == '`')
2333 || (new_backquote_flag && next_char == ','))));
2335 UNREAD (next_char);
2336 if (!ok)
2337 Fsignal (Qinvalid_read_syntax, Fcons (make_string ("?", 1), Qnil));
2339 return make_number (c);
2342 case '"':
2344 char *p = read_buffer;
2345 char *end = read_buffer + read_buffer_size;
2346 register int c;
2347 /* 1 if we saw an escape sequence specifying
2348 a multibyte character, or a multibyte character. */
2349 int force_multibyte = 0;
2350 /* 1 if we saw an escape sequence specifying
2351 a single-byte character. */
2352 int force_singlebyte = 0;
2353 /* 1 if read_buffer contains multibyte text now. */
2354 int is_multibyte = 0;
2355 int cancel = 0;
2356 int nchars = 0;
2358 while ((c = READCHAR) >= 0
2359 && c != '\"')
2361 if (end - p < MAX_MULTIBYTE_LENGTH)
2363 int offset = p - read_buffer;
2364 read_buffer = (char *) xrealloc (read_buffer,
2365 read_buffer_size *= 2);
2366 p = read_buffer + offset;
2367 end = read_buffer + read_buffer_size;
2370 if (c == '\\')
2372 int byterep;
2374 c = read_escape (readcharfun, 1, &byterep);
2376 /* C is -1 if \ newline has just been seen */
2377 if (c == -1)
2379 if (p == read_buffer)
2380 cancel = 1;
2381 continue;
2384 if (byterep == 1)
2385 force_singlebyte = 1;
2386 else if (byterep == 2)
2387 force_multibyte = 1;
2390 /* A character that must be multibyte forces multibyte. */
2391 if (! SINGLE_BYTE_CHAR_P (c & ~CHAR_MODIFIER_MASK))
2392 force_multibyte = 1;
2394 /* If we just discovered the need to be multibyte,
2395 convert the text accumulated thus far. */
2396 if (force_multibyte && ! is_multibyte)
2398 is_multibyte = 1;
2399 to_multibyte (&p, &end, &nchars);
2402 /* Allow `\C- ' and `\C-?'. */
2403 if (c == (CHAR_CTL | ' '))
2404 c = 0;
2405 else if (c == (CHAR_CTL | '?'))
2406 c = 127;
2408 if (c & CHAR_SHIFT)
2410 /* Shift modifier is valid only with [A-Za-z]. */
2411 if ((c & 0377) >= 'A' && (c & 0377) <= 'Z')
2412 c &= ~CHAR_SHIFT;
2413 else if ((c & 0377) >= 'a' && (c & 0377) <= 'z')
2414 c = (c & ~CHAR_SHIFT) - ('a' - 'A');
2417 if (c & CHAR_META)
2418 /* Move the meta bit to the right place for a string. */
2419 c = (c & ~CHAR_META) | 0x80;
2420 if (c & CHAR_MODIFIER_MASK)
2421 error ("Invalid modifier in string");
2423 if (is_multibyte)
2424 p += CHAR_STRING (c, p);
2425 else
2426 *p++ = c;
2428 nchars++;
2431 if (c < 0)
2432 end_of_file_error ();
2434 /* If purifying, and string starts with \ newline,
2435 return zero instead. This is for doc strings
2436 that we are really going to find in etc/DOC.nn.nn */
2437 if (!NILP (Vpurify_flag) && NILP (Vdoc_file_name) && cancel)
2438 return make_number (0);
2440 if (is_multibyte || force_singlebyte)
2442 else if (load_convert_to_unibyte)
2444 Lisp_Object string;
2445 to_multibyte (&p, &end, &nchars);
2446 if (p - read_buffer != nchars)
2448 string = make_multibyte_string (read_buffer, nchars,
2449 p - read_buffer);
2450 return Fstring_make_unibyte (string);
2452 /* We can make a unibyte string directly. */
2453 is_multibyte = 0;
2455 else if (EQ (readcharfun, Qget_file_char)
2456 || EQ (readcharfun, Qlambda))
2458 /* Nowadays, reading directly from a file is used only for
2459 compiled Emacs Lisp files, and those always use the
2460 Emacs internal encoding. Meanwhile, Qlambda is used
2461 for reading dynamic byte code (compiled with
2462 byte-compile-dynamic = t). So make the string multibyte
2463 if the string contains any multibyte sequences.
2464 (to_multibyte is a no-op if not.) */
2465 to_multibyte (&p, &end, &nchars);
2466 is_multibyte = (p - read_buffer) != nchars;
2468 else
2469 /* In all other cases, if we read these bytes as
2470 separate characters, treat them as separate characters now. */
2473 /* We want readchar_count to be the number of characters, not
2474 bytes. Hence we adjust for multibyte characters in the
2475 string. ... But it doesn't seem to be necessary, because
2476 READCHAR *does* read multibyte characters from buffers. */
2477 /* readchar_count -= (p - read_buffer) - nchars; */
2478 if (read_pure)
2479 return make_pure_string (read_buffer, nchars, p - read_buffer,
2480 is_multibyte);
2481 return make_specified_string (read_buffer, nchars, p - read_buffer,
2482 is_multibyte);
2485 case '.':
2487 int next_char = READCHAR;
2488 UNREAD (next_char);
2490 if (next_char <= 040
2491 || (next_char < 0200
2492 && (index ("\"';([#?", next_char)
2493 || (!first_in_list && next_char == '`')
2494 || (new_backquote_flag && next_char == ','))))
2496 *pch = c;
2497 return Qnil;
2500 /* Otherwise, we fall through! Note that the atom-reading loop
2501 below will now loop at least once, assuring that we will not
2502 try to UNREAD two characters in a row. */
2504 default:
2505 default_label:
2506 if (c <= 040) goto retry;
2508 char *p = read_buffer;
2509 int quoted = 0;
2512 char *end = read_buffer + read_buffer_size;
2514 while (c > 040
2515 && (c >= 0200
2516 || (!index ("\"';()[]#", c)
2517 && !(!first_in_list && c == '`')
2518 && !(new_backquote_flag && c == ','))))
2520 if (end - p < MAX_MULTIBYTE_LENGTH)
2522 int offset = p - read_buffer;
2523 read_buffer = (char *) xrealloc (read_buffer,
2524 read_buffer_size *= 2);
2525 p = read_buffer + offset;
2526 end = read_buffer + read_buffer_size;
2529 if (c == '\\')
2531 c = READCHAR;
2532 if (c == -1)
2533 end_of_file_error ();
2534 quoted = 1;
2537 if (! SINGLE_BYTE_CHAR_P (c))
2538 p += CHAR_STRING (c, p);
2539 else
2540 *p++ = c;
2542 c = READCHAR;
2545 if (p == end)
2547 int offset = p - read_buffer;
2548 read_buffer = (char *) xrealloc (read_buffer,
2549 read_buffer_size *= 2);
2550 p = read_buffer + offset;
2551 end = read_buffer + read_buffer_size;
2553 *p = 0;
2554 if (c >= 0)
2555 UNREAD (c);
2558 if (!quoted && !uninterned_symbol)
2560 register char *p1;
2561 register Lisp_Object val;
2562 p1 = read_buffer;
2563 if (*p1 == '+' || *p1 == '-') p1++;
2564 /* Is it an integer? */
2565 if (p1 != p)
2567 while (p1 != p && (c = *p1) >= '0' && c <= '9') p1++;
2568 /* Integers can have trailing decimal points. */
2569 if (p1 > read_buffer && p1 < p && *p1 == '.') p1++;
2570 if (p1 == p)
2571 /* It is an integer. */
2573 if (p1[-1] == '.')
2574 p1[-1] = '\0';
2575 if (sizeof (int) == sizeof (EMACS_INT))
2576 XSETINT (val, atoi (read_buffer));
2577 else if (sizeof (long) == sizeof (EMACS_INT))
2578 XSETINT (val, atol (read_buffer));
2579 else
2580 abort ();
2581 return val;
2584 if (isfloat_string (read_buffer))
2586 /* Compute NaN and infinities using 0.0 in a variable,
2587 to cope with compilers that think they are smarter
2588 than we are. */
2589 double zero = 0.0;
2591 double value;
2593 /* Negate the value ourselves. This treats 0, NaNs,
2594 and infinity properly on IEEE floating point hosts,
2595 and works around a common bug where atof ("-0.0")
2596 drops the sign. */
2597 int negative = read_buffer[0] == '-';
2599 /* The only way p[-1] can be 'F' or 'N', after isfloat_string
2600 returns 1, is if the input ends in e+INF or e+NaN. */
2601 switch (p[-1])
2603 case 'F':
2604 value = 1.0 / zero;
2605 break;
2606 case 'N':
2607 value = zero / zero;
2609 /* If that made a "negative" NaN, negate it. */
2612 int i;
2613 union { double d; char c[sizeof (double)]; } u_data, u_minus_zero;
2615 u_data.d = value;
2616 u_minus_zero.d = - 0.0;
2617 for (i = 0; i < sizeof (double); i++)
2618 if (u_data.c[i] & u_minus_zero.c[i])
2620 value = - value;
2621 break;
2624 /* Now VALUE is a positive NaN. */
2625 break;
2626 default:
2627 value = atof (read_buffer + negative);
2628 break;
2631 return make_float (negative ? - value : value);
2635 Lisp_Object result = uninterned_symbol ? make_symbol (read_buffer)
2636 : intern (read_buffer);
2637 if (EQ (Vread_with_symbol_positions, Qt)
2638 || EQ (Vread_with_symbol_positions, readcharfun))
2639 Vread_symbol_positions_list =
2640 /* Kind of a hack; this will probably fail if characters
2641 in the symbol name were escaped. Not really a big
2642 deal, though. */
2643 Fcons (Fcons (result,
2644 make_number (readchar_count
2645 - XFASTINT (Flength (Fsymbol_name (result))))),
2646 Vread_symbol_positions_list);
2647 return result;
2654 /* List of nodes we've seen during substitute_object_in_subtree. */
2655 static Lisp_Object seen_list;
2657 static void
2658 substitute_object_in_subtree (object, placeholder)
2659 Lisp_Object object;
2660 Lisp_Object placeholder;
2662 Lisp_Object check_object;
2664 /* We haven't seen any objects when we start. */
2665 seen_list = Qnil;
2667 /* Make all the substitutions. */
2668 check_object
2669 = substitute_object_recurse (object, placeholder, object);
2671 /* Clear seen_list because we're done with it. */
2672 seen_list = Qnil;
2674 /* The returned object here is expected to always eq the
2675 original. */
2676 if (!EQ (check_object, object))
2677 error ("Unexpected mutation error in reader");
2680 /* Feval doesn't get called from here, so no gc protection is needed. */
2681 #define SUBSTITUTE(get_val, set_val) \
2683 Lisp_Object old_value = get_val; \
2684 Lisp_Object true_value \
2685 = substitute_object_recurse (object, placeholder,\
2686 old_value); \
2688 if (!EQ (old_value, true_value)) \
2690 set_val; \
2694 static Lisp_Object
2695 substitute_object_recurse (object, placeholder, subtree)
2696 Lisp_Object object;
2697 Lisp_Object placeholder;
2698 Lisp_Object subtree;
2700 /* If we find the placeholder, return the target object. */
2701 if (EQ (placeholder, subtree))
2702 return object;
2704 /* If we've been to this node before, don't explore it again. */
2705 if (!EQ (Qnil, Fmemq (subtree, seen_list)))
2706 return subtree;
2708 /* If this node can be the entry point to a cycle, remember that
2709 we've seen it. It can only be such an entry point if it was made
2710 by #n=, which means that we can find it as a value in
2711 read_objects. */
2712 if (!EQ (Qnil, Frassq (subtree, read_objects)))
2713 seen_list = Fcons (subtree, seen_list);
2715 /* Recurse according to subtree's type.
2716 Every branch must return a Lisp_Object. */
2717 switch (XTYPE (subtree))
2719 case Lisp_Vectorlike:
2721 int i;
2722 int length = XINT (Flength(subtree));
2723 for (i = 0; i < length; i++)
2725 Lisp_Object idx = make_number (i);
2726 SUBSTITUTE (Faref (subtree, idx),
2727 Faset (subtree, idx, true_value));
2729 return subtree;
2732 case Lisp_Cons:
2734 SUBSTITUTE (Fcar_safe (subtree),
2735 Fsetcar (subtree, true_value));
2736 SUBSTITUTE (Fcdr_safe (subtree),
2737 Fsetcdr (subtree, true_value));
2738 return subtree;
2741 case Lisp_String:
2743 /* Check for text properties in each interval.
2744 substitute_in_interval contains part of the logic. */
2746 INTERVAL root_interval = STRING_INTERVALS (subtree);
2747 Lisp_Object arg = Fcons (object, placeholder);
2749 traverse_intervals_noorder (root_interval,
2750 &substitute_in_interval, arg);
2752 return subtree;
2755 /* Other types don't recurse any further. */
2756 default:
2757 return subtree;
2761 /* Helper function for substitute_object_recurse. */
2762 static void
2763 substitute_in_interval (interval, arg)
2764 INTERVAL interval;
2765 Lisp_Object arg;
2767 Lisp_Object object = Fcar (arg);
2768 Lisp_Object placeholder = Fcdr (arg);
2770 SUBSTITUTE(interval->plist, interval->plist = true_value);
2774 #define LEAD_INT 1
2775 #define DOT_CHAR 2
2776 #define TRAIL_INT 4
2777 #define E_CHAR 8
2778 #define EXP_INT 16
2781 isfloat_string (cp)
2782 register char *cp;
2784 register int state;
2786 char *start = cp;
2788 state = 0;
2789 if (*cp == '+' || *cp == '-')
2790 cp++;
2792 if (*cp >= '0' && *cp <= '9')
2794 state |= LEAD_INT;
2795 while (*cp >= '0' && *cp <= '9')
2796 cp++;
2798 if (*cp == '.')
2800 state |= DOT_CHAR;
2801 cp++;
2803 if (*cp >= '0' && *cp <= '9')
2805 state |= TRAIL_INT;
2806 while (*cp >= '0' && *cp <= '9')
2807 cp++;
2809 if (*cp == 'e' || *cp == 'E')
2811 state |= E_CHAR;
2812 cp++;
2813 if (*cp == '+' || *cp == '-')
2814 cp++;
2817 if (*cp >= '0' && *cp <= '9')
2819 state |= EXP_INT;
2820 while (*cp >= '0' && *cp <= '9')
2821 cp++;
2823 else if (cp == start)
2825 else if (cp[-1] == '+' && cp[0] == 'I' && cp[1] == 'N' && cp[2] == 'F')
2827 state |= EXP_INT;
2828 cp += 3;
2830 else if (cp[-1] == '+' && cp[0] == 'N' && cp[1] == 'a' && cp[2] == 'N')
2832 state |= EXP_INT;
2833 cp += 3;
2836 return (((*cp == 0) || (*cp == ' ') || (*cp == '\t') || (*cp == '\n') || (*cp == '\r') || (*cp == '\f'))
2837 && (state == (LEAD_INT|DOT_CHAR|TRAIL_INT)
2838 || state == (DOT_CHAR|TRAIL_INT)
2839 || state == (LEAD_INT|E_CHAR|EXP_INT)
2840 || state == (LEAD_INT|DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)
2841 || state == (DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)));
2845 static Lisp_Object
2846 read_vector (readcharfun, bytecodeflag)
2847 Lisp_Object readcharfun;
2848 int bytecodeflag;
2850 register int i;
2851 register int size;
2852 register Lisp_Object *ptr;
2853 register Lisp_Object tem, item, vector;
2854 register struct Lisp_Cons *otem;
2855 Lisp_Object len;
2857 tem = read_list (1, readcharfun);
2858 len = Flength (tem);
2859 vector = (read_pure ? make_pure_vector (XINT (len)) : Fmake_vector (len, Qnil));
2861 size = XVECTOR (vector)->size;
2862 ptr = XVECTOR (vector)->contents;
2863 for (i = 0; i < size; i++)
2865 item = Fcar (tem);
2866 /* If `load-force-doc-strings' is t when reading a lazily-loaded
2867 bytecode object, the docstring containing the bytecode and
2868 constants values must be treated as unibyte and passed to
2869 Fread, to get the actual bytecode string and constants vector. */
2870 if (bytecodeflag && load_force_doc_strings)
2872 if (i == COMPILED_BYTECODE)
2874 if (!STRINGP (item))
2875 error ("Invalid byte code");
2877 /* Delay handling the bytecode slot until we know whether
2878 it is lazily-loaded (we can tell by whether the
2879 constants slot is nil). */
2880 ptr[COMPILED_CONSTANTS] = item;
2881 item = Qnil;
2883 else if (i == COMPILED_CONSTANTS)
2885 Lisp_Object bytestr = ptr[COMPILED_CONSTANTS];
2887 if (NILP (item))
2889 /* Coerce string to unibyte (like string-as-unibyte,
2890 but without generating extra garbage and
2891 guaranteeing no change in the contents). */
2892 STRING_SET_CHARS (bytestr, SBYTES (bytestr));
2893 STRING_SET_UNIBYTE (bytestr);
2895 item = Fread (bytestr);
2896 if (!CONSP (item))
2897 error ("Invalid byte code");
2899 otem = XCONS (item);
2900 bytestr = XCAR (item);
2901 item = XCDR (item);
2902 free_cons (otem);
2905 /* Now handle the bytecode slot. */
2906 ptr[COMPILED_BYTECODE] = read_pure ? Fpurecopy (bytestr) : bytestr;
2909 ptr[i] = read_pure ? Fpurecopy (item) : item;
2910 otem = XCONS (tem);
2911 tem = Fcdr (tem);
2912 free_cons (otem);
2914 return vector;
2917 /* FLAG = 1 means check for ] to terminate rather than ) and .
2918 FLAG = -1 means check for starting with defun
2919 and make structure pure. */
2921 static Lisp_Object
2922 read_list (flag, readcharfun)
2923 int flag;
2924 register Lisp_Object readcharfun;
2926 /* -1 means check next element for defun,
2927 0 means don't check,
2928 1 means already checked and found defun. */
2929 int defunflag = flag < 0 ? -1 : 0;
2930 Lisp_Object val, tail;
2931 register Lisp_Object elt, tem;
2932 struct gcpro gcpro1, gcpro2;
2933 /* 0 is the normal case.
2934 1 means this list is a doc reference; replace it with the number 0.
2935 2 means this list is a doc reference; replace it with the doc string. */
2936 int doc_reference = 0;
2938 /* Initialize this to 1 if we are reading a list. */
2939 int first_in_list = flag <= 0;
2941 val = Qnil;
2942 tail = Qnil;
2944 while (1)
2946 int ch;
2947 GCPRO2 (val, tail);
2948 elt = read1 (readcharfun, &ch, first_in_list);
2949 UNGCPRO;
2951 first_in_list = 0;
2953 /* While building, if the list starts with #$, treat it specially. */
2954 if (EQ (elt, Vload_file_name)
2955 && ! NILP (elt)
2956 && !NILP (Vpurify_flag))
2958 if (NILP (Vdoc_file_name))
2959 /* We have not yet called Snarf-documentation, so assume
2960 this file is described in the DOC-MM.NN file
2961 and Snarf-documentation will fill in the right value later.
2962 For now, replace the whole list with 0. */
2963 doc_reference = 1;
2964 else
2965 /* We have already called Snarf-documentation, so make a relative
2966 file name for this file, so it can be found properly
2967 in the installed Lisp directory.
2968 We don't use Fexpand_file_name because that would make
2969 the directory absolute now. */
2970 elt = concat2 (build_string ("../lisp/"),
2971 Ffile_name_nondirectory (elt));
2973 else if (EQ (elt, Vload_file_name)
2974 && ! NILP (elt)
2975 && load_force_doc_strings)
2976 doc_reference = 2;
2978 if (ch)
2980 if (flag > 0)
2982 if (ch == ']')
2983 return val;
2984 Fsignal (Qinvalid_read_syntax,
2985 Fcons (make_string (") or . in a vector", 18), Qnil));
2987 if (ch == ')')
2988 return val;
2989 if (ch == '.')
2991 GCPRO2 (val, tail);
2992 if (!NILP (tail))
2993 XSETCDR (tail, read0 (readcharfun));
2994 else
2995 val = read0 (readcharfun);
2996 read1 (readcharfun, &ch, 0);
2997 UNGCPRO;
2998 if (ch == ')')
3000 if (doc_reference == 1)
3001 return make_number (0);
3002 if (doc_reference == 2)
3004 /* Get a doc string from the file we are loading.
3005 If it's in saved_doc_string, get it from there. */
3006 int pos = XINT (XCDR (val));
3007 /* Position is negative for user variables. */
3008 if (pos < 0) pos = -pos;
3009 if (pos >= saved_doc_string_position
3010 && pos < (saved_doc_string_position
3011 + saved_doc_string_length))
3013 int start = pos - saved_doc_string_position;
3014 int from, to;
3016 /* Process quoting with ^A,
3017 and find the end of the string,
3018 which is marked with ^_ (037). */
3019 for (from = start, to = start;
3020 saved_doc_string[from] != 037;)
3022 int c = saved_doc_string[from++];
3023 if (c == 1)
3025 c = saved_doc_string[from++];
3026 if (c == 1)
3027 saved_doc_string[to++] = c;
3028 else if (c == '0')
3029 saved_doc_string[to++] = 0;
3030 else if (c == '_')
3031 saved_doc_string[to++] = 037;
3033 else
3034 saved_doc_string[to++] = c;
3037 return make_string (saved_doc_string + start,
3038 to - start);
3040 /* Look in prev_saved_doc_string the same way. */
3041 else if (pos >= prev_saved_doc_string_position
3042 && pos < (prev_saved_doc_string_position
3043 + prev_saved_doc_string_length))
3045 int start = pos - prev_saved_doc_string_position;
3046 int from, to;
3048 /* Process quoting with ^A,
3049 and find the end of the string,
3050 which is marked with ^_ (037). */
3051 for (from = start, to = start;
3052 prev_saved_doc_string[from] != 037;)
3054 int c = prev_saved_doc_string[from++];
3055 if (c == 1)
3057 c = prev_saved_doc_string[from++];
3058 if (c == 1)
3059 prev_saved_doc_string[to++] = c;
3060 else if (c == '0')
3061 prev_saved_doc_string[to++] = 0;
3062 else if (c == '_')
3063 prev_saved_doc_string[to++] = 037;
3065 else
3066 prev_saved_doc_string[to++] = c;
3069 return make_string (prev_saved_doc_string + start,
3070 to - start);
3072 else
3073 return get_doc_string (val, 0, 0);
3076 return val;
3078 return Fsignal (Qinvalid_read_syntax, Fcons (make_string (". in wrong context", 18), Qnil));
3080 return Fsignal (Qinvalid_read_syntax, Fcons (make_string ("] in a list", 11), Qnil));
3082 tem = (read_pure && flag <= 0
3083 ? pure_cons (elt, Qnil)
3084 : Fcons (elt, Qnil));
3085 if (!NILP (tail))
3086 XSETCDR (tail, tem);
3087 else
3088 val = tem;
3089 tail = tem;
3090 if (defunflag < 0)
3091 defunflag = EQ (elt, Qdefun);
3092 else if (defunflag > 0)
3093 read_pure = 1;
3097 Lisp_Object Vobarray;
3098 Lisp_Object initial_obarray;
3100 /* oblookup stores the bucket number here, for the sake of Funintern. */
3102 int oblookup_last_bucket_number;
3104 static int hash_string ();
3106 /* Get an error if OBARRAY is not an obarray.
3107 If it is one, return it. */
3109 Lisp_Object
3110 check_obarray (obarray)
3111 Lisp_Object obarray;
3113 while (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3115 /* If Vobarray is now invalid, force it to be valid. */
3116 if (EQ (Vobarray, obarray)) Vobarray = initial_obarray;
3118 obarray = wrong_type_argument (Qvectorp, obarray);
3120 return obarray;
3123 /* Intern the C string STR: return a symbol with that name,
3124 interned in the current obarray. */
3126 Lisp_Object
3127 intern (str)
3128 const char *str;
3130 Lisp_Object tem;
3131 int len = strlen (str);
3132 Lisp_Object obarray;
3134 obarray = Vobarray;
3135 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3136 obarray = check_obarray (obarray);
3137 tem = oblookup (obarray, str, len, len);
3138 if (SYMBOLP (tem))
3139 return tem;
3140 return Fintern (make_string (str, len), obarray);
3143 /* Create an uninterned symbol with name STR. */
3145 Lisp_Object
3146 make_symbol (str)
3147 char *str;
3149 int len = strlen (str);
3151 return Fmake_symbol ((!NILP (Vpurify_flag)
3152 ? make_pure_string (str, len, len, 0)
3153 : make_string (str, len)));
3156 DEFUN ("intern", Fintern, Sintern, 1, 2, 0,
3157 doc: /* Return the canonical symbol whose name is STRING.
3158 If there is none, one is created by this function and returned.
3159 A second optional argument specifies the obarray to use;
3160 it defaults to the value of `obarray'. */)
3161 (string, obarray)
3162 Lisp_Object string, obarray;
3164 register Lisp_Object tem, sym, *ptr;
3166 if (NILP (obarray)) obarray = Vobarray;
3167 obarray = check_obarray (obarray);
3169 CHECK_STRING (string);
3171 tem = oblookup (obarray, SDATA (string),
3172 SCHARS (string),
3173 SBYTES (string));
3174 if (!INTEGERP (tem))
3175 return tem;
3177 if (!NILP (Vpurify_flag))
3178 string = Fpurecopy (string);
3179 sym = Fmake_symbol (string);
3181 if (EQ (obarray, initial_obarray))
3182 XSYMBOL (sym)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3183 else
3184 XSYMBOL (sym)->interned = SYMBOL_INTERNED;
3186 if ((SREF (string, 0) == ':')
3187 && EQ (obarray, initial_obarray))
3189 XSYMBOL (sym)->constant = 1;
3190 XSYMBOL (sym)->value = sym;
3193 ptr = &XVECTOR (obarray)->contents[XINT (tem)];
3194 if (SYMBOLP (*ptr))
3195 XSYMBOL (sym)->next = XSYMBOL (*ptr);
3196 else
3197 XSYMBOL (sym)->next = 0;
3198 *ptr = sym;
3199 return sym;
3202 DEFUN ("intern-soft", Fintern_soft, Sintern_soft, 1, 2, 0,
3203 doc: /* Return the canonical symbol named NAME, or nil if none exists.
3204 NAME may be a string or a symbol. If it is a symbol, that exact
3205 symbol is searched for.
3206 A second optional argument specifies the obarray to use;
3207 it defaults to the value of `obarray'. */)
3208 (name, obarray)
3209 Lisp_Object name, obarray;
3211 register Lisp_Object tem, string;
3213 if (NILP (obarray)) obarray = Vobarray;
3214 obarray = check_obarray (obarray);
3216 if (!SYMBOLP (name))
3218 CHECK_STRING (name);
3219 string = name;
3221 else
3222 string = SYMBOL_NAME (name);
3224 tem = oblookup (obarray, SDATA (string), SCHARS (string), SBYTES (string));
3225 if (INTEGERP (tem) || (SYMBOLP (name) && !EQ (name, tem)))
3226 return Qnil;
3227 else
3228 return tem;
3231 DEFUN ("unintern", Funintern, Sunintern, 1, 2, 0,
3232 doc: /* Delete the symbol named NAME, if any, from OBARRAY.
3233 The value is t if a symbol was found and deleted, nil otherwise.
3234 NAME may be a string or a symbol. If it is a symbol, that symbol
3235 is deleted, if it belongs to OBARRAY--no other symbol is deleted.
3236 OBARRAY defaults to the value of the variable `obarray'. */)
3237 (name, obarray)
3238 Lisp_Object name, obarray;
3240 register Lisp_Object string, tem;
3241 int hash;
3243 if (NILP (obarray)) obarray = Vobarray;
3244 obarray = check_obarray (obarray);
3246 if (SYMBOLP (name))
3247 string = SYMBOL_NAME (name);
3248 else
3250 CHECK_STRING (name);
3251 string = name;
3254 tem = oblookup (obarray, SDATA (string),
3255 SCHARS (string),
3256 SBYTES (string));
3257 if (INTEGERP (tem))
3258 return Qnil;
3259 /* If arg was a symbol, don't delete anything but that symbol itself. */
3260 if (SYMBOLP (name) && !EQ (name, tem))
3261 return Qnil;
3263 XSYMBOL (tem)->interned = SYMBOL_UNINTERNED;
3264 XSYMBOL (tem)->constant = 0;
3265 XSYMBOL (tem)->indirect_variable = 0;
3267 hash = oblookup_last_bucket_number;
3269 if (EQ (XVECTOR (obarray)->contents[hash], tem))
3271 if (XSYMBOL (tem)->next)
3272 XSETSYMBOL (XVECTOR (obarray)->contents[hash], XSYMBOL (tem)->next);
3273 else
3274 XSETINT (XVECTOR (obarray)->contents[hash], 0);
3276 else
3278 Lisp_Object tail, following;
3280 for (tail = XVECTOR (obarray)->contents[hash];
3281 XSYMBOL (tail)->next;
3282 tail = following)
3284 XSETSYMBOL (following, XSYMBOL (tail)->next);
3285 if (EQ (following, tem))
3287 XSYMBOL (tail)->next = XSYMBOL (following)->next;
3288 break;
3293 return Qt;
3296 /* Return the symbol in OBARRAY whose names matches the string
3297 of SIZE characters (SIZE_BYTE bytes) at PTR.
3298 If there is no such symbol in OBARRAY, return nil.
3300 Also store the bucket number in oblookup_last_bucket_number. */
3302 Lisp_Object
3303 oblookup (obarray, ptr, size, size_byte)
3304 Lisp_Object obarray;
3305 register const char *ptr;
3306 int size, size_byte;
3308 int hash;
3309 int obsize;
3310 register Lisp_Object tail;
3311 Lisp_Object bucket, tem;
3313 if (!VECTORP (obarray)
3314 || (obsize = XVECTOR (obarray)->size) == 0)
3316 obarray = check_obarray (obarray);
3317 obsize = XVECTOR (obarray)->size;
3319 /* This is sometimes needed in the middle of GC. */
3320 obsize &= ~ARRAY_MARK_FLAG;
3321 /* Combining next two lines breaks VMS C 2.3. */
3322 hash = hash_string (ptr, size_byte);
3323 hash %= obsize;
3324 bucket = XVECTOR (obarray)->contents[hash];
3325 oblookup_last_bucket_number = hash;
3326 if (EQ (bucket, make_number (0)))
3328 else if (!SYMBOLP (bucket))
3329 error ("Bad data in guts of obarray"); /* Like CADR error message */
3330 else
3331 for (tail = bucket; ; XSETSYMBOL (tail, XSYMBOL (tail)->next))
3333 if (SBYTES (SYMBOL_NAME (tail)) == size_byte
3334 && SCHARS (SYMBOL_NAME (tail)) == size
3335 && !bcmp (SDATA (SYMBOL_NAME (tail)), ptr, size_byte))
3336 return tail;
3337 else if (XSYMBOL (tail)->next == 0)
3338 break;
3340 XSETINT (tem, hash);
3341 return tem;
3344 static int
3345 hash_string (ptr, len)
3346 const unsigned char *ptr;
3347 int len;
3349 register const unsigned char *p = ptr;
3350 register const unsigned char *end = p + len;
3351 register unsigned char c;
3352 register int hash = 0;
3354 while (p != end)
3356 c = *p++;
3357 if (c >= 0140) c -= 40;
3358 hash = ((hash<<3) + (hash>>28) + c);
3360 return hash & 07777777777;
3363 void
3364 map_obarray (obarray, fn, arg)
3365 Lisp_Object obarray;
3366 void (*fn) P_ ((Lisp_Object, Lisp_Object));
3367 Lisp_Object arg;
3369 register int i;
3370 register Lisp_Object tail;
3371 CHECK_VECTOR (obarray);
3372 for (i = XVECTOR (obarray)->size - 1; i >= 0; i--)
3374 tail = XVECTOR (obarray)->contents[i];
3375 if (SYMBOLP (tail))
3376 while (1)
3378 (*fn) (tail, arg);
3379 if (XSYMBOL (tail)->next == 0)
3380 break;
3381 XSETSYMBOL (tail, XSYMBOL (tail)->next);
3386 void
3387 mapatoms_1 (sym, function)
3388 Lisp_Object sym, function;
3390 call1 (function, sym);
3393 DEFUN ("mapatoms", Fmapatoms, Smapatoms, 1, 2, 0,
3394 doc: /* Call FUNCTION on every symbol in OBARRAY.
3395 OBARRAY defaults to the value of `obarray'. */)
3396 (function, obarray)
3397 Lisp_Object function, obarray;
3399 if (NILP (obarray)) obarray = Vobarray;
3400 obarray = check_obarray (obarray);
3402 map_obarray (obarray, mapatoms_1, function);
3403 return Qnil;
3406 #define OBARRAY_SIZE 1511
3408 void
3409 init_obarray ()
3411 Lisp_Object oblength;
3412 int hash;
3413 Lisp_Object *tem;
3415 XSETFASTINT (oblength, OBARRAY_SIZE);
3417 Qnil = Fmake_symbol (make_pure_string ("nil", 3, 3, 0));
3418 Vobarray = Fmake_vector (oblength, make_number (0));
3419 initial_obarray = Vobarray;
3420 staticpro (&initial_obarray);
3421 /* Intern nil in the obarray */
3422 XSYMBOL (Qnil)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3423 XSYMBOL (Qnil)->constant = 1;
3425 /* These locals are to kludge around a pyramid compiler bug. */
3426 hash = hash_string ("nil", 3);
3427 /* Separate statement here to avoid VAXC bug. */
3428 hash %= OBARRAY_SIZE;
3429 tem = &XVECTOR (Vobarray)->contents[hash];
3430 *tem = Qnil;
3432 Qunbound = Fmake_symbol (make_pure_string ("unbound", 7, 7, 0));
3433 XSYMBOL (Qnil)->function = Qunbound;
3434 XSYMBOL (Qunbound)->value = Qunbound;
3435 XSYMBOL (Qunbound)->function = Qunbound;
3437 Qt = intern ("t");
3438 XSYMBOL (Qnil)->value = Qnil;
3439 XSYMBOL (Qnil)->plist = Qnil;
3440 XSYMBOL (Qt)->value = Qt;
3441 XSYMBOL (Qt)->constant = 1;
3443 /* Qt is correct even if CANNOT_DUMP. loadup.el will set to nil at end. */
3444 Vpurify_flag = Qt;
3446 Qvariable_documentation = intern ("variable-documentation");
3447 staticpro (&Qvariable_documentation);
3449 read_buffer_size = 100 + MAX_MULTIBYTE_LENGTH;
3450 read_buffer = (char *) xmalloc (read_buffer_size);
3453 void
3454 defsubr (sname)
3455 struct Lisp_Subr *sname;
3457 Lisp_Object sym;
3458 sym = intern (sname->symbol_name);
3459 XSETSUBR (XSYMBOL (sym)->function, sname);
3462 #ifdef NOTDEF /* use fset in subr.el now */
3463 void
3464 defalias (sname, string)
3465 struct Lisp_Subr *sname;
3466 char *string;
3468 Lisp_Object sym;
3469 sym = intern (string);
3470 XSETSUBR (XSYMBOL (sym)->function, sname);
3472 #endif /* NOTDEF */
3474 /* Define an "integer variable"; a symbol whose value is forwarded
3475 to a C variable of type int. Sample call: */
3476 /* DEFVAR_INT ("indent-tabs-mode", &indent_tabs_mode, "Documentation"); */
3477 void
3478 defvar_int (namestring, address)
3479 char *namestring;
3480 EMACS_INT *address;
3482 Lisp_Object sym, val;
3483 sym = intern (namestring);
3484 val = allocate_misc ();
3485 XMISCTYPE (val) = Lisp_Misc_Intfwd;
3486 XINTFWD (val)->intvar = address;
3487 SET_SYMBOL_VALUE (sym, val);
3490 /* Similar but define a variable whose value is t if address contains 1,
3491 nil if address contains 0 */
3492 void
3493 defvar_bool (namestring, address)
3494 char *namestring;
3495 int *address;
3497 Lisp_Object sym, val;
3498 sym = intern (namestring);
3499 val = allocate_misc ();
3500 XMISCTYPE (val) = Lisp_Misc_Boolfwd;
3501 XBOOLFWD (val)->boolvar = address;
3502 SET_SYMBOL_VALUE (sym, val);
3503 Vbyte_boolean_vars = Fcons (sym, Vbyte_boolean_vars);
3506 /* Similar but define a variable whose value is the Lisp Object stored
3507 at address. Two versions: with and without gc-marking of the C
3508 variable. The nopro version is used when that variable will be
3509 gc-marked for some other reason, since marking the same slot twice
3510 can cause trouble with strings. */
3511 void
3512 defvar_lisp_nopro (namestring, address)
3513 char *namestring;
3514 Lisp_Object *address;
3516 Lisp_Object sym, val;
3517 sym = intern (namestring);
3518 val = allocate_misc ();
3519 XMISCTYPE (val) = Lisp_Misc_Objfwd;
3520 XOBJFWD (val)->objvar = address;
3521 SET_SYMBOL_VALUE (sym, val);
3524 void
3525 defvar_lisp (namestring, address)
3526 char *namestring;
3527 Lisp_Object *address;
3529 defvar_lisp_nopro (namestring, address);
3530 staticpro (address);
3533 /* Similar but define a variable whose value is the Lisp Object stored in
3534 the current buffer. address is the address of the slot in the buffer
3535 that is current now. */
3537 void
3538 defvar_per_buffer (namestring, address, type, doc)
3539 char *namestring;
3540 Lisp_Object *address;
3541 Lisp_Object type;
3542 char *doc;
3544 Lisp_Object sym, val;
3545 int offset;
3547 sym = intern (namestring);
3548 val = allocate_misc ();
3549 offset = (char *)address - (char *)current_buffer;
3551 XMISCTYPE (val) = Lisp_Misc_Buffer_Objfwd;
3552 XBUFFER_OBJFWD (val)->offset = offset;
3553 SET_SYMBOL_VALUE (sym, val);
3554 PER_BUFFER_SYMBOL (offset) = sym;
3555 PER_BUFFER_TYPE (offset) = type;
3557 if (PER_BUFFER_IDX (offset) == 0)
3558 /* Did a DEFVAR_PER_BUFFER without initializing the corresponding
3559 slot of buffer_local_flags */
3560 abort ();
3564 /* Similar but define a variable whose value is the Lisp Object stored
3565 at a particular offset in the current kboard object. */
3567 void
3568 defvar_kboard (namestring, offset)
3569 char *namestring;
3570 int offset;
3572 Lisp_Object sym, val;
3573 sym = intern (namestring);
3574 val = allocate_misc ();
3575 XMISCTYPE (val) = Lisp_Misc_Kboard_Objfwd;
3576 XKBOARD_OBJFWD (val)->offset = offset;
3577 SET_SYMBOL_VALUE (sym, val);
3580 /* Record the value of load-path used at the start of dumping
3581 so we can see if the site changed it later during dumping. */
3582 static Lisp_Object dump_path;
3584 void
3585 init_lread ()
3587 char *normal;
3588 int turn_off_warning = 0;
3590 /* Compute the default load-path. */
3591 #ifdef CANNOT_DUMP
3592 normal = PATH_LOADSEARCH;
3593 Vload_path = decode_env_path (0, normal);
3594 #else
3595 if (NILP (Vpurify_flag))
3596 normal = PATH_LOADSEARCH;
3597 else
3598 normal = PATH_DUMPLOADSEARCH;
3600 /* In a dumped Emacs, we normally have to reset the value of
3601 Vload_path from PATH_LOADSEARCH, since the value that was dumped
3602 uses ../lisp, instead of the path of the installed elisp
3603 libraries. However, if it appears that Vload_path was changed
3604 from the default before dumping, don't override that value. */
3605 if (initialized)
3607 if (! NILP (Fequal (dump_path, Vload_path)))
3609 Vload_path = decode_env_path (0, normal);
3610 if (!NILP (Vinstallation_directory))
3612 Lisp_Object tem, tem1, sitelisp;
3614 /* Remove site-lisp dirs from path temporarily and store
3615 them in sitelisp, then conc them on at the end so
3616 they're always first in path. */
3617 sitelisp = Qnil;
3618 while (1)
3620 tem = Fcar (Vload_path);
3621 tem1 = Fstring_match (build_string ("site-lisp"),
3622 tem, Qnil);
3623 if (!NILP (tem1))
3625 Vload_path = Fcdr (Vload_path);
3626 sitelisp = Fcons (tem, sitelisp);
3628 else
3629 break;
3632 /* Add to the path the lisp subdir of the
3633 installation dir, if it exists. */
3634 tem = Fexpand_file_name (build_string ("lisp"),
3635 Vinstallation_directory);
3636 tem1 = Ffile_exists_p (tem);
3637 if (!NILP (tem1))
3639 if (NILP (Fmember (tem, Vload_path)))
3641 turn_off_warning = 1;
3642 Vload_path = Fcons (tem, Vload_path);
3645 else
3646 /* That dir doesn't exist, so add the build-time
3647 Lisp dirs instead. */
3648 Vload_path = nconc2 (Vload_path, dump_path);
3650 /* Add leim under the installation dir, if it exists. */
3651 tem = Fexpand_file_name (build_string ("leim"),
3652 Vinstallation_directory);
3653 tem1 = Ffile_exists_p (tem);
3654 if (!NILP (tem1))
3656 if (NILP (Fmember (tem, Vload_path)))
3657 Vload_path = Fcons (tem, Vload_path);
3660 /* Add site-list under the installation dir, if it exists. */
3661 tem = Fexpand_file_name (build_string ("site-lisp"),
3662 Vinstallation_directory);
3663 tem1 = Ffile_exists_p (tem);
3664 if (!NILP (tem1))
3666 if (NILP (Fmember (tem, Vload_path)))
3667 Vload_path = Fcons (tem, Vload_path);
3670 /* If Emacs was not built in the source directory,
3671 and it is run from where it was built, add to load-path
3672 the lisp, leim and site-lisp dirs under that directory. */
3674 if (NILP (Fequal (Vinstallation_directory, Vsource_directory)))
3676 Lisp_Object tem2;
3678 tem = Fexpand_file_name (build_string ("src/Makefile"),
3679 Vinstallation_directory);
3680 tem1 = Ffile_exists_p (tem);
3682 /* Don't be fooled if they moved the entire source tree
3683 AFTER dumping Emacs. If the build directory is indeed
3684 different from the source dir, src/Makefile.in and
3685 src/Makefile will not be found together. */
3686 tem = Fexpand_file_name (build_string ("src/Makefile.in"),
3687 Vinstallation_directory);
3688 tem2 = Ffile_exists_p (tem);
3689 if (!NILP (tem1) && NILP (tem2))
3691 tem = Fexpand_file_name (build_string ("lisp"),
3692 Vsource_directory);
3694 if (NILP (Fmember (tem, Vload_path)))
3695 Vload_path = Fcons (tem, Vload_path);
3697 tem = Fexpand_file_name (build_string ("leim"),
3698 Vsource_directory);
3700 if (NILP (Fmember (tem, Vload_path)))
3701 Vload_path = Fcons (tem, Vload_path);
3703 tem = Fexpand_file_name (build_string ("site-lisp"),
3704 Vsource_directory);
3706 if (NILP (Fmember (tem, Vload_path)))
3707 Vload_path = Fcons (tem, Vload_path);
3710 if (!NILP (sitelisp))
3711 Vload_path = nconc2 (Fnreverse (sitelisp), Vload_path);
3715 else
3717 /* NORMAL refers to the lisp dir in the source directory. */
3718 /* We used to add ../lisp at the front here, but
3719 that caused trouble because it was copied from dump_path
3720 into Vload_path, aboe, when Vinstallation_directory was non-nil.
3721 It should be unnecessary. */
3722 Vload_path = decode_env_path (0, normal);
3723 dump_path = Vload_path;
3725 #endif
3727 #if (!(defined(WINDOWSNT) || (defined(HAVE_CARBON))))
3728 /* When Emacs is invoked over network shares on NT, PATH_LOADSEARCH is
3729 almost never correct, thereby causing a warning to be printed out that
3730 confuses users. Since PATH_LOADSEARCH is always overridden by the
3731 EMACSLOADPATH environment variable below, disable the warning on NT.
3732 Also, when using the "self-contained" option for Carbon Emacs for MacOSX,
3733 the "standard" paths may not exist and would be overridden by
3734 EMACSLOADPATH as on NT. Since this depends on how the executable
3735 was build and packaged, turn off the warnings in general */
3737 /* Warn if dirs in the *standard* path don't exist. */
3738 if (!turn_off_warning)
3740 Lisp_Object path_tail;
3742 for (path_tail = Vload_path;
3743 !NILP (path_tail);
3744 path_tail = XCDR (path_tail))
3746 Lisp_Object dirfile;
3747 dirfile = Fcar (path_tail);
3748 if (STRINGP (dirfile))
3750 dirfile = Fdirectory_file_name (dirfile);
3751 if (access (SDATA (dirfile), 0) < 0)
3752 dir_warning ("Warning: Lisp directory `%s' does not exist.\n",
3753 XCAR (path_tail));
3757 #endif /* !(WINDOWSNT || HAVE_CARBON) */
3759 /* If the EMACSLOADPATH environment variable is set, use its value.
3760 This doesn't apply if we're dumping. */
3761 #ifndef CANNOT_DUMP
3762 if (NILP (Vpurify_flag)
3763 && egetenv ("EMACSLOADPATH"))
3764 #endif
3765 Vload_path = decode_env_path ("EMACSLOADPATH", normal);
3767 Vvalues = Qnil;
3769 load_in_progress = 0;
3770 Vload_file_name = Qnil;
3772 load_descriptor_list = Qnil;
3774 Vstandard_input = Qt;
3775 Vloads_in_progress = Qnil;
3778 /* Print a warning, using format string FORMAT, that directory DIRNAME
3779 does not exist. Print it on stderr and put it in *Message*. */
3781 void
3782 dir_warning (format, dirname)
3783 char *format;
3784 Lisp_Object dirname;
3786 char *buffer
3787 = (char *) alloca (SCHARS (dirname) + strlen (format) + 5);
3789 fprintf (stderr, format, SDATA (dirname));
3790 sprintf (buffer, format, SDATA (dirname));
3791 /* Don't log the warning before we've initialized!! */
3792 if (initialized)
3793 message_dolog (buffer, strlen (buffer), 0, STRING_MULTIBYTE (dirname));
3796 void
3797 syms_of_lread ()
3799 defsubr (&Sread);
3800 defsubr (&Sread_from_string);
3801 defsubr (&Sintern);
3802 defsubr (&Sintern_soft);
3803 defsubr (&Sunintern);
3804 defsubr (&Sload);
3805 defsubr (&Seval_buffer);
3806 defsubr (&Seval_region);
3807 defsubr (&Sread_char);
3808 defsubr (&Sread_char_exclusive);
3809 defsubr (&Sread_event);
3810 defsubr (&Sget_file_char);
3811 defsubr (&Smapatoms);
3812 defsubr (&Slocate_file_internal);
3814 DEFVAR_LISP ("obarray", &Vobarray,
3815 doc: /* Symbol table for use by `intern' and `read'.
3816 It is a vector whose length ought to be prime for best results.
3817 The vector's contents don't make sense if examined from Lisp programs;
3818 to find all the symbols in an obarray, use `mapatoms'. */);
3820 DEFVAR_LISP ("values", &Vvalues,
3821 doc: /* List of values of all expressions which were read, evaluated and printed.
3822 Order is reverse chronological. */);
3824 DEFVAR_LISP ("standard-input", &Vstandard_input,
3825 doc: /* Stream for read to get input from.
3826 See documentation of `read' for possible values. */);
3827 Vstandard_input = Qt;
3829 DEFVAR_LISP ("read-with-symbol-positions", &Vread_with_symbol_positions,
3830 doc: /* If non-nil, add position of read symbols to `read-symbol-positions-list'.
3832 If this variable is a buffer, then only forms read from that buffer
3833 will be added to `read-symbol-positions-list'.
3834 If this variable is t, then all read forms will be added.
3835 The effect of all other values other than nil are not currently
3836 defined, although they may be in the future.
3838 The positions are relative to the last call to `read' or
3839 `read-from-string'. It is probably a bad idea to set this variable at
3840 the toplevel; bind it instead. */);
3841 Vread_with_symbol_positions = Qnil;
3843 DEFVAR_LISP ("read-symbol-positions-list", &Vread_symbol_positions_list,
3844 doc: /* A list mapping read symbols to their positions.
3845 This variable is modified during calls to `read' or
3846 `read-from-string', but only when `read-with-symbol-positions' is
3847 non-nil.
3849 Each element of the list looks like (SYMBOL . CHAR-POSITION), where
3850 CHAR-POSITION is an integer giving the offset of that occurrence of the
3851 symbol from the position where `read' or `read-from-string' started.
3853 Note that a symbol will appear multiple times in this list, if it was
3854 read multiple times. The list is in the same order as the symbols
3855 were read in. */);
3856 Vread_symbol_positions_list = Qnil;
3858 DEFVAR_LISP ("load-path", &Vload_path,
3859 doc: /* *List of directories to search for files to load.
3860 Each element is a string (directory name) or nil (try default directory).
3861 Initialized based on EMACSLOADPATH environment variable, if any,
3862 otherwise to default specified by file `epaths.h' when Emacs was built. */);
3864 DEFVAR_LISP ("load-suffixes", &Vload_suffixes,
3865 doc: /* *List of suffixes to try for files to load.
3866 This list should not include the empty string. */);
3867 Vload_suffixes = Fcons (build_string (".elc"),
3868 Fcons (build_string (".el"), Qnil));
3869 /* We don't use empty_string because it's not initialized yet. */
3870 default_suffixes = Fcons (build_string (""), Qnil);
3871 staticpro (&default_suffixes);
3873 DEFVAR_BOOL ("load-in-progress", &load_in_progress,
3874 doc: /* Non-nil iff inside of `load'. */);
3876 DEFVAR_LISP ("after-load-alist", &Vafter_load_alist,
3877 doc: /* An alist of expressions to be evalled when particular files are loaded.
3878 Each element looks like (FILENAME FORMS...).
3879 When `load' is run and the file-name argument is FILENAME,
3880 the FORMS in the corresponding element are executed at the end of loading.
3882 FILENAME must match exactly! Normally FILENAME is the name of a library,
3883 with no directory specified, since that is how `load' is normally called.
3884 An error in FORMS does not undo the load,
3885 but does prevent execution of the rest of the FORMS.
3886 FILENAME can also be a symbol (a feature) and FORMS are then executed
3887 when the corresponding call to `provide' is made. */);
3888 Vafter_load_alist = Qnil;
3890 DEFVAR_LISP ("load-history", &Vload_history,
3891 doc: /* Alist mapping file names to symbols and features.
3892 Each alist element is a list that starts with a file name,
3893 except for one element (optional) that starts with nil and describes
3894 definitions evaluated from buffers not visiting files.
3895 The remaining elements of each list are symbols defined as variables
3896 and cons cells of the form `(provide . FEATURE)', `(require . FEATURE)',
3897 `(defun . FUNCTION)', `(autoload . SYMBOL)', and `(t . SYMBOL)'.
3898 An element `(t . SYMBOL)' precedes an entry `(defun . FUNCTION)',
3899 and means that SYMBOL was an autoload before this file redefined it
3900 as a function.
3902 During preloading, the file name recorded is relative to the main Lisp
3903 directory. These file names are converted to absolute at startup. */);
3904 Vload_history = Qnil;
3906 DEFVAR_LISP ("load-file-name", &Vload_file_name,
3907 doc: /* Full name of file being loaded by `load'. */);
3908 Vload_file_name = Qnil;
3910 DEFVAR_LISP ("user-init-file", &Vuser_init_file,
3911 doc: /* File name, including directory, of user's initialization file.
3912 If the file loaded had extension `.elc', and the corresponding source file
3913 exists, this variable contains the name of source file, suitable for use
3914 by functions like `custom-save-all' which edit the init file. */);
3915 Vuser_init_file = Qnil;
3917 DEFVAR_LISP ("current-load-list", &Vcurrent_load_list,
3918 doc: /* Used for internal purposes by `load'. */);
3919 Vcurrent_load_list = Qnil;
3921 DEFVAR_LISP ("load-read-function", &Vload_read_function,
3922 doc: /* Function used by `load' and `eval-region' for reading expressions.
3923 The default is nil, which means use the function `read'. */);
3924 Vload_read_function = Qnil;
3926 DEFVAR_LISP ("load-source-file-function", &Vload_source_file_function,
3927 doc: /* Function called in `load' for loading an Emacs lisp source file.
3928 This function is for doing code conversion before reading the source file.
3929 If nil, loading is done without any code conversion.
3930 Arguments are FULLNAME, FILE, NOERROR, NOMESSAGE, where
3931 FULLNAME is the full name of FILE.
3932 See `load' for the meaning of the remaining arguments. */);
3933 Vload_source_file_function = Qnil;
3935 DEFVAR_BOOL ("load-force-doc-strings", &load_force_doc_strings,
3936 doc: /* Non-nil means `load' should force-load all dynamic doc strings.
3937 This is useful when the file being loaded is a temporary copy. */);
3938 load_force_doc_strings = 0;
3940 DEFVAR_BOOL ("load-convert-to-unibyte", &load_convert_to_unibyte,
3941 doc: /* Non-nil means `read' converts strings to unibyte whenever possible.
3942 This is normally bound by `load' and `eval-buffer' to control `read',
3943 and is not meant for users to change. */);
3944 load_convert_to_unibyte = 0;
3946 DEFVAR_LISP ("source-directory", &Vsource_directory,
3947 doc: /* Directory in which Emacs sources were found when Emacs was built.
3948 You cannot count on them to still be there! */);
3949 Vsource_directory
3950 = Fexpand_file_name (build_string ("../"),
3951 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH)));
3953 DEFVAR_LISP ("preloaded-file-list", &Vpreloaded_file_list,
3954 doc: /* List of files that were preloaded (when dumping Emacs). */);
3955 Vpreloaded_file_list = Qnil;
3957 DEFVAR_LISP ("byte-boolean-vars", &Vbyte_boolean_vars,
3958 doc: /* List of all DEFVAR_BOOL variables, used by the byte code optimizer. */);
3959 Vbyte_boolean_vars = Qnil;
3961 DEFVAR_BOOL ("load-dangerous-libraries", &load_dangerous_libraries,
3962 doc: /* Non-nil means load dangerous compiled Lisp files.
3963 Some versions of XEmacs use different byte codes than Emacs. These
3964 incompatible byte codes can make Emacs crash when it tries to execute
3965 them. */);
3966 load_dangerous_libraries = 0;
3968 DEFVAR_LISP ("bytecomp-version-regexp", &Vbytecomp_version_regexp,
3969 doc: /* Regular expression matching safe to load compiled Lisp files.
3970 When Emacs loads a compiled Lisp file, it reads the first 512 bytes
3971 from the file, and matches them against this regular expression.
3972 When the regular expression matches, the file is considered to be safe
3973 to load. See also `load-dangerous-libraries'. */);
3974 Vbytecomp_version_regexp
3975 = build_string ("^;;;.\\(in Emacs version\\|bytecomp version FSF\\)");
3977 DEFVAR_LISP ("eval-buffer-list", &Veval_buffer_list,
3978 doc: /* List of buffers being read from by calls to `eval-buffer' and `eval-region'. */);
3979 Veval_buffer_list = Qnil;
3981 /* Vsource_directory was initialized in init_lread. */
3983 load_descriptor_list = Qnil;
3984 staticpro (&load_descriptor_list);
3986 Qcurrent_load_list = intern ("current-load-list");
3987 staticpro (&Qcurrent_load_list);
3989 Qstandard_input = intern ("standard-input");
3990 staticpro (&Qstandard_input);
3992 Qread_char = intern ("read-char");
3993 staticpro (&Qread_char);
3995 Qget_file_char = intern ("get-file-char");
3996 staticpro (&Qget_file_char);
3998 Qbackquote = intern ("`");
3999 staticpro (&Qbackquote);
4000 Qcomma = intern (",");
4001 staticpro (&Qcomma);
4002 Qcomma_at = intern (",@");
4003 staticpro (&Qcomma_at);
4004 Qcomma_dot = intern (",.");
4005 staticpro (&Qcomma_dot);
4007 Qinhibit_file_name_operation = intern ("inhibit-file-name-operation");
4008 staticpro (&Qinhibit_file_name_operation);
4010 Qascii_character = intern ("ascii-character");
4011 staticpro (&Qascii_character);
4013 Qfunction = intern ("function");
4014 staticpro (&Qfunction);
4016 Qload = intern ("load");
4017 staticpro (&Qload);
4019 Qload_file_name = intern ("load-file-name");
4020 staticpro (&Qload_file_name);
4022 Qeval_buffer_list = intern ("eval-buffer-list");
4023 staticpro (&Qeval_buffer_list);
4025 staticpro (&dump_path);
4027 staticpro (&read_objects);
4028 read_objects = Qnil;
4029 staticpro (&seen_list);
4030 seen_list = Qnil;
4032 Vloads_in_progress = Qnil;
4033 staticpro (&Vloads_in_progress);
4036 /* arch-tag: a0d02733-0f96-4844-a659-9fd53c4f414d
4037 (do not change this comment) */