(rmail-retry-failure): Use rmail-get-header rather than a magical
[emacs.git] / src / lread.c
blobe4ba5229e203b1de396daa2f30cc92a2855acf9a
1 /* Lisp parsing and input streams.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993, 1994, 1995,
3 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
22 #include <config.h>
23 #include <stdio.h>
24 #include <sys/types.h>
25 #include <sys/stat.h>
26 #include <sys/file.h>
27 #include <errno.h>
28 #include <setjmp.h>
29 #include "lisp.h"
30 #include "intervals.h"
31 #include "buffer.h"
32 #include "character.h"
33 #include "charset.h"
34 #include "coding.h"
35 #include <epaths.h>
36 #include "commands.h"
37 #include "keyboard.h"
38 #include "frame.h"
39 #include "termhooks.h"
40 #include "coding.h"
41 #include "blockinput.h"
43 #ifdef MSDOS
44 #if __DJGPP__ < 2
45 #include <unistd.h> /* to get X_OK */
46 #endif
47 #include "msdos.h"
48 #endif
50 #ifdef HAVE_UNISTD_H
51 #include <unistd.h>
52 #endif
54 #ifndef X_OK
55 #define X_OK 01
56 #endif
58 #include <math.h>
60 #ifdef HAVE_SETLOCALE
61 #include <locale.h>
62 #endif /* HAVE_SETLOCALE */
64 #ifdef HAVE_FCNTL_H
65 #include <fcntl.h>
66 #endif
67 #ifndef O_RDONLY
68 #define O_RDONLY 0
69 #endif
71 #ifdef HAVE_FSEEKO
72 #define file_offset off_t
73 #define file_tell ftello
74 #else
75 #define file_offset long
76 #define file_tell ftell
77 #endif
79 #ifndef USE_CRT_DLL
80 extern int errno;
81 #endif
83 Lisp_Object Qread_char, Qget_file_char, Qstandard_input, Qcurrent_load_list;
84 Lisp_Object Qvariable_documentation, Vvalues, Vstandard_input, Vafter_load_alist;
85 Lisp_Object Qascii_character, Qload, Qload_file_name;
86 Lisp_Object Qbackquote, Qcomma, Qcomma_at, Qcomma_dot, Qfunction;
87 Lisp_Object Qinhibit_file_name_operation;
88 Lisp_Object Qeval_buffer_list, Veval_buffer_list;
89 Lisp_Object Qfile_truename, Qdo_after_load_evaluation; /* ACM 2006/5/16 */
91 /* Used instead of Qget_file_char while loading *.elc files compiled
92 by Emacs 21 or older. */
93 static Lisp_Object Qget_emacs_mule_file_char;
95 static Lisp_Object Qload_force_doc_strings;
97 extern Lisp_Object Qevent_symbol_element_mask;
98 extern Lisp_Object Qfile_exists_p;
100 /* non-zero if inside `load' */
101 int load_in_progress;
103 /* Directory in which the sources were found. */
104 Lisp_Object Vsource_directory;
106 /* Search path and suffixes for files to be loaded. */
107 Lisp_Object Vload_path, Vload_suffixes, Vload_file_rep_suffixes;
109 /* File name of user's init file. */
110 Lisp_Object Vuser_init_file;
112 /* This is the user-visible association list that maps features to
113 lists of defs in their load files. */
114 Lisp_Object Vload_history;
116 /* This is used to build the load history. */
117 Lisp_Object Vcurrent_load_list;
119 /* List of files that were preloaded. */
120 Lisp_Object Vpreloaded_file_list;
122 /* Name of file actually being read by `load'. */
123 Lisp_Object Vload_file_name;
125 /* Function to use for reading, in `load' and friends. */
126 Lisp_Object Vload_read_function;
128 /* The association list of objects read with the #n=object form.
129 Each member of the list has the form (n . object), and is used to
130 look up the object for the corresponding #n# construct.
131 It must be set to nil before all top-level calls to read0. */
132 Lisp_Object read_objects;
134 /* Nonzero means load should forcibly load all dynamic doc strings. */
135 static int load_force_doc_strings;
137 /* Nonzero means read should convert strings to unibyte. */
138 static int load_convert_to_unibyte;
140 /* Nonzero means READCHAR should read bytes one by one (not character)
141 when READCHARFUN is Qget_file_char or Qget_emacs_mule_file_char.
142 This is set to 1 by read1 temporarily while handling #@NUMBER. */
143 static int load_each_byte;
145 /* Function to use for loading an Emacs Lisp source file (not
146 compiled) instead of readevalloop. */
147 Lisp_Object Vload_source_file_function;
149 /* List of all DEFVAR_BOOL variables. Used by the byte optimizer. */
150 Lisp_Object Vbyte_boolean_vars;
152 /* Whether or not to add a `read-positions' property to symbols
153 read. */
154 Lisp_Object Vread_with_symbol_positions;
156 /* List of (SYMBOL . POSITION) accumulated so far. */
157 Lisp_Object Vread_symbol_positions_list;
159 /* List of descriptors now open for Fload. */
160 static Lisp_Object load_descriptor_list;
162 /* File for get_file_char to read from. Use by load. */
163 static FILE *instream;
165 /* When nonzero, read conses in pure space */
166 static int read_pure;
168 /* For use within read-from-string (this reader is non-reentrant!!) */
169 static int read_from_string_index;
170 static int read_from_string_index_byte;
171 static int read_from_string_limit;
173 /* Number of characters read in the current call to Fread or
174 Fread_from_string. */
175 static int readchar_count;
177 /* This contains the last string skipped with #@. */
178 static char *saved_doc_string;
179 /* Length of buffer allocated in saved_doc_string. */
180 static int saved_doc_string_size;
181 /* Length of actual data in saved_doc_string. */
182 static int saved_doc_string_length;
183 /* This is the file position that string came from. */
184 static file_offset saved_doc_string_position;
186 /* This contains the previous string skipped with #@.
187 We copy it from saved_doc_string when a new string
188 is put in saved_doc_string. */
189 static char *prev_saved_doc_string;
190 /* Length of buffer allocated in prev_saved_doc_string. */
191 static int prev_saved_doc_string_size;
192 /* Length of actual data in prev_saved_doc_string. */
193 static int prev_saved_doc_string_length;
194 /* This is the file position that string came from. */
195 static file_offset prev_saved_doc_string_position;
197 /* Nonzero means inside a new-style backquote
198 with no surrounding parentheses.
199 Fread initializes this to zero, so we need not specbind it
200 or worry about what happens to it when there is an error. */
201 static int new_backquote_flag;
202 static Lisp_Object Vold_style_backquotes, Qold_style_backquotes;
204 /* A list of file names for files being loaded in Fload. Used to
205 check for recursive loads. */
207 static Lisp_Object Vloads_in_progress;
209 /* Non-zero means load dangerous compiled Lisp files. */
211 int load_dangerous_libraries;
213 /* A regular expression used to detect files compiled with Emacs. */
215 static Lisp_Object Vbytecomp_version_regexp;
217 static int read_emacs_mule_char P_ ((int, int (*) (int, Lisp_Object),
218 Lisp_Object));
220 static void readevalloop P_ ((Lisp_Object, FILE*, Lisp_Object,
221 Lisp_Object (*) (), int,
222 Lisp_Object, Lisp_Object,
223 Lisp_Object, Lisp_Object));
224 static Lisp_Object load_unwind P_ ((Lisp_Object));
225 static Lisp_Object load_descriptor_unwind P_ ((Lisp_Object));
227 static void invalid_syntax P_ ((const char *, int)) NO_RETURN;
228 static void end_of_file_error P_ (()) NO_RETURN;
231 /* Functions that read one byte from the current source READCHARFUN
232 or unreads one byte. If the integer argument C is -1, it returns
233 one read byte, or -1 when there's no more byte in the source. If C
234 is 0 or positive, it unreads C, and the return value is not
235 interesting. */
237 static int readbyte_for_lambda P_ ((int, Lisp_Object));
238 static int readbyte_from_file P_ ((int, Lisp_Object));
239 static int readbyte_from_string P_ ((int, Lisp_Object));
241 /* Handle unreading and rereading of characters.
242 Write READCHAR to read a character,
243 UNREAD(c) to unread c to be read again.
245 These macros correctly read/unread multibyte characters. */
247 #define READCHAR readchar (readcharfun, NULL)
248 #define UNREAD(c) unreadchar (readcharfun, c)
250 /* Same as READCHAR but set *MULTIBYTE to the multibyteness of the source. */
251 #define READCHAR_REPORT_MULTIBYTE(multibyte) readchar (readcharfun, multibyte)
253 /* When READCHARFUN is Qget_file_char, Qget_emacs_mule_file_char,
254 Qlambda, or a cons, we use this to keep an unread character because
255 a file stream can't handle multibyte-char unreading. The value -1
256 means that there's no unread character. */
257 static int unread_char;
259 static int
260 readchar (readcharfun, multibyte)
261 Lisp_Object readcharfun;
262 int *multibyte;
264 Lisp_Object tem;
265 register int c;
266 int (*readbyte) P_ ((int, Lisp_Object));
267 unsigned char buf[MAX_MULTIBYTE_LENGTH];
268 int i, len;
269 int emacs_mule_encoding = 0;
271 if (multibyte)
272 *multibyte = 0;
274 readchar_count++;
276 if (BUFFERP (readcharfun))
278 register struct buffer *inbuffer = XBUFFER (readcharfun);
280 int pt_byte = BUF_PT_BYTE (inbuffer);
282 if (pt_byte >= BUF_ZV_BYTE (inbuffer))
283 return -1;
285 if (! NILP (inbuffer->enable_multibyte_characters))
287 /* Fetch the character code from the buffer. */
288 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, pt_byte);
289 BUF_INC_POS (inbuffer, pt_byte);
290 c = STRING_CHAR (p, pt_byte - orig_pt_byte);
291 if (multibyte)
292 *multibyte = 1;
294 else
296 c = BUF_FETCH_BYTE (inbuffer, pt_byte);
297 if (! ASCII_BYTE_P (c))
298 c = BYTE8_TO_CHAR (c);
299 pt_byte++;
301 SET_BUF_PT_BOTH (inbuffer, BUF_PT (inbuffer) + 1, pt_byte);
303 return c;
305 if (MARKERP (readcharfun))
307 register struct buffer *inbuffer = XMARKER (readcharfun)->buffer;
309 int bytepos = marker_byte_position (readcharfun);
311 if (bytepos >= BUF_ZV_BYTE (inbuffer))
312 return -1;
314 if (! NILP (inbuffer->enable_multibyte_characters))
316 /* Fetch the character code from the buffer. */
317 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, bytepos);
318 BUF_INC_POS (inbuffer, bytepos);
319 c = STRING_CHAR (p, bytepos - orig_bytepos);
320 if (multibyte)
321 *multibyte = 1;
323 else
325 c = BUF_FETCH_BYTE (inbuffer, bytepos);
326 if (! ASCII_BYTE_P (c))
327 c = BYTE8_TO_CHAR (c);
328 bytepos++;
331 XMARKER (readcharfun)->bytepos = bytepos;
332 XMARKER (readcharfun)->charpos++;
334 return c;
337 if (EQ (readcharfun, Qlambda))
339 readbyte = readbyte_for_lambda;
340 goto read_multibyte;
343 if (EQ (readcharfun, Qget_file_char))
345 readbyte = readbyte_from_file;
346 goto read_multibyte;
349 if (STRINGP (readcharfun))
351 if (read_from_string_index >= read_from_string_limit)
352 c = -1;
353 else if (STRING_MULTIBYTE (readcharfun))
355 if (multibyte)
356 *multibyte = 1;
357 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c, readcharfun,
358 read_from_string_index,
359 read_from_string_index_byte);
361 else
363 c = SREF (readcharfun, read_from_string_index_byte);
364 read_from_string_index++;
365 read_from_string_index_byte++;
367 return c;
370 if (CONSP (readcharfun))
372 /* This is the case that read_vector is reading from a unibyte
373 string that contains a byte sequence previously skipped
374 because of #@NUMBER. The car part of readcharfun is that
375 string, and the cdr part is a value of readcharfun given to
376 read_vector. */
377 readbyte = readbyte_from_string;
378 if (EQ (XCDR (readcharfun), Qget_emacs_mule_file_char))
379 emacs_mule_encoding = 1;
380 goto read_multibyte;
383 if (EQ (readcharfun, Qget_emacs_mule_file_char))
385 readbyte = readbyte_from_file;
386 emacs_mule_encoding = 1;
387 goto read_multibyte;
390 tem = call0 (readcharfun);
392 if (NILP (tem))
393 return -1;
394 return XINT (tem);
396 read_multibyte:
397 if (unread_char >= 0)
399 c = unread_char;
400 unread_char = -1;
401 return c;
403 c = (*readbyte) (-1, readcharfun);
404 if (c < 0 || load_each_byte)
405 return c;
406 if (multibyte)
407 *multibyte = 1;
408 if (ASCII_BYTE_P (c))
409 return c;
410 if (emacs_mule_encoding)
411 return read_emacs_mule_char (c, readbyte, readcharfun);
412 i = 0;
413 buf[i++] = c;
414 len = BYTES_BY_CHAR_HEAD (c);
415 while (i < len)
417 c = (*readbyte) (-1, readcharfun);
418 if (c < 0 || ! TRAILING_CODE_P (c))
420 while (--i > 1)
421 (*readbyte) (buf[i], readcharfun);
422 return BYTE8_TO_CHAR (buf[0]);
424 buf[i++] = c;
426 return STRING_CHAR (buf, i);
429 /* Unread the character C in the way appropriate for the stream READCHARFUN.
430 If the stream is a user function, call it with the char as argument. */
432 static void
433 unreadchar (readcharfun, c)
434 Lisp_Object readcharfun;
435 int c;
437 readchar_count--;
438 if (c == -1)
439 /* Don't back up the pointer if we're unreading the end-of-input mark,
440 since readchar didn't advance it when we read it. */
442 else if (BUFFERP (readcharfun))
444 struct buffer *b = XBUFFER (readcharfun);
445 int bytepos = BUF_PT_BYTE (b);
447 BUF_PT (b)--;
448 if (! NILP (b->enable_multibyte_characters))
449 BUF_DEC_POS (b, bytepos);
450 else
451 bytepos--;
453 BUF_PT_BYTE (b) = bytepos;
455 else if (MARKERP (readcharfun))
457 struct buffer *b = XMARKER (readcharfun)->buffer;
458 int bytepos = XMARKER (readcharfun)->bytepos;
460 XMARKER (readcharfun)->charpos--;
461 if (! NILP (b->enable_multibyte_characters))
462 BUF_DEC_POS (b, bytepos);
463 else
464 bytepos--;
466 XMARKER (readcharfun)->bytepos = bytepos;
468 else if (STRINGP (readcharfun))
470 read_from_string_index--;
471 read_from_string_index_byte
472 = string_char_to_byte (readcharfun, read_from_string_index);
474 else if (CONSP (readcharfun))
476 unread_char = c;
478 else if (EQ (readcharfun, Qlambda))
480 unread_char = c;
482 else if (EQ (readcharfun, Qget_file_char)
483 || EQ (readcharfun, Qget_emacs_mule_file_char))
485 if (load_each_byte)
487 BLOCK_INPUT;
488 ungetc (c, instream);
489 UNBLOCK_INPUT;
491 else
492 unread_char = c;
494 else
495 call1 (readcharfun, make_number (c));
498 static int
499 readbyte_for_lambda (c, readcharfun)
500 int c;
501 Lisp_Object readcharfun;
503 return read_bytecode_char (c >= 0);
507 static int
508 readbyte_from_file (c, readcharfun)
509 int c;
510 Lisp_Object readcharfun;
512 if (c >= 0)
514 BLOCK_INPUT;
515 ungetc (c, instream);
516 UNBLOCK_INPUT;
517 return 0;
520 BLOCK_INPUT;
521 c = getc (instream);
523 #ifdef EINTR
524 /* Interrupted reads have been observed while reading over the network */
525 while (c == EOF && ferror (instream) && errno == EINTR)
527 UNBLOCK_INPUT;
528 QUIT;
529 BLOCK_INPUT;
530 clearerr (instream);
531 c = getc (instream);
533 #endif
535 UNBLOCK_INPUT;
537 return (c == EOF ? -1 : c);
540 static int
541 readbyte_from_string (c, readcharfun)
542 int c;
543 Lisp_Object readcharfun;
545 Lisp_Object string = XCAR (readcharfun);
547 if (c >= 0)
549 read_from_string_index--;
550 read_from_string_index_byte
551 = string_char_to_byte (string, read_from_string_index);
554 if (read_from_string_index >= read_from_string_limit)
555 c = -1;
556 else
557 FETCH_STRING_CHAR_ADVANCE (c, string,
558 read_from_string_index,
559 read_from_string_index_byte);
560 return c;
564 /* Read one non-ASCII character from INSTREAM. The character is
565 encoded in `emacs-mule' and the first byte is already read in
566 C. */
568 extern char emacs_mule_bytes[256];
570 static int
571 read_emacs_mule_char (c, readbyte, readcharfun)
572 int c;
573 int (*readbyte) P_ ((int, Lisp_Object));
574 Lisp_Object readcharfun;
576 /* Emacs-mule coding uses at most 4-byte for one character. */
577 unsigned char buf[4];
578 int len = emacs_mule_bytes[c];
579 struct charset *charset;
580 int i;
581 unsigned code;
583 if (len == 1)
584 /* C is not a valid leading-code of `emacs-mule'. */
585 return BYTE8_TO_CHAR (c);
587 i = 0;
588 buf[i++] = c;
589 while (i < len)
591 c = (*readbyte) (-1, readcharfun);
592 if (c < 0xA0)
594 while (--i > 1)
595 (*readbyte) (buf[i], readcharfun);
596 return BYTE8_TO_CHAR (buf[0]);
598 buf[i++] = c;
601 if (len == 2)
603 charset = emacs_mule_charset[buf[0]];
604 code = buf[1] & 0x7F;
606 else if (len == 3)
608 if (buf[0] == EMACS_MULE_LEADING_CODE_PRIVATE_11
609 || buf[0] == EMACS_MULE_LEADING_CODE_PRIVATE_12)
611 charset = emacs_mule_charset[buf[1]];
612 code = buf[2] & 0x7F;
614 else
616 charset = emacs_mule_charset[buf[0]];
617 code = ((buf[1] << 8) | buf[2]) & 0x7F7F;
620 else
622 charset = emacs_mule_charset[buf[1]];
623 code = ((buf[2] << 8) | buf[3]) & 0x7F7F;
625 c = DECODE_CHAR (charset, code);
626 if (c < 0)
627 Fsignal (Qinvalid_read_syntax,
628 Fcons (build_string ("invalid multibyte form"), Qnil));
629 return c;
633 static Lisp_Object read_internal_start P_ ((Lisp_Object, Lisp_Object,
634 Lisp_Object));
635 static Lisp_Object read0 P_ ((Lisp_Object));
636 static Lisp_Object read1 P_ ((Lisp_Object, int *, int));
638 static Lisp_Object read_list P_ ((int, Lisp_Object));
639 static Lisp_Object read_vector P_ ((Lisp_Object, int));
641 static Lisp_Object substitute_object_recurse P_ ((Lisp_Object, Lisp_Object,
642 Lisp_Object));
643 static void substitute_object_in_subtree P_ ((Lisp_Object,
644 Lisp_Object));
645 static void substitute_in_interval P_ ((INTERVAL, Lisp_Object));
648 /* Get a character from the tty. */
650 /* Read input events until we get one that's acceptable for our purposes.
652 If NO_SWITCH_FRAME is non-zero, switch-frame events are stashed
653 until we get a character we like, and then stuffed into
654 unread_switch_frame.
656 If ASCII_REQUIRED is non-zero, we check function key events to see
657 if the unmodified version of the symbol has a Qascii_character
658 property, and use that character, if present.
660 If ERROR_NONASCII is non-zero, we signal an error if the input we
661 get isn't an ASCII character with modifiers. If it's zero but
662 ASCII_REQUIRED is non-zero, we just re-read until we get an ASCII
663 character.
665 If INPUT_METHOD is nonzero, we invoke the current input method
666 if the character warrants that.
668 If SECONDS is a number, we wait that many seconds for input, and
669 return Qnil if no input arrives within that time. */
671 Lisp_Object
672 read_filtered_event (no_switch_frame, ascii_required, error_nonascii,
673 input_method, seconds)
674 int no_switch_frame, ascii_required, error_nonascii, input_method;
675 Lisp_Object seconds;
677 Lisp_Object val, delayed_switch_frame;
678 EMACS_TIME end_time;
680 #ifdef HAVE_WINDOW_SYSTEM
681 if (display_hourglass_p)
682 cancel_hourglass ();
683 #endif
685 delayed_switch_frame = Qnil;
687 /* Compute timeout. */
688 if (NUMBERP (seconds))
690 EMACS_TIME wait_time;
691 int sec, usec;
692 double duration = extract_float (seconds);
694 sec = (int) duration;
695 usec = (duration - sec) * 1000000;
696 EMACS_GET_TIME (end_time);
697 EMACS_SET_SECS_USECS (wait_time, sec, usec);
698 EMACS_ADD_TIME (end_time, end_time, wait_time);
701 /* Read until we get an acceptable event. */
702 retry:
704 val = read_char (0, 0, 0, (input_method ? Qnil : Qt), 0,
705 NUMBERP (seconds) ? &end_time : NULL);
706 while (INTEGERP (val) && XINT (val) == -2); /* wrong_kboard_jmpbuf */
708 if (BUFFERP (val))
709 goto retry;
711 /* switch-frame events are put off until after the next ASCII
712 character. This is better than signaling an error just because
713 the last characters were typed to a separate minibuffer frame,
714 for example. Eventually, some code which can deal with
715 switch-frame events will read it and process it. */
716 if (no_switch_frame
717 && EVENT_HAS_PARAMETERS (val)
718 && EQ (EVENT_HEAD_KIND (EVENT_HEAD (val)), Qswitch_frame))
720 delayed_switch_frame = val;
721 goto retry;
724 if (ascii_required && !(NUMBERP (seconds) && NILP (val)))
726 /* Convert certain symbols to their ASCII equivalents. */
727 if (SYMBOLP (val))
729 Lisp_Object tem, tem1;
730 tem = Fget (val, Qevent_symbol_element_mask);
731 if (!NILP (tem))
733 tem1 = Fget (Fcar (tem), Qascii_character);
734 /* Merge this symbol's modifier bits
735 with the ASCII equivalent of its basic code. */
736 if (!NILP (tem1))
737 XSETFASTINT (val, XINT (tem1) | XINT (Fcar (Fcdr (tem))));
741 /* If we don't have a character now, deal with it appropriately. */
742 if (!INTEGERP (val))
744 if (error_nonascii)
746 Vunread_command_events = Fcons (val, Qnil);
747 error ("Non-character input-event");
749 else
750 goto retry;
754 if (! NILP (delayed_switch_frame))
755 unread_switch_frame = delayed_switch_frame;
757 #if 0
759 #ifdef HAVE_WINDOW_SYSTEM
760 if (display_hourglass_p)
761 start_hourglass ();
762 #endif
764 #endif
766 return val;
769 DEFUN ("read-char", Fread_char, Sread_char, 0, 3, 0,
770 doc: /* Read a character from the command input (keyboard or macro).
771 It is returned as a number.
772 If the character has modifiers, they are resolved and reflected to the
773 character code if possible (e.g. C-SPC -> 0).
775 If the user generates an event which is not a character (i.e. a mouse
776 click or function key event), `read-char' signals an error. As an
777 exception, switch-frame events are put off until non-character events
778 can be read.
779 If you want to read non-character events, or ignore them, call
780 `read-event' or `read-char-exclusive' instead.
782 If the optional argument PROMPT is non-nil, display that as a prompt.
783 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
784 input method is turned on in the current buffer, that input method
785 is used for reading a character.
786 If the optional argument SECONDS is non-nil, it should be a number
787 specifying the maximum number of seconds to wait for input. If no
788 input arrives in that time, return nil. SECONDS may be a
789 floating-point value. */)
790 (prompt, inherit_input_method, seconds)
791 Lisp_Object prompt, inherit_input_method, seconds;
793 Lisp_Object val;
795 if (! NILP (prompt))
796 message_with_string ("%s", prompt, 0);
797 val = read_filtered_event (1, 1, 1, ! NILP (inherit_input_method), seconds);
799 return (NILP (val) ? Qnil
800 : make_number (char_resolve_modifier_mask (XINT (val))));
803 DEFUN ("read-event", Fread_event, Sread_event, 0, 3, 0,
804 doc: /* Read an event object from the input stream.
805 If the optional argument PROMPT is non-nil, display that as a prompt.
806 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
807 input method is turned on in the current buffer, that input method
808 is used for reading a character.
809 If the optional argument SECONDS is non-nil, it should be a number
810 specifying the maximum number of seconds to wait for input. If no
811 input arrives in that time, return nil. SECONDS may be a
812 floating-point value. */)
813 (prompt, inherit_input_method, seconds)
814 Lisp_Object prompt, inherit_input_method, seconds;
816 if (! NILP (prompt))
817 message_with_string ("%s", prompt, 0);
818 return read_filtered_event (0, 0, 0, ! NILP (inherit_input_method), seconds);
821 DEFUN ("read-char-exclusive", Fread_char_exclusive, Sread_char_exclusive, 0, 3, 0,
822 doc: /* Read a character from the command input (keyboard or macro).
823 It is returned as a number. Non-character events are ignored.
824 If the character has modifiers, they are resolved and reflected to the
825 character code if possible (e.g. C-SPC -> 0).
827 If the optional argument PROMPT is non-nil, display that as a prompt.
828 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
829 input method is turned on in the current buffer, that input method
830 is used for reading a character.
831 If the optional argument SECONDS is non-nil, it should be a number
832 specifying the maximum number of seconds to wait for input. If no
833 input arrives in that time, return nil. SECONDS may be a
834 floating-point value. */)
835 (prompt, inherit_input_method, seconds)
836 Lisp_Object prompt, inherit_input_method, seconds;
838 Lisp_Object val;
840 if (! NILP (prompt))
841 message_with_string ("%s", prompt, 0);
843 val = read_filtered_event (1, 1, 0, ! NILP (inherit_input_method), seconds);
845 return (NILP (val) ? Qnil
846 : make_number (char_resolve_modifier_mask (XINT (val))));
849 DEFUN ("get-file-char", Fget_file_char, Sget_file_char, 0, 0, 0,
850 doc: /* Don't use this yourself. */)
853 register Lisp_Object val;
854 BLOCK_INPUT;
855 XSETINT (val, getc (instream));
856 UNBLOCK_INPUT;
857 return val;
862 /* Value is a version number of byte compiled code if the file
863 associated with file descriptor FD is a compiled Lisp file that's
864 safe to load. Only files compiled with Emacs are safe to load.
865 Files compiled with XEmacs can lead to a crash in Fbyte_code
866 because of an incompatible change in the byte compiler. */
868 static int
869 safe_to_load_p (fd)
870 int fd;
872 char buf[512];
873 int nbytes, i;
874 int safe_p = 1;
875 int version = 1;
877 /* Read the first few bytes from the file, and look for a line
878 specifying the byte compiler version used. */
879 nbytes = emacs_read (fd, buf, sizeof buf - 1);
880 if (nbytes > 0)
882 buf[nbytes] = '\0';
884 /* Skip to the next newline, skipping over the initial `ELC'
885 with NUL bytes following it, but note the version. */
886 for (i = 0; i < nbytes && buf[i] != '\n'; ++i)
887 if (i == 4)
888 version = buf[i];
890 if (i == nbytes
891 || fast_c_string_match_ignore_case (Vbytecomp_version_regexp,
892 buf + i) < 0)
893 safe_p = 0;
895 if (safe_p)
896 safe_p = version;
898 lseek (fd, 0, SEEK_SET);
899 return safe_p;
903 /* Callback for record_unwind_protect. Restore the old load list OLD,
904 after loading a file successfully. */
906 static Lisp_Object
907 record_load_unwind (old)
908 Lisp_Object old;
910 return Vloads_in_progress = old;
913 /* This handler function is used via internal_condition_case_1. */
915 static Lisp_Object
916 load_error_handler (data)
917 Lisp_Object data;
919 return Qnil;
922 static Lisp_Object
923 load_warn_old_style_backquotes (file)
924 Lisp_Object file;
926 if (!NILP (Vold_style_backquotes))
928 Lisp_Object args[2];
929 args[0] = build_string ("Loading `%s': old-style backquotes detected!");
930 args[1] = file;
931 Fmessage (2, args);
933 return Qnil;
936 DEFUN ("get-load-suffixes", Fget_load_suffixes, Sget_load_suffixes, 0, 0, 0,
937 doc: /* Return the suffixes that `load' should try if a suffix is \
938 required.
939 This uses the variables `load-suffixes' and `load-file-rep-suffixes'. */)
942 Lisp_Object lst = Qnil, suffixes = Vload_suffixes, suffix, ext;
943 while (CONSP (suffixes))
945 Lisp_Object exts = Vload_file_rep_suffixes;
946 suffix = XCAR (suffixes);
947 suffixes = XCDR (suffixes);
948 while (CONSP (exts))
950 ext = XCAR (exts);
951 exts = XCDR (exts);
952 lst = Fcons (concat2 (suffix, ext), lst);
955 return Fnreverse (lst);
958 DEFUN ("load", Fload, Sload, 1, 5, 0,
959 doc: /* Execute a file of Lisp code named FILE.
960 First try FILE with `.elc' appended, then try with `.el',
961 then try FILE unmodified (the exact suffixes in the exact order are
962 determined by `load-suffixes'). Environment variable references in
963 FILE are replaced with their values by calling `substitute-in-file-name'.
964 This function searches the directories in `load-path'.
966 If optional second arg NOERROR is non-nil,
967 report no error if FILE doesn't exist.
968 Print messages at start and end of loading unless
969 optional third arg NOMESSAGE is non-nil.
970 If optional fourth arg NOSUFFIX is non-nil, don't try adding
971 suffixes `.elc' or `.el' to the specified name FILE.
972 If optional fifth arg MUST-SUFFIX is non-nil, insist on
973 the suffix `.elc' or `.el'; don't accept just FILE unless
974 it ends in one of those suffixes or includes a directory name.
976 If this function fails to find a file, it may look for different
977 representations of that file before trying another file.
978 It does so by adding the non-empty suffixes in `load-file-rep-suffixes'
979 to the file name. Emacs uses this feature mainly to find compressed
980 versions of files when Auto Compression mode is enabled.
982 The exact suffixes that this function tries out, in the exact order,
983 are given by the value of the variable `load-file-rep-suffixes' if
984 NOSUFFIX is non-nil and by the return value of the function
985 `get-load-suffixes' if MUST-SUFFIX is non-nil. If both NOSUFFIX and
986 MUST-SUFFIX are nil, this function first tries out the latter suffixes
987 and then the former.
989 Loading a file records its definitions, and its `provide' and
990 `require' calls, in an element of `load-history' whose
991 car is the file name loaded. See `load-history'.
993 Return t if the file exists and loads successfully. */)
994 (file, noerror, nomessage, nosuffix, must_suffix)
995 Lisp_Object file, noerror, nomessage, nosuffix, must_suffix;
997 register FILE *stream;
998 register int fd = -1;
999 int count = SPECPDL_INDEX ();
1000 struct gcpro gcpro1, gcpro2, gcpro3;
1001 Lisp_Object found, efound, hist_file_name;
1002 /* 1 means we printed the ".el is newer" message. */
1003 int newer = 0;
1004 /* 1 means we are loading a compiled file. */
1005 int compiled = 0;
1006 Lisp_Object handler;
1007 int safe_p = 1;
1008 char *fmode = "r";
1009 Lisp_Object tmp[2];
1010 int version;
1012 #ifdef DOS_NT
1013 fmode = "rt";
1014 #endif /* DOS_NT */
1016 CHECK_STRING (file);
1018 /* If file name is magic, call the handler. */
1019 /* This shouldn't be necessary any more now that `openp' handles it right.
1020 handler = Ffind_file_name_handler (file, Qload);
1021 if (!NILP (handler))
1022 return call5 (handler, Qload, file, noerror, nomessage, nosuffix); */
1024 /* Do this after the handler to avoid
1025 the need to gcpro noerror, nomessage and nosuffix.
1026 (Below here, we care only whether they are nil or not.)
1027 The presence of this call is the result of a historical accident:
1028 it used to be in every file-operation and when it got removed
1029 everywhere, it accidentally stayed here. Since then, enough people
1030 supposedly have things like (load "$PROJECT/foo.el") in their .emacs
1031 that it seemed risky to remove. */
1032 if (! NILP (noerror))
1034 file = internal_condition_case_1 (Fsubstitute_in_file_name, file,
1035 Qt, load_error_handler);
1036 if (NILP (file))
1037 return Qnil;
1039 else
1040 file = Fsubstitute_in_file_name (file);
1043 /* Avoid weird lossage with null string as arg,
1044 since it would try to load a directory as a Lisp file */
1045 if (SCHARS (file) > 0)
1047 int size = SBYTES (file);
1049 found = Qnil;
1050 GCPRO2 (file, found);
1052 if (! NILP (must_suffix))
1054 /* Don't insist on adding a suffix if FILE already ends with one. */
1055 if (size > 3
1056 && !strcmp (SDATA (file) + size - 3, ".el"))
1057 must_suffix = Qnil;
1058 else if (size > 4
1059 && !strcmp (SDATA (file) + size - 4, ".elc"))
1060 must_suffix = Qnil;
1061 /* Don't insist on adding a suffix
1062 if the argument includes a directory name. */
1063 else if (! NILP (Ffile_name_directory (file)))
1064 must_suffix = Qnil;
1067 fd = openp (Vload_path, file,
1068 (!NILP (nosuffix) ? Qnil
1069 : !NILP (must_suffix) ? Fget_load_suffixes ()
1070 : Fappend (2, (tmp[0] = Fget_load_suffixes (),
1071 tmp[1] = Vload_file_rep_suffixes,
1072 tmp))),
1073 &found, Qnil);
1074 UNGCPRO;
1077 if (fd == -1)
1079 if (NILP (noerror))
1080 xsignal2 (Qfile_error, build_string ("Cannot open load file"), file);
1081 return Qnil;
1084 /* Tell startup.el whether or not we found the user's init file. */
1085 if (EQ (Qt, Vuser_init_file))
1086 Vuser_init_file = found;
1088 /* If FD is -2, that means openp found a magic file. */
1089 if (fd == -2)
1091 if (NILP (Fequal (found, file)))
1092 /* If FOUND is a different file name from FILE,
1093 find its handler even if we have already inhibited
1094 the `load' operation on FILE. */
1095 handler = Ffind_file_name_handler (found, Qt);
1096 else
1097 handler = Ffind_file_name_handler (found, Qload);
1098 if (! NILP (handler))
1099 return call5 (handler, Qload, found, noerror, nomessage, Qt);
1102 /* Check if we're stuck in a recursive load cycle.
1104 2000-09-21: It's not possible to just check for the file loaded
1105 being a member of Vloads_in_progress. This fails because of the
1106 way the byte compiler currently works; `provide's are not
1107 evaluated, see font-lock.el/jit-lock.el as an example. This
1108 leads to a certain amount of ``normal'' recursion.
1110 Also, just loading a file recursively is not always an error in
1111 the general case; the second load may do something different. */
1113 int count = 0;
1114 Lisp_Object tem;
1115 for (tem = Vloads_in_progress; CONSP (tem); tem = XCDR (tem))
1116 if (!NILP (Fequal (found, XCAR (tem))) && (++count > 3))
1118 if (fd >= 0)
1119 emacs_close (fd);
1120 signal_error ("Recursive load", Fcons (found, Vloads_in_progress));
1122 record_unwind_protect (record_load_unwind, Vloads_in_progress);
1123 Vloads_in_progress = Fcons (found, Vloads_in_progress);
1126 /* Get the name for load-history. */
1127 hist_file_name = (! NILP (Vpurify_flag)
1128 ? Fconcat (2, (tmp[0] = Ffile_name_directory (file),
1129 tmp[1] = Ffile_name_nondirectory (found),
1130 tmp))
1131 : found) ;
1133 version = -1;
1135 /* Check for the presence of old-style quotes and warn about them. */
1136 specbind (Qold_style_backquotes, Qnil);
1137 record_unwind_protect (load_warn_old_style_backquotes, file);
1139 if (!bcmp (SDATA (found) + SBYTES (found) - 4,
1140 ".elc", 4)
1141 || (version = safe_to_load_p (fd)) > 0)
1142 /* Load .elc files directly, but not when they are
1143 remote and have no handler! */
1145 if (fd != -2)
1147 struct stat s1, s2;
1148 int result;
1150 GCPRO3 (file, found, hist_file_name);
1152 if (version < 0
1153 && ! (version = safe_to_load_p (fd)))
1155 safe_p = 0;
1156 if (!load_dangerous_libraries)
1158 if (fd >= 0)
1159 emacs_close (fd);
1160 error ("File `%s' was not compiled in Emacs",
1161 SDATA (found));
1163 else if (!NILP (nomessage))
1164 message_with_string ("File `%s' not compiled in Emacs", found, 1);
1167 compiled = 1;
1169 efound = ENCODE_FILE (found);
1171 #ifdef DOS_NT
1172 fmode = "rb";
1173 #endif /* DOS_NT */
1174 stat ((char *)SDATA (efound), &s1);
1175 SSET (efound, SBYTES (efound) - 1, 0);
1176 result = stat ((char *)SDATA (efound), &s2);
1177 SSET (efound, SBYTES (efound) - 1, 'c');
1179 if (result >= 0 && (unsigned) s1.st_mtime < (unsigned) s2.st_mtime)
1181 /* Make the progress messages mention that source is newer. */
1182 newer = 1;
1184 /* If we won't print another message, mention this anyway. */
1185 if (!NILP (nomessage))
1187 Lisp_Object msg_file;
1188 msg_file = Fsubstring (found, make_number (0), make_number (-1));
1189 message_with_string ("Source file `%s' newer than byte-compiled file",
1190 msg_file, 1);
1193 UNGCPRO;
1196 else
1198 /* We are loading a source file (*.el). */
1199 if (!NILP (Vload_source_file_function))
1201 Lisp_Object val;
1203 if (fd >= 0)
1204 emacs_close (fd);
1205 val = call4 (Vload_source_file_function, found, hist_file_name,
1206 NILP (noerror) ? Qnil : Qt,
1207 NILP (nomessage) ? Qnil : Qt);
1208 return unbind_to (count, val);
1212 GCPRO3 (file, found, hist_file_name);
1214 #ifdef WINDOWSNT
1215 emacs_close (fd);
1216 efound = ENCODE_FILE (found);
1217 stream = fopen ((char *) SDATA (efound), fmode);
1218 #else /* not WINDOWSNT */
1219 stream = fdopen (fd, fmode);
1220 #endif /* not WINDOWSNT */
1221 if (stream == 0)
1223 emacs_close (fd);
1224 error ("Failure to create stdio stream for %s", SDATA (file));
1227 if (! NILP (Vpurify_flag))
1228 Vpreloaded_file_list = Fcons (file, Vpreloaded_file_list);
1230 if (NILP (nomessage))
1232 if (!safe_p)
1233 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...",
1234 file, 1);
1235 else if (!compiled)
1236 message_with_string ("Loading %s (source)...", file, 1);
1237 else if (newer)
1238 message_with_string ("Loading %s (compiled; note, source file is newer)...",
1239 file, 1);
1240 else /* The typical case; compiled file newer than source file. */
1241 message_with_string ("Loading %s...", file, 1);
1244 record_unwind_protect (load_unwind, make_save_value (stream, 0));
1245 record_unwind_protect (load_descriptor_unwind, load_descriptor_list);
1246 specbind (Qload_file_name, found);
1247 specbind (Qinhibit_file_name_operation, Qnil);
1248 load_descriptor_list
1249 = Fcons (make_number (fileno (stream)), load_descriptor_list);
1250 load_in_progress++;
1251 if (! version || version >= 22)
1252 readevalloop (Qget_file_char, stream, hist_file_name,
1253 Feval, 0, Qnil, Qnil, Qnil, Qnil);
1254 else
1256 /* We can't handle a file which was compiled with
1257 byte-compile-dynamic by older version of Emacs. */
1258 specbind (Qload_force_doc_strings, Qt);
1259 readevalloop (Qget_emacs_mule_file_char, stream, hist_file_name, Feval,
1260 0, Qnil, Qnil, Qnil, Qnil);
1262 unbind_to (count, Qnil);
1264 /* Run any eval-after-load forms for this file */
1265 if (NILP (Vpurify_flag)
1266 && (!NILP (Ffboundp (Qdo_after_load_evaluation))))
1267 call1 (Qdo_after_load_evaluation, hist_file_name) ;
1269 UNGCPRO;
1271 xfree (saved_doc_string);
1272 saved_doc_string = 0;
1273 saved_doc_string_size = 0;
1275 xfree (prev_saved_doc_string);
1276 prev_saved_doc_string = 0;
1277 prev_saved_doc_string_size = 0;
1279 if (!noninteractive && NILP (nomessage))
1281 if (!safe_p)
1282 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...done",
1283 file, 1);
1284 else if (!compiled)
1285 message_with_string ("Loading %s (source)...done", file, 1);
1286 else if (newer)
1287 message_with_string ("Loading %s (compiled; note, source file is newer)...done",
1288 file, 1);
1289 else /* The typical case; compiled file newer than source file. */
1290 message_with_string ("Loading %s...done", file, 1);
1293 if (!NILP (Fequal (build_string ("obsolete"),
1294 Ffile_name_nondirectory
1295 (Fdirectory_file_name (Ffile_name_directory (found))))))
1296 message_with_string ("Package %s is obsolete", file, 1);
1298 return Qt;
1301 static Lisp_Object
1302 load_unwind (arg) /* used as unwind-protect function in load */
1303 Lisp_Object arg;
1305 FILE *stream = (FILE *) XSAVE_VALUE (arg)->pointer;
1306 if (stream != NULL)
1308 BLOCK_INPUT;
1309 fclose (stream);
1310 UNBLOCK_INPUT;
1312 if (--load_in_progress < 0) load_in_progress = 0;
1313 return Qnil;
1316 static Lisp_Object
1317 load_descriptor_unwind (oldlist)
1318 Lisp_Object oldlist;
1320 load_descriptor_list = oldlist;
1321 return Qnil;
1324 /* Close all descriptors in use for Floads.
1325 This is used when starting a subprocess. */
1327 void
1328 close_load_descs ()
1330 #ifndef WINDOWSNT
1331 Lisp_Object tail;
1332 for (tail = load_descriptor_list; CONSP (tail); tail = XCDR (tail))
1333 emacs_close (XFASTINT (XCAR (tail)));
1334 #endif
1337 static int
1338 complete_filename_p (pathname)
1339 Lisp_Object pathname;
1341 register const unsigned char *s = SDATA (pathname);
1342 return (IS_DIRECTORY_SEP (s[0])
1343 || (SCHARS (pathname) > 2
1344 && IS_DEVICE_SEP (s[1]) && IS_DIRECTORY_SEP (s[2])));
1347 DEFUN ("locate-file-internal", Flocate_file_internal, Slocate_file_internal, 2, 4, 0,
1348 doc: /* Search for FILENAME through PATH.
1349 Returns the file's name in absolute form, or nil if not found.
1350 If SUFFIXES is non-nil, it should be a list of suffixes to append to
1351 file name when searching.
1352 If non-nil, PREDICATE is used instead of `file-readable-p'.
1353 PREDICATE can also be an integer to pass to the access(2) function,
1354 in which case file-name-handlers are ignored. */)
1355 (filename, path, suffixes, predicate)
1356 Lisp_Object filename, path, suffixes, predicate;
1358 Lisp_Object file;
1359 int fd = openp (path, filename, suffixes, &file, predicate);
1360 if (NILP (predicate) && fd > 0)
1361 close (fd);
1362 return file;
1366 /* Search for a file whose name is STR, looking in directories
1367 in the Lisp list PATH, and trying suffixes from SUFFIX.
1368 On success, returns a file descriptor. On failure, returns -1.
1370 SUFFIXES is a list of strings containing possible suffixes.
1371 The empty suffix is automatically added if the list is empty.
1373 PREDICATE non-nil means don't open the files,
1374 just look for one that satisfies the predicate. In this case,
1375 returns 1 on success. The predicate can be a lisp function or
1376 an integer to pass to `access' (in which case file-name-handlers
1377 are ignored).
1379 If STOREPTR is nonzero, it points to a slot where the name of
1380 the file actually found should be stored as a Lisp string.
1381 nil is stored there on failure.
1383 If the file we find is remote, return -2
1384 but store the found remote file name in *STOREPTR. */
1387 openp (path, str, suffixes, storeptr, predicate)
1388 Lisp_Object path, str;
1389 Lisp_Object suffixes;
1390 Lisp_Object *storeptr;
1391 Lisp_Object predicate;
1393 register int fd;
1394 int fn_size = 100;
1395 char buf[100];
1396 register char *fn = buf;
1397 int absolute = 0;
1398 int want_size;
1399 Lisp_Object filename;
1400 struct stat st;
1401 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
1402 Lisp_Object string, tail, encoded_fn;
1403 int max_suffix_len = 0;
1405 CHECK_STRING (str);
1407 for (tail = suffixes; CONSP (tail); tail = XCDR (tail))
1409 CHECK_STRING_CAR (tail);
1410 max_suffix_len = max (max_suffix_len,
1411 SBYTES (XCAR (tail)));
1414 string = filename = encoded_fn = Qnil;
1415 GCPRO6 (str, string, filename, path, suffixes, encoded_fn);
1417 if (storeptr)
1418 *storeptr = Qnil;
1420 if (complete_filename_p (str))
1421 absolute = 1;
1423 for (; CONSP (path); path = XCDR (path))
1425 filename = Fexpand_file_name (str, XCAR (path));
1426 if (!complete_filename_p (filename))
1427 /* If there are non-absolute elts in PATH (eg ".") */
1428 /* Of course, this could conceivably lose if luser sets
1429 default-directory to be something non-absolute... */
1431 filename = Fexpand_file_name (filename, current_buffer->directory);
1432 if (!complete_filename_p (filename))
1433 /* Give up on this path element! */
1434 continue;
1437 /* Calculate maximum size of any filename made from
1438 this path element/specified file name and any possible suffix. */
1439 want_size = max_suffix_len + SBYTES (filename) + 1;
1440 if (fn_size < want_size)
1441 fn = (char *) alloca (fn_size = 100 + want_size);
1443 /* Loop over suffixes. */
1444 for (tail = NILP (suffixes) ? Fcons (empty_unibyte_string, Qnil) : suffixes;
1445 CONSP (tail); tail = XCDR (tail))
1447 int lsuffix = SBYTES (XCAR (tail));
1448 Lisp_Object handler;
1449 int exists;
1451 /* Concatenate path element/specified name with the suffix.
1452 If the directory starts with /:, remove that. */
1453 if (SCHARS (filename) > 2
1454 && SREF (filename, 0) == '/'
1455 && SREF (filename, 1) == ':')
1457 strncpy (fn, SDATA (filename) + 2,
1458 SBYTES (filename) - 2);
1459 fn[SBYTES (filename) - 2] = 0;
1461 else
1463 strncpy (fn, SDATA (filename),
1464 SBYTES (filename));
1465 fn[SBYTES (filename)] = 0;
1468 if (lsuffix != 0) /* Bug happens on CCI if lsuffix is 0. */
1469 strncat (fn, SDATA (XCAR (tail)), lsuffix);
1471 /* Check that the file exists and is not a directory. */
1472 /* We used to only check for handlers on non-absolute file names:
1473 if (absolute)
1474 handler = Qnil;
1475 else
1476 handler = Ffind_file_name_handler (filename, Qfile_exists_p);
1477 It's not clear why that was the case and it breaks things like
1478 (load "/bar.el") where the file is actually "/bar.el.gz". */
1479 string = build_string (fn);
1480 handler = Ffind_file_name_handler (string, Qfile_exists_p);
1481 if ((!NILP (handler) || !NILP (predicate)) && !NATNUMP (predicate))
1483 if (NILP (predicate))
1484 exists = !NILP (Ffile_readable_p (string));
1485 else
1486 exists = !NILP (call1 (predicate, string));
1487 if (exists && !NILP (Ffile_directory_p (string)))
1488 exists = 0;
1490 if (exists)
1492 /* We succeeded; return this descriptor and filename. */
1493 if (storeptr)
1494 *storeptr = string;
1495 UNGCPRO;
1496 return -2;
1499 else
1501 const char *pfn;
1503 encoded_fn = ENCODE_FILE (string);
1504 pfn = SDATA (encoded_fn);
1505 exists = (stat (pfn, &st) >= 0
1506 && (st.st_mode & S_IFMT) != S_IFDIR);
1507 if (exists)
1509 /* Check that we can access or open it. */
1510 if (NATNUMP (predicate))
1511 fd = (access (pfn, XFASTINT (predicate)) == 0) ? 1 : -1;
1512 else
1513 fd = emacs_open (pfn, O_RDONLY, 0);
1515 if (fd >= 0)
1517 /* We succeeded; return this descriptor and filename. */
1518 if (storeptr)
1519 *storeptr = string;
1520 UNGCPRO;
1521 return fd;
1526 if (absolute)
1527 break;
1530 UNGCPRO;
1531 return -1;
1535 /* Merge the list we've accumulated of globals from the current input source
1536 into the load_history variable. The details depend on whether
1537 the source has an associated file name or not.
1539 FILENAME is the file name that we are loading from.
1540 ENTIRE is 1 if loading that entire file, 0 if evaluating part of it. */
1542 static void
1543 build_load_history (filename, entire)
1544 Lisp_Object filename;
1545 int entire;
1547 register Lisp_Object tail, prev, newelt;
1548 register Lisp_Object tem, tem2;
1549 register int foundit = 0;
1551 tail = Vload_history;
1552 prev = Qnil;
1554 while (CONSP (tail))
1556 tem = XCAR (tail);
1558 /* Find the feature's previous assoc list... */
1559 if (!NILP (Fequal (filename, Fcar (tem))))
1561 foundit = 1;
1563 /* If we're loading the entire file, remove old data. */
1564 if (entire)
1566 if (NILP (prev))
1567 Vload_history = XCDR (tail);
1568 else
1569 Fsetcdr (prev, XCDR (tail));
1572 /* Otherwise, cons on new symbols that are not already members. */
1573 else
1575 tem2 = Vcurrent_load_list;
1577 while (CONSP (tem2))
1579 newelt = XCAR (tem2);
1581 if (NILP (Fmember (newelt, tem)))
1582 Fsetcar (tail, Fcons (XCAR (tem),
1583 Fcons (newelt, XCDR (tem))));
1585 tem2 = XCDR (tem2);
1586 QUIT;
1590 else
1591 prev = tail;
1592 tail = XCDR (tail);
1593 QUIT;
1596 /* If we're loading an entire file, cons the new assoc onto the
1597 front of load-history, the most-recently-loaded position. Also
1598 do this if we didn't find an existing member for the file. */
1599 if (entire || !foundit)
1600 Vload_history = Fcons (Fnreverse (Vcurrent_load_list),
1601 Vload_history);
1604 Lisp_Object
1605 unreadpure (junk) /* Used as unwind-protect function in readevalloop */
1606 Lisp_Object junk;
1608 read_pure = 0;
1609 return Qnil;
1612 static Lisp_Object
1613 readevalloop_1 (old)
1614 Lisp_Object old;
1616 load_convert_to_unibyte = ! NILP (old);
1617 return Qnil;
1620 /* Signal an `end-of-file' error, if possible with file name
1621 information. */
1623 static void
1624 end_of_file_error ()
1626 if (STRINGP (Vload_file_name))
1627 xsignal1 (Qend_of_file, Vload_file_name);
1629 xsignal0 (Qend_of_file);
1632 /* UNIBYTE specifies how to set load_convert_to_unibyte
1633 for this invocation.
1634 READFUN, if non-nil, is used instead of `read'.
1636 START, END specify region to read in current buffer (from eval-region).
1637 If the input is not from a buffer, they must be nil. */
1639 static void
1640 readevalloop (readcharfun, stream, sourcename, evalfun,
1641 printflag, unibyte, readfun, start, end)
1642 Lisp_Object readcharfun;
1643 FILE *stream;
1644 Lisp_Object sourcename;
1645 Lisp_Object (*evalfun) ();
1646 int printflag;
1647 Lisp_Object unibyte, readfun;
1648 Lisp_Object start, end;
1650 register int c;
1651 register Lisp_Object val;
1652 int count = SPECPDL_INDEX ();
1653 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1654 struct buffer *b = 0;
1655 int continue_reading_p;
1656 /* Nonzero if reading an entire buffer. */
1657 int whole_buffer = 0;
1658 /* 1 on the first time around. */
1659 int first_sexp = 1;
1661 if (MARKERP (readcharfun))
1663 if (NILP (start))
1664 start = readcharfun;
1667 if (BUFFERP (readcharfun))
1668 b = XBUFFER (readcharfun);
1669 else if (MARKERP (readcharfun))
1670 b = XMARKER (readcharfun)->buffer;
1672 /* We assume START is nil when input is not from a buffer. */
1673 if (! NILP (start) && !b)
1674 abort ();
1676 specbind (Qstandard_input, readcharfun); /* GCPROs readcharfun. */
1677 specbind (Qcurrent_load_list, Qnil);
1678 record_unwind_protect (readevalloop_1, load_convert_to_unibyte ? Qt : Qnil);
1679 load_convert_to_unibyte = !NILP (unibyte);
1681 GCPRO4 (sourcename, readfun, start, end);
1683 /* Try to ensure sourcename is a truename, except whilst preloading. */
1684 if (NILP (Vpurify_flag)
1685 && !NILP (sourcename) && !NILP (Ffile_name_absolute_p (sourcename))
1686 && !NILP (Ffboundp (Qfile_truename)))
1687 sourcename = call1 (Qfile_truename, sourcename) ;
1689 LOADHIST_ATTACH (sourcename);
1691 continue_reading_p = 1;
1692 while (continue_reading_p)
1694 int count1 = SPECPDL_INDEX ();
1696 if (b != 0 && NILP (b->name))
1697 error ("Reading from killed buffer");
1699 if (!NILP (start))
1701 /* Switch to the buffer we are reading from. */
1702 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1703 set_buffer_internal (b);
1705 /* Save point in it. */
1706 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1707 /* Save ZV in it. */
1708 record_unwind_protect (save_restriction_restore, save_restriction_save ());
1709 /* Those get unbound after we read one expression. */
1711 /* Set point and ZV around stuff to be read. */
1712 Fgoto_char (start);
1713 if (!NILP (end))
1714 Fnarrow_to_region (make_number (BEGV), end);
1716 /* Just for cleanliness, convert END to a marker
1717 if it is an integer. */
1718 if (INTEGERP (end))
1719 end = Fpoint_max_marker ();
1722 /* On the first cycle, we can easily test here
1723 whether we are reading the whole buffer. */
1724 if (b && first_sexp)
1725 whole_buffer = (PT == BEG && ZV == Z);
1727 instream = stream;
1728 read_next:
1729 c = READCHAR;
1730 if (c == ';')
1732 while ((c = READCHAR) != '\n' && c != -1);
1733 goto read_next;
1735 if (c < 0)
1737 unbind_to (count1, Qnil);
1738 break;
1741 /* Ignore whitespace here, so we can detect eof. */
1742 if (c == ' ' || c == '\t' || c == '\n' || c == '\f' || c == '\r'
1743 || c == 0x8a0) /* NBSP */
1744 goto read_next;
1746 if (!NILP (Vpurify_flag) && c == '(')
1748 record_unwind_protect (unreadpure, Qnil);
1749 val = read_list (-1, readcharfun);
1751 else
1753 UNREAD (c);
1754 read_objects = Qnil;
1755 if (!NILP (readfun))
1757 val = call1 (readfun, readcharfun);
1759 /* If READCHARFUN has set point to ZV, we should
1760 stop reading, even if the form read sets point
1761 to a different value when evaluated. */
1762 if (BUFFERP (readcharfun))
1764 struct buffer *b = XBUFFER (readcharfun);
1765 if (BUF_PT (b) == BUF_ZV (b))
1766 continue_reading_p = 0;
1769 else if (! NILP (Vload_read_function))
1770 val = call1 (Vload_read_function, readcharfun);
1771 else
1772 val = read_internal_start (readcharfun, Qnil, Qnil);
1775 if (!NILP (start) && continue_reading_p)
1776 start = Fpoint_marker ();
1778 /* Restore saved point and BEGV. */
1779 unbind_to (count1, Qnil);
1781 /* Now eval what we just read. */
1782 val = (*evalfun) (val);
1784 if (printflag)
1786 Vvalues = Fcons (val, Vvalues);
1787 if (EQ (Vstandard_output, Qt))
1788 Fprin1 (val, Qnil);
1789 else
1790 Fprint (val, Qnil);
1793 first_sexp = 0;
1796 build_load_history (sourcename,
1797 stream || whole_buffer);
1799 UNGCPRO;
1801 unbind_to (count, Qnil);
1804 DEFUN ("eval-buffer", Feval_buffer, Seval_buffer, 0, 5, "",
1805 doc: /* Execute the current buffer as Lisp code.
1806 Programs can pass two arguments, BUFFER and PRINTFLAG.
1807 BUFFER is the buffer to evaluate (nil means use current buffer).
1808 PRINTFLAG controls printing of output:
1809 A value of nil means discard it; anything else is stream for print.
1811 If the optional third argument FILENAME is non-nil,
1812 it specifies the file name to use for `load-history'.
1813 The optional fourth argument UNIBYTE specifies `load-convert-to-unibyte'
1814 for this invocation.
1816 The optional fifth argument DO-ALLOW-PRINT, if non-nil, specifies that
1817 `print' and related functions should work normally even if PRINTFLAG is nil.
1819 This function preserves the position of point. */)
1820 (buffer, printflag, filename, unibyte, do_allow_print)
1821 Lisp_Object buffer, printflag, filename, unibyte, do_allow_print;
1823 int count = SPECPDL_INDEX ();
1824 Lisp_Object tem, buf;
1826 if (NILP (buffer))
1827 buf = Fcurrent_buffer ();
1828 else
1829 buf = Fget_buffer (buffer);
1830 if (NILP (buf))
1831 error ("No such buffer");
1833 if (NILP (printflag) && NILP (do_allow_print))
1834 tem = Qsymbolp;
1835 else
1836 tem = printflag;
1838 if (NILP (filename))
1839 filename = XBUFFER (buf)->filename;
1841 specbind (Qeval_buffer_list, Fcons (buf, Veval_buffer_list));
1842 specbind (Qstandard_output, tem);
1843 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1844 BUF_TEMP_SET_PT (XBUFFER (buf), BUF_BEGV (XBUFFER (buf)));
1845 readevalloop (buf, 0, filename, Feval,
1846 !NILP (printflag), unibyte, Qnil, Qnil, Qnil);
1847 unbind_to (count, Qnil);
1849 return Qnil;
1852 DEFUN ("eval-region", Feval_region, Seval_region, 2, 4, "r",
1853 doc: /* Execute the region as Lisp code.
1854 When called from programs, expects two arguments,
1855 giving starting and ending indices in the current buffer
1856 of the text to be executed.
1857 Programs can pass third argument PRINTFLAG which controls output:
1858 A value of nil means discard it; anything else is stream for printing it.
1859 Also the fourth argument READ-FUNCTION, if non-nil, is used
1860 instead of `read' to read each expression. It gets one argument
1861 which is the input stream for reading characters.
1863 This function does not move point. */)
1864 (start, end, printflag, read_function)
1865 Lisp_Object start, end, printflag, read_function;
1867 int count = SPECPDL_INDEX ();
1868 Lisp_Object tem, cbuf;
1870 cbuf = Fcurrent_buffer ();
1872 if (NILP (printflag))
1873 tem = Qsymbolp;
1874 else
1875 tem = printflag;
1876 specbind (Qstandard_output, tem);
1877 specbind (Qeval_buffer_list, Fcons (cbuf, Veval_buffer_list));
1879 /* readevalloop calls functions which check the type of start and end. */
1880 readevalloop (cbuf, 0, XBUFFER (cbuf)->filename, Feval,
1881 !NILP (printflag), Qnil, read_function,
1882 start, end);
1884 return unbind_to (count, Qnil);
1888 DEFUN ("read", Fread, Sread, 0, 1, 0,
1889 doc: /* Read one Lisp expression as text from STREAM, return as Lisp object.
1890 If STREAM is nil, use the value of `standard-input' (which see).
1891 STREAM or the value of `standard-input' may be:
1892 a buffer (read from point and advance it)
1893 a marker (read from where it points and advance it)
1894 a function (call it with no arguments for each character,
1895 call it with a char as argument to push a char back)
1896 a string (takes text from string, starting at the beginning)
1897 t (read text line using minibuffer and use it, or read from
1898 standard input in batch mode). */)
1899 (stream)
1900 Lisp_Object stream;
1902 if (NILP (stream))
1903 stream = Vstandard_input;
1904 if (EQ (stream, Qt))
1905 stream = Qread_char;
1906 if (EQ (stream, Qread_char))
1907 return Fread_minibuffer (build_string ("Lisp expression: "), Qnil);
1909 return read_internal_start (stream, Qnil, Qnil);
1912 DEFUN ("read-from-string", Fread_from_string, Sread_from_string, 1, 3, 0,
1913 doc: /* Read one Lisp expression which is represented as text by STRING.
1914 Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
1915 START and END optionally delimit a substring of STRING from which to read;
1916 they default to 0 and (length STRING) respectively. */)
1917 (string, start, end)
1918 Lisp_Object string, start, end;
1920 Lisp_Object ret;
1921 CHECK_STRING (string);
1922 /* read_internal_start sets read_from_string_index. */
1923 ret = read_internal_start (string, start, end);
1924 return Fcons (ret, make_number (read_from_string_index));
1927 /* Function to set up the global context we need in toplevel read
1928 calls. */
1929 static Lisp_Object
1930 read_internal_start (stream, start, end)
1931 Lisp_Object stream;
1932 Lisp_Object start; /* Only used when stream is a string. */
1933 Lisp_Object end; /* Only used when stream is a string. */
1935 Lisp_Object retval;
1937 readchar_count = 0;
1938 new_backquote_flag = 0;
1939 read_objects = Qnil;
1940 if (EQ (Vread_with_symbol_positions, Qt)
1941 || EQ (Vread_with_symbol_positions, stream))
1942 Vread_symbol_positions_list = Qnil;
1944 if (STRINGP (stream)
1945 || ((CONSP (stream) && STRINGP (XCAR (stream)))))
1947 int startval, endval;
1948 Lisp_Object string;
1950 if (STRINGP (stream))
1951 string = stream;
1952 else
1953 string = XCAR (stream);
1955 if (NILP (end))
1956 endval = SCHARS (string);
1957 else
1959 CHECK_NUMBER (end);
1960 endval = XINT (end);
1961 if (endval < 0 || endval > SCHARS (string))
1962 args_out_of_range (string, end);
1965 if (NILP (start))
1966 startval = 0;
1967 else
1969 CHECK_NUMBER (start);
1970 startval = XINT (start);
1971 if (startval < 0 || startval > endval)
1972 args_out_of_range (string, start);
1974 read_from_string_index = startval;
1975 read_from_string_index_byte = string_char_to_byte (string, startval);
1976 read_from_string_limit = endval;
1979 retval = read0 (stream);
1980 if (EQ (Vread_with_symbol_positions, Qt)
1981 || EQ (Vread_with_symbol_positions, stream))
1982 Vread_symbol_positions_list = Fnreverse (Vread_symbol_positions_list);
1983 return retval;
1987 /* Signal Qinvalid_read_syntax error.
1988 S is error string of length N (if > 0) */
1990 static void
1991 invalid_syntax (s, n)
1992 const char *s;
1993 int n;
1995 if (!n)
1996 n = strlen (s);
1997 xsignal1 (Qinvalid_read_syntax, make_string (s, n));
2001 /* Use this for recursive reads, in contexts where internal tokens
2002 are not allowed. */
2004 static Lisp_Object
2005 read0 (readcharfun)
2006 Lisp_Object readcharfun;
2008 register Lisp_Object val;
2009 int c;
2011 val = read1 (readcharfun, &c, 0);
2012 if (!c)
2013 return val;
2015 xsignal1 (Qinvalid_read_syntax,
2016 Fmake_string (make_number (1), make_number (c)));
2019 static int read_buffer_size;
2020 static char *read_buffer;
2022 /* Read a \-escape sequence, assuming we already read the `\'.
2023 If the escape sequence forces unibyte, return eight-bit char. */
2025 static int
2026 read_escape (readcharfun, stringp)
2027 Lisp_Object readcharfun;
2028 int stringp;
2030 register int c = READCHAR;
2031 /* \u allows up to four hex digits, \U up to eight. Default to the
2032 behavior for \u, and change this value in the case that \U is seen. */
2033 int unicode_hex_count = 4;
2035 switch (c)
2037 case -1:
2038 end_of_file_error ();
2040 case 'a':
2041 return '\007';
2042 case 'b':
2043 return '\b';
2044 case 'd':
2045 return 0177;
2046 case 'e':
2047 return 033;
2048 case 'f':
2049 return '\f';
2050 case 'n':
2051 return '\n';
2052 case 'r':
2053 return '\r';
2054 case 't':
2055 return '\t';
2056 case 'v':
2057 return '\v';
2058 case '\n':
2059 return -1;
2060 case ' ':
2061 if (stringp)
2062 return -1;
2063 return ' ';
2065 case 'M':
2066 c = READCHAR;
2067 if (c != '-')
2068 error ("Invalid escape character syntax");
2069 c = READCHAR;
2070 if (c == '\\')
2071 c = read_escape (readcharfun, 0);
2072 return c | meta_modifier;
2074 case 'S':
2075 c = READCHAR;
2076 if (c != '-')
2077 error ("Invalid escape character syntax");
2078 c = READCHAR;
2079 if (c == '\\')
2080 c = read_escape (readcharfun, 0);
2081 return c | shift_modifier;
2083 case 'H':
2084 c = READCHAR;
2085 if (c != '-')
2086 error ("Invalid escape character syntax");
2087 c = READCHAR;
2088 if (c == '\\')
2089 c = read_escape (readcharfun, 0);
2090 return c | hyper_modifier;
2092 case 'A':
2093 c = READCHAR;
2094 if (c != '-')
2095 error ("Invalid escape character syntax");
2096 c = READCHAR;
2097 if (c == '\\')
2098 c = read_escape (readcharfun, 0);
2099 return c | alt_modifier;
2101 case 's':
2102 c = READCHAR;
2103 if (stringp || c != '-')
2105 UNREAD (c);
2106 return ' ';
2108 c = READCHAR;
2109 if (c == '\\')
2110 c = read_escape (readcharfun, 0);
2111 return c | super_modifier;
2113 case 'C':
2114 c = READCHAR;
2115 if (c != '-')
2116 error ("Invalid escape character syntax");
2117 case '^':
2118 c = READCHAR;
2119 if (c == '\\')
2120 c = read_escape (readcharfun, 0);
2121 if ((c & ~CHAR_MODIFIER_MASK) == '?')
2122 return 0177 | (c & CHAR_MODIFIER_MASK);
2123 else if (! SINGLE_BYTE_CHAR_P ((c & ~CHAR_MODIFIER_MASK)))
2124 return c | ctrl_modifier;
2125 /* ASCII control chars are made from letters (both cases),
2126 as well as the non-letters within 0100...0137. */
2127 else if ((c & 0137) >= 0101 && (c & 0137) <= 0132)
2128 return (c & (037 | ~0177));
2129 else if ((c & 0177) >= 0100 && (c & 0177) <= 0137)
2130 return (c & (037 | ~0177));
2131 else
2132 return c | ctrl_modifier;
2134 case '0':
2135 case '1':
2136 case '2':
2137 case '3':
2138 case '4':
2139 case '5':
2140 case '6':
2141 case '7':
2142 /* An octal escape, as in ANSI C. */
2144 register int i = c - '0';
2145 register int count = 0;
2146 while (++count < 3)
2148 if ((c = READCHAR) >= '0' && c <= '7')
2150 i *= 8;
2151 i += c - '0';
2153 else
2155 UNREAD (c);
2156 break;
2160 if (i >= 0x80 && i < 0x100)
2161 i = BYTE8_TO_CHAR (i);
2162 return i;
2165 case 'x':
2166 /* A hex escape, as in ANSI C. */
2168 int i = 0;
2169 int count = 0;
2170 while (1)
2172 c = READCHAR;
2173 if (c >= '0' && c <= '9')
2175 i *= 16;
2176 i += c - '0';
2178 else if ((c >= 'a' && c <= 'f')
2179 || (c >= 'A' && c <= 'F'))
2181 i *= 16;
2182 if (c >= 'a' && c <= 'f')
2183 i += c - 'a' + 10;
2184 else
2185 i += c - 'A' + 10;
2187 else
2189 UNREAD (c);
2190 break;
2192 count++;
2195 if (count < 3 && i >= 0x80)
2196 return BYTE8_TO_CHAR (i);
2197 return i;
2200 case 'U':
2201 /* Post-Unicode-2.0: Up to eight hex chars. */
2202 unicode_hex_count = 8;
2203 case 'u':
2205 /* A Unicode escape. We only permit them in strings and characters,
2206 not arbitrarily in the source code, as in some other languages. */
2208 unsigned int i = 0;
2209 int count = 0;
2211 while (++count <= unicode_hex_count)
2213 c = READCHAR;
2214 /* isdigit and isalpha may be locale-specific, which we don't
2215 want. */
2216 if (c >= '0' && c <= '9') i = (i << 4) + (c - '0');
2217 else if (c >= 'a' && c <= 'f') i = (i << 4) + (c - 'a') + 10;
2218 else if (c >= 'A' && c <= 'F') i = (i << 4) + (c - 'A') + 10;
2219 else
2221 error ("Non-hex digit used for Unicode escape");
2222 break;
2225 if (i > 0x10FFFF)
2226 error ("Non-Unicode character: 0x%x", i);
2227 return i;
2230 default:
2231 return c;
2235 /* Read an integer in radix RADIX using READCHARFUN to read
2236 characters. RADIX must be in the interval [2..36]; if it isn't, a
2237 read error is signaled . Value is the integer read. Signals an
2238 error if encountering invalid read syntax or if RADIX is out of
2239 range. */
2241 static Lisp_Object
2242 read_integer (readcharfun, radix)
2243 Lisp_Object readcharfun;
2244 int radix;
2246 int ndigits = 0, invalid_p, c, sign = 0;
2247 EMACS_INT number = 0;
2249 if (radix < 2 || radix > 36)
2250 invalid_p = 1;
2251 else
2253 number = ndigits = invalid_p = 0;
2254 sign = 1;
2256 c = READCHAR;
2257 if (c == '-')
2259 c = READCHAR;
2260 sign = -1;
2262 else if (c == '+')
2263 c = READCHAR;
2265 while (c >= 0)
2267 int digit;
2269 if (c >= '0' && c <= '9')
2270 digit = c - '0';
2271 else if (c >= 'a' && c <= 'z')
2272 digit = c - 'a' + 10;
2273 else if (c >= 'A' && c <= 'Z')
2274 digit = c - 'A' + 10;
2275 else
2277 UNREAD (c);
2278 break;
2281 if (digit < 0 || digit >= radix)
2282 invalid_p = 1;
2284 number = radix * number + digit;
2285 ++ndigits;
2286 c = READCHAR;
2290 if (ndigits == 0 || invalid_p)
2292 char buf[50];
2293 sprintf (buf, "integer, radix %d", radix);
2294 invalid_syntax (buf, 0);
2297 return make_number (sign * number);
2301 /* If the next token is ')' or ']' or '.', we store that character
2302 in *PCH and the return value is not interesting. Else, we store
2303 zero in *PCH and we read and return one lisp object.
2305 FIRST_IN_LIST is nonzero if this is the first element of a list. */
2307 static Lisp_Object
2308 read1 (readcharfun, pch, first_in_list)
2309 register Lisp_Object readcharfun;
2310 int *pch;
2311 int first_in_list;
2313 register int c;
2314 int uninterned_symbol = 0;
2315 int multibyte;
2317 *pch = 0;
2318 load_each_byte = 0;
2320 retry:
2322 c = READCHAR_REPORT_MULTIBYTE (&multibyte);
2323 if (c < 0)
2324 end_of_file_error ();
2326 switch (c)
2328 case '(':
2329 return read_list (0, readcharfun);
2331 case '[':
2332 return read_vector (readcharfun, 0);
2334 case ')':
2335 case ']':
2337 *pch = c;
2338 return Qnil;
2341 case '#':
2342 c = READCHAR;
2343 if (c == '^')
2345 c = READCHAR;
2346 if (c == '[')
2348 Lisp_Object tmp;
2349 tmp = read_vector (readcharfun, 0);
2350 if (XVECTOR (tmp)->size < CHAR_TABLE_STANDARD_SLOTS)
2351 error ("Invalid size char-table");
2352 XSETPVECTYPE (XVECTOR (tmp), PVEC_CHAR_TABLE);
2353 return tmp;
2355 else if (c == '^')
2357 c = READCHAR;
2358 if (c == '[')
2360 Lisp_Object tmp;
2361 int depth, size;
2363 tmp = read_vector (readcharfun, 0);
2364 if (!INTEGERP (AREF (tmp, 0)))
2365 error ("Invalid depth in char-table");
2366 depth = XINT (AREF (tmp, 0));
2367 if (depth < 1 || depth > 3)
2368 error ("Invalid depth in char-table");
2369 size = XVECTOR (tmp)->size - 2;
2370 if (chartab_size [depth] != size)
2371 error ("Invalid size char-table");
2372 XSETPVECTYPE (XVECTOR (tmp), PVEC_SUB_CHAR_TABLE);
2373 return tmp;
2375 invalid_syntax ("#^^", 3);
2377 invalid_syntax ("#^", 2);
2379 if (c == '&')
2381 Lisp_Object length;
2382 length = read1 (readcharfun, pch, first_in_list);
2383 c = READCHAR;
2384 if (c == '"')
2386 Lisp_Object tmp, val;
2387 int size_in_chars
2388 = ((XFASTINT (length) + BOOL_VECTOR_BITS_PER_CHAR - 1)
2389 / BOOL_VECTOR_BITS_PER_CHAR);
2391 UNREAD (c);
2392 tmp = read1 (readcharfun, pch, first_in_list);
2393 if (STRING_MULTIBYTE (tmp)
2394 || (size_in_chars != SCHARS (tmp)
2395 /* We used to print 1 char too many
2396 when the number of bits was a multiple of 8.
2397 Accept such input in case it came from an old
2398 version. */
2399 && ! (XFASTINT (length)
2400 == (SCHARS (tmp) - 1) * BOOL_VECTOR_BITS_PER_CHAR)))
2401 invalid_syntax ("#&...", 5);
2403 val = Fmake_bool_vector (length, Qnil);
2404 bcopy (SDATA (tmp), XBOOL_VECTOR (val)->data,
2405 size_in_chars);
2406 /* Clear the extraneous bits in the last byte. */
2407 if (XINT (length) != size_in_chars * BOOL_VECTOR_BITS_PER_CHAR)
2408 XBOOL_VECTOR (val)->data[size_in_chars - 1]
2409 &= (1 << (XINT (length) % BOOL_VECTOR_BITS_PER_CHAR)) - 1;
2410 return val;
2412 invalid_syntax ("#&...", 5);
2414 if (c == '[')
2416 /* Accept compiled functions at read-time so that we don't have to
2417 build them using function calls. */
2418 Lisp_Object tmp;
2419 tmp = read_vector (readcharfun, 1);
2420 return Fmake_byte_code (XVECTOR (tmp)->size,
2421 XVECTOR (tmp)->contents);
2423 if (c == '(')
2425 Lisp_Object tmp;
2426 struct gcpro gcpro1;
2427 int ch;
2429 /* Read the string itself. */
2430 tmp = read1 (readcharfun, &ch, 0);
2431 if (ch != 0 || !STRINGP (tmp))
2432 invalid_syntax ("#", 1);
2433 GCPRO1 (tmp);
2434 /* Read the intervals and their properties. */
2435 while (1)
2437 Lisp_Object beg, end, plist;
2439 beg = read1 (readcharfun, &ch, 0);
2440 end = plist = Qnil;
2441 if (ch == ')')
2442 break;
2443 if (ch == 0)
2444 end = read1 (readcharfun, &ch, 0);
2445 if (ch == 0)
2446 plist = read1 (readcharfun, &ch, 0);
2447 if (ch)
2448 invalid_syntax ("Invalid string property list", 0);
2449 Fset_text_properties (beg, end, plist, tmp);
2451 UNGCPRO;
2452 return tmp;
2455 /* #@NUMBER is used to skip NUMBER following characters.
2456 That's used in .elc files to skip over doc strings
2457 and function definitions. */
2458 if (c == '@')
2460 int i, nskip = 0;
2462 load_each_byte = 1;
2463 /* Read a decimal integer. */
2464 while ((c = READCHAR) >= 0
2465 && c >= '0' && c <= '9')
2467 nskip *= 10;
2468 nskip += c - '0';
2470 if (c >= 0)
2471 UNREAD (c);
2473 if (load_force_doc_strings
2474 && (EQ (readcharfun, Qget_file_char)
2475 || EQ (readcharfun, Qget_emacs_mule_file_char)))
2477 /* If we are supposed to force doc strings into core right now,
2478 record the last string that we skipped,
2479 and record where in the file it comes from. */
2481 /* But first exchange saved_doc_string
2482 with prev_saved_doc_string, so we save two strings. */
2484 char *temp = saved_doc_string;
2485 int temp_size = saved_doc_string_size;
2486 file_offset temp_pos = saved_doc_string_position;
2487 int temp_len = saved_doc_string_length;
2489 saved_doc_string = prev_saved_doc_string;
2490 saved_doc_string_size = prev_saved_doc_string_size;
2491 saved_doc_string_position = prev_saved_doc_string_position;
2492 saved_doc_string_length = prev_saved_doc_string_length;
2494 prev_saved_doc_string = temp;
2495 prev_saved_doc_string_size = temp_size;
2496 prev_saved_doc_string_position = temp_pos;
2497 prev_saved_doc_string_length = temp_len;
2500 if (saved_doc_string_size == 0)
2502 saved_doc_string_size = nskip + 100;
2503 saved_doc_string = (char *) xmalloc (saved_doc_string_size);
2505 if (nskip > saved_doc_string_size)
2507 saved_doc_string_size = nskip + 100;
2508 saved_doc_string = (char *) xrealloc (saved_doc_string,
2509 saved_doc_string_size);
2512 saved_doc_string_position = file_tell (instream);
2514 /* Copy that many characters into saved_doc_string. */
2515 for (i = 0; i < nskip && c >= 0; i++)
2516 saved_doc_string[i] = c = READCHAR;
2518 saved_doc_string_length = i;
2520 else
2522 /* Skip that many characters. */
2523 for (i = 0; i < nskip && c >= 0; i++)
2524 c = READCHAR;
2527 load_each_byte = 0;
2528 goto retry;
2530 if (c == '!')
2532 /* #! appears at the beginning of an executable file.
2533 Skip the first line. */
2534 while (c != '\n' && c >= 0)
2535 c = READCHAR;
2536 goto retry;
2538 if (c == '$')
2539 return Vload_file_name;
2540 if (c == '\'')
2541 return Fcons (Qfunction, Fcons (read0 (readcharfun), Qnil));
2542 /* #:foo is the uninterned symbol named foo. */
2543 if (c == ':')
2545 uninterned_symbol = 1;
2546 c = READCHAR;
2547 goto default_label;
2549 /* Reader forms that can reuse previously read objects. */
2550 if (c >= '0' && c <= '9')
2552 int n = 0;
2553 Lisp_Object tem;
2555 /* Read a non-negative integer. */
2556 while (c >= '0' && c <= '9')
2558 n *= 10;
2559 n += c - '0';
2560 c = READCHAR;
2562 /* #n=object returns object, but associates it with n for #n#. */
2563 if (c == '=')
2565 /* Make a placeholder for #n# to use temporarily */
2566 Lisp_Object placeholder;
2567 Lisp_Object cell;
2569 placeholder = Fcons(Qnil, Qnil);
2570 cell = Fcons (make_number (n), placeholder);
2571 read_objects = Fcons (cell, read_objects);
2573 /* Read the object itself. */
2574 tem = read0 (readcharfun);
2576 /* Now put it everywhere the placeholder was... */
2577 substitute_object_in_subtree (tem, placeholder);
2579 /* ...and #n# will use the real value from now on. */
2580 Fsetcdr (cell, tem);
2582 return tem;
2584 /* #n# returns a previously read object. */
2585 if (c == '#')
2587 tem = Fassq (make_number (n), read_objects);
2588 if (CONSP (tem))
2589 return XCDR (tem);
2590 /* Fall through to error message. */
2592 else if (c == 'r' || c == 'R')
2593 return read_integer (readcharfun, n);
2595 /* Fall through to error message. */
2597 else if (c == 'x' || c == 'X')
2598 return read_integer (readcharfun, 16);
2599 else if (c == 'o' || c == 'O')
2600 return read_integer (readcharfun, 8);
2601 else if (c == 'b' || c == 'B')
2602 return read_integer (readcharfun, 2);
2604 UNREAD (c);
2605 invalid_syntax ("#", 1);
2607 case ';':
2608 while ((c = READCHAR) >= 0 && c != '\n');
2609 goto retry;
2611 case '\'':
2613 return Fcons (Qquote, Fcons (read0 (readcharfun), Qnil));
2616 case '`':
2617 if (first_in_list)
2619 Vold_style_backquotes = Qt;
2620 goto default_label;
2622 else
2624 Lisp_Object value;
2626 new_backquote_flag++;
2627 value = read0 (readcharfun);
2628 new_backquote_flag--;
2630 return Fcons (Qbackquote, Fcons (value, Qnil));
2633 case ',':
2634 if (new_backquote_flag)
2636 Lisp_Object comma_type = Qnil;
2637 Lisp_Object value;
2638 int ch = READCHAR;
2640 if (ch == '@')
2641 comma_type = Qcomma_at;
2642 else if (ch == '.')
2643 comma_type = Qcomma_dot;
2644 else
2646 if (ch >= 0) UNREAD (ch);
2647 comma_type = Qcomma;
2650 new_backquote_flag--;
2651 value = read0 (readcharfun);
2652 new_backquote_flag++;
2653 return Fcons (comma_type, Fcons (value, Qnil));
2655 else
2657 Vold_style_backquotes = Qt;
2658 goto default_label;
2661 case '?':
2663 int modifiers;
2664 int next_char;
2665 int ok;
2667 c = READCHAR;
2668 if (c < 0)
2669 end_of_file_error ();
2671 /* Accept `single space' syntax like (list ? x) where the
2672 whitespace character is SPC or TAB.
2673 Other literal whitespace like NL, CR, and FF are not accepted,
2674 as there are well-established escape sequences for these. */
2675 if (c == ' ' || c == '\t')
2676 return make_number (c);
2678 if (c == '\\')
2679 c = read_escape (readcharfun, 0);
2680 modifiers = c & CHAR_MODIFIER_MASK;
2681 c &= ~CHAR_MODIFIER_MASK;
2682 if (CHAR_BYTE8_P (c))
2683 c = CHAR_TO_BYTE8 (c);
2684 c |= modifiers;
2686 next_char = READCHAR;
2687 if (next_char == '.')
2689 /* Only a dotted-pair dot is valid after a char constant. */
2690 int next_next_char = READCHAR;
2691 UNREAD (next_next_char);
2693 ok = (next_next_char <= 040
2694 || (next_next_char < 0200
2695 && (index ("\"';([#?", next_next_char)
2696 || (!first_in_list && next_next_char == '`')
2697 || (new_backquote_flag && next_next_char == ','))));
2699 else
2701 ok = (next_char <= 040
2702 || (next_char < 0200
2703 && (index ("\"';()[]#?", next_char)
2704 || (!first_in_list && next_char == '`')
2705 || (new_backquote_flag && next_char == ','))));
2707 UNREAD (next_char);
2708 if (ok)
2709 return make_number (c);
2711 invalid_syntax ("?", 1);
2714 case '"':
2716 char *p = read_buffer;
2717 char *end = read_buffer + read_buffer_size;
2718 register int c;
2719 /* Nonzero if we saw an escape sequence specifying
2720 a multibyte character. */
2721 int force_multibyte = 0;
2722 /* Nonzero if we saw an escape sequence specifying
2723 a single-byte character. */
2724 int force_singlebyte = 0;
2725 int cancel = 0;
2726 int nchars = 0;
2728 while ((c = READCHAR) >= 0
2729 && c != '\"')
2731 if (end - p < MAX_MULTIBYTE_LENGTH)
2733 int offset = p - read_buffer;
2734 read_buffer = (char *) xrealloc (read_buffer,
2735 read_buffer_size *= 2);
2736 p = read_buffer + offset;
2737 end = read_buffer + read_buffer_size;
2740 if (c == '\\')
2742 int modifiers;
2744 c = read_escape (readcharfun, 1);
2746 /* C is -1 if \ newline has just been seen */
2747 if (c == -1)
2749 if (p == read_buffer)
2750 cancel = 1;
2751 continue;
2754 modifiers = c & CHAR_MODIFIER_MASK;
2755 c = c & ~CHAR_MODIFIER_MASK;
2757 if (CHAR_BYTE8_P (c))
2758 force_singlebyte = 1;
2759 else if (! ASCII_CHAR_P (c))
2760 force_multibyte = 1;
2761 else /* i.e. ASCII_CHAR_P (c) */
2763 /* Allow `\C- ' and `\C-?'. */
2764 if (modifiers == CHAR_CTL)
2766 if (c == ' ')
2767 c = 0, modifiers = 0;
2768 else if (c == '?')
2769 c = 127, modifiers = 0;
2771 if (modifiers & CHAR_SHIFT)
2773 /* Shift modifier is valid only with [A-Za-z]. */
2774 if (c >= 'A' && c <= 'Z')
2775 modifiers &= ~CHAR_SHIFT;
2776 else if (c >= 'a' && c <= 'z')
2777 c -= ('a' - 'A'), modifiers &= ~CHAR_SHIFT;
2780 if (modifiers & CHAR_META)
2782 /* Move the meta bit to the right place for a
2783 string. */
2784 modifiers &= ~CHAR_META;
2785 c = BYTE8_TO_CHAR (c | 0x80);
2786 force_singlebyte = 1;
2790 /* Any modifiers remaining are invalid. */
2791 if (modifiers)
2792 error ("Invalid modifier in string");
2793 p += CHAR_STRING (c, (unsigned char *) p);
2795 else
2797 p += CHAR_STRING (c, (unsigned char *) p);
2798 if (CHAR_BYTE8_P (c))
2799 force_singlebyte = 1;
2800 else if (! ASCII_CHAR_P (c))
2801 force_multibyte = 1;
2803 nchars++;
2806 if (c < 0)
2807 end_of_file_error ();
2809 /* If purifying, and string starts with \ newline,
2810 return zero instead. This is for doc strings
2811 that we are really going to find in etc/DOC.nn.nn */
2812 if (!NILP (Vpurify_flag) && NILP (Vdoc_file_name) && cancel)
2813 return make_number (0);
2815 if (force_multibyte)
2816 /* READ_BUFFER already contains valid multibyte forms. */
2818 else if (force_singlebyte)
2820 nchars = str_as_unibyte (read_buffer, p - read_buffer);
2821 p = read_buffer + nchars;
2823 else
2824 /* Otherwise, READ_BUFFER contains only ASCII. */
2827 /* We want readchar_count to be the number of characters, not
2828 bytes. Hence we adjust for multibyte characters in the
2829 string. ... But it doesn't seem to be necessary, because
2830 READCHAR *does* read multibyte characters from buffers. */
2831 /* readchar_count -= (p - read_buffer) - nchars; */
2832 if (read_pure)
2833 return make_pure_string (read_buffer, nchars, p - read_buffer,
2834 (force_multibyte
2835 || (p - read_buffer != nchars)));
2836 return make_specified_string (read_buffer, nchars, p - read_buffer,
2837 (force_multibyte
2838 || (p - read_buffer != nchars)));
2841 case '.':
2843 int next_char = READCHAR;
2844 UNREAD (next_char);
2846 if (next_char <= 040
2847 || (next_char < 0200
2848 && (index ("\"';([#?", next_char)
2849 || (!first_in_list && next_char == '`')
2850 || (new_backquote_flag && next_char == ','))))
2852 *pch = c;
2853 return Qnil;
2856 /* Otherwise, we fall through! Note that the atom-reading loop
2857 below will now loop at least once, assuring that we will not
2858 try to UNREAD two characters in a row. */
2860 default:
2861 default_label:
2862 if (c <= 040) goto retry;
2863 if (c == 0x8a0) /* NBSP */
2864 goto retry;
2866 char *p = read_buffer;
2867 int quoted = 0;
2870 char *end = read_buffer + read_buffer_size;
2872 while (c > 040
2873 && c != 0x8a0 /* NBSP */
2874 && (c >= 0200
2875 || (!index ("\"';()[]#", c)
2876 && !(!first_in_list && c == '`')
2877 && !(new_backquote_flag && c == ','))))
2879 if (end - p < MAX_MULTIBYTE_LENGTH)
2881 int offset = p - read_buffer;
2882 read_buffer = (char *) xrealloc (read_buffer,
2883 read_buffer_size *= 2);
2884 p = read_buffer + offset;
2885 end = read_buffer + read_buffer_size;
2888 if (c == '\\')
2890 c = READCHAR;
2891 if (c == -1)
2892 end_of_file_error ();
2893 quoted = 1;
2896 if (multibyte)
2897 p += CHAR_STRING (c, p);
2898 else
2899 *p++ = c;
2900 c = READCHAR;
2903 if (p == end)
2905 int offset = p - read_buffer;
2906 read_buffer = (char *) xrealloc (read_buffer,
2907 read_buffer_size *= 2);
2908 p = read_buffer + offset;
2909 end = read_buffer + read_buffer_size;
2911 *p = 0;
2912 if (c >= 0)
2913 UNREAD (c);
2916 if (!quoted && !uninterned_symbol)
2918 register char *p1;
2919 register Lisp_Object val;
2920 p1 = read_buffer;
2921 if (*p1 == '+' || *p1 == '-') p1++;
2922 /* Is it an integer? */
2923 if (p1 != p)
2925 while (p1 != p && (c = *p1) >= '0' && c <= '9') p1++;
2926 /* Integers can have trailing decimal points. */
2927 if (p1 > read_buffer && p1 < p && *p1 == '.') p1++;
2928 if (p1 == p)
2929 /* It is an integer. */
2931 if (p1[-1] == '.')
2932 p1[-1] = '\0';
2933 /* Fixme: if we have strtol, use that, and check
2934 for overflow. */
2935 if (sizeof (int) == sizeof (EMACS_INT))
2936 XSETINT (val, atoi (read_buffer));
2937 else if (sizeof (long) == sizeof (EMACS_INT))
2938 XSETINT (val, atol (read_buffer));
2939 else
2940 abort ();
2941 return val;
2944 if (isfloat_string (read_buffer))
2946 /* Compute NaN and infinities using 0.0 in a variable,
2947 to cope with compilers that think they are smarter
2948 than we are. */
2949 double zero = 0.0;
2951 double value;
2953 /* Negate the value ourselves. This treats 0, NaNs,
2954 and infinity properly on IEEE floating point hosts,
2955 and works around a common bug where atof ("-0.0")
2956 drops the sign. */
2957 int negative = read_buffer[0] == '-';
2959 /* The only way p[-1] can be 'F' or 'N', after isfloat_string
2960 returns 1, is if the input ends in e+INF or e+NaN. */
2961 switch (p[-1])
2963 case 'F':
2964 value = 1.0 / zero;
2965 break;
2966 case 'N':
2967 value = zero / zero;
2969 /* If that made a "negative" NaN, negate it. */
2972 int i;
2973 union { double d; char c[sizeof (double)]; } u_data, u_minus_zero;
2975 u_data.d = value;
2976 u_minus_zero.d = - 0.0;
2977 for (i = 0; i < sizeof (double); i++)
2978 if (u_data.c[i] & u_minus_zero.c[i])
2980 value = - value;
2981 break;
2984 /* Now VALUE is a positive NaN. */
2985 break;
2986 default:
2987 value = atof (read_buffer + negative);
2988 break;
2991 return make_float (negative ? - value : value);
2995 Lisp_Object name, result;
2996 EMACS_INT nbytes = p - read_buffer;
2997 EMACS_INT nchars
2998 = (multibyte ? multibyte_chars_in_text (read_buffer, nbytes)
2999 : nbytes);
3001 if (uninterned_symbol && ! NILP (Vpurify_flag))
3002 name = make_pure_string (read_buffer, nchars, nbytes, multibyte);
3003 else
3004 name = make_specified_string (read_buffer, nchars, nbytes,multibyte);
3005 result = (uninterned_symbol ? Fmake_symbol (name)
3006 : Fintern (name, Qnil));
3008 if (EQ (Vread_with_symbol_positions, Qt)
3009 || EQ (Vread_with_symbol_positions, readcharfun))
3010 Vread_symbol_positions_list =
3011 /* Kind of a hack; this will probably fail if characters
3012 in the symbol name were escaped. Not really a big
3013 deal, though. */
3014 Fcons (Fcons (result,
3015 make_number (readchar_count
3016 - XFASTINT (Flength (Fsymbol_name (result))))),
3017 Vread_symbol_positions_list);
3018 return result;
3025 /* List of nodes we've seen during substitute_object_in_subtree. */
3026 static Lisp_Object seen_list;
3028 static void
3029 substitute_object_in_subtree (object, placeholder)
3030 Lisp_Object object;
3031 Lisp_Object placeholder;
3033 Lisp_Object check_object;
3035 /* We haven't seen any objects when we start. */
3036 seen_list = Qnil;
3038 /* Make all the substitutions. */
3039 check_object
3040 = substitute_object_recurse (object, placeholder, object);
3042 /* Clear seen_list because we're done with it. */
3043 seen_list = Qnil;
3045 /* The returned object here is expected to always eq the
3046 original. */
3047 if (!EQ (check_object, object))
3048 error ("Unexpected mutation error in reader");
3051 /* Feval doesn't get called from here, so no gc protection is needed. */
3052 #define SUBSTITUTE(get_val, set_val) \
3053 do { \
3054 Lisp_Object old_value = get_val; \
3055 Lisp_Object true_value \
3056 = substitute_object_recurse (object, placeholder, \
3057 old_value); \
3059 if (!EQ (old_value, true_value)) \
3061 set_val; \
3063 } while (0)
3065 static Lisp_Object
3066 substitute_object_recurse (object, placeholder, subtree)
3067 Lisp_Object object;
3068 Lisp_Object placeholder;
3069 Lisp_Object subtree;
3071 /* If we find the placeholder, return the target object. */
3072 if (EQ (placeholder, subtree))
3073 return object;
3075 /* If we've been to this node before, don't explore it again. */
3076 if (!EQ (Qnil, Fmemq (subtree, seen_list)))
3077 return subtree;
3079 /* If this node can be the entry point to a cycle, remember that
3080 we've seen it. It can only be such an entry point if it was made
3081 by #n=, which means that we can find it as a value in
3082 read_objects. */
3083 if (!EQ (Qnil, Frassq (subtree, read_objects)))
3084 seen_list = Fcons (subtree, seen_list);
3086 /* Recurse according to subtree's type.
3087 Every branch must return a Lisp_Object. */
3088 switch (XTYPE (subtree))
3090 case Lisp_Vectorlike:
3092 int i, length = 0;
3093 if (BOOL_VECTOR_P (subtree))
3094 return subtree; /* No sub-objects anyway. */
3095 else if (CHAR_TABLE_P (subtree) || SUB_CHAR_TABLE_P (subtree)
3096 || COMPILEDP (subtree))
3097 length = ASIZE (subtree) & PSEUDOVECTOR_SIZE_MASK;
3098 else if (VECTORP (subtree))
3099 length = ASIZE (subtree);
3100 else
3101 /* An unknown pseudovector may contain non-Lisp fields, so we
3102 can't just blindly traverse all its fields. We used to call
3103 `Flength' which signaled `sequencep', so I just preserved this
3104 behavior. */
3105 wrong_type_argument (Qsequencep, subtree);
3107 for (i = 0; i < length; i++)
3108 SUBSTITUTE (AREF (subtree, i),
3109 ASET (subtree, i, true_value));
3110 return subtree;
3113 case Lisp_Cons:
3115 SUBSTITUTE (XCAR (subtree),
3116 XSETCAR (subtree, true_value));
3117 SUBSTITUTE (XCDR (subtree),
3118 XSETCDR (subtree, true_value));
3119 return subtree;
3122 case Lisp_String:
3124 /* Check for text properties in each interval.
3125 substitute_in_interval contains part of the logic. */
3127 INTERVAL root_interval = STRING_INTERVALS (subtree);
3128 Lisp_Object arg = Fcons (object, placeholder);
3130 traverse_intervals_noorder (root_interval,
3131 &substitute_in_interval, arg);
3133 return subtree;
3136 /* Other types don't recurse any further. */
3137 default:
3138 return subtree;
3142 /* Helper function for substitute_object_recurse. */
3143 static void
3144 substitute_in_interval (interval, arg)
3145 INTERVAL interval;
3146 Lisp_Object arg;
3148 Lisp_Object object = Fcar (arg);
3149 Lisp_Object placeholder = Fcdr (arg);
3151 SUBSTITUTE(interval->plist, interval->plist = true_value);
3155 #define LEAD_INT 1
3156 #define DOT_CHAR 2
3157 #define TRAIL_INT 4
3158 #define E_CHAR 8
3159 #define EXP_INT 16
3162 isfloat_string (cp)
3163 register char *cp;
3165 register int state;
3167 char *start = cp;
3169 state = 0;
3170 if (*cp == '+' || *cp == '-')
3171 cp++;
3173 if (*cp >= '0' && *cp <= '9')
3175 state |= LEAD_INT;
3176 while (*cp >= '0' && *cp <= '9')
3177 cp++;
3179 if (*cp == '.')
3181 state |= DOT_CHAR;
3182 cp++;
3184 if (*cp >= '0' && *cp <= '9')
3186 state |= TRAIL_INT;
3187 while (*cp >= '0' && *cp <= '9')
3188 cp++;
3190 if (*cp == 'e' || *cp == 'E')
3192 state |= E_CHAR;
3193 cp++;
3194 if (*cp == '+' || *cp == '-')
3195 cp++;
3198 if (*cp >= '0' && *cp <= '9')
3200 state |= EXP_INT;
3201 while (*cp >= '0' && *cp <= '9')
3202 cp++;
3204 else if (cp == start)
3206 else if (cp[-1] == '+' && cp[0] == 'I' && cp[1] == 'N' && cp[2] == 'F')
3208 state |= EXP_INT;
3209 cp += 3;
3211 else if (cp[-1] == '+' && cp[0] == 'N' && cp[1] == 'a' && cp[2] == 'N')
3213 state |= EXP_INT;
3214 cp += 3;
3217 return (((*cp == 0) || (*cp == ' ') || (*cp == '\t') || (*cp == '\n') || (*cp == '\r') || (*cp == '\f'))
3218 && (state == (LEAD_INT|DOT_CHAR|TRAIL_INT)
3219 || state == (DOT_CHAR|TRAIL_INT)
3220 || state == (LEAD_INT|E_CHAR|EXP_INT)
3221 || state == (LEAD_INT|DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)
3222 || state == (DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)));
3226 static Lisp_Object
3227 read_vector (readcharfun, bytecodeflag)
3228 Lisp_Object readcharfun;
3229 int bytecodeflag;
3231 register int i;
3232 register int size;
3233 register Lisp_Object *ptr;
3234 register Lisp_Object tem, item, vector;
3235 register struct Lisp_Cons *otem;
3236 Lisp_Object len;
3238 tem = read_list (1, readcharfun);
3239 len = Flength (tem);
3240 vector = (read_pure ? make_pure_vector (XINT (len)) : Fmake_vector (len, Qnil));
3242 size = XVECTOR (vector)->size;
3243 ptr = XVECTOR (vector)->contents;
3244 for (i = 0; i < size; i++)
3246 item = Fcar (tem);
3247 /* If `load-force-doc-strings' is t when reading a lazily-loaded
3248 bytecode object, the docstring containing the bytecode and
3249 constants values must be treated as unibyte and passed to
3250 Fread, to get the actual bytecode string and constants vector. */
3251 if (bytecodeflag && load_force_doc_strings)
3253 if (i == COMPILED_BYTECODE)
3255 if (!STRINGP (item))
3256 error ("Invalid byte code");
3258 /* Delay handling the bytecode slot until we know whether
3259 it is lazily-loaded (we can tell by whether the
3260 constants slot is nil). */
3261 ptr[COMPILED_CONSTANTS] = item;
3262 item = Qnil;
3264 else if (i == COMPILED_CONSTANTS)
3266 Lisp_Object bytestr = ptr[COMPILED_CONSTANTS];
3268 if (NILP (item))
3270 /* Coerce string to unibyte (like string-as-unibyte,
3271 but without generating extra garbage and
3272 guaranteeing no change in the contents). */
3273 STRING_SET_CHARS (bytestr, SBYTES (bytestr));
3274 STRING_SET_UNIBYTE (bytestr);
3276 item = Fread (Fcons (bytestr, readcharfun));
3277 if (!CONSP (item))
3278 error ("Invalid byte code");
3280 otem = XCONS (item);
3281 bytestr = XCAR (item);
3282 item = XCDR (item);
3283 free_cons (otem);
3286 /* Now handle the bytecode slot. */
3287 ptr[COMPILED_BYTECODE] = read_pure ? Fpurecopy (bytestr) : bytestr;
3289 else if (i == COMPILED_DOC_STRING
3290 && STRINGP (item)
3291 && ! STRING_MULTIBYTE (item))
3293 if (EQ (readcharfun, Qget_emacs_mule_file_char))
3294 item = Fdecode_coding_string (item, Qemacs_mule, Qnil, Qnil);
3295 else
3296 item = Fstring_as_multibyte (item);
3299 ptr[i] = read_pure ? Fpurecopy (item) : item;
3300 otem = XCONS (tem);
3301 tem = Fcdr (tem);
3302 free_cons (otem);
3304 return vector;
3307 /* FLAG = 1 means check for ] to terminate rather than ) and .
3308 FLAG = -1 means check for starting with defun
3309 and make structure pure. */
3311 static Lisp_Object
3312 read_list (flag, readcharfun)
3313 int flag;
3314 register Lisp_Object readcharfun;
3316 /* -1 means check next element for defun,
3317 0 means don't check,
3318 1 means already checked and found defun. */
3319 int defunflag = flag < 0 ? -1 : 0;
3320 Lisp_Object val, tail;
3321 register Lisp_Object elt, tem;
3322 struct gcpro gcpro1, gcpro2;
3323 /* 0 is the normal case.
3324 1 means this list is a doc reference; replace it with the number 0.
3325 2 means this list is a doc reference; replace it with the doc string. */
3326 int doc_reference = 0;
3328 /* Initialize this to 1 if we are reading a list. */
3329 int first_in_list = flag <= 0;
3331 val = Qnil;
3332 tail = Qnil;
3334 while (1)
3336 int ch;
3337 GCPRO2 (val, tail);
3338 elt = read1 (readcharfun, &ch, first_in_list);
3339 UNGCPRO;
3341 first_in_list = 0;
3343 /* While building, if the list starts with #$, treat it specially. */
3344 if (EQ (elt, Vload_file_name)
3345 && ! NILP (elt)
3346 && !NILP (Vpurify_flag))
3348 if (NILP (Vdoc_file_name))
3349 /* We have not yet called Snarf-documentation, so assume
3350 this file is described in the DOC-MM.NN file
3351 and Snarf-documentation will fill in the right value later.
3352 For now, replace the whole list with 0. */
3353 doc_reference = 1;
3354 else
3355 /* We have already called Snarf-documentation, so make a relative
3356 file name for this file, so it can be found properly
3357 in the installed Lisp directory.
3358 We don't use Fexpand_file_name because that would make
3359 the directory absolute now. */
3360 elt = concat2 (build_string ("../lisp/"),
3361 Ffile_name_nondirectory (elt));
3363 else if (EQ (elt, Vload_file_name)
3364 && ! NILP (elt)
3365 && load_force_doc_strings)
3366 doc_reference = 2;
3368 if (ch)
3370 if (flag > 0)
3372 if (ch == ']')
3373 return val;
3374 invalid_syntax (") or . in a vector", 18);
3376 if (ch == ')')
3377 return val;
3378 if (ch == '.')
3380 GCPRO2 (val, tail);
3381 if (!NILP (tail))
3382 XSETCDR (tail, read0 (readcharfun));
3383 else
3384 val = read0 (readcharfun);
3385 read1 (readcharfun, &ch, 0);
3386 UNGCPRO;
3387 if (ch == ')')
3389 if (doc_reference == 1)
3390 return make_number (0);
3391 if (doc_reference == 2)
3393 /* Get a doc string from the file we are loading.
3394 If it's in saved_doc_string, get it from there.
3396 Here, we don't know if the string is a
3397 bytecode string or a doc string. As a
3398 bytecode string must be unibyte, we always
3399 return a unibyte string. If it is actually a
3400 doc string, caller must make it
3401 multibyte. */
3403 int pos = XINT (XCDR (val));
3404 /* Position is negative for user variables. */
3405 if (pos < 0) pos = -pos;
3406 if (pos >= saved_doc_string_position
3407 && pos < (saved_doc_string_position
3408 + saved_doc_string_length))
3410 int start = pos - saved_doc_string_position;
3411 int from, to;
3413 /* Process quoting with ^A,
3414 and find the end of the string,
3415 which is marked with ^_ (037). */
3416 for (from = start, to = start;
3417 saved_doc_string[from] != 037;)
3419 int c = saved_doc_string[from++];
3420 if (c == 1)
3422 c = saved_doc_string[from++];
3423 if (c == 1)
3424 saved_doc_string[to++] = c;
3425 else if (c == '0')
3426 saved_doc_string[to++] = 0;
3427 else if (c == '_')
3428 saved_doc_string[to++] = 037;
3430 else
3431 saved_doc_string[to++] = c;
3434 return make_unibyte_string (saved_doc_string + start,
3435 to - start);
3437 /* Look in prev_saved_doc_string the same way. */
3438 else if (pos >= prev_saved_doc_string_position
3439 && pos < (prev_saved_doc_string_position
3440 + prev_saved_doc_string_length))
3442 int start = pos - prev_saved_doc_string_position;
3443 int from, to;
3445 /* Process quoting with ^A,
3446 and find the end of the string,
3447 which is marked with ^_ (037). */
3448 for (from = start, to = start;
3449 prev_saved_doc_string[from] != 037;)
3451 int c = prev_saved_doc_string[from++];
3452 if (c == 1)
3454 c = prev_saved_doc_string[from++];
3455 if (c == 1)
3456 prev_saved_doc_string[to++] = c;
3457 else if (c == '0')
3458 prev_saved_doc_string[to++] = 0;
3459 else if (c == '_')
3460 prev_saved_doc_string[to++] = 037;
3462 else
3463 prev_saved_doc_string[to++] = c;
3466 return make_unibyte_string (prev_saved_doc_string
3467 + start,
3468 to - start);
3470 else
3471 return get_doc_string (val, 1, 0);
3474 return val;
3476 invalid_syntax (". in wrong context", 18);
3478 invalid_syntax ("] in a list", 11);
3480 tem = (read_pure && flag <= 0
3481 ? pure_cons (elt, Qnil)
3482 : Fcons (elt, Qnil));
3483 if (!NILP (tail))
3484 XSETCDR (tail, tem);
3485 else
3486 val = tem;
3487 tail = tem;
3488 if (defunflag < 0)
3489 defunflag = EQ (elt, Qdefun);
3490 else if (defunflag > 0)
3491 read_pure = 1;
3495 Lisp_Object Vobarray;
3496 Lisp_Object initial_obarray;
3498 /* oblookup stores the bucket number here, for the sake of Funintern. */
3500 int oblookup_last_bucket_number;
3502 static int hash_string ();
3504 /* Get an error if OBARRAY is not an obarray.
3505 If it is one, return it. */
3507 Lisp_Object
3508 check_obarray (obarray)
3509 Lisp_Object obarray;
3511 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3513 /* If Vobarray is now invalid, force it to be valid. */
3514 if (EQ (Vobarray, obarray)) Vobarray = initial_obarray;
3515 wrong_type_argument (Qvectorp, obarray);
3517 return obarray;
3520 /* Intern the C string STR: return a symbol with that name,
3521 interned in the current obarray. */
3523 Lisp_Object
3524 intern (str)
3525 const char *str;
3527 Lisp_Object tem;
3528 int len = strlen (str);
3529 Lisp_Object obarray;
3531 obarray = Vobarray;
3532 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3533 obarray = check_obarray (obarray);
3534 tem = oblookup (obarray, str, len, len);
3535 if (SYMBOLP (tem))
3536 return tem;
3537 return Fintern (make_string (str, len), obarray);
3540 /* Create an uninterned symbol with name STR. */
3542 Lisp_Object
3543 make_symbol (str)
3544 char *str;
3546 int len = strlen (str);
3548 return Fmake_symbol ((!NILP (Vpurify_flag)
3549 ? make_pure_string (str, len, len, 0)
3550 : make_string (str, len)));
3553 DEFUN ("intern", Fintern, Sintern, 1, 2, 0,
3554 doc: /* Return the canonical symbol whose name is STRING.
3555 If there is none, one is created by this function and returned.
3556 A second optional argument specifies the obarray to use;
3557 it defaults to the value of `obarray'. */)
3558 (string, obarray)
3559 Lisp_Object string, obarray;
3561 register Lisp_Object tem, sym, *ptr;
3563 if (NILP (obarray)) obarray = Vobarray;
3564 obarray = check_obarray (obarray);
3566 CHECK_STRING (string);
3568 tem = oblookup (obarray, SDATA (string),
3569 SCHARS (string),
3570 SBYTES (string));
3571 if (!INTEGERP (tem))
3572 return tem;
3574 if (!NILP (Vpurify_flag))
3575 string = Fpurecopy (string);
3576 sym = Fmake_symbol (string);
3578 if (EQ (obarray, initial_obarray))
3579 XSYMBOL (sym)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3580 else
3581 XSYMBOL (sym)->interned = SYMBOL_INTERNED;
3583 if ((SREF (string, 0) == ':')
3584 && EQ (obarray, initial_obarray))
3586 XSYMBOL (sym)->constant = 1;
3587 XSYMBOL (sym)->value = sym;
3590 ptr = &XVECTOR (obarray)->contents[XINT (tem)];
3591 if (SYMBOLP (*ptr))
3592 XSYMBOL (sym)->next = XSYMBOL (*ptr);
3593 else
3594 XSYMBOL (sym)->next = 0;
3595 *ptr = sym;
3596 return sym;
3599 DEFUN ("intern-soft", Fintern_soft, Sintern_soft, 1, 2, 0,
3600 doc: /* Return the canonical symbol named NAME, or nil if none exists.
3601 NAME may be a string or a symbol. If it is a symbol, that exact
3602 symbol is searched for.
3603 A second optional argument specifies the obarray to use;
3604 it defaults to the value of `obarray'. */)
3605 (name, obarray)
3606 Lisp_Object name, obarray;
3608 register Lisp_Object tem, string;
3610 if (NILP (obarray)) obarray = Vobarray;
3611 obarray = check_obarray (obarray);
3613 if (!SYMBOLP (name))
3615 CHECK_STRING (name);
3616 string = name;
3618 else
3619 string = SYMBOL_NAME (name);
3621 tem = oblookup (obarray, SDATA (string), SCHARS (string), SBYTES (string));
3622 if (INTEGERP (tem) || (SYMBOLP (name) && !EQ (name, tem)))
3623 return Qnil;
3624 else
3625 return tem;
3628 DEFUN ("unintern", Funintern, Sunintern, 1, 2, 0,
3629 doc: /* Delete the symbol named NAME, if any, from OBARRAY.
3630 The value is t if a symbol was found and deleted, nil otherwise.
3631 NAME may be a string or a symbol. If it is a symbol, that symbol
3632 is deleted, if it belongs to OBARRAY--no other symbol is deleted.
3633 OBARRAY defaults to the value of the variable `obarray'. */)
3634 (name, obarray)
3635 Lisp_Object name, obarray;
3637 register Lisp_Object string, tem;
3638 int hash;
3640 if (NILP (obarray)) obarray = Vobarray;
3641 obarray = check_obarray (obarray);
3643 if (SYMBOLP (name))
3644 string = SYMBOL_NAME (name);
3645 else
3647 CHECK_STRING (name);
3648 string = name;
3651 tem = oblookup (obarray, SDATA (string),
3652 SCHARS (string),
3653 SBYTES (string));
3654 if (INTEGERP (tem))
3655 return Qnil;
3656 /* If arg was a symbol, don't delete anything but that symbol itself. */
3657 if (SYMBOLP (name) && !EQ (name, tem))
3658 return Qnil;
3660 XSYMBOL (tem)->interned = SYMBOL_UNINTERNED;
3661 XSYMBOL (tem)->constant = 0;
3662 XSYMBOL (tem)->indirect_variable = 0;
3664 hash = oblookup_last_bucket_number;
3666 if (EQ (XVECTOR (obarray)->contents[hash], tem))
3668 if (XSYMBOL (tem)->next)
3669 XSETSYMBOL (XVECTOR (obarray)->contents[hash], XSYMBOL (tem)->next);
3670 else
3671 XSETINT (XVECTOR (obarray)->contents[hash], 0);
3673 else
3675 Lisp_Object tail, following;
3677 for (tail = XVECTOR (obarray)->contents[hash];
3678 XSYMBOL (tail)->next;
3679 tail = following)
3681 XSETSYMBOL (following, XSYMBOL (tail)->next);
3682 if (EQ (following, tem))
3684 XSYMBOL (tail)->next = XSYMBOL (following)->next;
3685 break;
3690 return Qt;
3693 /* Return the symbol in OBARRAY whose names matches the string
3694 of SIZE characters (SIZE_BYTE bytes) at PTR.
3695 If there is no such symbol in OBARRAY, return nil.
3697 Also store the bucket number in oblookup_last_bucket_number. */
3699 Lisp_Object
3700 oblookup (obarray, ptr, size, size_byte)
3701 Lisp_Object obarray;
3702 register const char *ptr;
3703 int size, size_byte;
3705 int hash;
3706 int obsize;
3707 register Lisp_Object tail;
3708 Lisp_Object bucket, tem;
3710 if (!VECTORP (obarray)
3711 || (obsize = XVECTOR (obarray)->size) == 0)
3713 obarray = check_obarray (obarray);
3714 obsize = XVECTOR (obarray)->size;
3716 /* This is sometimes needed in the middle of GC. */
3717 obsize &= ~ARRAY_MARK_FLAG;
3718 hash = hash_string (ptr, size_byte) % obsize;
3719 bucket = XVECTOR (obarray)->contents[hash];
3720 oblookup_last_bucket_number = hash;
3721 if (EQ (bucket, make_number (0)))
3723 else if (!SYMBOLP (bucket))
3724 error ("Bad data in guts of obarray"); /* Like CADR error message */
3725 else
3726 for (tail = bucket; ; XSETSYMBOL (tail, XSYMBOL (tail)->next))
3728 if (SBYTES (SYMBOL_NAME (tail)) == size_byte
3729 && SCHARS (SYMBOL_NAME (tail)) == size
3730 && !bcmp (SDATA (SYMBOL_NAME (tail)), ptr, size_byte))
3731 return tail;
3732 else if (XSYMBOL (tail)->next == 0)
3733 break;
3735 XSETINT (tem, hash);
3736 return tem;
3739 static int
3740 hash_string (ptr, len)
3741 const unsigned char *ptr;
3742 int len;
3744 register const unsigned char *p = ptr;
3745 register const unsigned char *end = p + len;
3746 register unsigned char c;
3747 register int hash = 0;
3749 while (p != end)
3751 c = *p++;
3752 if (c >= 0140) c -= 40;
3753 hash = ((hash<<3) + (hash>>28) + c);
3755 return hash & 07777777777;
3758 void
3759 map_obarray (obarray, fn, arg)
3760 Lisp_Object obarray;
3761 void (*fn) P_ ((Lisp_Object, Lisp_Object));
3762 Lisp_Object arg;
3764 register int i;
3765 register Lisp_Object tail;
3766 CHECK_VECTOR (obarray);
3767 for (i = XVECTOR (obarray)->size - 1; i >= 0; i--)
3769 tail = XVECTOR (obarray)->contents[i];
3770 if (SYMBOLP (tail))
3771 while (1)
3773 (*fn) (tail, arg);
3774 if (XSYMBOL (tail)->next == 0)
3775 break;
3776 XSETSYMBOL (tail, XSYMBOL (tail)->next);
3781 void
3782 mapatoms_1 (sym, function)
3783 Lisp_Object sym, function;
3785 call1 (function, sym);
3788 DEFUN ("mapatoms", Fmapatoms, Smapatoms, 1, 2, 0,
3789 doc: /* Call FUNCTION on every symbol in OBARRAY.
3790 OBARRAY defaults to the value of `obarray'. */)
3791 (function, obarray)
3792 Lisp_Object function, obarray;
3794 if (NILP (obarray)) obarray = Vobarray;
3795 obarray = check_obarray (obarray);
3797 map_obarray (obarray, mapatoms_1, function);
3798 return Qnil;
3801 #define OBARRAY_SIZE 1511
3803 void
3804 init_obarray ()
3806 Lisp_Object oblength;
3807 int hash;
3808 Lisp_Object *tem;
3810 XSETFASTINT (oblength, OBARRAY_SIZE);
3812 Qnil = Fmake_symbol (make_pure_string ("nil", 3, 3, 0));
3813 Vobarray = Fmake_vector (oblength, make_number (0));
3814 initial_obarray = Vobarray;
3815 staticpro (&initial_obarray);
3816 /* Intern nil in the obarray */
3817 XSYMBOL (Qnil)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3818 XSYMBOL (Qnil)->constant = 1;
3820 /* These locals are to kludge around a pyramid compiler bug. */
3821 hash = hash_string ("nil", 3);
3822 /* Separate statement here to avoid VAXC bug. */
3823 hash %= OBARRAY_SIZE;
3824 tem = &XVECTOR (Vobarray)->contents[hash];
3825 *tem = Qnil;
3827 Qunbound = Fmake_symbol (make_pure_string ("unbound", 7, 7, 0));
3828 XSYMBOL (Qnil)->function = Qunbound;
3829 XSYMBOL (Qunbound)->value = Qunbound;
3830 XSYMBOL (Qunbound)->function = Qunbound;
3832 Qt = intern ("t");
3833 XSYMBOL (Qnil)->value = Qnil;
3834 XSYMBOL (Qnil)->plist = Qnil;
3835 XSYMBOL (Qt)->value = Qt;
3836 XSYMBOL (Qt)->constant = 1;
3838 /* Qt is correct even if CANNOT_DUMP. loadup.el will set to nil at end. */
3839 Vpurify_flag = Qt;
3841 Qvariable_documentation = intern ("variable-documentation");
3842 staticpro (&Qvariable_documentation);
3844 read_buffer_size = 100 + MAX_MULTIBYTE_LENGTH;
3845 read_buffer = (char *) xmalloc (read_buffer_size);
3848 void
3849 defsubr (sname)
3850 struct Lisp_Subr *sname;
3852 Lisp_Object sym;
3853 sym = intern (sname->symbol_name);
3854 XSETPVECTYPE (sname, PVEC_SUBR);
3855 XSETSUBR (XSYMBOL (sym)->function, sname);
3858 #ifdef NOTDEF /* use fset in subr.el now */
3859 void
3860 defalias (sname, string)
3861 struct Lisp_Subr *sname;
3862 char *string;
3864 Lisp_Object sym;
3865 sym = intern (string);
3866 XSETSUBR (XSYMBOL (sym)->function, sname);
3868 #endif /* NOTDEF */
3870 /* Define an "integer variable"; a symbol whose value is forwarded
3871 to a C variable of type int. Sample call:
3872 DEFVAR_INT ("emacs-priority", &emacs_priority, "Documentation"); */
3873 void
3874 defvar_int (namestring, address)
3875 char *namestring;
3876 EMACS_INT *address;
3878 Lisp_Object sym, val;
3879 sym = intern (namestring);
3880 val = allocate_misc ();
3881 XMISCTYPE (val) = Lisp_Misc_Intfwd;
3882 XINTFWD (val)->intvar = address;
3883 SET_SYMBOL_VALUE (sym, val);
3886 /* Similar but define a variable whose value is t if address contains 1,
3887 nil if address contains 0. */
3888 void
3889 defvar_bool (namestring, address)
3890 char *namestring;
3891 int *address;
3893 Lisp_Object sym, val;
3894 sym = intern (namestring);
3895 val = allocate_misc ();
3896 XMISCTYPE (val) = Lisp_Misc_Boolfwd;
3897 XBOOLFWD (val)->boolvar = address;
3898 SET_SYMBOL_VALUE (sym, val);
3899 Vbyte_boolean_vars = Fcons (sym, Vbyte_boolean_vars);
3902 /* Similar but define a variable whose value is the Lisp Object stored
3903 at address. Two versions: with and without gc-marking of the C
3904 variable. The nopro version is used when that variable will be
3905 gc-marked for some other reason, since marking the same slot twice
3906 can cause trouble with strings. */
3907 void
3908 defvar_lisp_nopro (namestring, address)
3909 char *namestring;
3910 Lisp_Object *address;
3912 Lisp_Object sym, val;
3913 sym = intern (namestring);
3914 val = allocate_misc ();
3915 XMISCTYPE (val) = Lisp_Misc_Objfwd;
3916 XOBJFWD (val)->objvar = address;
3917 SET_SYMBOL_VALUE (sym, val);
3920 void
3921 defvar_lisp (namestring, address)
3922 char *namestring;
3923 Lisp_Object *address;
3925 defvar_lisp_nopro (namestring, address);
3926 staticpro (address);
3929 /* Similar but define a variable whose value is the Lisp Object stored
3930 at a particular offset in the current kboard object. */
3932 void
3933 defvar_kboard (namestring, offset)
3934 char *namestring;
3935 int offset;
3937 Lisp_Object sym, val;
3938 sym = intern (namestring);
3939 val = allocate_misc ();
3940 XMISCTYPE (val) = Lisp_Misc_Kboard_Objfwd;
3941 XKBOARD_OBJFWD (val)->offset = offset;
3942 SET_SYMBOL_VALUE (sym, val);
3945 /* Record the value of load-path used at the start of dumping
3946 so we can see if the site changed it later during dumping. */
3947 static Lisp_Object dump_path;
3949 void
3950 init_lread ()
3952 char *normal;
3953 int turn_off_warning = 0;
3955 /* Compute the default load-path. */
3956 #ifdef CANNOT_DUMP
3957 normal = PATH_LOADSEARCH;
3958 Vload_path = decode_env_path (0, normal);
3959 #else
3960 if (NILP (Vpurify_flag))
3961 normal = PATH_LOADSEARCH;
3962 else
3963 normal = PATH_DUMPLOADSEARCH;
3965 /* In a dumped Emacs, we normally have to reset the value of
3966 Vload_path from PATH_LOADSEARCH, since the value that was dumped
3967 uses ../lisp, instead of the path of the installed elisp
3968 libraries. However, if it appears that Vload_path was changed
3969 from the default before dumping, don't override that value. */
3970 if (initialized)
3972 if (! NILP (Fequal (dump_path, Vload_path)))
3974 Vload_path = decode_env_path (0, normal);
3975 if (!NILP (Vinstallation_directory))
3977 Lisp_Object tem, tem1, sitelisp;
3979 /* Remove site-lisp dirs from path temporarily and store
3980 them in sitelisp, then conc them on at the end so
3981 they're always first in path. */
3982 sitelisp = Qnil;
3983 while (1)
3985 tem = Fcar (Vload_path);
3986 tem1 = Fstring_match (build_string ("site-lisp"),
3987 tem, Qnil);
3988 if (!NILP (tem1))
3990 Vload_path = Fcdr (Vload_path);
3991 sitelisp = Fcons (tem, sitelisp);
3993 else
3994 break;
3997 /* Add to the path the lisp subdir of the
3998 installation dir, if it exists. */
3999 tem = Fexpand_file_name (build_string ("lisp"),
4000 Vinstallation_directory);
4001 tem1 = Ffile_exists_p (tem);
4002 if (!NILP (tem1))
4004 if (NILP (Fmember (tem, Vload_path)))
4006 turn_off_warning = 1;
4007 Vload_path = Fcons (tem, Vload_path);
4010 else
4011 /* That dir doesn't exist, so add the build-time
4012 Lisp dirs instead. */
4013 Vload_path = nconc2 (Vload_path, dump_path);
4015 /* Add leim under the installation dir, if it exists. */
4016 tem = Fexpand_file_name (build_string ("leim"),
4017 Vinstallation_directory);
4018 tem1 = Ffile_exists_p (tem);
4019 if (!NILP (tem1))
4021 if (NILP (Fmember (tem, Vload_path)))
4022 Vload_path = Fcons (tem, Vload_path);
4025 /* Add site-lisp under the installation dir, if it exists. */
4026 tem = Fexpand_file_name (build_string ("site-lisp"),
4027 Vinstallation_directory);
4028 tem1 = Ffile_exists_p (tem);
4029 if (!NILP (tem1))
4031 if (NILP (Fmember (tem, Vload_path)))
4032 Vload_path = Fcons (tem, Vload_path);
4035 /* If Emacs was not built in the source directory,
4036 and it is run from where it was built, add to load-path
4037 the lisp, leim and site-lisp dirs under that directory. */
4039 if (NILP (Fequal (Vinstallation_directory, Vsource_directory)))
4041 Lisp_Object tem2;
4043 tem = Fexpand_file_name (build_string ("src/Makefile"),
4044 Vinstallation_directory);
4045 tem1 = Ffile_exists_p (tem);
4047 /* Don't be fooled if they moved the entire source tree
4048 AFTER dumping Emacs. If the build directory is indeed
4049 different from the source dir, src/Makefile.in and
4050 src/Makefile will not be found together. */
4051 tem = Fexpand_file_name (build_string ("src/Makefile.in"),
4052 Vinstallation_directory);
4053 tem2 = Ffile_exists_p (tem);
4054 if (!NILP (tem1) && NILP (tem2))
4056 tem = Fexpand_file_name (build_string ("lisp"),
4057 Vsource_directory);
4059 if (NILP (Fmember (tem, Vload_path)))
4060 Vload_path = Fcons (tem, Vload_path);
4062 tem = Fexpand_file_name (build_string ("leim"),
4063 Vsource_directory);
4065 if (NILP (Fmember (tem, Vload_path)))
4066 Vload_path = Fcons (tem, Vload_path);
4068 tem = Fexpand_file_name (build_string ("site-lisp"),
4069 Vsource_directory);
4071 if (NILP (Fmember (tem, Vload_path)))
4072 Vload_path = Fcons (tem, Vload_path);
4075 if (!NILP (sitelisp))
4076 Vload_path = nconc2 (Fnreverse (sitelisp), Vload_path);
4080 else
4082 /* NORMAL refers to the lisp dir in the source directory. */
4083 /* We used to add ../lisp at the front here, but
4084 that caused trouble because it was copied from dump_path
4085 into Vload_path, above, when Vinstallation_directory was non-nil.
4086 It should be unnecessary. */
4087 Vload_path = decode_env_path (0, normal);
4088 dump_path = Vload_path;
4090 #endif
4092 #if (!(defined(WINDOWSNT) || (defined(HAVE_NS))))
4093 /* When Emacs is invoked over network shares on NT, PATH_LOADSEARCH is
4094 almost never correct, thereby causing a warning to be printed out that
4095 confuses users. Since PATH_LOADSEARCH is always overridden by the
4096 EMACSLOADPATH environment variable below, disable the warning on NT. */
4098 /* Warn if dirs in the *standard* path don't exist. */
4099 if (!turn_off_warning)
4101 Lisp_Object path_tail;
4103 for (path_tail = Vload_path;
4104 !NILP (path_tail);
4105 path_tail = XCDR (path_tail))
4107 Lisp_Object dirfile;
4108 dirfile = Fcar (path_tail);
4109 if (STRINGP (dirfile))
4111 dirfile = Fdirectory_file_name (dirfile);
4112 if (access (SDATA (dirfile), 0) < 0)
4113 dir_warning ("Warning: Lisp directory `%s' does not exist.\n",
4114 XCAR (path_tail));
4118 #endif /* !(WINDOWSNT || HAVE_NS) */
4120 /* If the EMACSLOADPATH environment variable is set, use its value.
4121 This doesn't apply if we're dumping. */
4122 #ifndef CANNOT_DUMP
4123 if (NILP (Vpurify_flag)
4124 && egetenv ("EMACSLOADPATH"))
4125 #endif
4126 Vload_path = decode_env_path ("EMACSLOADPATH", normal);
4128 Vvalues = Qnil;
4130 load_in_progress = 0;
4131 Vload_file_name = Qnil;
4133 load_descriptor_list = Qnil;
4135 Vstandard_input = Qt;
4136 Vloads_in_progress = Qnil;
4139 /* Print a warning, using format string FORMAT, that directory DIRNAME
4140 does not exist. Print it on stderr and put it in *Messages*. */
4142 void
4143 dir_warning (format, dirname)
4144 char *format;
4145 Lisp_Object dirname;
4147 char *buffer
4148 = (char *) alloca (SCHARS (dirname) + strlen (format) + 5);
4150 fprintf (stderr, format, SDATA (dirname));
4151 sprintf (buffer, format, SDATA (dirname));
4152 /* Don't log the warning before we've initialized!! */
4153 if (initialized)
4154 message_dolog (buffer, strlen (buffer), 0, STRING_MULTIBYTE (dirname));
4157 void
4158 syms_of_lread ()
4160 defsubr (&Sread);
4161 defsubr (&Sread_from_string);
4162 defsubr (&Sintern);
4163 defsubr (&Sintern_soft);
4164 defsubr (&Sunintern);
4165 defsubr (&Sget_load_suffixes);
4166 defsubr (&Sload);
4167 defsubr (&Seval_buffer);
4168 defsubr (&Seval_region);
4169 defsubr (&Sread_char);
4170 defsubr (&Sread_char_exclusive);
4171 defsubr (&Sread_event);
4172 defsubr (&Sget_file_char);
4173 defsubr (&Smapatoms);
4174 defsubr (&Slocate_file_internal);
4176 DEFVAR_LISP ("obarray", &Vobarray,
4177 doc: /* Symbol table for use by `intern' and `read'.
4178 It is a vector whose length ought to be prime for best results.
4179 The vector's contents don't make sense if examined from Lisp programs;
4180 to find all the symbols in an obarray, use `mapatoms'. */);
4182 DEFVAR_LISP ("values", &Vvalues,
4183 doc: /* List of values of all expressions which were read, evaluated and printed.
4184 Order is reverse chronological. */);
4186 DEFVAR_LISP ("standard-input", &Vstandard_input,
4187 doc: /* Stream for read to get input from.
4188 See documentation of `read' for possible values. */);
4189 Vstandard_input = Qt;
4191 DEFVAR_LISP ("read-with-symbol-positions", &Vread_with_symbol_positions,
4192 doc: /* If non-nil, add position of read symbols to `read-symbol-positions-list'.
4194 If this variable is a buffer, then only forms read from that buffer
4195 will be added to `read-symbol-positions-list'.
4196 If this variable is t, then all read forms will be added.
4197 The effect of all other values other than nil are not currently
4198 defined, although they may be in the future.
4200 The positions are relative to the last call to `read' or
4201 `read-from-string'. It is probably a bad idea to set this variable at
4202 the toplevel; bind it instead. */);
4203 Vread_with_symbol_positions = Qnil;
4205 DEFVAR_LISP ("read-symbol-positions-list", &Vread_symbol_positions_list,
4206 doc: /* A list mapping read symbols to their positions.
4207 This variable is modified during calls to `read' or
4208 `read-from-string', but only when `read-with-symbol-positions' is
4209 non-nil.
4211 Each element of the list looks like (SYMBOL . CHAR-POSITION), where
4212 CHAR-POSITION is an integer giving the offset of that occurrence of the
4213 symbol from the position where `read' or `read-from-string' started.
4215 Note that a symbol will appear multiple times in this list, if it was
4216 read multiple times. The list is in the same order as the symbols
4217 were read in. */);
4218 Vread_symbol_positions_list = Qnil;
4220 DEFVAR_LISP ("load-path", &Vload_path,
4221 doc: /* *List of directories to search for files to load.
4222 Each element is a string (directory name) or nil (try default directory).
4223 Initialized based on EMACSLOADPATH environment variable, if any,
4224 otherwise to default specified by file `epaths.h' when Emacs was built. */);
4226 DEFVAR_LISP ("load-suffixes", &Vload_suffixes,
4227 doc: /* List of suffixes for (compiled or source) Emacs Lisp files.
4228 This list should not include the empty string.
4229 `load' and related functions try to append these suffixes, in order,
4230 to the specified file name if a Lisp suffix is allowed or required. */);
4231 Vload_suffixes = Fcons (build_string (".elc"),
4232 Fcons (build_string (".el"), Qnil));
4233 DEFVAR_LISP ("load-file-rep-suffixes", &Vload_file_rep_suffixes,
4234 doc: /* List of suffixes that indicate representations of \
4235 the same file.
4236 This list should normally start with the empty string.
4238 Enabling Auto Compression mode appends the suffixes in
4239 `jka-compr-load-suffixes' to this list and disabling Auto Compression
4240 mode removes them again. `load' and related functions use this list to
4241 determine whether they should look for compressed versions of a file
4242 and, if so, which suffixes they should try to append to the file name
4243 in order to do so. However, if you want to customize which suffixes
4244 the loading functions recognize as compression suffixes, you should
4245 customize `jka-compr-load-suffixes' rather than the present variable. */);
4246 Vload_file_rep_suffixes = Fcons (empty_unibyte_string, Qnil);
4248 DEFVAR_BOOL ("load-in-progress", &load_in_progress,
4249 doc: /* Non-nil if inside of `load'. */);
4251 DEFVAR_LISP ("after-load-alist", &Vafter_load_alist,
4252 doc: /* An alist of expressions to be evalled when particular files are loaded.
4253 Each element looks like (REGEXP-OR-FEATURE FORMS...).
4255 REGEXP-OR-FEATURE is either a regular expression to match file names, or
4256 a symbol \(a feature name).
4258 When `load' is run and the file-name argument matches an element's
4259 REGEXP-OR-FEATURE, or when `provide' is run and provides the symbol
4260 REGEXP-OR-FEATURE, the FORMS in the element are executed.
4262 An error in FORMS does not undo the load, but does prevent execution of
4263 the rest of the FORMS. */);
4264 Vafter_load_alist = Qnil;
4266 DEFVAR_LISP ("load-history", &Vload_history,
4267 doc: /* Alist mapping file names to symbols and features.
4268 Each alist element is a list that starts with a file name,
4269 except for one element (optional) that starts with nil and describes
4270 definitions evaluated from buffers not visiting files.
4272 The file name is absolute and is the true file name (i.e. it doesn't
4273 contain symbolic links) of the loaded file.
4275 The remaining elements of each list are symbols defined as variables
4276 and cons cells of the form `(provide . FEATURE)', `(require . FEATURE)',
4277 `(defun . FUNCTION)', `(autoload . SYMBOL)', `(defface . SYMBOL)'
4278 and `(t . SYMBOL)'. An element `(t . SYMBOL)' precedes an entry
4279 `(defun . FUNCTION)', and means that SYMBOL was an autoload before
4280 this file redefined it as a function.
4282 During preloading, the file name recorded is relative to the main Lisp
4283 directory. These file names are converted to absolute at startup. */);
4284 Vload_history = Qnil;
4286 DEFVAR_LISP ("load-file-name", &Vload_file_name,
4287 doc: /* Full name of file being loaded by `load'. */);
4288 Vload_file_name = Qnil;
4290 DEFVAR_LISP ("user-init-file", &Vuser_init_file,
4291 doc: /* File name, including directory, of user's initialization file.
4292 If the file loaded had extension `.elc', and the corresponding source file
4293 exists, this variable contains the name of source file, suitable for use
4294 by functions like `custom-save-all' which edit the init file.
4295 While Emacs loads and evaluates the init file, value is the real name
4296 of the file, regardless of whether or not it has the `.elc' extension. */);
4297 Vuser_init_file = Qnil;
4299 DEFVAR_LISP ("current-load-list", &Vcurrent_load_list,
4300 doc: /* Used for internal purposes by `load'. */);
4301 Vcurrent_load_list = Qnil;
4303 DEFVAR_LISP ("load-read-function", &Vload_read_function,
4304 doc: /* Function used by `load' and `eval-region' for reading expressions.
4305 The default is nil, which means use the function `read'. */);
4306 Vload_read_function = Qnil;
4308 DEFVAR_LISP ("load-source-file-function", &Vload_source_file_function,
4309 doc: /* Function called in `load' for loading an Emacs Lisp source file.
4310 This function is for doing code conversion before reading the source file.
4311 If nil, loading is done without any code conversion.
4312 Arguments are FULLNAME, FILE, NOERROR, NOMESSAGE, where
4313 FULLNAME is the full name of FILE.
4314 See `load' for the meaning of the remaining arguments. */);
4315 Vload_source_file_function = Qnil;
4317 DEFVAR_BOOL ("load-force-doc-strings", &load_force_doc_strings,
4318 doc: /* Non-nil means `load' should force-load all dynamic doc strings.
4319 This is useful when the file being loaded is a temporary copy. */);
4320 load_force_doc_strings = 0;
4322 DEFVAR_BOOL ("load-convert-to-unibyte", &load_convert_to_unibyte,
4323 doc: /* Non-nil means `read' converts strings to unibyte whenever possible.
4324 This is normally bound by `load' and `eval-buffer' to control `read',
4325 and is not meant for users to change. */);
4326 load_convert_to_unibyte = 0;
4328 DEFVAR_LISP ("source-directory", &Vsource_directory,
4329 doc: /* Directory in which Emacs sources were found when Emacs was built.
4330 You cannot count on them to still be there! */);
4331 Vsource_directory
4332 = Fexpand_file_name (build_string ("../"),
4333 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH)));
4335 DEFVAR_LISP ("preloaded-file-list", &Vpreloaded_file_list,
4336 doc: /* List of files that were preloaded (when dumping Emacs). */);
4337 Vpreloaded_file_list = Qnil;
4339 DEFVAR_LISP ("byte-boolean-vars", &Vbyte_boolean_vars,
4340 doc: /* List of all DEFVAR_BOOL variables, used by the byte code optimizer. */);
4341 Vbyte_boolean_vars = Qnil;
4343 DEFVAR_BOOL ("load-dangerous-libraries", &load_dangerous_libraries,
4344 doc: /* Non-nil means load dangerous compiled Lisp files.
4345 Some versions of XEmacs use different byte codes than Emacs. These
4346 incompatible byte codes can make Emacs crash when it tries to execute
4347 them. */);
4348 load_dangerous_libraries = 0;
4350 DEFVAR_LISP ("bytecomp-version-regexp", &Vbytecomp_version_regexp,
4351 doc: /* Regular expression matching safe to load compiled Lisp files.
4352 When Emacs loads a compiled Lisp file, it reads the first 512 bytes
4353 from the file, and matches them against this regular expression.
4354 When the regular expression matches, the file is considered to be safe
4355 to load. See also `load-dangerous-libraries'. */);
4356 Vbytecomp_version_regexp
4357 = build_string ("^;;;.\\(in Emacs version\\|bytecomp version FSF\\)");
4359 DEFVAR_LISP ("eval-buffer-list", &Veval_buffer_list,
4360 doc: /* List of buffers being read from by calls to `eval-buffer' and `eval-region'. */);
4361 Veval_buffer_list = Qnil;
4363 DEFVAR_LISP ("old-style-backquotes", &Vold_style_backquotes,
4364 doc: /* Set to non-nil when `read' encounters an old-style backquote. */);
4365 Vold_style_backquotes = Qnil;
4366 Qold_style_backquotes = intern ("old-style-backquotes");
4367 staticpro (&Qold_style_backquotes);
4369 /* Vsource_directory was initialized in init_lread. */
4371 load_descriptor_list = Qnil;
4372 staticpro (&load_descriptor_list);
4374 Qcurrent_load_list = intern ("current-load-list");
4375 staticpro (&Qcurrent_load_list);
4377 Qstandard_input = intern ("standard-input");
4378 staticpro (&Qstandard_input);
4380 Qread_char = intern ("read-char");
4381 staticpro (&Qread_char);
4383 Qget_file_char = intern ("get-file-char");
4384 staticpro (&Qget_file_char);
4386 Qget_emacs_mule_file_char = intern ("get-emacs-mule-file-char");
4387 staticpro (&Qget_emacs_mule_file_char);
4389 Qload_force_doc_strings = intern ("load-force-doc-strings");
4390 staticpro (&Qload_force_doc_strings);
4392 Qbackquote = intern ("`");
4393 staticpro (&Qbackquote);
4394 Qcomma = intern (",");
4395 staticpro (&Qcomma);
4396 Qcomma_at = intern (",@");
4397 staticpro (&Qcomma_at);
4398 Qcomma_dot = intern (",.");
4399 staticpro (&Qcomma_dot);
4401 Qinhibit_file_name_operation = intern ("inhibit-file-name-operation");
4402 staticpro (&Qinhibit_file_name_operation);
4404 Qascii_character = intern ("ascii-character");
4405 staticpro (&Qascii_character);
4407 Qfunction = intern ("function");
4408 staticpro (&Qfunction);
4410 Qload = intern ("load");
4411 staticpro (&Qload);
4413 Qload_file_name = intern ("load-file-name");
4414 staticpro (&Qload_file_name);
4416 Qeval_buffer_list = intern ("eval-buffer-list");
4417 staticpro (&Qeval_buffer_list);
4419 Qfile_truename = intern ("file-truename");
4420 staticpro (&Qfile_truename) ;
4422 Qdo_after_load_evaluation = intern ("do-after-load-evaluation");
4423 staticpro (&Qdo_after_load_evaluation) ;
4425 staticpro (&dump_path);
4427 staticpro (&read_objects);
4428 read_objects = Qnil;
4429 staticpro (&seen_list);
4430 seen_list = Qnil;
4432 Vloads_in_progress = Qnil;
4433 staticpro (&Vloads_in_progress);
4436 /* arch-tag: a0d02733-0f96-4844-a659-9fd53c4f414d
4437 (do not change this comment) */