(tramp-drop-volume-letter): Move definition before use.
[emacs.git] / src / lread.c
blob77c7a3c875fd66995d7d3ef36ac7fb039614d57a
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 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, or (at your option)
11 any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs; see the file COPYING. If not, write to
20 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA. */
24 #include <config.h>
25 #include <stdio.h>
26 #include <sys/types.h>
27 #include <sys/stat.h>
28 #include <sys/file.h>
29 #include <errno.h>
30 #include <setjmp.h>
31 #include "lisp.h"
32 #include "intervals.h"
33 #include "buffer.h"
34 #include "character.h"
35 #include "charset.h"
36 #include "coding.h"
37 #include <epaths.h>
38 #include "commands.h"
39 #include "keyboard.h"
40 #include "frame.h"
41 #include "termhooks.h"
42 #include "coding.h"
43 #include "blockinput.h"
45 #ifdef MSDOS
46 #if __DJGPP__ < 2
47 #include <unistd.h> /* to get X_OK */
48 #endif
49 #include "msdos.h"
50 #endif
52 #ifdef HAVE_UNISTD_H
53 #include <unistd.h>
54 #endif
56 #ifndef X_OK
57 #define X_OK 01
58 #endif
60 #include <math.h>
62 #ifdef HAVE_SETLOCALE
63 #include <locale.h>
64 #endif /* HAVE_SETLOCALE */
66 #ifdef HAVE_FCNTL_H
67 #include <fcntl.h>
68 #endif
69 #ifndef O_RDONLY
70 #define O_RDONLY 0
71 #endif
73 #ifdef HAVE_FSEEKO
74 #define file_offset off_t
75 #define file_tell ftello
76 #else
77 #define file_offset long
78 #define file_tell ftell
79 #endif
81 #ifndef USE_CRT_DLL
82 extern int errno;
83 #endif
85 Lisp_Object Qread_char, Qget_file_char, Qstandard_input, Qcurrent_load_list;
86 Lisp_Object Qvariable_documentation, Vvalues, Vstandard_input, Vafter_load_alist;
87 Lisp_Object Qascii_character, Qload, Qload_file_name;
88 Lisp_Object Qbackquote, Qcomma, Qcomma_at, Qcomma_dot, Qfunction;
89 Lisp_Object Qinhibit_file_name_operation;
90 Lisp_Object Qeval_buffer_list, Veval_buffer_list;
91 Lisp_Object Qfile_truename, Qdo_after_load_evaluation; /* ACM 2006/5/16 */
93 /* Used instead of Qget_file_char while loading *.elc files compiled
94 by Emacs 21 or older. */
95 static Lisp_Object Qget_emacs_mule_file_char;
97 static Lisp_Object Qload_force_doc_strings;
99 extern Lisp_Object Qevent_symbol_element_mask;
100 extern Lisp_Object Qfile_exists_p;
102 /* non-zero if inside `load' */
103 int load_in_progress;
105 /* Directory in which the sources were found. */
106 Lisp_Object Vsource_directory;
108 /* Search path and suffixes for files to be loaded. */
109 Lisp_Object Vload_path, Vload_suffixes, Vload_file_rep_suffixes;
111 /* File name of user's init file. */
112 Lisp_Object Vuser_init_file;
114 /* This is the user-visible association list that maps features to
115 lists of defs in their load files. */
116 Lisp_Object Vload_history;
118 /* This is used to build the load history. */
119 Lisp_Object Vcurrent_load_list;
121 /* List of files that were preloaded. */
122 Lisp_Object Vpreloaded_file_list;
124 /* Name of file actually being read by `load'. */
125 Lisp_Object Vload_file_name;
127 /* Function to use for reading, in `load' and friends. */
128 Lisp_Object Vload_read_function;
130 /* The association list of objects read with the #n=object form.
131 Each member of the list has the form (n . object), and is used to
132 look up the object for the corresponding #n# construct.
133 It must be set to nil before all top-level calls to read0. */
134 Lisp_Object read_objects;
136 /* Nonzero means load should forcibly load all dynamic doc strings. */
137 static int load_force_doc_strings;
139 /* Nonzero means read should convert strings to unibyte. */
140 static int load_convert_to_unibyte;
142 /* Nonzero means READCHAR should read bytes one by one (not character)
143 when READCHARFUN is Qget_file_char or Qget_emacs_mule_file_char.
144 This is set to 1 by read1 temporarily while handling #@NUMBER. */
145 static int load_each_byte;
147 /* Function to use for loading an Emacs Lisp source file (not
148 compiled) instead of readevalloop. */
149 Lisp_Object Vload_source_file_function;
151 /* List of all DEFVAR_BOOL variables. Used by the byte optimizer. */
152 Lisp_Object Vbyte_boolean_vars;
154 /* Whether or not to add a `read-positions' property to symbols
155 read. */
156 Lisp_Object Vread_with_symbol_positions;
158 /* List of (SYMBOL . POSITION) accumulated so far. */
159 Lisp_Object Vread_symbol_positions_list;
161 /* List of descriptors now open for Fload. */
162 static Lisp_Object load_descriptor_list;
164 /* File for get_file_char to read from. Use by load. */
165 static FILE *instream;
167 /* When nonzero, read conses in pure space */
168 static int read_pure;
170 /* For use within read-from-string (this reader is non-reentrant!!) */
171 static int read_from_string_index;
172 static int read_from_string_index_byte;
173 static int read_from_string_limit;
175 /* Number of characters read in the current call to Fread or
176 Fread_from_string. */
177 static int readchar_count;
179 /* This contains the last string skipped with #@. */
180 static char *saved_doc_string;
181 /* Length of buffer allocated in saved_doc_string. */
182 static int saved_doc_string_size;
183 /* Length of actual data in saved_doc_string. */
184 static int saved_doc_string_length;
185 /* This is the file position that string came from. */
186 static file_offset saved_doc_string_position;
188 /* This contains the previous string skipped with #@.
189 We copy it from saved_doc_string when a new string
190 is put in saved_doc_string. */
191 static char *prev_saved_doc_string;
192 /* Length of buffer allocated in prev_saved_doc_string. */
193 static int prev_saved_doc_string_size;
194 /* Length of actual data in prev_saved_doc_string. */
195 static int prev_saved_doc_string_length;
196 /* This is the file position that string came from. */
197 static file_offset prev_saved_doc_string_position;
199 /* Nonzero means inside a new-style backquote
200 with no surrounding parentheses.
201 Fread initializes this to zero, so we need not specbind it
202 or worry about what happens to it when there is an error. */
203 static int new_backquote_flag;
204 static Lisp_Object Vold_style_backquotes, Qold_style_backquotes;
206 /* A list of file names for files being loaded in Fload. Used to
207 check for recursive loads. */
209 static Lisp_Object Vloads_in_progress;
211 /* Non-zero means load dangerous compiled Lisp files. */
213 int load_dangerous_libraries;
215 /* A regular expression used to detect files compiled with Emacs. */
217 static Lisp_Object Vbytecomp_version_regexp;
219 static int read_emacs_mule_char P_ ((int, int (*) (int, Lisp_Object),
220 Lisp_Object));
222 static void readevalloop P_ ((Lisp_Object, FILE*, Lisp_Object,
223 Lisp_Object (*) (), int,
224 Lisp_Object, Lisp_Object,
225 Lisp_Object, Lisp_Object));
226 static Lisp_Object load_unwind P_ ((Lisp_Object));
227 static Lisp_Object load_descriptor_unwind P_ ((Lisp_Object));
229 static void invalid_syntax P_ ((const char *, int)) NO_RETURN;
230 static void end_of_file_error P_ (()) NO_RETURN;
233 /* Functions that read one byte from the current source READCHARFUN
234 or unreads one byte. If the integer argument C is -1, it returns
235 one read byte, or -1 when there's no more byte in the source. If C
236 is 0 or positive, it unreads C, and the return value is not
237 interesting. */
239 static int readbyte_for_lambda P_ ((int, Lisp_Object));
240 static int readbyte_from_file P_ ((int, Lisp_Object));
241 static int readbyte_from_string P_ ((int, Lisp_Object));
243 /* Handle unreading and rereading of characters.
244 Write READCHAR to read a character,
245 UNREAD(c) to unread c to be read again.
247 These macros correctly read/unread multibyte characters. */
249 #define READCHAR readchar (readcharfun, NULL)
250 #define UNREAD(c) unreadchar (readcharfun, c)
252 /* Same as READCHAR but set *MULTIBYTE to the multibyteness of the source. */
253 #define READCHAR_REPORT_MULTIBYTE(multibyte) readchar (readcharfun, multibyte)
255 /* When READCHARFUN is Qget_file_char, Qget_emacs_mule_file_char,
256 Qlambda, or a cons, we use this to keep an unread character because
257 a file stream can't handle multibyte-char unreading. The value -1
258 means that there's no unread character. */
259 static int unread_char;
261 static int
262 readchar (readcharfun, multibyte)
263 Lisp_Object readcharfun;
264 int *multibyte;
266 Lisp_Object tem;
267 register int c;
268 int (*readbyte) P_ ((int, Lisp_Object));
269 unsigned char buf[MAX_MULTIBYTE_LENGTH];
270 int i, len;
271 int emacs_mule_encoding = 0;
273 if (multibyte)
274 *multibyte = 0;
276 readchar_count++;
278 if (BUFFERP (readcharfun))
280 register struct buffer *inbuffer = XBUFFER (readcharfun);
282 int pt_byte = BUF_PT_BYTE (inbuffer);
284 if (pt_byte >= BUF_ZV_BYTE (inbuffer))
285 return -1;
287 if (! NILP (inbuffer->enable_multibyte_characters))
289 /* Fetch the character code from the buffer. */
290 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, pt_byte);
291 BUF_INC_POS (inbuffer, pt_byte);
292 c = STRING_CHAR (p, pt_byte - orig_pt_byte);
293 if (multibyte)
294 *multibyte = 1;
296 else
298 c = BUF_FETCH_BYTE (inbuffer, pt_byte);
299 if (! ASCII_BYTE_P (c))
300 c = BYTE8_TO_CHAR (c);
301 pt_byte++;
303 SET_BUF_PT_BOTH (inbuffer, BUF_PT (inbuffer) + 1, pt_byte);
305 return c;
307 if (MARKERP (readcharfun))
309 register struct buffer *inbuffer = XMARKER (readcharfun)->buffer;
311 int bytepos = marker_byte_position (readcharfun);
313 if (bytepos >= BUF_ZV_BYTE (inbuffer))
314 return -1;
316 if (! NILP (inbuffer->enable_multibyte_characters))
318 /* Fetch the character code from the buffer. */
319 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, bytepos);
320 BUF_INC_POS (inbuffer, bytepos);
321 c = STRING_CHAR (p, bytepos - orig_bytepos);
322 if (multibyte)
323 *multibyte = 1;
325 else
327 c = BUF_FETCH_BYTE (inbuffer, bytepos);
328 if (! ASCII_BYTE_P (c))
329 c = BYTE8_TO_CHAR (c);
330 bytepos++;
333 XMARKER (readcharfun)->bytepos = bytepos;
334 XMARKER (readcharfun)->charpos++;
336 return c;
339 if (EQ (readcharfun, Qlambda))
341 readbyte = readbyte_for_lambda;
342 goto read_multibyte;
345 if (EQ (readcharfun, Qget_file_char))
347 readbyte = readbyte_from_file;
348 goto read_multibyte;
351 if (STRINGP (readcharfun))
353 if (read_from_string_index >= read_from_string_limit)
354 c = -1;
355 else if (STRING_MULTIBYTE (readcharfun))
357 if (multibyte)
358 *multibyte = 1;
359 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c, readcharfun,
360 read_from_string_index,
361 read_from_string_index_byte);
363 else
365 c = SREF (readcharfun, read_from_string_index_byte);
366 read_from_string_index++;
367 read_from_string_index_byte++;
369 return c;
372 if (CONSP (readcharfun))
374 /* This is the case that read_vector is reading from a unibyte
375 string that contains a byte sequence previously skipped
376 because of #@NUMBER. The car part of readcharfun is that
377 string, and the cdr part is a value of readcharfun given to
378 read_vector. */
379 readbyte = readbyte_from_string;
380 if (EQ (XCDR (readcharfun), Qget_emacs_mule_file_char))
381 emacs_mule_encoding = 1;
382 goto read_multibyte;
385 if (EQ (readcharfun, Qget_emacs_mule_file_char))
387 readbyte = readbyte_from_file;
388 emacs_mule_encoding = 1;
389 goto read_multibyte;
392 tem = call0 (readcharfun);
394 if (NILP (tem))
395 return -1;
396 return XINT (tem);
398 read_multibyte:
399 if (unread_char >= 0)
401 c = unread_char;
402 unread_char = -1;
403 return c;
405 c = (*readbyte) (-1, readcharfun);
406 if (c < 0 || load_each_byte)
407 return c;
408 if (multibyte)
409 *multibyte = 1;
410 if (ASCII_BYTE_P (c))
411 return c;
412 if (emacs_mule_encoding)
413 return read_emacs_mule_char (c, readbyte, readcharfun);
414 i = 0;
415 buf[i++] = c;
416 len = BYTES_BY_CHAR_HEAD (c);
417 while (i < len)
419 c = (*readbyte) (-1, readcharfun);
420 if (c < 0 || ! TRAILING_CODE_P (c))
422 while (--i > 1)
423 (*readbyte) (buf[i], readcharfun);
424 return BYTE8_TO_CHAR (buf[0]);
426 buf[i++] = c;
428 return STRING_CHAR (buf, i);
431 /* Unread the character C in the way appropriate for the stream READCHARFUN.
432 If the stream is a user function, call it with the char as argument. */
434 static void
435 unreadchar (readcharfun, c)
436 Lisp_Object readcharfun;
437 int c;
439 readchar_count--;
440 if (c == -1)
441 /* Don't back up the pointer if we're unreading the end-of-input mark,
442 since readchar didn't advance it when we read it. */
444 else if (BUFFERP (readcharfun))
446 struct buffer *b = XBUFFER (readcharfun);
447 int bytepos = BUF_PT_BYTE (b);
449 BUF_PT (b)--;
450 if (! NILP (b->enable_multibyte_characters))
451 BUF_DEC_POS (b, bytepos);
452 else
453 bytepos--;
455 BUF_PT_BYTE (b) = bytepos;
457 else if (MARKERP (readcharfun))
459 struct buffer *b = XMARKER (readcharfun)->buffer;
460 int bytepos = XMARKER (readcharfun)->bytepos;
462 XMARKER (readcharfun)->charpos--;
463 if (! NILP (b->enable_multibyte_characters))
464 BUF_DEC_POS (b, bytepos);
465 else
466 bytepos--;
468 XMARKER (readcharfun)->bytepos = bytepos;
470 else if (STRINGP (readcharfun))
472 read_from_string_index--;
473 read_from_string_index_byte
474 = string_char_to_byte (readcharfun, read_from_string_index);
476 else if (CONSP (readcharfun))
478 unread_char = c;
480 else if (EQ (readcharfun, Qlambda))
482 unread_char = c;
484 else if (EQ (readcharfun, Qget_file_char)
485 || EQ (readcharfun, Qget_emacs_mule_file_char))
487 if (load_each_byte)
489 BLOCK_INPUT;
490 ungetc (c, instream);
491 UNBLOCK_INPUT;
493 else
494 unread_char = c;
496 else
497 call1 (readcharfun, make_number (c));
500 static int
501 readbyte_for_lambda (c, readcharfun)
502 int c;
503 Lisp_Object readcharfun;
505 return read_bytecode_char (c >= 0);
509 static int
510 readbyte_from_file (c, readcharfun)
511 int c;
512 Lisp_Object readcharfun;
514 if (c >= 0)
516 BLOCK_INPUT;
517 ungetc (c, instream);
518 UNBLOCK_INPUT;
519 return 0;
522 BLOCK_INPUT;
523 c = getc (instream);
525 #ifdef EINTR
526 /* Interrupted reads have been observed while reading over the network */
527 while (c == EOF && ferror (instream) && errno == EINTR)
529 UNBLOCK_INPUT;
530 QUIT;
531 BLOCK_INPUT;
532 clearerr (instream);
533 c = getc (instream);
535 #endif
537 UNBLOCK_INPUT;
539 return (c == EOF ? -1 : c);
542 static int
543 readbyte_from_string (c, readcharfun)
544 int c;
545 Lisp_Object readcharfun;
547 Lisp_Object string = XCAR (readcharfun);
549 if (c >= 0)
551 read_from_string_index--;
552 read_from_string_index_byte
553 = string_char_to_byte (string, read_from_string_index);
556 if (read_from_string_index >= read_from_string_limit)
557 c = -1;
558 else
559 FETCH_STRING_CHAR_ADVANCE (c, string,
560 read_from_string_index,
561 read_from_string_index_byte);
562 return c;
566 /* Read one non-ASCII character from INSTREAM. The character is
567 encoded in `emacs-mule' and the first byte is already read in
568 C. */
570 extern char emacs_mule_bytes[256];
572 static int
573 read_emacs_mule_char (c, readbyte, readcharfun)
574 int c;
575 int (*readbyte) P_ ((int, Lisp_Object));
576 Lisp_Object readcharfun;
578 /* Emacs-mule coding uses at most 4-byte for one character. */
579 unsigned char buf[4];
580 int len = emacs_mule_bytes[c];
581 struct charset *charset;
582 int i;
583 unsigned code;
585 if (len == 1)
586 /* C is not a valid leading-code of `emacs-mule'. */
587 return BYTE8_TO_CHAR (c);
589 i = 0;
590 buf[i++] = c;
591 while (i < len)
593 c = (*readbyte) (-1, readcharfun);
594 if (c < 0xA0)
596 while (--i > 1)
597 (*readbyte) (buf[i], readcharfun);
598 return BYTE8_TO_CHAR (buf[0]);
600 buf[i++] = c;
603 if (len == 2)
605 charset = emacs_mule_charset[buf[0]];
606 code = buf[1] & 0x7F;
608 else if (len == 3)
610 if (buf[0] == EMACS_MULE_LEADING_CODE_PRIVATE_11
611 || buf[0] == EMACS_MULE_LEADING_CODE_PRIVATE_12)
613 charset = emacs_mule_charset[buf[1]];
614 code = buf[2] & 0x7F;
616 else
618 charset = emacs_mule_charset[buf[0]];
619 code = ((buf[1] << 8) | buf[2]) & 0x7F7F;
622 else
624 charset = emacs_mule_charset[buf[1]];
625 code = ((buf[2] << 8) | buf[3]) & 0x7F7F;
627 c = DECODE_CHAR (charset, code);
628 if (c < 0)
629 Fsignal (Qinvalid_read_syntax,
630 Fcons (build_string ("invalid multibyte form"), Qnil));
631 return c;
635 static Lisp_Object read_internal_start P_ ((Lisp_Object, Lisp_Object,
636 Lisp_Object));
637 static Lisp_Object read0 P_ ((Lisp_Object));
638 static Lisp_Object read1 P_ ((Lisp_Object, int *, int));
640 static Lisp_Object read_list P_ ((int, Lisp_Object));
641 static Lisp_Object read_vector P_ ((Lisp_Object, int));
643 static Lisp_Object substitute_object_recurse P_ ((Lisp_Object, Lisp_Object,
644 Lisp_Object));
645 static void substitute_object_in_subtree P_ ((Lisp_Object,
646 Lisp_Object));
647 static void substitute_in_interval P_ ((INTERVAL, Lisp_Object));
650 /* Get a character from the tty. */
652 /* Read input events until we get one that's acceptable for our purposes.
654 If NO_SWITCH_FRAME is non-zero, switch-frame events are stashed
655 until we get a character we like, and then stuffed into
656 unread_switch_frame.
658 If ASCII_REQUIRED is non-zero, we check function key events to see
659 if the unmodified version of the symbol has a Qascii_character
660 property, and use that character, if present.
662 If ERROR_NONASCII is non-zero, we signal an error if the input we
663 get isn't an ASCII character with modifiers. If it's zero but
664 ASCII_REQUIRED is non-zero, we just re-read until we get an ASCII
665 character.
667 If INPUT_METHOD is nonzero, we invoke the current input method
668 if the character warrants that.
670 If SECONDS is a number, we wait that many seconds for input, and
671 return Qnil if no input arrives within that time. */
673 Lisp_Object
674 read_filtered_event (no_switch_frame, ascii_required, error_nonascii,
675 input_method, seconds)
676 int no_switch_frame, ascii_required, error_nonascii, input_method;
677 Lisp_Object seconds;
679 Lisp_Object val, delayed_switch_frame;
680 EMACS_TIME end_time;
682 #ifdef HAVE_WINDOW_SYSTEM
683 if (display_hourglass_p)
684 cancel_hourglass ();
685 #endif
687 delayed_switch_frame = Qnil;
689 /* Compute timeout. */
690 if (NUMBERP (seconds))
692 EMACS_TIME wait_time;
693 int sec, usec;
694 double duration = extract_float (seconds);
696 sec = (int) duration;
697 usec = (duration - sec) * 1000000;
698 EMACS_GET_TIME (end_time);
699 EMACS_SET_SECS_USECS (wait_time, sec, usec);
700 EMACS_ADD_TIME (end_time, end_time, wait_time);
703 /* Read until we get an acceptable event. */
704 retry:
706 val = read_char (0, 0, 0, (input_method ? Qnil : Qt), 0,
707 NUMBERP (seconds) ? &end_time : NULL);
708 while (INTEGERP (val) && XINT (val) == -2); /* wrong_kboard_jmpbuf */
710 if (BUFFERP (val))
711 goto retry;
713 /* switch-frame events are put off until after the next ASCII
714 character. This is better than signaling an error just because
715 the last characters were typed to a separate minibuffer frame,
716 for example. Eventually, some code which can deal with
717 switch-frame events will read it and process it. */
718 if (no_switch_frame
719 && EVENT_HAS_PARAMETERS (val)
720 && EQ (EVENT_HEAD_KIND (EVENT_HEAD (val)), Qswitch_frame))
722 delayed_switch_frame = val;
723 goto retry;
726 if (ascii_required && !(NUMBERP (seconds) && NILP (val)))
728 /* Convert certain symbols to their ASCII equivalents. */
729 if (SYMBOLP (val))
731 Lisp_Object tem, tem1;
732 tem = Fget (val, Qevent_symbol_element_mask);
733 if (!NILP (tem))
735 tem1 = Fget (Fcar (tem), Qascii_character);
736 /* Merge this symbol's modifier bits
737 with the ASCII equivalent of its basic code. */
738 if (!NILP (tem1))
739 XSETFASTINT (val, XINT (tem1) | XINT (Fcar (Fcdr (tem))));
743 /* If we don't have a character now, deal with it appropriately. */
744 if (!INTEGERP (val))
746 if (error_nonascii)
748 Vunread_command_events = Fcons (val, Qnil);
749 error ("Non-character input-event");
751 else
752 goto retry;
756 if (! NILP (delayed_switch_frame))
757 unread_switch_frame = delayed_switch_frame;
759 #if 0
761 #ifdef HAVE_WINDOW_SYSTEM
762 if (display_hourglass_p)
763 start_hourglass ();
764 #endif
766 #endif
768 return val;
771 DEFUN ("read-char", Fread_char, Sread_char, 0, 3, 0,
772 doc: /* Read a character from the command input (keyboard or macro).
773 It is returned as a number.
774 If the character has modifiers, they are resolved and reflected to the
775 character code if possible (e.g. C-SPC -> 0).
777 If the user generates an event which is not a character (i.e. a mouse
778 click or function key event), `read-char' signals an error. As an
779 exception, switch-frame events are put off until non-character events
780 can be read.
781 If you want to read non-character events, or ignore them, call
782 `read-event' or `read-char-exclusive' instead.
784 If the optional argument PROMPT is non-nil, display that as a prompt.
785 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
786 input method is turned on in the current buffer, that input method
787 is used for reading a character.
788 If the optional argument SECONDS is non-nil, it should be a number
789 specifying the maximum number of seconds to wait for input. If no
790 input arrives in that time, return nil. SECONDS may be a
791 floating-point value. */)
792 (prompt, inherit_input_method, seconds)
793 Lisp_Object prompt, inherit_input_method, seconds;
795 Lisp_Object val;
796 int c;
798 if (! NILP (prompt))
799 message_with_string ("%s", prompt, 0);
800 val = read_filtered_event (1, 1, 1, ! NILP (inherit_input_method), seconds);
801 c = XINT (val);
802 return make_number (char_resolve_modifier_mask (c));
805 DEFUN ("read-event", Fread_event, Sread_event, 0, 3, 0,
806 doc: /* Read an event object from the input stream.
807 If the optional argument PROMPT is non-nil, display that as a prompt.
808 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
809 input method is turned on in the current buffer, that input method
810 is used for reading a character.
811 If the optional argument SECONDS is non-nil, it should be a number
812 specifying the maximum number of seconds to wait for input. If no
813 input arrives in that time, return nil. SECONDS may be a
814 floating-point value. */)
815 (prompt, inherit_input_method, seconds)
816 Lisp_Object prompt, inherit_input_method, seconds;
818 if (! NILP (prompt))
819 message_with_string ("%s", prompt, 0);
820 return read_filtered_event (0, 0, 0, ! NILP (inherit_input_method), seconds);
823 DEFUN ("read-char-exclusive", Fread_char_exclusive, Sread_char_exclusive, 0, 3, 0,
824 doc: /* Read a character from the command input (keyboard or macro).
825 It is returned as a number. Non-character events are ignored.
826 If the character has modifiers, they are resolved and reflected to the
827 character code if possible (e.g. C-SPC -> 0).
829 If the optional argument PROMPT is non-nil, display that as a prompt.
830 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
831 input method is turned on in the current buffer, that input method
832 is used for reading a character.
833 If the optional argument SECONDS is non-nil, it should be a number
834 specifying the maximum number of seconds to wait for input. If no
835 input arrives in that time, return nil. SECONDS may be a
836 floating-point value. */)
837 (prompt, inherit_input_method, seconds)
838 Lisp_Object prompt, inherit_input_method, seconds;
840 Lisp_Object val;
841 int c;
843 if (! NILP (prompt))
844 message_with_string ("%s", prompt, 0);
845 val = read_filtered_event (1, 1, 0, ! NILP (inherit_input_method), seconds);
846 c = XINT (val);
847 return make_number (char_resolve_modifier_mask (c));
850 DEFUN ("get-file-char", Fget_file_char, Sget_file_char, 0, 0, 0,
851 doc: /* Don't use this yourself. */)
854 register Lisp_Object val;
855 BLOCK_INPUT;
856 XSETINT (val, getc (instream));
857 UNBLOCK_INPUT;
858 return val;
863 /* Value is a version number of byte compiled code if the file
864 associated with file descriptor FD is a compiled Lisp file that's
865 safe to load. Only files compiled with Emacs are safe to load.
866 Files compiled with XEmacs can lead to a crash in Fbyte_code
867 because of an incompatible change in the byte compiler. */
869 static int
870 safe_to_load_p (fd)
871 int fd;
873 char buf[512];
874 int nbytes, i;
875 int safe_p = 1;
876 int version = 1;
878 /* Read the first few bytes from the file, and look for a line
879 specifying the byte compiler version used. */
880 nbytes = emacs_read (fd, buf, sizeof buf - 1);
881 if (nbytes > 0)
883 buf[nbytes] = '\0';
885 /* Skip to the next newline, skipping over the initial `ELC'
886 with NUL bytes following it, but note the version. */
887 for (i = 0; i < nbytes && buf[i] != '\n'; ++i)
888 if (i == 4)
889 version = buf[i];
891 if (i == nbytes
892 || fast_c_string_match_ignore_case (Vbytecomp_version_regexp,
893 buf + i) < 0)
894 safe_p = 0;
896 if (safe_p)
897 safe_p = version;
899 lseek (fd, 0, SEEK_SET);
900 return safe_p;
904 /* Callback for record_unwind_protect. Restore the old load list OLD,
905 after loading a file successfully. */
907 static Lisp_Object
908 record_load_unwind (old)
909 Lisp_Object old;
911 return Vloads_in_progress = old;
914 /* This handler function is used via internal_condition_case_1. */
916 static Lisp_Object
917 load_error_handler (data)
918 Lisp_Object data;
920 return Qnil;
923 static Lisp_Object
924 load_warn_old_style_backquotes (file)
925 Lisp_Object file;
927 if (!NILP (Vold_style_backquotes))
929 Lisp_Object args[2];
930 args[0] = build_string ("Loading `%s': old-style backquotes detected!");
931 args[1] = file;
932 Fmessage (2, args);
934 return Qnil;
937 DEFUN ("get-load-suffixes", Fget_load_suffixes, Sget_load_suffixes, 0, 0, 0,
938 doc: /* Return the suffixes that `load' should try if a suffix is \
939 required.
940 This uses the variables `load-suffixes' and `load-file-rep-suffixes'. */)
943 Lisp_Object lst = Qnil, suffixes = Vload_suffixes, suffix, ext;
944 while (CONSP (suffixes))
946 Lisp_Object exts = Vload_file_rep_suffixes;
947 suffix = XCAR (suffixes);
948 suffixes = XCDR (suffixes);
949 while (CONSP (exts))
951 ext = XCAR (exts);
952 exts = XCDR (exts);
953 lst = Fcons (concat2 (suffix, ext), lst);
956 return Fnreverse (lst);
959 DEFUN ("load", Fload, Sload, 1, 5, 0,
960 doc: /* Execute a file of Lisp code named FILE.
961 First try FILE with `.elc' appended, then try with `.el',
962 then try FILE unmodified (the exact suffixes in the exact order are
963 determined by `load-suffixes'). Environment variable references in
964 FILE are replaced with their values by calling `substitute-in-file-name'.
965 This function searches the directories in `load-path'.
967 If optional second arg NOERROR is non-nil,
968 report no error if FILE doesn't exist.
969 Print messages at start and end of loading unless
970 optional third arg NOMESSAGE is non-nil.
971 If optional fourth arg NOSUFFIX is non-nil, don't try adding
972 suffixes `.elc' or `.el' to the specified name FILE.
973 If optional fifth arg MUST-SUFFIX is non-nil, insist on
974 the suffix `.elc' or `.el'; don't accept just FILE unless
975 it ends in one of those suffixes or includes a directory name.
977 If this function fails to find a file, it may look for different
978 representations of that file before trying another file.
979 It does so by adding the non-empty suffixes in `load-file-rep-suffixes'
980 to the file name. Emacs uses this feature mainly to find compressed
981 versions of files when Auto Compression mode is enabled.
983 The exact suffixes that this function tries out, in the exact order,
984 are given by the value of the variable `load-file-rep-suffixes' if
985 NOSUFFIX is non-nil and by the return value of the function
986 `get-load-suffixes' if MUST-SUFFIX is non-nil. If both NOSUFFIX and
987 MUST-SUFFIX are nil, this function first tries out the latter suffixes
988 and then the former.
990 Loading a file records its definitions, and its `provide' and
991 `require' calls, in an element of `load-history' whose
992 car is the file name loaded. See `load-history'.
994 Return t if the file exists and loads successfully. */)
995 (file, noerror, nomessage, nosuffix, must_suffix)
996 Lisp_Object file, noerror, nomessage, nosuffix, must_suffix;
998 register FILE *stream;
999 register int fd = -1;
1000 int count = SPECPDL_INDEX ();
1001 struct gcpro gcpro1, gcpro2, gcpro3;
1002 Lisp_Object found, efound, hist_file_name;
1003 /* 1 means we printed the ".el is newer" message. */
1004 int newer = 0;
1005 /* 1 means we are loading a compiled file. */
1006 int compiled = 0;
1007 Lisp_Object handler;
1008 int safe_p = 1;
1009 char *fmode = "r";
1010 Lisp_Object tmp[2];
1011 int version;
1013 #ifdef DOS_NT
1014 fmode = "rt";
1015 #endif /* DOS_NT */
1017 CHECK_STRING (file);
1019 /* If file name is magic, call the handler. */
1020 /* This shouldn't be necessary any more now that `openp' handles it right.
1021 handler = Ffind_file_name_handler (file, Qload);
1022 if (!NILP (handler))
1023 return call5 (handler, Qload, file, noerror, nomessage, nosuffix); */
1025 /* Do this after the handler to avoid
1026 the need to gcpro noerror, nomessage and nosuffix.
1027 (Below here, we care only whether they are nil or not.)
1028 The presence of this call is the result of a historical accident:
1029 it used to be in every file-operation and when it got removed
1030 everywhere, it accidentally stayed here. Since then, enough people
1031 supposedly have things like (load "$PROJECT/foo.el") in their .emacs
1032 that it seemed risky to remove. */
1033 if (! NILP (noerror))
1035 file = internal_condition_case_1 (Fsubstitute_in_file_name, file,
1036 Qt, load_error_handler);
1037 if (NILP (file))
1038 return Qnil;
1040 else
1041 file = Fsubstitute_in_file_name (file);
1044 /* Avoid weird lossage with null string as arg,
1045 since it would try to load a directory as a Lisp file */
1046 if (SCHARS (file) > 0)
1048 int size = SBYTES (file);
1050 found = Qnil;
1051 GCPRO2 (file, found);
1053 if (! NILP (must_suffix))
1055 /* Don't insist on adding a suffix if FILE already ends with one. */
1056 if (size > 3
1057 && !strcmp (SDATA (file) + size - 3, ".el"))
1058 must_suffix = Qnil;
1059 else if (size > 4
1060 && !strcmp (SDATA (file) + size - 4, ".elc"))
1061 must_suffix = Qnil;
1062 /* Don't insist on adding a suffix
1063 if the argument includes a directory name. */
1064 else if (! NILP (Ffile_name_directory (file)))
1065 must_suffix = Qnil;
1068 fd = openp (Vload_path, file,
1069 (!NILP (nosuffix) ? Qnil
1070 : !NILP (must_suffix) ? Fget_load_suffixes ()
1071 : Fappend (2, (tmp[0] = Fget_load_suffixes (),
1072 tmp[1] = Vload_file_rep_suffixes,
1073 tmp))),
1074 &found, Qnil);
1075 UNGCPRO;
1078 if (fd == -1)
1080 if (NILP (noerror))
1081 xsignal2 (Qfile_error, build_string ("Cannot open load file"), file);
1082 return Qnil;
1085 /* Tell startup.el whether or not we found the user's init file. */
1086 if (EQ (Qt, Vuser_init_file))
1087 Vuser_init_file = found;
1089 /* If FD is -2, that means openp found a magic file. */
1090 if (fd == -2)
1092 if (NILP (Fequal (found, file)))
1093 /* If FOUND is a different file name from FILE,
1094 find its handler even if we have already inhibited
1095 the `load' operation on FILE. */
1096 handler = Ffind_file_name_handler (found, Qt);
1097 else
1098 handler = Ffind_file_name_handler (found, Qload);
1099 if (! NILP (handler))
1100 return call5 (handler, Qload, found, noerror, nomessage, Qt);
1103 /* Check if we're stuck in a recursive load cycle.
1105 2000-09-21: It's not possible to just check for the file loaded
1106 being a member of Vloads_in_progress. This fails because of the
1107 way the byte compiler currently works; `provide's are not
1108 evaluted, see font-lock.el/jit-lock.el as an example. This
1109 leads to a certain amount of ``normal'' recursion.
1111 Also, just loading a file recursively is not always an error in
1112 the general case; the second load may do something different. */
1114 int count = 0;
1115 Lisp_Object tem;
1116 for (tem = Vloads_in_progress; CONSP (tem); tem = XCDR (tem))
1117 if (!NILP (Fequal (found, XCAR (tem))))
1118 count++;
1119 if (count > 3)
1121 if (fd >= 0)
1122 emacs_close (fd);
1123 signal_error ("Recursive load", Fcons (found, Vloads_in_progress));
1125 record_unwind_protect (record_load_unwind, Vloads_in_progress);
1126 Vloads_in_progress = Fcons (found, Vloads_in_progress);
1129 /* Get the name for load-history. */
1130 hist_file_name = (! NILP (Vpurify_flag)
1131 ? Fconcat (2, (tmp[0] = Ffile_name_directory (file),
1132 tmp[1] = Ffile_name_nondirectory (found),
1133 tmp))
1134 : found) ;
1136 version = -1;
1138 /* Check for the presence of old-style quotes and warn about them. */
1139 specbind (Qold_style_backquotes, Qnil);
1140 record_unwind_protect (load_warn_old_style_backquotes, file);
1142 if (!bcmp (SDATA (found) + SBYTES (found) - 4,
1143 ".elc", 4)
1144 || (version = safe_to_load_p (fd)) > 0)
1145 /* Load .elc files directly, but not when they are
1146 remote and have no handler! */
1148 if (fd != -2)
1150 struct stat s1, s2;
1151 int result;
1153 GCPRO3 (file, found, hist_file_name);
1155 if (version < 0
1156 && ! (version = safe_to_load_p (fd)))
1158 safe_p = 0;
1159 if (!load_dangerous_libraries)
1161 if (fd >= 0)
1162 emacs_close (fd);
1163 error ("File `%s' was not compiled in Emacs",
1164 SDATA (found));
1166 else if (!NILP (nomessage))
1167 message_with_string ("File `%s' not compiled in Emacs", found, 1);
1170 compiled = 1;
1172 efound = ENCODE_FILE (found);
1174 #ifdef DOS_NT
1175 fmode = "rb";
1176 #endif /* DOS_NT */
1177 stat ((char *)SDATA (efound), &s1);
1178 SSET (efound, SBYTES (efound) - 1, 0);
1179 result = stat ((char *)SDATA (efound), &s2);
1180 SSET (efound, SBYTES (efound) - 1, 'c');
1182 if (result >= 0 && (unsigned) s1.st_mtime < (unsigned) s2.st_mtime)
1184 /* Make the progress messages mention that source is newer. */
1185 newer = 1;
1187 /* If we won't print another message, mention this anyway. */
1188 if (!NILP (nomessage))
1190 Lisp_Object msg_file;
1191 msg_file = Fsubstring (found, make_number (0), make_number (-1));
1192 message_with_string ("Source file `%s' newer than byte-compiled file",
1193 msg_file, 1);
1196 UNGCPRO;
1199 else
1201 /* We are loading a source file (*.el). */
1202 if (!NILP (Vload_source_file_function))
1204 Lisp_Object val;
1206 if (fd >= 0)
1207 emacs_close (fd);
1208 val = call4 (Vload_source_file_function, found, hist_file_name,
1209 NILP (noerror) ? Qnil : Qt,
1210 NILP (nomessage) ? Qnil : Qt);
1211 return unbind_to (count, val);
1215 GCPRO3 (file, found, hist_file_name);
1217 #ifdef WINDOWSNT
1218 emacs_close (fd);
1219 efound = ENCODE_FILE (found);
1220 stream = fopen ((char *) SDATA (efound), fmode);
1221 #else /* not WINDOWSNT */
1222 stream = fdopen (fd, fmode);
1223 #endif /* not WINDOWSNT */
1224 if (stream == 0)
1226 emacs_close (fd);
1227 error ("Failure to create stdio stream for %s", SDATA (file));
1230 if (! NILP (Vpurify_flag))
1231 Vpreloaded_file_list = Fcons (file, Vpreloaded_file_list);
1233 if (NILP (nomessage))
1235 if (!safe_p)
1236 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...",
1237 file, 1);
1238 else if (!compiled)
1239 message_with_string ("Loading %s (source)...", file, 1);
1240 else if (newer)
1241 message_with_string ("Loading %s (compiled; note, source file is newer)...",
1242 file, 1);
1243 else /* The typical case; compiled file newer than source file. */
1244 message_with_string ("Loading %s...", file, 1);
1247 record_unwind_protect (load_unwind, make_save_value (stream, 0));
1248 record_unwind_protect (load_descriptor_unwind, load_descriptor_list);
1249 specbind (Qload_file_name, found);
1250 specbind (Qinhibit_file_name_operation, Qnil);
1251 load_descriptor_list
1252 = Fcons (make_number (fileno (stream)), load_descriptor_list);
1253 load_in_progress++;
1254 if (! version || version >= 22)
1255 readevalloop (Qget_file_char, stream, hist_file_name,
1256 Feval, 0, Qnil, Qnil, Qnil, Qnil);
1257 else
1259 /* We can't handle a file which was compiled with
1260 byte-compile-dynamic by older version of Emacs. */
1261 specbind (Qload_force_doc_strings, Qt);
1262 readevalloop (Qget_emacs_mule_file_char, stream, hist_file_name, Feval,
1263 0, Qnil, Qnil, Qnil, Qnil);
1265 unbind_to (count, Qnil);
1267 /* Run any eval-after-load forms for this file */
1268 if (NILP (Vpurify_flag)
1269 && (!NILP (Ffboundp (Qdo_after_load_evaluation))))
1270 call1 (Qdo_after_load_evaluation, hist_file_name) ;
1272 UNGCPRO;
1274 if (saved_doc_string)
1275 free (saved_doc_string);
1276 saved_doc_string = 0;
1277 saved_doc_string_size = 0;
1279 if (prev_saved_doc_string)
1280 xfree (prev_saved_doc_string);
1281 prev_saved_doc_string = 0;
1282 prev_saved_doc_string_size = 0;
1284 if (!noninteractive && NILP (nomessage))
1286 if (!safe_p)
1287 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...done",
1288 file, 1);
1289 else if (!compiled)
1290 message_with_string ("Loading %s (source)...done", file, 1);
1291 else if (newer)
1292 message_with_string ("Loading %s (compiled; note, source file is newer)...done",
1293 file, 1);
1294 else /* The typical case; compiled file newer than source file. */
1295 message_with_string ("Loading %s...done", file, 1);
1298 if (!NILP (Fequal (build_string ("obsolete"),
1299 Ffile_name_nondirectory
1300 (Fdirectory_file_name (Ffile_name_directory (found))))))
1301 message_with_string ("Package %s is obsolete", file, 1);
1303 return Qt;
1306 static Lisp_Object
1307 load_unwind (arg) /* used as unwind-protect function in load */
1308 Lisp_Object arg;
1310 FILE *stream = (FILE *) XSAVE_VALUE (arg)->pointer;
1311 if (stream != NULL)
1313 BLOCK_INPUT;
1314 fclose (stream);
1315 UNBLOCK_INPUT;
1317 if (--load_in_progress < 0) load_in_progress = 0;
1318 return Qnil;
1321 static Lisp_Object
1322 load_descriptor_unwind (oldlist)
1323 Lisp_Object oldlist;
1325 load_descriptor_list = oldlist;
1326 return Qnil;
1329 /* Close all descriptors in use for Floads.
1330 This is used when starting a subprocess. */
1332 void
1333 close_load_descs ()
1335 #ifndef WINDOWSNT
1336 Lisp_Object tail;
1337 for (tail = load_descriptor_list; CONSP (tail); tail = XCDR (tail))
1338 emacs_close (XFASTINT (XCAR (tail)));
1339 #endif
1342 static int
1343 complete_filename_p (pathname)
1344 Lisp_Object pathname;
1346 register const unsigned char *s = SDATA (pathname);
1347 return (IS_DIRECTORY_SEP (s[0])
1348 || (SCHARS (pathname) > 2
1349 && IS_DEVICE_SEP (s[1]) && IS_DIRECTORY_SEP (s[2]))
1350 #ifdef VMS
1351 || index (s, ':')
1352 #endif /* VMS */
1356 DEFUN ("locate-file-internal", Flocate_file_internal, Slocate_file_internal, 2, 4, 0,
1357 doc: /* Search for FILENAME through PATH.
1358 Returns the file's name in absolute form, or nil if not found.
1359 If SUFFIXES is non-nil, it should be a list of suffixes to append to
1360 file name when searching.
1361 If non-nil, PREDICATE is used instead of `file-readable-p'.
1362 PREDICATE can also be an integer to pass to the access(2) function,
1363 in which case file-name-handlers are ignored. */)
1364 (filename, path, suffixes, predicate)
1365 Lisp_Object filename, path, suffixes, predicate;
1367 Lisp_Object file;
1368 int fd = openp (path, filename, suffixes, &file, predicate);
1369 if (NILP (predicate) && fd > 0)
1370 close (fd);
1371 return file;
1375 /* Search for a file whose name is STR, looking in directories
1376 in the Lisp list PATH, and trying suffixes from SUFFIX.
1377 On success, returns a file descriptor. On failure, returns -1.
1379 SUFFIXES is a list of strings containing possible suffixes.
1380 The empty suffix is automatically added if the list is empty.
1382 PREDICATE non-nil means don't open the files,
1383 just look for one that satisfies the predicate. In this case,
1384 returns 1 on success. The predicate can be a lisp function or
1385 an integer to pass to `access' (in which case file-name-handlers
1386 are ignored).
1388 If STOREPTR is nonzero, it points to a slot where the name of
1389 the file actually found should be stored as a Lisp string.
1390 nil is stored there on failure.
1392 If the file we find is remote, return -2
1393 but store the found remote file name in *STOREPTR. */
1396 openp (path, str, suffixes, storeptr, predicate)
1397 Lisp_Object path, str;
1398 Lisp_Object suffixes;
1399 Lisp_Object *storeptr;
1400 Lisp_Object predicate;
1402 register int fd;
1403 int fn_size = 100;
1404 char buf[100];
1405 register char *fn = buf;
1406 int absolute = 0;
1407 int want_size;
1408 Lisp_Object filename;
1409 struct stat st;
1410 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
1411 Lisp_Object string, tail, encoded_fn;
1412 int max_suffix_len = 0;
1414 CHECK_STRING (str);
1416 for (tail = suffixes; CONSP (tail); tail = XCDR (tail))
1418 CHECK_STRING_CAR (tail);
1419 max_suffix_len = max (max_suffix_len,
1420 SBYTES (XCAR (tail)));
1423 string = filename = encoded_fn = Qnil;
1424 GCPRO6 (str, string, filename, path, suffixes, encoded_fn);
1426 if (storeptr)
1427 *storeptr = Qnil;
1429 if (complete_filename_p (str))
1430 absolute = 1;
1432 for (; CONSP (path); path = XCDR (path))
1434 filename = Fexpand_file_name (str, XCAR (path));
1435 if (!complete_filename_p (filename))
1436 /* If there are non-absolute elts in PATH (eg ".") */
1437 /* Of course, this could conceivably lose if luser sets
1438 default-directory to be something non-absolute... */
1440 filename = Fexpand_file_name (filename, current_buffer->directory);
1441 if (!complete_filename_p (filename))
1442 /* Give up on this path element! */
1443 continue;
1446 /* Calculate maximum size of any filename made from
1447 this path element/specified file name and any possible suffix. */
1448 want_size = max_suffix_len + SBYTES (filename) + 1;
1449 if (fn_size < want_size)
1450 fn = (char *) alloca (fn_size = 100 + want_size);
1452 /* Loop over suffixes. */
1453 for (tail = NILP (suffixes) ? Fcons (empty_unibyte_string, Qnil) : suffixes;
1454 CONSP (tail); tail = XCDR (tail))
1456 int lsuffix = SBYTES (XCAR (tail));
1457 Lisp_Object handler;
1458 int exists;
1460 /* Concatenate path element/specified name with the suffix.
1461 If the directory starts with /:, remove that. */
1462 if (SCHARS (filename) > 2
1463 && SREF (filename, 0) == '/'
1464 && SREF (filename, 1) == ':')
1466 strncpy (fn, SDATA (filename) + 2,
1467 SBYTES (filename) - 2);
1468 fn[SBYTES (filename) - 2] = 0;
1470 else
1472 strncpy (fn, SDATA (filename),
1473 SBYTES (filename));
1474 fn[SBYTES (filename)] = 0;
1477 if (lsuffix != 0) /* Bug happens on CCI if lsuffix is 0. */
1478 strncat (fn, SDATA (XCAR (tail)), lsuffix);
1480 /* Check that the file exists and is not a directory. */
1481 /* We used to only check for handlers on non-absolute file names:
1482 if (absolute)
1483 handler = Qnil;
1484 else
1485 handler = Ffind_file_name_handler (filename, Qfile_exists_p);
1486 It's not clear why that was the case and it breaks things like
1487 (load "/bar.el") where the file is actually "/bar.el.gz". */
1488 string = build_string (fn);
1489 handler = Ffind_file_name_handler (string, Qfile_exists_p);
1490 if ((!NILP (handler) || !NILP (predicate)) && !NATNUMP (predicate))
1492 if (NILP (predicate))
1493 exists = !NILP (Ffile_readable_p (string));
1494 else
1495 exists = !NILP (call1 (predicate, string));
1496 if (exists && !NILP (Ffile_directory_p (string)))
1497 exists = 0;
1499 if (exists)
1501 /* We succeeded; return this descriptor and filename. */
1502 if (storeptr)
1503 *storeptr = string;
1504 UNGCPRO;
1505 return -2;
1508 else
1510 const char *pfn;
1512 encoded_fn = ENCODE_FILE (string);
1513 pfn = SDATA (encoded_fn);
1514 exists = (stat (pfn, &st) >= 0
1515 && (st.st_mode & S_IFMT) != S_IFDIR);
1516 if (exists)
1518 /* Check that we can access or open it. */
1519 if (NATNUMP (predicate))
1520 fd = (access (pfn, XFASTINT (predicate)) == 0) ? 1 : -1;
1521 else
1522 fd = emacs_open (pfn, O_RDONLY, 0);
1524 if (fd >= 0)
1526 /* We succeeded; return this descriptor and filename. */
1527 if (storeptr)
1528 *storeptr = string;
1529 UNGCPRO;
1530 return fd;
1535 if (absolute)
1536 break;
1539 UNGCPRO;
1540 return -1;
1544 /* Merge the list we've accumulated of globals from the current input source
1545 into the load_history variable. The details depend on whether
1546 the source has an associated file name or not.
1548 FILENAME is the file name that we are loading from.
1549 ENTIRE is 1 if loading that entire file, 0 if evaluating part of it. */
1551 static void
1552 build_load_history (filename, entire)
1553 Lisp_Object filename;
1554 int entire;
1556 register Lisp_Object tail, prev, newelt;
1557 register Lisp_Object tem, tem2;
1558 register int foundit = 0;
1560 tail = Vload_history;
1561 prev = Qnil;
1563 while (CONSP (tail))
1565 tem = XCAR (tail);
1567 /* Find the feature's previous assoc list... */
1568 if (!NILP (Fequal (filename, Fcar (tem))))
1570 foundit = 1;
1572 /* If we're loading the entire file, remove old data. */
1573 if (entire)
1575 if (NILP (prev))
1576 Vload_history = XCDR (tail);
1577 else
1578 Fsetcdr (prev, XCDR (tail));
1581 /* Otherwise, cons on new symbols that are not already members. */
1582 else
1584 tem2 = Vcurrent_load_list;
1586 while (CONSP (tem2))
1588 newelt = XCAR (tem2);
1590 if (NILP (Fmember (newelt, tem)))
1591 Fsetcar (tail, Fcons (XCAR (tem),
1592 Fcons (newelt, XCDR (tem))));
1594 tem2 = XCDR (tem2);
1595 QUIT;
1599 else
1600 prev = tail;
1601 tail = XCDR (tail);
1602 QUIT;
1605 /* If we're loading an entire file, cons the new assoc onto the
1606 front of load-history, the most-recently-loaded position. Also
1607 do this if we didn't find an existing member for the file. */
1608 if (entire || !foundit)
1609 Vload_history = Fcons (Fnreverse (Vcurrent_load_list),
1610 Vload_history);
1613 Lisp_Object
1614 unreadpure (junk) /* Used as unwind-protect function in readevalloop */
1615 Lisp_Object junk;
1617 read_pure = 0;
1618 return Qnil;
1621 static Lisp_Object
1622 readevalloop_1 (old)
1623 Lisp_Object old;
1625 load_convert_to_unibyte = ! NILP (old);
1626 return Qnil;
1629 /* Signal an `end-of-file' error, if possible with file name
1630 information. */
1632 static void
1633 end_of_file_error ()
1635 if (STRINGP (Vload_file_name))
1636 xsignal1 (Qend_of_file, Vload_file_name);
1638 xsignal0 (Qend_of_file);
1641 /* UNIBYTE specifies how to set load_convert_to_unibyte
1642 for this invocation.
1643 READFUN, if non-nil, is used instead of `read'.
1645 START, END specify region to read in current buffer (from eval-region).
1646 If the input is not from a buffer, they must be nil. */
1648 static void
1649 readevalloop (readcharfun, stream, sourcename, evalfun,
1650 printflag, unibyte, readfun, start, end)
1651 Lisp_Object readcharfun;
1652 FILE *stream;
1653 Lisp_Object sourcename;
1654 Lisp_Object (*evalfun) ();
1655 int printflag;
1656 Lisp_Object unibyte, readfun;
1657 Lisp_Object start, end;
1659 register int c;
1660 register Lisp_Object val;
1661 int count = SPECPDL_INDEX ();
1662 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1663 struct buffer *b = 0;
1664 int continue_reading_p;
1665 /* Nonzero if reading an entire buffer. */
1666 int whole_buffer = 0;
1667 /* 1 on the first time around. */
1668 int first_sexp = 1;
1670 if (MARKERP (readcharfun))
1672 if (NILP (start))
1673 start = readcharfun;
1676 if (BUFFERP (readcharfun))
1677 b = XBUFFER (readcharfun);
1678 else if (MARKERP (readcharfun))
1679 b = XMARKER (readcharfun)->buffer;
1681 /* We assume START is nil when input is not from a buffer. */
1682 if (! NILP (start) && !b)
1683 abort ();
1685 specbind (Qstandard_input, readcharfun); /* GCPROs readcharfun. */
1686 specbind (Qcurrent_load_list, Qnil);
1687 record_unwind_protect (readevalloop_1, load_convert_to_unibyte ? Qt : Qnil);
1688 load_convert_to_unibyte = !NILP (unibyte);
1690 GCPRO4 (sourcename, readfun, start, end);
1692 /* Try to ensure sourcename is a truename, except whilst preloading. */
1693 if (NILP (Vpurify_flag)
1694 && !NILP (sourcename) && !NILP (Ffile_name_absolute_p (sourcename))
1695 && !NILP (Ffboundp (Qfile_truename)))
1696 sourcename = call1 (Qfile_truename, sourcename) ;
1698 LOADHIST_ATTACH (sourcename);
1700 continue_reading_p = 1;
1701 while (continue_reading_p)
1703 int count1 = SPECPDL_INDEX ();
1705 if (b != 0 && NILP (b->name))
1706 error ("Reading from killed buffer");
1708 if (!NILP (start))
1710 /* Switch to the buffer we are reading from. */
1711 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1712 set_buffer_internal (b);
1714 /* Save point in it. */
1715 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1716 /* Save ZV in it. */
1717 record_unwind_protect (save_restriction_restore, save_restriction_save ());
1718 /* Those get unbound after we read one expression. */
1720 /* Set point and ZV around stuff to be read. */
1721 Fgoto_char (start);
1722 if (!NILP (end))
1723 Fnarrow_to_region (make_number (BEGV), end);
1725 /* Just for cleanliness, convert END to a marker
1726 if it is an integer. */
1727 if (INTEGERP (end))
1728 end = Fpoint_max_marker ();
1731 /* On the first cycle, we can easily test here
1732 whether we are reading the whole buffer. */
1733 if (b && first_sexp)
1734 whole_buffer = (PT == BEG && ZV == Z);
1736 instream = stream;
1737 read_next:
1738 c = READCHAR;
1739 if (c == ';')
1741 while ((c = READCHAR) != '\n' && c != -1);
1742 goto read_next;
1744 if (c < 0)
1746 unbind_to (count1, Qnil);
1747 break;
1750 /* Ignore whitespace here, so we can detect eof. */
1751 if (c == ' ' || c == '\t' || c == '\n' || c == '\f' || c == '\r'
1752 || c == 0x8a0) /* NBSP */
1753 goto read_next;
1755 if (!NILP (Vpurify_flag) && c == '(')
1757 record_unwind_protect (unreadpure, Qnil);
1758 val = read_list (-1, readcharfun);
1760 else
1762 UNREAD (c);
1763 read_objects = Qnil;
1764 if (!NILP (readfun))
1766 val = call1 (readfun, readcharfun);
1768 /* If READCHARFUN has set point to ZV, we should
1769 stop reading, even if the form read sets point
1770 to a different value when evaluated. */
1771 if (BUFFERP (readcharfun))
1773 struct buffer *b = XBUFFER (readcharfun);
1774 if (BUF_PT (b) == BUF_ZV (b))
1775 continue_reading_p = 0;
1778 else if (! NILP (Vload_read_function))
1779 val = call1 (Vload_read_function, readcharfun);
1780 else
1781 val = read_internal_start (readcharfun, Qnil, Qnil);
1784 if (!NILP (start) && continue_reading_p)
1785 start = Fpoint_marker ();
1787 /* Restore saved point and BEGV. */
1788 unbind_to (count1, Qnil);
1790 /* Now eval what we just read. */
1791 val = (*evalfun) (val);
1793 if (printflag)
1795 Vvalues = Fcons (val, Vvalues);
1796 if (EQ (Vstandard_output, Qt))
1797 Fprin1 (val, Qnil);
1798 else
1799 Fprint (val, Qnil);
1802 first_sexp = 0;
1805 build_load_history (sourcename,
1806 stream || whole_buffer);
1808 UNGCPRO;
1810 unbind_to (count, Qnil);
1813 DEFUN ("eval-buffer", Feval_buffer, Seval_buffer, 0, 5, "",
1814 doc: /* Execute the current buffer as Lisp code.
1815 Programs can pass two arguments, BUFFER and PRINTFLAG.
1816 BUFFER is the buffer to evaluate (nil means use current buffer).
1817 PRINTFLAG controls printing of output:
1818 A value of nil means discard it; anything else is stream for print.
1820 If the optional third argument FILENAME is non-nil,
1821 it specifies the file name to use for `load-history'.
1822 The optional fourth argument UNIBYTE specifies `load-convert-to-unibyte'
1823 for this invocation.
1825 The optional fifth argument DO-ALLOW-PRINT, if non-nil, specifies that
1826 `print' and related functions should work normally even if PRINTFLAG is nil.
1828 This function preserves the position of point. */)
1829 (buffer, printflag, filename, unibyte, do_allow_print)
1830 Lisp_Object buffer, printflag, filename, unibyte, do_allow_print;
1832 int count = SPECPDL_INDEX ();
1833 Lisp_Object tem, buf;
1835 if (NILP (buffer))
1836 buf = Fcurrent_buffer ();
1837 else
1838 buf = Fget_buffer (buffer);
1839 if (NILP (buf))
1840 error ("No such buffer");
1842 if (NILP (printflag) && NILP (do_allow_print))
1843 tem = Qsymbolp;
1844 else
1845 tem = printflag;
1847 if (NILP (filename))
1848 filename = XBUFFER (buf)->filename;
1850 specbind (Qeval_buffer_list, Fcons (buf, Veval_buffer_list));
1851 specbind (Qstandard_output, tem);
1852 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1853 BUF_TEMP_SET_PT (XBUFFER (buf), BUF_BEGV (XBUFFER (buf)));
1854 readevalloop (buf, 0, filename, Feval,
1855 !NILP (printflag), unibyte, Qnil, Qnil, Qnil);
1856 unbind_to (count, Qnil);
1858 return Qnil;
1861 DEFUN ("eval-region", Feval_region, Seval_region, 2, 4, "r",
1862 doc: /* Execute the region as Lisp code.
1863 When called from programs, expects two arguments,
1864 giving starting and ending indices in the current buffer
1865 of the text to be executed.
1866 Programs can pass third argument PRINTFLAG which controls output:
1867 A value of nil means discard it; anything else is stream for printing it.
1868 Also the fourth argument READ-FUNCTION, if non-nil, is used
1869 instead of `read' to read each expression. It gets one argument
1870 which is the input stream for reading characters.
1872 This function does not move point. */)
1873 (start, end, printflag, read_function)
1874 Lisp_Object start, end, printflag, read_function;
1876 int count = SPECPDL_INDEX ();
1877 Lisp_Object tem, cbuf;
1879 cbuf = Fcurrent_buffer ();
1881 if (NILP (printflag))
1882 tem = Qsymbolp;
1883 else
1884 tem = printflag;
1885 specbind (Qstandard_output, tem);
1886 specbind (Qeval_buffer_list, Fcons (cbuf, Veval_buffer_list));
1888 /* readevalloop calls functions which check the type of start and end. */
1889 readevalloop (cbuf, 0, XBUFFER (cbuf)->filename, Feval,
1890 !NILP (printflag), Qnil, read_function,
1891 start, end);
1893 return unbind_to (count, Qnil);
1897 DEFUN ("read", Fread, Sread, 0, 1, 0,
1898 doc: /* Read one Lisp expression as text from STREAM, return as Lisp object.
1899 If STREAM is nil, use the value of `standard-input' (which see).
1900 STREAM or the value of `standard-input' may be:
1901 a buffer (read from point and advance it)
1902 a marker (read from where it points and advance it)
1903 a function (call it with no arguments for each character,
1904 call it with a char as argument to push a char back)
1905 a string (takes text from string, starting at the beginning)
1906 t (read text line using minibuffer and use it, or read from
1907 standard input in batch mode). */)
1908 (stream)
1909 Lisp_Object stream;
1911 if (NILP (stream))
1912 stream = Vstandard_input;
1913 if (EQ (stream, Qt))
1914 stream = Qread_char;
1915 if (EQ (stream, Qread_char))
1916 return Fread_minibuffer (build_string ("Lisp expression: "), Qnil);
1918 return read_internal_start (stream, Qnil, Qnil);
1921 DEFUN ("read-from-string", Fread_from_string, Sread_from_string, 1, 3, 0,
1922 doc: /* Read one Lisp expression which is represented as text by STRING.
1923 Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
1924 START and END optionally delimit a substring of STRING from which to read;
1925 they default to 0 and (length STRING) respectively. */)
1926 (string, start, end)
1927 Lisp_Object string, start, end;
1929 Lisp_Object ret;
1930 CHECK_STRING (string);
1931 /* read_internal_start sets read_from_string_index. */
1932 ret = read_internal_start (string, start, end);
1933 return Fcons (ret, make_number (read_from_string_index));
1936 /* Function to set up the global context we need in toplevel read
1937 calls. */
1938 static Lisp_Object
1939 read_internal_start (stream, start, end)
1940 Lisp_Object stream;
1941 Lisp_Object start; /* Only used when stream is a string. */
1942 Lisp_Object end; /* Only used when stream is a string. */
1944 Lisp_Object retval;
1946 readchar_count = 0;
1947 new_backquote_flag = 0;
1948 read_objects = Qnil;
1949 if (EQ (Vread_with_symbol_positions, Qt)
1950 || EQ (Vread_with_symbol_positions, stream))
1951 Vread_symbol_positions_list = Qnil;
1953 if (STRINGP (stream)
1954 || ((CONSP (stream) && STRINGP (XCAR (stream)))))
1956 int startval, endval;
1957 Lisp_Object string;
1959 if (STRINGP (stream))
1960 string = stream;
1961 else
1962 string = XCAR (stream);
1964 if (NILP (end))
1965 endval = SCHARS (string);
1966 else
1968 CHECK_NUMBER (end);
1969 endval = XINT (end);
1970 if (endval < 0 || endval > SCHARS (string))
1971 args_out_of_range (string, end);
1974 if (NILP (start))
1975 startval = 0;
1976 else
1978 CHECK_NUMBER (start);
1979 startval = XINT (start);
1980 if (startval < 0 || startval > endval)
1981 args_out_of_range (string, start);
1983 read_from_string_index = startval;
1984 read_from_string_index_byte = string_char_to_byte (string, startval);
1985 read_from_string_limit = endval;
1988 retval = read0 (stream);
1989 if (EQ (Vread_with_symbol_positions, Qt)
1990 || EQ (Vread_with_symbol_positions, stream))
1991 Vread_symbol_positions_list = Fnreverse (Vread_symbol_positions_list);
1992 return retval;
1996 /* Signal Qinvalid_read_syntax error.
1997 S is error string of length N (if > 0) */
1999 static void
2000 invalid_syntax (s, n)
2001 const char *s;
2002 int n;
2004 if (!n)
2005 n = strlen (s);
2006 xsignal1 (Qinvalid_read_syntax, make_string (s, n));
2010 /* Use this for recursive reads, in contexts where internal tokens
2011 are not allowed. */
2013 static Lisp_Object
2014 read0 (readcharfun)
2015 Lisp_Object readcharfun;
2017 register Lisp_Object val;
2018 int c;
2020 val = read1 (readcharfun, &c, 0);
2021 if (!c)
2022 return val;
2024 xsignal1 (Qinvalid_read_syntax,
2025 Fmake_string (make_number (1), make_number (c)));
2028 static int read_buffer_size;
2029 static char *read_buffer;
2031 /* Read a \-escape sequence, assuming we already read the `\'.
2032 If the escape sequence forces unibyte, return eight-bit char. */
2034 static int
2035 read_escape (readcharfun, stringp)
2036 Lisp_Object readcharfun;
2037 int stringp;
2039 register int c = READCHAR;
2040 /* \u allows up to four hex digits, \U up to eight. Default to the
2041 behaviour for \u, and change this value in the case that \U is seen. */
2042 int unicode_hex_count = 4;
2044 switch (c)
2046 case -1:
2047 end_of_file_error ();
2049 case 'a':
2050 return '\007';
2051 case 'b':
2052 return '\b';
2053 case 'd':
2054 return 0177;
2055 case 'e':
2056 return 033;
2057 case 'f':
2058 return '\f';
2059 case 'n':
2060 return '\n';
2061 case 'r':
2062 return '\r';
2063 case 't':
2064 return '\t';
2065 case 'v':
2066 return '\v';
2067 case '\n':
2068 return -1;
2069 case ' ':
2070 if (stringp)
2071 return -1;
2072 return ' ';
2074 case 'M':
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 | meta_modifier;
2083 case 'S':
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 | shift_modifier;
2092 case 'H':
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 | hyper_modifier;
2101 case 'A':
2102 c = READCHAR;
2103 if (c != '-')
2104 error ("Invalid escape character syntax");
2105 c = READCHAR;
2106 if (c == '\\')
2107 c = read_escape (readcharfun, 0);
2108 return c | alt_modifier;
2110 case 's':
2111 c = READCHAR;
2112 if (stringp || c != '-')
2114 UNREAD (c);
2115 return ' ';
2117 c = READCHAR;
2118 if (c == '\\')
2119 c = read_escape (readcharfun, 0);
2120 return c | super_modifier;
2122 case 'C':
2123 c = READCHAR;
2124 if (c != '-')
2125 error ("Invalid escape character syntax");
2126 case '^':
2127 c = READCHAR;
2128 if (c == '\\')
2129 c = read_escape (readcharfun, 0);
2130 if ((c & ~CHAR_MODIFIER_MASK) == '?')
2131 return 0177 | (c & CHAR_MODIFIER_MASK);
2132 else if (! SINGLE_BYTE_CHAR_P ((c & ~CHAR_MODIFIER_MASK)))
2133 return c | ctrl_modifier;
2134 /* ASCII control chars are made from letters (both cases),
2135 as well as the non-letters within 0100...0137. */
2136 else if ((c & 0137) >= 0101 && (c & 0137) <= 0132)
2137 return (c & (037 | ~0177));
2138 else if ((c & 0177) >= 0100 && (c & 0177) <= 0137)
2139 return (c & (037 | ~0177));
2140 else
2141 return c | ctrl_modifier;
2143 case '0':
2144 case '1':
2145 case '2':
2146 case '3':
2147 case '4':
2148 case '5':
2149 case '6':
2150 case '7':
2151 /* An octal escape, as in ANSI C. */
2153 register int i = c - '0';
2154 register int count = 0;
2155 while (++count < 3)
2157 if ((c = READCHAR) >= '0' && c <= '7')
2159 i *= 8;
2160 i += c - '0';
2162 else
2164 UNREAD (c);
2165 break;
2169 if (i >= 0x80 && i < 0x100)
2170 i = BYTE8_TO_CHAR (i);
2171 return i;
2174 case 'x':
2175 /* A hex escape, as in ANSI C. */
2177 int i = 0;
2178 int count = 0;
2179 while (1)
2181 c = READCHAR;
2182 if (c >= '0' && c <= '9')
2184 i *= 16;
2185 i += c - '0';
2187 else if ((c >= 'a' && c <= 'f')
2188 || (c >= 'A' && c <= 'F'))
2190 i *= 16;
2191 if (c >= 'a' && c <= 'f')
2192 i += c - 'a' + 10;
2193 else
2194 i += c - 'A' + 10;
2196 else
2198 UNREAD (c);
2199 break;
2201 count++;
2204 if (count < 3 && i >= 0x80)
2205 return BYTE8_TO_CHAR (i);
2206 return i;
2209 case 'U':
2210 /* Post-Unicode-2.0: Up to eight hex chars. */
2211 unicode_hex_count = 8;
2212 case 'u':
2214 /* A Unicode escape. We only permit them in strings and characters,
2215 not arbitrarily in the source code, as in some other languages. */
2217 int i = 0;
2218 int count = 0;
2220 while (++count <= unicode_hex_count)
2222 c = READCHAR;
2223 /* isdigit and isalpha may be locale-specific, which we don't
2224 want. */
2225 if (c >= '0' && c <= '9') i = (i << 4) + (c - '0');
2226 else if (c >= 'a' && c <= 'f') i = (i << 4) + (c - 'a') + 10;
2227 else if (c >= 'A' && c <= 'F') i = (i << 4) + (c - 'A') + 10;
2228 else
2230 error ("Non-hex digit used for Unicode escape");
2231 break;
2235 return i;
2238 default:
2239 return c;
2243 /* Read an integer in radix RADIX using READCHARFUN to read
2244 characters. RADIX must be in the interval [2..36]; if it isn't, a
2245 read error is signaled . Value is the integer read. Signals an
2246 error if encountering invalid read syntax or if RADIX is out of
2247 range. */
2249 static Lisp_Object
2250 read_integer (readcharfun, radix)
2251 Lisp_Object readcharfun;
2252 int radix;
2254 int ndigits = 0, invalid_p, c, sign = 0;
2255 EMACS_INT number = 0;
2257 if (radix < 2 || radix > 36)
2258 invalid_p = 1;
2259 else
2261 number = ndigits = invalid_p = 0;
2262 sign = 1;
2264 c = READCHAR;
2265 if (c == '-')
2267 c = READCHAR;
2268 sign = -1;
2270 else if (c == '+')
2271 c = READCHAR;
2273 while (c >= 0)
2275 int digit;
2277 if (c >= '0' && c <= '9')
2278 digit = c - '0';
2279 else if (c >= 'a' && c <= 'z')
2280 digit = c - 'a' + 10;
2281 else if (c >= 'A' && c <= 'Z')
2282 digit = c - 'A' + 10;
2283 else
2285 UNREAD (c);
2286 break;
2289 if (digit < 0 || digit >= radix)
2290 invalid_p = 1;
2292 number = radix * number + digit;
2293 ++ndigits;
2294 c = READCHAR;
2298 if (ndigits == 0 || invalid_p)
2300 char buf[50];
2301 sprintf (buf, "integer, radix %d", radix);
2302 invalid_syntax (buf, 0);
2305 return make_number (sign * number);
2309 /* If the next token is ')' or ']' or '.', we store that character
2310 in *PCH and the return value is not interesting. Else, we store
2311 zero in *PCH and we read and return one lisp object.
2313 FIRST_IN_LIST is nonzero if this is the first element of a list. */
2315 static Lisp_Object
2316 read1 (readcharfun, pch, first_in_list)
2317 register Lisp_Object readcharfun;
2318 int *pch;
2319 int first_in_list;
2321 register int c;
2322 int uninterned_symbol = 0;
2323 int multibyte;
2325 *pch = 0;
2326 load_each_byte = 0;
2328 retry:
2330 c = READCHAR_REPORT_MULTIBYTE (&multibyte);
2331 if (c < 0)
2332 end_of_file_error ();
2334 switch (c)
2336 case '(':
2337 return read_list (0, readcharfun);
2339 case '[':
2340 return read_vector (readcharfun, 0);
2342 case ')':
2343 case ']':
2345 *pch = c;
2346 return Qnil;
2349 case '#':
2350 c = READCHAR;
2351 if (c == '^')
2353 c = READCHAR;
2354 if (c == '[')
2356 Lisp_Object tmp;
2357 tmp = read_vector (readcharfun, 0);
2358 if (XVECTOR (tmp)->size < CHAR_TABLE_STANDARD_SLOTS)
2359 error ("Invalid size char-table");
2360 XSETPVECTYPE (XVECTOR (tmp), PVEC_CHAR_TABLE);
2361 return tmp;
2363 else if (c == '^')
2365 c = READCHAR;
2366 if (c == '[')
2368 Lisp_Object tmp;
2369 int depth, size;
2371 tmp = read_vector (readcharfun, 0);
2372 if (!INTEGERP (AREF (tmp, 0)))
2373 error ("Invalid depth in char-table");
2374 depth = XINT (AREF (tmp, 0));
2375 if (depth < 1 || depth > 3)
2376 error ("Invalid depth in char-table");
2377 size = XVECTOR (tmp)->size - 2;
2378 if (chartab_size [depth] != size)
2379 error ("Invalid size char-table");
2380 XSETPVECTYPE (XVECTOR (tmp), PVEC_SUB_CHAR_TABLE);
2381 return tmp;
2383 invalid_syntax ("#^^", 3);
2385 invalid_syntax ("#^", 2);
2387 if (c == '&')
2389 Lisp_Object length;
2390 length = read1 (readcharfun, pch, first_in_list);
2391 c = READCHAR;
2392 if (c == '"')
2394 Lisp_Object tmp, val;
2395 int size_in_chars
2396 = ((XFASTINT (length) + BOOL_VECTOR_BITS_PER_CHAR - 1)
2397 / BOOL_VECTOR_BITS_PER_CHAR);
2399 UNREAD (c);
2400 tmp = read1 (readcharfun, pch, first_in_list);
2401 if (STRING_MULTIBYTE (tmp)
2402 || (size_in_chars != SCHARS (tmp)
2403 /* We used to print 1 char too many
2404 when the number of bits was a multiple of 8.
2405 Accept such input in case it came from an old
2406 version. */
2407 && ! (XFASTINT (length)
2408 == (SCHARS (tmp) - 1) * BOOL_VECTOR_BITS_PER_CHAR)))
2409 invalid_syntax ("#&...", 5);
2411 val = Fmake_bool_vector (length, Qnil);
2412 bcopy (SDATA (tmp), XBOOL_VECTOR (val)->data,
2413 size_in_chars);
2414 /* Clear the extraneous bits in the last byte. */
2415 if (XINT (length) != size_in_chars * BOOL_VECTOR_BITS_PER_CHAR)
2416 XBOOL_VECTOR (val)->data[size_in_chars - 1]
2417 &= (1 << (XINT (length) % BOOL_VECTOR_BITS_PER_CHAR)) - 1;
2418 return val;
2420 invalid_syntax ("#&...", 5);
2422 if (c == '[')
2424 /* Accept compiled functions at read-time so that we don't have to
2425 build them using function calls. */
2426 Lisp_Object tmp;
2427 tmp = read_vector (readcharfun, 1);
2428 return Fmake_byte_code (XVECTOR (tmp)->size,
2429 XVECTOR (tmp)->contents);
2431 if (c == '(')
2433 Lisp_Object tmp;
2434 struct gcpro gcpro1;
2435 int ch;
2437 /* Read the string itself. */
2438 tmp = read1 (readcharfun, &ch, 0);
2439 if (ch != 0 || !STRINGP (tmp))
2440 invalid_syntax ("#", 1);
2441 GCPRO1 (tmp);
2442 /* Read the intervals and their properties. */
2443 while (1)
2445 Lisp_Object beg, end, plist;
2447 beg = read1 (readcharfun, &ch, 0);
2448 end = plist = Qnil;
2449 if (ch == ')')
2450 break;
2451 if (ch == 0)
2452 end = read1 (readcharfun, &ch, 0);
2453 if (ch == 0)
2454 plist = read1 (readcharfun, &ch, 0);
2455 if (ch)
2456 invalid_syntax ("Invalid string property list", 0);
2457 Fset_text_properties (beg, end, plist, tmp);
2459 UNGCPRO;
2460 return tmp;
2463 /* #@NUMBER is used to skip NUMBER following characters.
2464 That's used in .elc files to skip over doc strings
2465 and function definitions. */
2466 if (c == '@')
2468 int i, nskip = 0;
2470 load_each_byte = 1;
2471 /* Read a decimal integer. */
2472 while ((c = READCHAR) >= 0
2473 && c >= '0' && c <= '9')
2475 nskip *= 10;
2476 nskip += c - '0';
2478 if (c >= 0)
2479 UNREAD (c);
2481 if (load_force_doc_strings
2482 && (EQ (readcharfun, Qget_file_char)
2483 || EQ (readcharfun, Qget_emacs_mule_file_char)))
2485 /* If we are supposed to force doc strings into core right now,
2486 record the last string that we skipped,
2487 and record where in the file it comes from. */
2489 /* But first exchange saved_doc_string
2490 with prev_saved_doc_string, so we save two strings. */
2492 char *temp = saved_doc_string;
2493 int temp_size = saved_doc_string_size;
2494 file_offset temp_pos = saved_doc_string_position;
2495 int temp_len = saved_doc_string_length;
2497 saved_doc_string = prev_saved_doc_string;
2498 saved_doc_string_size = prev_saved_doc_string_size;
2499 saved_doc_string_position = prev_saved_doc_string_position;
2500 saved_doc_string_length = prev_saved_doc_string_length;
2502 prev_saved_doc_string = temp;
2503 prev_saved_doc_string_size = temp_size;
2504 prev_saved_doc_string_position = temp_pos;
2505 prev_saved_doc_string_length = temp_len;
2508 if (saved_doc_string_size == 0)
2510 saved_doc_string_size = nskip + 100;
2511 saved_doc_string = (char *) xmalloc (saved_doc_string_size);
2513 if (nskip > saved_doc_string_size)
2515 saved_doc_string_size = nskip + 100;
2516 saved_doc_string = (char *) xrealloc (saved_doc_string,
2517 saved_doc_string_size);
2520 saved_doc_string_position = file_tell (instream);
2522 /* Copy that many characters into saved_doc_string. */
2523 for (i = 0; i < nskip && c >= 0; i++)
2524 saved_doc_string[i] = c = READCHAR;
2526 saved_doc_string_length = i;
2528 else
2530 /* Skip that many characters. */
2531 for (i = 0; i < nskip && c >= 0; i++)
2532 c = READCHAR;
2535 load_each_byte = 0;
2536 goto retry;
2538 if (c == '!')
2540 /* #! appears at the beginning of an executable file.
2541 Skip the first line. */
2542 while (c != '\n' && c >= 0)
2543 c = READCHAR;
2544 goto retry;
2546 if (c == '$')
2547 return Vload_file_name;
2548 if (c == '\'')
2549 return Fcons (Qfunction, Fcons (read0 (readcharfun), Qnil));
2550 /* #:foo is the uninterned symbol named foo. */
2551 if (c == ':')
2553 uninterned_symbol = 1;
2554 c = READCHAR;
2555 goto default_label;
2557 /* Reader forms that can reuse previously read objects. */
2558 if (c >= '0' && c <= '9')
2560 int n = 0;
2561 Lisp_Object tem;
2563 /* Read a non-negative integer. */
2564 while (c >= '0' && c <= '9')
2566 n *= 10;
2567 n += c - '0';
2568 c = READCHAR;
2570 /* #n=object returns object, but associates it with n for #n#. */
2571 if (c == '=')
2573 /* Make a placeholder for #n# to use temporarily */
2574 Lisp_Object placeholder;
2575 Lisp_Object cell;
2577 placeholder = Fcons(Qnil, Qnil);
2578 cell = Fcons (make_number (n), placeholder);
2579 read_objects = Fcons (cell, read_objects);
2581 /* Read the object itself. */
2582 tem = read0 (readcharfun);
2584 /* Now put it everywhere the placeholder was... */
2585 substitute_object_in_subtree (tem, placeholder);
2587 /* ...and #n# will use the real value from now on. */
2588 Fsetcdr (cell, tem);
2590 return tem;
2592 /* #n# returns a previously read object. */
2593 if (c == '#')
2595 tem = Fassq (make_number (n), read_objects);
2596 if (CONSP (tem))
2597 return XCDR (tem);
2598 /* Fall through to error message. */
2600 else if (c == 'r' || c == 'R')
2601 return read_integer (readcharfun, n);
2603 /* Fall through to error message. */
2605 else if (c == 'x' || c == 'X')
2606 return read_integer (readcharfun, 16);
2607 else if (c == 'o' || c == 'O')
2608 return read_integer (readcharfun, 8);
2609 else if (c == 'b' || c == 'B')
2610 return read_integer (readcharfun, 2);
2612 UNREAD (c);
2613 invalid_syntax ("#", 1);
2615 case ';':
2616 while ((c = READCHAR) >= 0 && c != '\n');
2617 goto retry;
2619 case '\'':
2621 return Fcons (Qquote, Fcons (read0 (readcharfun), Qnil));
2624 case '`':
2625 if (first_in_list)
2627 Vold_style_backquotes = Qt;
2628 goto default_label;
2630 else
2632 Lisp_Object value;
2634 new_backquote_flag++;
2635 value = read0 (readcharfun);
2636 new_backquote_flag--;
2638 return Fcons (Qbackquote, Fcons (value, Qnil));
2641 case ',':
2642 if (new_backquote_flag)
2644 Lisp_Object comma_type = Qnil;
2645 Lisp_Object value;
2646 int ch = READCHAR;
2648 if (ch == '@')
2649 comma_type = Qcomma_at;
2650 else if (ch == '.')
2651 comma_type = Qcomma_dot;
2652 else
2654 if (ch >= 0) UNREAD (ch);
2655 comma_type = Qcomma;
2658 new_backquote_flag--;
2659 value = read0 (readcharfun);
2660 new_backquote_flag++;
2661 return Fcons (comma_type, Fcons (value, Qnil));
2663 else
2665 Vold_style_backquotes = Qt;
2666 goto default_label;
2669 case '?':
2671 int modifiers;
2672 int next_char;
2673 int ok;
2675 c = READCHAR;
2676 if (c < 0)
2677 end_of_file_error ();
2679 /* Accept `single space' syntax like (list ? x) where the
2680 whitespace character is SPC or TAB.
2681 Other literal whitespace like NL, CR, and FF are not accepted,
2682 as there are well-established escape sequences for these. */
2683 if (c == ' ' || c == '\t')
2684 return make_number (c);
2686 if (c == '\\')
2687 c = read_escape (readcharfun, 0);
2688 modifiers = c & CHAR_MODIFIER_MASK;
2689 c &= ~CHAR_MODIFIER_MASK;
2690 if (CHAR_BYTE8_P (c))
2691 c = CHAR_TO_BYTE8 (c);
2692 c |= modifiers;
2694 next_char = READCHAR;
2695 if (next_char == '.')
2697 /* Only a dotted-pair dot is valid after a char constant. */
2698 int next_next_char = READCHAR;
2699 UNREAD (next_next_char);
2701 ok = (next_next_char <= 040
2702 || (next_next_char < 0200
2703 && (index ("\"';([#?", next_next_char)
2704 || (!first_in_list && next_next_char == '`')
2705 || (new_backquote_flag && next_next_char == ','))));
2707 else
2709 ok = (next_char <= 040
2710 || (next_char < 0200
2711 && (index ("\"';()[]#?", next_char)
2712 || (!first_in_list && next_char == '`')
2713 || (new_backquote_flag && next_char == ','))));
2715 UNREAD (next_char);
2716 if (ok)
2717 return make_number (c);
2719 invalid_syntax ("?", 1);
2722 case '"':
2724 char *p = read_buffer;
2725 char *end = read_buffer + read_buffer_size;
2726 register int c;
2727 /* Nonzero if we saw an escape sequence specifying
2728 a multibyte character. */
2729 int force_multibyte = 0;
2730 /* Nonzero if we saw an escape sequence specifying
2731 a single-byte character. */
2732 int force_singlebyte = 0;
2733 int cancel = 0;
2734 int nchars = 0;
2736 while ((c = READCHAR) >= 0
2737 && c != '\"')
2739 if (end - p < MAX_MULTIBYTE_LENGTH)
2741 int offset = p - read_buffer;
2742 read_buffer = (char *) xrealloc (read_buffer,
2743 read_buffer_size *= 2);
2744 p = read_buffer + offset;
2745 end = read_buffer + read_buffer_size;
2748 if (c == '\\')
2750 int modifiers;
2752 c = read_escape (readcharfun, 1);
2754 /* C is -1 if \ newline has just been seen */
2755 if (c == -1)
2757 if (p == read_buffer)
2758 cancel = 1;
2759 continue;
2762 modifiers = c & CHAR_MODIFIER_MASK;
2763 c = c & ~CHAR_MODIFIER_MASK;
2765 if (CHAR_BYTE8_P (c))
2766 force_singlebyte = 1;
2767 else if (! ASCII_CHAR_P (c))
2768 force_multibyte = 1;
2769 else /* i.e. ASCII_CHAR_P (c) */
2771 /* Allow `\C- ' and `\C-?'. */
2772 if (modifiers == CHAR_CTL)
2774 if (c == ' ')
2775 c = 0, modifiers = 0;
2776 else if (c == '?')
2777 c = 127, modifiers = 0;
2779 if (modifiers & CHAR_SHIFT)
2781 /* Shift modifier is valid only with [A-Za-z]. */
2782 if (c >= 'A' && c <= 'Z')
2783 modifiers &= ~CHAR_SHIFT;
2784 else if (c >= 'a' && c <= 'z')
2785 c -= ('a' - 'A'), modifiers &= ~CHAR_SHIFT;
2788 if (modifiers & CHAR_META)
2790 /* Move the meta bit to the right place for a
2791 string. */
2792 modifiers &= ~CHAR_META;
2793 c = BYTE8_TO_CHAR (c | 0x80);
2794 force_singlebyte = 1;
2798 /* Any modifiers remaining are invalid. */
2799 if (modifiers)
2800 error ("Invalid modifier in string");
2801 p += CHAR_STRING (c, (unsigned char *) p);
2803 else
2805 p += CHAR_STRING (c, (unsigned char *) p);
2806 if (CHAR_BYTE8_P (c))
2807 force_singlebyte = 1;
2808 else if (! ASCII_CHAR_P (c))
2809 force_multibyte = 1;
2811 nchars++;
2814 if (c < 0)
2815 end_of_file_error ();
2817 /* If purifying, and string starts with \ newline,
2818 return zero instead. This is for doc strings
2819 that we are really going to find in etc/DOC.nn.nn */
2820 if (!NILP (Vpurify_flag) && NILP (Vdoc_file_name) && cancel)
2821 return make_number (0);
2823 if (force_multibyte)
2824 /* READ_BUFFER already contains valid multibyte forms. */
2826 else if (force_singlebyte)
2828 nchars = str_as_unibyte (read_buffer, p - read_buffer);
2829 p = read_buffer + nchars;
2831 else
2832 /* Otherwise, READ_BUFFER contains only ASCII. */
2835 /* We want readchar_count to be the number of characters, not
2836 bytes. Hence we adjust for multibyte characters in the
2837 string. ... But it doesn't seem to be necessary, because
2838 READCHAR *does* read multibyte characters from buffers. */
2839 /* readchar_count -= (p - read_buffer) - nchars; */
2840 if (read_pure)
2841 return make_pure_string (read_buffer, nchars, p - read_buffer,
2842 (force_multibyte
2843 || (p - read_buffer != nchars)));
2844 return make_specified_string (read_buffer, nchars, p - read_buffer,
2845 (force_multibyte
2846 || (p - read_buffer != nchars)));
2849 case '.':
2851 int next_char = READCHAR;
2852 UNREAD (next_char);
2854 if (next_char <= 040
2855 || (next_char < 0200
2856 && (index ("\"';([#?", next_char)
2857 || (!first_in_list && next_char == '`')
2858 || (new_backquote_flag && next_char == ','))))
2860 *pch = c;
2861 return Qnil;
2864 /* Otherwise, we fall through! Note that the atom-reading loop
2865 below will now loop at least once, assuring that we will not
2866 try to UNREAD two characters in a row. */
2868 default:
2869 default_label:
2870 if (c <= 040) goto retry;
2871 if (c == 0x8a0) /* NBSP */
2872 goto retry;
2874 char *p = read_buffer;
2875 int quoted = 0;
2878 char *end = read_buffer + read_buffer_size;
2880 while (c > 040
2881 && c != 0x8a0 /* NBSP */
2882 && (c >= 0200
2883 || (!index ("\"';()[]#", c)
2884 && !(!first_in_list && c == '`')
2885 && !(new_backquote_flag && c == ','))))
2887 if (end - p < MAX_MULTIBYTE_LENGTH)
2889 int offset = p - read_buffer;
2890 read_buffer = (char *) xrealloc (read_buffer,
2891 read_buffer_size *= 2);
2892 p = read_buffer + offset;
2893 end = read_buffer + read_buffer_size;
2896 if (c == '\\')
2898 c = READCHAR;
2899 if (c == -1)
2900 end_of_file_error ();
2901 quoted = 1;
2904 if (multibyte)
2905 p += CHAR_STRING (c, p);
2906 else
2907 *p++ = c;
2908 c = READCHAR;
2911 if (p == end)
2913 int offset = p - read_buffer;
2914 read_buffer = (char *) xrealloc (read_buffer,
2915 read_buffer_size *= 2);
2916 p = read_buffer + offset;
2917 end = read_buffer + read_buffer_size;
2919 *p = 0;
2920 if (c >= 0)
2921 UNREAD (c);
2924 if (!quoted && !uninterned_symbol)
2926 register char *p1;
2927 register Lisp_Object val;
2928 p1 = read_buffer;
2929 if (*p1 == '+' || *p1 == '-') p1++;
2930 /* Is it an integer? */
2931 if (p1 != p)
2933 while (p1 != p && (c = *p1) >= '0' && c <= '9') p1++;
2934 /* Integers can have trailing decimal points. */
2935 if (p1 > read_buffer && p1 < p && *p1 == '.') p1++;
2936 if (p1 == p)
2937 /* It is an integer. */
2939 if (p1[-1] == '.')
2940 p1[-1] = '\0';
2941 /* Fixme: if we have strtol, use that, and check
2942 for overflow. */
2943 if (sizeof (int) == sizeof (EMACS_INT))
2944 XSETINT (val, atoi (read_buffer));
2945 else if (sizeof (long) == sizeof (EMACS_INT))
2946 XSETINT (val, atol (read_buffer));
2947 else
2948 abort ();
2949 return val;
2952 if (isfloat_string (read_buffer))
2954 /* Compute NaN and infinities using 0.0 in a variable,
2955 to cope with compilers that think they are smarter
2956 than we are. */
2957 double zero = 0.0;
2959 double value;
2961 /* Negate the value ourselves. This treats 0, NaNs,
2962 and infinity properly on IEEE floating point hosts,
2963 and works around a common bug where atof ("-0.0")
2964 drops the sign. */
2965 int negative = read_buffer[0] == '-';
2967 /* The only way p[-1] can be 'F' or 'N', after isfloat_string
2968 returns 1, is if the input ends in e+INF or e+NaN. */
2969 switch (p[-1])
2971 case 'F':
2972 value = 1.0 / zero;
2973 break;
2974 case 'N':
2975 value = zero / zero;
2977 /* If that made a "negative" NaN, negate it. */
2980 int i;
2981 union { double d; char c[sizeof (double)]; } u_data, u_minus_zero;
2983 u_data.d = value;
2984 u_minus_zero.d = - 0.0;
2985 for (i = 0; i < sizeof (double); i++)
2986 if (u_data.c[i] & u_minus_zero.c[i])
2988 value = - value;
2989 break;
2992 /* Now VALUE is a positive NaN. */
2993 break;
2994 default:
2995 value = atof (read_buffer + negative);
2996 break;
2999 return make_float (negative ? - value : value);
3003 Lisp_Object name, result;
3004 EMACS_INT nbytes = p - read_buffer;
3005 EMACS_INT nchars
3006 = (multibyte ? multibyte_chars_in_text (read_buffer, nbytes)
3007 : nbytes);
3009 if (uninterned_symbol && ! NILP (Vpurify_flag))
3010 name = make_pure_string (read_buffer, nchars, nbytes, multibyte);
3011 else
3012 name = make_specified_string (read_buffer, nchars, nbytes,multibyte);
3013 result = (uninterned_symbol ? Fmake_symbol (name)
3014 : Fintern (name, Qnil));
3016 if (EQ (Vread_with_symbol_positions, Qt)
3017 || EQ (Vread_with_symbol_positions, readcharfun))
3018 Vread_symbol_positions_list =
3019 /* Kind of a hack; this will probably fail if characters
3020 in the symbol name were escaped. Not really a big
3021 deal, though. */
3022 Fcons (Fcons (result,
3023 make_number (readchar_count
3024 - XFASTINT (Flength (Fsymbol_name (result))))),
3025 Vread_symbol_positions_list);
3026 return result;
3033 /* List of nodes we've seen during substitute_object_in_subtree. */
3034 static Lisp_Object seen_list;
3036 static void
3037 substitute_object_in_subtree (object, placeholder)
3038 Lisp_Object object;
3039 Lisp_Object placeholder;
3041 Lisp_Object check_object;
3043 /* We haven't seen any objects when we start. */
3044 seen_list = Qnil;
3046 /* Make all the substitutions. */
3047 check_object
3048 = substitute_object_recurse (object, placeholder, object);
3050 /* Clear seen_list because we're done with it. */
3051 seen_list = Qnil;
3053 /* The returned object here is expected to always eq the
3054 original. */
3055 if (!EQ (check_object, object))
3056 error ("Unexpected mutation error in reader");
3059 /* Feval doesn't get called from here, so no gc protection is needed. */
3060 #define SUBSTITUTE(get_val, set_val) \
3062 Lisp_Object old_value = get_val; \
3063 Lisp_Object true_value \
3064 = substitute_object_recurse (object, placeholder,\
3065 old_value); \
3067 if (!EQ (old_value, true_value)) \
3069 set_val; \
3073 static Lisp_Object
3074 substitute_object_recurse (object, placeholder, subtree)
3075 Lisp_Object object;
3076 Lisp_Object placeholder;
3077 Lisp_Object subtree;
3079 /* If we find the placeholder, return the target object. */
3080 if (EQ (placeholder, subtree))
3081 return object;
3083 /* If we've been to this node before, don't explore it again. */
3084 if (!EQ (Qnil, Fmemq (subtree, seen_list)))
3085 return subtree;
3087 /* If this node can be the entry point to a cycle, remember that
3088 we've seen it. It can only be such an entry point if it was made
3089 by #n=, which means that we can find it as a value in
3090 read_objects. */
3091 if (!EQ (Qnil, Frassq (subtree, read_objects)))
3092 seen_list = Fcons (subtree, seen_list);
3094 /* Recurse according to subtree's type.
3095 Every branch must return a Lisp_Object. */
3096 switch (XTYPE (subtree))
3098 case Lisp_Vectorlike:
3100 int i;
3101 int length = XINT (Flength(subtree));
3102 for (i = 0; i < length; i++)
3104 Lisp_Object idx = make_number (i);
3105 SUBSTITUTE (Faref (subtree, idx),
3106 Faset (subtree, idx, true_value));
3108 return subtree;
3111 case Lisp_Cons:
3113 SUBSTITUTE (Fcar_safe (subtree),
3114 Fsetcar (subtree, true_value));
3115 SUBSTITUTE (Fcdr_safe (subtree),
3116 Fsetcdr (subtree, true_value));
3117 return subtree;
3120 case Lisp_String:
3122 /* Check for text properties in each interval.
3123 substitute_in_interval contains part of the logic. */
3125 INTERVAL root_interval = STRING_INTERVALS (subtree);
3126 Lisp_Object arg = Fcons (object, placeholder);
3128 traverse_intervals_noorder (root_interval,
3129 &substitute_in_interval, arg);
3131 return subtree;
3134 /* Other types don't recurse any further. */
3135 default:
3136 return subtree;
3140 /* Helper function for substitute_object_recurse. */
3141 static void
3142 substitute_in_interval (interval, arg)
3143 INTERVAL interval;
3144 Lisp_Object arg;
3146 Lisp_Object object = Fcar (arg);
3147 Lisp_Object placeholder = Fcdr (arg);
3149 SUBSTITUTE(interval->plist, interval->plist = true_value);
3153 #define LEAD_INT 1
3154 #define DOT_CHAR 2
3155 #define TRAIL_INT 4
3156 #define E_CHAR 8
3157 #define EXP_INT 16
3160 isfloat_string (cp)
3161 register char *cp;
3163 register int state;
3165 char *start = cp;
3167 state = 0;
3168 if (*cp == '+' || *cp == '-')
3169 cp++;
3171 if (*cp >= '0' && *cp <= '9')
3173 state |= LEAD_INT;
3174 while (*cp >= '0' && *cp <= '9')
3175 cp++;
3177 if (*cp == '.')
3179 state |= DOT_CHAR;
3180 cp++;
3182 if (*cp >= '0' && *cp <= '9')
3184 state |= TRAIL_INT;
3185 while (*cp >= '0' && *cp <= '9')
3186 cp++;
3188 if (*cp == 'e' || *cp == 'E')
3190 state |= E_CHAR;
3191 cp++;
3192 if (*cp == '+' || *cp == '-')
3193 cp++;
3196 if (*cp >= '0' && *cp <= '9')
3198 state |= EXP_INT;
3199 while (*cp >= '0' && *cp <= '9')
3200 cp++;
3202 else if (cp == start)
3204 else if (cp[-1] == '+' && cp[0] == 'I' && cp[1] == 'N' && cp[2] == 'F')
3206 state |= EXP_INT;
3207 cp += 3;
3209 else if (cp[-1] == '+' && cp[0] == 'N' && cp[1] == 'a' && cp[2] == 'N')
3211 state |= EXP_INT;
3212 cp += 3;
3215 return (((*cp == 0) || (*cp == ' ') || (*cp == '\t') || (*cp == '\n') || (*cp == '\r') || (*cp == '\f'))
3216 && (state == (LEAD_INT|DOT_CHAR|TRAIL_INT)
3217 || state == (DOT_CHAR|TRAIL_INT)
3218 || state == (LEAD_INT|E_CHAR|EXP_INT)
3219 || state == (LEAD_INT|DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)
3220 || state == (DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)));
3224 static Lisp_Object
3225 read_vector (readcharfun, bytecodeflag)
3226 Lisp_Object readcharfun;
3227 int bytecodeflag;
3229 register int i;
3230 register int size;
3231 register Lisp_Object *ptr;
3232 register Lisp_Object tem, item, vector;
3233 register struct Lisp_Cons *otem;
3234 Lisp_Object len;
3236 tem = read_list (1, readcharfun);
3237 len = Flength (tem);
3238 vector = (read_pure ? make_pure_vector (XINT (len)) : Fmake_vector (len, Qnil));
3240 size = XVECTOR (vector)->size;
3241 ptr = XVECTOR (vector)->contents;
3242 for (i = 0; i < size; i++)
3244 item = Fcar (tem);
3245 /* If `load-force-doc-strings' is t when reading a lazily-loaded
3246 bytecode object, the docstring containing the bytecode and
3247 constants values must be treated as unibyte and passed to
3248 Fread, to get the actual bytecode string and constants vector. */
3249 if (bytecodeflag && load_force_doc_strings)
3251 if (i == COMPILED_BYTECODE)
3253 if (!STRINGP (item))
3254 error ("Invalid byte code");
3256 /* Delay handling the bytecode slot until we know whether
3257 it is lazily-loaded (we can tell by whether the
3258 constants slot is nil). */
3259 ptr[COMPILED_CONSTANTS] = item;
3260 item = Qnil;
3262 else if (i == COMPILED_CONSTANTS)
3264 Lisp_Object bytestr = ptr[COMPILED_CONSTANTS];
3266 if (NILP (item))
3268 /* Coerce string to unibyte (like string-as-unibyte,
3269 but without generating extra garbage and
3270 guaranteeing no change in the contents). */
3271 STRING_SET_CHARS (bytestr, SBYTES (bytestr));
3272 STRING_SET_UNIBYTE (bytestr);
3274 item = Fread (Fcons (bytestr, readcharfun));
3275 if (!CONSP (item))
3276 error ("Invalid byte code");
3278 otem = XCONS (item);
3279 bytestr = XCAR (item);
3280 item = XCDR (item);
3281 free_cons (otem);
3284 /* Now handle the bytecode slot. */
3285 ptr[COMPILED_BYTECODE] = read_pure ? Fpurecopy (bytestr) : bytestr;
3287 else if (i == COMPILED_DOC_STRING
3288 && STRINGP (item)
3289 && ! STRING_MULTIBYTE (item))
3291 if (EQ (readcharfun, Qget_emacs_mule_file_char))
3292 item = Fdecode_coding_string (item, Qemacs_mule, Qnil, Qnil);
3293 else
3294 item = Fstring_as_multibyte (item);
3297 ptr[i] = read_pure ? Fpurecopy (item) : item;
3298 otem = XCONS (tem);
3299 tem = Fcdr (tem);
3300 free_cons (otem);
3302 return vector;
3305 /* FLAG = 1 means check for ] to terminate rather than ) and .
3306 FLAG = -1 means check for starting with defun
3307 and make structure pure. */
3309 static Lisp_Object
3310 read_list (flag, readcharfun)
3311 int flag;
3312 register Lisp_Object readcharfun;
3314 /* -1 means check next element for defun,
3315 0 means don't check,
3316 1 means already checked and found defun. */
3317 int defunflag = flag < 0 ? -1 : 0;
3318 Lisp_Object val, tail;
3319 register Lisp_Object elt, tem;
3320 struct gcpro gcpro1, gcpro2;
3321 /* 0 is the normal case.
3322 1 means this list is a doc reference; replace it with the number 0.
3323 2 means this list is a doc reference; replace it with the doc string. */
3324 int doc_reference = 0;
3326 /* Initialize this to 1 if we are reading a list. */
3327 int first_in_list = flag <= 0;
3329 val = Qnil;
3330 tail = Qnil;
3332 while (1)
3334 int ch;
3335 GCPRO2 (val, tail);
3336 elt = read1 (readcharfun, &ch, first_in_list);
3337 UNGCPRO;
3339 first_in_list = 0;
3341 /* While building, if the list starts with #$, treat it specially. */
3342 if (EQ (elt, Vload_file_name)
3343 && ! NILP (elt)
3344 && !NILP (Vpurify_flag))
3346 if (NILP (Vdoc_file_name))
3347 /* We have not yet called Snarf-documentation, so assume
3348 this file is described in the DOC-MM.NN file
3349 and Snarf-documentation will fill in the right value later.
3350 For now, replace the whole list with 0. */
3351 doc_reference = 1;
3352 else
3353 /* We have already called Snarf-documentation, so make a relative
3354 file name for this file, so it can be found properly
3355 in the installed Lisp directory.
3356 We don't use Fexpand_file_name because that would make
3357 the directory absolute now. */
3358 elt = concat2 (build_string ("../lisp/"),
3359 Ffile_name_nondirectory (elt));
3361 else if (EQ (elt, Vload_file_name)
3362 && ! NILP (elt)
3363 && load_force_doc_strings)
3364 doc_reference = 2;
3366 if (ch)
3368 if (flag > 0)
3370 if (ch == ']')
3371 return val;
3372 invalid_syntax (") or . in a vector", 18);
3374 if (ch == ')')
3375 return val;
3376 if (ch == '.')
3378 GCPRO2 (val, tail);
3379 if (!NILP (tail))
3380 XSETCDR (tail, read0 (readcharfun));
3381 else
3382 val = read0 (readcharfun);
3383 read1 (readcharfun, &ch, 0);
3384 UNGCPRO;
3385 if (ch == ')')
3387 if (doc_reference == 1)
3388 return make_number (0);
3389 if (doc_reference == 2)
3391 /* Get a doc string from the file we are loading.
3392 If it's in saved_doc_string, get it from there.
3394 Here, we don't know if the string is a
3395 bytecode string or a doc string. As a
3396 bytecode string must be unibyte, we always
3397 return a unibyte string. If it is actually a
3398 doc string, caller must make it
3399 multibyte. */
3401 int pos = XINT (XCDR (val));
3402 /* Position is negative for user variables. */
3403 if (pos < 0) pos = -pos;
3404 if (pos >= saved_doc_string_position
3405 && pos < (saved_doc_string_position
3406 + saved_doc_string_length))
3408 int start = pos - saved_doc_string_position;
3409 int from, to;
3411 /* Process quoting with ^A,
3412 and find the end of the string,
3413 which is marked with ^_ (037). */
3414 for (from = start, to = start;
3415 saved_doc_string[from] != 037;)
3417 int c = saved_doc_string[from++];
3418 if (c == 1)
3420 c = saved_doc_string[from++];
3421 if (c == 1)
3422 saved_doc_string[to++] = c;
3423 else if (c == '0')
3424 saved_doc_string[to++] = 0;
3425 else if (c == '_')
3426 saved_doc_string[to++] = 037;
3428 else
3429 saved_doc_string[to++] = c;
3432 return make_unibyte_string (saved_doc_string + start,
3433 to - start);
3435 /* Look in prev_saved_doc_string the same way. */
3436 else if (pos >= prev_saved_doc_string_position
3437 && pos < (prev_saved_doc_string_position
3438 + prev_saved_doc_string_length))
3440 int start = pos - prev_saved_doc_string_position;
3441 int from, to;
3443 /* Process quoting with ^A,
3444 and find the end of the string,
3445 which is marked with ^_ (037). */
3446 for (from = start, to = start;
3447 prev_saved_doc_string[from] != 037;)
3449 int c = prev_saved_doc_string[from++];
3450 if (c == 1)
3452 c = prev_saved_doc_string[from++];
3453 if (c == 1)
3454 prev_saved_doc_string[to++] = c;
3455 else if (c == '0')
3456 prev_saved_doc_string[to++] = 0;
3457 else if (c == '_')
3458 prev_saved_doc_string[to++] = 037;
3460 else
3461 prev_saved_doc_string[to++] = c;
3464 return make_unibyte_string (prev_saved_doc_string
3465 + start,
3466 to - start);
3468 else
3469 return get_doc_string (val, 1, 0);
3472 return val;
3474 invalid_syntax (". in wrong context", 18);
3476 invalid_syntax ("] in a list", 11);
3478 tem = (read_pure && flag <= 0
3479 ? pure_cons (elt, Qnil)
3480 : Fcons (elt, Qnil));
3481 if (!NILP (tail))
3482 XSETCDR (tail, tem);
3483 else
3484 val = tem;
3485 tail = tem;
3486 if (defunflag < 0)
3487 defunflag = EQ (elt, Qdefun);
3488 else if (defunflag > 0)
3489 read_pure = 1;
3493 Lisp_Object Vobarray;
3494 Lisp_Object initial_obarray;
3496 /* oblookup stores the bucket number here, for the sake of Funintern. */
3498 int oblookup_last_bucket_number;
3500 static int hash_string ();
3502 /* Get an error if OBARRAY is not an obarray.
3503 If it is one, return it. */
3505 Lisp_Object
3506 check_obarray (obarray)
3507 Lisp_Object obarray;
3509 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3511 /* If Vobarray is now invalid, force it to be valid. */
3512 if (EQ (Vobarray, obarray)) Vobarray = initial_obarray;
3513 wrong_type_argument (Qvectorp, obarray);
3515 return obarray;
3518 /* Intern the C string STR: return a symbol with that name,
3519 interned in the current obarray. */
3521 Lisp_Object
3522 intern (str)
3523 const char *str;
3525 Lisp_Object tem;
3526 int len = strlen (str);
3527 Lisp_Object obarray;
3529 obarray = Vobarray;
3530 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3531 obarray = check_obarray (obarray);
3532 tem = oblookup (obarray, str, len, len);
3533 if (SYMBOLP (tem))
3534 return tem;
3535 return Fintern (make_string (str, len), obarray);
3538 /* Create an uninterned symbol with name STR. */
3540 Lisp_Object
3541 make_symbol (str)
3542 char *str;
3544 int len = strlen (str);
3546 return Fmake_symbol ((!NILP (Vpurify_flag)
3547 ? make_pure_string (str, len, len, 0)
3548 : make_string (str, len)));
3551 DEFUN ("intern", Fintern, Sintern, 1, 2, 0,
3552 doc: /* Return the canonical symbol whose name is STRING.
3553 If there is none, one is created by this function and returned.
3554 A second optional argument specifies the obarray to use;
3555 it defaults to the value of `obarray'. */)
3556 (string, obarray)
3557 Lisp_Object string, obarray;
3559 register Lisp_Object tem, sym, *ptr;
3561 if (NILP (obarray)) obarray = Vobarray;
3562 obarray = check_obarray (obarray);
3564 CHECK_STRING (string);
3566 tem = oblookup (obarray, SDATA (string),
3567 SCHARS (string),
3568 SBYTES (string));
3569 if (!INTEGERP (tem))
3570 return tem;
3572 if (!NILP (Vpurify_flag))
3573 string = Fpurecopy (string);
3574 sym = Fmake_symbol (string);
3576 if (EQ (obarray, initial_obarray))
3577 XSYMBOL (sym)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3578 else
3579 XSYMBOL (sym)->interned = SYMBOL_INTERNED;
3581 if ((SREF (string, 0) == ':')
3582 && EQ (obarray, initial_obarray))
3584 XSYMBOL (sym)->constant = 1;
3585 XSYMBOL (sym)->value = sym;
3588 ptr = &XVECTOR (obarray)->contents[XINT (tem)];
3589 if (SYMBOLP (*ptr))
3590 XSYMBOL (sym)->next = XSYMBOL (*ptr);
3591 else
3592 XSYMBOL (sym)->next = 0;
3593 *ptr = sym;
3594 return sym;
3597 DEFUN ("intern-soft", Fintern_soft, Sintern_soft, 1, 2, 0,
3598 doc: /* Return the canonical symbol named NAME, or nil if none exists.
3599 NAME may be a string or a symbol. If it is a symbol, that exact
3600 symbol is searched for.
3601 A second optional argument specifies the obarray to use;
3602 it defaults to the value of `obarray'. */)
3603 (name, obarray)
3604 Lisp_Object name, obarray;
3606 register Lisp_Object tem, string;
3608 if (NILP (obarray)) obarray = Vobarray;
3609 obarray = check_obarray (obarray);
3611 if (!SYMBOLP (name))
3613 CHECK_STRING (name);
3614 string = name;
3616 else
3617 string = SYMBOL_NAME (name);
3619 tem = oblookup (obarray, SDATA (string), SCHARS (string), SBYTES (string));
3620 if (INTEGERP (tem) || (SYMBOLP (name) && !EQ (name, tem)))
3621 return Qnil;
3622 else
3623 return tem;
3626 DEFUN ("unintern", Funintern, Sunintern, 1, 2, 0,
3627 doc: /* Delete the symbol named NAME, if any, from OBARRAY.
3628 The value is t if a symbol was found and deleted, nil otherwise.
3629 NAME may be a string or a symbol. If it is a symbol, that symbol
3630 is deleted, if it belongs to OBARRAY--no other symbol is deleted.
3631 OBARRAY defaults to the value of the variable `obarray'. */)
3632 (name, obarray)
3633 Lisp_Object name, obarray;
3635 register Lisp_Object string, tem;
3636 int hash;
3638 if (NILP (obarray)) obarray = Vobarray;
3639 obarray = check_obarray (obarray);
3641 if (SYMBOLP (name))
3642 string = SYMBOL_NAME (name);
3643 else
3645 CHECK_STRING (name);
3646 string = name;
3649 tem = oblookup (obarray, SDATA (string),
3650 SCHARS (string),
3651 SBYTES (string));
3652 if (INTEGERP (tem))
3653 return Qnil;
3654 /* If arg was a symbol, don't delete anything but that symbol itself. */
3655 if (SYMBOLP (name) && !EQ (name, tem))
3656 return Qnil;
3658 XSYMBOL (tem)->interned = SYMBOL_UNINTERNED;
3659 XSYMBOL (tem)->constant = 0;
3660 XSYMBOL (tem)->indirect_variable = 0;
3662 hash = oblookup_last_bucket_number;
3664 if (EQ (XVECTOR (obarray)->contents[hash], tem))
3666 if (XSYMBOL (tem)->next)
3667 XSETSYMBOL (XVECTOR (obarray)->contents[hash], XSYMBOL (tem)->next);
3668 else
3669 XSETINT (XVECTOR (obarray)->contents[hash], 0);
3671 else
3673 Lisp_Object tail, following;
3675 for (tail = XVECTOR (obarray)->contents[hash];
3676 XSYMBOL (tail)->next;
3677 tail = following)
3679 XSETSYMBOL (following, XSYMBOL (tail)->next);
3680 if (EQ (following, tem))
3682 XSYMBOL (tail)->next = XSYMBOL (following)->next;
3683 break;
3688 return Qt;
3691 /* Return the symbol in OBARRAY whose names matches the string
3692 of SIZE characters (SIZE_BYTE bytes) at PTR.
3693 If there is no such symbol in OBARRAY, return nil.
3695 Also store the bucket number in oblookup_last_bucket_number. */
3697 Lisp_Object
3698 oblookup (obarray, ptr, size, size_byte)
3699 Lisp_Object obarray;
3700 register const char *ptr;
3701 int size, size_byte;
3703 int hash;
3704 int obsize;
3705 register Lisp_Object tail;
3706 Lisp_Object bucket, tem;
3708 if (!VECTORP (obarray)
3709 || (obsize = XVECTOR (obarray)->size) == 0)
3711 obarray = check_obarray (obarray);
3712 obsize = XVECTOR (obarray)->size;
3714 /* This is sometimes needed in the middle of GC. */
3715 obsize &= ~ARRAY_MARK_FLAG;
3716 /* Combining next two lines breaks VMS C 2.3. */
3717 hash = hash_string (ptr, size_byte);
3718 hash %= 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_CARBON))))
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.
4097 Also, when using the "self-contained" option for Carbon Emacs for MacOSX,
4098 the "standard" paths may not exist and would be overridden by
4099 EMACSLOADPATH as on NT. Since this depends on how the executable
4100 was build and packaged, turn off the warnings in general */
4102 /* Warn if dirs in the *standard* path don't exist. */
4103 if (!turn_off_warning)
4105 Lisp_Object path_tail;
4107 for (path_tail = Vload_path;
4108 !NILP (path_tail);
4109 path_tail = XCDR (path_tail))
4111 Lisp_Object dirfile;
4112 dirfile = Fcar (path_tail);
4113 if (STRINGP (dirfile))
4115 dirfile = Fdirectory_file_name (dirfile);
4116 if (access (SDATA (dirfile), 0) < 0)
4117 dir_warning ("Warning: Lisp directory `%s' does not exist.\n",
4118 XCAR (path_tail));
4122 #endif /* !(WINDOWSNT || HAVE_CARBON) */
4124 /* If the EMACSLOADPATH environment variable is set, use its value.
4125 This doesn't apply if we're dumping. */
4126 #ifndef CANNOT_DUMP
4127 if (NILP (Vpurify_flag)
4128 && egetenv ("EMACSLOADPATH"))
4129 #endif
4130 Vload_path = decode_env_path ("EMACSLOADPATH", normal);
4132 Vvalues = Qnil;
4134 load_in_progress = 0;
4135 Vload_file_name = Qnil;
4137 load_descriptor_list = Qnil;
4139 Vstandard_input = Qt;
4140 Vloads_in_progress = Qnil;
4143 /* Print a warning, using format string FORMAT, that directory DIRNAME
4144 does not exist. Print it on stderr and put it in *Messages*. */
4146 void
4147 dir_warning (format, dirname)
4148 char *format;
4149 Lisp_Object dirname;
4151 char *buffer
4152 = (char *) alloca (SCHARS (dirname) + strlen (format) + 5);
4154 fprintf (stderr, format, SDATA (dirname));
4155 sprintf (buffer, format, SDATA (dirname));
4156 /* Don't log the warning before we've initialized!! */
4157 if (initialized)
4158 message_dolog (buffer, strlen (buffer), 0, STRING_MULTIBYTE (dirname));
4161 void
4162 syms_of_lread ()
4164 defsubr (&Sread);
4165 defsubr (&Sread_from_string);
4166 defsubr (&Sintern);
4167 defsubr (&Sintern_soft);
4168 defsubr (&Sunintern);
4169 defsubr (&Sget_load_suffixes);
4170 defsubr (&Sload);
4171 defsubr (&Seval_buffer);
4172 defsubr (&Seval_region);
4173 defsubr (&Sread_char);
4174 defsubr (&Sread_char_exclusive);
4175 defsubr (&Sread_event);
4176 defsubr (&Sget_file_char);
4177 defsubr (&Smapatoms);
4178 defsubr (&Slocate_file_internal);
4180 DEFVAR_LISP ("obarray", &Vobarray,
4181 doc: /* Symbol table for use by `intern' and `read'.
4182 It is a vector whose length ought to be prime for best results.
4183 The vector's contents don't make sense if examined from Lisp programs;
4184 to find all the symbols in an obarray, use `mapatoms'. */);
4186 DEFVAR_LISP ("values", &Vvalues,
4187 doc: /* List of values of all expressions which were read, evaluated and printed.
4188 Order is reverse chronological. */);
4190 DEFVAR_LISP ("standard-input", &Vstandard_input,
4191 doc: /* Stream for read to get input from.
4192 See documentation of `read' for possible values. */);
4193 Vstandard_input = Qt;
4195 DEFVAR_LISP ("read-with-symbol-positions", &Vread_with_symbol_positions,
4196 doc: /* If non-nil, add position of read symbols to `read-symbol-positions-list'.
4198 If this variable is a buffer, then only forms read from that buffer
4199 will be added to `read-symbol-positions-list'.
4200 If this variable is t, then all read forms will be added.
4201 The effect of all other values other than nil are not currently
4202 defined, although they may be in the future.
4204 The positions are relative to the last call to `read' or
4205 `read-from-string'. It is probably a bad idea to set this variable at
4206 the toplevel; bind it instead. */);
4207 Vread_with_symbol_positions = Qnil;
4209 DEFVAR_LISP ("read-symbol-positions-list", &Vread_symbol_positions_list,
4210 doc: /* A list mapping read symbols to their positions.
4211 This variable is modified during calls to `read' or
4212 `read-from-string', but only when `read-with-symbol-positions' is
4213 non-nil.
4215 Each element of the list looks like (SYMBOL . CHAR-POSITION), where
4216 CHAR-POSITION is an integer giving the offset of that occurrence of the
4217 symbol from the position where `read' or `read-from-string' started.
4219 Note that a symbol will appear multiple times in this list, if it was
4220 read multiple times. The list is in the same order as the symbols
4221 were read in. */);
4222 Vread_symbol_positions_list = Qnil;
4224 DEFVAR_LISP ("load-path", &Vload_path,
4225 doc: /* *List of directories to search for files to load.
4226 Each element is a string (directory name) or nil (try default directory).
4227 Initialized based on EMACSLOADPATH environment variable, if any,
4228 otherwise to default specified by file `epaths.h' when Emacs was built. */);
4230 DEFVAR_LISP ("load-suffixes", &Vload_suffixes,
4231 doc: /* List of suffixes for (compiled or source) Emacs Lisp files.
4232 This list should not include the empty string.
4233 `load' and related functions try to append these suffixes, in order,
4234 to the specified file name if a Lisp suffix is allowed or required. */);
4235 Vload_suffixes = Fcons (build_string (".elc"),
4236 Fcons (build_string (".el"), Qnil));
4237 DEFVAR_LISP ("load-file-rep-suffixes", &Vload_file_rep_suffixes,
4238 doc: /* List of suffixes that indicate representations of \
4239 the same file.
4240 This list should normally start with the empty string.
4242 Enabling Auto Compression mode appends the suffixes in
4243 `jka-compr-load-suffixes' to this list and disabling Auto Compression
4244 mode removes them again. `load' and related functions use this list to
4245 determine whether they should look for compressed versions of a file
4246 and, if so, which suffixes they should try to append to the file name
4247 in order to do so. However, if you want to customize which suffixes
4248 the loading functions recognize as compression suffixes, you should
4249 customize `jka-compr-load-suffixes' rather than the present variable. */);
4250 Vload_file_rep_suffixes = Fcons (empty_unibyte_string, Qnil);
4252 DEFVAR_BOOL ("load-in-progress", &load_in_progress,
4253 doc: /* Non-nil if inside of `load'. */);
4255 DEFVAR_LISP ("after-load-alist", &Vafter_load_alist,
4256 doc: /* An alist of expressions to be evalled when particular files are loaded.
4257 Each element looks like (REGEXP-OR-FEATURE FORMS...).
4259 REGEXP-OR-FEATURE is either a regular expression to match file names, or
4260 a symbol \(a feature name).
4262 When `load' is run and the file-name argument matches an element's
4263 REGEXP-OR-FEATURE, or when `provide' is run and provides the symbol
4264 REGEXP-OR-FEATURE, the FORMS in the element are executed.
4266 An error in FORMS does not undo the load, but does prevent execution of
4267 the rest of the FORMS. */);
4268 Vafter_load_alist = Qnil;
4270 DEFVAR_LISP ("load-history", &Vload_history,
4271 doc: /* Alist mapping file names to symbols and features.
4272 Each alist element is a list that starts with a file name,
4273 except for one element (optional) that starts with nil and describes
4274 definitions evaluated from buffers not visiting files.
4276 The file name is absolute and is the true file name (i.e. it doesn't
4277 contain symbolic links) of the loaded file.
4279 The remaining elements of each list are symbols defined as variables
4280 and cons cells of the form `(provide . FEATURE)', `(require . FEATURE)',
4281 `(defun . FUNCTION)', `(autoload . SYMBOL)', `(defface . SYMBOL)'
4282 and `(t . SYMBOL)'. An element `(t . SYMBOL)' precedes an entry
4283 `(defun . FUNCTION)', and means that SYMBOL was an autoload before
4284 this file redefined it as a function.
4286 During preloading, the file name recorded is relative to the main Lisp
4287 directory. These file names are converted to absolute at startup. */);
4288 Vload_history = Qnil;
4290 DEFVAR_LISP ("load-file-name", &Vload_file_name,
4291 doc: /* Full name of file being loaded by `load'. */);
4292 Vload_file_name = Qnil;
4294 DEFVAR_LISP ("user-init-file", &Vuser_init_file,
4295 doc: /* File name, including directory, of user's initialization file.
4296 If the file loaded had extension `.elc', and the corresponding source file
4297 exists, this variable contains the name of source file, suitable for use
4298 by functions like `custom-save-all' which edit the init file.
4299 While Emacs loads and evaluates the init file, value is the real name
4300 of the file, regardless of whether or not it has the `.elc' extension. */);
4301 Vuser_init_file = Qnil;
4303 DEFVAR_LISP ("current-load-list", &Vcurrent_load_list,
4304 doc: /* Used for internal purposes by `load'. */);
4305 Vcurrent_load_list = Qnil;
4307 DEFVAR_LISP ("load-read-function", &Vload_read_function,
4308 doc: /* Function used by `load' and `eval-region' for reading expressions.
4309 The default is nil, which means use the function `read'. */);
4310 Vload_read_function = Qnil;
4312 DEFVAR_LISP ("load-source-file-function", &Vload_source_file_function,
4313 doc: /* Function called in `load' for loading an Emacs Lisp source file.
4314 This function is for doing code conversion before reading the source file.
4315 If nil, loading is done without any code conversion.
4316 Arguments are FULLNAME, FILE, NOERROR, NOMESSAGE, where
4317 FULLNAME is the full name of FILE.
4318 See `load' for the meaning of the remaining arguments. */);
4319 Vload_source_file_function = Qnil;
4321 DEFVAR_BOOL ("load-force-doc-strings", &load_force_doc_strings,
4322 doc: /* Non-nil means `load' should force-load all dynamic doc strings.
4323 This is useful when the file being loaded is a temporary copy. */);
4324 load_force_doc_strings = 0;
4326 DEFVAR_BOOL ("load-convert-to-unibyte", &load_convert_to_unibyte,
4327 doc: /* Non-nil means `read' converts strings to unibyte whenever possible.
4328 This is normally bound by `load' and `eval-buffer' to control `read',
4329 and is not meant for users to change. */);
4330 load_convert_to_unibyte = 0;
4332 DEFVAR_LISP ("source-directory", &Vsource_directory,
4333 doc: /* Directory in which Emacs sources were found when Emacs was built.
4334 You cannot count on them to still be there! */);
4335 Vsource_directory
4336 = Fexpand_file_name (build_string ("../"),
4337 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH)));
4339 DEFVAR_LISP ("preloaded-file-list", &Vpreloaded_file_list,
4340 doc: /* List of files that were preloaded (when dumping Emacs). */);
4341 Vpreloaded_file_list = Qnil;
4343 DEFVAR_LISP ("byte-boolean-vars", &Vbyte_boolean_vars,
4344 doc: /* List of all DEFVAR_BOOL variables, used by the byte code optimizer. */);
4345 Vbyte_boolean_vars = Qnil;
4347 DEFVAR_BOOL ("load-dangerous-libraries", &load_dangerous_libraries,
4348 doc: /* Non-nil means load dangerous compiled Lisp files.
4349 Some versions of XEmacs use different byte codes than Emacs. These
4350 incompatible byte codes can make Emacs crash when it tries to execute
4351 them. */);
4352 load_dangerous_libraries = 0;
4354 DEFVAR_LISP ("bytecomp-version-regexp", &Vbytecomp_version_regexp,
4355 doc: /* Regular expression matching safe to load compiled Lisp files.
4356 When Emacs loads a compiled Lisp file, it reads the first 512 bytes
4357 from the file, and matches them against this regular expression.
4358 When the regular expression matches, the file is considered to be safe
4359 to load. See also `load-dangerous-libraries'. */);
4360 Vbytecomp_version_regexp
4361 = build_string ("^;;;.\\(in Emacs version\\|bytecomp version FSF\\)");
4363 DEFVAR_LISP ("eval-buffer-list", &Veval_buffer_list,
4364 doc: /* List of buffers being read from by calls to `eval-buffer' and `eval-region'. */);
4365 Veval_buffer_list = Qnil;
4367 DEFVAR_LISP ("old-style-backquotes", &Vold_style_backquotes,
4368 doc: /* Set to non-nil when `read' encounters an old-style backquote. */);
4369 Vold_style_backquotes = Qnil;
4370 Qold_style_backquotes = intern ("old-style-backquotes");
4371 staticpro (&Qold_style_backquotes);
4373 /* Vsource_directory was initialized in init_lread. */
4375 load_descriptor_list = Qnil;
4376 staticpro (&load_descriptor_list);
4378 Qcurrent_load_list = intern ("current-load-list");
4379 staticpro (&Qcurrent_load_list);
4381 Qstandard_input = intern ("standard-input");
4382 staticpro (&Qstandard_input);
4384 Qread_char = intern ("read-char");
4385 staticpro (&Qread_char);
4387 Qget_file_char = intern ("get-file-char");
4388 staticpro (&Qget_file_char);
4390 Qget_emacs_mule_file_char = intern ("get-emacs-mule-file-char");
4391 staticpro (&Qget_emacs_mule_file_char);
4393 Qload_force_doc_strings = intern ("load-force-doc-strings");
4394 staticpro (&Qload_force_doc_strings);
4396 Qbackquote = intern ("`");
4397 staticpro (&Qbackquote);
4398 Qcomma = intern (",");
4399 staticpro (&Qcomma);
4400 Qcomma_at = intern (",@");
4401 staticpro (&Qcomma_at);
4402 Qcomma_dot = intern (",.");
4403 staticpro (&Qcomma_dot);
4405 Qinhibit_file_name_operation = intern ("inhibit-file-name-operation");
4406 staticpro (&Qinhibit_file_name_operation);
4408 Qascii_character = intern ("ascii-character");
4409 staticpro (&Qascii_character);
4411 Qfunction = intern ("function");
4412 staticpro (&Qfunction);
4414 Qload = intern ("load");
4415 staticpro (&Qload);
4417 Qload_file_name = intern ("load-file-name");
4418 staticpro (&Qload_file_name);
4420 Qeval_buffer_list = intern ("eval-buffer-list");
4421 staticpro (&Qeval_buffer_list);
4423 Qfile_truename = intern ("file-truename");
4424 staticpro (&Qfile_truename) ;
4426 Qdo_after_load_evaluation = intern ("do-after-load-evaluation");
4427 staticpro (&Qdo_after_load_evaluation) ;
4429 staticpro (&dump_path);
4431 staticpro (&read_objects);
4432 read_objects = Qnil;
4433 staticpro (&seen_list);
4434 seen_list = Qnil;
4436 Vloads_in_progress = Qnil;
4437 staticpro (&Vloads_in_progress);
4440 /* arch-tag: a0d02733-0f96-4844-a659-9fd53c4f414d
4441 (do not change this comment) */