(delete-selection-pre-hook): Avoid clearing out
[emacs.git] / src / lread.c
blob271fd98a70c99cbdda3b2cc7979d84cbb077fb93
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 "charset.h"
35 #include <epaths.h>
36 #include "commands.h"
37 #include "keyboard.h"
38 #include "frame.h"
39 #include "termhooks.h"
40 #include "coding.h"
41 #include "blockinput.h"
43 #ifdef lint
44 #include <sys/inode.h>
45 #endif /* lint */
47 #ifdef MSDOS
48 #if __DJGPP__ < 2
49 #include <unistd.h> /* to get X_OK */
50 #endif
51 #include "msdos.h"
52 #endif
54 #ifdef HAVE_UNISTD_H
55 #include <unistd.h>
56 #endif
58 #ifndef X_OK
59 #define X_OK 01
60 #endif
62 #include <math.h>
64 #ifdef HAVE_SETLOCALE
65 #include <locale.h>
66 #endif /* HAVE_SETLOCALE */
68 #ifdef HAVE_FCNTL_H
69 #include <fcntl.h>
70 #endif
71 #ifndef O_RDONLY
72 #define O_RDONLY 0
73 #endif
75 #ifdef HAVE_FSEEKO
76 #define file_offset off_t
77 #define file_tell ftello
78 #else
79 #define file_offset long
80 #define file_tell ftell
81 #endif
83 #ifndef USE_CRT_DLL
84 extern int errno;
85 #endif
87 Lisp_Object Qread_char, Qget_file_char, Qstandard_input, Qcurrent_load_list;
88 Lisp_Object Qvariable_documentation, Vvalues, Vstandard_input, Vafter_load_alist;
89 Lisp_Object Qascii_character, Qload, Qload_file_name;
90 Lisp_Object Qbackquote, Qcomma, Qcomma_at, Qcomma_dot, Qfunction;
91 Lisp_Object Qinhibit_file_name_operation;
92 Lisp_Object Qeval_buffer_list, Veval_buffer_list;
93 Lisp_Object Qfile_truename, Qdo_after_load_evaluation; /* ACM 2006/5/16 */
95 extern Lisp_Object Qevent_symbol_element_mask;
96 extern Lisp_Object Qfile_exists_p;
98 /* non-zero if inside `load' */
99 int load_in_progress;
101 /* Directory in which the sources were found. */
102 Lisp_Object Vsource_directory;
104 /* Search path and suffixes for files to be loaded. */
105 Lisp_Object Vload_path, Vload_suffixes, Vload_file_rep_suffixes;
107 /* File name of user's init file. */
108 Lisp_Object Vuser_init_file;
110 /* This is the user-visible association list that maps features to
111 lists of defs in their load files. */
112 Lisp_Object Vload_history;
114 /* This is used to build the load history. */
115 Lisp_Object Vcurrent_load_list;
117 /* List of files that were preloaded. */
118 Lisp_Object Vpreloaded_file_list;
120 /* Name of file actually being read by `load'. */
121 Lisp_Object Vload_file_name;
123 /* Function to use for reading, in `load' and friends. */
124 Lisp_Object Vload_read_function;
126 /* The association list of objects read with the #n=object form.
127 Each member of the list has the form (n . object), and is used to
128 look up the object for the corresponding #n# construct.
129 It must be set to nil before all top-level calls to read0. */
130 Lisp_Object read_objects;
132 /* Nonzero means load should forcibly load all dynamic doc strings. */
133 static int load_force_doc_strings;
135 /* Nonzero means read should convert strings to unibyte. */
136 static int load_convert_to_unibyte;
138 /* Function to use for loading an Emacs Lisp source file (not
139 compiled) instead of readevalloop. */
140 Lisp_Object Vload_source_file_function;
142 /* List of all DEFVAR_BOOL variables. Used by the byte optimizer. */
143 Lisp_Object Vbyte_boolean_vars;
145 /* Whether or not to add a `read-positions' property to symbols
146 read. */
147 Lisp_Object Vread_with_symbol_positions;
149 /* List of (SYMBOL . POSITION) accumulated so far. */
150 Lisp_Object Vread_symbol_positions_list;
152 /* List of descriptors now open for Fload. */
153 static Lisp_Object load_descriptor_list;
155 /* File for get_file_char to read from. Use by load. */
156 static FILE *instream;
158 /* When nonzero, read conses in pure space */
159 static int read_pure;
161 /* For use within read-from-string (this reader is non-reentrant!!) */
162 static int read_from_string_index;
163 static int read_from_string_index_byte;
164 static int read_from_string_limit;
166 /* Number of bytes left to read in the buffer character
167 that `readchar' has already advanced over. */
168 static int readchar_backlog;
169 /* Number of characters read in the current call to Fread or
170 Fread_from_string. */
171 static int readchar_count;
173 /* This contains the last string skipped with #@. */
174 static char *saved_doc_string;
175 /* Length of buffer allocated in saved_doc_string. */
176 static int saved_doc_string_size;
177 /* Length of actual data in saved_doc_string. */
178 static int saved_doc_string_length;
179 /* This is the file position that string came from. */
180 static file_offset saved_doc_string_position;
182 /* This contains the previous string skipped with #@.
183 We copy it from saved_doc_string when a new string
184 is put in saved_doc_string. */
185 static char *prev_saved_doc_string;
186 /* Length of buffer allocated in prev_saved_doc_string. */
187 static int prev_saved_doc_string_size;
188 /* Length of actual data in prev_saved_doc_string. */
189 static int prev_saved_doc_string_length;
190 /* This is the file position that string came from. */
191 static file_offset prev_saved_doc_string_position;
193 /* Nonzero means inside a new-style backquote
194 with no surrounding parentheses.
195 Fread initializes this to zero, so we need not specbind it
196 or worry about what happens to it when there is an error. */
197 static int new_backquote_flag;
198 static Lisp_Object Vold_style_backquotes, Qold_style_backquotes;
200 /* A list of file names for files being loaded in Fload. Used to
201 check for recursive loads. */
203 static Lisp_Object Vloads_in_progress;
205 /* Non-zero means load dangerous compiled Lisp files. */
207 int load_dangerous_libraries;
209 /* A regular expression used to detect files compiled with Emacs. */
211 static Lisp_Object Vbytecomp_version_regexp;
213 static void to_multibyte P_ ((char **, char **, int *));
214 static void readevalloop P_ ((Lisp_Object, FILE*, Lisp_Object,
215 Lisp_Object (*) (), int,
216 Lisp_Object, Lisp_Object,
217 Lisp_Object, Lisp_Object));
218 static Lisp_Object load_unwind P_ ((Lisp_Object));
219 static Lisp_Object load_descriptor_unwind P_ ((Lisp_Object));
221 static void invalid_syntax P_ ((const char *, int)) NO_RETURN;
222 static void end_of_file_error P_ (()) NO_RETURN;
225 /* Handle unreading and rereading of characters.
226 Write READCHAR to read a character,
227 UNREAD(c) to unread c to be read again.
229 The READCHAR and UNREAD macros are meant for reading/unreading a
230 byte code; they do not handle multibyte characters. The caller
231 should manage them if necessary.
233 [ Actually that seems to be a lie; READCHAR will definitely read
234 multibyte characters from buffer sources, at least. Is the
235 comment just out of date?
236 -- Colin Walters <walters@gnu.org>, 22 May 2002 16:36:50 -0400 ]
239 #define READCHAR readchar (readcharfun)
240 #define UNREAD(c) unreadchar (readcharfun, c)
242 static int
243 readchar (readcharfun)
244 Lisp_Object readcharfun;
246 Lisp_Object tem;
247 register int c;
249 readchar_count++;
251 if (BUFFERP (readcharfun))
253 register struct buffer *inbuffer = XBUFFER (readcharfun);
255 int pt_byte = BUF_PT_BYTE (inbuffer);
256 int orig_pt_byte = pt_byte;
258 if (readchar_backlog > 0)
259 /* We get the address of the byte just passed,
260 which is the last byte of the character.
261 The other bytes in this character are consecutive with it,
262 because the gap can't be in the middle of a character. */
263 return *(BUF_BYTE_ADDRESS (inbuffer, BUF_PT_BYTE (inbuffer) - 1)
264 - --readchar_backlog);
266 if (pt_byte >= BUF_ZV_BYTE (inbuffer))
267 return -1;
269 readchar_backlog = -1;
271 if (! NILP (inbuffer->enable_multibyte_characters))
273 /* Fetch the character code from the buffer. */
274 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, pt_byte);
275 BUF_INC_POS (inbuffer, pt_byte);
276 c = STRING_CHAR (p, pt_byte - orig_pt_byte);
278 else
280 c = BUF_FETCH_BYTE (inbuffer, pt_byte);
281 pt_byte++;
283 SET_BUF_PT_BOTH (inbuffer, BUF_PT (inbuffer) + 1, pt_byte);
285 return c;
287 if (MARKERP (readcharfun))
289 register struct buffer *inbuffer = XMARKER (readcharfun)->buffer;
291 int bytepos = marker_byte_position (readcharfun);
292 int orig_bytepos = bytepos;
294 if (readchar_backlog > 0)
295 /* We get the address of the byte just passed,
296 which is the last byte of the character.
297 The other bytes in this character are consecutive with it,
298 because the gap can't be in the middle of a character. */
299 return *(BUF_BYTE_ADDRESS (inbuffer, XMARKER (readcharfun)->bytepos - 1)
300 - --readchar_backlog);
302 if (bytepos >= BUF_ZV_BYTE (inbuffer))
303 return -1;
305 readchar_backlog = -1;
307 if (! NILP (inbuffer->enable_multibyte_characters))
309 /* Fetch the character code from the buffer. */
310 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, bytepos);
311 BUF_INC_POS (inbuffer, bytepos);
312 c = STRING_CHAR (p, bytepos - orig_bytepos);
314 else
316 c = BUF_FETCH_BYTE (inbuffer, bytepos);
317 bytepos++;
320 XMARKER (readcharfun)->bytepos = bytepos;
321 XMARKER (readcharfun)->charpos++;
323 return c;
326 if (EQ (readcharfun, Qlambda))
327 return read_bytecode_char (0);
329 if (EQ (readcharfun, Qget_file_char))
331 BLOCK_INPUT;
332 c = getc (instream);
333 #ifdef EINTR
334 /* Interrupted reads have been observed while reading over the network */
335 while (c == EOF && ferror (instream) && errno == EINTR)
337 UNBLOCK_INPUT;
338 QUIT;
339 BLOCK_INPUT;
340 clearerr (instream);
341 c = getc (instream);
343 #endif
344 UNBLOCK_INPUT;
345 return c;
348 if (STRINGP (readcharfun))
350 if (read_from_string_index >= read_from_string_limit)
351 c = -1;
352 else
353 FETCH_STRING_CHAR_ADVANCE (c, readcharfun,
354 read_from_string_index,
355 read_from_string_index_byte);
357 return c;
360 tem = call0 (readcharfun);
362 if (NILP (tem))
363 return -1;
364 return XINT (tem);
367 /* Unread the character C in the way appropriate for the stream READCHARFUN.
368 If the stream is a user function, call it with the char as argument. */
370 static void
371 unreadchar (readcharfun, c)
372 Lisp_Object readcharfun;
373 int c;
375 readchar_count--;
376 if (c == -1)
377 /* Don't back up the pointer if we're unreading the end-of-input mark,
378 since readchar didn't advance it when we read it. */
380 else if (BUFFERP (readcharfun))
382 struct buffer *b = XBUFFER (readcharfun);
383 int bytepos = BUF_PT_BYTE (b);
385 if (readchar_backlog >= 0)
386 readchar_backlog++;
387 else
389 BUF_PT (b)--;
390 if (! NILP (b->enable_multibyte_characters))
391 BUF_DEC_POS (b, bytepos);
392 else
393 bytepos--;
395 BUF_PT_BYTE (b) = bytepos;
398 else if (MARKERP (readcharfun))
400 struct buffer *b = XMARKER (readcharfun)->buffer;
401 int bytepos = XMARKER (readcharfun)->bytepos;
403 if (readchar_backlog >= 0)
404 readchar_backlog++;
405 else
407 XMARKER (readcharfun)->charpos--;
408 if (! NILP (b->enable_multibyte_characters))
409 BUF_DEC_POS (b, bytepos);
410 else
411 bytepos--;
413 XMARKER (readcharfun)->bytepos = bytepos;
416 else if (STRINGP (readcharfun))
418 read_from_string_index--;
419 read_from_string_index_byte
420 = string_char_to_byte (readcharfun, read_from_string_index);
422 else if (EQ (readcharfun, Qlambda))
423 read_bytecode_char (1);
424 else if (EQ (readcharfun, Qget_file_char))
426 BLOCK_INPUT;
427 ungetc (c, instream);
428 UNBLOCK_INPUT;
430 else
431 call1 (readcharfun, make_number (c));
434 static Lisp_Object read_internal_start P_ ((Lisp_Object, Lisp_Object,
435 Lisp_Object));
436 static Lisp_Object read0 P_ ((Lisp_Object));
437 static Lisp_Object read1 P_ ((Lisp_Object, int *, int));
439 static Lisp_Object read_list P_ ((int, Lisp_Object));
440 static Lisp_Object read_vector P_ ((Lisp_Object, int));
441 static int read_multibyte P_ ((int, Lisp_Object));
443 static Lisp_Object substitute_object_recurse P_ ((Lisp_Object, Lisp_Object,
444 Lisp_Object));
445 static void substitute_object_in_subtree P_ ((Lisp_Object,
446 Lisp_Object));
447 static void substitute_in_interval P_ ((INTERVAL, Lisp_Object));
450 /* Get a character from the tty. */
452 /* Read input events until we get one that's acceptable for our purposes.
454 If NO_SWITCH_FRAME is non-zero, switch-frame events are stashed
455 until we get a character we like, and then stuffed into
456 unread_switch_frame.
458 If ASCII_REQUIRED is non-zero, we check function key events to see
459 if the unmodified version of the symbol has a Qascii_character
460 property, and use that character, if present.
462 If ERROR_NONASCII is non-zero, we signal an error if the input we
463 get isn't an ASCII character with modifiers. If it's zero but
464 ASCII_REQUIRED is non-zero, we just re-read until we get an ASCII
465 character.
467 If INPUT_METHOD is nonzero, we invoke the current input method
468 if the character warrants that.
470 If SECONDS is a number, we wait that many seconds for input, and
471 return Qnil if no input arrives within that time. */
473 Lisp_Object
474 read_filtered_event (no_switch_frame, ascii_required, error_nonascii,
475 input_method, seconds)
476 int no_switch_frame, ascii_required, error_nonascii, input_method;
477 Lisp_Object seconds;
479 Lisp_Object val, delayed_switch_frame;
480 EMACS_TIME end_time;
482 #ifdef HAVE_WINDOW_SYSTEM
483 if (display_hourglass_p)
484 cancel_hourglass ();
485 #endif
487 delayed_switch_frame = Qnil;
489 /* Compute timeout. */
490 if (NUMBERP (seconds))
492 EMACS_TIME wait_time;
493 int sec, usec;
494 double duration = extract_float (seconds);
496 sec = (int) duration;
497 usec = (duration - sec) * 1000000;
498 EMACS_GET_TIME (end_time);
499 EMACS_SET_SECS_USECS (wait_time, sec, usec);
500 EMACS_ADD_TIME (end_time, end_time, wait_time);
503 /* Read until we get an acceptable event. */
504 retry:
506 val = read_char (0, 0, 0, (input_method ? Qnil : Qt), 0,
507 NUMBERP (seconds) ? &end_time : NULL);
508 while (INTEGERP (val) && XINT (val) == -2); /* wrong_kboard_jmpbuf */
510 if (BUFFERP (val))
511 goto retry;
513 /* switch-frame events are put off until after the next ASCII
514 character. This is better than signaling an error just because
515 the last characters were typed to a separate minibuffer frame,
516 for example. Eventually, some code which can deal with
517 switch-frame events will read it and process it. */
518 if (no_switch_frame
519 && EVENT_HAS_PARAMETERS (val)
520 && EQ (EVENT_HEAD_KIND (EVENT_HEAD (val)), Qswitch_frame))
522 delayed_switch_frame = val;
523 goto retry;
526 if (ascii_required && !(NUMBERP (seconds) && NILP (val)))
528 /* Convert certain symbols to their ASCII equivalents. */
529 if (SYMBOLP (val))
531 Lisp_Object tem, tem1;
532 tem = Fget (val, Qevent_symbol_element_mask);
533 if (!NILP (tem))
535 tem1 = Fget (Fcar (tem), Qascii_character);
536 /* Merge this symbol's modifier bits
537 with the ASCII equivalent of its basic code. */
538 if (!NILP (tem1))
539 XSETFASTINT (val, XINT (tem1) | XINT (Fcar (Fcdr (tem))));
543 /* If we don't have a character now, deal with it appropriately. */
544 if (!INTEGERP (val))
546 if (error_nonascii)
548 Vunread_command_events = Fcons (val, Qnil);
549 error ("Non-character input-event");
551 else
552 goto retry;
556 if (! NILP (delayed_switch_frame))
557 unread_switch_frame = delayed_switch_frame;
559 #if 0
561 #ifdef HAVE_WINDOW_SYSTEM
562 if (display_hourglass_p)
563 start_hourglass ();
564 #endif
566 #endif
568 return val;
571 DEFUN ("read-char", Fread_char, Sread_char, 0, 3, 0,
572 doc: /* Read a character from the command input (keyboard or macro).
573 It is returned as a number.
574 If the user generates an event which is not a character (i.e. a mouse
575 click or function key event), `read-char' signals an error. As an
576 exception, switch-frame events are put off until non-ASCII events can
577 be read.
578 If you want to read non-character events, or ignore them, call
579 `read-event' or `read-char-exclusive' instead.
581 If the optional argument PROMPT is non-nil, display that as a prompt.
582 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
583 input method is turned on in the current buffer, that input method
584 is used for reading a character.
585 If the optional argument SECONDS is non-nil, it should be a number
586 specifying the maximum number of seconds to wait for input. If no
587 input arrives in that time, return nil. SECONDS may be a
588 floating-point value. */)
589 (prompt, inherit_input_method, seconds)
590 Lisp_Object prompt, inherit_input_method, seconds;
592 if (! NILP (prompt))
593 message_with_string ("%s", prompt, 0);
594 return read_filtered_event (1, 1, 1, ! NILP (inherit_input_method), seconds);
597 DEFUN ("read-event", Fread_event, Sread_event, 0, 3, 0,
598 doc: /* Read an event object from the input stream.
599 If the optional argument PROMPT is non-nil, display that as a prompt.
600 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
601 input method is turned on in the current buffer, that input method
602 is used for reading a character.
603 If the optional argument SECONDS is non-nil, it should be a number
604 specifying the maximum number of seconds to wait for input. If no
605 input arrives in that time, return nil. SECONDS may be a
606 floating-point value. */)
607 (prompt, inherit_input_method, seconds)
608 Lisp_Object prompt, inherit_input_method, seconds;
610 if (! NILP (prompt))
611 message_with_string ("%s", prompt, 0);
612 return read_filtered_event (0, 0, 0, ! NILP (inherit_input_method), seconds);
615 DEFUN ("read-char-exclusive", Fread_char_exclusive, Sread_char_exclusive, 0, 3, 0,
616 doc: /* Read a character from the command input (keyboard or macro).
617 It is returned as a number. Non-character events are ignored.
619 If the optional argument PROMPT is non-nil, display that as a prompt.
620 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
621 input method is turned on in the current buffer, that input method
622 is used for reading a character.
623 If the optional argument SECONDS is non-nil, it should be a number
624 specifying the maximum number of seconds to wait for input. If no
625 input arrives in that time, return nil. SECONDS may be a
626 floating-point value. */)
627 (prompt, inherit_input_method, seconds)
628 Lisp_Object prompt, inherit_input_method, seconds;
630 if (! NILP (prompt))
631 message_with_string ("%s", prompt, 0);
632 return read_filtered_event (1, 1, 0, ! NILP (inherit_input_method), seconds);
635 DEFUN ("get-file-char", Fget_file_char, Sget_file_char, 0, 0, 0,
636 doc: /* Don't use this yourself. */)
639 register Lisp_Object val;
640 BLOCK_INPUT;
641 XSETINT (val, getc (instream));
642 UNBLOCK_INPUT;
643 return val;
648 /* Value is non-zero if the file associated with file descriptor FD
649 is a compiled Lisp file that's safe to load. Only files compiled
650 with Emacs are safe to load. Files compiled with XEmacs can lead
651 to a crash in Fbyte_code because of an incompatible change in the
652 byte compiler. */
654 static int
655 safe_to_load_p (fd)
656 int fd;
658 char buf[512];
659 int nbytes, i;
660 int safe_p = 1;
662 /* Read the first few bytes from the file, and look for a line
663 specifying the byte compiler version used. */
664 nbytes = emacs_read (fd, buf, sizeof buf - 1);
665 if (nbytes > 0)
667 buf[nbytes] = '\0';
669 /* Skip to the next newline, skipping over the initial `ELC'
670 with NUL bytes following it. */
671 for (i = 0; i < nbytes && buf[i] != '\n'; ++i)
674 if (i < nbytes
675 && fast_c_string_match_ignore_case (Vbytecomp_version_regexp,
676 buf + i) < 0)
677 safe_p = 0;
680 lseek (fd, 0, SEEK_SET);
681 return safe_p;
685 /* Callback for record_unwind_protect. Restore the old load list OLD,
686 after loading a file successfully. */
688 static Lisp_Object
689 record_load_unwind (old)
690 Lisp_Object old;
692 return Vloads_in_progress = old;
695 /* This handler function is used via internal_condition_case_1. */
697 static Lisp_Object
698 load_error_handler (data)
699 Lisp_Object data;
701 return Qnil;
704 static Lisp_Object
705 load_warn_old_style_backquotes (file)
706 Lisp_Object file;
708 if (!NILP (Vold_style_backquotes))
710 Lisp_Object args[2];
711 args[0] = build_string ("Loading `%s': old-style backquotes detected!");
712 args[1] = file;
713 Fmessage (2, args);
715 return Qnil;
718 DEFUN ("get-load-suffixes", Fget_load_suffixes, Sget_load_suffixes, 0, 0, 0,
719 doc: /* Return the suffixes that `load' should try if a suffix is \
720 required.
721 This uses the variables `load-suffixes' and `load-file-rep-suffixes'. */)
724 Lisp_Object lst = Qnil, suffixes = Vload_suffixes, suffix, ext;
725 while (CONSP (suffixes))
727 Lisp_Object exts = Vload_file_rep_suffixes;
728 suffix = XCAR (suffixes);
729 suffixes = XCDR (suffixes);
730 while (CONSP (exts))
732 ext = XCAR (exts);
733 exts = XCDR (exts);
734 lst = Fcons (concat2 (suffix, ext), lst);
737 return Fnreverse (lst);
740 DEFUN ("load", Fload, Sload, 1, 5, 0,
741 doc: /* Execute a file of Lisp code named FILE.
742 First try FILE with `.elc' appended, then try with `.el',
743 then try FILE unmodified (the exact suffixes in the exact order are
744 determined by `load-suffixes'). Environment variable references in
745 FILE are replaced with their values by calling `substitute-in-file-name'.
746 This function searches the directories in `load-path'.
748 If optional second arg NOERROR is non-nil,
749 report no error if FILE doesn't exist.
750 Print messages at start and end of loading unless
751 optional third arg NOMESSAGE is non-nil.
752 If optional fourth arg NOSUFFIX is non-nil, don't try adding
753 suffixes `.elc' or `.el' to the specified name FILE.
754 If optional fifth arg MUST-SUFFIX is non-nil, insist on
755 the suffix `.elc' or `.el'; don't accept just FILE unless
756 it ends in one of those suffixes or includes a directory name.
758 If this function fails to find a file, it may look for different
759 representations of that file before trying another file.
760 It does so by adding the non-empty suffixes in `load-file-rep-suffixes'
761 to the file name. Emacs uses this feature mainly to find compressed
762 versions of files when Auto Compression mode is enabled.
764 The exact suffixes that this function tries out, in the exact order,
765 are given by the value of the variable `load-file-rep-suffixes' if
766 NOSUFFIX is non-nil and by the return value of the function
767 `get-load-suffixes' if MUST-SUFFIX is non-nil. If both NOSUFFIX and
768 MUST-SUFFIX are nil, this function first tries out the latter suffixes
769 and then the former.
771 Loading a file records its definitions, and its `provide' and
772 `require' calls, in an element of `load-history' whose
773 car is the file name loaded. See `load-history'.
775 Return t if the file exists and loads successfully. */)
776 (file, noerror, nomessage, nosuffix, must_suffix)
777 Lisp_Object file, noerror, nomessage, nosuffix, must_suffix;
779 register FILE *stream;
780 register int fd = -1;
781 int count = SPECPDL_INDEX ();
782 struct gcpro gcpro1, gcpro2, gcpro3;
783 Lisp_Object found, efound, hist_file_name;
784 /* 1 means we printed the ".el is newer" message. */
785 int newer = 0;
786 /* 1 means we are loading a compiled file. */
787 int compiled = 0;
788 Lisp_Object handler;
789 int safe_p = 1;
790 char *fmode = "r";
791 Lisp_Object tmp[2];
792 #ifdef DOS_NT
793 fmode = "rt";
794 #endif /* DOS_NT */
796 CHECK_STRING (file);
798 /* If file name is magic, call the handler. */
799 /* This shouldn't be necessary any more now that `openp' handles it right.
800 handler = Ffind_file_name_handler (file, Qload);
801 if (!NILP (handler))
802 return call5 (handler, Qload, file, noerror, nomessage, nosuffix); */
804 /* Do this after the handler to avoid
805 the need to gcpro noerror, nomessage and nosuffix.
806 (Below here, we care only whether they are nil or not.)
807 The presence of this call is the result of a historical accident:
808 it used to be in every file-operation and when it got removed
809 everywhere, it accidentally stayed here. Since then, enough people
810 supposedly have things like (load "$PROJECT/foo.el") in their .emacs
811 that it seemed risky to remove. */
812 if (! NILP (noerror))
814 file = internal_condition_case_1 (Fsubstitute_in_file_name, file,
815 Qt, load_error_handler);
816 if (NILP (file))
817 return Qnil;
819 else
820 file = Fsubstitute_in_file_name (file);
823 /* Avoid weird lossage with null string as arg,
824 since it would try to load a directory as a Lisp file */
825 if (SCHARS (file) > 0)
827 int size = SBYTES (file);
829 found = Qnil;
830 GCPRO2 (file, found);
832 if (! NILP (must_suffix))
834 /* Don't insist on adding a suffix if FILE already ends with one. */
835 if (size > 3
836 && !strcmp (SDATA (file) + size - 3, ".el"))
837 must_suffix = Qnil;
838 else if (size > 4
839 && !strcmp (SDATA (file) + size - 4, ".elc"))
840 must_suffix = Qnil;
841 /* Don't insist on adding a suffix
842 if the argument includes a directory name. */
843 else if (! NILP (Ffile_name_directory (file)))
844 must_suffix = Qnil;
847 fd = openp (Vload_path, file,
848 (!NILP (nosuffix) ? Qnil
849 : !NILP (must_suffix) ? Fget_load_suffixes ()
850 : Fappend (2, (tmp[0] = Fget_load_suffixes (),
851 tmp[1] = Vload_file_rep_suffixes,
852 tmp))),
853 &found, Qnil);
854 UNGCPRO;
857 if (fd == -1)
859 if (NILP (noerror))
860 xsignal2 (Qfile_error, build_string ("Cannot open load file"), file);
861 return Qnil;
864 /* Tell startup.el whether or not we found the user's init file. */
865 if (EQ (Qt, Vuser_init_file))
866 Vuser_init_file = found;
868 /* If FD is -2, that means openp found a magic file. */
869 if (fd == -2)
871 if (NILP (Fequal (found, file)))
872 /* If FOUND is a different file name from FILE,
873 find its handler even if we have already inhibited
874 the `load' operation on FILE. */
875 handler = Ffind_file_name_handler (found, Qt);
876 else
877 handler = Ffind_file_name_handler (found, Qload);
878 if (! NILP (handler))
879 return call5 (handler, Qload, found, noerror, nomessage, Qt);
882 /* Check if we're stuck in a recursive load cycle.
884 2000-09-21: It's not possible to just check for the file loaded
885 being a member of Vloads_in_progress. This fails because of the
886 way the byte compiler currently works; `provide's are not
887 evaluted, see font-lock.el/jit-lock.el as an example. This
888 leads to a certain amount of ``normal'' recursion.
890 Also, just loading a file recursively is not always an error in
891 the general case; the second load may do something different. */
893 int count = 0;
894 Lisp_Object tem;
895 for (tem = Vloads_in_progress; CONSP (tem); tem = XCDR (tem))
896 if (!NILP (Fequal (found, XCAR (tem))))
897 count++;
898 if (count > 3)
900 if (fd >= 0)
901 emacs_close (fd);
902 signal_error ("Recursive load", Fcons (found, Vloads_in_progress));
904 record_unwind_protect (record_load_unwind, Vloads_in_progress);
905 Vloads_in_progress = Fcons (found, Vloads_in_progress);
908 /* Get the name for load-history. */
909 hist_file_name = (! NILP (Vpurify_flag)
910 ? Fconcat (2, (tmp[0] = Ffile_name_directory (file),
911 tmp[1] = Ffile_name_nondirectory (found),
912 tmp))
913 : found) ;
915 /* Check for the presence of old-style quotes and warn about them. */
916 specbind (Qold_style_backquotes, Qnil);
917 record_unwind_protect (load_warn_old_style_backquotes, file);
919 if (!bcmp (SDATA (found) + SBYTES (found) - 4,
920 ".elc", 4))
921 /* Load .elc files directly, but not when they are
922 remote and have no handler! */
924 if (fd != -2)
926 struct stat s1, s2;
927 int result;
929 GCPRO3 (file, found, hist_file_name);
931 if (!safe_to_load_p (fd))
933 safe_p = 0;
934 if (!load_dangerous_libraries)
936 if (fd >= 0)
937 emacs_close (fd);
938 error ("File `%s' was not compiled in Emacs",
939 SDATA (found));
941 else if (!NILP (nomessage))
942 message_with_string ("File `%s' not compiled in Emacs", found, 1);
945 compiled = 1;
947 efound = ENCODE_FILE (found);
949 #ifdef DOS_NT
950 fmode = "rb";
951 #endif /* DOS_NT */
952 stat ((char *)SDATA (efound), &s1);
953 SSET (efound, SBYTES (efound) - 1, 0);
954 result = stat ((char *)SDATA (efound), &s2);
955 SSET (efound, SBYTES (efound) - 1, 'c');
957 if (result >= 0 && (unsigned) s1.st_mtime < (unsigned) s2.st_mtime)
959 /* Make the progress messages mention that source is newer. */
960 newer = 1;
962 /* If we won't print another message, mention this anyway. */
963 if (!NILP (nomessage))
965 Lisp_Object msg_file;
966 msg_file = Fsubstring (found, make_number (0), make_number (-1));
967 message_with_string ("Source file `%s' newer than byte-compiled file",
968 msg_file, 1);
971 UNGCPRO;
974 else
976 /* We are loading a source file (*.el). */
977 if (!NILP (Vload_source_file_function))
979 Lisp_Object val;
981 if (fd >= 0)
982 emacs_close (fd);
983 val = call4 (Vload_source_file_function, found, hist_file_name,
984 NILP (noerror) ? Qnil : Qt,
985 NILP (nomessage) ? Qnil : Qt);
986 return unbind_to (count, val);
990 GCPRO3 (file, found, hist_file_name);
992 #ifdef WINDOWSNT
993 emacs_close (fd);
994 efound = ENCODE_FILE (found);
995 stream = fopen ((char *) SDATA (efound), fmode);
996 #else /* not WINDOWSNT */
997 stream = fdopen (fd, fmode);
998 #endif /* not WINDOWSNT */
999 if (stream == 0)
1001 emacs_close (fd);
1002 error ("Failure to create stdio stream for %s", SDATA (file));
1005 if (! NILP (Vpurify_flag))
1006 Vpreloaded_file_list = Fcons (file, Vpreloaded_file_list);
1008 if (NILP (nomessage))
1010 if (!safe_p)
1011 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...",
1012 file, 1);
1013 else if (!compiled)
1014 message_with_string ("Loading %s (source)...", file, 1);
1015 else if (newer)
1016 message_with_string ("Loading %s (compiled; note, source file is newer)...",
1017 file, 1);
1018 else /* The typical case; compiled file newer than source file. */
1019 message_with_string ("Loading %s...", file, 1);
1022 record_unwind_protect (load_unwind, make_save_value (stream, 0));
1023 record_unwind_protect (load_descriptor_unwind, load_descriptor_list);
1024 specbind (Qload_file_name, found);
1025 specbind (Qinhibit_file_name_operation, Qnil);
1026 load_descriptor_list
1027 = Fcons (make_number (fileno (stream)), load_descriptor_list);
1028 load_in_progress++;
1029 readevalloop (Qget_file_char, stream, hist_file_name,
1030 Feval, 0, Qnil, Qnil, Qnil, Qnil);
1031 unbind_to (count, Qnil);
1033 /* Run any eval-after-load forms for this file */
1034 if (NILP (Vpurify_flag)
1035 && (!NILP (Ffboundp (Qdo_after_load_evaluation))))
1036 call1 (Qdo_after_load_evaluation, hist_file_name) ;
1038 UNGCPRO;
1040 if (saved_doc_string)
1041 free (saved_doc_string);
1042 saved_doc_string = 0;
1043 saved_doc_string_size = 0;
1045 if (prev_saved_doc_string)
1046 xfree (prev_saved_doc_string);
1047 prev_saved_doc_string = 0;
1048 prev_saved_doc_string_size = 0;
1050 if (!noninteractive && NILP (nomessage))
1052 if (!safe_p)
1053 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...done",
1054 file, 1);
1055 else if (!compiled)
1056 message_with_string ("Loading %s (source)...done", file, 1);
1057 else if (newer)
1058 message_with_string ("Loading %s (compiled; note, source file is newer)...done",
1059 file, 1);
1060 else /* The typical case; compiled file newer than source file. */
1061 message_with_string ("Loading %s...done", file, 1);
1064 if (!NILP (Fequal (build_string ("obsolete"),
1065 Ffile_name_nondirectory
1066 (Fdirectory_file_name (Ffile_name_directory (found))))))
1067 message_with_string ("Package %s is obsolete", file, 1);
1069 return Qt;
1072 static Lisp_Object
1073 load_unwind (arg) /* used as unwind-protect function in load */
1074 Lisp_Object arg;
1076 FILE *stream = (FILE *) XSAVE_VALUE (arg)->pointer;
1077 if (stream != NULL)
1079 BLOCK_INPUT;
1080 fclose (stream);
1081 UNBLOCK_INPUT;
1083 if (--load_in_progress < 0) load_in_progress = 0;
1084 return Qnil;
1087 static Lisp_Object
1088 load_descriptor_unwind (oldlist)
1089 Lisp_Object oldlist;
1091 load_descriptor_list = oldlist;
1092 return Qnil;
1095 /* Close all descriptors in use for Floads.
1096 This is used when starting a subprocess. */
1098 void
1099 close_load_descs ()
1101 #ifndef WINDOWSNT
1102 Lisp_Object tail;
1103 for (tail = load_descriptor_list; CONSP (tail); tail = XCDR (tail))
1104 emacs_close (XFASTINT (XCAR (tail)));
1105 #endif
1108 static int
1109 complete_filename_p (pathname)
1110 Lisp_Object pathname;
1112 register const unsigned char *s = SDATA (pathname);
1113 return (IS_DIRECTORY_SEP (s[0])
1114 || (SCHARS (pathname) > 2
1115 && IS_DEVICE_SEP (s[1]) && IS_DIRECTORY_SEP (s[2]))
1116 #ifdef VMS
1117 || index (s, ':')
1118 #endif /* VMS */
1122 DEFUN ("locate-file-internal", Flocate_file_internal, Slocate_file_internal, 2, 4, 0,
1123 doc: /* Search for FILENAME through PATH.
1124 Returns the file's name in absolute form, or nil if not found.
1125 If SUFFIXES is non-nil, it should be a list of suffixes to append to
1126 file name when searching.
1127 If non-nil, PREDICATE is used instead of `file-readable-p'.
1128 PREDICATE can also be an integer to pass to the access(2) function,
1129 in which case file-name-handlers are ignored. */)
1130 (filename, path, suffixes, predicate)
1131 Lisp_Object filename, path, suffixes, predicate;
1133 Lisp_Object file;
1134 int fd = openp (path, filename, suffixes, &file, predicate);
1135 if (NILP (predicate) && fd > 0)
1136 close (fd);
1137 return file;
1141 /* Search for a file whose name is STR, looking in directories
1142 in the Lisp list PATH, and trying suffixes from SUFFIX.
1143 On success, returns a file descriptor. On failure, returns -1.
1145 SUFFIXES is a list of strings containing possible suffixes.
1146 The empty suffix is automatically added if the list is empty.
1148 PREDICATE non-nil means don't open the files,
1149 just look for one that satisfies the predicate. In this case,
1150 returns 1 on success. The predicate can be a lisp function or
1151 an integer to pass to `access' (in which case file-name-handlers
1152 are ignored).
1154 If STOREPTR is nonzero, it points to a slot where the name of
1155 the file actually found should be stored as a Lisp string.
1156 nil is stored there on failure.
1158 If the file we find is remote, return -2
1159 but store the found remote file name in *STOREPTR. */
1162 openp (path, str, suffixes, storeptr, predicate)
1163 Lisp_Object path, str;
1164 Lisp_Object suffixes;
1165 Lisp_Object *storeptr;
1166 Lisp_Object predicate;
1168 register int fd;
1169 int fn_size = 100;
1170 char buf[100];
1171 register char *fn = buf;
1172 int absolute = 0;
1173 int want_size;
1174 Lisp_Object filename;
1175 struct stat st;
1176 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5, gcpro6;
1177 Lisp_Object string, tail, encoded_fn;
1178 int max_suffix_len = 0;
1180 CHECK_STRING (str);
1182 for (tail = suffixes; CONSP (tail); tail = XCDR (tail))
1184 CHECK_STRING_CAR (tail);
1185 max_suffix_len = max (max_suffix_len,
1186 SBYTES (XCAR (tail)));
1189 string = filename = encoded_fn = Qnil;
1190 GCPRO6 (str, string, filename, path, suffixes, encoded_fn);
1192 if (storeptr)
1193 *storeptr = Qnil;
1195 if (complete_filename_p (str))
1196 absolute = 1;
1198 for (; CONSP (path); path = XCDR (path))
1200 filename = Fexpand_file_name (str, XCAR (path));
1201 if (!complete_filename_p (filename))
1202 /* If there are non-absolute elts in PATH (eg ".") */
1203 /* Of course, this could conceivably lose if luser sets
1204 default-directory to be something non-absolute... */
1206 filename = Fexpand_file_name (filename, current_buffer->directory);
1207 if (!complete_filename_p (filename))
1208 /* Give up on this path element! */
1209 continue;
1212 /* Calculate maximum size of any filename made from
1213 this path element/specified file name and any possible suffix. */
1214 want_size = max_suffix_len + SBYTES (filename) + 1;
1215 if (fn_size < want_size)
1216 fn = (char *) alloca (fn_size = 100 + want_size);
1218 /* Loop over suffixes. */
1219 for (tail = NILP (suffixes) ? Fcons (empty_unibyte_string, Qnil) : suffixes;
1220 CONSP (tail); tail = XCDR (tail))
1222 int lsuffix = SBYTES (XCAR (tail));
1223 Lisp_Object handler;
1224 int exists;
1226 /* Concatenate path element/specified name with the suffix.
1227 If the directory starts with /:, remove that. */
1228 if (SCHARS (filename) > 2
1229 && SREF (filename, 0) == '/'
1230 && SREF (filename, 1) == ':')
1232 strncpy (fn, SDATA (filename) + 2,
1233 SBYTES (filename) - 2);
1234 fn[SBYTES (filename) - 2] = 0;
1236 else
1238 strncpy (fn, SDATA (filename),
1239 SBYTES (filename));
1240 fn[SBYTES (filename)] = 0;
1243 if (lsuffix != 0) /* Bug happens on CCI if lsuffix is 0. */
1244 strncat (fn, SDATA (XCAR (tail)), lsuffix);
1246 /* Check that the file exists and is not a directory. */
1247 /* We used to only check for handlers on non-absolute file names:
1248 if (absolute)
1249 handler = Qnil;
1250 else
1251 handler = Ffind_file_name_handler (filename, Qfile_exists_p);
1252 It's not clear why that was the case and it breaks things like
1253 (load "/bar.el") where the file is actually "/bar.el.gz". */
1254 string = build_string (fn);
1255 handler = Ffind_file_name_handler (string, Qfile_exists_p);
1256 if ((!NILP (handler) || !NILP (predicate)) && !NATNUMP (predicate))
1258 if (NILP (predicate))
1259 exists = !NILP (Ffile_readable_p (string));
1260 else
1261 exists = !NILP (call1 (predicate, string));
1262 if (exists && !NILP (Ffile_directory_p (string)))
1263 exists = 0;
1265 if (exists)
1267 /* We succeeded; return this descriptor and filename. */
1268 if (storeptr)
1269 *storeptr = string;
1270 UNGCPRO;
1271 return -2;
1274 else
1276 const char *pfn;
1278 encoded_fn = ENCODE_FILE (string);
1279 pfn = SDATA (encoded_fn);
1280 exists = (stat (pfn, &st) >= 0
1281 && (st.st_mode & S_IFMT) != S_IFDIR);
1282 if (exists)
1284 /* Check that we can access or open it. */
1285 if (NATNUMP (predicate))
1286 fd = (access (pfn, XFASTINT (predicate)) == 0) ? 1 : -1;
1287 else
1288 fd = emacs_open (pfn, O_RDONLY, 0);
1290 if (fd >= 0)
1292 /* We succeeded; return this descriptor and filename. */
1293 if (storeptr)
1294 *storeptr = string;
1295 UNGCPRO;
1296 return fd;
1301 if (absolute)
1302 break;
1305 UNGCPRO;
1306 return -1;
1310 /* Merge the list we've accumulated of globals from the current input source
1311 into the load_history variable. The details depend on whether
1312 the source has an associated file name or not.
1314 FILENAME is the file name that we are loading from.
1315 ENTIRE is 1 if loading that entire file, 0 if evaluating part of it. */
1317 static void
1318 build_load_history (filename, entire)
1319 Lisp_Object filename;
1320 int entire;
1322 register Lisp_Object tail, prev, newelt;
1323 register Lisp_Object tem, tem2;
1324 register int foundit = 0;
1326 tail = Vload_history;
1327 prev = Qnil;
1329 while (CONSP (tail))
1331 tem = XCAR (tail);
1333 /* Find the feature's previous assoc list... */
1334 if (!NILP (Fequal (filename, Fcar (tem))))
1336 foundit = 1;
1338 /* If we're loading the entire file, remove old data. */
1339 if (entire)
1341 if (NILP (prev))
1342 Vload_history = XCDR (tail);
1343 else
1344 Fsetcdr (prev, XCDR (tail));
1347 /* Otherwise, cons on new symbols that are not already members. */
1348 else
1350 tem2 = Vcurrent_load_list;
1352 while (CONSP (tem2))
1354 newelt = XCAR (tem2);
1356 if (NILP (Fmember (newelt, tem)))
1357 Fsetcar (tail, Fcons (XCAR (tem),
1358 Fcons (newelt, XCDR (tem))));
1360 tem2 = XCDR (tem2);
1361 QUIT;
1365 else
1366 prev = tail;
1367 tail = XCDR (tail);
1368 QUIT;
1371 /* If we're loading an entire file, cons the new assoc onto the
1372 front of load-history, the most-recently-loaded position. Also
1373 do this if we didn't find an existing member for the file. */
1374 if (entire || !foundit)
1375 Vload_history = Fcons (Fnreverse (Vcurrent_load_list),
1376 Vload_history);
1379 Lisp_Object
1380 unreadpure (junk) /* Used as unwind-protect function in readevalloop */
1381 Lisp_Object junk;
1383 read_pure = 0;
1384 return Qnil;
1387 static Lisp_Object
1388 readevalloop_1 (old)
1389 Lisp_Object old;
1391 load_convert_to_unibyte = ! NILP (old);
1392 return Qnil;
1395 /* Signal an `end-of-file' error, if possible with file name
1396 information. */
1398 static void
1399 end_of_file_error ()
1401 if (STRINGP (Vload_file_name))
1402 xsignal1 (Qend_of_file, Vload_file_name);
1404 xsignal0 (Qend_of_file);
1407 /* UNIBYTE specifies how to set load_convert_to_unibyte
1408 for this invocation.
1409 READFUN, if non-nil, is used instead of `read'.
1411 START, END specify region to read in current buffer (from eval-region).
1412 If the input is not from a buffer, they must be nil. */
1414 static void
1415 readevalloop (readcharfun, stream, sourcename, evalfun,
1416 printflag, unibyte, readfun, start, end)
1417 Lisp_Object readcharfun;
1418 FILE *stream;
1419 Lisp_Object sourcename;
1420 Lisp_Object (*evalfun) ();
1421 int printflag;
1422 Lisp_Object unibyte, readfun;
1423 Lisp_Object start, end;
1425 register int c;
1426 register Lisp_Object val;
1427 int count = SPECPDL_INDEX ();
1428 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1429 struct buffer *b = 0;
1430 int continue_reading_p;
1431 /* Nonzero if reading an entire buffer. */
1432 int whole_buffer = 0;
1433 /* 1 on the first time around. */
1434 int first_sexp = 1;
1436 if (MARKERP (readcharfun))
1438 if (NILP (start))
1439 start = readcharfun;
1442 if (BUFFERP (readcharfun))
1443 b = XBUFFER (readcharfun);
1444 else if (MARKERP (readcharfun))
1445 b = XMARKER (readcharfun)->buffer;
1447 /* We assume START is nil when input is not from a buffer. */
1448 if (! NILP (start) && !b)
1449 abort ();
1451 specbind (Qstandard_input, readcharfun); /* GCPROs readcharfun. */
1452 specbind (Qcurrent_load_list, Qnil);
1453 record_unwind_protect (readevalloop_1, load_convert_to_unibyte ? Qt : Qnil);
1454 load_convert_to_unibyte = !NILP (unibyte);
1456 readchar_backlog = -1;
1458 GCPRO4 (sourcename, readfun, start, end);
1460 /* Try to ensure sourcename is a truename, except whilst preloading. */
1461 if (NILP (Vpurify_flag)
1462 && !NILP (sourcename) && !NILP (Ffile_name_absolute_p (sourcename))
1463 && !NILP (Ffboundp (Qfile_truename)))
1464 sourcename = call1 (Qfile_truename, sourcename) ;
1466 LOADHIST_ATTACH (sourcename);
1468 continue_reading_p = 1;
1469 while (continue_reading_p)
1471 int count1 = SPECPDL_INDEX ();
1473 if (b != 0 && NILP (b->name))
1474 error ("Reading from killed buffer");
1476 if (!NILP (start))
1478 /* Switch to the buffer we are reading from. */
1479 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1480 set_buffer_internal (b);
1482 /* Save point in it. */
1483 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1484 /* Save ZV in it. */
1485 record_unwind_protect (save_restriction_restore, save_restriction_save ());
1486 /* Those get unbound after we read one expression. */
1488 /* Set point and ZV around stuff to be read. */
1489 Fgoto_char (start);
1490 if (!NILP (end))
1491 Fnarrow_to_region (make_number (BEGV), end);
1493 /* Just for cleanliness, convert END to a marker
1494 if it is an integer. */
1495 if (INTEGERP (end))
1496 end = Fpoint_max_marker ();
1499 /* On the first cycle, we can easily test here
1500 whether we are reading the whole buffer. */
1501 if (b && first_sexp)
1502 whole_buffer = (PT == BEG && ZV == Z);
1504 instream = stream;
1505 read_next:
1506 c = READCHAR;
1507 if (c == ';')
1509 while ((c = READCHAR) != '\n' && c != -1);
1510 goto read_next;
1512 if (c < 0)
1514 unbind_to (count1, Qnil);
1515 break;
1518 /* Ignore whitespace here, so we can detect eof. */
1519 if (c == ' ' || c == '\t' || c == '\n' || c == '\f' || c == '\r'
1520 || c == 0x8a0) /* NBSP */
1521 goto read_next;
1523 if (!NILP (Vpurify_flag) && c == '(')
1525 record_unwind_protect (unreadpure, Qnil);
1526 val = read_list (-1, readcharfun);
1528 else
1530 UNREAD (c);
1531 read_objects = Qnil;
1532 if (!NILP (readfun))
1534 val = call1 (readfun, readcharfun);
1536 /* If READCHARFUN has set point to ZV, we should
1537 stop reading, even if the form read sets point
1538 to a different value when evaluated. */
1539 if (BUFFERP (readcharfun))
1541 struct buffer *b = XBUFFER (readcharfun);
1542 if (BUF_PT (b) == BUF_ZV (b))
1543 continue_reading_p = 0;
1546 else if (! NILP (Vload_read_function))
1547 val = call1 (Vload_read_function, readcharfun);
1548 else
1549 val = read_internal_start (readcharfun, Qnil, Qnil);
1552 if (!NILP (start) && continue_reading_p)
1553 start = Fpoint_marker ();
1555 /* Restore saved point and BEGV. */
1556 unbind_to (count1, Qnil);
1558 /* Now eval what we just read. */
1559 val = (*evalfun) (val);
1561 if (printflag)
1563 Vvalues = Fcons (val, Vvalues);
1564 if (EQ (Vstandard_output, Qt))
1565 Fprin1 (val, Qnil);
1566 else
1567 Fprint (val, Qnil);
1570 first_sexp = 0;
1573 build_load_history (sourcename,
1574 stream || whole_buffer);
1576 UNGCPRO;
1578 unbind_to (count, Qnil);
1581 DEFUN ("eval-buffer", Feval_buffer, Seval_buffer, 0, 5, "",
1582 doc: /* Execute the current buffer as Lisp code.
1583 Programs can pass two arguments, BUFFER and PRINTFLAG.
1584 BUFFER is the buffer to evaluate (nil means use current buffer).
1585 PRINTFLAG controls printing of output:
1586 A value of nil means discard it; anything else is stream for print.
1588 If the optional third argument FILENAME is non-nil,
1589 it specifies the file name to use for `load-history'.
1590 The optional fourth argument UNIBYTE specifies `load-convert-to-unibyte'
1591 for this invocation.
1593 The optional fifth argument DO-ALLOW-PRINT, if non-nil, specifies that
1594 `print' and related functions should work normally even if PRINTFLAG is nil.
1596 This function preserves the position of point. */)
1597 (buffer, printflag, filename, unibyte, do_allow_print)
1598 Lisp_Object buffer, printflag, filename, unibyte, do_allow_print;
1600 int count = SPECPDL_INDEX ();
1601 Lisp_Object tem, buf;
1603 if (NILP (buffer))
1604 buf = Fcurrent_buffer ();
1605 else
1606 buf = Fget_buffer (buffer);
1607 if (NILP (buf))
1608 error ("No such buffer");
1610 if (NILP (printflag) && NILP (do_allow_print))
1611 tem = Qsymbolp;
1612 else
1613 tem = printflag;
1615 if (NILP (filename))
1616 filename = XBUFFER (buf)->filename;
1618 specbind (Qeval_buffer_list, Fcons (buf, Veval_buffer_list));
1619 specbind (Qstandard_output, tem);
1620 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1621 BUF_SET_PT (XBUFFER (buf), BUF_BEGV (XBUFFER (buf)));
1622 readevalloop (buf, 0, filename, Feval,
1623 !NILP (printflag), unibyte, Qnil, Qnil, Qnil);
1624 unbind_to (count, Qnil);
1626 return Qnil;
1629 DEFUN ("eval-region", Feval_region, Seval_region, 2, 4, "r",
1630 doc: /* Execute the region as Lisp code.
1631 When called from programs, expects two arguments,
1632 giving starting and ending indices in the current buffer
1633 of the text to be executed.
1634 Programs can pass third argument PRINTFLAG which controls output:
1635 A value of nil means discard it; anything else is stream for printing it.
1636 Also the fourth argument READ-FUNCTION, if non-nil, is used
1637 instead of `read' to read each expression. It gets one argument
1638 which is the input stream for reading characters.
1640 This function does not move point. */)
1641 (start, end, printflag, read_function)
1642 Lisp_Object start, end, printflag, read_function;
1644 int count = SPECPDL_INDEX ();
1645 Lisp_Object tem, cbuf;
1647 cbuf = Fcurrent_buffer ();
1649 if (NILP (printflag))
1650 tem = Qsymbolp;
1651 else
1652 tem = printflag;
1653 specbind (Qstandard_output, tem);
1654 specbind (Qeval_buffer_list, Fcons (cbuf, Veval_buffer_list));
1656 /* readevalloop calls functions which check the type of start and end. */
1657 readevalloop (cbuf, 0, XBUFFER (cbuf)->filename, Feval,
1658 !NILP (printflag), Qnil, read_function,
1659 start, end);
1661 return unbind_to (count, Qnil);
1665 DEFUN ("read", Fread, Sread, 0, 1, 0,
1666 doc: /* Read one Lisp expression as text from STREAM, return as Lisp object.
1667 If STREAM is nil, use the value of `standard-input' (which see).
1668 STREAM or the value of `standard-input' may be:
1669 a buffer (read from point and advance it)
1670 a marker (read from where it points and advance it)
1671 a function (call it with no arguments for each character,
1672 call it with a char as argument to push a char back)
1673 a string (takes text from string, starting at the beginning)
1674 t (read text line using minibuffer and use it, or read from
1675 standard input in batch mode). */)
1676 (stream)
1677 Lisp_Object stream;
1679 if (NILP (stream))
1680 stream = Vstandard_input;
1681 if (EQ (stream, Qt))
1682 stream = Qread_char;
1683 if (EQ (stream, Qread_char))
1684 return Fread_minibuffer (build_string ("Lisp expression: "), Qnil);
1686 return read_internal_start (stream, Qnil, Qnil);
1689 DEFUN ("read-from-string", Fread_from_string, Sread_from_string, 1, 3, 0,
1690 doc: /* Read one Lisp expression which is represented as text by STRING.
1691 Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
1692 START and END optionally delimit a substring of STRING from which to read;
1693 they default to 0 and (length STRING) respectively. */)
1694 (string, start, end)
1695 Lisp_Object string, start, end;
1697 Lisp_Object ret;
1698 CHECK_STRING (string);
1699 /* read_internal_start sets read_from_string_index. */
1700 ret = read_internal_start (string, start, end);
1701 return Fcons (ret, make_number (read_from_string_index));
1704 /* Function to set up the global context we need in toplevel read
1705 calls. */
1706 static Lisp_Object
1707 read_internal_start (stream, start, end)
1708 Lisp_Object stream;
1709 Lisp_Object start; /* Only used when stream is a string. */
1710 Lisp_Object end; /* Only used when stream is a string. */
1712 Lisp_Object retval;
1714 readchar_backlog = -1;
1715 readchar_count = 0;
1716 new_backquote_flag = 0;
1717 read_objects = Qnil;
1718 if (EQ (Vread_with_symbol_positions, Qt)
1719 || EQ (Vread_with_symbol_positions, stream))
1720 Vread_symbol_positions_list = Qnil;
1722 if (STRINGP (stream))
1724 int startval, endval;
1725 if (NILP (end))
1726 endval = SCHARS (stream);
1727 else
1729 CHECK_NUMBER (end);
1730 endval = XINT (end);
1731 if (endval < 0 || endval > SCHARS (stream))
1732 args_out_of_range (stream, end);
1735 if (NILP (start))
1736 startval = 0;
1737 else
1739 CHECK_NUMBER (start);
1740 startval = XINT (start);
1741 if (startval < 0 || startval > endval)
1742 args_out_of_range (stream, start);
1744 read_from_string_index = startval;
1745 read_from_string_index_byte = string_char_to_byte (stream, startval);
1746 read_from_string_limit = endval;
1749 retval = read0 (stream);
1750 if (EQ (Vread_with_symbol_positions, Qt)
1751 || EQ (Vread_with_symbol_positions, stream))
1752 Vread_symbol_positions_list = Fnreverse (Vread_symbol_positions_list);
1753 return retval;
1757 /* Signal Qinvalid_read_syntax error.
1758 S is error string of length N (if > 0) */
1760 static void
1761 invalid_syntax (s, n)
1762 const char *s;
1763 int n;
1765 if (!n)
1766 n = strlen (s);
1767 xsignal1 (Qinvalid_read_syntax, make_string (s, n));
1771 /* Use this for recursive reads, in contexts where internal tokens
1772 are not allowed. */
1774 static Lisp_Object
1775 read0 (readcharfun)
1776 Lisp_Object readcharfun;
1778 register Lisp_Object val;
1779 int c;
1781 val = read1 (readcharfun, &c, 0);
1782 if (!c)
1783 return val;
1785 xsignal1 (Qinvalid_read_syntax,
1786 Fmake_string (make_number (1), make_number (c)));
1789 static int read_buffer_size;
1790 static char *read_buffer;
1792 /* Read multibyte form and return it as a character. C is a first
1793 byte of multibyte form, and rest of them are read from
1794 READCHARFUN. */
1796 static int
1797 read_multibyte (c, readcharfun)
1798 register int c;
1799 Lisp_Object readcharfun;
1801 /* We need the actual character code of this multibyte
1802 characters. */
1803 unsigned char str[MAX_MULTIBYTE_LENGTH];
1804 int len = 0;
1805 int bytes;
1807 if (c < 0)
1808 return c;
1810 str[len++] = c;
1811 while ((c = READCHAR) >= 0xA0
1812 && len < MAX_MULTIBYTE_LENGTH)
1814 str[len++] = c;
1815 readchar_count--;
1817 UNREAD (c);
1818 if (UNIBYTE_STR_AS_MULTIBYTE_P (str, len, bytes))
1819 return STRING_CHAR (str, len);
1820 /* The byte sequence is not valid as multibyte. Unread all bytes
1821 but the first one, and return the first byte. */
1822 while (--len > 0)
1823 UNREAD (str[len]);
1824 return str[0];
1827 /* Read a \-escape sequence, assuming we already read the `\'.
1828 If the escape sequence forces unibyte, store 1 into *BYTEREP.
1829 If the escape sequence forces multibyte, store 2 into *BYTEREP.
1830 Otherwise store 0 into *BYTEREP. */
1832 static int
1833 read_escape (readcharfun, stringp, byterep)
1834 Lisp_Object readcharfun;
1835 int stringp;
1836 int *byterep;
1838 register int c = READCHAR;
1839 /* \u allows up to four hex digits, \U up to eight. Default to the
1840 behaviour for \u, and change this value in the case that \U is seen. */
1841 int unicode_hex_count = 4;
1843 *byterep = 0;
1845 switch (c)
1847 case -1:
1848 end_of_file_error ();
1850 case 'a':
1851 return '\007';
1852 case 'b':
1853 return '\b';
1854 case 'd':
1855 return 0177;
1856 case 'e':
1857 return 033;
1858 case 'f':
1859 return '\f';
1860 case 'n':
1861 return '\n';
1862 case 'r':
1863 return '\r';
1864 case 't':
1865 return '\t';
1866 case 'v':
1867 return '\v';
1868 case '\n':
1869 return -1;
1870 case ' ':
1871 if (stringp)
1872 return -1;
1873 return ' ';
1875 case 'M':
1876 c = READCHAR;
1877 if (c != '-')
1878 error ("Invalid escape character syntax");
1879 c = READCHAR;
1880 if (c == '\\')
1881 c = read_escape (readcharfun, 0, byterep);
1882 return c | meta_modifier;
1884 case 'S':
1885 c = READCHAR;
1886 if (c != '-')
1887 error ("Invalid escape character syntax");
1888 c = READCHAR;
1889 if (c == '\\')
1890 c = read_escape (readcharfun, 0, byterep);
1891 return c | shift_modifier;
1893 case 'H':
1894 c = READCHAR;
1895 if (c != '-')
1896 error ("Invalid escape character syntax");
1897 c = READCHAR;
1898 if (c == '\\')
1899 c = read_escape (readcharfun, 0, byterep);
1900 return c | hyper_modifier;
1902 case 'A':
1903 c = READCHAR;
1904 if (c != '-')
1905 error ("Invalid escape character syntax");
1906 c = READCHAR;
1907 if (c == '\\')
1908 c = read_escape (readcharfun, 0, byterep);
1909 return c | alt_modifier;
1911 case 's':
1912 c = READCHAR;
1913 if (stringp || c != '-')
1915 UNREAD (c);
1916 return ' ';
1918 c = READCHAR;
1919 if (c == '\\')
1920 c = read_escape (readcharfun, 0, byterep);
1921 return c | super_modifier;
1923 case 'C':
1924 c = READCHAR;
1925 if (c != '-')
1926 error ("Invalid escape character syntax");
1927 case '^':
1928 c = READCHAR;
1929 if (c == '\\')
1930 c = read_escape (readcharfun, 0, byterep);
1931 if ((c & ~CHAR_MODIFIER_MASK) == '?')
1932 return 0177 | (c & CHAR_MODIFIER_MASK);
1933 else if (! SINGLE_BYTE_CHAR_P ((c & ~CHAR_MODIFIER_MASK)))
1934 return c | ctrl_modifier;
1935 /* ASCII control chars are made from letters (both cases),
1936 as well as the non-letters within 0100...0137. */
1937 else if ((c & 0137) >= 0101 && (c & 0137) <= 0132)
1938 return (c & (037 | ~0177));
1939 else if ((c & 0177) >= 0100 && (c & 0177) <= 0137)
1940 return (c & (037 | ~0177));
1941 else
1942 return c | ctrl_modifier;
1944 case '0':
1945 case '1':
1946 case '2':
1947 case '3':
1948 case '4':
1949 case '5':
1950 case '6':
1951 case '7':
1952 /* An octal escape, as in ANSI C. */
1954 register int i = c - '0';
1955 register int count = 0;
1956 while (++count < 3)
1958 if ((c = READCHAR) >= '0' && c <= '7')
1960 i *= 8;
1961 i += c - '0';
1963 else
1965 UNREAD (c);
1966 break;
1970 *byterep = 1;
1971 return i;
1974 case 'x':
1975 /* A hex escape, as in ANSI C. */
1977 int i = 0;
1978 while (1)
1980 c = READCHAR;
1981 if (c >= '0' && c <= '9')
1983 i *= 16;
1984 i += c - '0';
1986 else if ((c >= 'a' && c <= 'f')
1987 || (c >= 'A' && c <= 'F'))
1989 i *= 16;
1990 if (c >= 'a' && c <= 'f')
1991 i += c - 'a' + 10;
1992 else
1993 i += c - 'A' + 10;
1995 else
1997 UNREAD (c);
1998 break;
2002 *byterep = 2;
2003 return i;
2006 case 'U':
2007 /* Post-Unicode-2.0: Up to eight hex chars. */
2008 unicode_hex_count = 8;
2009 case 'u':
2011 /* A Unicode escape. We only permit them in strings and characters,
2012 not arbitrarily in the source code, as in some other languages. */
2014 int i = 0;
2015 int count = 0;
2016 Lisp_Object lisp_char;
2017 struct gcpro gcpro1;
2019 while (++count <= unicode_hex_count)
2021 c = READCHAR;
2022 /* isdigit and isalpha may be locale-specific, which we don't
2023 want. */
2024 if (c >= '0' && c <= '9') i = (i << 4) + (c - '0');
2025 else if (c >= 'a' && c <= 'f') i = (i << 4) + (c - 'a') + 10;
2026 else if (c >= 'A' && c <= 'F') i = (i << 4) + (c - 'A') + 10;
2027 else
2029 error ("Non-hex digit used for Unicode escape");
2030 break;
2034 GCPRO1 (readcharfun);
2035 lisp_char = call2 (intern ("decode-char"), intern ("ucs"),
2036 make_number (i));
2037 UNGCPRO;
2039 if (NILP (lisp_char))
2041 error ("Unsupported Unicode code point: U+%x", (unsigned)i);
2044 return XFASTINT (lisp_char);
2047 default:
2048 if (BASE_LEADING_CODE_P (c))
2049 c = read_multibyte (c, readcharfun);
2050 return c;
2054 /* Read an integer in radix RADIX using READCHARFUN to read
2055 characters. RADIX must be in the interval [2..36]; if it isn't, a
2056 read error is signaled . Value is the integer read. Signals an
2057 error if encountering invalid read syntax or if RADIX is out of
2058 range. */
2060 static Lisp_Object
2061 read_integer (readcharfun, radix)
2062 Lisp_Object readcharfun;
2063 int radix;
2065 int ndigits = 0, invalid_p, c, sign = 0;
2066 EMACS_INT number = 0;
2068 if (radix < 2 || radix > 36)
2069 invalid_p = 1;
2070 else
2072 number = ndigits = invalid_p = 0;
2073 sign = 1;
2075 c = READCHAR;
2076 if (c == '-')
2078 c = READCHAR;
2079 sign = -1;
2081 else if (c == '+')
2082 c = READCHAR;
2084 while (c >= 0)
2086 int digit;
2088 if (c >= '0' && c <= '9')
2089 digit = c - '0';
2090 else if (c >= 'a' && c <= 'z')
2091 digit = c - 'a' + 10;
2092 else if (c >= 'A' && c <= 'Z')
2093 digit = c - 'A' + 10;
2094 else
2096 UNREAD (c);
2097 break;
2100 if (digit < 0 || digit >= radix)
2101 invalid_p = 1;
2103 number = radix * number + digit;
2104 ++ndigits;
2105 c = READCHAR;
2109 if (ndigits == 0 || invalid_p)
2111 char buf[50];
2112 sprintf (buf, "integer, radix %d", radix);
2113 invalid_syntax (buf, 0);
2116 return make_number (sign * number);
2120 /* Convert unibyte text in read_buffer to multibyte.
2122 Initially, *P is a pointer after the end of the unibyte text, and
2123 the pointer *END points after the end of read_buffer.
2125 If read_buffer doesn't have enough room to hold the result
2126 of the conversion, reallocate it and adjust *P and *END.
2128 At the end, make *P point after the result of the conversion, and
2129 return in *NCHARS the number of characters in the converted
2130 text. */
2132 static void
2133 to_multibyte (p, end, nchars)
2134 char **p, **end;
2135 int *nchars;
2137 int nbytes;
2139 parse_str_as_multibyte (read_buffer, *p - read_buffer, &nbytes, nchars);
2140 if (read_buffer_size < 2 * nbytes)
2142 int offset = *p - read_buffer;
2143 read_buffer_size = 2 * max (read_buffer_size, nbytes);
2144 read_buffer = (char *) xrealloc (read_buffer, read_buffer_size);
2145 *p = read_buffer + offset;
2146 *end = read_buffer + read_buffer_size;
2149 if (nbytes != *nchars)
2150 nbytes = str_as_multibyte (read_buffer, read_buffer_size,
2151 *p - read_buffer, nchars);
2153 *p = read_buffer + nbytes;
2157 /* If the next token is ')' or ']' or '.', we store that character
2158 in *PCH and the return value is not interesting. Else, we store
2159 zero in *PCH and we read and return one lisp object.
2161 FIRST_IN_LIST is nonzero if this is the first element of a list. */
2163 static Lisp_Object
2164 read1 (readcharfun, pch, first_in_list)
2165 register Lisp_Object readcharfun;
2166 int *pch;
2167 int first_in_list;
2169 register int c;
2170 int uninterned_symbol = 0;
2172 *pch = 0;
2174 retry:
2176 c = READCHAR;
2177 if (c < 0)
2178 end_of_file_error ();
2180 switch (c)
2182 case '(':
2183 return read_list (0, readcharfun);
2185 case '[':
2186 return read_vector (readcharfun, 0);
2188 case ')':
2189 case ']':
2191 *pch = c;
2192 return Qnil;
2195 case '#':
2196 c = READCHAR;
2197 if (c == '^')
2199 c = READCHAR;
2200 if (c == '[')
2202 Lisp_Object tmp;
2203 tmp = read_vector (readcharfun, 0);
2204 if (XVECTOR (tmp)->size < CHAR_TABLE_STANDARD_SLOTS
2205 || XVECTOR (tmp)->size > CHAR_TABLE_STANDARD_SLOTS + 10)
2206 error ("Invalid size char-table");
2207 XSETPVECTYPE (XVECTOR (tmp), PVEC_CHAR_TABLE);
2208 XCHAR_TABLE (tmp)->top = Qt;
2209 return tmp;
2211 else if (c == '^')
2213 c = READCHAR;
2214 if (c == '[')
2216 Lisp_Object tmp;
2217 tmp = read_vector (readcharfun, 0);
2218 if (XVECTOR (tmp)->size != SUB_CHAR_TABLE_STANDARD_SLOTS)
2219 error ("Invalid size char-table");
2220 XSETPVECTYPE (XVECTOR (tmp), PVEC_CHAR_TABLE);
2221 XCHAR_TABLE (tmp)->top = Qnil;
2222 return tmp;
2224 invalid_syntax ("#^^", 3);
2226 invalid_syntax ("#^", 2);
2228 if (c == '&')
2230 Lisp_Object length;
2231 length = read1 (readcharfun, pch, first_in_list);
2232 c = READCHAR;
2233 if (c == '"')
2235 Lisp_Object tmp, val;
2236 int size_in_chars
2237 = ((XFASTINT (length) + BOOL_VECTOR_BITS_PER_CHAR - 1)
2238 / BOOL_VECTOR_BITS_PER_CHAR);
2240 UNREAD (c);
2241 tmp = read1 (readcharfun, pch, first_in_list);
2242 if (size_in_chars != SCHARS (tmp)
2243 /* We used to print 1 char too many
2244 when the number of bits was a multiple of 8.
2245 Accept such input in case it came from an old version. */
2246 && ! (XFASTINT (length)
2247 == (SCHARS (tmp) - 1) * BOOL_VECTOR_BITS_PER_CHAR))
2248 invalid_syntax ("#&...", 5);
2250 val = Fmake_bool_vector (length, Qnil);
2251 bcopy (SDATA (tmp), XBOOL_VECTOR (val)->data,
2252 size_in_chars);
2253 /* Clear the extraneous bits in the last byte. */
2254 if (XINT (length) != size_in_chars * BOOL_VECTOR_BITS_PER_CHAR)
2255 XBOOL_VECTOR (val)->data[size_in_chars - 1]
2256 &= (1 << (XINT (length) % BOOL_VECTOR_BITS_PER_CHAR)) - 1;
2257 return val;
2259 invalid_syntax ("#&...", 5);
2261 if (c == '[')
2263 /* Accept compiled functions at read-time so that we don't have to
2264 build them using function calls. */
2265 Lisp_Object tmp;
2266 tmp = read_vector (readcharfun, 1);
2267 return Fmake_byte_code (XVECTOR (tmp)->size,
2268 XVECTOR (tmp)->contents);
2270 if (c == '(')
2272 Lisp_Object tmp;
2273 struct gcpro gcpro1;
2274 int ch;
2276 /* Read the string itself. */
2277 tmp = read1 (readcharfun, &ch, 0);
2278 if (ch != 0 || !STRINGP (tmp))
2279 invalid_syntax ("#", 1);
2280 GCPRO1 (tmp);
2281 /* Read the intervals and their properties. */
2282 while (1)
2284 Lisp_Object beg, end, plist;
2286 beg = read1 (readcharfun, &ch, 0);
2287 end = plist = Qnil;
2288 if (ch == ')')
2289 break;
2290 if (ch == 0)
2291 end = read1 (readcharfun, &ch, 0);
2292 if (ch == 0)
2293 plist = read1 (readcharfun, &ch, 0);
2294 if (ch)
2295 invalid_syntax ("Invalid string property list", 0);
2296 Fset_text_properties (beg, end, plist, tmp);
2298 UNGCPRO;
2299 return tmp;
2302 /* #@NUMBER is used to skip NUMBER following characters.
2303 That's used in .elc files to skip over doc strings
2304 and function definitions. */
2305 if (c == '@')
2307 int i, nskip = 0;
2309 /* Read a decimal integer. */
2310 while ((c = READCHAR) >= 0
2311 && c >= '0' && c <= '9')
2313 nskip *= 10;
2314 nskip += c - '0';
2316 if (c >= 0)
2317 UNREAD (c);
2319 if (load_force_doc_strings && EQ (readcharfun, Qget_file_char))
2321 /* If we are supposed to force doc strings into core right now,
2322 record the last string that we skipped,
2323 and record where in the file it comes from. */
2325 /* But first exchange saved_doc_string
2326 with prev_saved_doc_string, so we save two strings. */
2328 char *temp = saved_doc_string;
2329 int temp_size = saved_doc_string_size;
2330 file_offset temp_pos = saved_doc_string_position;
2331 int temp_len = saved_doc_string_length;
2333 saved_doc_string = prev_saved_doc_string;
2334 saved_doc_string_size = prev_saved_doc_string_size;
2335 saved_doc_string_position = prev_saved_doc_string_position;
2336 saved_doc_string_length = prev_saved_doc_string_length;
2338 prev_saved_doc_string = temp;
2339 prev_saved_doc_string_size = temp_size;
2340 prev_saved_doc_string_position = temp_pos;
2341 prev_saved_doc_string_length = temp_len;
2344 if (saved_doc_string_size == 0)
2346 saved_doc_string_size = nskip + 100;
2347 saved_doc_string = (char *) xmalloc (saved_doc_string_size);
2349 if (nskip > saved_doc_string_size)
2351 saved_doc_string_size = nskip + 100;
2352 saved_doc_string = (char *) xrealloc (saved_doc_string,
2353 saved_doc_string_size);
2356 saved_doc_string_position = file_tell (instream);
2358 /* Copy that many characters into saved_doc_string. */
2359 for (i = 0; i < nskip && c >= 0; i++)
2360 saved_doc_string[i] = c = READCHAR;
2362 saved_doc_string_length = i;
2364 else
2366 /* Skip that many characters. */
2367 for (i = 0; i < nskip && c >= 0; i++)
2368 c = READCHAR;
2371 goto retry;
2373 if (c == '!')
2375 /* #! appears at the beginning of an executable file.
2376 Skip the first line. */
2377 while (c != '\n' && c >= 0)
2378 c = READCHAR;
2379 goto retry;
2381 if (c == '$')
2382 return Vload_file_name;
2383 if (c == '\'')
2384 return Fcons (Qfunction, Fcons (read0 (readcharfun), Qnil));
2385 /* #:foo is the uninterned symbol named foo. */
2386 if (c == ':')
2388 uninterned_symbol = 1;
2389 c = READCHAR;
2390 goto default_label;
2392 /* Reader forms that can reuse previously read objects. */
2393 if (c >= '0' && c <= '9')
2395 int n = 0;
2396 Lisp_Object tem;
2398 /* Read a non-negative integer. */
2399 while (c >= '0' && c <= '9')
2401 n *= 10;
2402 n += c - '0';
2403 c = READCHAR;
2405 /* #n=object returns object, but associates it with n for #n#. */
2406 if (c == '=')
2408 /* Make a placeholder for #n# to use temporarily */
2409 Lisp_Object placeholder;
2410 Lisp_Object cell;
2412 placeholder = Fcons(Qnil, Qnil);
2413 cell = Fcons (make_number (n), placeholder);
2414 read_objects = Fcons (cell, read_objects);
2416 /* Read the object itself. */
2417 tem = read0 (readcharfun);
2419 /* Now put it everywhere the placeholder was... */
2420 substitute_object_in_subtree (tem, placeholder);
2422 /* ...and #n# will use the real value from now on. */
2423 Fsetcdr (cell, tem);
2425 return tem;
2427 /* #n# returns a previously read object. */
2428 if (c == '#')
2430 tem = Fassq (make_number (n), read_objects);
2431 if (CONSP (tem))
2432 return XCDR (tem);
2433 /* Fall through to error message. */
2435 else if (c == 'r' || c == 'R')
2436 return read_integer (readcharfun, n);
2438 /* Fall through to error message. */
2440 else if (c == 'x' || c == 'X')
2441 return read_integer (readcharfun, 16);
2442 else if (c == 'o' || c == 'O')
2443 return read_integer (readcharfun, 8);
2444 else if (c == 'b' || c == 'B')
2445 return read_integer (readcharfun, 2);
2447 UNREAD (c);
2448 invalid_syntax ("#", 1);
2450 case ';':
2451 while ((c = READCHAR) >= 0 && c != '\n');
2452 goto retry;
2454 case '\'':
2456 return Fcons (Qquote, Fcons (read0 (readcharfun), Qnil));
2459 case '`':
2460 if (first_in_list)
2462 Vold_style_backquotes = Qt;
2463 goto default_label;
2465 else
2467 Lisp_Object value;
2469 new_backquote_flag++;
2470 value = read0 (readcharfun);
2471 new_backquote_flag--;
2473 return Fcons (Qbackquote, Fcons (value, Qnil));
2476 case ',':
2477 if (new_backquote_flag)
2479 Lisp_Object comma_type = Qnil;
2480 Lisp_Object value;
2481 int ch = READCHAR;
2483 if (ch == '@')
2484 comma_type = Qcomma_at;
2485 else if (ch == '.')
2486 comma_type = Qcomma_dot;
2487 else
2489 if (ch >= 0) UNREAD (ch);
2490 comma_type = Qcomma;
2493 new_backquote_flag--;
2494 value = read0 (readcharfun);
2495 new_backquote_flag++;
2496 return Fcons (comma_type, Fcons (value, Qnil));
2498 else
2500 Vold_style_backquotes = Qt;
2501 goto default_label;
2504 case '?':
2506 int discard;
2507 int next_char;
2508 int ok;
2510 c = READCHAR;
2511 if (c < 0)
2512 end_of_file_error ();
2514 /* Accept `single space' syntax like (list ? x) where the
2515 whitespace character is SPC or TAB.
2516 Other literal whitespace like NL, CR, and FF are not accepted,
2517 as there are well-established escape sequences for these. */
2518 if (c == ' ' || c == '\t')
2519 return make_number (c);
2521 if (c == '\\')
2522 c = read_escape (readcharfun, 0, &discard);
2523 else if (BASE_LEADING_CODE_P (c))
2524 c = read_multibyte (c, readcharfun);
2526 next_char = READCHAR;
2527 if (next_char == '.')
2529 /* Only a dotted-pair dot is valid after a char constant. */
2530 int next_next_char = READCHAR;
2531 UNREAD (next_next_char);
2533 ok = (next_next_char <= 040
2534 || (next_next_char < 0200
2535 && (index ("\"';([#?", next_next_char)
2536 || (!first_in_list && next_next_char == '`')
2537 || (new_backquote_flag && next_next_char == ','))));
2539 else
2541 ok = (next_char <= 040
2542 || (next_char < 0200
2543 && (index ("\"';()[]#?", next_char)
2544 || (!first_in_list && next_char == '`')
2545 || (new_backquote_flag && next_char == ','))));
2547 UNREAD (next_char);
2548 if (ok)
2549 return make_number (c);
2551 invalid_syntax ("?", 1);
2554 case '"':
2556 char *p = read_buffer;
2557 char *end = read_buffer + read_buffer_size;
2558 register int c;
2559 /* 1 if we saw an escape sequence specifying
2560 a multibyte character, or a multibyte character. */
2561 int force_multibyte = 0;
2562 /* 1 if we saw an escape sequence specifying
2563 a single-byte character. */
2564 int force_singlebyte = 0;
2565 /* 1 if read_buffer contains multibyte text now. */
2566 int is_multibyte = 0;
2567 int cancel = 0;
2568 int nchars = 0;
2570 while ((c = READCHAR) >= 0
2571 && c != '\"')
2573 if (end - p < MAX_MULTIBYTE_LENGTH)
2575 int offset = p - read_buffer;
2576 read_buffer = (char *) xrealloc (read_buffer,
2577 read_buffer_size *= 2);
2578 p = read_buffer + offset;
2579 end = read_buffer + read_buffer_size;
2582 if (c == '\\')
2584 int byterep;
2586 c = read_escape (readcharfun, 1, &byterep);
2588 /* C is -1 if \ newline has just been seen */
2589 if (c == -1)
2591 if (p == read_buffer)
2592 cancel = 1;
2593 continue;
2596 if (byterep == 1)
2597 force_singlebyte = 1;
2598 else if (byterep == 2)
2599 force_multibyte = 1;
2602 /* A character that must be multibyte forces multibyte. */
2603 if (! SINGLE_BYTE_CHAR_P (c & ~CHAR_MODIFIER_MASK))
2604 force_multibyte = 1;
2606 /* If we just discovered the need to be multibyte,
2607 convert the text accumulated thus far. */
2608 if (force_multibyte && ! is_multibyte)
2610 is_multibyte = 1;
2611 to_multibyte (&p, &end, &nchars);
2614 /* Allow `\C- ' and `\C-?'. */
2615 if (c == (CHAR_CTL | ' '))
2616 c = 0;
2617 else if (c == (CHAR_CTL | '?'))
2618 c = 127;
2620 if (c & CHAR_SHIFT)
2622 /* Shift modifier is valid only with [A-Za-z]. */
2623 if ((c & 0377) >= 'A' && (c & 0377) <= 'Z')
2624 c &= ~CHAR_SHIFT;
2625 else if ((c & 0377) >= 'a' && (c & 0377) <= 'z')
2626 c = (c & ~CHAR_SHIFT) - ('a' - 'A');
2629 if (c & CHAR_META)
2630 /* Move the meta bit to the right place for a string. */
2631 c = (c & ~CHAR_META) | 0x80;
2632 if (c & CHAR_MODIFIER_MASK)
2633 error ("Invalid modifier in string");
2635 if (is_multibyte)
2636 p += CHAR_STRING (c, p);
2637 else
2638 *p++ = c;
2640 nchars++;
2643 if (c < 0)
2644 end_of_file_error ();
2646 /* If purifying, and string starts with \ newline,
2647 return zero instead. This is for doc strings
2648 that we are really going to find in etc/DOC.nn.nn */
2649 if (!NILP (Vpurify_flag) && NILP (Vdoc_file_name) && cancel)
2650 return make_number (0);
2652 if (is_multibyte || force_singlebyte)
2654 else if (load_convert_to_unibyte)
2656 Lisp_Object string;
2657 to_multibyte (&p, &end, &nchars);
2658 if (p - read_buffer != nchars)
2660 string = make_multibyte_string (read_buffer, nchars,
2661 p - read_buffer);
2662 return Fstring_make_unibyte (string);
2664 /* We can make a unibyte string directly. */
2665 is_multibyte = 0;
2667 else if (EQ (readcharfun, Qget_file_char)
2668 || EQ (readcharfun, Qlambda))
2670 /* Nowadays, reading directly from a file is used only for
2671 compiled Emacs Lisp files, and those always use the
2672 Emacs internal encoding. Meanwhile, Qlambda is used
2673 for reading dynamic byte code (compiled with
2674 byte-compile-dynamic = t). So make the string multibyte
2675 if the string contains any multibyte sequences.
2676 (to_multibyte is a no-op if not.) */
2677 to_multibyte (&p, &end, &nchars);
2678 is_multibyte = (p - read_buffer) != nchars;
2680 else
2681 /* In all other cases, if we read these bytes as
2682 separate characters, treat them as separate characters now. */
2685 /* We want readchar_count to be the number of characters, not
2686 bytes. Hence we adjust for multibyte characters in the
2687 string. ... But it doesn't seem to be necessary, because
2688 READCHAR *does* read multibyte characters from buffers. */
2689 /* readchar_count -= (p - read_buffer) - nchars; */
2690 if (read_pure)
2691 return make_pure_string (read_buffer, nchars, p - read_buffer,
2692 is_multibyte);
2693 return make_specified_string (read_buffer, nchars, p - read_buffer,
2694 is_multibyte);
2697 case '.':
2699 int next_char = READCHAR;
2700 UNREAD (next_char);
2702 if (next_char <= 040
2703 || (next_char < 0200
2704 && (index ("\"';([#?", next_char)
2705 || (!first_in_list && next_char == '`')
2706 || (new_backquote_flag && next_char == ','))))
2708 *pch = c;
2709 return Qnil;
2712 /* Otherwise, we fall through! Note that the atom-reading loop
2713 below will now loop at least once, assuring that we will not
2714 try to UNREAD two characters in a row. */
2716 default:
2717 default_label:
2718 if (c <= 040) goto retry;
2719 if (c == 0x8a0) /* NBSP */
2720 goto retry;
2722 char *p = read_buffer;
2723 int quoted = 0;
2726 char *end = read_buffer + read_buffer_size;
2728 while (c > 040
2729 && c != 0x8a0 /* NBSP */
2730 && (c >= 0200
2731 || (!index ("\"';()[]#", c)
2732 && !(!first_in_list && c == '`')
2733 && !(new_backquote_flag && c == ','))))
2735 if (end - p < MAX_MULTIBYTE_LENGTH)
2737 int offset = p - read_buffer;
2738 read_buffer = (char *) xrealloc (read_buffer,
2739 read_buffer_size *= 2);
2740 p = read_buffer + offset;
2741 end = read_buffer + read_buffer_size;
2744 if (c == '\\')
2746 c = READCHAR;
2747 if (c == -1)
2748 end_of_file_error ();
2749 quoted = 1;
2752 if (! SINGLE_BYTE_CHAR_P (c))
2753 p += CHAR_STRING (c, p);
2754 else
2755 *p++ = c;
2757 c = READCHAR;
2760 if (p == end)
2762 int offset = p - read_buffer;
2763 read_buffer = (char *) xrealloc (read_buffer,
2764 read_buffer_size *= 2);
2765 p = read_buffer + offset;
2766 end = read_buffer + read_buffer_size;
2768 *p = 0;
2769 if (c >= 0)
2770 UNREAD (c);
2773 if (!quoted && !uninterned_symbol)
2775 register char *p1;
2776 register Lisp_Object val;
2777 p1 = read_buffer;
2778 if (*p1 == '+' || *p1 == '-') p1++;
2779 /* Is it an integer? */
2780 if (p1 != p)
2782 while (p1 != p && (c = *p1) >= '0' && c <= '9') p1++;
2783 /* Integers can have trailing decimal points. */
2784 if (p1 > read_buffer && p1 < p && *p1 == '.') p1++;
2785 if (p1 == p)
2786 /* It is an integer. */
2788 if (p1[-1] == '.')
2789 p1[-1] = '\0';
2790 if (sizeof (int) == sizeof (EMACS_INT))
2791 XSETINT (val, atoi (read_buffer));
2792 else if (sizeof (long) == sizeof (EMACS_INT))
2793 XSETINT (val, atol (read_buffer));
2794 else
2795 abort ();
2796 return val;
2799 if (isfloat_string (read_buffer))
2801 /* Compute NaN and infinities using 0.0 in a variable,
2802 to cope with compilers that think they are smarter
2803 than we are. */
2804 double zero = 0.0;
2806 double value;
2808 /* Negate the value ourselves. This treats 0, NaNs,
2809 and infinity properly on IEEE floating point hosts,
2810 and works around a common bug where atof ("-0.0")
2811 drops the sign. */
2812 int negative = read_buffer[0] == '-';
2814 /* The only way p[-1] can be 'F' or 'N', after isfloat_string
2815 returns 1, is if the input ends in e+INF or e+NaN. */
2816 switch (p[-1])
2818 case 'F':
2819 value = 1.0 / zero;
2820 break;
2821 case 'N':
2822 value = zero / zero;
2824 /* If that made a "negative" NaN, negate it. */
2827 int i;
2828 union { double d; char c[sizeof (double)]; } u_data, u_minus_zero;
2830 u_data.d = value;
2831 u_minus_zero.d = - 0.0;
2832 for (i = 0; i < sizeof (double); i++)
2833 if (u_data.c[i] & u_minus_zero.c[i])
2835 value = - value;
2836 break;
2839 /* Now VALUE is a positive NaN. */
2840 break;
2841 default:
2842 value = atof (read_buffer + negative);
2843 break;
2846 return make_float (negative ? - value : value);
2850 Lisp_Object result = uninterned_symbol ? make_symbol (read_buffer)
2851 : intern (read_buffer);
2852 if (EQ (Vread_with_symbol_positions, Qt)
2853 || EQ (Vread_with_symbol_positions, readcharfun))
2854 Vread_symbol_positions_list =
2855 /* Kind of a hack; this will probably fail if characters
2856 in the symbol name were escaped. Not really a big
2857 deal, though. */
2858 Fcons (Fcons (result,
2859 make_number (readchar_count
2860 - XFASTINT (Flength (Fsymbol_name (result))))),
2861 Vread_symbol_positions_list);
2862 return result;
2869 /* List of nodes we've seen during substitute_object_in_subtree. */
2870 static Lisp_Object seen_list;
2872 static void
2873 substitute_object_in_subtree (object, placeholder)
2874 Lisp_Object object;
2875 Lisp_Object placeholder;
2877 Lisp_Object check_object;
2879 /* We haven't seen any objects when we start. */
2880 seen_list = Qnil;
2882 /* Make all the substitutions. */
2883 check_object
2884 = substitute_object_recurse (object, placeholder, object);
2886 /* Clear seen_list because we're done with it. */
2887 seen_list = Qnil;
2889 /* The returned object here is expected to always eq the
2890 original. */
2891 if (!EQ (check_object, object))
2892 error ("Unexpected mutation error in reader");
2895 /* Feval doesn't get called from here, so no gc protection is needed. */
2896 #define SUBSTITUTE(get_val, set_val) \
2898 Lisp_Object old_value = get_val; \
2899 Lisp_Object true_value \
2900 = substitute_object_recurse (object, placeholder,\
2901 old_value); \
2903 if (!EQ (old_value, true_value)) \
2905 set_val; \
2909 static Lisp_Object
2910 substitute_object_recurse (object, placeholder, subtree)
2911 Lisp_Object object;
2912 Lisp_Object placeholder;
2913 Lisp_Object subtree;
2915 /* If we find the placeholder, return the target object. */
2916 if (EQ (placeholder, subtree))
2917 return object;
2919 /* If we've been to this node before, don't explore it again. */
2920 if (!EQ (Qnil, Fmemq (subtree, seen_list)))
2921 return subtree;
2923 /* If this node can be the entry point to a cycle, remember that
2924 we've seen it. It can only be such an entry point if it was made
2925 by #n=, which means that we can find it as a value in
2926 read_objects. */
2927 if (!EQ (Qnil, Frassq (subtree, read_objects)))
2928 seen_list = Fcons (subtree, seen_list);
2930 /* Recurse according to subtree's type.
2931 Every branch must return a Lisp_Object. */
2932 switch (XTYPE (subtree))
2934 case Lisp_Vectorlike:
2936 int i;
2937 int length = XINT (Flength(subtree));
2938 for (i = 0; i < length; i++)
2940 Lisp_Object idx = make_number (i);
2941 SUBSTITUTE (Faref (subtree, idx),
2942 Faset (subtree, idx, true_value));
2944 return subtree;
2947 case Lisp_Cons:
2949 SUBSTITUTE (Fcar_safe (subtree),
2950 Fsetcar (subtree, true_value));
2951 SUBSTITUTE (Fcdr_safe (subtree),
2952 Fsetcdr (subtree, true_value));
2953 return subtree;
2956 case Lisp_String:
2958 /* Check for text properties in each interval.
2959 substitute_in_interval contains part of the logic. */
2961 INTERVAL root_interval = STRING_INTERVALS (subtree);
2962 Lisp_Object arg = Fcons (object, placeholder);
2964 traverse_intervals_noorder (root_interval,
2965 &substitute_in_interval, arg);
2967 return subtree;
2970 /* Other types don't recurse any further. */
2971 default:
2972 return subtree;
2976 /* Helper function for substitute_object_recurse. */
2977 static void
2978 substitute_in_interval (interval, arg)
2979 INTERVAL interval;
2980 Lisp_Object arg;
2982 Lisp_Object object = Fcar (arg);
2983 Lisp_Object placeholder = Fcdr (arg);
2985 SUBSTITUTE(interval->plist, interval->plist = true_value);
2989 #define LEAD_INT 1
2990 #define DOT_CHAR 2
2991 #define TRAIL_INT 4
2992 #define E_CHAR 8
2993 #define EXP_INT 16
2996 isfloat_string (cp)
2997 register char *cp;
2999 register int state;
3001 char *start = cp;
3003 state = 0;
3004 if (*cp == '+' || *cp == '-')
3005 cp++;
3007 if (*cp >= '0' && *cp <= '9')
3009 state |= LEAD_INT;
3010 while (*cp >= '0' && *cp <= '9')
3011 cp++;
3013 if (*cp == '.')
3015 state |= DOT_CHAR;
3016 cp++;
3018 if (*cp >= '0' && *cp <= '9')
3020 state |= TRAIL_INT;
3021 while (*cp >= '0' && *cp <= '9')
3022 cp++;
3024 if (*cp == 'e' || *cp == 'E')
3026 state |= E_CHAR;
3027 cp++;
3028 if (*cp == '+' || *cp == '-')
3029 cp++;
3032 if (*cp >= '0' && *cp <= '9')
3034 state |= EXP_INT;
3035 while (*cp >= '0' && *cp <= '9')
3036 cp++;
3038 else if (cp == start)
3040 else if (cp[-1] == '+' && cp[0] == 'I' && cp[1] == 'N' && cp[2] == 'F')
3042 state |= EXP_INT;
3043 cp += 3;
3045 else if (cp[-1] == '+' && cp[0] == 'N' && cp[1] == 'a' && cp[2] == 'N')
3047 state |= EXP_INT;
3048 cp += 3;
3051 return (((*cp == 0) || (*cp == ' ') || (*cp == '\t') || (*cp == '\n') || (*cp == '\r') || (*cp == '\f'))
3052 && (state == (LEAD_INT|DOT_CHAR|TRAIL_INT)
3053 || state == (DOT_CHAR|TRAIL_INT)
3054 || state == (LEAD_INT|E_CHAR|EXP_INT)
3055 || state == (LEAD_INT|DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)
3056 || state == (DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)));
3060 static Lisp_Object
3061 read_vector (readcharfun, bytecodeflag)
3062 Lisp_Object readcharfun;
3063 int bytecodeflag;
3065 register int i;
3066 register int size;
3067 register Lisp_Object *ptr;
3068 register Lisp_Object tem, item, vector;
3069 register struct Lisp_Cons *otem;
3070 Lisp_Object len;
3072 tem = read_list (1, readcharfun);
3073 len = Flength (tem);
3074 vector = (read_pure ? make_pure_vector (XINT (len)) : Fmake_vector (len, Qnil));
3076 size = XVECTOR (vector)->size;
3077 ptr = XVECTOR (vector)->contents;
3078 for (i = 0; i < size; i++)
3080 item = Fcar (tem);
3081 /* If `load-force-doc-strings' is t when reading a lazily-loaded
3082 bytecode object, the docstring containing the bytecode and
3083 constants values must be treated as unibyte and passed to
3084 Fread, to get the actual bytecode string and constants vector. */
3085 if (bytecodeflag && load_force_doc_strings)
3087 if (i == COMPILED_BYTECODE)
3089 if (!STRINGP (item))
3090 error ("Invalid byte code");
3092 /* Delay handling the bytecode slot until we know whether
3093 it is lazily-loaded (we can tell by whether the
3094 constants slot is nil). */
3095 ptr[COMPILED_CONSTANTS] = item;
3096 item = Qnil;
3098 else if (i == COMPILED_CONSTANTS)
3100 Lisp_Object bytestr = ptr[COMPILED_CONSTANTS];
3102 if (NILP (item))
3104 /* Coerce string to unibyte (like string-as-unibyte,
3105 but without generating extra garbage and
3106 guaranteeing no change in the contents). */
3107 STRING_SET_CHARS (bytestr, SBYTES (bytestr));
3108 STRING_SET_UNIBYTE (bytestr);
3110 item = Fread (bytestr);
3111 if (!CONSP (item))
3112 error ("Invalid byte code");
3114 otem = XCONS (item);
3115 bytestr = XCAR (item);
3116 item = XCDR (item);
3117 free_cons (otem);
3120 /* Now handle the bytecode slot. */
3121 ptr[COMPILED_BYTECODE] = read_pure ? Fpurecopy (bytestr) : bytestr;
3124 ptr[i] = read_pure ? Fpurecopy (item) : item;
3125 otem = XCONS (tem);
3126 tem = Fcdr (tem);
3127 free_cons (otem);
3129 return vector;
3132 /* FLAG = 1 means check for ] to terminate rather than ) and .
3133 FLAG = -1 means check for starting with defun
3134 and make structure pure. */
3136 static Lisp_Object
3137 read_list (flag, readcharfun)
3138 int flag;
3139 register Lisp_Object readcharfun;
3141 /* -1 means check next element for defun,
3142 0 means don't check,
3143 1 means already checked and found defun. */
3144 int defunflag = flag < 0 ? -1 : 0;
3145 Lisp_Object val, tail;
3146 register Lisp_Object elt, tem;
3147 struct gcpro gcpro1, gcpro2;
3148 /* 0 is the normal case.
3149 1 means this list is a doc reference; replace it with the number 0.
3150 2 means this list is a doc reference; replace it with the doc string. */
3151 int doc_reference = 0;
3153 /* Initialize this to 1 if we are reading a list. */
3154 int first_in_list = flag <= 0;
3156 val = Qnil;
3157 tail = Qnil;
3159 while (1)
3161 int ch;
3162 GCPRO2 (val, tail);
3163 elt = read1 (readcharfun, &ch, first_in_list);
3164 UNGCPRO;
3166 first_in_list = 0;
3168 /* While building, if the list starts with #$, treat it specially. */
3169 if (EQ (elt, Vload_file_name)
3170 && ! NILP (elt)
3171 && !NILP (Vpurify_flag))
3173 if (NILP (Vdoc_file_name))
3174 /* We have not yet called Snarf-documentation, so assume
3175 this file is described in the DOC-MM.NN file
3176 and Snarf-documentation will fill in the right value later.
3177 For now, replace the whole list with 0. */
3178 doc_reference = 1;
3179 else
3180 /* We have already called Snarf-documentation, so make a relative
3181 file name for this file, so it can be found properly
3182 in the installed Lisp directory.
3183 We don't use Fexpand_file_name because that would make
3184 the directory absolute now. */
3185 elt = concat2 (build_string ("../lisp/"),
3186 Ffile_name_nondirectory (elt));
3188 else if (EQ (elt, Vload_file_name)
3189 && ! NILP (elt)
3190 && load_force_doc_strings)
3191 doc_reference = 2;
3193 if (ch)
3195 if (flag > 0)
3197 if (ch == ']')
3198 return val;
3199 invalid_syntax (") or . in a vector", 18);
3201 if (ch == ')')
3202 return val;
3203 if (ch == '.')
3205 GCPRO2 (val, tail);
3206 if (!NILP (tail))
3207 XSETCDR (tail, read0 (readcharfun));
3208 else
3209 val = read0 (readcharfun);
3210 read1 (readcharfun, &ch, 0);
3211 UNGCPRO;
3212 if (ch == ')')
3214 if (doc_reference == 1)
3215 return make_number (0);
3216 if (doc_reference == 2)
3218 /* Get a doc string from the file we are loading.
3219 If it's in saved_doc_string, get it from there. */
3220 int pos = XINT (XCDR (val));
3221 /* Position is negative for user variables. */
3222 if (pos < 0) pos = -pos;
3223 if (pos >= saved_doc_string_position
3224 && pos < (saved_doc_string_position
3225 + saved_doc_string_length))
3227 int start = pos - saved_doc_string_position;
3228 int from, to;
3230 /* Process quoting with ^A,
3231 and find the end of the string,
3232 which is marked with ^_ (037). */
3233 for (from = start, to = start;
3234 saved_doc_string[from] != 037;)
3236 int c = saved_doc_string[from++];
3237 if (c == 1)
3239 c = saved_doc_string[from++];
3240 if (c == 1)
3241 saved_doc_string[to++] = c;
3242 else if (c == '0')
3243 saved_doc_string[to++] = 0;
3244 else if (c == '_')
3245 saved_doc_string[to++] = 037;
3247 else
3248 saved_doc_string[to++] = c;
3251 return make_string (saved_doc_string + start,
3252 to - start);
3254 /* Look in prev_saved_doc_string the same way. */
3255 else if (pos >= prev_saved_doc_string_position
3256 && pos < (prev_saved_doc_string_position
3257 + prev_saved_doc_string_length))
3259 int start = pos - prev_saved_doc_string_position;
3260 int from, to;
3262 /* Process quoting with ^A,
3263 and find the end of the string,
3264 which is marked with ^_ (037). */
3265 for (from = start, to = start;
3266 prev_saved_doc_string[from] != 037;)
3268 int c = prev_saved_doc_string[from++];
3269 if (c == 1)
3271 c = prev_saved_doc_string[from++];
3272 if (c == 1)
3273 prev_saved_doc_string[to++] = c;
3274 else if (c == '0')
3275 prev_saved_doc_string[to++] = 0;
3276 else if (c == '_')
3277 prev_saved_doc_string[to++] = 037;
3279 else
3280 prev_saved_doc_string[to++] = c;
3283 return make_string (prev_saved_doc_string + start,
3284 to - start);
3286 else
3287 return get_doc_string (val, 0, 0);
3290 return val;
3292 invalid_syntax (". in wrong context", 18);
3294 invalid_syntax ("] in a list", 11);
3296 tem = (read_pure && flag <= 0
3297 ? pure_cons (elt, Qnil)
3298 : Fcons (elt, Qnil));
3299 if (!NILP (tail))
3300 XSETCDR (tail, tem);
3301 else
3302 val = tem;
3303 tail = tem;
3304 if (defunflag < 0)
3305 defunflag = EQ (elt, Qdefun);
3306 else if (defunflag > 0)
3307 read_pure = 1;
3311 Lisp_Object Vobarray;
3312 Lisp_Object initial_obarray;
3314 /* oblookup stores the bucket number here, for the sake of Funintern. */
3316 int oblookup_last_bucket_number;
3318 static int hash_string ();
3320 /* Get an error if OBARRAY is not an obarray.
3321 If it is one, return it. */
3323 Lisp_Object
3324 check_obarray (obarray)
3325 Lisp_Object obarray;
3327 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3329 /* If Vobarray is now invalid, force it to be valid. */
3330 if (EQ (Vobarray, obarray)) Vobarray = initial_obarray;
3331 wrong_type_argument (Qvectorp, obarray);
3333 return obarray;
3336 /* Intern the C string STR: return a symbol with that name,
3337 interned in the current obarray. */
3339 Lisp_Object
3340 intern (str)
3341 const char *str;
3343 Lisp_Object tem;
3344 int len = strlen (str);
3345 Lisp_Object obarray;
3347 obarray = Vobarray;
3348 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3349 obarray = check_obarray (obarray);
3350 tem = oblookup (obarray, str, len, len);
3351 if (SYMBOLP (tem))
3352 return tem;
3353 return Fintern (make_string (str, len), obarray);
3356 /* Create an uninterned symbol with name STR. */
3358 Lisp_Object
3359 make_symbol (str)
3360 char *str;
3362 int len = strlen (str);
3364 return Fmake_symbol ((!NILP (Vpurify_flag)
3365 ? make_pure_string (str, len, len, 0)
3366 : make_string (str, len)));
3369 DEFUN ("intern", Fintern, Sintern, 1, 2, 0,
3370 doc: /* Return the canonical symbol whose name is STRING.
3371 If there is none, one is created by this function and returned.
3372 A second optional argument specifies the obarray to use;
3373 it defaults to the value of `obarray'. */)
3374 (string, obarray)
3375 Lisp_Object string, obarray;
3377 register Lisp_Object tem, sym, *ptr;
3379 if (NILP (obarray)) obarray = Vobarray;
3380 obarray = check_obarray (obarray);
3382 CHECK_STRING (string);
3384 tem = oblookup (obarray, SDATA (string),
3385 SCHARS (string),
3386 SBYTES (string));
3387 if (!INTEGERP (tem))
3388 return tem;
3390 if (!NILP (Vpurify_flag))
3391 string = Fpurecopy (string);
3392 sym = Fmake_symbol (string);
3394 if (EQ (obarray, initial_obarray))
3395 XSYMBOL (sym)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3396 else
3397 XSYMBOL (sym)->interned = SYMBOL_INTERNED;
3399 if ((SREF (string, 0) == ':')
3400 && EQ (obarray, initial_obarray))
3402 XSYMBOL (sym)->constant = 1;
3403 XSYMBOL (sym)->value = sym;
3406 ptr = &XVECTOR (obarray)->contents[XINT (tem)];
3407 if (SYMBOLP (*ptr))
3408 XSYMBOL (sym)->next = XSYMBOL (*ptr);
3409 else
3410 XSYMBOL (sym)->next = 0;
3411 *ptr = sym;
3412 return sym;
3415 DEFUN ("intern-soft", Fintern_soft, Sintern_soft, 1, 2, 0,
3416 doc: /* Return the canonical symbol named NAME, or nil if none exists.
3417 NAME may be a string or a symbol. If it is a symbol, that exact
3418 symbol is searched for.
3419 A second optional argument specifies the obarray to use;
3420 it defaults to the value of `obarray'. */)
3421 (name, obarray)
3422 Lisp_Object name, obarray;
3424 register Lisp_Object tem, string;
3426 if (NILP (obarray)) obarray = Vobarray;
3427 obarray = check_obarray (obarray);
3429 if (!SYMBOLP (name))
3431 CHECK_STRING (name);
3432 string = name;
3434 else
3435 string = SYMBOL_NAME (name);
3437 tem = oblookup (obarray, SDATA (string), SCHARS (string), SBYTES (string));
3438 if (INTEGERP (tem) || (SYMBOLP (name) && !EQ (name, tem)))
3439 return Qnil;
3440 else
3441 return tem;
3444 DEFUN ("unintern", Funintern, Sunintern, 1, 2, 0,
3445 doc: /* Delete the symbol named NAME, if any, from OBARRAY.
3446 The value is t if a symbol was found and deleted, nil otherwise.
3447 NAME may be a string or a symbol. If it is a symbol, that symbol
3448 is deleted, if it belongs to OBARRAY--no other symbol is deleted.
3449 OBARRAY defaults to the value of the variable `obarray'. */)
3450 (name, obarray)
3451 Lisp_Object name, obarray;
3453 register Lisp_Object string, tem;
3454 int hash;
3456 if (NILP (obarray)) obarray = Vobarray;
3457 obarray = check_obarray (obarray);
3459 if (SYMBOLP (name))
3460 string = SYMBOL_NAME (name);
3461 else
3463 CHECK_STRING (name);
3464 string = name;
3467 tem = oblookup (obarray, SDATA (string),
3468 SCHARS (string),
3469 SBYTES (string));
3470 if (INTEGERP (tem))
3471 return Qnil;
3472 /* If arg was a symbol, don't delete anything but that symbol itself. */
3473 if (SYMBOLP (name) && !EQ (name, tem))
3474 return Qnil;
3476 XSYMBOL (tem)->interned = SYMBOL_UNINTERNED;
3477 XSYMBOL (tem)->constant = 0;
3478 XSYMBOL (tem)->indirect_variable = 0;
3480 hash = oblookup_last_bucket_number;
3482 if (EQ (XVECTOR (obarray)->contents[hash], tem))
3484 if (XSYMBOL (tem)->next)
3485 XSETSYMBOL (XVECTOR (obarray)->contents[hash], XSYMBOL (tem)->next);
3486 else
3487 XSETINT (XVECTOR (obarray)->contents[hash], 0);
3489 else
3491 Lisp_Object tail, following;
3493 for (tail = XVECTOR (obarray)->contents[hash];
3494 XSYMBOL (tail)->next;
3495 tail = following)
3497 XSETSYMBOL (following, XSYMBOL (tail)->next);
3498 if (EQ (following, tem))
3500 XSYMBOL (tail)->next = XSYMBOL (following)->next;
3501 break;
3506 return Qt;
3509 /* Return the symbol in OBARRAY whose names matches the string
3510 of SIZE characters (SIZE_BYTE bytes) at PTR.
3511 If there is no such symbol in OBARRAY, return nil.
3513 Also store the bucket number in oblookup_last_bucket_number. */
3515 Lisp_Object
3516 oblookup (obarray, ptr, size, size_byte)
3517 Lisp_Object obarray;
3518 register const char *ptr;
3519 int size, size_byte;
3521 int hash;
3522 int obsize;
3523 register Lisp_Object tail;
3524 Lisp_Object bucket, tem;
3526 if (!VECTORP (obarray)
3527 || (obsize = XVECTOR (obarray)->size) == 0)
3529 obarray = check_obarray (obarray);
3530 obsize = XVECTOR (obarray)->size;
3532 /* This is sometimes needed in the middle of GC. */
3533 obsize &= ~ARRAY_MARK_FLAG;
3534 /* Combining next two lines breaks VMS C 2.3. */
3535 hash = hash_string (ptr, size_byte);
3536 hash %= obsize;
3537 bucket = XVECTOR (obarray)->contents[hash];
3538 oblookup_last_bucket_number = hash;
3539 if (EQ (bucket, make_number (0)))
3541 else if (!SYMBOLP (bucket))
3542 error ("Bad data in guts of obarray"); /* Like CADR error message */
3543 else
3544 for (tail = bucket; ; XSETSYMBOL (tail, XSYMBOL (tail)->next))
3546 if (SBYTES (SYMBOL_NAME (tail)) == size_byte
3547 && SCHARS (SYMBOL_NAME (tail)) == size
3548 && !bcmp (SDATA (SYMBOL_NAME (tail)), ptr, size_byte))
3549 return tail;
3550 else if (XSYMBOL (tail)->next == 0)
3551 break;
3553 XSETINT (tem, hash);
3554 return tem;
3557 static int
3558 hash_string (ptr, len)
3559 const unsigned char *ptr;
3560 int len;
3562 register const unsigned char *p = ptr;
3563 register const unsigned char *end = p + len;
3564 register unsigned char c;
3565 register int hash = 0;
3567 while (p != end)
3569 c = *p++;
3570 if (c >= 0140) c -= 40;
3571 hash = ((hash<<3) + (hash>>28) + c);
3573 return hash & 07777777777;
3576 void
3577 map_obarray (obarray, fn, arg)
3578 Lisp_Object obarray;
3579 void (*fn) P_ ((Lisp_Object, Lisp_Object));
3580 Lisp_Object arg;
3582 register int i;
3583 register Lisp_Object tail;
3584 CHECK_VECTOR (obarray);
3585 for (i = XVECTOR (obarray)->size - 1; i >= 0; i--)
3587 tail = XVECTOR (obarray)->contents[i];
3588 if (SYMBOLP (tail))
3589 while (1)
3591 (*fn) (tail, arg);
3592 if (XSYMBOL (tail)->next == 0)
3593 break;
3594 XSETSYMBOL (tail, XSYMBOL (tail)->next);
3599 void
3600 mapatoms_1 (sym, function)
3601 Lisp_Object sym, function;
3603 call1 (function, sym);
3606 DEFUN ("mapatoms", Fmapatoms, Smapatoms, 1, 2, 0,
3607 doc: /* Call FUNCTION on every symbol in OBARRAY.
3608 OBARRAY defaults to the value of `obarray'. */)
3609 (function, obarray)
3610 Lisp_Object function, obarray;
3612 if (NILP (obarray)) obarray = Vobarray;
3613 obarray = check_obarray (obarray);
3615 map_obarray (obarray, mapatoms_1, function);
3616 return Qnil;
3619 #define OBARRAY_SIZE 1511
3621 void
3622 init_obarray ()
3624 Lisp_Object oblength;
3625 int hash;
3626 Lisp_Object *tem;
3628 XSETFASTINT (oblength, OBARRAY_SIZE);
3630 Qnil = Fmake_symbol (make_pure_string ("nil", 3, 3, 0));
3631 Vobarray = Fmake_vector (oblength, make_number (0));
3632 initial_obarray = Vobarray;
3633 staticpro (&initial_obarray);
3634 /* Intern nil in the obarray */
3635 XSYMBOL (Qnil)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3636 XSYMBOL (Qnil)->constant = 1;
3638 /* These locals are to kludge around a pyramid compiler bug. */
3639 hash = hash_string ("nil", 3);
3640 /* Separate statement here to avoid VAXC bug. */
3641 hash %= OBARRAY_SIZE;
3642 tem = &XVECTOR (Vobarray)->contents[hash];
3643 *tem = Qnil;
3645 Qunbound = Fmake_symbol (make_pure_string ("unbound", 7, 7, 0));
3646 XSYMBOL (Qnil)->function = Qunbound;
3647 XSYMBOL (Qunbound)->value = Qunbound;
3648 XSYMBOL (Qunbound)->function = Qunbound;
3650 Qt = intern ("t");
3651 XSYMBOL (Qnil)->value = Qnil;
3652 XSYMBOL (Qnil)->plist = Qnil;
3653 XSYMBOL (Qt)->value = Qt;
3654 XSYMBOL (Qt)->constant = 1;
3656 /* Qt is correct even if CANNOT_DUMP. loadup.el will set to nil at end. */
3657 Vpurify_flag = Qt;
3659 Qvariable_documentation = intern ("variable-documentation");
3660 staticpro (&Qvariable_documentation);
3662 read_buffer_size = 100 + MAX_MULTIBYTE_LENGTH;
3663 read_buffer = (char *) xmalloc (read_buffer_size);
3666 void
3667 defsubr (sname)
3668 struct Lisp_Subr *sname;
3670 Lisp_Object sym;
3671 sym = intern (sname->symbol_name);
3672 XSETPVECTYPE (sname, PVEC_SUBR);
3673 XSETSUBR (XSYMBOL (sym)->function, sname);
3676 #ifdef NOTDEF /* use fset in subr.el now */
3677 void
3678 defalias (sname, string)
3679 struct Lisp_Subr *sname;
3680 char *string;
3682 Lisp_Object sym;
3683 sym = intern (string);
3684 XSETSUBR (XSYMBOL (sym)->function, sname);
3686 #endif /* NOTDEF */
3688 /* Define an "integer variable"; a symbol whose value is forwarded
3689 to a C variable of type int. Sample call:
3690 DEFVAR_INT ("emacs-priority", &emacs_priority, "Documentation"); */
3691 void
3692 defvar_int (namestring, address)
3693 char *namestring;
3694 EMACS_INT *address;
3696 Lisp_Object sym, val;
3697 sym = intern (namestring);
3698 val = allocate_misc ();
3699 XMISCTYPE (val) = Lisp_Misc_Intfwd;
3700 XINTFWD (val)->intvar = address;
3701 SET_SYMBOL_VALUE (sym, val);
3704 /* Similar but define a variable whose value is t if address contains 1,
3705 nil if address contains 0. */
3706 void
3707 defvar_bool (namestring, address)
3708 char *namestring;
3709 int *address;
3711 Lisp_Object sym, val;
3712 sym = intern (namestring);
3713 val = allocate_misc ();
3714 XMISCTYPE (val) = Lisp_Misc_Boolfwd;
3715 XBOOLFWD (val)->boolvar = address;
3716 SET_SYMBOL_VALUE (sym, val);
3717 Vbyte_boolean_vars = Fcons (sym, Vbyte_boolean_vars);
3720 /* Similar but define a variable whose value is the Lisp Object stored
3721 at address. Two versions: with and without gc-marking of the C
3722 variable. The nopro version is used when that variable will be
3723 gc-marked for some other reason, since marking the same slot twice
3724 can cause trouble with strings. */
3725 void
3726 defvar_lisp_nopro (namestring, address)
3727 char *namestring;
3728 Lisp_Object *address;
3730 Lisp_Object sym, val;
3731 sym = intern (namestring);
3732 val = allocate_misc ();
3733 XMISCTYPE (val) = Lisp_Misc_Objfwd;
3734 XOBJFWD (val)->objvar = address;
3735 SET_SYMBOL_VALUE (sym, val);
3738 void
3739 defvar_lisp (namestring, address)
3740 char *namestring;
3741 Lisp_Object *address;
3743 defvar_lisp_nopro (namestring, address);
3744 staticpro (address);
3747 /* Similar but define a variable whose value is the Lisp Object stored
3748 at a particular offset in the current kboard object. */
3750 void
3751 defvar_kboard (namestring, offset)
3752 char *namestring;
3753 int offset;
3755 Lisp_Object sym, val;
3756 sym = intern (namestring);
3757 val = allocate_misc ();
3758 XMISCTYPE (val) = Lisp_Misc_Kboard_Objfwd;
3759 XKBOARD_OBJFWD (val)->offset = offset;
3760 SET_SYMBOL_VALUE (sym, val);
3763 /* Record the value of load-path used at the start of dumping
3764 so we can see if the site changed it later during dumping. */
3765 static Lisp_Object dump_path;
3767 void
3768 init_lread ()
3770 char *normal;
3771 int turn_off_warning = 0;
3773 /* Compute the default load-path. */
3774 #ifdef CANNOT_DUMP
3775 normal = PATH_LOADSEARCH;
3776 Vload_path = decode_env_path (0, normal);
3777 #else
3778 if (NILP (Vpurify_flag))
3779 normal = PATH_LOADSEARCH;
3780 else
3781 normal = PATH_DUMPLOADSEARCH;
3783 /* In a dumped Emacs, we normally have to reset the value of
3784 Vload_path from PATH_LOADSEARCH, since the value that was dumped
3785 uses ../lisp, instead of the path of the installed elisp
3786 libraries. However, if it appears that Vload_path was changed
3787 from the default before dumping, don't override that value. */
3788 if (initialized)
3790 if (! NILP (Fequal (dump_path, Vload_path)))
3792 Vload_path = decode_env_path (0, normal);
3793 if (!NILP (Vinstallation_directory))
3795 Lisp_Object tem, tem1, sitelisp;
3797 /* Remove site-lisp dirs from path temporarily and store
3798 them in sitelisp, then conc them on at the end so
3799 they're always first in path. */
3800 sitelisp = Qnil;
3801 while (1)
3803 tem = Fcar (Vload_path);
3804 tem1 = Fstring_match (build_string ("site-lisp"),
3805 tem, Qnil);
3806 if (!NILP (tem1))
3808 Vload_path = Fcdr (Vload_path);
3809 sitelisp = Fcons (tem, sitelisp);
3811 else
3812 break;
3815 /* Add to the path the lisp subdir of the
3816 installation dir, if it exists. */
3817 tem = Fexpand_file_name (build_string ("lisp"),
3818 Vinstallation_directory);
3819 tem1 = Ffile_exists_p (tem);
3820 if (!NILP (tem1))
3822 if (NILP (Fmember (tem, Vload_path)))
3824 turn_off_warning = 1;
3825 Vload_path = Fcons (tem, Vload_path);
3828 else
3829 /* That dir doesn't exist, so add the build-time
3830 Lisp dirs instead. */
3831 Vload_path = nconc2 (Vload_path, dump_path);
3833 /* Add leim under the installation dir, if it exists. */
3834 tem = Fexpand_file_name (build_string ("leim"),
3835 Vinstallation_directory);
3836 tem1 = Ffile_exists_p (tem);
3837 if (!NILP (tem1))
3839 if (NILP (Fmember (tem, Vload_path)))
3840 Vload_path = Fcons (tem, Vload_path);
3843 /* Add site-lisp under the installation dir, if it exists. */
3844 tem = Fexpand_file_name (build_string ("site-lisp"),
3845 Vinstallation_directory);
3846 tem1 = Ffile_exists_p (tem);
3847 if (!NILP (tem1))
3849 if (NILP (Fmember (tem, Vload_path)))
3850 Vload_path = Fcons (tem, Vload_path);
3853 /* If Emacs was not built in the source directory,
3854 and it is run from where it was built, add to load-path
3855 the lisp, leim and site-lisp dirs under that directory. */
3857 if (NILP (Fequal (Vinstallation_directory, Vsource_directory)))
3859 Lisp_Object tem2;
3861 tem = Fexpand_file_name (build_string ("src/Makefile"),
3862 Vinstallation_directory);
3863 tem1 = Ffile_exists_p (tem);
3865 /* Don't be fooled if they moved the entire source tree
3866 AFTER dumping Emacs. If the build directory is indeed
3867 different from the source dir, src/Makefile.in and
3868 src/Makefile will not be found together. */
3869 tem = Fexpand_file_name (build_string ("src/Makefile.in"),
3870 Vinstallation_directory);
3871 tem2 = Ffile_exists_p (tem);
3872 if (!NILP (tem1) && NILP (tem2))
3874 tem = Fexpand_file_name (build_string ("lisp"),
3875 Vsource_directory);
3877 if (NILP (Fmember (tem, Vload_path)))
3878 Vload_path = Fcons (tem, Vload_path);
3880 tem = Fexpand_file_name (build_string ("leim"),
3881 Vsource_directory);
3883 if (NILP (Fmember (tem, Vload_path)))
3884 Vload_path = Fcons (tem, Vload_path);
3886 tem = Fexpand_file_name (build_string ("site-lisp"),
3887 Vsource_directory);
3889 if (NILP (Fmember (tem, Vload_path)))
3890 Vload_path = Fcons (tem, Vload_path);
3893 if (!NILP (sitelisp))
3894 Vload_path = nconc2 (Fnreverse (sitelisp), Vload_path);
3898 else
3900 /* NORMAL refers to the lisp dir in the source directory. */
3901 /* We used to add ../lisp at the front here, but
3902 that caused trouble because it was copied from dump_path
3903 into Vload_path, above, when Vinstallation_directory was non-nil.
3904 It should be unnecessary. */
3905 Vload_path = decode_env_path (0, normal);
3906 dump_path = Vload_path;
3908 #endif
3910 #if (!(defined(WINDOWSNT) || (defined(HAVE_CARBON))))
3911 /* When Emacs is invoked over network shares on NT, PATH_LOADSEARCH is
3912 almost never correct, thereby causing a warning to be printed out that
3913 confuses users. Since PATH_LOADSEARCH is always overridden by the
3914 EMACSLOADPATH environment variable below, disable the warning on NT.
3915 Also, when using the "self-contained" option for Carbon Emacs for MacOSX,
3916 the "standard" paths may not exist and would be overridden by
3917 EMACSLOADPATH as on NT. Since this depends on how the executable
3918 was build and packaged, turn off the warnings in general */
3920 /* Warn if dirs in the *standard* path don't exist. */
3921 if (!turn_off_warning)
3923 Lisp_Object path_tail;
3925 for (path_tail = Vload_path;
3926 !NILP (path_tail);
3927 path_tail = XCDR (path_tail))
3929 Lisp_Object dirfile;
3930 dirfile = Fcar (path_tail);
3931 if (STRINGP (dirfile))
3933 dirfile = Fdirectory_file_name (dirfile);
3934 if (access (SDATA (dirfile), 0) < 0)
3935 dir_warning ("Warning: Lisp directory `%s' does not exist.\n",
3936 XCAR (path_tail));
3940 #endif /* !(WINDOWSNT || HAVE_CARBON) */
3942 /* If the EMACSLOADPATH environment variable is set, use its value.
3943 This doesn't apply if we're dumping. */
3944 #ifndef CANNOT_DUMP
3945 if (NILP (Vpurify_flag)
3946 && egetenv ("EMACSLOADPATH"))
3947 #endif
3948 Vload_path = decode_env_path ("EMACSLOADPATH", normal);
3950 Vvalues = Qnil;
3952 load_in_progress = 0;
3953 Vload_file_name = Qnil;
3955 load_descriptor_list = Qnil;
3957 Vstandard_input = Qt;
3958 Vloads_in_progress = Qnil;
3961 /* Print a warning, using format string FORMAT, that directory DIRNAME
3962 does not exist. Print it on stderr and put it in *Messages*. */
3964 void
3965 dir_warning (format, dirname)
3966 char *format;
3967 Lisp_Object dirname;
3969 char *buffer
3970 = (char *) alloca (SCHARS (dirname) + strlen (format) + 5);
3972 fprintf (stderr, format, SDATA (dirname));
3973 sprintf (buffer, format, SDATA (dirname));
3974 /* Don't log the warning before we've initialized!! */
3975 if (initialized)
3976 message_dolog (buffer, strlen (buffer), 0, STRING_MULTIBYTE (dirname));
3979 void
3980 syms_of_lread ()
3982 defsubr (&Sread);
3983 defsubr (&Sread_from_string);
3984 defsubr (&Sintern);
3985 defsubr (&Sintern_soft);
3986 defsubr (&Sunintern);
3987 defsubr (&Sget_load_suffixes);
3988 defsubr (&Sload);
3989 defsubr (&Seval_buffer);
3990 defsubr (&Seval_region);
3991 defsubr (&Sread_char);
3992 defsubr (&Sread_char_exclusive);
3993 defsubr (&Sread_event);
3994 defsubr (&Sget_file_char);
3995 defsubr (&Smapatoms);
3996 defsubr (&Slocate_file_internal);
3998 DEFVAR_LISP ("obarray", &Vobarray,
3999 doc: /* Symbol table for use by `intern' and `read'.
4000 It is a vector whose length ought to be prime for best results.
4001 The vector's contents don't make sense if examined from Lisp programs;
4002 to find all the symbols in an obarray, use `mapatoms'. */);
4004 DEFVAR_LISP ("values", &Vvalues,
4005 doc: /* List of values of all expressions which were read, evaluated and printed.
4006 Order is reverse chronological. */);
4008 DEFVAR_LISP ("standard-input", &Vstandard_input,
4009 doc: /* Stream for read to get input from.
4010 See documentation of `read' for possible values. */);
4011 Vstandard_input = Qt;
4013 DEFVAR_LISP ("read-with-symbol-positions", &Vread_with_symbol_positions,
4014 doc: /* If non-nil, add position of read symbols to `read-symbol-positions-list'.
4016 If this variable is a buffer, then only forms read from that buffer
4017 will be added to `read-symbol-positions-list'.
4018 If this variable is t, then all read forms will be added.
4019 The effect of all other values other than nil are not currently
4020 defined, although they may be in the future.
4022 The positions are relative to the last call to `read' or
4023 `read-from-string'. It is probably a bad idea to set this variable at
4024 the toplevel; bind it instead. */);
4025 Vread_with_symbol_positions = Qnil;
4027 DEFVAR_LISP ("read-symbol-positions-list", &Vread_symbol_positions_list,
4028 doc: /* A list mapping read symbols to their positions.
4029 This variable is modified during calls to `read' or
4030 `read-from-string', but only when `read-with-symbol-positions' is
4031 non-nil.
4033 Each element of the list looks like (SYMBOL . CHAR-POSITION), where
4034 CHAR-POSITION is an integer giving the offset of that occurrence of the
4035 symbol from the position where `read' or `read-from-string' started.
4037 Note that a symbol will appear multiple times in this list, if it was
4038 read multiple times. The list is in the same order as the symbols
4039 were read in. */);
4040 Vread_symbol_positions_list = Qnil;
4042 DEFVAR_LISP ("load-path", &Vload_path,
4043 doc: /* *List of directories to search for files to load.
4044 Each element is a string (directory name) or nil (try default directory).
4045 Initialized based on EMACSLOADPATH environment variable, if any,
4046 otherwise to default specified by file `epaths.h' when Emacs was built. */);
4048 DEFVAR_LISP ("load-suffixes", &Vload_suffixes,
4049 doc: /* List of suffixes for (compiled or source) Emacs Lisp files.
4050 This list should not include the empty string.
4051 `load' and related functions try to append these suffixes, in order,
4052 to the specified file name if a Lisp suffix is allowed or required. */);
4053 Vload_suffixes = Fcons (build_string (".elc"),
4054 Fcons (build_string (".el"), Qnil));
4055 DEFVAR_LISP ("load-file-rep-suffixes", &Vload_file_rep_suffixes,
4056 doc: /* List of suffixes that indicate representations of \
4057 the same file.
4058 This list should normally start with the empty string.
4060 Enabling Auto Compression mode appends the suffixes in
4061 `jka-compr-load-suffixes' to this list and disabling Auto Compression
4062 mode removes them again. `load' and related functions use this list to
4063 determine whether they should look for compressed versions of a file
4064 and, if so, which suffixes they should try to append to the file name
4065 in order to do so. However, if you want to customize which suffixes
4066 the loading functions recognize as compression suffixes, you should
4067 customize `jka-compr-load-suffixes' rather than the present variable. */);
4068 Vload_file_rep_suffixes = Fcons (empty_unibyte_string, Qnil);
4070 DEFVAR_BOOL ("load-in-progress", &load_in_progress,
4071 doc: /* Non-nil if inside of `load'. */);
4073 DEFVAR_LISP ("after-load-alist", &Vafter_load_alist,
4074 doc: /* An alist of expressions to be evalled when particular files are loaded.
4075 Each element looks like (REGEXP-OR-FEATURE FORMS...).
4077 REGEXP-OR-FEATURE is either a regular expression to match file names, or
4078 a symbol \(a feature name).
4080 When `load' is run and the file-name argument matches an element's
4081 REGEXP-OR-FEATURE, or when `provide' is run and provides the symbol
4082 REGEXP-OR-FEATURE, the FORMS in the element are executed.
4084 An error in FORMS does not undo the load, but does prevent execution of
4085 the rest of the FORMS. */);
4086 Vafter_load_alist = Qnil;
4088 DEFVAR_LISP ("load-history", &Vload_history,
4089 doc: /* Alist mapping file names to symbols and features.
4090 Each alist element is a list that starts with a file name,
4091 except for one element (optional) that starts with nil and describes
4092 definitions evaluated from buffers not visiting files.
4094 The file name is absolute and is the true file name (i.e. it doesn't
4095 contain symbolic links) of the loaded file.
4097 The remaining elements of each list are symbols defined as variables
4098 and cons cells of the form `(provide . FEATURE)', `(require . FEATURE)',
4099 `(defun . FUNCTION)', `(autoload . SYMBOL)', `(defface . SYMBOL)'
4100 and `(t . SYMBOL)'. An element `(t . SYMBOL)' precedes an entry
4101 `(defun . FUNCTION)', and means that SYMBOL was an autoload before
4102 this file redefined it as a function.
4104 During preloading, the file name recorded is relative to the main Lisp
4105 directory. These file names are converted to absolute at startup. */);
4106 Vload_history = Qnil;
4108 DEFVAR_LISP ("load-file-name", &Vload_file_name,
4109 doc: /* Full name of file being loaded by `load'. */);
4110 Vload_file_name = Qnil;
4112 DEFVAR_LISP ("user-init-file", &Vuser_init_file,
4113 doc: /* File name, including directory, of user's initialization file.
4114 If the file loaded had extension `.elc', and the corresponding source file
4115 exists, this variable contains the name of source file, suitable for use
4116 by functions like `custom-save-all' which edit the init file.
4117 While Emacs loads and evaluates the init file, value is the real name
4118 of the file, regardless of whether or not it has the `.elc' extension. */);
4119 Vuser_init_file = Qnil;
4121 DEFVAR_LISP ("current-load-list", &Vcurrent_load_list,
4122 doc: /* Used for internal purposes by `load'. */);
4123 Vcurrent_load_list = Qnil;
4125 DEFVAR_LISP ("load-read-function", &Vload_read_function,
4126 doc: /* Function used by `load' and `eval-region' for reading expressions.
4127 The default is nil, which means use the function `read'. */);
4128 Vload_read_function = Qnil;
4130 DEFVAR_LISP ("load-source-file-function", &Vload_source_file_function,
4131 doc: /* Function called in `load' for loading an Emacs Lisp source file.
4132 This function is for doing code conversion before reading the source file.
4133 If nil, loading is done without any code conversion.
4134 Arguments are FULLNAME, FILE, NOERROR, NOMESSAGE, where
4135 FULLNAME is the full name of FILE.
4136 See `load' for the meaning of the remaining arguments. */);
4137 Vload_source_file_function = Qnil;
4139 DEFVAR_BOOL ("load-force-doc-strings", &load_force_doc_strings,
4140 doc: /* Non-nil means `load' should force-load all dynamic doc strings.
4141 This is useful when the file being loaded is a temporary copy. */);
4142 load_force_doc_strings = 0;
4144 DEFVAR_BOOL ("load-convert-to-unibyte", &load_convert_to_unibyte,
4145 doc: /* Non-nil means `read' converts strings to unibyte whenever possible.
4146 This is normally bound by `load' and `eval-buffer' to control `read',
4147 and is not meant for users to change. */);
4148 load_convert_to_unibyte = 0;
4150 DEFVAR_LISP ("source-directory", &Vsource_directory,
4151 doc: /* Directory in which Emacs sources were found when Emacs was built.
4152 You cannot count on them to still be there! */);
4153 Vsource_directory
4154 = Fexpand_file_name (build_string ("../"),
4155 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH)));
4157 DEFVAR_LISP ("preloaded-file-list", &Vpreloaded_file_list,
4158 doc: /* List of files that were preloaded (when dumping Emacs). */);
4159 Vpreloaded_file_list = Qnil;
4161 DEFVAR_LISP ("byte-boolean-vars", &Vbyte_boolean_vars,
4162 doc: /* List of all DEFVAR_BOOL variables, used by the byte code optimizer. */);
4163 Vbyte_boolean_vars = Qnil;
4165 DEFVAR_BOOL ("load-dangerous-libraries", &load_dangerous_libraries,
4166 doc: /* Non-nil means load dangerous compiled Lisp files.
4167 Some versions of XEmacs use different byte codes than Emacs. These
4168 incompatible byte codes can make Emacs crash when it tries to execute
4169 them. */);
4170 load_dangerous_libraries = 0;
4172 DEFVAR_LISP ("bytecomp-version-regexp", &Vbytecomp_version_regexp,
4173 doc: /* Regular expression matching safe to load compiled Lisp files.
4174 When Emacs loads a compiled Lisp file, it reads the first 512 bytes
4175 from the file, and matches them against this regular expression.
4176 When the regular expression matches, the file is considered to be safe
4177 to load. See also `load-dangerous-libraries'. */);
4178 Vbytecomp_version_regexp
4179 = build_string ("^;;;.\\(in Emacs version\\|bytecomp version FSF\\)");
4181 DEFVAR_LISP ("eval-buffer-list", &Veval_buffer_list,
4182 doc: /* List of buffers being read from by calls to `eval-buffer' and `eval-region'. */);
4183 Veval_buffer_list = Qnil;
4185 DEFVAR_LISP ("old-style-backquotes", &Vold_style_backquotes,
4186 doc: /* Set to non-nil when `read' encounters an old-style backquote. */);
4187 Vold_style_backquotes = Qnil;
4188 Qold_style_backquotes = intern ("old-style-backquotes");
4189 staticpro (&Qold_style_backquotes);
4191 /* Vsource_directory was initialized in init_lread. */
4193 load_descriptor_list = Qnil;
4194 staticpro (&load_descriptor_list);
4196 Qcurrent_load_list = intern ("current-load-list");
4197 staticpro (&Qcurrent_load_list);
4199 Qstandard_input = intern ("standard-input");
4200 staticpro (&Qstandard_input);
4202 Qread_char = intern ("read-char");
4203 staticpro (&Qread_char);
4205 Qget_file_char = intern ("get-file-char");
4206 staticpro (&Qget_file_char);
4208 Qbackquote = intern ("`");
4209 staticpro (&Qbackquote);
4210 Qcomma = intern (",");
4211 staticpro (&Qcomma);
4212 Qcomma_at = intern (",@");
4213 staticpro (&Qcomma_at);
4214 Qcomma_dot = intern (",.");
4215 staticpro (&Qcomma_dot);
4217 Qinhibit_file_name_operation = intern ("inhibit-file-name-operation");
4218 staticpro (&Qinhibit_file_name_operation);
4220 Qascii_character = intern ("ascii-character");
4221 staticpro (&Qascii_character);
4223 Qfunction = intern ("function");
4224 staticpro (&Qfunction);
4226 Qload = intern ("load");
4227 staticpro (&Qload);
4229 Qload_file_name = intern ("load-file-name");
4230 staticpro (&Qload_file_name);
4232 Qeval_buffer_list = intern ("eval-buffer-list");
4233 staticpro (&Qeval_buffer_list);
4235 Qfile_truename = intern ("file-truename");
4236 staticpro (&Qfile_truename) ;
4238 Qdo_after_load_evaluation = intern ("do-after-load-evaluation");
4239 staticpro (&Qdo_after_load_evaluation) ;
4241 staticpro (&dump_path);
4243 staticpro (&read_objects);
4244 read_objects = Qnil;
4245 staticpro (&seen_list);
4246 seen_list = Qnil;
4248 Vloads_in_progress = Qnil;
4249 staticpro (&Vloads_in_progress);
4252 /* arch-tag: a0d02733-0f96-4844-a659-9fd53c4f414d
4253 (do not change this comment) */