* keyboard.c (parse_modifiers_uncached, parse_modifiers):
[emacs.git] / src / lread.c
bloba5fd1513c3915b344e1c0ddc36aa85cbc4ce29d5
1 /* Lisp parsing and input streams.
3 Copyright (C) 1985-1989, 1993-1995, 1997-2011 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 #include <config.h>
22 #include <stdio.h>
23 #include <sys/types.h>
24 #include <sys/stat.h>
25 #include <sys/file.h>
26 #include <errno.h>
27 #include <setjmp.h>
28 #include "lisp.h"
29 #include "intervals.h"
30 #include "buffer.h"
31 #include "character.h"
32 #include "charset.h"
33 #include "coding.h"
34 #include <epaths.h>
35 #include "commands.h"
36 #include "keyboard.h"
37 #include "frame.h"
38 #include "termhooks.h"
39 #include "coding.h"
40 #include "blockinput.h"
42 #ifdef MSDOS
43 #include "msdos.h"
44 #endif
46 #include <unistd.h>
47 #include <math.h>
49 #ifdef HAVE_SETLOCALE
50 #include <locale.h>
51 #endif /* HAVE_SETLOCALE */
53 #include <fcntl.h>
55 #ifdef HAVE_FSEEKO
56 #define file_offset off_t
57 #define file_tell ftello
58 #else
59 #define file_offset long
60 #define file_tell ftell
61 #endif
63 /* hash table read constants */
64 Lisp_Object Qhash_table, Qdata;
65 Lisp_Object Qtest, Qsize;
66 Lisp_Object Qweakness;
67 Lisp_Object Qrehash_size;
68 Lisp_Object Qrehash_threshold;
70 Lisp_Object Qread_char, Qget_file_char, Qstandard_input, Qcurrent_load_list;
71 Lisp_Object Qvariable_documentation;
72 Lisp_Object Qascii_character, Qload, Qload_file_name;
73 Lisp_Object Qbackquote, Qcomma, Qcomma_at, Qcomma_dot, Qfunction;
74 Lisp_Object Qinhibit_file_name_operation;
75 Lisp_Object Qeval_buffer_list;
76 Lisp_Object Qfile_truename, Qdo_after_load_evaluation; /* ACM 2006/5/16 */
78 /* Used instead of Qget_file_char while loading *.elc files compiled
79 by Emacs 21 or older. */
80 static Lisp_Object Qget_emacs_mule_file_char;
82 static Lisp_Object Qload_force_doc_strings;
84 static Lisp_Object Qload_in_progress;
86 /* The association list of objects read with the #n=object form.
87 Each member of the list has the form (n . object), and is used to
88 look up the object for the corresponding #n# construct.
89 It must be set to nil before all top-level calls to read0. */
90 Lisp_Object read_objects;
92 /* Nonzero means READCHAR should read bytes one by one (not character)
93 when READCHARFUN is Qget_file_char or Qget_emacs_mule_file_char.
94 This is set to 1 by read1 temporarily while handling #@NUMBER. */
95 static int load_each_byte;
97 /* List of descriptors now open for Fload. */
98 static Lisp_Object load_descriptor_list;
100 /* File for get_file_char to read from. Use by load. */
101 static FILE *instream;
103 /* When nonzero, read conses in pure space */
104 static int read_pure;
106 /* For use within read-from-string (this reader is non-reentrant!!) */
107 static EMACS_INT read_from_string_index;
108 static EMACS_INT read_from_string_index_byte;
109 static EMACS_INT read_from_string_limit;
111 /* Number of characters read in the current call to Fread or
112 Fread_from_string. */
113 static EMACS_INT readchar_count;
115 /* This contains the last string skipped with #@. */
116 static char *saved_doc_string;
117 /* Length of buffer allocated in saved_doc_string. */
118 static int saved_doc_string_size;
119 /* Length of actual data in saved_doc_string. */
120 static int saved_doc_string_length;
121 /* This is the file position that string came from. */
122 static file_offset saved_doc_string_position;
124 /* This contains the previous string skipped with #@.
125 We copy it from saved_doc_string when a new string
126 is put in saved_doc_string. */
127 static char *prev_saved_doc_string;
128 /* Length of buffer allocated in prev_saved_doc_string. */
129 static int prev_saved_doc_string_size;
130 /* Length of actual data in prev_saved_doc_string. */
131 static int prev_saved_doc_string_length;
132 /* This is the file position that string came from. */
133 static file_offset prev_saved_doc_string_position;
135 /* Nonzero means inside a new-style backquote
136 with no surrounding parentheses.
137 Fread initializes this to zero, so we need not specbind it
138 or worry about what happens to it when there is an error. */
139 static int new_backquote_flag;
140 static Lisp_Object Qold_style_backquotes;
142 /* A list of file names for files being loaded in Fload. Used to
143 check for recursive loads. */
145 static Lisp_Object Vloads_in_progress;
147 static int read_emacs_mule_char (int, int (*) (int, Lisp_Object),
148 Lisp_Object);
150 static void readevalloop (Lisp_Object, FILE*, Lisp_Object,
151 Lisp_Object (*) (Lisp_Object), int,
152 Lisp_Object, Lisp_Object,
153 Lisp_Object, Lisp_Object);
154 static Lisp_Object load_unwind (Lisp_Object);
155 static Lisp_Object load_descriptor_unwind (Lisp_Object);
157 static void invalid_syntax (const char *, int) NO_RETURN;
158 static void end_of_file_error (void) NO_RETURN;
161 /* Functions that read one byte from the current source READCHARFUN
162 or unreads one byte. If the integer argument C is -1, it returns
163 one read byte, or -1 when there's no more byte in the source. If C
164 is 0 or positive, it unreads C, and the return value is not
165 interesting. */
167 static int readbyte_for_lambda (int, Lisp_Object);
168 static int readbyte_from_file (int, Lisp_Object);
169 static int readbyte_from_string (int, Lisp_Object);
171 /* Handle unreading and rereading of characters.
172 Write READCHAR to read a character,
173 UNREAD(c) to unread c to be read again.
175 These macros correctly read/unread multibyte characters. */
177 #define READCHAR readchar (readcharfun, NULL)
178 #define UNREAD(c) unreadchar (readcharfun, c)
180 /* Same as READCHAR but set *MULTIBYTE to the multibyteness of the source. */
181 #define READCHAR_REPORT_MULTIBYTE(multibyte) readchar (readcharfun, multibyte)
183 /* When READCHARFUN is Qget_file_char, Qget_emacs_mule_file_char,
184 Qlambda, or a cons, we use this to keep an unread character because
185 a file stream can't handle multibyte-char unreading. The value -1
186 means that there's no unread character. */
187 static int unread_char;
189 static int
190 readchar (Lisp_Object readcharfun, int *multibyte)
192 Lisp_Object tem;
193 register int c;
194 int (*readbyte) (int, Lisp_Object);
195 unsigned char buf[MAX_MULTIBYTE_LENGTH];
196 int i, len;
197 int emacs_mule_encoding = 0;
199 if (multibyte)
200 *multibyte = 0;
202 readchar_count++;
204 if (BUFFERP (readcharfun))
206 register struct buffer *inbuffer = XBUFFER (readcharfun);
208 EMACS_INT pt_byte = BUF_PT_BYTE (inbuffer);
210 if (pt_byte >= BUF_ZV_BYTE (inbuffer))
211 return -1;
213 if (! NILP (BVAR (inbuffer, enable_multibyte_characters)))
215 /* Fetch the character code from the buffer. */
216 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, pt_byte);
217 BUF_INC_POS (inbuffer, pt_byte);
218 c = STRING_CHAR (p);
219 if (multibyte)
220 *multibyte = 1;
222 else
224 c = BUF_FETCH_BYTE (inbuffer, pt_byte);
225 if (! ASCII_BYTE_P (c))
226 c = BYTE8_TO_CHAR (c);
227 pt_byte++;
229 SET_BUF_PT_BOTH (inbuffer, BUF_PT (inbuffer) + 1, pt_byte);
231 return c;
233 if (MARKERP (readcharfun))
235 register struct buffer *inbuffer = XMARKER (readcharfun)->buffer;
237 EMACS_INT bytepos = marker_byte_position (readcharfun);
239 if (bytepos >= BUF_ZV_BYTE (inbuffer))
240 return -1;
242 if (! NILP (BVAR (inbuffer, enable_multibyte_characters)))
244 /* Fetch the character code from the buffer. */
245 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, bytepos);
246 BUF_INC_POS (inbuffer, bytepos);
247 c = STRING_CHAR (p);
248 if (multibyte)
249 *multibyte = 1;
251 else
253 c = BUF_FETCH_BYTE (inbuffer, bytepos);
254 if (! ASCII_BYTE_P (c))
255 c = BYTE8_TO_CHAR (c);
256 bytepos++;
259 XMARKER (readcharfun)->bytepos = bytepos;
260 XMARKER (readcharfun)->charpos++;
262 return c;
265 if (EQ (readcharfun, Qlambda))
267 readbyte = readbyte_for_lambda;
268 goto read_multibyte;
271 if (EQ (readcharfun, Qget_file_char))
273 readbyte = readbyte_from_file;
274 goto read_multibyte;
277 if (STRINGP (readcharfun))
279 if (read_from_string_index >= read_from_string_limit)
280 c = -1;
281 else if (STRING_MULTIBYTE (readcharfun))
283 if (multibyte)
284 *multibyte = 1;
285 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c, readcharfun,
286 read_from_string_index,
287 read_from_string_index_byte);
289 else
291 c = SREF (readcharfun, read_from_string_index_byte);
292 read_from_string_index++;
293 read_from_string_index_byte++;
295 return c;
298 if (CONSP (readcharfun))
300 /* This is the case that read_vector is reading from a unibyte
301 string that contains a byte sequence previously skipped
302 because of #@NUMBER. The car part of readcharfun is that
303 string, and the cdr part is a value of readcharfun given to
304 read_vector. */
305 readbyte = readbyte_from_string;
306 if (EQ (XCDR (readcharfun), Qget_emacs_mule_file_char))
307 emacs_mule_encoding = 1;
308 goto read_multibyte;
311 if (EQ (readcharfun, Qget_emacs_mule_file_char))
313 readbyte = readbyte_from_file;
314 emacs_mule_encoding = 1;
315 goto read_multibyte;
318 tem = call0 (readcharfun);
320 if (NILP (tem))
321 return -1;
322 return XINT (tem);
324 read_multibyte:
325 if (unread_char >= 0)
327 c = unread_char;
328 unread_char = -1;
329 return c;
331 c = (*readbyte) (-1, readcharfun);
332 if (c < 0 || load_each_byte)
333 return c;
334 if (multibyte)
335 *multibyte = 1;
336 if (ASCII_BYTE_P (c))
337 return c;
338 if (emacs_mule_encoding)
339 return read_emacs_mule_char (c, readbyte, readcharfun);
340 i = 0;
341 buf[i++] = c;
342 len = BYTES_BY_CHAR_HEAD (c);
343 while (i < len)
345 c = (*readbyte) (-1, readcharfun);
346 if (c < 0 || ! TRAILING_CODE_P (c))
348 while (--i > 1)
349 (*readbyte) (buf[i], readcharfun);
350 return BYTE8_TO_CHAR (buf[0]);
352 buf[i++] = c;
354 return STRING_CHAR (buf);
357 /* Unread the character C in the way appropriate for the stream READCHARFUN.
358 If the stream is a user function, call it with the char as argument. */
360 static void
361 unreadchar (Lisp_Object readcharfun, 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 EMACS_INT charpos = BUF_PT (b);
372 EMACS_INT bytepos = BUF_PT_BYTE (b);
374 if (! NILP (BVAR (b, enable_multibyte_characters)))
375 BUF_DEC_POS (b, bytepos);
376 else
377 bytepos--;
379 SET_BUF_PT_BOTH (b, charpos - 1, bytepos);
381 else if (MARKERP (readcharfun))
383 struct buffer *b = XMARKER (readcharfun)->buffer;
384 EMACS_INT bytepos = XMARKER (readcharfun)->bytepos;
386 XMARKER (readcharfun)->charpos--;
387 if (! NILP (BVAR (b, enable_multibyte_characters)))
388 BUF_DEC_POS (b, bytepos);
389 else
390 bytepos--;
392 XMARKER (readcharfun)->bytepos = bytepos;
394 else if (STRINGP (readcharfun))
396 read_from_string_index--;
397 read_from_string_index_byte
398 = string_char_to_byte (readcharfun, read_from_string_index);
400 else if (CONSP (readcharfun))
402 unread_char = c;
404 else if (EQ (readcharfun, Qlambda))
406 unread_char = c;
408 else if (EQ (readcharfun, Qget_file_char)
409 || EQ (readcharfun, Qget_emacs_mule_file_char))
411 if (load_each_byte)
413 BLOCK_INPUT;
414 ungetc (c, instream);
415 UNBLOCK_INPUT;
417 else
418 unread_char = c;
420 else
421 call1 (readcharfun, make_number (c));
424 static int
425 readbyte_for_lambda (int c, Lisp_Object readcharfun)
427 return read_bytecode_char (c >= 0);
431 static int
432 readbyte_from_file (int c, Lisp_Object readcharfun)
434 if (c >= 0)
436 BLOCK_INPUT;
437 ungetc (c, instream);
438 UNBLOCK_INPUT;
439 return 0;
442 BLOCK_INPUT;
443 c = getc (instream);
445 #ifdef EINTR
446 /* Interrupted reads have been observed while reading over the network */
447 while (c == EOF && ferror (instream) && errno == EINTR)
449 UNBLOCK_INPUT;
450 QUIT;
451 BLOCK_INPUT;
452 clearerr (instream);
453 c = getc (instream);
455 #endif
457 UNBLOCK_INPUT;
459 return (c == EOF ? -1 : c);
462 static int
463 readbyte_from_string (int c, Lisp_Object readcharfun)
465 Lisp_Object string = XCAR (readcharfun);
467 if (c >= 0)
469 read_from_string_index--;
470 read_from_string_index_byte
471 = string_char_to_byte (string, read_from_string_index);
474 if (read_from_string_index >= read_from_string_limit)
475 c = -1;
476 else
477 FETCH_STRING_CHAR_ADVANCE (c, string,
478 read_from_string_index,
479 read_from_string_index_byte);
480 return c;
484 /* Read one non-ASCII character from INSTREAM. The character is
485 encoded in `emacs-mule' and the first byte is already read in
486 C. */
488 static int
489 read_emacs_mule_char (int c, int (*readbyte) (int, Lisp_Object), Lisp_Object readcharfun)
491 /* Emacs-mule coding uses at most 4-byte for one character. */
492 unsigned char buf[4];
493 int len = emacs_mule_bytes[c];
494 struct charset *charset;
495 int i;
496 unsigned code;
498 if (len == 1)
499 /* C is not a valid leading-code of `emacs-mule'. */
500 return BYTE8_TO_CHAR (c);
502 i = 0;
503 buf[i++] = c;
504 while (i < len)
506 c = (*readbyte) (-1, readcharfun);
507 if (c < 0xA0)
509 while (--i > 1)
510 (*readbyte) (buf[i], readcharfun);
511 return BYTE8_TO_CHAR (buf[0]);
513 buf[i++] = c;
516 if (len == 2)
518 charset = CHARSET_FROM_ID (emacs_mule_charset[buf[0]]);
519 code = buf[1] & 0x7F;
521 else if (len == 3)
523 if (buf[0] == EMACS_MULE_LEADING_CODE_PRIVATE_11
524 || buf[0] == EMACS_MULE_LEADING_CODE_PRIVATE_12)
526 charset = CHARSET_FROM_ID (emacs_mule_charset[buf[1]]);
527 code = buf[2] & 0x7F;
529 else
531 charset = CHARSET_FROM_ID (emacs_mule_charset[buf[0]]);
532 code = ((buf[1] << 8) | buf[2]) & 0x7F7F;
535 else
537 charset = CHARSET_FROM_ID (emacs_mule_charset[buf[1]]);
538 code = ((buf[2] << 8) | buf[3]) & 0x7F7F;
540 c = DECODE_CHAR (charset, code);
541 if (c < 0)
542 Fsignal (Qinvalid_read_syntax,
543 Fcons (build_string ("invalid multibyte form"), Qnil));
544 return c;
548 static Lisp_Object read_internal_start (Lisp_Object, Lisp_Object,
549 Lisp_Object);
550 static Lisp_Object read0 (Lisp_Object);
551 static Lisp_Object read1 (Lisp_Object, int *, int);
553 static Lisp_Object read_list (int, Lisp_Object);
554 static Lisp_Object read_vector (Lisp_Object, int);
556 static Lisp_Object substitute_object_recurse (Lisp_Object, Lisp_Object,
557 Lisp_Object);
558 static void substitute_object_in_subtree (Lisp_Object,
559 Lisp_Object);
560 static void substitute_in_interval (INTERVAL, Lisp_Object);
563 /* Get a character from the tty. */
565 /* Read input events until we get one that's acceptable for our purposes.
567 If NO_SWITCH_FRAME is non-zero, switch-frame events are stashed
568 until we get a character we like, and then stuffed into
569 unread_switch_frame.
571 If ASCII_REQUIRED is non-zero, we check function key events to see
572 if the unmodified version of the symbol has a Qascii_character
573 property, and use that character, if present.
575 If ERROR_NONASCII is non-zero, we signal an error if the input we
576 get isn't an ASCII character with modifiers. If it's zero but
577 ASCII_REQUIRED is non-zero, we just re-read until we get an ASCII
578 character.
580 If INPUT_METHOD is nonzero, we invoke the current input method
581 if the character warrants that.
583 If SECONDS is a number, we wait that many seconds for input, and
584 return Qnil if no input arrives within that time. */
586 static Lisp_Object
587 read_filtered_event (int no_switch_frame, int ascii_required,
588 int error_nonascii, int input_method, Lisp_Object seconds)
590 Lisp_Object val, delayed_switch_frame;
591 EMACS_TIME end_time;
593 #ifdef HAVE_WINDOW_SYSTEM
594 if (display_hourglass_p)
595 cancel_hourglass ();
596 #endif
598 delayed_switch_frame = Qnil;
600 /* Compute timeout. */
601 if (NUMBERP (seconds))
603 EMACS_TIME wait_time;
604 int sec, usec;
605 double duration = extract_float (seconds);
607 sec = (int) duration;
608 usec = (duration - sec) * 1000000;
609 EMACS_GET_TIME (end_time);
610 EMACS_SET_SECS_USECS (wait_time, sec, usec);
611 EMACS_ADD_TIME (end_time, end_time, wait_time);
614 /* Read until we get an acceptable event. */
615 retry:
617 val = read_char (0, 0, 0, (input_method ? Qnil : Qt), 0,
618 NUMBERP (seconds) ? &end_time : NULL);
619 while (INTEGERP (val) && XINT (val) == -2); /* wrong_kboard_jmpbuf */
621 if (BUFFERP (val))
622 goto retry;
624 /* switch-frame events are put off until after the next ASCII
625 character. This is better than signaling an error just because
626 the last characters were typed to a separate minibuffer frame,
627 for example. Eventually, some code which can deal with
628 switch-frame events will read it and process it. */
629 if (no_switch_frame
630 && EVENT_HAS_PARAMETERS (val)
631 && EQ (EVENT_HEAD_KIND (EVENT_HEAD (val)), Qswitch_frame))
633 delayed_switch_frame = val;
634 goto retry;
637 if (ascii_required && !(NUMBERP (seconds) && NILP (val)))
639 /* Convert certain symbols to their ASCII equivalents. */
640 if (SYMBOLP (val))
642 Lisp_Object tem, tem1;
643 tem = Fget (val, Qevent_symbol_element_mask);
644 if (!NILP (tem))
646 tem1 = Fget (Fcar (tem), Qascii_character);
647 /* Merge this symbol's modifier bits
648 with the ASCII equivalent of its basic code. */
649 if (!NILP (tem1))
650 XSETFASTINT (val, XINT (tem1) | XINT (Fcar (Fcdr (tem))));
654 /* If we don't have a character now, deal with it appropriately. */
655 if (!INTEGERP (val))
657 if (error_nonascii)
659 Vunread_command_events = Fcons (val, Qnil);
660 error ("Non-character input-event");
662 else
663 goto retry;
667 if (! NILP (delayed_switch_frame))
668 unread_switch_frame = delayed_switch_frame;
670 #if 0
672 #ifdef HAVE_WINDOW_SYSTEM
673 if (display_hourglass_p)
674 start_hourglass ();
675 #endif
677 #endif
679 return val;
682 DEFUN ("read-char", Fread_char, Sread_char, 0, 3, 0,
683 doc: /* Read a character from the command input (keyboard or macro).
684 It is returned as a number.
685 If the character has modifiers, they are resolved and reflected to the
686 character code if possible (e.g. C-SPC -> 0).
688 If the user generates an event which is not a character (i.e. a mouse
689 click or function key event), `read-char' signals an error. As an
690 exception, switch-frame events are put off until non-character events
691 can be read.
692 If you want to read non-character events, or ignore them, call
693 `read-event' or `read-char-exclusive' instead.
695 If the optional argument PROMPT is non-nil, display that as a prompt.
696 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
697 input method is turned on in the current buffer, that input method
698 is used for reading a character.
699 If the optional argument SECONDS is non-nil, it should be a number
700 specifying the maximum number of seconds to wait for input. If no
701 input arrives in that time, return nil. SECONDS may be a
702 floating-point value. */)
703 (Lisp_Object prompt, Lisp_Object inherit_input_method, Lisp_Object seconds)
705 Lisp_Object val;
707 if (! NILP (prompt))
708 message_with_string ("%s", prompt, 0);
709 val = read_filtered_event (1, 1, 1, ! NILP (inherit_input_method), seconds);
711 return (NILP (val) ? Qnil
712 : make_number (char_resolve_modifier_mask (XINT (val))));
715 DEFUN ("read-event", Fread_event, Sread_event, 0, 3, 0,
716 doc: /* Read an event object from the input stream.
717 If the optional argument PROMPT is non-nil, display that as a prompt.
718 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
719 input method is turned on in the current buffer, that input method
720 is used for reading a character.
721 If the optional argument SECONDS is non-nil, it should be a number
722 specifying the maximum number of seconds to wait for input. If no
723 input arrives in that time, return nil. SECONDS may be a
724 floating-point value. */)
725 (Lisp_Object prompt, Lisp_Object inherit_input_method, Lisp_Object seconds)
727 if (! NILP (prompt))
728 message_with_string ("%s", prompt, 0);
729 return read_filtered_event (0, 0, 0, ! NILP (inherit_input_method), seconds);
732 DEFUN ("read-char-exclusive", Fread_char_exclusive, Sread_char_exclusive, 0, 3, 0,
733 doc: /* Read a character from the command input (keyboard or macro).
734 It is returned as a number. Non-character events are ignored.
735 If the character has modifiers, they are resolved and reflected to the
736 character code if possible (e.g. C-SPC -> 0).
738 If the optional argument PROMPT is non-nil, display that as a prompt.
739 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
740 input method is turned on in the current buffer, that input method
741 is used for reading a character.
742 If the optional argument SECONDS is non-nil, it should be a number
743 specifying the maximum number of seconds to wait for input. If no
744 input arrives in that time, return nil. SECONDS may be a
745 floating-point value. */)
746 (Lisp_Object prompt, Lisp_Object inherit_input_method, Lisp_Object seconds)
748 Lisp_Object val;
750 if (! NILP (prompt))
751 message_with_string ("%s", prompt, 0);
753 val = read_filtered_event (1, 1, 0, ! NILP (inherit_input_method), seconds);
755 return (NILP (val) ? Qnil
756 : make_number (char_resolve_modifier_mask (XINT (val))));
759 DEFUN ("get-file-char", Fget_file_char, Sget_file_char, 0, 0, 0,
760 doc: /* Don't use this yourself. */)
761 (void)
763 register Lisp_Object val;
764 BLOCK_INPUT;
765 XSETINT (val, getc (instream));
766 UNBLOCK_INPUT;
767 return val;
772 /* Value is a version number of byte compiled code if the file
773 associated with file descriptor FD is a compiled Lisp file that's
774 safe to load. Only files compiled with Emacs are safe to load.
775 Files compiled with XEmacs can lead to a crash in Fbyte_code
776 because of an incompatible change in the byte compiler. */
778 static int
779 safe_to_load_p (int fd)
781 char buf[512];
782 int nbytes, i;
783 int safe_p = 1;
784 int version = 1;
786 /* Read the first few bytes from the file, and look for a line
787 specifying the byte compiler version used. */
788 nbytes = emacs_read (fd, buf, sizeof buf - 1);
789 if (nbytes > 0)
791 buf[nbytes] = '\0';
793 /* Skip to the next newline, skipping over the initial `ELC'
794 with NUL bytes following it, but note the version. */
795 for (i = 0; i < nbytes && buf[i] != '\n'; ++i)
796 if (i == 4)
797 version = buf[i];
799 if (i == nbytes
800 || fast_c_string_match_ignore_case (Vbytecomp_version_regexp,
801 buf + i) < 0)
802 safe_p = 0;
804 if (safe_p)
805 safe_p = version;
807 lseek (fd, 0, SEEK_SET);
808 return safe_p;
812 /* Callback for record_unwind_protect. Restore the old load list OLD,
813 after loading a file successfully. */
815 static Lisp_Object
816 record_load_unwind (Lisp_Object old)
818 return Vloads_in_progress = old;
821 /* This handler function is used via internal_condition_case_1. */
823 static Lisp_Object
824 load_error_handler (Lisp_Object data)
826 return Qnil;
829 static Lisp_Object
830 load_warn_old_style_backquotes (Lisp_Object file)
832 if (!NILP (Vold_style_backquotes))
834 Lisp_Object args[2];
835 args[0] = build_string ("Loading `%s': old-style backquotes detected!");
836 args[1] = file;
837 Fmessage (2, args);
839 return Qnil;
842 DEFUN ("get-load-suffixes", Fget_load_suffixes, Sget_load_suffixes, 0, 0, 0,
843 doc: /* Return the suffixes that `load' should try if a suffix is \
844 required.
845 This uses the variables `load-suffixes' and `load-file-rep-suffixes'. */)
846 (void)
848 Lisp_Object lst = Qnil, suffixes = Vload_suffixes, suffix, ext;
849 while (CONSP (suffixes))
851 Lisp_Object exts = Vload_file_rep_suffixes;
852 suffix = XCAR (suffixes);
853 suffixes = XCDR (suffixes);
854 while (CONSP (exts))
856 ext = XCAR (exts);
857 exts = XCDR (exts);
858 lst = Fcons (concat2 (suffix, ext), lst);
861 return Fnreverse (lst);
864 DEFUN ("load", Fload, Sload, 1, 5, 0,
865 doc: /* Execute a file of Lisp code named FILE.
866 First try FILE with `.elc' appended, then try with `.el',
867 then try FILE unmodified (the exact suffixes in the exact order are
868 determined by `load-suffixes'). Environment variable references in
869 FILE are replaced with their values by calling `substitute-in-file-name'.
870 This function searches the directories in `load-path'.
872 If optional second arg NOERROR is non-nil,
873 report no error if FILE doesn't exist.
874 Print messages at start and end of loading unless
875 optional third arg NOMESSAGE is non-nil (but `force-load-messages'
876 overrides that).
877 If optional fourth arg NOSUFFIX is non-nil, don't try adding
878 suffixes `.elc' or `.el' to the specified name FILE.
879 If optional fifth arg MUST-SUFFIX is non-nil, insist on
880 the suffix `.elc' or `.el'; don't accept just FILE unless
881 it ends in one of those suffixes or includes a directory name.
883 If this function fails to find a file, it may look for different
884 representations of that file before trying another file.
885 It does so by adding the non-empty suffixes in `load-file-rep-suffixes'
886 to the file name. Emacs uses this feature mainly to find compressed
887 versions of files when Auto Compression mode is enabled.
889 The exact suffixes that this function tries out, in the exact order,
890 are given by the value of the variable `load-file-rep-suffixes' if
891 NOSUFFIX is non-nil and by the return value of the function
892 `get-load-suffixes' if MUST-SUFFIX is non-nil. If both NOSUFFIX and
893 MUST-SUFFIX are nil, this function first tries out the latter suffixes
894 and then the former.
896 Loading a file records its definitions, and its `provide' and
897 `require' calls, in an element of `load-history' whose
898 car is the file name loaded. See `load-history'.
900 While the file is in the process of being loaded, the variable
901 `load-in-progress' is non-nil and the variable `load-file-name'
902 is bound to the file's name.
904 Return t if the file exists and loads successfully. */)
905 (Lisp_Object file, Lisp_Object noerror, Lisp_Object nomessage, Lisp_Object nosuffix, Lisp_Object must_suffix)
907 register FILE *stream;
908 register int fd = -1;
909 int count = SPECPDL_INDEX ();
910 struct gcpro gcpro1, gcpro2, gcpro3;
911 Lisp_Object found, efound, hist_file_name;
912 /* 1 means we printed the ".el is newer" message. */
913 int newer = 0;
914 /* 1 means we are loading a compiled file. */
915 int compiled = 0;
916 Lisp_Object handler;
917 int safe_p = 1;
918 const char *fmode = "r";
919 Lisp_Object tmp[2];
920 int version;
922 #ifdef DOS_NT
923 fmode = "rt";
924 #endif /* DOS_NT */
926 CHECK_STRING (file);
928 /* If file name is magic, call the handler. */
929 /* This shouldn't be necessary any more now that `openp' handles it right.
930 handler = Ffind_file_name_handler (file, Qload);
931 if (!NILP (handler))
932 return call5 (handler, Qload, file, noerror, nomessage, nosuffix); */
934 /* Do this after the handler to avoid
935 the need to gcpro noerror, nomessage and nosuffix.
936 (Below here, we care only whether they are nil or not.)
937 The presence of this call is the result of a historical accident:
938 it used to be in every file-operation and when it got removed
939 everywhere, it accidentally stayed here. Since then, enough people
940 supposedly have things like (load "$PROJECT/foo.el") in their .emacs
941 that it seemed risky to remove. */
942 if (! NILP (noerror))
944 file = internal_condition_case_1 (Fsubstitute_in_file_name, file,
945 Qt, load_error_handler);
946 if (NILP (file))
947 return Qnil;
949 else
950 file = Fsubstitute_in_file_name (file);
953 /* Avoid weird lossage with null string as arg,
954 since it would try to load a directory as a Lisp file */
955 if (SCHARS (file) > 0)
957 int size = SBYTES (file);
959 found = Qnil;
960 GCPRO2 (file, found);
962 if (! NILP (must_suffix))
964 /* Don't insist on adding a suffix if FILE already ends with one. */
965 if (size > 3
966 && !strcmp (SSDATA (file) + size - 3, ".el"))
967 must_suffix = Qnil;
968 else if (size > 4
969 && !strcmp (SSDATA (file) + size - 4, ".elc"))
970 must_suffix = Qnil;
971 /* Don't insist on adding a suffix
972 if the argument includes a directory name. */
973 else if (! NILP (Ffile_name_directory (file)))
974 must_suffix = Qnil;
977 fd = openp (Vload_path, file,
978 (!NILP (nosuffix) ? Qnil
979 : !NILP (must_suffix) ? Fget_load_suffixes ()
980 : Fappend (2, (tmp[0] = Fget_load_suffixes (),
981 tmp[1] = Vload_file_rep_suffixes,
982 tmp))),
983 &found, Qnil);
984 UNGCPRO;
987 if (fd == -1)
989 if (NILP (noerror))
990 xsignal2 (Qfile_error, build_string ("Cannot open load file"), file);
991 return Qnil;
994 /* Tell startup.el whether or not we found the user's init file. */
995 if (EQ (Qt, Vuser_init_file))
996 Vuser_init_file = found;
998 /* If FD is -2, that means openp found a magic file. */
999 if (fd == -2)
1001 if (NILP (Fequal (found, file)))
1002 /* If FOUND is a different file name from FILE,
1003 find its handler even if we have already inhibited
1004 the `load' operation on FILE. */
1005 handler = Ffind_file_name_handler (found, Qt);
1006 else
1007 handler = Ffind_file_name_handler (found, Qload);
1008 if (! NILP (handler))
1009 return call5 (handler, Qload, found, noerror, nomessage, Qt);
1012 /* Check if we're stuck in a recursive load cycle.
1014 2000-09-21: It's not possible to just check for the file loaded
1015 being a member of Vloads_in_progress. This fails because of the
1016 way the byte compiler currently works; `provide's are not
1017 evaluated, see font-lock.el/jit-lock.el as an example. This
1018 leads to a certain amount of ``normal'' recursion.
1020 Also, just loading a file recursively is not always an error in
1021 the general case; the second load may do something different. */
1023 int load_count = 0;
1024 Lisp_Object tem;
1025 for (tem = Vloads_in_progress; CONSP (tem); tem = XCDR (tem))
1026 if (!NILP (Fequal (found, XCAR (tem))) && (++load_count > 3))
1028 if (fd >= 0)
1029 emacs_close (fd);
1030 signal_error ("Recursive load", Fcons (found, Vloads_in_progress));
1032 record_unwind_protect (record_load_unwind, Vloads_in_progress);
1033 Vloads_in_progress = Fcons (found, Vloads_in_progress);
1036 /* Get the name for load-history. */
1037 hist_file_name = (! NILP (Vpurify_flag)
1038 ? Fconcat (2, (tmp[0] = Ffile_name_directory (file),
1039 tmp[1] = Ffile_name_nondirectory (found),
1040 tmp))
1041 : found) ;
1043 version = -1;
1045 /* Check for the presence of old-style quotes and warn about them. */
1046 specbind (Qold_style_backquotes, Qnil);
1047 record_unwind_protect (load_warn_old_style_backquotes, file);
1049 if (!memcmp (SDATA (found) + SBYTES (found) - 4, ".elc", 4)
1050 || (fd >= 0 && (version = safe_to_load_p (fd)) > 0))
1051 /* Load .elc files directly, but not when they are
1052 remote and have no handler! */
1054 if (fd != -2)
1056 struct stat s1, s2;
1057 int result;
1059 GCPRO3 (file, found, hist_file_name);
1061 if (version < 0
1062 && ! (version = safe_to_load_p (fd)))
1064 safe_p = 0;
1065 if (!load_dangerous_libraries)
1067 if (fd >= 0)
1068 emacs_close (fd);
1069 error ("File `%s' was not compiled in Emacs",
1070 SDATA (found));
1072 else if (!NILP (nomessage) && !force_load_messages)
1073 message_with_string ("File `%s' not compiled in Emacs", found, 1);
1076 compiled = 1;
1078 efound = ENCODE_FILE (found);
1080 #ifdef DOS_NT
1081 fmode = "rb";
1082 #endif /* DOS_NT */
1083 stat (SSDATA (efound), &s1);
1084 SSET (efound, SBYTES (efound) - 1, 0);
1085 result = stat (SSDATA (efound), &s2);
1086 SSET (efound, SBYTES (efound) - 1, 'c');
1088 if (result >= 0 && (unsigned) s1.st_mtime < (unsigned) s2.st_mtime)
1090 /* Make the progress messages mention that source is newer. */
1091 newer = 1;
1093 /* If we won't print another message, mention this anyway. */
1094 if (!NILP (nomessage) && !force_load_messages)
1096 Lisp_Object msg_file;
1097 msg_file = Fsubstring (found, make_number (0), make_number (-1));
1098 message_with_string ("Source file `%s' newer than byte-compiled file",
1099 msg_file, 1);
1102 UNGCPRO;
1105 else
1107 /* We are loading a source file (*.el). */
1108 if (!NILP (Vload_source_file_function))
1110 Lisp_Object val;
1112 if (fd >= 0)
1113 emacs_close (fd);
1114 val = call4 (Vload_source_file_function, found, hist_file_name,
1115 NILP (noerror) ? Qnil : Qt,
1116 (NILP (nomessage) || force_load_messages) ? Qnil : Qt);
1117 return unbind_to (count, val);
1121 GCPRO3 (file, found, hist_file_name);
1123 #ifdef WINDOWSNT
1124 emacs_close (fd);
1125 efound = ENCODE_FILE (found);
1126 stream = fopen (SSDATA (efound), fmode);
1127 #else /* not WINDOWSNT */
1128 stream = fdopen (fd, fmode);
1129 #endif /* not WINDOWSNT */
1130 if (stream == 0)
1132 emacs_close (fd);
1133 error ("Failure to create stdio stream for %s", SDATA (file));
1136 if (! NILP (Vpurify_flag))
1137 Vpreloaded_file_list = Fcons (Fpurecopy(file), Vpreloaded_file_list);
1139 if (NILP (nomessage) || force_load_messages)
1141 if (!safe_p)
1142 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...",
1143 file, 1);
1144 else if (!compiled)
1145 message_with_string ("Loading %s (source)...", file, 1);
1146 else if (newer)
1147 message_with_string ("Loading %s (compiled; note, source file is newer)...",
1148 file, 1);
1149 else /* The typical case; compiled file newer than source file. */
1150 message_with_string ("Loading %s...", file, 1);
1153 record_unwind_protect (load_unwind, make_save_value (stream, 0));
1154 record_unwind_protect (load_descriptor_unwind, load_descriptor_list);
1155 specbind (Qload_file_name, found);
1156 specbind (Qinhibit_file_name_operation, Qnil);
1157 load_descriptor_list
1158 = Fcons (make_number (fileno (stream)), load_descriptor_list);
1159 specbind (Qload_in_progress, Qt);
1160 if (! version || version >= 22)
1161 readevalloop (Qget_file_char, stream, hist_file_name,
1162 Feval, 0, Qnil, Qnil, Qnil, Qnil);
1163 else
1165 /* We can't handle a file which was compiled with
1166 byte-compile-dynamic by older version of Emacs. */
1167 specbind (Qload_force_doc_strings, Qt);
1168 readevalloop (Qget_emacs_mule_file_char, stream, hist_file_name, Feval,
1169 0, Qnil, Qnil, Qnil, Qnil);
1171 unbind_to (count, Qnil);
1173 /* Run any eval-after-load forms for this file */
1174 if (!NILP (Ffboundp (Qdo_after_load_evaluation)))
1175 call1 (Qdo_after_load_evaluation, hist_file_name) ;
1177 UNGCPRO;
1179 xfree (saved_doc_string);
1180 saved_doc_string = 0;
1181 saved_doc_string_size = 0;
1183 xfree (prev_saved_doc_string);
1184 prev_saved_doc_string = 0;
1185 prev_saved_doc_string_size = 0;
1187 if (!noninteractive && (NILP (nomessage) || force_load_messages))
1189 if (!safe_p)
1190 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...done",
1191 file, 1);
1192 else if (!compiled)
1193 message_with_string ("Loading %s (source)...done", file, 1);
1194 else if (newer)
1195 message_with_string ("Loading %s (compiled; note, source file is newer)...done",
1196 file, 1);
1197 else /* The typical case; compiled file newer than source file. */
1198 message_with_string ("Loading %s...done", file, 1);
1201 return Qt;
1204 static Lisp_Object
1205 load_unwind (Lisp_Object arg) /* used as unwind-protect function in load */
1207 FILE *stream = (FILE *) XSAVE_VALUE (arg)->pointer;
1208 if (stream != NULL)
1210 BLOCK_INPUT;
1211 fclose (stream);
1212 UNBLOCK_INPUT;
1214 return Qnil;
1217 static Lisp_Object
1218 load_descriptor_unwind (Lisp_Object oldlist)
1220 load_descriptor_list = oldlist;
1221 return Qnil;
1224 /* Close all descriptors in use for Floads.
1225 This is used when starting a subprocess. */
1227 void
1228 close_load_descs (void)
1230 #ifndef WINDOWSNT
1231 Lisp_Object tail;
1232 for (tail = load_descriptor_list; CONSP (tail); tail = XCDR (tail))
1233 emacs_close (XFASTINT (XCAR (tail)));
1234 #endif
1237 static int
1238 complete_filename_p (Lisp_Object pathname)
1240 register const unsigned char *s = SDATA (pathname);
1241 return (IS_DIRECTORY_SEP (s[0])
1242 || (SCHARS (pathname) > 2
1243 && IS_DEVICE_SEP (s[1]) && IS_DIRECTORY_SEP (s[2])));
1246 DEFUN ("locate-file-internal", Flocate_file_internal, Slocate_file_internal, 2, 4, 0,
1247 doc: /* Search for FILENAME through PATH.
1248 Returns the file's name in absolute form, or nil if not found.
1249 If SUFFIXES is non-nil, it should be a list of suffixes to append to
1250 file name when searching.
1251 If non-nil, PREDICATE is used instead of `file-readable-p'.
1252 PREDICATE can also be an integer to pass to the access(2) function,
1253 in which case file-name-handlers are ignored.
1254 This function will normally skip directories, so if you want it to find
1255 directories, make sure the PREDICATE function returns `dir-ok' for them. */)
1256 (Lisp_Object filename, Lisp_Object path, Lisp_Object suffixes, Lisp_Object predicate)
1258 Lisp_Object file;
1259 int fd = openp (path, filename, suffixes, &file, predicate);
1260 if (NILP (predicate) && fd > 0)
1261 close (fd);
1262 return file;
1265 static Lisp_Object Qdir_ok;
1267 /* Search for a file whose name is STR, looking in directories
1268 in the Lisp list PATH, and trying suffixes from SUFFIX.
1269 On success, returns a file descriptor. On failure, returns -1.
1271 SUFFIXES is a list of strings containing possible suffixes.
1272 The empty suffix is automatically added if the list is empty.
1274 PREDICATE non-nil means don't open the files,
1275 just look for one that satisfies the predicate. In this case,
1276 returns 1 on success. The predicate can be a lisp function or
1277 an integer to pass to `access' (in which case file-name-handlers
1278 are ignored).
1280 If STOREPTR is nonzero, it points to a slot where the name of
1281 the file actually found should be stored as a Lisp string.
1282 nil is stored there on failure.
1284 If the file we find is remote, return -2
1285 but store the found remote file name in *STOREPTR. */
1288 openp (Lisp_Object path, Lisp_Object str, Lisp_Object suffixes, Lisp_Object *storeptr, Lisp_Object predicate)
1290 register int fd;
1291 int fn_size = 100;
1292 char buf[100];
1293 register char *fn = buf;
1294 int absolute = 0;
1295 int want_size;
1296 Lisp_Object filename;
1297 struct stat st;
1298 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
1299 Lisp_Object string, tail, encoded_fn;
1300 int max_suffix_len = 0;
1302 CHECK_STRING (str);
1304 for (tail = suffixes; CONSP (tail); tail = XCDR (tail))
1306 CHECK_STRING_CAR (tail);
1307 max_suffix_len = max (max_suffix_len,
1308 SBYTES (XCAR (tail)));
1311 string = filename = encoded_fn = Qnil;
1312 GCPRO6 (str, string, filename, path, suffixes, encoded_fn);
1314 if (storeptr)
1315 *storeptr = Qnil;
1317 if (complete_filename_p (str))
1318 absolute = 1;
1320 for (; CONSP (path); path = XCDR (path))
1322 filename = Fexpand_file_name (str, XCAR (path));
1323 if (!complete_filename_p (filename))
1324 /* If there are non-absolute elts in PATH (eg ".") */
1325 /* Of course, this could conceivably lose if luser sets
1326 default-directory to be something non-absolute... */
1328 filename = Fexpand_file_name (filename, BVAR (current_buffer, directory));
1329 if (!complete_filename_p (filename))
1330 /* Give up on this path element! */
1331 continue;
1334 /* Calculate maximum size of any filename made from
1335 this path element/specified file name and any possible suffix. */
1336 want_size = max_suffix_len + SBYTES (filename) + 1;
1337 if (fn_size < want_size)
1338 fn = (char *) alloca (fn_size = 100 + want_size);
1340 /* Loop over suffixes. */
1341 for (tail = NILP (suffixes) ? Fcons (empty_unibyte_string, Qnil) : suffixes;
1342 CONSP (tail); tail = XCDR (tail))
1344 int lsuffix = SBYTES (XCAR (tail));
1345 Lisp_Object handler;
1346 int exists;
1348 /* Concatenate path element/specified name with the suffix.
1349 If the directory starts with /:, remove that. */
1350 if (SCHARS (filename) > 2
1351 && SREF (filename, 0) == '/'
1352 && SREF (filename, 1) == ':')
1354 strncpy (fn, SSDATA (filename) + 2,
1355 SBYTES (filename) - 2);
1356 fn[SBYTES (filename) - 2] = 0;
1358 else
1360 strncpy (fn, SSDATA (filename),
1361 SBYTES (filename));
1362 fn[SBYTES (filename)] = 0;
1365 if (lsuffix != 0) /* Bug happens on CCI if lsuffix is 0. */
1366 strncat (fn, SSDATA (XCAR (tail)), lsuffix);
1368 /* Check that the file exists and is not a directory. */
1369 /* We used to only check for handlers on non-absolute file names:
1370 if (absolute)
1371 handler = Qnil;
1372 else
1373 handler = Ffind_file_name_handler (filename, Qfile_exists_p);
1374 It's not clear why that was the case and it breaks things like
1375 (load "/bar.el") where the file is actually "/bar.el.gz". */
1376 string = build_string (fn);
1377 handler = Ffind_file_name_handler (string, Qfile_exists_p);
1378 if ((!NILP (handler) || !NILP (predicate)) && !NATNUMP (predicate))
1380 if (NILP (predicate))
1381 exists = !NILP (Ffile_readable_p (string));
1382 else
1384 Lisp_Object tmp = call1 (predicate, string);
1385 exists = !NILP (tmp)
1386 && (EQ (tmp, Qdir_ok)
1387 || NILP (Ffile_directory_p (string)));
1390 if (exists)
1392 /* We succeeded; return this descriptor and filename. */
1393 if (storeptr)
1394 *storeptr = string;
1395 UNGCPRO;
1396 return -2;
1399 else
1401 const char *pfn;
1403 encoded_fn = ENCODE_FILE (string);
1404 pfn = SSDATA (encoded_fn);
1405 exists = (stat (pfn, &st) == 0 && ! S_ISDIR (st.st_mode));
1406 if (exists)
1408 /* Check that we can access or open it. */
1409 if (NATNUMP (predicate))
1410 fd = (access (pfn, XFASTINT (predicate)) == 0) ? 1 : -1;
1411 else
1412 fd = emacs_open (pfn, O_RDONLY, 0);
1414 if (fd >= 0)
1416 /* We succeeded; return this descriptor and filename. */
1417 if (storeptr)
1418 *storeptr = string;
1419 UNGCPRO;
1420 return fd;
1425 if (absolute)
1426 break;
1429 UNGCPRO;
1430 return -1;
1434 /* Merge the list we've accumulated of globals from the current input source
1435 into the load_history variable. The details depend on whether
1436 the source has an associated file name or not.
1438 FILENAME is the file name that we are loading from.
1439 ENTIRE is 1 if loading that entire file, 0 if evaluating part of it. */
1441 static void
1442 build_load_history (Lisp_Object filename, int entire)
1444 register Lisp_Object tail, prev, newelt;
1445 register Lisp_Object tem, tem2;
1446 register int foundit = 0;
1448 tail = Vload_history;
1449 prev = Qnil;
1451 while (CONSP (tail))
1453 tem = XCAR (tail);
1455 /* Find the feature's previous assoc list... */
1456 if (!NILP (Fequal (filename, Fcar (tem))))
1458 foundit = 1;
1460 /* If we're loading the entire file, remove old data. */
1461 if (entire)
1463 if (NILP (prev))
1464 Vload_history = XCDR (tail);
1465 else
1466 Fsetcdr (prev, XCDR (tail));
1469 /* Otherwise, cons on new symbols that are not already members. */
1470 else
1472 tem2 = Vcurrent_load_list;
1474 while (CONSP (tem2))
1476 newelt = XCAR (tem2);
1478 if (NILP (Fmember (newelt, tem)))
1479 Fsetcar (tail, Fcons (XCAR (tem),
1480 Fcons (newelt, XCDR (tem))));
1482 tem2 = XCDR (tem2);
1483 QUIT;
1487 else
1488 prev = tail;
1489 tail = XCDR (tail);
1490 QUIT;
1493 /* If we're loading an entire file, cons the new assoc onto the
1494 front of load-history, the most-recently-loaded position. Also
1495 do this if we didn't find an existing member for the file. */
1496 if (entire || !foundit)
1497 Vload_history = Fcons (Fnreverse (Vcurrent_load_list),
1498 Vload_history);
1501 static Lisp_Object
1502 unreadpure (Lisp_Object junk) /* Used as unwind-protect function in readevalloop */
1504 read_pure = 0;
1505 return Qnil;
1508 static Lisp_Object
1509 readevalloop_1 (Lisp_Object old)
1511 load_convert_to_unibyte = ! NILP (old);
1512 return Qnil;
1515 /* Signal an `end-of-file' error, if possible with file name
1516 information. */
1518 static void
1519 end_of_file_error (void)
1521 if (STRINGP (Vload_file_name))
1522 xsignal1 (Qend_of_file, Vload_file_name);
1524 xsignal0 (Qend_of_file);
1527 /* UNIBYTE specifies how to set load_convert_to_unibyte
1528 for this invocation.
1529 READFUN, if non-nil, is used instead of `read'.
1531 START, END specify region to read in current buffer (from eval-region).
1532 If the input is not from a buffer, they must be nil. */
1534 static void
1535 readevalloop (Lisp_Object readcharfun,
1536 FILE *stream,
1537 Lisp_Object sourcename,
1538 Lisp_Object (*evalfun) (Lisp_Object),
1539 int printflag,
1540 Lisp_Object unibyte, Lisp_Object readfun,
1541 Lisp_Object start, Lisp_Object end)
1543 register int c;
1544 register Lisp_Object val;
1545 int count = SPECPDL_INDEX ();
1546 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1547 struct buffer *b = 0;
1548 int continue_reading_p;
1549 /* Nonzero if reading an entire buffer. */
1550 int whole_buffer = 0;
1551 /* 1 on the first time around. */
1552 int first_sexp = 1;
1554 if (MARKERP (readcharfun))
1556 if (NILP (start))
1557 start = readcharfun;
1560 if (BUFFERP (readcharfun))
1561 b = XBUFFER (readcharfun);
1562 else if (MARKERP (readcharfun))
1563 b = XMARKER (readcharfun)->buffer;
1565 /* We assume START is nil when input is not from a buffer. */
1566 if (! NILP (start) && !b)
1567 abort ();
1569 specbind (Qstandard_input, readcharfun); /* GCPROs readcharfun. */
1570 specbind (Qcurrent_load_list, Qnil);
1571 record_unwind_protect (readevalloop_1, load_convert_to_unibyte ? Qt : Qnil);
1572 load_convert_to_unibyte = !NILP (unibyte);
1574 GCPRO4 (sourcename, readfun, start, end);
1576 /* Try to ensure sourcename is a truename, except whilst preloading. */
1577 if (NILP (Vpurify_flag)
1578 && !NILP (sourcename) && !NILP (Ffile_name_absolute_p (sourcename))
1579 && !NILP (Ffboundp (Qfile_truename)))
1580 sourcename = call1 (Qfile_truename, sourcename) ;
1582 LOADHIST_ATTACH (sourcename);
1584 continue_reading_p = 1;
1585 while (continue_reading_p)
1587 int count1 = SPECPDL_INDEX ();
1589 if (b != 0 && NILP (BVAR (b, name)))
1590 error ("Reading from killed buffer");
1592 if (!NILP (start))
1594 /* Switch to the buffer we are reading from. */
1595 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1596 set_buffer_internal (b);
1598 /* Save point in it. */
1599 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1600 /* Save ZV in it. */
1601 record_unwind_protect (save_restriction_restore, save_restriction_save ());
1602 /* Those get unbound after we read one expression. */
1604 /* Set point and ZV around stuff to be read. */
1605 Fgoto_char (start);
1606 if (!NILP (end))
1607 Fnarrow_to_region (make_number (BEGV), end);
1609 /* Just for cleanliness, convert END to a marker
1610 if it is an integer. */
1611 if (INTEGERP (end))
1612 end = Fpoint_max_marker ();
1615 /* On the first cycle, we can easily test here
1616 whether we are reading the whole buffer. */
1617 if (b && first_sexp)
1618 whole_buffer = (PT == BEG && ZV == Z);
1620 instream = stream;
1621 read_next:
1622 c = READCHAR;
1623 if (c == ';')
1625 while ((c = READCHAR) != '\n' && c != -1);
1626 goto read_next;
1628 if (c < 0)
1630 unbind_to (count1, Qnil);
1631 break;
1634 /* Ignore whitespace here, so we can detect eof. */
1635 if (c == ' ' || c == '\t' || c == '\n' || c == '\f' || c == '\r'
1636 || c == 0x8a0) /* NBSP */
1637 goto read_next;
1639 if (!NILP (Vpurify_flag) && c == '(')
1641 record_unwind_protect (unreadpure, Qnil);
1642 val = read_list (-1, readcharfun);
1644 else
1646 UNREAD (c);
1647 read_objects = Qnil;
1648 if (!NILP (readfun))
1650 val = call1 (readfun, readcharfun);
1652 /* If READCHARFUN has set point to ZV, we should
1653 stop reading, even if the form read sets point
1654 to a different value when evaluated. */
1655 if (BUFFERP (readcharfun))
1657 struct buffer *buf = XBUFFER (readcharfun);
1658 if (BUF_PT (buf) == BUF_ZV (buf))
1659 continue_reading_p = 0;
1662 else if (! NILP (Vload_read_function))
1663 val = call1 (Vload_read_function, readcharfun);
1664 else
1665 val = read_internal_start (readcharfun, Qnil, Qnil);
1668 if (!NILP (start) && continue_reading_p)
1669 start = Fpoint_marker ();
1671 /* Restore saved point and BEGV. */
1672 unbind_to (count1, Qnil);
1674 /* Now eval what we just read. */
1675 val = (*evalfun) (val);
1677 if (printflag)
1679 Vvalues = Fcons (val, Vvalues);
1680 if (EQ (Vstandard_output, Qt))
1681 Fprin1 (val, Qnil);
1682 else
1683 Fprint (val, Qnil);
1686 first_sexp = 0;
1689 build_load_history (sourcename,
1690 stream || whole_buffer);
1692 UNGCPRO;
1694 unbind_to (count, Qnil);
1697 DEFUN ("eval-buffer", Feval_buffer, Seval_buffer, 0, 5, "",
1698 doc: /* Execute the current buffer as Lisp code.
1699 When called from a Lisp program (i.e., not interactively), this
1700 function accepts up to five optional arguments:
1701 BUFFER is the buffer to evaluate (nil means use current buffer).
1702 PRINTFLAG controls printing of output:
1703 A value of nil means discard it; anything else is stream for print.
1704 FILENAME specifies the file name to use for `load-history'.
1705 UNIBYTE, if non-nil, specifies `load-convert-to-unibyte' for this
1706 invocation.
1707 DO-ALLOW-PRINT, if non-nil, specifies that `print' and related
1708 functions should work normally even if PRINTFLAG is nil.
1710 This function preserves the position of point. */)
1711 (Lisp_Object buffer, Lisp_Object printflag, Lisp_Object filename, Lisp_Object unibyte, Lisp_Object do_allow_print)
1713 int count = SPECPDL_INDEX ();
1714 Lisp_Object tem, buf;
1716 if (NILP (buffer))
1717 buf = Fcurrent_buffer ();
1718 else
1719 buf = Fget_buffer (buffer);
1720 if (NILP (buf))
1721 error ("No such buffer");
1723 if (NILP (printflag) && NILP (do_allow_print))
1724 tem = Qsymbolp;
1725 else
1726 tem = printflag;
1728 if (NILP (filename))
1729 filename = BVAR (XBUFFER (buf), filename);
1731 specbind (Qeval_buffer_list, Fcons (buf, Veval_buffer_list));
1732 specbind (Qstandard_output, tem);
1733 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1734 BUF_TEMP_SET_PT (XBUFFER (buf), BUF_BEGV (XBUFFER (buf)));
1735 readevalloop (buf, 0, filename, Feval,
1736 !NILP (printflag), unibyte, Qnil, Qnil, Qnil);
1737 unbind_to (count, Qnil);
1739 return Qnil;
1742 DEFUN ("eval-region", Feval_region, Seval_region, 2, 4, "r",
1743 doc: /* Execute the region as Lisp code.
1744 When called from programs, expects two arguments,
1745 giving starting and ending indices in the current buffer
1746 of the text to be executed.
1747 Programs can pass third argument PRINTFLAG which controls output:
1748 A value of nil means discard it; anything else is stream for printing it.
1749 Also the fourth argument READ-FUNCTION, if non-nil, is used
1750 instead of `read' to read each expression. It gets one argument
1751 which is the input stream for reading characters.
1753 This function does not move point. */)
1754 (Lisp_Object start, Lisp_Object end, Lisp_Object printflag, Lisp_Object read_function)
1756 int count = SPECPDL_INDEX ();
1757 Lisp_Object tem, cbuf;
1759 cbuf = Fcurrent_buffer ();
1761 if (NILP (printflag))
1762 tem = Qsymbolp;
1763 else
1764 tem = printflag;
1765 specbind (Qstandard_output, tem);
1766 specbind (Qeval_buffer_list, Fcons (cbuf, Veval_buffer_list));
1768 /* readevalloop calls functions which check the type of start and end. */
1769 readevalloop (cbuf, 0, BVAR (XBUFFER (cbuf), filename), Feval,
1770 !NILP (printflag), Qnil, read_function,
1771 start, end);
1773 return unbind_to (count, Qnil);
1777 DEFUN ("read", Fread, Sread, 0, 1, 0,
1778 doc: /* Read one Lisp expression as text from STREAM, return as Lisp object.
1779 If STREAM is nil, use the value of `standard-input' (which see).
1780 STREAM or the value of `standard-input' may be:
1781 a buffer (read from point and advance it)
1782 a marker (read from where it points and advance it)
1783 a function (call it with no arguments for each character,
1784 call it with a char as argument to push a char back)
1785 a string (takes text from string, starting at the beginning)
1786 t (read text line using minibuffer and use it, or read from
1787 standard input in batch mode). */)
1788 (Lisp_Object stream)
1790 if (NILP (stream))
1791 stream = Vstandard_input;
1792 if (EQ (stream, Qt))
1793 stream = Qread_char;
1794 if (EQ (stream, Qread_char))
1795 return Fread_minibuffer (build_string ("Lisp expression: "), Qnil);
1797 return read_internal_start (stream, Qnil, Qnil);
1800 DEFUN ("read-from-string", Fread_from_string, Sread_from_string, 1, 3, 0,
1801 doc: /* Read one Lisp expression which is represented as text by STRING.
1802 Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
1803 START and END optionally delimit a substring of STRING from which to read;
1804 they default to 0 and (length STRING) respectively. */)
1805 (Lisp_Object string, Lisp_Object start, Lisp_Object end)
1807 Lisp_Object ret;
1808 CHECK_STRING (string);
1809 /* read_internal_start sets read_from_string_index. */
1810 ret = read_internal_start (string, start, end);
1811 return Fcons (ret, make_number (read_from_string_index));
1814 /* Function to set up the global context we need in toplevel read
1815 calls. */
1816 static Lisp_Object
1817 read_internal_start (Lisp_Object stream, Lisp_Object start, Lisp_Object end)
1818 /* start, end only used when stream is a string. */
1820 Lisp_Object retval;
1822 readchar_count = 0;
1823 new_backquote_flag = 0;
1824 read_objects = Qnil;
1825 if (EQ (Vread_with_symbol_positions, Qt)
1826 || EQ (Vread_with_symbol_positions, stream))
1827 Vread_symbol_positions_list = Qnil;
1829 if (STRINGP (stream)
1830 || ((CONSP (stream) && STRINGP (XCAR (stream)))))
1832 EMACS_INT startval, endval;
1833 Lisp_Object string;
1835 if (STRINGP (stream))
1836 string = stream;
1837 else
1838 string = XCAR (stream);
1840 if (NILP (end))
1841 endval = SCHARS (string);
1842 else
1844 CHECK_NUMBER (end);
1845 endval = XINT (end);
1846 if (endval < 0 || endval > SCHARS (string))
1847 args_out_of_range (string, end);
1850 if (NILP (start))
1851 startval = 0;
1852 else
1854 CHECK_NUMBER (start);
1855 startval = XINT (start);
1856 if (startval < 0 || startval > endval)
1857 args_out_of_range (string, start);
1859 read_from_string_index = startval;
1860 read_from_string_index_byte = string_char_to_byte (string, startval);
1861 read_from_string_limit = endval;
1864 retval = read0 (stream);
1865 if (EQ (Vread_with_symbol_positions, Qt)
1866 || EQ (Vread_with_symbol_positions, stream))
1867 Vread_symbol_positions_list = Fnreverse (Vread_symbol_positions_list);
1868 return retval;
1872 /* Signal Qinvalid_read_syntax error.
1873 S is error string of length N (if > 0) */
1875 static void
1876 invalid_syntax (const char *s, int n)
1878 if (!n)
1879 n = strlen (s);
1880 xsignal1 (Qinvalid_read_syntax, make_string (s, n));
1884 /* Use this for recursive reads, in contexts where internal tokens
1885 are not allowed. */
1887 static Lisp_Object
1888 read0 (Lisp_Object readcharfun)
1890 register Lisp_Object val;
1891 int c;
1893 val = read1 (readcharfun, &c, 0);
1894 if (!c)
1895 return val;
1897 xsignal1 (Qinvalid_read_syntax,
1898 Fmake_string (make_number (1), make_number (c)));
1901 static int read_buffer_size;
1902 static char *read_buffer;
1904 /* Read a \-escape sequence, assuming we already read the `\'.
1905 If the escape sequence forces unibyte, return eight-bit char. */
1907 static int
1908 read_escape (Lisp_Object readcharfun, int stringp)
1910 register int c = READCHAR;
1911 /* \u allows up to four hex digits, \U up to eight. Default to the
1912 behavior for \u, and change this value in the case that \U is seen. */
1913 int unicode_hex_count = 4;
1915 switch (c)
1917 case -1:
1918 end_of_file_error ();
1920 case 'a':
1921 return '\007';
1922 case 'b':
1923 return '\b';
1924 case 'd':
1925 return 0177;
1926 case 'e':
1927 return 033;
1928 case 'f':
1929 return '\f';
1930 case 'n':
1931 return '\n';
1932 case 'r':
1933 return '\r';
1934 case 't':
1935 return '\t';
1936 case 'v':
1937 return '\v';
1938 case '\n':
1939 return -1;
1940 case ' ':
1941 if (stringp)
1942 return -1;
1943 return ' ';
1945 case 'M':
1946 c = READCHAR;
1947 if (c != '-')
1948 error ("Invalid escape character syntax");
1949 c = READCHAR;
1950 if (c == '\\')
1951 c = read_escape (readcharfun, 0);
1952 return c | meta_modifier;
1954 case 'S':
1955 c = READCHAR;
1956 if (c != '-')
1957 error ("Invalid escape character syntax");
1958 c = READCHAR;
1959 if (c == '\\')
1960 c = read_escape (readcharfun, 0);
1961 return c | shift_modifier;
1963 case 'H':
1964 c = READCHAR;
1965 if (c != '-')
1966 error ("Invalid escape character syntax");
1967 c = READCHAR;
1968 if (c == '\\')
1969 c = read_escape (readcharfun, 0);
1970 return c | hyper_modifier;
1972 case 'A':
1973 c = READCHAR;
1974 if (c != '-')
1975 error ("Invalid escape character syntax");
1976 c = READCHAR;
1977 if (c == '\\')
1978 c = read_escape (readcharfun, 0);
1979 return c | alt_modifier;
1981 case 's':
1982 c = READCHAR;
1983 if (stringp || c != '-')
1985 UNREAD (c);
1986 return ' ';
1988 c = READCHAR;
1989 if (c == '\\')
1990 c = read_escape (readcharfun, 0);
1991 return c | super_modifier;
1993 case 'C':
1994 c = READCHAR;
1995 if (c != '-')
1996 error ("Invalid escape character syntax");
1997 case '^':
1998 c = READCHAR;
1999 if (c == '\\')
2000 c = read_escape (readcharfun, 0);
2001 if ((c & ~CHAR_MODIFIER_MASK) == '?')
2002 return 0177 | (c & CHAR_MODIFIER_MASK);
2003 else if (! SINGLE_BYTE_CHAR_P ((c & ~CHAR_MODIFIER_MASK)))
2004 return c | ctrl_modifier;
2005 /* ASCII control chars are made from letters (both cases),
2006 as well as the non-letters within 0100...0137. */
2007 else if ((c & 0137) >= 0101 && (c & 0137) <= 0132)
2008 return (c & (037 | ~0177));
2009 else if ((c & 0177) >= 0100 && (c & 0177) <= 0137)
2010 return (c & (037 | ~0177));
2011 else
2012 return c | ctrl_modifier;
2014 case '0':
2015 case '1':
2016 case '2':
2017 case '3':
2018 case '4':
2019 case '5':
2020 case '6':
2021 case '7':
2022 /* An octal escape, as in ANSI C. */
2024 register int i = c - '0';
2025 register int count = 0;
2026 while (++count < 3)
2028 if ((c = READCHAR) >= '0' && c <= '7')
2030 i *= 8;
2031 i += c - '0';
2033 else
2035 UNREAD (c);
2036 break;
2040 if (i >= 0x80 && i < 0x100)
2041 i = BYTE8_TO_CHAR (i);
2042 return i;
2045 case 'x':
2046 /* A hex escape, as in ANSI C. */
2048 int i = 0;
2049 int count = 0;
2050 while (1)
2052 c = READCHAR;
2053 if (c >= '0' && c <= '9')
2055 i *= 16;
2056 i += c - '0';
2058 else if ((c >= 'a' && c <= 'f')
2059 || (c >= 'A' && c <= 'F'))
2061 i *= 16;
2062 if (c >= 'a' && c <= 'f')
2063 i += c - 'a' + 10;
2064 else
2065 i += c - 'A' + 10;
2067 else
2069 UNREAD (c);
2070 break;
2072 count++;
2075 if (count < 3 && i >= 0x80)
2076 return BYTE8_TO_CHAR (i);
2077 return i;
2080 case 'U':
2081 /* Post-Unicode-2.0: Up to eight hex chars. */
2082 unicode_hex_count = 8;
2083 case 'u':
2085 /* A Unicode escape. We only permit them in strings and characters,
2086 not arbitrarily in the source code, as in some other languages. */
2088 unsigned int i = 0;
2089 int count = 0;
2091 while (++count <= unicode_hex_count)
2093 c = READCHAR;
2094 /* isdigit and isalpha may be locale-specific, which we don't
2095 want. */
2096 if (c >= '0' && c <= '9') i = (i << 4) + (c - '0');
2097 else if (c >= 'a' && c <= 'f') i = (i << 4) + (c - 'a') + 10;
2098 else if (c >= 'A' && c <= 'F') i = (i << 4) + (c - 'A') + 10;
2099 else
2101 error ("Non-hex digit used for Unicode escape");
2102 break;
2105 if (i > 0x10FFFF)
2106 error ("Non-Unicode character: 0x%x", i);
2107 return i;
2110 default:
2111 return c;
2115 /* Read an integer in radix RADIX using READCHARFUN to read
2116 characters. RADIX must be in the interval [2..36]; if it isn't, a
2117 read error is signaled . Value is the integer read. Signals an
2118 error if encountering invalid read syntax or if RADIX is out of
2119 range. */
2121 static Lisp_Object
2122 read_integer (Lisp_Object readcharfun, int radix)
2124 int ndigits = 0, invalid_p, c, sign = 0;
2125 /* We use a floating point number because */
2126 double number = 0;
2128 if (radix < 2 || radix > 36)
2129 invalid_p = 1;
2130 else
2132 number = ndigits = invalid_p = 0;
2133 sign = 1;
2135 c = READCHAR;
2136 if (c == '-')
2138 c = READCHAR;
2139 sign = -1;
2141 else if (c == '+')
2142 c = READCHAR;
2144 while (c >= 0)
2146 int digit;
2148 if (c >= '0' && c <= '9')
2149 digit = c - '0';
2150 else if (c >= 'a' && c <= 'z')
2151 digit = c - 'a' + 10;
2152 else if (c >= 'A' && c <= 'Z')
2153 digit = c - 'A' + 10;
2154 else
2156 UNREAD (c);
2157 break;
2160 if (digit < 0 || digit >= radix)
2161 invalid_p = 1;
2163 number = radix * number + digit;
2164 ++ndigits;
2165 c = READCHAR;
2169 if (ndigits == 0 || invalid_p)
2171 char buf[50];
2172 sprintf (buf, "integer, radix %d", radix);
2173 invalid_syntax (buf, 0);
2176 return make_fixnum_or_float (sign * number);
2180 /* If the next token is ')' or ']' or '.', we store that character
2181 in *PCH and the return value is not interesting. Else, we store
2182 zero in *PCH and we read and return one lisp object.
2184 FIRST_IN_LIST is nonzero if this is the first element of a list. */
2186 static Lisp_Object
2187 read1 (register Lisp_Object readcharfun, int *pch, int first_in_list)
2189 register int c;
2190 int uninterned_symbol = 0;
2191 int multibyte;
2193 *pch = 0;
2194 load_each_byte = 0;
2196 retry:
2198 c = READCHAR_REPORT_MULTIBYTE (&multibyte);
2199 if (c < 0)
2200 end_of_file_error ();
2202 switch (c)
2204 case '(':
2205 return read_list (0, readcharfun);
2207 case '[':
2208 return read_vector (readcharfun, 0);
2210 case ')':
2211 case ']':
2213 *pch = c;
2214 return Qnil;
2217 case '#':
2218 c = READCHAR;
2219 if (c == 's')
2221 c = READCHAR;
2222 if (c == '(')
2224 /* Accept extended format for hashtables (extensible to
2225 other types), e.g.
2226 #s(hash-table size 2 test equal data (k1 v1 k2 v2)) */
2227 Lisp_Object tmp = read_list (0, readcharfun);
2228 Lisp_Object head = CAR_SAFE (tmp);
2229 Lisp_Object data = Qnil;
2230 Lisp_Object val = Qnil;
2231 /* The size is 2 * number of allowed keywords to
2232 make-hash-table. */
2233 Lisp_Object params[10];
2234 Lisp_Object ht;
2235 Lisp_Object key = Qnil;
2236 int param_count = 0;
2238 if (!EQ (head, Qhash_table))
2239 error ("Invalid extended read marker at head of #s list "
2240 "(only hash-table allowed)");
2242 tmp = CDR_SAFE (tmp);
2244 /* This is repetitive but fast and simple. */
2245 params[param_count] = QCsize;
2246 params[param_count+1] = Fplist_get (tmp, Qsize);
2247 if (!NILP (params[param_count + 1]))
2248 param_count += 2;
2250 params[param_count] = QCtest;
2251 params[param_count+1] = Fplist_get (tmp, Qtest);
2252 if (!NILP (params[param_count + 1]))
2253 param_count += 2;
2255 params[param_count] = QCweakness;
2256 params[param_count+1] = Fplist_get (tmp, Qweakness);
2257 if (!NILP (params[param_count + 1]))
2258 param_count += 2;
2260 params[param_count] = QCrehash_size;
2261 params[param_count+1] = Fplist_get (tmp, Qrehash_size);
2262 if (!NILP (params[param_count + 1]))
2263 param_count += 2;
2265 params[param_count] = QCrehash_threshold;
2266 params[param_count+1] = Fplist_get (tmp, Qrehash_threshold);
2267 if (!NILP (params[param_count + 1]))
2268 param_count += 2;
2270 /* This is the hashtable data. */
2271 data = Fplist_get (tmp, Qdata);
2273 /* Now use params to make a new hashtable and fill it. */
2274 ht = Fmake_hash_table (param_count, params);
2276 while (CONSP (data))
2278 key = XCAR (data);
2279 data = XCDR (data);
2280 if (!CONSP (data))
2281 error ("Odd number of elements in hashtable data");
2282 val = XCAR (data);
2283 data = XCDR (data);
2284 Fputhash (key, val, ht);
2287 return ht;
2289 UNREAD (c);
2290 invalid_syntax ("#", 1);
2292 if (c == '^')
2294 c = READCHAR;
2295 if (c == '[')
2297 Lisp_Object tmp;
2298 tmp = read_vector (readcharfun, 0);
2299 if (XVECTOR (tmp)->size < CHAR_TABLE_STANDARD_SLOTS)
2300 error ("Invalid size char-table");
2301 XSETPVECTYPE (XVECTOR (tmp), PVEC_CHAR_TABLE);
2302 return tmp;
2304 else if (c == '^')
2306 c = READCHAR;
2307 if (c == '[')
2309 Lisp_Object tmp;
2310 int depth, size;
2312 tmp = read_vector (readcharfun, 0);
2313 if (!INTEGERP (AREF (tmp, 0)))
2314 error ("Invalid depth in char-table");
2315 depth = XINT (AREF (tmp, 0));
2316 if (depth < 1 || depth > 3)
2317 error ("Invalid depth in char-table");
2318 size = XVECTOR (tmp)->size - 2;
2319 if (chartab_size [depth] != size)
2320 error ("Invalid size char-table");
2321 XSETPVECTYPE (XVECTOR (tmp), PVEC_SUB_CHAR_TABLE);
2322 return tmp;
2324 invalid_syntax ("#^^", 3);
2326 invalid_syntax ("#^", 2);
2328 if (c == '&')
2330 Lisp_Object length;
2331 length = read1 (readcharfun, pch, first_in_list);
2332 c = READCHAR;
2333 if (c == '"')
2335 Lisp_Object tmp, val;
2336 int size_in_chars
2337 = ((XFASTINT (length) + BOOL_VECTOR_BITS_PER_CHAR - 1)
2338 / BOOL_VECTOR_BITS_PER_CHAR);
2340 UNREAD (c);
2341 tmp = read1 (readcharfun, pch, first_in_list);
2342 if (STRING_MULTIBYTE (tmp)
2343 || (size_in_chars != SCHARS (tmp)
2344 /* We used to print 1 char too many
2345 when the number of bits was a multiple of 8.
2346 Accept such input in case it came from an old
2347 version. */
2348 && ! (XFASTINT (length)
2349 == (SCHARS (tmp) - 1) * BOOL_VECTOR_BITS_PER_CHAR)))
2350 invalid_syntax ("#&...", 5);
2352 val = Fmake_bool_vector (length, Qnil);
2353 memcpy (XBOOL_VECTOR (val)->data, SDATA (tmp), size_in_chars);
2354 /* Clear the extraneous bits in the last byte. */
2355 if (XINT (length) != size_in_chars * BOOL_VECTOR_BITS_PER_CHAR)
2356 XBOOL_VECTOR (val)->data[size_in_chars - 1]
2357 &= (1 << (XINT (length) % BOOL_VECTOR_BITS_PER_CHAR)) - 1;
2358 return val;
2360 invalid_syntax ("#&...", 5);
2362 if (c == '[')
2364 /* Accept compiled functions at read-time so that we don't have to
2365 build them using function calls. */
2366 Lisp_Object tmp;
2367 tmp = read_vector (readcharfun, 1);
2368 return Fmake_byte_code (XVECTOR (tmp)->size,
2369 XVECTOR (tmp)->contents);
2371 if (c == '(')
2373 Lisp_Object tmp;
2374 struct gcpro gcpro1;
2375 int ch;
2377 /* Read the string itself. */
2378 tmp = read1 (readcharfun, &ch, 0);
2379 if (ch != 0 || !STRINGP (tmp))
2380 invalid_syntax ("#", 1);
2381 GCPRO1 (tmp);
2382 /* Read the intervals and their properties. */
2383 while (1)
2385 Lisp_Object beg, end, plist;
2387 beg = read1 (readcharfun, &ch, 0);
2388 end = plist = Qnil;
2389 if (ch == ')')
2390 break;
2391 if (ch == 0)
2392 end = read1 (readcharfun, &ch, 0);
2393 if (ch == 0)
2394 plist = read1 (readcharfun, &ch, 0);
2395 if (ch)
2396 invalid_syntax ("Invalid string property list", 0);
2397 Fset_text_properties (beg, end, plist, tmp);
2399 UNGCPRO;
2400 return tmp;
2403 /* #@NUMBER is used to skip NUMBER following characters.
2404 That's used in .elc files to skip over doc strings
2405 and function definitions. */
2406 if (c == '@')
2408 int i, nskip = 0;
2410 load_each_byte = 1;
2411 /* Read a decimal integer. */
2412 while ((c = READCHAR) >= 0
2413 && c >= '0' && c <= '9')
2415 nskip *= 10;
2416 nskip += c - '0';
2418 if (c >= 0)
2419 UNREAD (c);
2421 if (load_force_doc_strings
2422 && (EQ (readcharfun, Qget_file_char)
2423 || EQ (readcharfun, Qget_emacs_mule_file_char)))
2425 /* If we are supposed to force doc strings into core right now,
2426 record the last string that we skipped,
2427 and record where in the file it comes from. */
2429 /* But first exchange saved_doc_string
2430 with prev_saved_doc_string, so we save two strings. */
2432 char *temp = saved_doc_string;
2433 int temp_size = saved_doc_string_size;
2434 file_offset temp_pos = saved_doc_string_position;
2435 int temp_len = saved_doc_string_length;
2437 saved_doc_string = prev_saved_doc_string;
2438 saved_doc_string_size = prev_saved_doc_string_size;
2439 saved_doc_string_position = prev_saved_doc_string_position;
2440 saved_doc_string_length = prev_saved_doc_string_length;
2442 prev_saved_doc_string = temp;
2443 prev_saved_doc_string_size = temp_size;
2444 prev_saved_doc_string_position = temp_pos;
2445 prev_saved_doc_string_length = temp_len;
2448 if (saved_doc_string_size == 0)
2450 saved_doc_string_size = nskip + 100;
2451 saved_doc_string = (char *) xmalloc (saved_doc_string_size);
2453 if (nskip > saved_doc_string_size)
2455 saved_doc_string_size = nskip + 100;
2456 saved_doc_string = (char *) xrealloc (saved_doc_string,
2457 saved_doc_string_size);
2460 saved_doc_string_position = file_tell (instream);
2462 /* Copy that many characters into saved_doc_string. */
2463 for (i = 0; i < nskip && c >= 0; i++)
2464 saved_doc_string[i] = c = READCHAR;
2466 saved_doc_string_length = i;
2468 else
2470 /* Skip that many characters. */
2471 for (i = 0; i < nskip && c >= 0; i++)
2472 c = READCHAR;
2475 load_each_byte = 0;
2476 goto retry;
2478 if (c == '!')
2480 /* #! appears at the beginning of an executable file.
2481 Skip the first line. */
2482 while (c != '\n' && c >= 0)
2483 c = READCHAR;
2484 goto retry;
2486 if (c == '$')
2487 return Vload_file_name;
2488 if (c == '\'')
2489 return Fcons (Qfunction, Fcons (read0 (readcharfun), Qnil));
2490 /* #:foo is the uninterned symbol named foo. */
2491 if (c == ':')
2493 uninterned_symbol = 1;
2494 c = READCHAR;
2495 goto default_label;
2497 /* Reader forms that can reuse previously read objects. */
2498 if (c >= '0' && c <= '9')
2500 int n = 0;
2501 Lisp_Object tem;
2503 /* Read a non-negative integer. */
2504 while (c >= '0' && c <= '9')
2506 n *= 10;
2507 n += c - '0';
2508 c = READCHAR;
2510 /* #n=object returns object, but associates it with n for #n#. */
2511 if (c == '=' && !NILP (Vread_circle))
2513 /* Make a placeholder for #n# to use temporarily */
2514 Lisp_Object placeholder;
2515 Lisp_Object cell;
2517 placeholder = Fcons (Qnil, Qnil);
2518 cell = Fcons (make_number (n), placeholder);
2519 read_objects = Fcons (cell, read_objects);
2521 /* Read the object itself. */
2522 tem = read0 (readcharfun);
2524 /* Now put it everywhere the placeholder was... */
2525 substitute_object_in_subtree (tem, placeholder);
2527 /* ...and #n# will use the real value from now on. */
2528 Fsetcdr (cell, tem);
2530 return tem;
2532 /* #n# returns a previously read object. */
2533 if (c == '#' && !NILP (Vread_circle))
2535 tem = Fassq (make_number (n), read_objects);
2536 if (CONSP (tem))
2537 return XCDR (tem);
2538 /* Fall through to error message. */
2540 else if (c == 'r' || c == 'R')
2541 return read_integer (readcharfun, n);
2543 /* Fall through to error message. */
2545 else if (c == 'x' || c == 'X')
2546 return read_integer (readcharfun, 16);
2547 else if (c == 'o' || c == 'O')
2548 return read_integer (readcharfun, 8);
2549 else if (c == 'b' || c == 'B')
2550 return read_integer (readcharfun, 2);
2552 UNREAD (c);
2553 invalid_syntax ("#", 1);
2555 case ';':
2556 while ((c = READCHAR) >= 0 && c != '\n');
2557 goto retry;
2559 case '\'':
2561 return Fcons (Qquote, Fcons (read0 (readcharfun), Qnil));
2564 case '`':
2566 int next_char = READCHAR;
2567 UNREAD (next_char);
2568 /* Transition from old-style to new-style:
2569 If we see "(`" it used to mean old-style, which usually works
2570 fine because ` should almost never appear in such a position
2571 for new-style. But occasionally we need "(`" to mean new
2572 style, so we try to distinguish the two by the fact that we
2573 can either write "( `foo" or "(` foo", where the first
2574 intends to use new-style whereas the second intends to use
2575 old-style. For Emacs-25, we should completely remove this
2576 first_in_list exception (old-style can still be obtained via
2577 "(\`" anyway). */
2578 if (!new_backquote_flag && first_in_list && next_char == ' ')
2580 Vold_style_backquotes = Qt;
2581 goto default_label;
2583 else
2585 Lisp_Object value;
2587 new_backquote_flag++;
2588 value = read0 (readcharfun);
2589 new_backquote_flag--;
2591 return Fcons (Qbackquote, Fcons (value, Qnil));
2594 case ',':
2596 int next_char = READCHAR;
2597 UNREAD (next_char);
2598 /* Transition from old-style to new-style:
2599 It used to be impossible to have a new-style , other than within
2600 a new-style `. This is sufficient when ` and , are used in the
2601 normal way, but ` and , can also appear in args to macros that
2602 will not interpret them in the usual way, in which case , may be
2603 used without any ` anywhere near.
2604 So we now use the same heuristic as for backquote: old-style
2605 unquotes are only recognized when first on a list, and when
2606 followed by a space.
2607 Because it's more difficult to peak 2 chars ahead, a new-style
2608 ,@ can still not be used outside of a `, unless it's in the middle
2609 of a list. */
2610 if (new_backquote_flag
2611 || !first_in_list
2612 || (next_char != ' ' && next_char != '@'))
2614 Lisp_Object comma_type = Qnil;
2615 Lisp_Object value;
2616 int ch = READCHAR;
2618 if (ch == '@')
2619 comma_type = Qcomma_at;
2620 else if (ch == '.')
2621 comma_type = Qcomma_dot;
2622 else
2624 if (ch >= 0) UNREAD (ch);
2625 comma_type = Qcomma;
2628 value = read0 (readcharfun);
2629 return Fcons (comma_type, Fcons (value, Qnil));
2631 else
2633 Vold_style_backquotes = Qt;
2634 goto default_label;
2637 case '?':
2639 int modifiers;
2640 int next_char;
2641 int ok;
2643 c = READCHAR;
2644 if (c < 0)
2645 end_of_file_error ();
2647 /* Accept `single space' syntax like (list ? x) where the
2648 whitespace character is SPC or TAB.
2649 Other literal whitespace like NL, CR, and FF are not accepted,
2650 as there are well-established escape sequences for these. */
2651 if (c == ' ' || c == '\t')
2652 return make_number (c);
2654 if (c == '\\')
2655 c = read_escape (readcharfun, 0);
2656 modifiers = c & CHAR_MODIFIER_MASK;
2657 c &= ~CHAR_MODIFIER_MASK;
2658 if (CHAR_BYTE8_P (c))
2659 c = CHAR_TO_BYTE8 (c);
2660 c |= modifiers;
2662 next_char = READCHAR;
2663 ok = (next_char <= 040
2664 || (next_char < 0200
2665 && (strchr ("\"';()[]#?`,.", next_char))));
2666 UNREAD (next_char);
2667 if (ok)
2668 return make_number (c);
2670 invalid_syntax ("?", 1);
2673 case '"':
2675 char *p = read_buffer;
2676 char *end = read_buffer + read_buffer_size;
2677 register int ch;
2678 /* Nonzero if we saw an escape sequence specifying
2679 a multibyte character. */
2680 int force_multibyte = 0;
2681 /* Nonzero if we saw an escape sequence specifying
2682 a single-byte character. */
2683 int force_singlebyte = 0;
2684 int cancel = 0;
2685 int nchars = 0;
2687 while ((ch = READCHAR) >= 0
2688 && ch != '\"')
2690 if (end - p < MAX_MULTIBYTE_LENGTH)
2692 int offset = p - read_buffer;
2693 read_buffer = (char *) xrealloc (read_buffer,
2694 read_buffer_size *= 2);
2695 p = read_buffer + offset;
2696 end = read_buffer + read_buffer_size;
2699 if (ch == '\\')
2701 int modifiers;
2703 ch = read_escape (readcharfun, 1);
2705 /* CH is -1 if \ newline has just been seen */
2706 if (ch == -1)
2708 if (p == read_buffer)
2709 cancel = 1;
2710 continue;
2713 modifiers = ch & CHAR_MODIFIER_MASK;
2714 ch = ch & ~CHAR_MODIFIER_MASK;
2716 if (CHAR_BYTE8_P (ch))
2717 force_singlebyte = 1;
2718 else if (! ASCII_CHAR_P (ch))
2719 force_multibyte = 1;
2720 else /* i.e. ASCII_CHAR_P (ch) */
2722 /* Allow `\C- ' and `\C-?'. */
2723 if (modifiers == CHAR_CTL)
2725 if (ch == ' ')
2726 ch = 0, modifiers = 0;
2727 else if (ch == '?')
2728 ch = 127, modifiers = 0;
2730 if (modifiers & CHAR_SHIFT)
2732 /* Shift modifier is valid only with [A-Za-z]. */
2733 if (ch >= 'A' && ch <= 'Z')
2734 modifiers &= ~CHAR_SHIFT;
2735 else if (ch >= 'a' && ch <= 'z')
2736 ch -= ('a' - 'A'), modifiers &= ~CHAR_SHIFT;
2739 if (modifiers & CHAR_META)
2741 /* Move the meta bit to the right place for a
2742 string. */
2743 modifiers &= ~CHAR_META;
2744 ch = BYTE8_TO_CHAR (ch | 0x80);
2745 force_singlebyte = 1;
2749 /* Any modifiers remaining are invalid. */
2750 if (modifiers)
2751 error ("Invalid modifier in string");
2752 p += CHAR_STRING (ch, (unsigned char *) p);
2754 else
2756 p += CHAR_STRING (ch, (unsigned char *) p);
2757 if (CHAR_BYTE8_P (ch))
2758 force_singlebyte = 1;
2759 else if (! ASCII_CHAR_P (ch))
2760 force_multibyte = 1;
2762 nchars++;
2765 if (ch < 0)
2766 end_of_file_error ();
2768 /* If purifying, and string starts with \ newline,
2769 return zero instead. This is for doc strings
2770 that we are really going to find in etc/DOC.nn.nn */
2771 if (!NILP (Vpurify_flag) && NILP (Vdoc_file_name) && cancel)
2772 return make_number (0);
2774 if (force_multibyte)
2775 /* READ_BUFFER already contains valid multibyte forms. */
2777 else if (force_singlebyte)
2779 nchars = str_as_unibyte ((unsigned char *) read_buffer,
2780 p - read_buffer);
2781 p = read_buffer + nchars;
2783 else
2785 /* Otherwise, READ_BUFFER contains only ASCII. */
2788 /* We want readchar_count to be the number of characters, not
2789 bytes. Hence we adjust for multibyte characters in the
2790 string. ... But it doesn't seem to be necessary, because
2791 READCHAR *does* read multibyte characters from buffers. */
2792 /* readchar_count -= (p - read_buffer) - nchars; */
2793 if (read_pure)
2794 return make_pure_string (read_buffer, nchars, p - read_buffer,
2795 (force_multibyte
2796 || (p - read_buffer != nchars)));
2797 return make_specified_string (read_buffer, nchars, p - read_buffer,
2798 (force_multibyte
2799 || (p - read_buffer != nchars)));
2802 case '.':
2804 int next_char = READCHAR;
2805 UNREAD (next_char);
2807 if (next_char <= 040
2808 || (next_char < 0200
2809 && (strchr ("\"';([#?`,", next_char))))
2811 *pch = c;
2812 return Qnil;
2815 /* Otherwise, we fall through! Note that the atom-reading loop
2816 below will now loop at least once, assuring that we will not
2817 try to UNREAD two characters in a row. */
2819 default:
2820 default_label:
2821 if (c <= 040) goto retry;
2822 if (c == 0x8a0) /* NBSP */
2823 goto retry;
2825 char *p = read_buffer;
2826 int quoted = 0;
2829 char *end = read_buffer + read_buffer_size;
2833 if (end - p < MAX_MULTIBYTE_LENGTH)
2835 int offset = p - read_buffer;
2836 read_buffer = (char *) xrealloc (read_buffer,
2837 read_buffer_size *= 2);
2838 p = read_buffer + offset;
2839 end = read_buffer + read_buffer_size;
2842 if (c == '\\')
2844 c = READCHAR;
2845 if (c == -1)
2846 end_of_file_error ();
2847 quoted = 1;
2850 if (multibyte)
2851 p += CHAR_STRING (c, (unsigned char *) p);
2852 else
2853 *p++ = c;
2854 c = READCHAR;
2855 } while (c > 040
2856 && c != 0x8a0 /* NBSP */
2857 && (c >= 0200
2858 || !(strchr ("\"';()[]#`,", c))));
2860 if (p == end)
2862 int offset = p - read_buffer;
2863 read_buffer = (char *) xrealloc (read_buffer,
2864 read_buffer_size *= 2);
2865 p = read_buffer + offset;
2866 end = read_buffer + read_buffer_size;
2868 *p = 0;
2869 if (c >= 0)
2870 UNREAD (c);
2873 if (!quoted && !uninterned_symbol)
2875 register char *p1;
2876 p1 = read_buffer;
2877 if (*p1 == '+' || *p1 == '-') p1++;
2878 /* Is it an integer? */
2879 if (p1 != p)
2881 while (p1 != p && (c = *p1) >= '0' && c <= '9') p1++;
2882 /* Integers can have trailing decimal points. */
2883 if (p1 > read_buffer && p1 < p && *p1 == '.') p1++;
2884 if (p1 == p)
2885 /* It is an integer. */
2887 if (p1[-1] == '.')
2888 p1[-1] = '\0';
2890 /* EMACS_INT n = atol (read_buffer); */
2891 char *endptr = NULL;
2892 EMACS_INT n = (errno = 0,
2893 strtol (read_buffer, &endptr, 10));
2894 if (errno == ERANGE && endptr)
2896 Lisp_Object args
2897 = Fcons (make_string (read_buffer,
2898 endptr - read_buffer),
2899 Qnil);
2900 xsignal (Qoverflow_error, args);
2902 return make_fixnum_or_float (n);
2906 if (isfloat_string (read_buffer, 0))
2908 /* Compute NaN and infinities using 0.0 in a variable,
2909 to cope with compilers that think they are smarter
2910 than we are. */
2911 double zero = 0.0;
2913 double value;
2915 /* Negate the value ourselves. This treats 0, NaNs,
2916 and infinity properly on IEEE floating point hosts,
2917 and works around a common bug where atof ("-0.0")
2918 drops the sign. */
2919 int negative = read_buffer[0] == '-';
2921 /* The only way p[-1] can be 'F' or 'N', after isfloat_string
2922 returns 1, is if the input ends in e+INF or e+NaN. */
2923 switch (p[-1])
2925 case 'F':
2926 value = 1.0 / zero;
2927 break;
2928 case 'N':
2929 value = zero / zero;
2931 /* If that made a "negative" NaN, negate it. */
2934 int i;
2935 union { double d; char c[sizeof (double)]; } u_data, u_minus_zero;
2937 u_data.d = value;
2938 u_minus_zero.d = - 0.0;
2939 for (i = 0; i < sizeof (double); i++)
2940 if (u_data.c[i] & u_minus_zero.c[i])
2942 value = - value;
2943 break;
2946 /* Now VALUE is a positive NaN. */
2947 break;
2948 default:
2949 value = atof (read_buffer + negative);
2950 break;
2953 return make_float (negative ? - value : value);
2957 Lisp_Object name, result;
2958 EMACS_INT nbytes = p - read_buffer;
2959 EMACS_INT nchars
2960 = (multibyte
2961 ? multibyte_chars_in_text ((unsigned char *) read_buffer,
2962 nbytes)
2963 : nbytes);
2965 if (uninterned_symbol && ! NILP (Vpurify_flag))
2966 name = make_pure_string (read_buffer, nchars, nbytes, multibyte);
2967 else
2968 name = make_specified_string (read_buffer, nchars, nbytes,multibyte);
2969 result = (uninterned_symbol ? Fmake_symbol (name)
2970 : Fintern (name, Qnil));
2972 if (EQ (Vread_with_symbol_positions, Qt)
2973 || EQ (Vread_with_symbol_positions, readcharfun))
2974 Vread_symbol_positions_list =
2975 /* Kind of a hack; this will probably fail if characters
2976 in the symbol name were escaped. Not really a big
2977 deal, though. */
2978 Fcons (Fcons (result,
2979 make_number (readchar_count
2980 - XFASTINT (Flength (Fsymbol_name (result))))),
2981 Vread_symbol_positions_list);
2982 return result;
2989 /* List of nodes we've seen during substitute_object_in_subtree. */
2990 static Lisp_Object seen_list;
2992 static void
2993 substitute_object_in_subtree (Lisp_Object object, Lisp_Object placeholder)
2995 Lisp_Object check_object;
2997 /* We haven't seen any objects when we start. */
2998 seen_list = Qnil;
3000 /* Make all the substitutions. */
3001 check_object
3002 = substitute_object_recurse (object, placeholder, object);
3004 /* Clear seen_list because we're done with it. */
3005 seen_list = Qnil;
3007 /* The returned object here is expected to always eq the
3008 original. */
3009 if (!EQ (check_object, object))
3010 error ("Unexpected mutation error in reader");
3013 /* Feval doesn't get called from here, so no gc protection is needed. */
3014 #define SUBSTITUTE(get_val, set_val) \
3015 do { \
3016 Lisp_Object old_value = get_val; \
3017 Lisp_Object true_value \
3018 = substitute_object_recurse (object, placeholder, \
3019 old_value); \
3021 if (!EQ (old_value, true_value)) \
3023 set_val; \
3025 } while (0)
3027 static Lisp_Object
3028 substitute_object_recurse (Lisp_Object object, Lisp_Object placeholder, Lisp_Object subtree)
3030 /* If we find the placeholder, return the target object. */
3031 if (EQ (placeholder, subtree))
3032 return object;
3034 /* If we've been to this node before, don't explore it again. */
3035 if (!EQ (Qnil, Fmemq (subtree, seen_list)))
3036 return subtree;
3038 /* If this node can be the entry point to a cycle, remember that
3039 we've seen it. It can only be such an entry point if it was made
3040 by #n=, which means that we can find it as a value in
3041 read_objects. */
3042 if (!EQ (Qnil, Frassq (subtree, read_objects)))
3043 seen_list = Fcons (subtree, seen_list);
3045 /* Recurse according to subtree's type.
3046 Every branch must return a Lisp_Object. */
3047 switch (XTYPE (subtree))
3049 case Lisp_Vectorlike:
3051 int i, length = 0;
3052 if (BOOL_VECTOR_P (subtree))
3053 return subtree; /* No sub-objects anyway. */
3054 else if (CHAR_TABLE_P (subtree) || SUB_CHAR_TABLE_P (subtree)
3055 || COMPILEDP (subtree))
3056 length = ASIZE (subtree) & PSEUDOVECTOR_SIZE_MASK;
3057 else if (VECTORP (subtree))
3058 length = ASIZE (subtree);
3059 else
3060 /* An unknown pseudovector may contain non-Lisp fields, so we
3061 can't just blindly traverse all its fields. We used to call
3062 `Flength' which signaled `sequencep', so I just preserved this
3063 behavior. */
3064 wrong_type_argument (Qsequencep, subtree);
3066 for (i = 0; i < length; i++)
3067 SUBSTITUTE (AREF (subtree, i),
3068 ASET (subtree, i, true_value));
3069 return subtree;
3072 case Lisp_Cons:
3074 SUBSTITUTE (XCAR (subtree),
3075 XSETCAR (subtree, true_value));
3076 SUBSTITUTE (XCDR (subtree),
3077 XSETCDR (subtree, true_value));
3078 return subtree;
3081 case Lisp_String:
3083 /* Check for text properties in each interval.
3084 substitute_in_interval contains part of the logic. */
3086 INTERVAL root_interval = STRING_INTERVALS (subtree);
3087 Lisp_Object arg = Fcons (object, placeholder);
3089 traverse_intervals_noorder (root_interval,
3090 &substitute_in_interval, arg);
3092 return subtree;
3095 /* Other types don't recurse any further. */
3096 default:
3097 return subtree;
3101 /* Helper function for substitute_object_recurse. */
3102 static void
3103 substitute_in_interval (INTERVAL interval, Lisp_Object arg)
3105 Lisp_Object object = Fcar (arg);
3106 Lisp_Object placeholder = Fcdr (arg);
3108 SUBSTITUTE (interval->plist, interval->plist = true_value);
3112 #define LEAD_INT 1
3113 #define DOT_CHAR 2
3114 #define TRAIL_INT 4
3115 #define E_CHAR 8
3116 #define EXP_INT 16
3119 isfloat_string (const char *cp, int ignore_trailing)
3121 int state;
3122 const char *start = cp;
3124 state = 0;
3125 if (*cp == '+' || *cp == '-')
3126 cp++;
3128 if (*cp >= '0' && *cp <= '9')
3130 state |= LEAD_INT;
3131 while (*cp >= '0' && *cp <= '9')
3132 cp++;
3134 if (*cp == '.')
3136 state |= DOT_CHAR;
3137 cp++;
3139 if (*cp >= '0' && *cp <= '9')
3141 state |= TRAIL_INT;
3142 while (*cp >= '0' && *cp <= '9')
3143 cp++;
3145 if (*cp == 'e' || *cp == 'E')
3147 state |= E_CHAR;
3148 cp++;
3149 if (*cp == '+' || *cp == '-')
3150 cp++;
3153 if (*cp >= '0' && *cp <= '9')
3155 state |= EXP_INT;
3156 while (*cp >= '0' && *cp <= '9')
3157 cp++;
3159 else if (cp == start)
3161 else if (cp[-1] == '+' && cp[0] == 'I' && cp[1] == 'N' && cp[2] == 'F')
3163 state |= EXP_INT;
3164 cp += 3;
3166 else if (cp[-1] == '+' && cp[0] == 'N' && cp[1] == 'a' && cp[2] == 'N')
3168 state |= EXP_INT;
3169 cp += 3;
3172 return ((ignore_trailing
3173 || *cp == 0 || *cp == ' ' || *cp == '\t' || *cp == '\n'
3174 || *cp == '\r' || *cp == '\f')
3175 && (state == (LEAD_INT|DOT_CHAR|TRAIL_INT)
3176 || state == (DOT_CHAR|TRAIL_INT)
3177 || state == (LEAD_INT|E_CHAR|EXP_INT)
3178 || state == (LEAD_INT|DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)
3179 || state == (DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)));
3183 static Lisp_Object
3184 read_vector (Lisp_Object readcharfun, int bytecodeflag)
3186 register int i;
3187 register int size;
3188 register Lisp_Object *ptr;
3189 register Lisp_Object tem, item, vector;
3190 register struct Lisp_Cons *otem;
3191 Lisp_Object len;
3193 tem = read_list (1, readcharfun);
3194 len = Flength (tem);
3195 vector = (read_pure ? make_pure_vector (XINT (len)) : Fmake_vector (len, Qnil));
3197 size = XVECTOR (vector)->size;
3198 ptr = XVECTOR (vector)->contents;
3199 for (i = 0; i < size; i++)
3201 item = Fcar (tem);
3202 /* If `load-force-doc-strings' is t when reading a lazily-loaded
3203 bytecode object, the docstring containing the bytecode and
3204 constants values must be treated as unibyte and passed to
3205 Fread, to get the actual bytecode string and constants vector. */
3206 if (bytecodeflag && load_force_doc_strings)
3208 if (i == COMPILED_BYTECODE)
3210 if (!STRINGP (item))
3211 error ("Invalid byte code");
3213 /* Delay handling the bytecode slot until we know whether
3214 it is lazily-loaded (we can tell by whether the
3215 constants slot is nil). */
3216 ptr[COMPILED_CONSTANTS] = item;
3217 item = Qnil;
3219 else if (i == COMPILED_CONSTANTS)
3221 Lisp_Object bytestr = ptr[COMPILED_CONSTANTS];
3223 if (NILP (item))
3225 /* Coerce string to unibyte (like string-as-unibyte,
3226 but without generating extra garbage and
3227 guaranteeing no change in the contents). */
3228 STRING_SET_CHARS (bytestr, SBYTES (bytestr));
3229 STRING_SET_UNIBYTE (bytestr);
3231 item = Fread (Fcons (bytestr, readcharfun));
3232 if (!CONSP (item))
3233 error ("Invalid byte code");
3235 otem = XCONS (item);
3236 bytestr = XCAR (item);
3237 item = XCDR (item);
3238 free_cons (otem);
3241 /* Now handle the bytecode slot. */
3242 ptr[COMPILED_BYTECODE] = read_pure ? Fpurecopy (bytestr) : bytestr;
3244 else if (i == COMPILED_DOC_STRING
3245 && STRINGP (item)
3246 && ! STRING_MULTIBYTE (item))
3248 if (EQ (readcharfun, Qget_emacs_mule_file_char))
3249 item = Fdecode_coding_string (item, Qemacs_mule, Qnil, Qnil);
3250 else
3251 item = Fstring_as_multibyte (item);
3254 ptr[i] = read_pure ? Fpurecopy (item) : item;
3255 otem = XCONS (tem);
3256 tem = Fcdr (tem);
3257 free_cons (otem);
3259 return vector;
3262 /* FLAG = 1 means check for ] to terminate rather than ) and .
3263 FLAG = -1 means check for starting with defun
3264 and make structure pure. */
3266 static Lisp_Object
3267 read_list (int flag, register Lisp_Object readcharfun)
3269 /* -1 means check next element for defun,
3270 0 means don't check,
3271 1 means already checked and found defun. */
3272 int defunflag = flag < 0 ? -1 : 0;
3273 Lisp_Object val, tail;
3274 register Lisp_Object elt, tem;
3275 struct gcpro gcpro1, gcpro2;
3276 /* 0 is the normal case.
3277 1 means this list is a doc reference; replace it with the number 0.
3278 2 means this list is a doc reference; replace it with the doc string. */
3279 int doc_reference = 0;
3281 /* Initialize this to 1 if we are reading a list. */
3282 int first_in_list = flag <= 0;
3284 val = Qnil;
3285 tail = Qnil;
3287 while (1)
3289 int ch;
3290 GCPRO2 (val, tail);
3291 elt = read1 (readcharfun, &ch, first_in_list);
3292 UNGCPRO;
3294 first_in_list = 0;
3296 /* While building, if the list starts with #$, treat it specially. */
3297 if (EQ (elt, Vload_file_name)
3298 && ! NILP (elt)
3299 && !NILP (Vpurify_flag))
3301 if (NILP (Vdoc_file_name))
3302 /* We have not yet called Snarf-documentation, so assume
3303 this file is described in the DOC-MM.NN file
3304 and Snarf-documentation will fill in the right value later.
3305 For now, replace the whole list with 0. */
3306 doc_reference = 1;
3307 else
3308 /* We have already called Snarf-documentation, so make a relative
3309 file name for this file, so it can be found properly
3310 in the installed Lisp directory.
3311 We don't use Fexpand_file_name because that would make
3312 the directory absolute now. */
3313 elt = concat2 (build_string ("../lisp/"),
3314 Ffile_name_nondirectory (elt));
3316 else if (EQ (elt, Vload_file_name)
3317 && ! NILP (elt)
3318 && load_force_doc_strings)
3319 doc_reference = 2;
3321 if (ch)
3323 if (flag > 0)
3325 if (ch == ']')
3326 return val;
3327 invalid_syntax (") or . in a vector", 18);
3329 if (ch == ')')
3330 return val;
3331 if (ch == '.')
3333 GCPRO2 (val, tail);
3334 if (!NILP (tail))
3335 XSETCDR (tail, read0 (readcharfun));
3336 else
3337 val = read0 (readcharfun);
3338 read1 (readcharfun, &ch, 0);
3339 UNGCPRO;
3340 if (ch == ')')
3342 if (doc_reference == 1)
3343 return make_number (0);
3344 if (doc_reference == 2)
3346 /* Get a doc string from the file we are loading.
3347 If it's in saved_doc_string, get it from there.
3349 Here, we don't know if the string is a
3350 bytecode string or a doc string. As a
3351 bytecode string must be unibyte, we always
3352 return a unibyte string. If it is actually a
3353 doc string, caller must make it
3354 multibyte. */
3356 int pos = XINT (XCDR (val));
3357 /* Position is negative for user variables. */
3358 if (pos < 0) pos = -pos;
3359 if (pos >= saved_doc_string_position
3360 && pos < (saved_doc_string_position
3361 + saved_doc_string_length))
3363 int start = pos - saved_doc_string_position;
3364 int from, to;
3366 /* Process quoting with ^A,
3367 and find the end of the string,
3368 which is marked with ^_ (037). */
3369 for (from = start, to = start;
3370 saved_doc_string[from] != 037;)
3372 int c = saved_doc_string[from++];
3373 if (c == 1)
3375 c = saved_doc_string[from++];
3376 if (c == 1)
3377 saved_doc_string[to++] = c;
3378 else if (c == '0')
3379 saved_doc_string[to++] = 0;
3380 else if (c == '_')
3381 saved_doc_string[to++] = 037;
3383 else
3384 saved_doc_string[to++] = c;
3387 return make_unibyte_string (saved_doc_string + start,
3388 to - start);
3390 /* Look in prev_saved_doc_string the same way. */
3391 else if (pos >= prev_saved_doc_string_position
3392 && pos < (prev_saved_doc_string_position
3393 + prev_saved_doc_string_length))
3395 int start = pos - prev_saved_doc_string_position;
3396 int from, to;
3398 /* Process quoting with ^A,
3399 and find the end of the string,
3400 which is marked with ^_ (037). */
3401 for (from = start, to = start;
3402 prev_saved_doc_string[from] != 037;)
3404 int c = prev_saved_doc_string[from++];
3405 if (c == 1)
3407 c = prev_saved_doc_string[from++];
3408 if (c == 1)
3409 prev_saved_doc_string[to++] = c;
3410 else if (c == '0')
3411 prev_saved_doc_string[to++] = 0;
3412 else if (c == '_')
3413 prev_saved_doc_string[to++] = 037;
3415 else
3416 prev_saved_doc_string[to++] = c;
3419 return make_unibyte_string (prev_saved_doc_string
3420 + start,
3421 to - start);
3423 else
3424 return get_doc_string (val, 1, 0);
3427 return val;
3429 invalid_syntax (". in wrong context", 18);
3431 invalid_syntax ("] in a list", 11);
3433 tem = (read_pure && flag <= 0
3434 ? pure_cons (elt, Qnil)
3435 : Fcons (elt, Qnil));
3436 if (!NILP (tail))
3437 XSETCDR (tail, tem);
3438 else
3439 val = tem;
3440 tail = tem;
3441 if (defunflag < 0)
3442 defunflag = EQ (elt, Qdefun);
3443 else if (defunflag > 0)
3444 read_pure = 1;
3448 Lisp_Object initial_obarray;
3450 /* oblookup stores the bucket number here, for the sake of Funintern. */
3452 int oblookup_last_bucket_number;
3454 static int hash_string (const char *ptr, int len);
3456 /* Get an error if OBARRAY is not an obarray.
3457 If it is one, return it. */
3459 Lisp_Object
3460 check_obarray (Lisp_Object obarray)
3462 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3464 /* If Vobarray is now invalid, force it to be valid. */
3465 if (EQ (Vobarray, obarray)) Vobarray = initial_obarray;
3466 wrong_type_argument (Qvectorp, obarray);
3468 return obarray;
3471 /* Intern the C string STR: return a symbol with that name,
3472 interned in the current obarray. */
3474 Lisp_Object
3475 intern (const char *str)
3477 Lisp_Object tem;
3478 int len = strlen (str);
3479 Lisp_Object obarray;
3481 obarray = Vobarray;
3482 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3483 obarray = check_obarray (obarray);
3484 tem = oblookup (obarray, str, len, len);
3485 if (SYMBOLP (tem))
3486 return tem;
3487 return Fintern (make_string (str, len), obarray);
3490 Lisp_Object
3491 intern_c_string (const char *str)
3493 Lisp_Object tem;
3494 int len = strlen (str);
3495 Lisp_Object obarray;
3497 obarray = Vobarray;
3498 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3499 obarray = check_obarray (obarray);
3500 tem = oblookup (obarray, str, len, len);
3501 if (SYMBOLP (tem))
3502 return tem;
3504 if (NILP (Vpurify_flag))
3505 /* Creating a non-pure string from a string literal not
3506 implemented yet. We could just use make_string here and live
3507 with the extra copy. */
3508 abort ();
3510 return Fintern (make_pure_c_string (str), obarray);
3513 /* Create an uninterned symbol with name STR. */
3515 Lisp_Object
3516 make_symbol (const char *str)
3518 int len = strlen (str);
3520 return Fmake_symbol (!NILP (Vpurify_flag)
3521 ? make_pure_string (str, len, len, 0)
3522 : make_string (str, len));
3525 DEFUN ("intern", Fintern, Sintern, 1, 2, 0,
3526 doc: /* Return the canonical symbol whose name is STRING.
3527 If there is none, one is created by this function and returned.
3528 A second optional argument specifies the obarray to use;
3529 it defaults to the value of `obarray'. */)
3530 (Lisp_Object string, Lisp_Object obarray)
3532 register Lisp_Object tem, sym, *ptr;
3534 if (NILP (obarray)) obarray = Vobarray;
3535 obarray = check_obarray (obarray);
3537 CHECK_STRING (string);
3539 tem = oblookup (obarray, SSDATA (string),
3540 SCHARS (string),
3541 SBYTES (string));
3542 if (!INTEGERP (tem))
3543 return tem;
3545 if (!NILP (Vpurify_flag))
3546 string = Fpurecopy (string);
3547 sym = Fmake_symbol (string);
3549 if (EQ (obarray, initial_obarray))
3550 XSYMBOL (sym)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3551 else
3552 XSYMBOL (sym)->interned = SYMBOL_INTERNED;
3554 if ((SREF (string, 0) == ':')
3555 && EQ (obarray, initial_obarray))
3557 XSYMBOL (sym)->constant = 1;
3558 XSYMBOL (sym)->redirect = SYMBOL_PLAINVAL;
3559 SET_SYMBOL_VAL (XSYMBOL (sym), sym);
3562 ptr = &XVECTOR (obarray)->contents[XINT (tem)];
3563 if (SYMBOLP (*ptr))
3564 XSYMBOL (sym)->next = XSYMBOL (*ptr);
3565 else
3566 XSYMBOL (sym)->next = 0;
3567 *ptr = sym;
3568 return sym;
3571 DEFUN ("intern-soft", Fintern_soft, Sintern_soft, 1, 2, 0,
3572 doc: /* Return the canonical symbol named NAME, or nil if none exists.
3573 NAME may be a string or a symbol. If it is a symbol, that exact
3574 symbol is searched for.
3575 A second optional argument specifies the obarray to use;
3576 it defaults to the value of `obarray'. */)
3577 (Lisp_Object name, Lisp_Object obarray)
3579 register Lisp_Object tem, string;
3581 if (NILP (obarray)) obarray = Vobarray;
3582 obarray = check_obarray (obarray);
3584 if (!SYMBOLP (name))
3586 CHECK_STRING (name);
3587 string = name;
3589 else
3590 string = SYMBOL_NAME (name);
3592 tem = oblookup (obarray, SSDATA (string), SCHARS (string), SBYTES (string));
3593 if (INTEGERP (tem) || (SYMBOLP (name) && !EQ (name, tem)))
3594 return Qnil;
3595 else
3596 return tem;
3599 DEFUN ("unintern", Funintern, Sunintern, 1, 2, 0,
3600 doc: /* Delete the symbol named NAME, if any, from OBARRAY.
3601 The value is t if a symbol was found and deleted, nil otherwise.
3602 NAME may be a string or a symbol. If it is a symbol, that symbol
3603 is deleted, if it belongs to OBARRAY--no other symbol is deleted.
3604 OBARRAY defaults to the value of the variable `obarray'. */)
3605 (Lisp_Object name, Lisp_Object obarray)
3607 register Lisp_Object string, tem;
3608 int hash;
3610 if (NILP (obarray)) obarray = Vobarray;
3611 obarray = check_obarray (obarray);
3613 if (SYMBOLP (name))
3614 string = SYMBOL_NAME (name);
3615 else
3617 CHECK_STRING (name);
3618 string = name;
3621 tem = oblookup (obarray, SSDATA (string),
3622 SCHARS (string),
3623 SBYTES (string));
3624 if (INTEGERP (tem))
3625 return Qnil;
3626 /* If arg was a symbol, don't delete anything but that symbol itself. */
3627 if (SYMBOLP (name) && !EQ (name, tem))
3628 return Qnil;
3630 /* There are plenty of other symbols which will screw up the Emacs
3631 session if we unintern them, as well as even more ways to use
3632 `setq' or `fset' or whatnot to make the Emacs session
3633 unusable. Let's not go down this silly road. --Stef */
3634 /* if (EQ (tem, Qnil) || EQ (tem, Qt))
3635 error ("Attempt to unintern t or nil"); */
3637 XSYMBOL (tem)->interned = SYMBOL_UNINTERNED;
3639 hash = oblookup_last_bucket_number;
3641 if (EQ (XVECTOR (obarray)->contents[hash], tem))
3643 if (XSYMBOL (tem)->next)
3644 XSETSYMBOL (XVECTOR (obarray)->contents[hash], XSYMBOL (tem)->next);
3645 else
3646 XSETINT (XVECTOR (obarray)->contents[hash], 0);
3648 else
3650 Lisp_Object tail, following;
3652 for (tail = XVECTOR (obarray)->contents[hash];
3653 XSYMBOL (tail)->next;
3654 tail = following)
3656 XSETSYMBOL (following, XSYMBOL (tail)->next);
3657 if (EQ (following, tem))
3659 XSYMBOL (tail)->next = XSYMBOL (following)->next;
3660 break;
3665 return Qt;
3668 /* Return the symbol in OBARRAY whose names matches the string
3669 of SIZE characters (SIZE_BYTE bytes) at PTR.
3670 If there is no such symbol in OBARRAY, return nil.
3672 Also store the bucket number in oblookup_last_bucket_number. */
3674 Lisp_Object
3675 oblookup (Lisp_Object obarray, register const char *ptr, EMACS_INT size, EMACS_INT size_byte)
3677 int hash;
3678 int obsize;
3679 register Lisp_Object tail;
3680 Lisp_Object bucket, tem;
3682 if (!VECTORP (obarray)
3683 || (obsize = XVECTOR (obarray)->size) == 0)
3685 obarray = check_obarray (obarray);
3686 obsize = XVECTOR (obarray)->size;
3688 /* This is sometimes needed in the middle of GC. */
3689 obsize &= ~ARRAY_MARK_FLAG;
3690 hash = hash_string (ptr, size_byte) % obsize;
3691 bucket = XVECTOR (obarray)->contents[hash];
3692 oblookup_last_bucket_number = hash;
3693 if (EQ (bucket, make_number (0)))
3695 else if (!SYMBOLP (bucket))
3696 error ("Bad data in guts of obarray"); /* Like CADR error message */
3697 else
3698 for (tail = bucket; ; XSETSYMBOL (tail, XSYMBOL (tail)->next))
3700 if (SBYTES (SYMBOL_NAME (tail)) == size_byte
3701 && SCHARS (SYMBOL_NAME (tail)) == size
3702 && !memcmp (SDATA (SYMBOL_NAME (tail)), ptr, size_byte))
3703 return tail;
3704 else if (XSYMBOL (tail)->next == 0)
3705 break;
3707 XSETINT (tem, hash);
3708 return tem;
3711 static int
3712 hash_string (const char *ptr, int len)
3714 register const char *p = ptr;
3715 register const char *end = p + len;
3716 register unsigned char c;
3717 register int hash = 0;
3719 while (p != end)
3721 c = *p++;
3722 if (c >= 0140) c -= 40;
3723 hash = ((hash<<3) + (hash>>28) + c);
3725 return hash & 07777777777;
3728 void
3729 map_obarray (Lisp_Object obarray, void (*fn) (Lisp_Object, Lisp_Object), Lisp_Object arg)
3731 register int i;
3732 register Lisp_Object tail;
3733 CHECK_VECTOR (obarray);
3734 for (i = XVECTOR (obarray)->size - 1; i >= 0; i--)
3736 tail = XVECTOR (obarray)->contents[i];
3737 if (SYMBOLP (tail))
3738 while (1)
3740 (*fn) (tail, arg);
3741 if (XSYMBOL (tail)->next == 0)
3742 break;
3743 XSETSYMBOL (tail, XSYMBOL (tail)->next);
3748 static void
3749 mapatoms_1 (Lisp_Object sym, Lisp_Object function)
3751 call1 (function, sym);
3754 DEFUN ("mapatoms", Fmapatoms, Smapatoms, 1, 2, 0,
3755 doc: /* Call FUNCTION on every symbol in OBARRAY.
3756 OBARRAY defaults to the value of `obarray'. */)
3757 (Lisp_Object function, Lisp_Object obarray)
3759 if (NILP (obarray)) obarray = Vobarray;
3760 obarray = check_obarray (obarray);
3762 map_obarray (obarray, mapatoms_1, function);
3763 return Qnil;
3766 #define OBARRAY_SIZE 1511
3768 void
3769 init_obarray (void)
3771 Lisp_Object oblength;
3773 XSETFASTINT (oblength, OBARRAY_SIZE);
3775 Vobarray = Fmake_vector (oblength, make_number (0));
3776 initial_obarray = Vobarray;
3777 staticpro (&initial_obarray);
3779 Qunbound = Fmake_symbol (make_pure_c_string ("unbound"));
3780 /* Set temporary dummy values to Qnil and Vpurify_flag to satisfy the
3781 NILP (Vpurify_flag) check in intern_c_string. */
3782 Qnil = make_number (-1); Vpurify_flag = make_number (1);
3783 Qnil = intern_c_string ("nil");
3785 /* Fmake_symbol inits fields of new symbols with Qunbound and Qnil,
3786 so those two need to be fixed manally. */
3787 SET_SYMBOL_VAL (XSYMBOL (Qunbound), Qunbound);
3788 XSYMBOL (Qunbound)->function = Qunbound;
3789 XSYMBOL (Qunbound)->plist = Qnil;
3790 /* XSYMBOL (Qnil)->function = Qunbound; */
3791 SET_SYMBOL_VAL (XSYMBOL (Qnil), Qnil);
3792 XSYMBOL (Qnil)->constant = 1;
3793 XSYMBOL (Qnil)->plist = Qnil;
3795 Qt = intern_c_string ("t");
3796 SET_SYMBOL_VAL (XSYMBOL (Qt), Qt);
3797 XSYMBOL (Qt)->constant = 1;
3799 /* Qt is correct even if CANNOT_DUMP. loadup.el will set to nil at end. */
3800 Vpurify_flag = Qt;
3802 Qvariable_documentation = intern_c_string ("variable-documentation");
3803 staticpro (&Qvariable_documentation);
3805 read_buffer_size = 100 + MAX_MULTIBYTE_LENGTH;
3806 read_buffer = (char *) xmalloc (read_buffer_size);
3809 void
3810 defsubr (struct Lisp_Subr *sname)
3812 Lisp_Object sym;
3813 sym = intern_c_string (sname->symbol_name);
3814 XSETPVECTYPE (sname, PVEC_SUBR);
3815 XSETSUBR (XSYMBOL (sym)->function, sname);
3818 #ifdef NOTDEF /* use fset in subr.el now */
3819 void
3820 defalias (sname, string)
3821 struct Lisp_Subr *sname;
3822 char *string;
3824 Lisp_Object sym;
3825 sym = intern (string);
3826 XSETSUBR (XSYMBOL (sym)->function, sname);
3828 #endif /* NOTDEF */
3830 /* Define an "integer variable"; a symbol whose value is forwarded to a
3831 C variable of type int. Sample call (munged w "xx" to fool make-docfile):
3832 DEFxxVAR_INT ("emacs-priority", &emacs_priority, "Documentation"); */
3833 void
3834 defvar_int (struct Lisp_Intfwd *i_fwd,
3835 const char *namestring, EMACS_INT *address)
3837 Lisp_Object sym;
3838 sym = intern_c_string (namestring);
3839 i_fwd->type = Lisp_Fwd_Int;
3840 i_fwd->intvar = address;
3841 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
3842 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)i_fwd);
3845 /* Similar but define a variable whose value is t if address contains 1,
3846 nil if address contains 0. */
3847 void
3848 defvar_bool (struct Lisp_Boolfwd *b_fwd,
3849 const char *namestring, int *address)
3851 Lisp_Object sym;
3852 sym = intern_c_string (namestring);
3853 b_fwd->type = Lisp_Fwd_Bool;
3854 b_fwd->boolvar = address;
3855 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
3856 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)b_fwd);
3857 Vbyte_boolean_vars = Fcons (sym, Vbyte_boolean_vars);
3860 /* Similar but define a variable whose value is the Lisp Object stored
3861 at address. Two versions: with and without gc-marking of the C
3862 variable. The nopro version is used when that variable will be
3863 gc-marked for some other reason, since marking the same slot twice
3864 can cause trouble with strings. */
3865 void
3866 defvar_lisp_nopro (struct Lisp_Objfwd *o_fwd,
3867 const char *namestring, Lisp_Object *address)
3869 Lisp_Object sym;
3870 sym = intern_c_string (namestring);
3871 o_fwd->type = Lisp_Fwd_Obj;
3872 o_fwd->objvar = address;
3873 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
3874 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)o_fwd);
3877 void
3878 defvar_lisp (struct Lisp_Objfwd *o_fwd,
3879 const char *namestring, Lisp_Object *address)
3881 defvar_lisp_nopro (o_fwd, namestring, address);
3882 staticpro (address);
3885 /* Similar but define a variable whose value is the Lisp Object stored
3886 at a particular offset in the current kboard object. */
3888 void
3889 defvar_kboard (struct Lisp_Kboard_Objfwd *ko_fwd,
3890 const char *namestring, int offset)
3892 Lisp_Object sym;
3893 sym = intern_c_string (namestring);
3894 ko_fwd->type = Lisp_Fwd_Kboard_Obj;
3895 ko_fwd->offset = offset;
3896 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
3897 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)ko_fwd);
3900 /* Record the value of load-path used at the start of dumping
3901 so we can see if the site changed it later during dumping. */
3902 static Lisp_Object dump_path;
3904 void
3905 init_lread (void)
3907 const char *normal;
3908 int turn_off_warning = 0;
3910 /* Compute the default load-path. */
3911 #ifdef CANNOT_DUMP
3912 normal = PATH_LOADSEARCH;
3913 Vload_path = decode_env_path (0, normal);
3914 #else
3915 if (NILP (Vpurify_flag))
3916 normal = PATH_LOADSEARCH;
3917 else
3918 normal = PATH_DUMPLOADSEARCH;
3920 /* In a dumped Emacs, we normally have to reset the value of
3921 Vload_path from PATH_LOADSEARCH, since the value that was dumped
3922 uses ../lisp, instead of the path of the installed elisp
3923 libraries. However, if it appears that Vload_path was changed
3924 from the default before dumping, don't override that value. */
3925 if (initialized)
3927 if (! NILP (Fequal (dump_path, Vload_path)))
3929 Vload_path = decode_env_path (0, normal);
3930 if (!NILP (Vinstallation_directory))
3932 Lisp_Object tem, tem1, sitelisp;
3934 /* Remove site-lisp dirs from path temporarily and store
3935 them in sitelisp, then conc them on at the end so
3936 they're always first in path. */
3937 sitelisp = Qnil;
3938 while (1)
3940 tem = Fcar (Vload_path);
3941 tem1 = Fstring_match (build_string ("site-lisp"),
3942 tem, Qnil);
3943 if (!NILP (tem1))
3945 Vload_path = Fcdr (Vload_path);
3946 sitelisp = Fcons (tem, sitelisp);
3948 else
3949 break;
3952 /* Add to the path the lisp subdir of the
3953 installation dir, if it exists. */
3954 tem = Fexpand_file_name (build_string ("lisp"),
3955 Vinstallation_directory);
3956 tem1 = Ffile_exists_p (tem);
3957 if (!NILP (tem1))
3959 if (NILP (Fmember (tem, Vload_path)))
3961 turn_off_warning = 1;
3962 Vload_path = Fcons (tem, Vload_path);
3965 else
3966 /* That dir doesn't exist, so add the build-time
3967 Lisp dirs instead. */
3968 Vload_path = nconc2 (Vload_path, dump_path);
3970 /* Add leim under the installation dir, if it exists. */
3971 tem = Fexpand_file_name (build_string ("leim"),
3972 Vinstallation_directory);
3973 tem1 = Ffile_exists_p (tem);
3974 if (!NILP (tem1))
3976 if (NILP (Fmember (tem, Vload_path)))
3977 Vload_path = Fcons (tem, Vload_path);
3980 /* Add site-lisp under the installation dir, if it exists. */
3981 tem = Fexpand_file_name (build_string ("site-lisp"),
3982 Vinstallation_directory);
3983 tem1 = Ffile_exists_p (tem);
3984 if (!NILP (tem1))
3986 if (NILP (Fmember (tem, Vload_path)))
3987 Vload_path = Fcons (tem, Vload_path);
3990 /* If Emacs was not built in the source directory,
3991 and it is run from where it was built, add to load-path
3992 the lisp, leim and site-lisp dirs under that directory. */
3994 if (NILP (Fequal (Vinstallation_directory, Vsource_directory)))
3996 Lisp_Object tem2;
3998 tem = Fexpand_file_name (build_string ("src/Makefile"),
3999 Vinstallation_directory);
4000 tem1 = Ffile_exists_p (tem);
4002 /* Don't be fooled if they moved the entire source tree
4003 AFTER dumping Emacs. If the build directory is indeed
4004 different from the source dir, src/Makefile.in and
4005 src/Makefile will not be found together. */
4006 tem = Fexpand_file_name (build_string ("src/Makefile.in"),
4007 Vinstallation_directory);
4008 tem2 = Ffile_exists_p (tem);
4009 if (!NILP (tem1) && NILP (tem2))
4011 tem = Fexpand_file_name (build_string ("lisp"),
4012 Vsource_directory);
4014 if (NILP (Fmember (tem, Vload_path)))
4015 Vload_path = Fcons (tem, Vload_path);
4017 tem = Fexpand_file_name (build_string ("leim"),
4018 Vsource_directory);
4020 if (NILP (Fmember (tem, Vload_path)))
4021 Vload_path = Fcons (tem, Vload_path);
4023 tem = Fexpand_file_name (build_string ("site-lisp"),
4024 Vsource_directory);
4026 if (NILP (Fmember (tem, Vload_path)))
4027 Vload_path = Fcons (tem, Vload_path);
4030 if (!NILP (sitelisp) && !no_site_lisp)
4031 Vload_path = nconc2 (Fnreverse (sitelisp), Vload_path);
4035 else
4037 /* NORMAL refers to the lisp dir in the source directory. */
4038 /* We used to add ../lisp at the front here, but
4039 that caused trouble because it was copied from dump_path
4040 into Vload_path, above, when Vinstallation_directory was non-nil.
4041 It should be unnecessary. */
4042 Vload_path = decode_env_path (0, normal);
4043 dump_path = Vload_path;
4045 #endif
4047 #if (!(defined (WINDOWSNT) || (defined (HAVE_NS))))
4048 /* When Emacs is invoked over network shares on NT, PATH_LOADSEARCH is
4049 almost never correct, thereby causing a warning to be printed out that
4050 confuses users. Since PATH_LOADSEARCH is always overridden by the
4051 EMACSLOADPATH environment variable below, disable the warning on NT. */
4053 /* Warn if dirs in the *standard* path don't exist. */
4054 if (!turn_off_warning)
4056 Lisp_Object path_tail;
4058 for (path_tail = Vload_path;
4059 !NILP (path_tail);
4060 path_tail = XCDR (path_tail))
4062 Lisp_Object dirfile;
4063 dirfile = Fcar (path_tail);
4064 if (STRINGP (dirfile))
4066 dirfile = Fdirectory_file_name (dirfile);
4067 if (access (SSDATA (dirfile), 0) < 0)
4068 dir_warning ("Warning: Lisp directory `%s' does not exist.\n",
4069 XCAR (path_tail));
4073 #endif /* !(WINDOWSNT || HAVE_NS) */
4075 /* If the EMACSLOADPATH environment variable is set, use its value.
4076 This doesn't apply if we're dumping. */
4077 #ifndef CANNOT_DUMP
4078 if (NILP (Vpurify_flag)
4079 && egetenv ("EMACSLOADPATH"))
4080 #endif
4081 Vload_path = decode_env_path ("EMACSLOADPATH", normal);
4083 Vvalues = Qnil;
4085 load_in_progress = 0;
4086 Vload_file_name = Qnil;
4088 load_descriptor_list = Qnil;
4090 Vstandard_input = Qt;
4091 Vloads_in_progress = Qnil;
4094 /* Print a warning, using format string FORMAT, that directory DIRNAME
4095 does not exist. Print it on stderr and put it in *Messages*. */
4097 void
4098 dir_warning (const char *format, Lisp_Object dirname)
4100 char *buffer
4101 = (char *) alloca (SCHARS (dirname) + strlen (format) + 5);
4103 fprintf (stderr, format, SDATA (dirname));
4104 sprintf (buffer, format, SDATA (dirname));
4105 /* Don't log the warning before we've initialized!! */
4106 if (initialized)
4107 message_dolog (buffer, strlen (buffer), 0, STRING_MULTIBYTE (dirname));
4110 void
4111 syms_of_lread (void)
4113 defsubr (&Sread);
4114 defsubr (&Sread_from_string);
4115 defsubr (&Sintern);
4116 defsubr (&Sintern_soft);
4117 defsubr (&Sunintern);
4118 defsubr (&Sget_load_suffixes);
4119 defsubr (&Sload);
4120 defsubr (&Seval_buffer);
4121 defsubr (&Seval_region);
4122 defsubr (&Sread_char);
4123 defsubr (&Sread_char_exclusive);
4124 defsubr (&Sread_event);
4125 defsubr (&Sget_file_char);
4126 defsubr (&Smapatoms);
4127 defsubr (&Slocate_file_internal);
4129 DEFVAR_LISP ("obarray", Vobarray,
4130 doc: /* Symbol table for use by `intern' and `read'.
4131 It is a vector whose length ought to be prime for best results.
4132 The vector's contents don't make sense if examined from Lisp programs;
4133 to find all the symbols in an obarray, use `mapatoms'. */);
4135 DEFVAR_LISP ("values", Vvalues,
4136 doc: /* List of values of all expressions which were read, evaluated and printed.
4137 Order is reverse chronological. */);
4139 DEFVAR_LISP ("standard-input", Vstandard_input,
4140 doc: /* Stream for read to get input from.
4141 See documentation of `read' for possible values. */);
4142 Vstandard_input = Qt;
4144 DEFVAR_LISP ("read-with-symbol-positions", Vread_with_symbol_positions,
4145 doc: /* If non-nil, add position of read symbols to `read-symbol-positions-list'.
4147 If this variable is a buffer, then only forms read from that buffer
4148 will be added to `read-symbol-positions-list'.
4149 If this variable is t, then all read forms will be added.
4150 The effect of all other values other than nil are not currently
4151 defined, although they may be in the future.
4153 The positions are relative to the last call to `read' or
4154 `read-from-string'. It is probably a bad idea to set this variable at
4155 the toplevel; bind it instead. */);
4156 Vread_with_symbol_positions = Qnil;
4158 DEFVAR_LISP ("read-symbol-positions-list", Vread_symbol_positions_list,
4159 doc: /* A list mapping read symbols to their positions.
4160 This variable is modified during calls to `read' or
4161 `read-from-string', but only when `read-with-symbol-positions' is
4162 non-nil.
4164 Each element of the list looks like (SYMBOL . CHAR-POSITION), where
4165 CHAR-POSITION is an integer giving the offset of that occurrence of the
4166 symbol from the position where `read' or `read-from-string' started.
4168 Note that a symbol will appear multiple times in this list, if it was
4169 read multiple times. The list is in the same order as the symbols
4170 were read in. */);
4171 Vread_symbol_positions_list = Qnil;
4173 DEFVAR_LISP ("read-circle", Vread_circle,
4174 doc: /* Non-nil means read recursive structures using #N= and #N# syntax. */);
4175 Vread_circle = Qt;
4177 DEFVAR_LISP ("load-path", Vload_path,
4178 doc: /* *List of directories to search for files to load.
4179 Each element is a string (directory name) or nil (try default directory).
4180 Initialized based on EMACSLOADPATH environment variable, if any,
4181 otherwise to default specified by file `epaths.h' when Emacs was built. */);
4183 DEFVAR_LISP ("load-suffixes", Vload_suffixes,
4184 doc: /* List of suffixes for (compiled or source) Emacs Lisp files.
4185 This list should not include the empty string.
4186 `load' and related functions try to append these suffixes, in order,
4187 to the specified file name if a Lisp suffix is allowed or required. */);
4188 Vload_suffixes = Fcons (make_pure_c_string (".elc"),
4189 Fcons (make_pure_c_string (".el"), Qnil));
4190 DEFVAR_LISP ("load-file-rep-suffixes", Vload_file_rep_suffixes,
4191 doc: /* List of suffixes that indicate representations of \
4192 the same file.
4193 This list should normally start with the empty string.
4195 Enabling Auto Compression mode appends the suffixes in
4196 `jka-compr-load-suffixes' to this list and disabling Auto Compression
4197 mode removes them again. `load' and related functions use this list to
4198 determine whether they should look for compressed versions of a file
4199 and, if so, which suffixes they should try to append to the file name
4200 in order to do so. However, if you want to customize which suffixes
4201 the loading functions recognize as compression suffixes, you should
4202 customize `jka-compr-load-suffixes' rather than the present variable. */);
4203 Vload_file_rep_suffixes = Fcons (empty_unibyte_string, Qnil);
4205 DEFVAR_BOOL ("load-in-progress", load_in_progress,
4206 doc: /* Non-nil if inside of `load'. */);
4207 Qload_in_progress = intern_c_string ("load-in-progress");
4208 staticpro (&Qload_in_progress);
4210 DEFVAR_LISP ("after-load-alist", Vafter_load_alist,
4211 doc: /* An alist of expressions to be evalled when particular files are loaded.
4212 Each element looks like (REGEXP-OR-FEATURE FORMS...).
4214 REGEXP-OR-FEATURE is either a regular expression to match file names, or
4215 a symbol \(a feature name).
4217 When `load' is run and the file-name argument matches an element's
4218 REGEXP-OR-FEATURE, or when `provide' is run and provides the symbol
4219 REGEXP-OR-FEATURE, the FORMS in the element are executed.
4221 An error in FORMS does not undo the load, but does prevent execution of
4222 the rest of the FORMS. */);
4223 Vafter_load_alist = Qnil;
4225 DEFVAR_LISP ("load-history", Vload_history,
4226 doc: /* Alist mapping loaded file names to symbols and features.
4227 Each alist element should be a list (FILE-NAME ENTRIES...), where
4228 FILE-NAME is the name of a file that has been loaded into Emacs.
4229 The file name is absolute and true (i.e. it doesn't contain symlinks).
4230 As an exception, one of the alist elements may have FILE-NAME nil,
4231 for symbols and features not associated with any file.
4233 The remaining ENTRIES in the alist element describe the functions and
4234 variables defined in that file, the features provided, and the
4235 features required. Each entry has the form `(provide . FEATURE)',
4236 `(require . FEATURE)', `(defun . FUNCTION)', `(autoload . SYMBOL)',
4237 `(defface . SYMBOL)', or `(t . SYMBOL)'. In addition, an entry `(t
4238 . SYMBOL)' may precede an entry `(defun . FUNCTION)', and means that
4239 SYMBOL was an autoload before this file redefined it as a function.
4241 During preloading, the file name recorded is relative to the main Lisp
4242 directory. These file names are converted to absolute at startup. */);
4243 Vload_history = Qnil;
4245 DEFVAR_LISP ("load-file-name", Vload_file_name,
4246 doc: /* Full name of file being loaded by `load'. */);
4247 Vload_file_name = Qnil;
4249 DEFVAR_LISP ("user-init-file", Vuser_init_file,
4250 doc: /* File name, including directory, of user's initialization file.
4251 If the file loaded had extension `.elc', and the corresponding source file
4252 exists, this variable contains the name of source file, suitable for use
4253 by functions like `custom-save-all' which edit the init file.
4254 While Emacs loads and evaluates the init file, value is the real name
4255 of the file, regardless of whether or not it has the `.elc' extension. */);
4256 Vuser_init_file = Qnil;
4258 DEFVAR_LISP ("current-load-list", Vcurrent_load_list,
4259 doc: /* Used for internal purposes by `load'. */);
4260 Vcurrent_load_list = Qnil;
4262 DEFVAR_LISP ("load-read-function", Vload_read_function,
4263 doc: /* Function used by `load' and `eval-region' for reading expressions.
4264 The default is nil, which means use the function `read'. */);
4265 Vload_read_function = Qnil;
4267 DEFVAR_LISP ("load-source-file-function", Vload_source_file_function,
4268 doc: /* Function called in `load' for loading an Emacs Lisp source file.
4269 This function is for doing code conversion before reading the source file.
4270 If nil, loading is done without any code conversion.
4271 Arguments are FULLNAME, FILE, NOERROR, NOMESSAGE, where
4272 FULLNAME is the full name of FILE.
4273 See `load' for the meaning of the remaining arguments. */);
4274 Vload_source_file_function = Qnil;
4276 DEFVAR_BOOL ("load-force-doc-strings", load_force_doc_strings,
4277 doc: /* Non-nil means `load' should force-load all dynamic doc strings.
4278 This is useful when the file being loaded is a temporary copy. */);
4279 load_force_doc_strings = 0;
4281 DEFVAR_BOOL ("load-convert-to-unibyte", load_convert_to_unibyte,
4282 doc: /* Non-nil means `read' converts strings to unibyte whenever possible.
4283 This is normally bound by `load' and `eval-buffer' to control `read',
4284 and is not meant for users to change. */);
4285 load_convert_to_unibyte = 0;
4287 DEFVAR_LISP ("source-directory", Vsource_directory,
4288 doc: /* Directory in which Emacs sources were found when Emacs was built.
4289 You cannot count on them to still be there! */);
4290 Vsource_directory
4291 = Fexpand_file_name (build_string ("../"),
4292 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH)));
4294 DEFVAR_LISP ("preloaded-file-list", Vpreloaded_file_list,
4295 doc: /* List of files that were preloaded (when dumping Emacs). */);
4296 Vpreloaded_file_list = Qnil;
4298 DEFVAR_LISP ("byte-boolean-vars", Vbyte_boolean_vars,
4299 doc: /* List of all DEFVAR_BOOL variables, used by the byte code optimizer. */);
4300 Vbyte_boolean_vars = Qnil;
4302 DEFVAR_BOOL ("load-dangerous-libraries", load_dangerous_libraries,
4303 doc: /* Non-nil means load dangerous compiled Lisp files.
4304 Some versions of XEmacs use different byte codes than Emacs. These
4305 incompatible byte codes can make Emacs crash when it tries to execute
4306 them. */);
4307 load_dangerous_libraries = 0;
4309 DEFVAR_BOOL ("force-load-messages", force_load_messages,
4310 doc: /* Non-nil means force printing messages when loading Lisp files.
4311 This overrides the value of the NOMESSAGE argument to `load'. */);
4312 force_load_messages = 0;
4314 DEFVAR_LISP ("bytecomp-version-regexp", Vbytecomp_version_regexp,
4315 doc: /* Regular expression matching safe to load compiled Lisp files.
4316 When Emacs loads a compiled Lisp file, it reads the first 512 bytes
4317 from the file, and matches them against this regular expression.
4318 When the regular expression matches, the file is considered to be safe
4319 to load. See also `load-dangerous-libraries'. */);
4320 Vbytecomp_version_regexp
4321 = make_pure_c_string ("^;;;.\\(in Emacs version\\|bytecomp version FSF\\)");
4323 DEFVAR_LISP ("eval-buffer-list", Veval_buffer_list,
4324 doc: /* List of buffers being read from by calls to `eval-buffer' and `eval-region'. */);
4325 Veval_buffer_list = Qnil;
4327 DEFVAR_LISP ("old-style-backquotes", Vold_style_backquotes,
4328 doc: /* Set to non-nil when `read' encounters an old-style backquote. */);
4329 Vold_style_backquotes = Qnil;
4330 Qold_style_backquotes = intern_c_string ("old-style-backquotes");
4331 staticpro (&Qold_style_backquotes);
4333 /* Vsource_directory was initialized in init_lread. */
4335 load_descriptor_list = Qnil;
4336 staticpro (&load_descriptor_list);
4338 Qcurrent_load_list = intern_c_string ("current-load-list");
4339 staticpro (&Qcurrent_load_list);
4341 Qstandard_input = intern_c_string ("standard-input");
4342 staticpro (&Qstandard_input);
4344 Qread_char = intern_c_string ("read-char");
4345 staticpro (&Qread_char);
4347 Qget_file_char = intern_c_string ("get-file-char");
4348 staticpro (&Qget_file_char);
4350 Qget_emacs_mule_file_char = intern_c_string ("get-emacs-mule-file-char");
4351 staticpro (&Qget_emacs_mule_file_char);
4353 Qload_force_doc_strings = intern_c_string ("load-force-doc-strings");
4354 staticpro (&Qload_force_doc_strings);
4356 Qbackquote = intern_c_string ("`");
4357 staticpro (&Qbackquote);
4358 Qcomma = intern_c_string (",");
4359 staticpro (&Qcomma);
4360 Qcomma_at = intern_c_string (",@");
4361 staticpro (&Qcomma_at);
4362 Qcomma_dot = intern_c_string (",.");
4363 staticpro (&Qcomma_dot);
4365 Qinhibit_file_name_operation = intern_c_string ("inhibit-file-name-operation");
4366 staticpro (&Qinhibit_file_name_operation);
4368 Qascii_character = intern_c_string ("ascii-character");
4369 staticpro (&Qascii_character);
4371 Qfunction = intern_c_string ("function");
4372 staticpro (&Qfunction);
4374 Qload = intern_c_string ("load");
4375 staticpro (&Qload);
4377 Qload_file_name = intern_c_string ("load-file-name");
4378 staticpro (&Qload_file_name);
4380 Qeval_buffer_list = intern_c_string ("eval-buffer-list");
4381 staticpro (&Qeval_buffer_list);
4383 Qfile_truename = intern_c_string ("file-truename");
4384 staticpro (&Qfile_truename) ;
4386 Qdir_ok = intern_c_string ("dir-ok");
4387 staticpro (&Qdir_ok);
4389 Qdo_after_load_evaluation = intern_c_string ("do-after-load-evaluation");
4390 staticpro (&Qdo_after_load_evaluation) ;
4392 staticpro (&dump_path);
4394 staticpro (&read_objects);
4395 read_objects = Qnil;
4396 staticpro (&seen_list);
4397 seen_list = Qnil;
4399 Vloads_in_progress = Qnil;
4400 staticpro (&Vloads_in_progress);
4402 Qhash_table = intern_c_string ("hash-table");
4403 staticpro (&Qhash_table);
4404 Qdata = intern_c_string ("data");
4405 staticpro (&Qdata);
4406 Qtest = intern_c_string ("test");
4407 staticpro (&Qtest);
4408 Qsize = intern_c_string ("size");
4409 staticpro (&Qsize);
4410 Qweakness = intern_c_string ("weakness");
4411 staticpro (&Qweakness);
4412 Qrehash_size = intern_c_string ("rehash-size");
4413 staticpro (&Qrehash_size);
4414 Qrehash_threshold = intern_c_string ("rehash-threshold");
4415 staticpro (&Qrehash_threshold);