1 /* Lisp parsing and input streams.
2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1993, 1994, 1995,
3 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
24 #include <sys/types.h>
30 #include "intervals.h"
32 #include "character.h"
39 #include "termhooks.h"
41 #include "blockinput.h"
55 #endif /* HAVE_SETLOCALE */
65 #define file_offset off_t
66 #define file_tell ftello
68 #define file_offset long
69 #define file_tell ftell
72 /* hash table read constants */
73 Lisp_Object Qhash_table
, Qdata
;
74 Lisp_Object Qtest
, Qsize
;
75 Lisp_Object Qweakness
;
76 Lisp_Object Qrehash_size
;
77 Lisp_Object Qrehash_threshold
;
78 extern Lisp_Object QCtest
, QCsize
, QCrehash_size
, QCrehash_threshold
, QCweakness
;
80 Lisp_Object Qread_char
, Qget_file_char
, Qstandard_input
, Qcurrent_load_list
;
81 Lisp_Object Qvariable_documentation
, Vvalues
, Vstandard_input
, Vafter_load_alist
;
82 Lisp_Object Qascii_character
, Qload
, Qload_file_name
;
83 Lisp_Object Qbackquote
, Qcomma
, Qcomma_at
, Qcomma_dot
, Qfunction
;
84 Lisp_Object Qinhibit_file_name_operation
;
85 Lisp_Object Qeval_buffer_list
, Veval_buffer_list
;
86 Lisp_Object Qfile_truename
, Qdo_after_load_evaluation
; /* ACM 2006/5/16 */
88 /* Used instead of Qget_file_char while loading *.elc files compiled
89 by Emacs 21 or older. */
90 static Lisp_Object Qget_emacs_mule_file_char
;
92 static Lisp_Object Qload_force_doc_strings
;
94 extern Lisp_Object Qevent_symbol_element_mask
;
95 extern Lisp_Object Qfile_exists_p
;
97 /* non-zero if inside `load' */
99 static Lisp_Object Qload_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 /* Non-nil means read recursive structures using #n= and #n# syntax. */
127 Lisp_Object Vread_circle
;
129 /* The association list of objects read with the #n=object form.
130 Each member of the list has the form (n . object), and is used to
131 look up the object for the corresponding #n# construct.
132 It must be set to nil before all top-level calls to read0. */
133 Lisp_Object read_objects
;
135 /* Nonzero means load should forcibly load all dynamic doc strings. */
136 static int load_force_doc_strings
;
138 /* Nonzero means read should convert strings to unibyte. */
139 static int load_convert_to_unibyte
;
141 /* Nonzero means READCHAR should read bytes one by one (not character)
142 when READCHARFUN is Qget_file_char or Qget_emacs_mule_file_char.
143 This is set to 1 by read1 temporarily while handling #@NUMBER. */
144 static int load_each_byte
;
146 /* Function to use for loading an Emacs Lisp source file (not
147 compiled) instead of readevalloop. */
148 Lisp_Object Vload_source_file_function
;
150 /* List of all DEFVAR_BOOL variables. Used by the byte optimizer. */
151 Lisp_Object Vbyte_boolean_vars
;
153 /* Whether or not to add a `read-positions' property to symbols
155 Lisp_Object Vread_with_symbol_positions
;
157 /* List of (SYMBOL . POSITION) accumulated so far. */
158 Lisp_Object Vread_symbol_positions_list
;
160 /* List of descriptors now open for Fload. */
161 static Lisp_Object load_descriptor_list
;
163 /* File for get_file_char to read from. Use by load. */
164 static FILE *instream
;
166 /* When nonzero, read conses in pure space */
167 static int read_pure
;
169 /* For use within read-from-string (this reader is non-reentrant!!) */
170 static int read_from_string_index
;
171 static int read_from_string_index_byte
;
172 static int read_from_string_limit
;
174 /* Number of characters read in the current call to Fread or
175 Fread_from_string. */
176 static int readchar_count
;
178 /* This contains the last string skipped with #@. */
179 static char *saved_doc_string
;
180 /* Length of buffer allocated in saved_doc_string. */
181 static int saved_doc_string_size
;
182 /* Length of actual data in saved_doc_string. */
183 static int saved_doc_string_length
;
184 /* This is the file position that string came from. */
185 static file_offset saved_doc_string_position
;
187 /* This contains the previous string skipped with #@.
188 We copy it from saved_doc_string when a new string
189 is put in saved_doc_string. */
190 static char *prev_saved_doc_string
;
191 /* Length of buffer allocated in prev_saved_doc_string. */
192 static int prev_saved_doc_string_size
;
193 /* Length of actual data in prev_saved_doc_string. */
194 static int prev_saved_doc_string_length
;
195 /* This is the file position that string came from. */
196 static file_offset prev_saved_doc_string_position
;
198 /* Nonzero means inside a new-style backquote
199 with no surrounding parentheses.
200 Fread initializes this to zero, so we need not specbind it
201 or worry about what happens to it when there is an error. */
202 static int new_backquote_flag
;
203 static Lisp_Object Vold_style_backquotes
, Qold_style_backquotes
;
205 /* A list of file names for files being loaded in Fload. Used to
206 check for recursive loads. */
208 static Lisp_Object Vloads_in_progress
;
210 /* Non-zero means load dangerous compiled Lisp files. */
212 int load_dangerous_libraries
;
214 /* Non-zero means force printing messages when loading Lisp files. */
216 int force_load_messages
;
218 /* A regular expression used to detect files compiled with Emacs. */
220 static Lisp_Object Vbytecomp_version_regexp
;
222 static int read_emacs_mule_char
P_ ((int, int (*) (int, Lisp_Object
),
225 static void readevalloop
P_ ((Lisp_Object
, FILE*, Lisp_Object
,
226 Lisp_Object (*) (), int,
227 Lisp_Object
, Lisp_Object
,
228 Lisp_Object
, Lisp_Object
));
229 static Lisp_Object load_unwind
P_ ((Lisp_Object
));
230 static Lisp_Object load_descriptor_unwind
P_ ((Lisp_Object
));
232 static void invalid_syntax
P_ ((const char *, int)) NO_RETURN
;
233 static void end_of_file_error
P_ (()) NO_RETURN
;
236 /* Functions that read one byte from the current source READCHARFUN
237 or unreads one byte. If the integer argument C is -1, it returns
238 one read byte, or -1 when there's no more byte in the source. If C
239 is 0 or positive, it unreads C, and the return value is not
242 static int readbyte_for_lambda
P_ ((int, Lisp_Object
));
243 static int readbyte_from_file
P_ ((int, Lisp_Object
));
244 static int readbyte_from_string
P_ ((int, Lisp_Object
));
246 /* Handle unreading and rereading of characters.
247 Write READCHAR to read a character,
248 UNREAD(c) to unread c to be read again.
250 These macros correctly read/unread multibyte characters. */
252 #define READCHAR readchar (readcharfun, NULL)
253 #define UNREAD(c) unreadchar (readcharfun, c)
255 /* Same as READCHAR but set *MULTIBYTE to the multibyteness of the source. */
256 #define READCHAR_REPORT_MULTIBYTE(multibyte) readchar (readcharfun, multibyte)
258 /* When READCHARFUN is Qget_file_char, Qget_emacs_mule_file_char,
259 Qlambda, or a cons, we use this to keep an unread character because
260 a file stream can't handle multibyte-char unreading. The value -1
261 means that there's no unread character. */
262 static int unread_char
;
265 readchar (readcharfun
, multibyte
)
266 Lisp_Object readcharfun
;
271 int (*readbyte
) P_ ((int, Lisp_Object
));
272 unsigned char buf
[MAX_MULTIBYTE_LENGTH
];
274 int emacs_mule_encoding
= 0;
281 if (BUFFERP (readcharfun
))
283 register struct buffer
*inbuffer
= XBUFFER (readcharfun
);
285 int pt_byte
= BUF_PT_BYTE (inbuffer
);
287 if (pt_byte
>= BUF_ZV_BYTE (inbuffer
))
290 if (! NILP (inbuffer
->enable_multibyte_characters
))
292 /* Fetch the character code from the buffer. */
293 unsigned char *p
= BUF_BYTE_ADDRESS (inbuffer
, pt_byte
);
294 BUF_INC_POS (inbuffer
, pt_byte
);
301 c
= BUF_FETCH_BYTE (inbuffer
, pt_byte
);
302 if (! ASCII_BYTE_P (c
))
303 c
= BYTE8_TO_CHAR (c
);
306 SET_BUF_PT_BOTH (inbuffer
, BUF_PT (inbuffer
) + 1, pt_byte
);
310 if (MARKERP (readcharfun
))
312 register struct buffer
*inbuffer
= XMARKER (readcharfun
)->buffer
;
314 int bytepos
= marker_byte_position (readcharfun
);
316 if (bytepos
>= BUF_ZV_BYTE (inbuffer
))
319 if (! NILP (inbuffer
->enable_multibyte_characters
))
321 /* Fetch the character code from the buffer. */
322 unsigned char *p
= BUF_BYTE_ADDRESS (inbuffer
, bytepos
);
323 BUF_INC_POS (inbuffer
, bytepos
);
330 c
= BUF_FETCH_BYTE (inbuffer
, bytepos
);
331 if (! ASCII_BYTE_P (c
))
332 c
= BYTE8_TO_CHAR (c
);
336 XMARKER (readcharfun
)->bytepos
= bytepos
;
337 XMARKER (readcharfun
)->charpos
++;
342 if (EQ (readcharfun
, Qlambda
))
344 readbyte
= readbyte_for_lambda
;
348 if (EQ (readcharfun
, Qget_file_char
))
350 readbyte
= readbyte_from_file
;
354 if (STRINGP (readcharfun
))
356 if (read_from_string_index
>= read_from_string_limit
)
358 else if (STRING_MULTIBYTE (readcharfun
))
362 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c
, readcharfun
,
363 read_from_string_index
,
364 read_from_string_index_byte
);
368 c
= SREF (readcharfun
, read_from_string_index_byte
);
369 read_from_string_index
++;
370 read_from_string_index_byte
++;
375 if (CONSP (readcharfun
))
377 /* This is the case that read_vector is reading from a unibyte
378 string that contains a byte sequence previously skipped
379 because of #@NUMBER. The car part of readcharfun is that
380 string, and the cdr part is a value of readcharfun given to
382 readbyte
= readbyte_from_string
;
383 if (EQ (XCDR (readcharfun
), Qget_emacs_mule_file_char
))
384 emacs_mule_encoding
= 1;
388 if (EQ (readcharfun
, Qget_emacs_mule_file_char
))
390 readbyte
= readbyte_from_file
;
391 emacs_mule_encoding
= 1;
395 tem
= call0 (readcharfun
);
402 if (unread_char
>= 0)
408 c
= (*readbyte
) (-1, readcharfun
);
409 if (c
< 0 || load_each_byte
)
413 if (ASCII_BYTE_P (c
))
415 if (emacs_mule_encoding
)
416 return read_emacs_mule_char (c
, readbyte
, readcharfun
);
419 len
= BYTES_BY_CHAR_HEAD (c
);
422 c
= (*readbyte
) (-1, readcharfun
);
423 if (c
< 0 || ! TRAILING_CODE_P (c
))
426 (*readbyte
) (buf
[i
], readcharfun
);
427 return BYTE8_TO_CHAR (buf
[0]);
431 return STRING_CHAR (buf
);
434 /* Unread the character C in the way appropriate for the stream READCHARFUN.
435 If the stream is a user function, call it with the char as argument. */
438 unreadchar (readcharfun
, c
)
439 Lisp_Object readcharfun
;
444 /* Don't back up the pointer if we're unreading the end-of-input mark,
445 since readchar didn't advance it when we read it. */
447 else if (BUFFERP (readcharfun
))
449 struct buffer
*b
= XBUFFER (readcharfun
);
450 int bytepos
= BUF_PT_BYTE (b
);
453 if (! NILP (b
->enable_multibyte_characters
))
454 BUF_DEC_POS (b
, bytepos
);
458 BUF_PT_BYTE (b
) = bytepos
;
460 else if (MARKERP (readcharfun
))
462 struct buffer
*b
= XMARKER (readcharfun
)->buffer
;
463 int bytepos
= XMARKER (readcharfun
)->bytepos
;
465 XMARKER (readcharfun
)->charpos
--;
466 if (! NILP (b
->enable_multibyte_characters
))
467 BUF_DEC_POS (b
, bytepos
);
471 XMARKER (readcharfun
)->bytepos
= bytepos
;
473 else if (STRINGP (readcharfun
))
475 read_from_string_index
--;
476 read_from_string_index_byte
477 = string_char_to_byte (readcharfun
, read_from_string_index
);
479 else if (CONSP (readcharfun
))
483 else if (EQ (readcharfun
, Qlambda
))
487 else if (EQ (readcharfun
, Qget_file_char
)
488 || EQ (readcharfun
, Qget_emacs_mule_file_char
))
493 ungetc (c
, instream
);
500 call1 (readcharfun
, make_number (c
));
504 readbyte_for_lambda (c
, readcharfun
)
506 Lisp_Object readcharfun
;
508 return read_bytecode_char (c
>= 0);
513 readbyte_from_file (c
, readcharfun
)
515 Lisp_Object readcharfun
;
520 ungetc (c
, instream
);
529 /* Interrupted reads have been observed while reading over the network */
530 while (c
== EOF
&& ferror (instream
) && errno
== EINTR
)
542 return (c
== EOF
? -1 : c
);
546 readbyte_from_string (c
, readcharfun
)
548 Lisp_Object readcharfun
;
550 Lisp_Object string
= XCAR (readcharfun
);
554 read_from_string_index
--;
555 read_from_string_index_byte
556 = string_char_to_byte (string
, read_from_string_index
);
559 if (read_from_string_index
>= read_from_string_limit
)
562 FETCH_STRING_CHAR_ADVANCE (c
, string
,
563 read_from_string_index
,
564 read_from_string_index_byte
);
569 /* Read one non-ASCII character from INSTREAM. The character is
570 encoded in `emacs-mule' and the first byte is already read in
573 extern char emacs_mule_bytes
[256];
576 read_emacs_mule_char (c
, readbyte
, readcharfun
)
578 int (*readbyte
) P_ ((int, Lisp_Object
));
579 Lisp_Object readcharfun
;
581 /* Emacs-mule coding uses at most 4-byte for one character. */
582 unsigned char buf
[4];
583 int len
= emacs_mule_bytes
[c
];
584 struct charset
*charset
;
589 /* C is not a valid leading-code of `emacs-mule'. */
590 return BYTE8_TO_CHAR (c
);
596 c
= (*readbyte
) (-1, readcharfun
);
600 (*readbyte
) (buf
[i
], readcharfun
);
601 return BYTE8_TO_CHAR (buf
[0]);
608 charset
= emacs_mule_charset
[buf
[0]];
609 code
= buf
[1] & 0x7F;
613 if (buf
[0] == EMACS_MULE_LEADING_CODE_PRIVATE_11
614 || buf
[0] == EMACS_MULE_LEADING_CODE_PRIVATE_12
)
616 charset
= emacs_mule_charset
[buf
[1]];
617 code
= buf
[2] & 0x7F;
621 charset
= emacs_mule_charset
[buf
[0]];
622 code
= ((buf
[1] << 8) | buf
[2]) & 0x7F7F;
627 charset
= emacs_mule_charset
[buf
[1]];
628 code
= ((buf
[2] << 8) | buf
[3]) & 0x7F7F;
630 c
= DECODE_CHAR (charset
, code
);
632 Fsignal (Qinvalid_read_syntax
,
633 Fcons (build_string ("invalid multibyte form"), Qnil
));
638 static Lisp_Object read_internal_start
P_ ((Lisp_Object
, Lisp_Object
,
640 static Lisp_Object read0
P_ ((Lisp_Object
));
641 static Lisp_Object read1
P_ ((Lisp_Object
, int *, int));
643 static Lisp_Object read_list
P_ ((int, Lisp_Object
));
644 static Lisp_Object read_vector
P_ ((Lisp_Object
, int));
646 static Lisp_Object substitute_object_recurse
P_ ((Lisp_Object
, Lisp_Object
,
648 static void substitute_object_in_subtree
P_ ((Lisp_Object
,
650 static void substitute_in_interval
P_ ((INTERVAL
, Lisp_Object
));
653 /* Get a character from the tty. */
655 /* Read input events until we get one that's acceptable for our purposes.
657 If NO_SWITCH_FRAME is non-zero, switch-frame events are stashed
658 until we get a character we like, and then stuffed into
661 If ASCII_REQUIRED is non-zero, we check function key events to see
662 if the unmodified version of the symbol has a Qascii_character
663 property, and use that character, if present.
665 If ERROR_NONASCII is non-zero, we signal an error if the input we
666 get isn't an ASCII character with modifiers. If it's zero but
667 ASCII_REQUIRED is non-zero, we just re-read until we get an ASCII
670 If INPUT_METHOD is nonzero, we invoke the current input method
671 if the character warrants that.
673 If SECONDS is a number, we wait that many seconds for input, and
674 return Qnil if no input arrives within that time. */
677 read_filtered_event (no_switch_frame
, ascii_required
, error_nonascii
,
678 input_method
, seconds
)
679 int no_switch_frame
, ascii_required
, error_nonascii
, input_method
;
682 Lisp_Object val
, delayed_switch_frame
;
685 #ifdef HAVE_WINDOW_SYSTEM
686 if (display_hourglass_p
)
690 delayed_switch_frame
= Qnil
;
692 /* Compute timeout. */
693 if (NUMBERP (seconds
))
695 EMACS_TIME wait_time
;
697 double duration
= extract_float (seconds
);
699 sec
= (int) duration
;
700 usec
= (duration
- sec
) * 1000000;
701 EMACS_GET_TIME (end_time
);
702 EMACS_SET_SECS_USECS (wait_time
, sec
, usec
);
703 EMACS_ADD_TIME (end_time
, end_time
, wait_time
);
706 /* Read until we get an acceptable event. */
709 val
= read_char (0, 0, 0, (input_method
? Qnil
: Qt
), 0,
710 NUMBERP (seconds
) ? &end_time
: NULL
);
711 while (INTEGERP (val
) && XINT (val
) == -2); /* wrong_kboard_jmpbuf */
716 /* switch-frame events are put off until after the next ASCII
717 character. This is better than signaling an error just because
718 the last characters were typed to a separate minibuffer frame,
719 for example. Eventually, some code which can deal with
720 switch-frame events will read it and process it. */
722 && EVENT_HAS_PARAMETERS (val
)
723 && EQ (EVENT_HEAD_KIND (EVENT_HEAD (val
)), Qswitch_frame
))
725 delayed_switch_frame
= val
;
729 if (ascii_required
&& !(NUMBERP (seconds
) && NILP (val
)))
731 /* Convert certain symbols to their ASCII equivalents. */
734 Lisp_Object tem
, tem1
;
735 tem
= Fget (val
, Qevent_symbol_element_mask
);
738 tem1
= Fget (Fcar (tem
), Qascii_character
);
739 /* Merge this symbol's modifier bits
740 with the ASCII equivalent of its basic code. */
742 XSETFASTINT (val
, XINT (tem1
) | XINT (Fcar (Fcdr (tem
))));
746 /* If we don't have a character now, deal with it appropriately. */
751 Vunread_command_events
= Fcons (val
, Qnil
);
752 error ("Non-character input-event");
759 if (! NILP (delayed_switch_frame
))
760 unread_switch_frame
= delayed_switch_frame
;
764 #ifdef HAVE_WINDOW_SYSTEM
765 if (display_hourglass_p
)
774 DEFUN ("read-char", Fread_char
, Sread_char
, 0, 3, 0,
775 doc
: /* Read a character from the command input (keyboard or macro).
776 It is returned as a number.
777 If the character has modifiers, they are resolved and reflected to the
778 character code if possible (e.g. C-SPC -> 0).
780 If the user generates an event which is not a character (i.e. a mouse
781 click or function key event), `read-char' signals an error. As an
782 exception, switch-frame events are put off until non-character events
784 If you want to read non-character events, or ignore them, call
785 `read-event' or `read-char-exclusive' instead.
787 If the optional argument PROMPT is non-nil, display that as a prompt.
788 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
789 input method is turned on in the current buffer, that input method
790 is used for reading a character.
791 If the optional argument SECONDS is non-nil, it should be a number
792 specifying the maximum number of seconds to wait for input. If no
793 input arrives in that time, return nil. SECONDS may be a
794 floating-point value. */)
795 (prompt
, inherit_input_method
, seconds
)
796 Lisp_Object prompt
, inherit_input_method
, seconds
;
801 message_with_string ("%s", prompt
, 0);
802 val
= read_filtered_event (1, 1, 1, ! NILP (inherit_input_method
), seconds
);
804 return (NILP (val
) ? Qnil
805 : make_number (char_resolve_modifier_mask (XINT (val
))));
808 DEFUN ("read-event", Fread_event
, Sread_event
, 0, 3, 0,
809 doc
: /* Read an event object from the input stream.
810 If the optional argument PROMPT is non-nil, display that as a prompt.
811 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
812 input method is turned on in the current buffer, that input method
813 is used for reading a character.
814 If the optional argument SECONDS is non-nil, it should be a number
815 specifying the maximum number of seconds to wait for input. If no
816 input arrives in that time, return nil. SECONDS may be a
817 floating-point value. */)
818 (prompt
, inherit_input_method
, seconds
)
819 Lisp_Object prompt
, inherit_input_method
, seconds
;
822 message_with_string ("%s", prompt
, 0);
823 return read_filtered_event (0, 0, 0, ! NILP (inherit_input_method
), seconds
);
826 DEFUN ("read-char-exclusive", Fread_char_exclusive
, Sread_char_exclusive
, 0, 3, 0,
827 doc
: /* Read a character from the command input (keyboard or macro).
828 It is returned as a number. Non-character events are ignored.
829 If the character has modifiers, they are resolved and reflected to the
830 character code if possible (e.g. C-SPC -> 0).
832 If the optional argument PROMPT is non-nil, display that as a prompt.
833 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
834 input method is turned on in the current buffer, that input method
835 is used for reading a character.
836 If the optional argument SECONDS is non-nil, it should be a number
837 specifying the maximum number of seconds to wait for input. If no
838 input arrives in that time, return nil. SECONDS may be a
839 floating-point value. */)
840 (prompt
, inherit_input_method
, seconds
)
841 Lisp_Object prompt
, inherit_input_method
, seconds
;
846 message_with_string ("%s", prompt
, 0);
848 val
= read_filtered_event (1, 1, 0, ! NILP (inherit_input_method
), seconds
);
850 return (NILP (val
) ? Qnil
851 : make_number (char_resolve_modifier_mask (XINT (val
))));
854 DEFUN ("get-file-char", Fget_file_char
, Sget_file_char
, 0, 0, 0,
855 doc
: /* Don't use this yourself. */)
858 register Lisp_Object val
;
860 XSETINT (val
, getc (instream
));
867 /* Value is a version number of byte compiled code if the file
868 associated with file descriptor FD is a compiled Lisp file that's
869 safe to load. Only files compiled with Emacs are safe to load.
870 Files compiled with XEmacs can lead to a crash in Fbyte_code
871 because of an incompatible change in the byte compiler. */
882 /* Read the first few bytes from the file, and look for a line
883 specifying the byte compiler version used. */
884 nbytes
= emacs_read (fd
, buf
, sizeof buf
- 1);
889 /* Skip to the next newline, skipping over the initial `ELC'
890 with NUL bytes following it, but note the version. */
891 for (i
= 0; i
< nbytes
&& buf
[i
] != '\n'; ++i
)
896 || fast_c_string_match_ignore_case (Vbytecomp_version_regexp
,
903 lseek (fd
, 0, SEEK_SET
);
908 /* Callback for record_unwind_protect. Restore the old load list OLD,
909 after loading a file successfully. */
912 record_load_unwind (old
)
915 return Vloads_in_progress
= old
;
918 /* This handler function is used via internal_condition_case_1. */
921 load_error_handler (data
)
928 load_warn_old_style_backquotes (file
)
931 if (!NILP (Vold_style_backquotes
))
934 args
[0] = build_string ("Loading `%s': old-style backquotes detected!");
941 DEFUN ("get-load-suffixes", Fget_load_suffixes
, Sget_load_suffixes
, 0, 0, 0,
942 doc
: /* Return the suffixes that `load' should try if a suffix is \
944 This uses the variables `load-suffixes' and `load-file-rep-suffixes'. */)
947 Lisp_Object lst
= Qnil
, suffixes
= Vload_suffixes
, suffix
, ext
;
948 while (CONSP (suffixes
))
950 Lisp_Object exts
= Vload_file_rep_suffixes
;
951 suffix
= XCAR (suffixes
);
952 suffixes
= XCDR (suffixes
);
957 lst
= Fcons (concat2 (suffix
, ext
), lst
);
960 return Fnreverse (lst
);
963 DEFUN ("load", Fload
, Sload
, 1, 5, 0,
964 doc
: /* Execute a file of Lisp code named FILE.
965 First try FILE with `.elc' appended, then try with `.el',
966 then try FILE unmodified (the exact suffixes in the exact order are
967 determined by `load-suffixes'). Environment variable references in
968 FILE are replaced with their values by calling `substitute-in-file-name'.
969 This function searches the directories in `load-path'.
971 If optional second arg NOERROR is non-nil,
972 report no error if FILE doesn't exist.
973 Print messages at start and end of loading unless
974 optional third arg NOMESSAGE is non-nil (but `force-load-messages'
976 If optional fourth arg NOSUFFIX is non-nil, don't try adding
977 suffixes `.elc' or `.el' to the specified name FILE.
978 If optional fifth arg MUST-SUFFIX is non-nil, insist on
979 the suffix `.elc' or `.el'; don't accept just FILE unless
980 it ends in one of those suffixes or includes a directory name.
982 If this function fails to find a file, it may look for different
983 representations of that file before trying another file.
984 It does so by adding the non-empty suffixes in `load-file-rep-suffixes'
985 to the file name. Emacs uses this feature mainly to find compressed
986 versions of files when Auto Compression mode is enabled.
988 The exact suffixes that this function tries out, in the exact order,
989 are given by the value of the variable `load-file-rep-suffixes' if
990 NOSUFFIX is non-nil and by the return value of the function
991 `get-load-suffixes' if MUST-SUFFIX is non-nil. If both NOSUFFIX and
992 MUST-SUFFIX are nil, this function first tries out the latter suffixes
995 Loading a file records its definitions, and its `provide' and
996 `require' calls, in an element of `load-history' whose
997 car is the file name loaded. See `load-history'.
999 Return t if the file exists and loads successfully. */)
1000 (file
, noerror
, nomessage
, nosuffix
, must_suffix
)
1001 Lisp_Object file
, noerror
, nomessage
, nosuffix
, must_suffix
;
1003 register FILE *stream
;
1004 register int fd
= -1;
1005 int count
= SPECPDL_INDEX ();
1006 struct gcpro gcpro1
, gcpro2
, gcpro3
;
1007 Lisp_Object found
, efound
, hist_file_name
;
1008 /* 1 means we printed the ".el is newer" message. */
1010 /* 1 means we are loading a compiled file. */
1012 Lisp_Object handler
;
1022 CHECK_STRING (file
);
1024 /* If file name is magic, call the handler. */
1025 /* This shouldn't be necessary any more now that `openp' handles it right.
1026 handler = Ffind_file_name_handler (file, Qload);
1027 if (!NILP (handler))
1028 return call5 (handler, Qload, file, noerror, nomessage, nosuffix); */
1030 /* Do this after the handler to avoid
1031 the need to gcpro noerror, nomessage and nosuffix.
1032 (Below here, we care only whether they are nil or not.)
1033 The presence of this call is the result of a historical accident:
1034 it used to be in every file-operation and when it got removed
1035 everywhere, it accidentally stayed here. Since then, enough people
1036 supposedly have things like (load "$PROJECT/foo.el") in their .emacs
1037 that it seemed risky to remove. */
1038 if (! NILP (noerror
))
1040 file
= internal_condition_case_1 (Fsubstitute_in_file_name
, file
,
1041 Qt
, load_error_handler
);
1046 file
= Fsubstitute_in_file_name (file
);
1049 /* Avoid weird lossage with null string as arg,
1050 since it would try to load a directory as a Lisp file */
1051 if (SCHARS (file
) > 0)
1053 int size
= SBYTES (file
);
1056 GCPRO2 (file
, found
);
1058 if (! NILP (must_suffix
))
1060 /* Don't insist on adding a suffix if FILE already ends with one. */
1062 && !strcmp (SDATA (file
) + size
- 3, ".el"))
1065 && !strcmp (SDATA (file
) + size
- 4, ".elc"))
1067 /* Don't insist on adding a suffix
1068 if the argument includes a directory name. */
1069 else if (! NILP (Ffile_name_directory (file
)))
1073 fd
= openp (Vload_path
, file
,
1074 (!NILP (nosuffix
) ? Qnil
1075 : !NILP (must_suffix
) ? Fget_load_suffixes ()
1076 : Fappend (2, (tmp
[0] = Fget_load_suffixes (),
1077 tmp
[1] = Vload_file_rep_suffixes
,
1086 xsignal2 (Qfile_error
, build_string ("Cannot open load file"), file
);
1090 /* Tell startup.el whether or not we found the user's init file. */
1091 if (EQ (Qt
, Vuser_init_file
))
1092 Vuser_init_file
= found
;
1094 /* If FD is -2, that means openp found a magic file. */
1097 if (NILP (Fequal (found
, file
)))
1098 /* If FOUND is a different file name from FILE,
1099 find its handler even if we have already inhibited
1100 the `load' operation on FILE. */
1101 handler
= Ffind_file_name_handler (found
, Qt
);
1103 handler
= Ffind_file_name_handler (found
, Qload
);
1104 if (! NILP (handler
))
1105 return call5 (handler
, Qload
, found
, noerror
, nomessage
, Qt
);
1108 /* Check if we're stuck in a recursive load cycle.
1110 2000-09-21: It's not possible to just check for the file loaded
1111 being a member of Vloads_in_progress. This fails because of the
1112 way the byte compiler currently works; `provide's are not
1113 evaluated, see font-lock.el/jit-lock.el as an example. This
1114 leads to a certain amount of ``normal'' recursion.
1116 Also, just loading a file recursively is not always an error in
1117 the general case; the second load may do something different. */
1121 for (tem
= Vloads_in_progress
; CONSP (tem
); tem
= XCDR (tem
))
1122 if (!NILP (Fequal (found
, XCAR (tem
))) && (++count
> 3))
1126 signal_error ("Recursive load", Fcons (found
, Vloads_in_progress
));
1128 record_unwind_protect (record_load_unwind
, Vloads_in_progress
);
1129 Vloads_in_progress
= Fcons (found
, Vloads_in_progress
);
1132 /* Get the name for load-history. */
1133 hist_file_name
= (! NILP (Vpurify_flag
)
1134 ? Fconcat (2, (tmp
[0] = Ffile_name_directory (file
),
1135 tmp
[1] = Ffile_name_nondirectory (found
),
1141 /* Check for the presence of old-style quotes and warn about them. */
1142 specbind (Qold_style_backquotes
, Qnil
);
1143 record_unwind_protect (load_warn_old_style_backquotes
, file
);
1145 if (!bcmp (SDATA (found
) + SBYTES (found
) - 4,
1147 || (fd
>= 0 && (version
= safe_to_load_p (fd
)) > 0))
1148 /* Load .elc files directly, but not when they are
1149 remote and have no handler! */
1156 GCPRO3 (file
, found
, hist_file_name
);
1159 && ! (version
= safe_to_load_p (fd
)))
1162 if (!load_dangerous_libraries
)
1166 error ("File `%s' was not compiled in Emacs",
1169 else if (!NILP (nomessage
) && !force_load_messages
)
1170 message_with_string ("File `%s' not compiled in Emacs", found
, 1);
1175 efound
= ENCODE_FILE (found
);
1180 stat ((char *)SDATA (efound
), &s1
);
1181 SSET (efound
, SBYTES (efound
) - 1, 0);
1182 result
= stat ((char *)SDATA (efound
), &s2
);
1183 SSET (efound
, SBYTES (efound
) - 1, 'c');
1185 if (result
>= 0 && (unsigned) s1
.st_mtime
< (unsigned) s2
.st_mtime
)
1187 /* Make the progress messages mention that source is newer. */
1190 /* If we won't print another message, mention this anyway. */
1191 if (!NILP (nomessage
) && !force_load_messages
)
1193 Lisp_Object msg_file
;
1194 msg_file
= Fsubstring (found
, make_number (0), make_number (-1));
1195 message_with_string ("Source file `%s' newer than byte-compiled file",
1204 /* We are loading a source file (*.el). */
1205 if (!NILP (Vload_source_file_function
))
1211 val
= call4 (Vload_source_file_function
, found
, hist_file_name
,
1212 NILP (noerror
) ? Qnil
: Qt
,
1213 (NILP (nomessage
) || force_load_messages
) ? Qnil
: Qt
);
1214 return unbind_to (count
, val
);
1218 GCPRO3 (file
, found
, hist_file_name
);
1222 efound
= ENCODE_FILE (found
);
1223 stream
= fopen ((char *) SDATA (efound
), fmode
);
1224 #else /* not WINDOWSNT */
1225 stream
= fdopen (fd
, fmode
);
1226 #endif /* not WINDOWSNT */
1230 error ("Failure to create stdio stream for %s", SDATA (file
));
1233 if (! NILP (Vpurify_flag
))
1234 Vpreloaded_file_list
= Fcons (Fpurecopy(file
), Vpreloaded_file_list
);
1236 if (NILP (nomessage
) || force_load_messages
)
1239 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...",
1242 message_with_string ("Loading %s (source)...", file
, 1);
1244 message_with_string ("Loading %s (compiled; note, source file is newer)...",
1246 else /* The typical case; compiled file newer than source file. */
1247 message_with_string ("Loading %s...", file
, 1);
1250 record_unwind_protect (load_unwind
, make_save_value (stream
, 0));
1251 record_unwind_protect (load_descriptor_unwind
, load_descriptor_list
);
1252 specbind (Qload_file_name
, found
);
1253 specbind (Qinhibit_file_name_operation
, Qnil
);
1254 load_descriptor_list
1255 = Fcons (make_number (fileno (stream
)), load_descriptor_list
);
1256 specbind (Qload_in_progress
, Qt
);
1257 if (! version
|| version
>= 22)
1258 readevalloop (Qget_file_char
, stream
, hist_file_name
,
1259 Feval
, 0, Qnil
, Qnil
, Qnil
, Qnil
);
1262 /* We can't handle a file which was compiled with
1263 byte-compile-dynamic by older version of Emacs. */
1264 specbind (Qload_force_doc_strings
, Qt
);
1265 readevalloop (Qget_emacs_mule_file_char
, stream
, hist_file_name
, Feval
,
1266 0, Qnil
, Qnil
, Qnil
, Qnil
);
1268 unbind_to (count
, Qnil
);
1270 /* Run any eval-after-load forms for this file */
1271 if (!NILP (Ffboundp (Qdo_after_load_evaluation
)))
1272 call1 (Qdo_after_load_evaluation
, hist_file_name
) ;
1276 xfree (saved_doc_string
);
1277 saved_doc_string
= 0;
1278 saved_doc_string_size
= 0;
1280 xfree (prev_saved_doc_string
);
1281 prev_saved_doc_string
= 0;
1282 prev_saved_doc_string_size
= 0;
1284 if (!noninteractive
&& (NILP (nomessage
) || force_load_messages
))
1287 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...done",
1290 message_with_string ("Loading %s (source)...done", file
, 1);
1292 message_with_string ("Loading %s (compiled; note, source file is newer)...done",
1294 else /* The typical case; compiled file newer than source file. */
1295 message_with_string ("Loading %s...done", file
, 1);
1302 load_unwind (arg
) /* used as unwind-protect function in load */
1305 FILE *stream
= (FILE *) XSAVE_VALUE (arg
)->pointer
;
1316 load_descriptor_unwind (oldlist
)
1317 Lisp_Object oldlist
;
1319 load_descriptor_list
= oldlist
;
1323 /* Close all descriptors in use for Floads.
1324 This is used when starting a subprocess. */
1331 for (tail
= load_descriptor_list
; CONSP (tail
); tail
= XCDR (tail
))
1332 emacs_close (XFASTINT (XCAR (tail
)));
1337 complete_filename_p (pathname
)
1338 Lisp_Object pathname
;
1340 register const unsigned char *s
= SDATA (pathname
);
1341 return (IS_DIRECTORY_SEP (s
[0])
1342 || (SCHARS (pathname
) > 2
1343 && IS_DEVICE_SEP (s
[1]) && IS_DIRECTORY_SEP (s
[2])));
1346 DEFUN ("locate-file-internal", Flocate_file_internal
, Slocate_file_internal
, 2, 4, 0,
1347 doc
: /* Search for FILENAME through PATH.
1348 Returns the file's name in absolute form, or nil if not found.
1349 If SUFFIXES is non-nil, it should be a list of suffixes to append to
1350 file name when searching.
1351 If non-nil, PREDICATE is used instead of `file-readable-p'.
1352 PREDICATE can also be an integer to pass to the access(2) function,
1353 in which case file-name-handlers are ignored. */)
1354 (filename
, path
, suffixes
, predicate
)
1355 Lisp_Object filename
, path
, suffixes
, predicate
;
1358 int fd
= openp (path
, filename
, suffixes
, &file
, predicate
);
1359 if (NILP (predicate
) && fd
> 0)
1365 /* Search for a file whose name is STR, looking in directories
1366 in the Lisp list PATH, and trying suffixes from SUFFIX.
1367 On success, returns a file descriptor. On failure, returns -1.
1369 SUFFIXES is a list of strings containing possible suffixes.
1370 The empty suffix is automatically added if the list is empty.
1372 PREDICATE non-nil means don't open the files,
1373 just look for one that satisfies the predicate. In this case,
1374 returns 1 on success. The predicate can be a lisp function or
1375 an integer to pass to `access' (in which case file-name-handlers
1378 If STOREPTR is nonzero, it points to a slot where the name of
1379 the file actually found should be stored as a Lisp string.
1380 nil is stored there on failure.
1382 If the file we find is remote, return -2
1383 but store the found remote file name in *STOREPTR. */
1386 openp (path
, str
, suffixes
, storeptr
, predicate
)
1387 Lisp_Object path
, str
;
1388 Lisp_Object suffixes
;
1389 Lisp_Object
*storeptr
;
1390 Lisp_Object predicate
;
1395 register char *fn
= buf
;
1398 Lisp_Object filename
;
1400 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
, gcpro6
;
1401 Lisp_Object string
, tail
, encoded_fn
;
1402 int max_suffix_len
= 0;
1406 for (tail
= suffixes
; CONSP (tail
); tail
= XCDR (tail
))
1408 CHECK_STRING_CAR (tail
);
1409 max_suffix_len
= max (max_suffix_len
,
1410 SBYTES (XCAR (tail
)));
1413 string
= filename
= encoded_fn
= Qnil
;
1414 GCPRO6 (str
, string
, filename
, path
, suffixes
, encoded_fn
);
1419 if (complete_filename_p (str
))
1422 for (; CONSP (path
); path
= XCDR (path
))
1424 filename
= Fexpand_file_name (str
, XCAR (path
));
1425 if (!complete_filename_p (filename
))
1426 /* If there are non-absolute elts in PATH (eg ".") */
1427 /* Of course, this could conceivably lose if luser sets
1428 default-directory to be something non-absolute... */
1430 filename
= Fexpand_file_name (filename
, current_buffer
->directory
);
1431 if (!complete_filename_p (filename
))
1432 /* Give up on this path element! */
1436 /* Calculate maximum size of any filename made from
1437 this path element/specified file name and any possible suffix. */
1438 want_size
= max_suffix_len
+ SBYTES (filename
) + 1;
1439 if (fn_size
< want_size
)
1440 fn
= (char *) alloca (fn_size
= 100 + want_size
);
1442 /* Loop over suffixes. */
1443 for (tail
= NILP (suffixes
) ? Fcons (empty_unibyte_string
, Qnil
) : suffixes
;
1444 CONSP (tail
); tail
= XCDR (tail
))
1446 int lsuffix
= SBYTES (XCAR (tail
));
1447 Lisp_Object handler
;
1450 /* Concatenate path element/specified name with the suffix.
1451 If the directory starts with /:, remove that. */
1452 if (SCHARS (filename
) > 2
1453 && SREF (filename
, 0) == '/'
1454 && SREF (filename
, 1) == ':')
1456 strncpy (fn
, SDATA (filename
) + 2,
1457 SBYTES (filename
) - 2);
1458 fn
[SBYTES (filename
) - 2] = 0;
1462 strncpy (fn
, SDATA (filename
),
1464 fn
[SBYTES (filename
)] = 0;
1467 if (lsuffix
!= 0) /* Bug happens on CCI if lsuffix is 0. */
1468 strncat (fn
, SDATA (XCAR (tail
)), lsuffix
);
1470 /* Check that the file exists and is not a directory. */
1471 /* We used to only check for handlers on non-absolute file names:
1475 handler = Ffind_file_name_handler (filename, Qfile_exists_p);
1476 It's not clear why that was the case and it breaks things like
1477 (load "/bar.el") where the file is actually "/bar.el.gz". */
1478 string
= build_string (fn
);
1479 handler
= Ffind_file_name_handler (string
, Qfile_exists_p
);
1480 if ((!NILP (handler
) || !NILP (predicate
)) && !NATNUMP (predicate
))
1482 if (NILP (predicate
))
1483 exists
= !NILP (Ffile_readable_p (string
));
1485 exists
= !NILP (call1 (predicate
, string
));
1486 if (exists
&& !NILP (Ffile_directory_p (string
)))
1491 /* We succeeded; return this descriptor and filename. */
1502 encoded_fn
= ENCODE_FILE (string
);
1503 pfn
= SDATA (encoded_fn
);
1504 exists
= (stat (pfn
, &st
) >= 0
1505 && (st
.st_mode
& S_IFMT
) != S_IFDIR
);
1508 /* Check that we can access or open it. */
1509 if (NATNUMP (predicate
))
1510 fd
= (access (pfn
, XFASTINT (predicate
)) == 0) ? 1 : -1;
1512 fd
= emacs_open (pfn
, O_RDONLY
, 0);
1516 /* We succeeded; return this descriptor and filename. */
1534 /* Merge the list we've accumulated of globals from the current input source
1535 into the load_history variable. The details depend on whether
1536 the source has an associated file name or not.
1538 FILENAME is the file name that we are loading from.
1539 ENTIRE is 1 if loading that entire file, 0 if evaluating part of it. */
1542 build_load_history (filename
, entire
)
1543 Lisp_Object filename
;
1546 register Lisp_Object tail
, prev
, newelt
;
1547 register Lisp_Object tem
, tem2
;
1548 register int foundit
= 0;
1550 tail
= Vload_history
;
1553 while (CONSP (tail
))
1557 /* Find the feature's previous assoc list... */
1558 if (!NILP (Fequal (filename
, Fcar (tem
))))
1562 /* If we're loading the entire file, remove old data. */
1566 Vload_history
= XCDR (tail
);
1568 Fsetcdr (prev
, XCDR (tail
));
1571 /* Otherwise, cons on new symbols that are not already members. */
1574 tem2
= Vcurrent_load_list
;
1576 while (CONSP (tem2
))
1578 newelt
= XCAR (tem2
);
1580 if (NILP (Fmember (newelt
, tem
)))
1581 Fsetcar (tail
, Fcons (XCAR (tem
),
1582 Fcons (newelt
, XCDR (tem
))));
1595 /* If we're loading an entire file, cons the new assoc onto the
1596 front of load-history, the most-recently-loaded position. Also
1597 do this if we didn't find an existing member for the file. */
1598 if (entire
|| !foundit
)
1599 Vload_history
= Fcons (Fnreverse (Vcurrent_load_list
),
1604 unreadpure (junk
) /* Used as unwind-protect function in readevalloop */
1612 readevalloop_1 (old
)
1615 load_convert_to_unibyte
= ! NILP (old
);
1619 /* Signal an `end-of-file' error, if possible with file name
1623 end_of_file_error ()
1625 if (STRINGP (Vload_file_name
))
1626 xsignal1 (Qend_of_file
, Vload_file_name
);
1628 xsignal0 (Qend_of_file
);
1631 /* UNIBYTE specifies how to set load_convert_to_unibyte
1632 for this invocation.
1633 READFUN, if non-nil, is used instead of `read'.
1635 START, END specify region to read in current buffer (from eval-region).
1636 If the input is not from a buffer, they must be nil. */
1639 readevalloop (readcharfun
, stream
, sourcename
, evalfun
,
1640 printflag
, unibyte
, readfun
, start
, end
)
1641 Lisp_Object readcharfun
;
1643 Lisp_Object sourcename
;
1644 Lisp_Object (*evalfun
) ();
1646 Lisp_Object unibyte
, readfun
;
1647 Lisp_Object start
, end
;
1650 register Lisp_Object val
;
1651 int count
= SPECPDL_INDEX ();
1652 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1653 struct buffer
*b
= 0;
1654 int continue_reading_p
;
1655 /* Nonzero if reading an entire buffer. */
1656 int whole_buffer
= 0;
1657 /* 1 on the first time around. */
1660 if (MARKERP (readcharfun
))
1663 start
= readcharfun
;
1666 if (BUFFERP (readcharfun
))
1667 b
= XBUFFER (readcharfun
);
1668 else if (MARKERP (readcharfun
))
1669 b
= XMARKER (readcharfun
)->buffer
;
1671 /* We assume START is nil when input is not from a buffer. */
1672 if (! NILP (start
) && !b
)
1675 specbind (Qstandard_input
, readcharfun
); /* GCPROs readcharfun. */
1676 specbind (Qcurrent_load_list
, Qnil
);
1677 record_unwind_protect (readevalloop_1
, load_convert_to_unibyte
? Qt
: Qnil
);
1678 load_convert_to_unibyte
= !NILP (unibyte
);
1680 GCPRO4 (sourcename
, readfun
, start
, end
);
1682 /* Try to ensure sourcename is a truename, except whilst preloading. */
1683 if (NILP (Vpurify_flag
)
1684 && !NILP (sourcename
) && !NILP (Ffile_name_absolute_p (sourcename
))
1685 && !NILP (Ffboundp (Qfile_truename
)))
1686 sourcename
= call1 (Qfile_truename
, sourcename
) ;
1688 LOADHIST_ATTACH (sourcename
);
1690 continue_reading_p
= 1;
1691 while (continue_reading_p
)
1693 int count1
= SPECPDL_INDEX ();
1695 if (b
!= 0 && NILP (b
->name
))
1696 error ("Reading from killed buffer");
1700 /* Switch to the buffer we are reading from. */
1701 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1702 set_buffer_internal (b
);
1704 /* Save point in it. */
1705 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1706 /* Save ZV in it. */
1707 record_unwind_protect (save_restriction_restore
, save_restriction_save ());
1708 /* Those get unbound after we read one expression. */
1710 /* Set point and ZV around stuff to be read. */
1713 Fnarrow_to_region (make_number (BEGV
), end
);
1715 /* Just for cleanliness, convert END to a marker
1716 if it is an integer. */
1718 end
= Fpoint_max_marker ();
1721 /* On the first cycle, we can easily test here
1722 whether we are reading the whole buffer. */
1723 if (b
&& first_sexp
)
1724 whole_buffer
= (PT
== BEG
&& ZV
== Z
);
1731 while ((c
= READCHAR
) != '\n' && c
!= -1);
1736 unbind_to (count1
, Qnil
);
1740 /* Ignore whitespace here, so we can detect eof. */
1741 if (c
== ' ' || c
== '\t' || c
== '\n' || c
== '\f' || c
== '\r'
1742 || c
== 0x8a0) /* NBSP */
1745 if (!NILP (Vpurify_flag
) && c
== '(')
1747 record_unwind_protect (unreadpure
, Qnil
);
1748 val
= read_list (-1, readcharfun
);
1753 read_objects
= Qnil
;
1754 if (!NILP (readfun
))
1756 val
= call1 (readfun
, readcharfun
);
1758 /* If READCHARFUN has set point to ZV, we should
1759 stop reading, even if the form read sets point
1760 to a different value when evaluated. */
1761 if (BUFFERP (readcharfun
))
1763 struct buffer
*b
= XBUFFER (readcharfun
);
1764 if (BUF_PT (b
) == BUF_ZV (b
))
1765 continue_reading_p
= 0;
1768 else if (! NILP (Vload_read_function
))
1769 val
= call1 (Vload_read_function
, readcharfun
);
1771 val
= read_internal_start (readcharfun
, Qnil
, Qnil
);
1774 if (!NILP (start
) && continue_reading_p
)
1775 start
= Fpoint_marker ();
1777 /* Restore saved point and BEGV. */
1778 unbind_to (count1
, Qnil
);
1780 /* Now eval what we just read. */
1781 val
= (*evalfun
) (val
);
1785 Vvalues
= Fcons (val
, Vvalues
);
1786 if (EQ (Vstandard_output
, Qt
))
1795 build_load_history (sourcename
,
1796 stream
|| whole_buffer
);
1800 unbind_to (count
, Qnil
);
1803 DEFUN ("eval-buffer", Feval_buffer
, Seval_buffer
, 0, 5, "",
1804 doc
: /* Execute the current buffer as Lisp code.
1805 When called from a Lisp program (i.e., not interactively), this
1806 function accepts up to five optional arguments:
1807 BUFFER is the buffer to evaluate (nil means use current buffer).
1808 PRINTFLAG controls printing of output:
1809 A value of nil means discard it; anything else is stream for print.
1810 FILENAME specifies the file name to use for `load-history'.
1811 UNIBYTE, if non-nil, specifies `load-convert-to-unibyte' for this
1813 DO-ALLOW-PRINT, if non-nil, specifies that `print' and related
1814 functions should work normally even if PRINTFLAG is nil.
1816 This function preserves the position of point. */)
1817 (buffer
, printflag
, filename
, unibyte
, do_allow_print
)
1818 Lisp_Object buffer
, printflag
, filename
, unibyte
, do_allow_print
;
1820 int count
= SPECPDL_INDEX ();
1821 Lisp_Object tem
, buf
;
1824 buf
= Fcurrent_buffer ();
1826 buf
= Fget_buffer (buffer
);
1828 error ("No such buffer");
1830 if (NILP (printflag
) && NILP (do_allow_print
))
1835 if (NILP (filename
))
1836 filename
= XBUFFER (buf
)->filename
;
1838 specbind (Qeval_buffer_list
, Fcons (buf
, Veval_buffer_list
));
1839 specbind (Qstandard_output
, tem
);
1840 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
1841 BUF_TEMP_SET_PT (XBUFFER (buf
), BUF_BEGV (XBUFFER (buf
)));
1842 readevalloop (buf
, 0, filename
, Feval
,
1843 !NILP (printflag
), unibyte
, Qnil
, Qnil
, Qnil
);
1844 unbind_to (count
, Qnil
);
1849 DEFUN ("eval-region", Feval_region
, Seval_region
, 2, 4, "r",
1850 doc
: /* Execute the region as Lisp code.
1851 When called from programs, expects two arguments,
1852 giving starting and ending indices in the current buffer
1853 of the text to be executed.
1854 Programs can pass third argument PRINTFLAG which controls output:
1855 A value of nil means discard it; anything else is stream for printing it.
1856 Also the fourth argument READ-FUNCTION, if non-nil, is used
1857 instead of `read' to read each expression. It gets one argument
1858 which is the input stream for reading characters.
1860 This function does not move point. */)
1861 (start
, end
, printflag
, read_function
)
1862 Lisp_Object start
, end
, printflag
, read_function
;
1864 int count
= SPECPDL_INDEX ();
1865 Lisp_Object tem
, cbuf
;
1867 cbuf
= Fcurrent_buffer ();
1869 if (NILP (printflag
))
1873 specbind (Qstandard_output
, tem
);
1874 specbind (Qeval_buffer_list
, Fcons (cbuf
, Veval_buffer_list
));
1876 /* readevalloop calls functions which check the type of start and end. */
1877 readevalloop (cbuf
, 0, XBUFFER (cbuf
)->filename
, Feval
,
1878 !NILP (printflag
), Qnil
, read_function
,
1881 return unbind_to (count
, Qnil
);
1885 DEFUN ("read", Fread
, Sread
, 0, 1, 0,
1886 doc
: /* Read one Lisp expression as text from STREAM, return as Lisp object.
1887 If STREAM is nil, use the value of `standard-input' (which see).
1888 STREAM or the value of `standard-input' may be:
1889 a buffer (read from point and advance it)
1890 a marker (read from where it points and advance it)
1891 a function (call it with no arguments for each character,
1892 call it with a char as argument to push a char back)
1893 a string (takes text from string, starting at the beginning)
1894 t (read text line using minibuffer and use it, or read from
1895 standard input in batch mode). */)
1900 stream
= Vstandard_input
;
1901 if (EQ (stream
, Qt
))
1902 stream
= Qread_char
;
1903 if (EQ (stream
, Qread_char
))
1904 return Fread_minibuffer (build_string ("Lisp expression: "), Qnil
);
1906 return read_internal_start (stream
, Qnil
, Qnil
);
1909 DEFUN ("read-from-string", Fread_from_string
, Sread_from_string
, 1, 3, 0,
1910 doc
: /* Read one Lisp expression which is represented as text by STRING.
1911 Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
1912 START and END optionally delimit a substring of STRING from which to read;
1913 they default to 0 and (length STRING) respectively. */)
1914 (string
, start
, end
)
1915 Lisp_Object string
, start
, end
;
1918 CHECK_STRING (string
);
1919 /* read_internal_start sets read_from_string_index. */
1920 ret
= read_internal_start (string
, start
, end
);
1921 return Fcons (ret
, make_number (read_from_string_index
));
1924 /* Function to set up the global context we need in toplevel read
1927 read_internal_start (stream
, start
, end
)
1929 Lisp_Object start
; /* Only used when stream is a string. */
1930 Lisp_Object end
; /* Only used when stream is a string. */
1935 new_backquote_flag
= 0;
1936 read_objects
= Qnil
;
1937 if (EQ (Vread_with_symbol_positions
, Qt
)
1938 || EQ (Vread_with_symbol_positions
, stream
))
1939 Vread_symbol_positions_list
= Qnil
;
1941 if (STRINGP (stream
)
1942 || ((CONSP (stream
) && STRINGP (XCAR (stream
)))))
1944 int startval
, endval
;
1947 if (STRINGP (stream
))
1950 string
= XCAR (stream
);
1953 endval
= SCHARS (string
);
1957 endval
= XINT (end
);
1958 if (endval
< 0 || endval
> SCHARS (string
))
1959 args_out_of_range (string
, end
);
1966 CHECK_NUMBER (start
);
1967 startval
= XINT (start
);
1968 if (startval
< 0 || startval
> endval
)
1969 args_out_of_range (string
, start
);
1971 read_from_string_index
= startval
;
1972 read_from_string_index_byte
= string_char_to_byte (string
, startval
);
1973 read_from_string_limit
= endval
;
1976 retval
= read0 (stream
);
1977 if (EQ (Vread_with_symbol_positions
, Qt
)
1978 || EQ (Vread_with_symbol_positions
, stream
))
1979 Vread_symbol_positions_list
= Fnreverse (Vread_symbol_positions_list
);
1984 /* Signal Qinvalid_read_syntax error.
1985 S is error string of length N (if > 0) */
1988 invalid_syntax (s
, n
)
1994 xsignal1 (Qinvalid_read_syntax
, make_string (s
, n
));
1998 /* Use this for recursive reads, in contexts where internal tokens
2003 Lisp_Object readcharfun
;
2005 register Lisp_Object val
;
2008 val
= read1 (readcharfun
, &c
, 0);
2012 xsignal1 (Qinvalid_read_syntax
,
2013 Fmake_string (make_number (1), make_number (c
)));
2016 static int read_buffer_size
;
2017 static char *read_buffer
;
2019 /* Read a \-escape sequence, assuming we already read the `\'.
2020 If the escape sequence forces unibyte, return eight-bit char. */
2023 read_escape (readcharfun
, stringp
)
2024 Lisp_Object readcharfun
;
2027 register int c
= READCHAR
;
2028 /* \u allows up to four hex digits, \U up to eight. Default to the
2029 behavior for \u, and change this value in the case that \U is seen. */
2030 int unicode_hex_count
= 4;
2035 end_of_file_error ();
2065 error ("Invalid escape character syntax");
2068 c
= read_escape (readcharfun
, 0);
2069 return c
| meta_modifier
;
2074 error ("Invalid escape character syntax");
2077 c
= read_escape (readcharfun
, 0);
2078 return c
| shift_modifier
;
2083 error ("Invalid escape character syntax");
2086 c
= read_escape (readcharfun
, 0);
2087 return c
| hyper_modifier
;
2092 error ("Invalid escape character syntax");
2095 c
= read_escape (readcharfun
, 0);
2096 return c
| alt_modifier
;
2100 if (stringp
|| c
!= '-')
2107 c
= read_escape (readcharfun
, 0);
2108 return c
| super_modifier
;
2113 error ("Invalid escape character syntax");
2117 c
= read_escape (readcharfun
, 0);
2118 if ((c
& ~CHAR_MODIFIER_MASK
) == '?')
2119 return 0177 | (c
& CHAR_MODIFIER_MASK
);
2120 else if (! SINGLE_BYTE_CHAR_P ((c
& ~CHAR_MODIFIER_MASK
)))
2121 return c
| ctrl_modifier
;
2122 /* ASCII control chars are made from letters (both cases),
2123 as well as the non-letters within 0100...0137. */
2124 else if ((c
& 0137) >= 0101 && (c
& 0137) <= 0132)
2125 return (c
& (037 | ~0177));
2126 else if ((c
& 0177) >= 0100 && (c
& 0177) <= 0137)
2127 return (c
& (037 | ~0177));
2129 return c
| ctrl_modifier
;
2139 /* An octal escape, as in ANSI C. */
2141 register int i
= c
- '0';
2142 register int count
= 0;
2145 if ((c
= READCHAR
) >= '0' && c
<= '7')
2157 if (i
>= 0x80 && i
< 0x100)
2158 i
= BYTE8_TO_CHAR (i
);
2163 /* A hex escape, as in ANSI C. */
2170 if (c
>= '0' && c
<= '9')
2175 else if ((c
>= 'a' && c
<= 'f')
2176 || (c
>= 'A' && c
<= 'F'))
2179 if (c
>= 'a' && c
<= 'f')
2192 if (count
< 3 && i
>= 0x80)
2193 return BYTE8_TO_CHAR (i
);
2198 /* Post-Unicode-2.0: Up to eight hex chars. */
2199 unicode_hex_count
= 8;
2202 /* A Unicode escape. We only permit them in strings and characters,
2203 not arbitrarily in the source code, as in some other languages. */
2208 while (++count
<= unicode_hex_count
)
2211 /* isdigit and isalpha may be locale-specific, which we don't
2213 if (c
>= '0' && c
<= '9') i
= (i
<< 4) + (c
- '0');
2214 else if (c
>= 'a' && c
<= 'f') i
= (i
<< 4) + (c
- 'a') + 10;
2215 else if (c
>= 'A' && c
<= 'F') i
= (i
<< 4) + (c
- 'A') + 10;
2218 error ("Non-hex digit used for Unicode escape");
2223 error ("Non-Unicode character: 0x%x", i
);
2232 /* Read an integer in radix RADIX using READCHARFUN to read
2233 characters. RADIX must be in the interval [2..36]; if it isn't, a
2234 read error is signaled . Value is the integer read. Signals an
2235 error if encountering invalid read syntax or if RADIX is out of
2239 read_integer (readcharfun
, radix
)
2240 Lisp_Object readcharfun
;
2243 int ndigits
= 0, invalid_p
, c
, sign
= 0;
2244 /* We use a floating point number because */
2247 if (radix
< 2 || radix
> 36)
2251 number
= ndigits
= invalid_p
= 0;
2267 if (c
>= '0' && c
<= '9')
2269 else if (c
>= 'a' && c
<= 'z')
2270 digit
= c
- 'a' + 10;
2271 else if (c
>= 'A' && c
<= 'Z')
2272 digit
= c
- 'A' + 10;
2279 if (digit
< 0 || digit
>= radix
)
2282 number
= radix
* number
+ digit
;
2288 if (ndigits
== 0 || invalid_p
)
2291 sprintf (buf
, "integer, radix %d", radix
);
2292 invalid_syntax (buf
, 0);
2295 return make_fixnum_or_float (sign
* number
);
2299 /* If the next token is ')' or ']' or '.', we store that character
2300 in *PCH and the return value is not interesting. Else, we store
2301 zero in *PCH and we read and return one lisp object.
2303 FIRST_IN_LIST is nonzero if this is the first element of a list. */
2306 read1 (readcharfun
, pch
, first_in_list
)
2307 register Lisp_Object readcharfun
;
2312 int uninterned_symbol
= 0;
2320 c
= READCHAR_REPORT_MULTIBYTE (&multibyte
);
2322 end_of_file_error ();
2327 return read_list (0, readcharfun
);
2330 return read_vector (readcharfun
, 0);
2346 /* Accept extended format for hashtables (extensible to
2348 #s(hash-table size 2 test equal data (k1 v1 k2 v2)) */
2349 Lisp_Object tmp
= read_list (0, readcharfun
);
2350 Lisp_Object head
= CAR_SAFE (tmp
);
2351 Lisp_Object data
= Qnil
;
2352 Lisp_Object val
= Qnil
;
2353 /* The size is 2 * number of allowed keywords to
2355 Lisp_Object params
[10];
2357 Lisp_Object key
= Qnil
;
2358 int param_count
= 0;
2360 if (!EQ (head
, Qhash_table
))
2361 error ("Invalid extended read marker at head of #s list "
2362 "(only hash-table allowed)");
2364 tmp
= CDR_SAFE (tmp
);
2366 /* This is repetitive but fast and simple. */
2367 params
[param_count
] = QCsize
;
2368 params
[param_count
+1] = Fplist_get (tmp
, Qsize
);
2369 if (!NILP (params
[param_count
+1]))
2372 params
[param_count
] = QCtest
;
2373 params
[param_count
+1] = Fplist_get (tmp
, Qtest
);
2374 if (!NILP (params
[param_count
+1]))
2377 params
[param_count
] = QCweakness
;
2378 params
[param_count
+1] = Fplist_get (tmp
, Qweakness
);
2379 if (!NILP (params
[param_count
+1]))
2382 params
[param_count
] = QCrehash_size
;
2383 params
[param_count
+1] = Fplist_get (tmp
, Qrehash_size
);
2384 if (!NILP (params
[param_count
+1]))
2387 params
[param_count
] = QCrehash_threshold
;
2388 params
[param_count
+1] = Fplist_get (tmp
, Qrehash_threshold
);
2389 if (!NILP (params
[param_count
+1]))
2392 /* This is the hashtable data. */
2393 data
= Fplist_get (tmp
, Qdata
);
2395 /* Now use params to make a new hashtable and fill it. */
2396 ht
= Fmake_hash_table (param_count
, params
);
2398 while (CONSP (data
))
2403 error ("Odd number of elements in hashtable data");
2406 Fputhash (key
, val
, ht
);
2418 tmp
= read_vector (readcharfun
, 0);
2419 if (XVECTOR (tmp
)->size
< CHAR_TABLE_STANDARD_SLOTS
)
2420 error ("Invalid size char-table");
2421 XSETPVECTYPE (XVECTOR (tmp
), PVEC_CHAR_TABLE
);
2432 tmp
= read_vector (readcharfun
, 0);
2433 if (!INTEGERP (AREF (tmp
, 0)))
2434 error ("Invalid depth in char-table");
2435 depth
= XINT (AREF (tmp
, 0));
2436 if (depth
< 1 || depth
> 3)
2437 error ("Invalid depth in char-table");
2438 size
= XVECTOR (tmp
)->size
- 2;
2439 if (chartab_size
[depth
] != size
)
2440 error ("Invalid size char-table");
2441 XSETPVECTYPE (XVECTOR (tmp
), PVEC_SUB_CHAR_TABLE
);
2444 invalid_syntax ("#^^", 3);
2446 invalid_syntax ("#^", 2);
2451 length
= read1 (readcharfun
, pch
, first_in_list
);
2455 Lisp_Object tmp
, val
;
2457 = ((XFASTINT (length
) + BOOL_VECTOR_BITS_PER_CHAR
- 1)
2458 / BOOL_VECTOR_BITS_PER_CHAR
);
2461 tmp
= read1 (readcharfun
, pch
, first_in_list
);
2462 if (STRING_MULTIBYTE (tmp
)
2463 || (size_in_chars
!= SCHARS (tmp
)
2464 /* We used to print 1 char too many
2465 when the number of bits was a multiple of 8.
2466 Accept such input in case it came from an old
2468 && ! (XFASTINT (length
)
2469 == (SCHARS (tmp
) - 1) * BOOL_VECTOR_BITS_PER_CHAR
)))
2470 invalid_syntax ("#&...", 5);
2472 val
= Fmake_bool_vector (length
, Qnil
);
2473 bcopy (SDATA (tmp
), XBOOL_VECTOR (val
)->data
,
2475 /* Clear the extraneous bits in the last byte. */
2476 if (XINT (length
) != size_in_chars
* BOOL_VECTOR_BITS_PER_CHAR
)
2477 XBOOL_VECTOR (val
)->data
[size_in_chars
- 1]
2478 &= (1 << (XINT (length
) % BOOL_VECTOR_BITS_PER_CHAR
)) - 1;
2481 invalid_syntax ("#&...", 5);
2485 /* Accept compiled functions at read-time so that we don't have to
2486 build them using function calls. */
2488 tmp
= read_vector (readcharfun
, 1);
2489 return Fmake_byte_code (XVECTOR (tmp
)->size
,
2490 XVECTOR (tmp
)->contents
);
2495 struct gcpro gcpro1
;
2498 /* Read the string itself. */
2499 tmp
= read1 (readcharfun
, &ch
, 0);
2500 if (ch
!= 0 || !STRINGP (tmp
))
2501 invalid_syntax ("#", 1);
2503 /* Read the intervals and their properties. */
2506 Lisp_Object beg
, end
, plist
;
2508 beg
= read1 (readcharfun
, &ch
, 0);
2513 end
= read1 (readcharfun
, &ch
, 0);
2515 plist
= read1 (readcharfun
, &ch
, 0);
2517 invalid_syntax ("Invalid string property list", 0);
2518 Fset_text_properties (beg
, end
, plist
, tmp
);
2524 /* #@NUMBER is used to skip NUMBER following characters.
2525 That's used in .elc files to skip over doc strings
2526 and function definitions. */
2532 /* Read a decimal integer. */
2533 while ((c
= READCHAR
) >= 0
2534 && c
>= '0' && c
<= '9')
2542 if (load_force_doc_strings
2543 && (EQ (readcharfun
, Qget_file_char
)
2544 || EQ (readcharfun
, Qget_emacs_mule_file_char
)))
2546 /* If we are supposed to force doc strings into core right now,
2547 record the last string that we skipped,
2548 and record where in the file it comes from. */
2550 /* But first exchange saved_doc_string
2551 with prev_saved_doc_string, so we save two strings. */
2553 char *temp
= saved_doc_string
;
2554 int temp_size
= saved_doc_string_size
;
2555 file_offset temp_pos
= saved_doc_string_position
;
2556 int temp_len
= saved_doc_string_length
;
2558 saved_doc_string
= prev_saved_doc_string
;
2559 saved_doc_string_size
= prev_saved_doc_string_size
;
2560 saved_doc_string_position
= prev_saved_doc_string_position
;
2561 saved_doc_string_length
= prev_saved_doc_string_length
;
2563 prev_saved_doc_string
= temp
;
2564 prev_saved_doc_string_size
= temp_size
;
2565 prev_saved_doc_string_position
= temp_pos
;
2566 prev_saved_doc_string_length
= temp_len
;
2569 if (saved_doc_string_size
== 0)
2571 saved_doc_string_size
= nskip
+ 100;
2572 saved_doc_string
= (char *) xmalloc (saved_doc_string_size
);
2574 if (nskip
> saved_doc_string_size
)
2576 saved_doc_string_size
= nskip
+ 100;
2577 saved_doc_string
= (char *) xrealloc (saved_doc_string
,
2578 saved_doc_string_size
);
2581 saved_doc_string_position
= file_tell (instream
);
2583 /* Copy that many characters into saved_doc_string. */
2584 for (i
= 0; i
< nskip
&& c
>= 0; i
++)
2585 saved_doc_string
[i
] = c
= READCHAR
;
2587 saved_doc_string_length
= i
;
2591 /* Skip that many characters. */
2592 for (i
= 0; i
< nskip
&& c
>= 0; i
++)
2601 /* #! appears at the beginning of an executable file.
2602 Skip the first line. */
2603 while (c
!= '\n' && c
>= 0)
2608 return Vload_file_name
;
2610 return Fcons (Qfunction
, Fcons (read0 (readcharfun
), Qnil
));
2611 /* #:foo is the uninterned symbol named foo. */
2614 uninterned_symbol
= 1;
2618 /* Reader forms that can reuse previously read objects. */
2619 if (c
>= '0' && c
<= '9')
2624 /* Read a non-negative integer. */
2625 while (c
>= '0' && c
<= '9')
2631 /* #n=object returns object, but associates it with n for #n#. */
2632 if (c
== '=' && !NILP (Vread_circle
))
2634 /* Make a placeholder for #n# to use temporarily */
2635 Lisp_Object placeholder
;
2638 placeholder
= Fcons (Qnil
, Qnil
);
2639 cell
= Fcons (make_number (n
), placeholder
);
2640 read_objects
= Fcons (cell
, read_objects
);
2642 /* Read the object itself. */
2643 tem
= read0 (readcharfun
);
2645 /* Now put it everywhere the placeholder was... */
2646 substitute_object_in_subtree (tem
, placeholder
);
2648 /* ...and #n# will use the real value from now on. */
2649 Fsetcdr (cell
, tem
);
2653 /* #n# returns a previously read object. */
2654 if (c
== '#' && !NILP (Vread_circle
))
2656 tem
= Fassq (make_number (n
), read_objects
);
2659 /* Fall through to error message. */
2661 else if (c
== 'r' || c
== 'R')
2662 return read_integer (readcharfun
, n
);
2664 /* Fall through to error message. */
2666 else if (c
== 'x' || c
== 'X')
2667 return read_integer (readcharfun
, 16);
2668 else if (c
== 'o' || c
== 'O')
2669 return read_integer (readcharfun
, 8);
2670 else if (c
== 'b' || c
== 'B')
2671 return read_integer (readcharfun
, 2);
2674 invalid_syntax ("#", 1);
2677 while ((c
= READCHAR
) >= 0 && c
!= '\n');
2682 return Fcons (Qquote
, Fcons (read0 (readcharfun
), Qnil
));
2686 /* Transition from old-style to new-style:
2687 If we see "(`" it used to mean old-style, which usually works
2688 fine because ` should almost never appear in such a position
2689 for new-style. But occasionally we need "(`" to mean new
2690 style, so we try to distinguish the two by the fact that we
2691 can either write "( `foo" or "(` foo", where the first
2692 intends to use new-style whereas the second intends to use
2693 old-style. For Emacs-25, we should completely remove this
2694 first_in_list exception (old-style can still be obtained via
2696 if (first_in_list
&& (c
= READCHAR
, UNREAD (c
), c
== ' '))
2698 Vold_style_backquotes
= Qt
;
2705 new_backquote_flag
++;
2706 value
= read0 (readcharfun
);
2707 new_backquote_flag
--;
2709 return Fcons (Qbackquote
, Fcons (value
, Qnil
));
2713 if (new_backquote_flag
)
2715 Lisp_Object comma_type
= Qnil
;
2720 comma_type
= Qcomma_at
;
2722 comma_type
= Qcomma_dot
;
2725 if (ch
>= 0) UNREAD (ch
);
2726 comma_type
= Qcomma
;
2729 new_backquote_flag
--;
2730 value
= read0 (readcharfun
);
2731 new_backquote_flag
++;
2732 return Fcons (comma_type
, Fcons (value
, Qnil
));
2736 Vold_style_backquotes
= Qt
;
2748 end_of_file_error ();
2750 /* Accept `single space' syntax like (list ? x) where the
2751 whitespace character is SPC or TAB.
2752 Other literal whitespace like NL, CR, and FF are not accepted,
2753 as there are well-established escape sequences for these. */
2754 if (c
== ' ' || c
== '\t')
2755 return make_number (c
);
2758 c
= read_escape (readcharfun
, 0);
2759 modifiers
= c
& CHAR_MODIFIER_MASK
;
2760 c
&= ~CHAR_MODIFIER_MASK
;
2761 if (CHAR_BYTE8_P (c
))
2762 c
= CHAR_TO_BYTE8 (c
);
2765 next_char
= READCHAR
;
2766 if (next_char
== '.')
2768 /* Only a dotted-pair dot is valid after a char constant. */
2769 int next_next_char
= READCHAR
;
2770 UNREAD (next_next_char
);
2772 ok
= (next_next_char
<= 040
2773 || (next_next_char
< 0200
2774 && (index ("\"';([#?", next_next_char
)
2775 || (!first_in_list
&& next_next_char
== '`')
2776 || (new_backquote_flag
&& next_next_char
== ','))));
2780 ok
= (next_char
<= 040
2781 || (next_char
< 0200
2782 && (index ("\"';()[]#?", next_char
)
2783 || (!first_in_list
&& next_char
== '`')
2784 || (new_backquote_flag
&& next_char
== ','))));
2788 return make_number (c
);
2790 invalid_syntax ("?", 1);
2795 char *p
= read_buffer
;
2796 char *end
= read_buffer
+ read_buffer_size
;
2798 /* Nonzero if we saw an escape sequence specifying
2799 a multibyte character. */
2800 int force_multibyte
= 0;
2801 /* Nonzero if we saw an escape sequence specifying
2802 a single-byte character. */
2803 int force_singlebyte
= 0;
2807 while ((c
= READCHAR
) >= 0
2810 if (end
- p
< MAX_MULTIBYTE_LENGTH
)
2812 int offset
= p
- read_buffer
;
2813 read_buffer
= (char *) xrealloc (read_buffer
,
2814 read_buffer_size
*= 2);
2815 p
= read_buffer
+ offset
;
2816 end
= read_buffer
+ read_buffer_size
;
2823 c
= read_escape (readcharfun
, 1);
2825 /* C is -1 if \ newline has just been seen */
2828 if (p
== read_buffer
)
2833 modifiers
= c
& CHAR_MODIFIER_MASK
;
2834 c
= c
& ~CHAR_MODIFIER_MASK
;
2836 if (CHAR_BYTE8_P (c
))
2837 force_singlebyte
= 1;
2838 else if (! ASCII_CHAR_P (c
))
2839 force_multibyte
= 1;
2840 else /* i.e. ASCII_CHAR_P (c) */
2842 /* Allow `\C- ' and `\C-?'. */
2843 if (modifiers
== CHAR_CTL
)
2846 c
= 0, modifiers
= 0;
2848 c
= 127, modifiers
= 0;
2850 if (modifiers
& CHAR_SHIFT
)
2852 /* Shift modifier is valid only with [A-Za-z]. */
2853 if (c
>= 'A' && c
<= 'Z')
2854 modifiers
&= ~CHAR_SHIFT
;
2855 else if (c
>= 'a' && c
<= 'z')
2856 c
-= ('a' - 'A'), modifiers
&= ~CHAR_SHIFT
;
2859 if (modifiers
& CHAR_META
)
2861 /* Move the meta bit to the right place for a
2863 modifiers
&= ~CHAR_META
;
2864 c
= BYTE8_TO_CHAR (c
| 0x80);
2865 force_singlebyte
= 1;
2869 /* Any modifiers remaining are invalid. */
2871 error ("Invalid modifier in string");
2872 p
+= CHAR_STRING (c
, (unsigned char *) p
);
2876 p
+= CHAR_STRING (c
, (unsigned char *) p
);
2877 if (CHAR_BYTE8_P (c
))
2878 force_singlebyte
= 1;
2879 else if (! ASCII_CHAR_P (c
))
2880 force_multibyte
= 1;
2886 end_of_file_error ();
2888 /* If purifying, and string starts with \ newline,
2889 return zero instead. This is for doc strings
2890 that we are really going to find in etc/DOC.nn.nn */
2891 if (!NILP (Vpurify_flag
) && NILP (Vdoc_file_name
) && cancel
)
2892 return make_number (0);
2894 if (force_multibyte
)
2895 /* READ_BUFFER already contains valid multibyte forms. */
2897 else if (force_singlebyte
)
2899 nchars
= str_as_unibyte (read_buffer
, p
- read_buffer
);
2900 p
= read_buffer
+ nchars
;
2903 /* Otherwise, READ_BUFFER contains only ASCII. */
2906 /* We want readchar_count to be the number of characters, not
2907 bytes. Hence we adjust for multibyte characters in the
2908 string. ... But it doesn't seem to be necessary, because
2909 READCHAR *does* read multibyte characters from buffers. */
2910 /* readchar_count -= (p - read_buffer) - nchars; */
2912 return make_pure_string (read_buffer
, nchars
, p
- read_buffer
,
2914 || (p
- read_buffer
!= nchars
)));
2915 return make_specified_string (read_buffer
, nchars
, p
- read_buffer
,
2917 || (p
- read_buffer
!= nchars
)));
2922 int next_char
= READCHAR
;
2925 if (next_char
<= 040
2926 || (next_char
< 0200
2927 && (index ("\"';([#?", next_char
)
2928 || (!first_in_list
&& next_char
== '`')
2929 || (new_backquote_flag
&& next_char
== ','))))
2935 /* Otherwise, we fall through! Note that the atom-reading loop
2936 below will now loop at least once, assuring that we will not
2937 try to UNREAD two characters in a row. */
2941 if (c
<= 040) goto retry
;
2942 if (c
== 0x8a0) /* NBSP */
2945 char *p
= read_buffer
;
2949 char *end
= read_buffer
+ read_buffer_size
;
2952 && c
!= 0x8a0 /* NBSP */
2954 || (!index ("\"';()[]#", c
)
2955 && !(!first_in_list
&& c
== '`')
2956 && !(new_backquote_flag
&& c
== ','))))
2958 if (end
- p
< MAX_MULTIBYTE_LENGTH
)
2960 int offset
= p
- read_buffer
;
2961 read_buffer
= (char *) xrealloc (read_buffer
,
2962 read_buffer_size
*= 2);
2963 p
= read_buffer
+ offset
;
2964 end
= read_buffer
+ read_buffer_size
;
2971 end_of_file_error ();
2976 p
+= CHAR_STRING (c
, p
);
2984 int offset
= p
- read_buffer
;
2985 read_buffer
= (char *) xrealloc (read_buffer
,
2986 read_buffer_size
*= 2);
2987 p
= read_buffer
+ offset
;
2988 end
= read_buffer
+ read_buffer_size
;
2995 if (!quoted
&& !uninterned_symbol
)
2999 if (*p1
== '+' || *p1
== '-') p1
++;
3000 /* Is it an integer? */
3003 while (p1
!= p
&& (c
= *p1
) >= '0' && c
<= '9') p1
++;
3004 /* Integers can have trailing decimal points. */
3005 if (p1
> read_buffer
&& p1
< p
&& *p1
== '.') p1
++;
3007 /* It is an integer. */
3012 /* EMACS_INT n = atol (read_buffer); */
3013 char *endptr
= NULL
;
3014 EMACS_INT n
= (errno
= 0,
3015 strtol (read_buffer
, &endptr
, 10));
3016 if (errno
== ERANGE
&& endptr
)
3019 = Fcons (make_string (read_buffer
,
3020 endptr
- read_buffer
),
3022 xsignal (Qoverflow_error
, args
);
3024 return make_fixnum_or_float (n
);
3028 if (isfloat_string (read_buffer
, 0))
3030 /* Compute NaN and infinities using 0.0 in a variable,
3031 to cope with compilers that think they are smarter
3037 /* Negate the value ourselves. This treats 0, NaNs,
3038 and infinity properly on IEEE floating point hosts,
3039 and works around a common bug where atof ("-0.0")
3041 int negative
= read_buffer
[0] == '-';
3043 /* The only way p[-1] can be 'F' or 'N', after isfloat_string
3044 returns 1, is if the input ends in e+INF or e+NaN. */
3051 value
= zero
/ zero
;
3053 /* If that made a "negative" NaN, negate it. */
3057 union { double d
; char c
[sizeof (double)]; } u_data
, u_minus_zero
;
3060 u_minus_zero
.d
= - 0.0;
3061 for (i
= 0; i
< sizeof (double); i
++)
3062 if (u_data
.c
[i
] & u_minus_zero
.c
[i
])
3068 /* Now VALUE is a positive NaN. */
3071 value
= atof (read_buffer
+ negative
);
3075 return make_float (negative
? - value
: value
);
3079 Lisp_Object name
, result
;
3080 EMACS_INT nbytes
= p
- read_buffer
;
3082 = (multibyte
? multibyte_chars_in_text (read_buffer
, nbytes
)
3085 if (uninterned_symbol
&& ! NILP (Vpurify_flag
))
3086 name
= make_pure_string (read_buffer
, nchars
, nbytes
, multibyte
);
3088 name
= make_specified_string (read_buffer
, nchars
, nbytes
,multibyte
);
3089 result
= (uninterned_symbol
? Fmake_symbol (name
)
3090 : Fintern (name
, Qnil
));
3092 if (EQ (Vread_with_symbol_positions
, Qt
)
3093 || EQ (Vread_with_symbol_positions
, readcharfun
))
3094 Vread_symbol_positions_list
=
3095 /* Kind of a hack; this will probably fail if characters
3096 in the symbol name were escaped. Not really a big
3098 Fcons (Fcons (result
,
3099 make_number (readchar_count
3100 - XFASTINT (Flength (Fsymbol_name (result
))))),
3101 Vread_symbol_positions_list
);
3109 /* List of nodes we've seen during substitute_object_in_subtree. */
3110 static Lisp_Object seen_list
;
3113 substitute_object_in_subtree (object
, placeholder
)
3115 Lisp_Object placeholder
;
3117 Lisp_Object check_object
;
3119 /* We haven't seen any objects when we start. */
3122 /* Make all the substitutions. */
3124 = substitute_object_recurse (object
, placeholder
, object
);
3126 /* Clear seen_list because we're done with it. */
3129 /* The returned object here is expected to always eq the
3131 if (!EQ (check_object
, object
))
3132 error ("Unexpected mutation error in reader");
3135 /* Feval doesn't get called from here, so no gc protection is needed. */
3136 #define SUBSTITUTE(get_val, set_val) \
3138 Lisp_Object old_value = get_val; \
3139 Lisp_Object true_value \
3140 = substitute_object_recurse (object, placeholder, \
3143 if (!EQ (old_value, true_value)) \
3150 substitute_object_recurse (object
, placeholder
, subtree
)
3152 Lisp_Object placeholder
;
3153 Lisp_Object subtree
;
3155 /* If we find the placeholder, return the target object. */
3156 if (EQ (placeholder
, subtree
))
3159 /* If we've been to this node before, don't explore it again. */
3160 if (!EQ (Qnil
, Fmemq (subtree
, seen_list
)))
3163 /* If this node can be the entry point to a cycle, remember that
3164 we've seen it. It can only be such an entry point if it was made
3165 by #n=, which means that we can find it as a value in
3167 if (!EQ (Qnil
, Frassq (subtree
, read_objects
)))
3168 seen_list
= Fcons (subtree
, seen_list
);
3170 /* Recurse according to subtree's type.
3171 Every branch must return a Lisp_Object. */
3172 switch (XTYPE (subtree
))
3174 case Lisp_Vectorlike
:
3177 if (BOOL_VECTOR_P (subtree
))
3178 return subtree
; /* No sub-objects anyway. */
3179 else if (CHAR_TABLE_P (subtree
) || SUB_CHAR_TABLE_P (subtree
)
3180 || COMPILEDP (subtree
))
3181 length
= ASIZE (subtree
) & PSEUDOVECTOR_SIZE_MASK
;
3182 else if (VECTORP (subtree
))
3183 length
= ASIZE (subtree
);
3185 /* An unknown pseudovector may contain non-Lisp fields, so we
3186 can't just blindly traverse all its fields. We used to call
3187 `Flength' which signaled `sequencep', so I just preserved this
3189 wrong_type_argument (Qsequencep
, subtree
);
3191 for (i
= 0; i
< length
; i
++)
3192 SUBSTITUTE (AREF (subtree
, i
),
3193 ASET (subtree
, i
, true_value
));
3199 SUBSTITUTE (XCAR (subtree
),
3200 XSETCAR (subtree
, true_value
));
3201 SUBSTITUTE (XCDR (subtree
),
3202 XSETCDR (subtree
, true_value
));
3208 /* Check for text properties in each interval.
3209 substitute_in_interval contains part of the logic. */
3211 INTERVAL root_interval
= STRING_INTERVALS (subtree
);
3212 Lisp_Object arg
= Fcons (object
, placeholder
);
3214 traverse_intervals_noorder (root_interval
,
3215 &substitute_in_interval
, arg
);
3220 /* Other types don't recurse any further. */
3226 /* Helper function for substitute_object_recurse. */
3228 substitute_in_interval (interval
, arg
)
3232 Lisp_Object object
= Fcar (arg
);
3233 Lisp_Object placeholder
= Fcdr (arg
);
3235 SUBSTITUTE (interval
->plist
, interval
->plist
= true_value
);
3246 isfloat_string (cp
, ignore_trailing
)
3248 int ignore_trailing
;
3255 if (*cp
== '+' || *cp
== '-')
3258 if (*cp
>= '0' && *cp
<= '9')
3261 while (*cp
>= '0' && *cp
<= '9')
3269 if (*cp
>= '0' && *cp
<= '9')
3272 while (*cp
>= '0' && *cp
<= '9')
3275 if (*cp
== 'e' || *cp
== 'E')
3279 if (*cp
== '+' || *cp
== '-')
3283 if (*cp
>= '0' && *cp
<= '9')
3286 while (*cp
>= '0' && *cp
<= '9')
3289 else if (cp
== start
)
3291 else if (cp
[-1] == '+' && cp
[0] == 'I' && cp
[1] == 'N' && cp
[2] == 'F')
3296 else if (cp
[-1] == '+' && cp
[0] == 'N' && cp
[1] == 'a' && cp
[2] == 'N')
3302 return ((ignore_trailing
3303 || (*cp
== 0) || (*cp
== ' ') || (*cp
== '\t') || (*cp
== '\n') || (*cp
== '\r') || (*cp
== '\f'))
3304 && (state
== (LEAD_INT
|DOT_CHAR
|TRAIL_INT
)
3305 || state
== (DOT_CHAR
|TRAIL_INT
)
3306 || state
== (LEAD_INT
|E_CHAR
|EXP_INT
)
3307 || state
== (LEAD_INT
|DOT_CHAR
|TRAIL_INT
|E_CHAR
|EXP_INT
)
3308 || state
== (DOT_CHAR
|TRAIL_INT
|E_CHAR
|EXP_INT
)));
3313 read_vector (readcharfun
, bytecodeflag
)
3314 Lisp_Object readcharfun
;
3319 register Lisp_Object
*ptr
;
3320 register Lisp_Object tem
, item
, vector
;
3321 register struct Lisp_Cons
*otem
;
3324 tem
= read_list (1, readcharfun
);
3325 len
= Flength (tem
);
3326 vector
= (read_pure
? make_pure_vector (XINT (len
)) : Fmake_vector (len
, Qnil
));
3328 size
= XVECTOR (vector
)->size
;
3329 ptr
= XVECTOR (vector
)->contents
;
3330 for (i
= 0; i
< size
; i
++)
3333 /* If `load-force-doc-strings' is t when reading a lazily-loaded
3334 bytecode object, the docstring containing the bytecode and
3335 constants values must be treated as unibyte and passed to
3336 Fread, to get the actual bytecode string and constants vector. */
3337 if (bytecodeflag
&& load_force_doc_strings
)
3339 if (i
== COMPILED_BYTECODE
)
3341 if (!STRINGP (item
))
3342 error ("Invalid byte code");
3344 /* Delay handling the bytecode slot until we know whether
3345 it is lazily-loaded (we can tell by whether the
3346 constants slot is nil). */
3347 ptr
[COMPILED_CONSTANTS
] = item
;
3350 else if (i
== COMPILED_CONSTANTS
)
3352 Lisp_Object bytestr
= ptr
[COMPILED_CONSTANTS
];
3356 /* Coerce string to unibyte (like string-as-unibyte,
3357 but without generating extra garbage and
3358 guaranteeing no change in the contents). */
3359 STRING_SET_CHARS (bytestr
, SBYTES (bytestr
));
3360 STRING_SET_UNIBYTE (bytestr
);
3362 item
= Fread (Fcons (bytestr
, readcharfun
));
3364 error ("Invalid byte code");
3366 otem
= XCONS (item
);
3367 bytestr
= XCAR (item
);
3372 /* Now handle the bytecode slot. */
3373 ptr
[COMPILED_BYTECODE
] = read_pure
? Fpurecopy (bytestr
) : bytestr
;
3375 else if (i
== COMPILED_DOC_STRING
3377 && ! STRING_MULTIBYTE (item
))
3379 if (EQ (readcharfun
, Qget_emacs_mule_file_char
))
3380 item
= Fdecode_coding_string (item
, Qemacs_mule
, Qnil
, Qnil
);
3382 item
= Fstring_as_multibyte (item
);
3385 ptr
[i
] = read_pure
? Fpurecopy (item
) : item
;
3393 /* FLAG = 1 means check for ] to terminate rather than ) and .
3394 FLAG = -1 means check for starting with defun
3395 and make structure pure. */
3398 read_list (flag
, readcharfun
)
3400 register Lisp_Object readcharfun
;
3402 /* -1 means check next element for defun,
3403 0 means don't check,
3404 1 means already checked and found defun. */
3405 int defunflag
= flag
< 0 ? -1 : 0;
3406 Lisp_Object val
, tail
;
3407 register Lisp_Object elt
, tem
;
3408 struct gcpro gcpro1
, gcpro2
;
3409 /* 0 is the normal case.
3410 1 means this list is a doc reference; replace it with the number 0.
3411 2 means this list is a doc reference; replace it with the doc string. */
3412 int doc_reference
= 0;
3414 /* Initialize this to 1 if we are reading a list. */
3415 int first_in_list
= flag
<= 0;
3424 elt
= read1 (readcharfun
, &ch
, first_in_list
);
3429 /* While building, if the list starts with #$, treat it specially. */
3430 if (EQ (elt
, Vload_file_name
)
3432 && !NILP (Vpurify_flag
))
3434 if (NILP (Vdoc_file_name
))
3435 /* We have not yet called Snarf-documentation, so assume
3436 this file is described in the DOC-MM.NN file
3437 and Snarf-documentation will fill in the right value later.
3438 For now, replace the whole list with 0. */
3441 /* We have already called Snarf-documentation, so make a relative
3442 file name for this file, so it can be found properly
3443 in the installed Lisp directory.
3444 We don't use Fexpand_file_name because that would make
3445 the directory absolute now. */
3446 elt
= concat2 (build_string ("../lisp/"),
3447 Ffile_name_nondirectory (elt
));
3449 else if (EQ (elt
, Vload_file_name
)
3451 && load_force_doc_strings
)
3460 invalid_syntax (") or . in a vector", 18);
3468 XSETCDR (tail
, read0 (readcharfun
));
3470 val
= read0 (readcharfun
);
3471 read1 (readcharfun
, &ch
, 0);
3475 if (doc_reference
== 1)
3476 return make_number (0);
3477 if (doc_reference
== 2)
3479 /* Get a doc string from the file we are loading.
3480 If it's in saved_doc_string, get it from there.
3482 Here, we don't know if the string is a
3483 bytecode string or a doc string. As a
3484 bytecode string must be unibyte, we always
3485 return a unibyte string. If it is actually a
3486 doc string, caller must make it
3489 int pos
= XINT (XCDR (val
));
3490 /* Position is negative for user variables. */
3491 if (pos
< 0) pos
= -pos
;
3492 if (pos
>= saved_doc_string_position
3493 && pos
< (saved_doc_string_position
3494 + saved_doc_string_length
))
3496 int start
= pos
- saved_doc_string_position
;
3499 /* Process quoting with ^A,
3500 and find the end of the string,
3501 which is marked with ^_ (037). */
3502 for (from
= start
, to
= start
;
3503 saved_doc_string
[from
] != 037;)
3505 int c
= saved_doc_string
[from
++];
3508 c
= saved_doc_string
[from
++];
3510 saved_doc_string
[to
++] = c
;
3512 saved_doc_string
[to
++] = 0;
3514 saved_doc_string
[to
++] = 037;
3517 saved_doc_string
[to
++] = c
;
3520 return make_unibyte_string (saved_doc_string
+ start
,
3523 /* Look in prev_saved_doc_string the same way. */
3524 else if (pos
>= prev_saved_doc_string_position
3525 && pos
< (prev_saved_doc_string_position
3526 + prev_saved_doc_string_length
))
3528 int start
= pos
- prev_saved_doc_string_position
;
3531 /* Process quoting with ^A,
3532 and find the end of the string,
3533 which is marked with ^_ (037). */
3534 for (from
= start
, to
= start
;
3535 prev_saved_doc_string
[from
] != 037;)
3537 int c
= prev_saved_doc_string
[from
++];
3540 c
= prev_saved_doc_string
[from
++];
3542 prev_saved_doc_string
[to
++] = c
;
3544 prev_saved_doc_string
[to
++] = 0;
3546 prev_saved_doc_string
[to
++] = 037;
3549 prev_saved_doc_string
[to
++] = c
;
3552 return make_unibyte_string (prev_saved_doc_string
3557 return get_doc_string (val
, 1, 0);
3562 invalid_syntax (". in wrong context", 18);
3564 invalid_syntax ("] in a list", 11);
3566 tem
= (read_pure
&& flag
<= 0
3567 ? pure_cons (elt
, Qnil
)
3568 : Fcons (elt
, Qnil
));
3570 XSETCDR (tail
, tem
);
3575 defunflag
= EQ (elt
, Qdefun
);
3576 else if (defunflag
> 0)
3581 Lisp_Object Vobarray
;
3582 Lisp_Object initial_obarray
;
3584 /* oblookup stores the bucket number here, for the sake of Funintern. */
3586 int oblookup_last_bucket_number
;
3588 static int hash_string ();
3590 /* Get an error if OBARRAY is not an obarray.
3591 If it is one, return it. */
3594 check_obarray (obarray
)
3595 Lisp_Object obarray
;
3597 if (!VECTORP (obarray
) || XVECTOR (obarray
)->size
== 0)
3599 /* If Vobarray is now invalid, force it to be valid. */
3600 if (EQ (Vobarray
, obarray
)) Vobarray
= initial_obarray
;
3601 wrong_type_argument (Qvectorp
, obarray
);
3606 /* Intern the C string STR: return a symbol with that name,
3607 interned in the current obarray. */
3614 int len
= strlen (str
);
3615 Lisp_Object obarray
;
3618 if (!VECTORP (obarray
) || XVECTOR (obarray
)->size
== 0)
3619 obarray
= check_obarray (obarray
);
3620 tem
= oblookup (obarray
, str
, len
, len
);
3623 return Fintern (make_string (str
, len
), obarray
);
3627 intern_c_string (const char *str
)
3630 int len
= strlen (str
);
3631 Lisp_Object obarray
;
3634 if (!VECTORP (obarray
) || XVECTOR (obarray
)->size
== 0)
3635 obarray
= check_obarray (obarray
);
3636 tem
= oblookup (obarray
, str
, len
, len
);
3640 if (NILP (Vpurify_flag
))
3641 /* Creating a non-pure string from a string literal not
3642 implemented yet. We could just use make_string here and live
3643 with the extra copy. */
3646 return Fintern (make_pure_c_string (str
), obarray
);
3649 /* Create an uninterned symbol with name STR. */
3655 int len
= strlen (str
);
3657 return Fmake_symbol ((!NILP (Vpurify_flag
)
3658 ? make_pure_string (str
, len
, len
, 0)
3659 : make_string (str
, len
)));
3662 DEFUN ("intern", Fintern
, Sintern
, 1, 2, 0,
3663 doc
: /* Return the canonical symbol whose name is STRING.
3664 If there is none, one is created by this function and returned.
3665 A second optional argument specifies the obarray to use;
3666 it defaults to the value of `obarray'. */)
3668 Lisp_Object string
, obarray
;
3670 register Lisp_Object tem
, sym
, *ptr
;
3672 if (NILP (obarray
)) obarray
= Vobarray
;
3673 obarray
= check_obarray (obarray
);
3675 CHECK_STRING (string
);
3677 tem
= oblookup (obarray
, SDATA (string
),
3680 if (!INTEGERP (tem
))
3683 if (!NILP (Vpurify_flag
))
3684 string
= Fpurecopy (string
);
3685 sym
= Fmake_symbol (string
);
3687 if (EQ (obarray
, initial_obarray
))
3688 XSYMBOL (sym
)->interned
= SYMBOL_INTERNED_IN_INITIAL_OBARRAY
;
3690 XSYMBOL (sym
)->interned
= SYMBOL_INTERNED
;
3692 if ((SREF (string
, 0) == ':')
3693 && EQ (obarray
, initial_obarray
))
3695 XSYMBOL (sym
)->constant
= 1;
3696 XSYMBOL (sym
)->redirect
= SYMBOL_PLAINVAL
;
3697 SET_SYMBOL_VAL (XSYMBOL (sym
), sym
);
3700 ptr
= &XVECTOR (obarray
)->contents
[XINT (tem
)];
3702 XSYMBOL (sym
)->next
= XSYMBOL (*ptr
);
3704 XSYMBOL (sym
)->next
= 0;
3709 DEFUN ("intern-soft", Fintern_soft
, Sintern_soft
, 1, 2, 0,
3710 doc
: /* Return the canonical symbol named NAME, or nil if none exists.
3711 NAME may be a string or a symbol. If it is a symbol, that exact
3712 symbol is searched for.
3713 A second optional argument specifies the obarray to use;
3714 it defaults to the value of `obarray'. */)
3716 Lisp_Object name
, obarray
;
3718 register Lisp_Object tem
, string
;
3720 if (NILP (obarray
)) obarray
= Vobarray
;
3721 obarray
= check_obarray (obarray
);
3723 if (!SYMBOLP (name
))
3725 CHECK_STRING (name
);
3729 string
= SYMBOL_NAME (name
);
3731 tem
= oblookup (obarray
, SDATA (string
), SCHARS (string
), SBYTES (string
));
3732 if (INTEGERP (tem
) || (SYMBOLP (name
) && !EQ (name
, tem
)))
3738 DEFUN ("unintern", Funintern
, Sunintern
, 1, 2, 0,
3739 doc
: /* Delete the symbol named NAME, if any, from OBARRAY.
3740 The value is t if a symbol was found and deleted, nil otherwise.
3741 NAME may be a string or a symbol. If it is a symbol, that symbol
3742 is deleted, if it belongs to OBARRAY--no other symbol is deleted.
3743 OBARRAY defaults to the value of the variable `obarray'. */)
3745 Lisp_Object name
, obarray
;
3747 register Lisp_Object string
, tem
;
3750 if (NILP (obarray
)) obarray
= Vobarray
;
3751 obarray
= check_obarray (obarray
);
3754 string
= SYMBOL_NAME (name
);
3757 CHECK_STRING (name
);
3761 tem
= oblookup (obarray
, SDATA (string
),
3766 /* If arg was a symbol, don't delete anything but that symbol itself. */
3767 if (SYMBOLP (name
) && !EQ (name
, tem
))
3770 /* There are plenty of other symbols which will screw up the Emacs
3771 session if we unintern them, as well as even more ways to use
3772 `setq' or `fset' or whatnot to make the Emacs session
3773 unusable. Let's not go down this silly road. --Stef */
3774 /* if (EQ (tem, Qnil) || EQ (tem, Qt))
3775 error ("Attempt to unintern t or nil"); */
3777 XSYMBOL (tem
)->interned
= SYMBOL_UNINTERNED
;
3779 hash
= oblookup_last_bucket_number
;
3781 if (EQ (XVECTOR (obarray
)->contents
[hash
], tem
))
3783 if (XSYMBOL (tem
)->next
)
3784 XSETSYMBOL (XVECTOR (obarray
)->contents
[hash
], XSYMBOL (tem
)->next
);
3786 XSETINT (XVECTOR (obarray
)->contents
[hash
], 0);
3790 Lisp_Object tail
, following
;
3792 for (tail
= XVECTOR (obarray
)->contents
[hash
];
3793 XSYMBOL (tail
)->next
;
3796 XSETSYMBOL (following
, XSYMBOL (tail
)->next
);
3797 if (EQ (following
, tem
))
3799 XSYMBOL (tail
)->next
= XSYMBOL (following
)->next
;
3808 /* Return the symbol in OBARRAY whose names matches the string
3809 of SIZE characters (SIZE_BYTE bytes) at PTR.
3810 If there is no such symbol in OBARRAY, return nil.
3812 Also store the bucket number in oblookup_last_bucket_number. */
3815 oblookup (obarray
, ptr
, size
, size_byte
)
3816 Lisp_Object obarray
;
3817 register const char *ptr
;
3818 int size
, size_byte
;
3822 register Lisp_Object tail
;
3823 Lisp_Object bucket
, tem
;
3825 if (!VECTORP (obarray
)
3826 || (obsize
= XVECTOR (obarray
)->size
) == 0)
3828 obarray
= check_obarray (obarray
);
3829 obsize
= XVECTOR (obarray
)->size
;
3831 /* This is sometimes needed in the middle of GC. */
3832 obsize
&= ~ARRAY_MARK_FLAG
;
3833 hash
= hash_string (ptr
, size_byte
) % obsize
;
3834 bucket
= XVECTOR (obarray
)->contents
[hash
];
3835 oblookup_last_bucket_number
= hash
;
3836 if (EQ (bucket
, make_number (0)))
3838 else if (!SYMBOLP (bucket
))
3839 error ("Bad data in guts of obarray"); /* Like CADR error message */
3841 for (tail
= bucket
; ; XSETSYMBOL (tail
, XSYMBOL (tail
)->next
))
3843 if (SBYTES (SYMBOL_NAME (tail
)) == size_byte
3844 && SCHARS (SYMBOL_NAME (tail
)) == size
3845 && !bcmp (SDATA (SYMBOL_NAME (tail
)), ptr
, size_byte
))
3847 else if (XSYMBOL (tail
)->next
== 0)
3850 XSETINT (tem
, hash
);
3855 hash_string (ptr
, len
)
3856 const unsigned char *ptr
;
3859 register const unsigned char *p
= ptr
;
3860 register const unsigned char *end
= p
+ len
;
3861 register unsigned char c
;
3862 register int hash
= 0;
3867 if (c
>= 0140) c
-= 40;
3868 hash
= ((hash
<<3) + (hash
>>28) + c
);
3870 return hash
& 07777777777;
3874 map_obarray (obarray
, fn
, arg
)
3875 Lisp_Object obarray
;
3876 void (*fn
) P_ ((Lisp_Object
, Lisp_Object
));
3880 register Lisp_Object tail
;
3881 CHECK_VECTOR (obarray
);
3882 for (i
= XVECTOR (obarray
)->size
- 1; i
>= 0; i
--)
3884 tail
= XVECTOR (obarray
)->contents
[i
];
3889 if (XSYMBOL (tail
)->next
== 0)
3891 XSETSYMBOL (tail
, XSYMBOL (tail
)->next
);
3897 mapatoms_1 (sym
, function
)
3898 Lisp_Object sym
, function
;
3900 call1 (function
, sym
);
3903 DEFUN ("mapatoms", Fmapatoms
, Smapatoms
, 1, 2, 0,
3904 doc
: /* Call FUNCTION on every symbol in OBARRAY.
3905 OBARRAY defaults to the value of `obarray'. */)
3907 Lisp_Object function
, obarray
;
3909 if (NILP (obarray
)) obarray
= Vobarray
;
3910 obarray
= check_obarray (obarray
);
3912 map_obarray (obarray
, mapatoms_1
, function
);
3916 #define OBARRAY_SIZE 1511
3921 Lisp_Object oblength
;
3923 XSETFASTINT (oblength
, OBARRAY_SIZE
);
3925 Vobarray
= Fmake_vector (oblength
, make_number (0));
3926 initial_obarray
= Vobarray
;
3927 staticpro (&initial_obarray
);
3929 Qunbound
= Fmake_symbol (make_pure_c_string ("unbound"));
3930 /* Set temporary dummy values to Qnil and Vpurify_flag to satisfy the
3931 NILP (Vpurify_flag) check in intern_c_string. */
3932 Qnil
= make_number (-1); Vpurify_flag
= make_number (1);
3933 Qnil
= intern_c_string ("nil");
3935 /* Fmake_symbol inits fields of new symbols with Qunbound and Qnil,
3936 so those two need to be fixed manally. */
3937 SET_SYMBOL_VAL (XSYMBOL (Qunbound
), Qunbound
);
3938 XSYMBOL (Qunbound
)->function
= Qunbound
;
3939 XSYMBOL (Qunbound
)->plist
= Qnil
;
3940 /* XSYMBOL (Qnil)->function = Qunbound; */
3941 SET_SYMBOL_VAL (XSYMBOL (Qnil
), Qnil
);
3942 XSYMBOL (Qnil
)->constant
= 1;
3943 XSYMBOL (Qnil
)->plist
= Qnil
;
3945 Qt
= intern_c_string ("t");
3946 SET_SYMBOL_VAL (XSYMBOL (Qt
), Qt
);
3947 XSYMBOL (Qt
)->constant
= 1;
3949 /* Qt is correct even if CANNOT_DUMP. loadup.el will set to nil at end. */
3952 Qvariable_documentation
= intern_c_string ("variable-documentation");
3953 staticpro (&Qvariable_documentation
);
3955 read_buffer_size
= 100 + MAX_MULTIBYTE_LENGTH
;
3956 read_buffer
= (char *) xmalloc (read_buffer_size
);
3961 struct Lisp_Subr
*sname
;
3964 sym
= intern_c_string (sname
->symbol_name
);
3965 XSETPVECTYPE (sname
, PVEC_SUBR
);
3966 XSETSUBR (XSYMBOL (sym
)->function
, sname
);
3969 #ifdef NOTDEF /* use fset in subr.el now */
3971 defalias (sname
, string
)
3972 struct Lisp_Subr
*sname
;
3976 sym
= intern (string
);
3977 XSETSUBR (XSYMBOL (sym
)->function
, sname
);
3981 /* Define an "integer variable"; a symbol whose value is forwarded
3982 to a C variable of type int. Sample call:
3983 DEFVAR_INT ("emacs-priority", &emacs_priority, "Documentation"); */
3985 defvar_int (struct Lisp_Intfwd
*i_fwd
,
3986 const char *namestring
, EMACS_INT
*address
)
3989 sym
= intern_c_string (namestring
);
3990 i_fwd
->type
= Lisp_Fwd_Int
;
3991 i_fwd
->intvar
= address
;
3992 XSYMBOL (sym
)->redirect
= SYMBOL_FORWARDED
;
3993 SET_SYMBOL_FWD (XSYMBOL (sym
), (union Lisp_Fwd
*)i_fwd
);
3996 /* Similar but define a variable whose value is t if address contains 1,
3997 nil if address contains 0. */
3999 defvar_bool (struct Lisp_Boolfwd
*b_fwd
,
4000 const char *namestring
, int *address
)
4003 sym
= intern_c_string (namestring
);
4004 b_fwd
->type
= Lisp_Fwd_Bool
;
4005 b_fwd
->boolvar
= address
;
4006 XSYMBOL (sym
)->redirect
= SYMBOL_FORWARDED
;
4007 SET_SYMBOL_FWD (XSYMBOL (sym
), (union Lisp_Fwd
*)b_fwd
);
4008 Vbyte_boolean_vars
= Fcons (sym
, Vbyte_boolean_vars
);
4011 /* Similar but define a variable whose value is the Lisp Object stored
4012 at address. Two versions: with and without gc-marking of the C
4013 variable. The nopro version is used when that variable will be
4014 gc-marked for some other reason, since marking the same slot twice
4015 can cause trouble with strings. */
4017 defvar_lisp_nopro (struct Lisp_Objfwd
*o_fwd
,
4018 const char *namestring
, Lisp_Object
*address
)
4021 sym
= intern_c_string (namestring
);
4022 o_fwd
->type
= Lisp_Fwd_Obj
;
4023 o_fwd
->objvar
= address
;
4024 XSYMBOL (sym
)->redirect
= SYMBOL_FORWARDED
;
4025 SET_SYMBOL_FWD (XSYMBOL (sym
), (union Lisp_Fwd
*)o_fwd
);
4029 defvar_lisp (struct Lisp_Objfwd
*o_fwd
,
4030 const char *namestring
, Lisp_Object
*address
)
4032 defvar_lisp_nopro (o_fwd
, namestring
, address
);
4033 staticpro (address
);
4036 /* Similar but define a variable whose value is the Lisp Object stored
4037 at a particular offset in the current kboard object. */
4040 defvar_kboard (struct Lisp_Kboard_Objfwd
*ko_fwd
,
4041 const char *namestring
, int offset
)
4044 sym
= intern_c_string (namestring
);
4045 ko_fwd
->type
= Lisp_Fwd_Kboard_Obj
;
4046 ko_fwd
->offset
= offset
;
4047 XSYMBOL (sym
)->redirect
= SYMBOL_FORWARDED
;
4048 SET_SYMBOL_FWD (XSYMBOL (sym
), (union Lisp_Fwd
*)ko_fwd
);
4051 /* Record the value of load-path used at the start of dumping
4052 so we can see if the site changed it later during dumping. */
4053 static Lisp_Object dump_path
;
4059 int turn_off_warning
= 0;
4061 /* Compute the default load-path. */
4063 normal
= PATH_LOADSEARCH
;
4064 Vload_path
= decode_env_path (0, normal
);
4066 if (NILP (Vpurify_flag
))
4067 normal
= PATH_LOADSEARCH
;
4069 normal
= PATH_DUMPLOADSEARCH
;
4071 /* In a dumped Emacs, we normally have to reset the value of
4072 Vload_path from PATH_LOADSEARCH, since the value that was dumped
4073 uses ../lisp, instead of the path of the installed elisp
4074 libraries. However, if it appears that Vload_path was changed
4075 from the default before dumping, don't override that value. */
4078 if (! NILP (Fequal (dump_path
, Vload_path
)))
4080 Vload_path
= decode_env_path (0, normal
);
4081 if (!NILP (Vinstallation_directory
))
4083 Lisp_Object tem
, tem1
, sitelisp
;
4085 /* Remove site-lisp dirs from path temporarily and store
4086 them in sitelisp, then conc them on at the end so
4087 they're always first in path. */
4091 tem
= Fcar (Vload_path
);
4092 tem1
= Fstring_match (build_string ("site-lisp"),
4096 Vload_path
= Fcdr (Vload_path
);
4097 sitelisp
= Fcons (tem
, sitelisp
);
4103 /* Add to the path the lisp subdir of the
4104 installation dir, if it exists. */
4105 tem
= Fexpand_file_name (build_string ("lisp"),
4106 Vinstallation_directory
);
4107 tem1
= Ffile_exists_p (tem
);
4110 if (NILP (Fmember (tem
, Vload_path
)))
4112 turn_off_warning
= 1;
4113 Vload_path
= Fcons (tem
, Vload_path
);
4117 /* That dir doesn't exist, so add the build-time
4118 Lisp dirs instead. */
4119 Vload_path
= nconc2 (Vload_path
, dump_path
);
4121 /* Add leim under the installation dir, if it exists. */
4122 tem
= Fexpand_file_name (build_string ("leim"),
4123 Vinstallation_directory
);
4124 tem1
= Ffile_exists_p (tem
);
4127 if (NILP (Fmember (tem
, Vload_path
)))
4128 Vload_path
= Fcons (tem
, Vload_path
);
4131 /* Add site-lisp under the installation dir, if it exists. */
4132 tem
= Fexpand_file_name (build_string ("site-lisp"),
4133 Vinstallation_directory
);
4134 tem1
= Ffile_exists_p (tem
);
4137 if (NILP (Fmember (tem
, Vload_path
)))
4138 Vload_path
= Fcons (tem
, Vload_path
);
4141 /* If Emacs was not built in the source directory,
4142 and it is run from where it was built, add to load-path
4143 the lisp, leim and site-lisp dirs under that directory. */
4145 if (NILP (Fequal (Vinstallation_directory
, Vsource_directory
)))
4149 tem
= Fexpand_file_name (build_string ("src/Makefile"),
4150 Vinstallation_directory
);
4151 tem1
= Ffile_exists_p (tem
);
4153 /* Don't be fooled if they moved the entire source tree
4154 AFTER dumping Emacs. If the build directory is indeed
4155 different from the source dir, src/Makefile.in and
4156 src/Makefile will not be found together. */
4157 tem
= Fexpand_file_name (build_string ("src/Makefile.in"),
4158 Vinstallation_directory
);
4159 tem2
= Ffile_exists_p (tem
);
4160 if (!NILP (tem1
) && NILP (tem2
))
4162 tem
= Fexpand_file_name (build_string ("lisp"),
4165 if (NILP (Fmember (tem
, Vload_path
)))
4166 Vload_path
= Fcons (tem
, Vload_path
);
4168 tem
= Fexpand_file_name (build_string ("leim"),
4171 if (NILP (Fmember (tem
, Vload_path
)))
4172 Vload_path
= Fcons (tem
, Vload_path
);
4174 tem
= Fexpand_file_name (build_string ("site-lisp"),
4177 if (NILP (Fmember (tem
, Vload_path
)))
4178 Vload_path
= Fcons (tem
, Vload_path
);
4181 if (!NILP (sitelisp
))
4182 Vload_path
= nconc2 (Fnreverse (sitelisp
), Vload_path
);
4188 /* NORMAL refers to the lisp dir in the source directory. */
4189 /* We used to add ../lisp at the front here, but
4190 that caused trouble because it was copied from dump_path
4191 into Vload_path, above, when Vinstallation_directory was non-nil.
4192 It should be unnecessary. */
4193 Vload_path
= decode_env_path (0, normal
);
4194 dump_path
= Vload_path
;
4198 #if (!(defined (WINDOWSNT) || (defined (HAVE_NS))))
4199 /* When Emacs is invoked over network shares on NT, PATH_LOADSEARCH is
4200 almost never correct, thereby causing a warning to be printed out that
4201 confuses users. Since PATH_LOADSEARCH is always overridden by the
4202 EMACSLOADPATH environment variable below, disable the warning on NT. */
4204 /* Warn if dirs in the *standard* path don't exist. */
4205 if (!turn_off_warning
)
4207 Lisp_Object path_tail
;
4209 for (path_tail
= Vload_path
;
4211 path_tail
= XCDR (path_tail
))
4213 Lisp_Object dirfile
;
4214 dirfile
= Fcar (path_tail
);
4215 if (STRINGP (dirfile
))
4217 dirfile
= Fdirectory_file_name (dirfile
);
4218 if (access (SDATA (dirfile
), 0) < 0)
4219 dir_warning ("Warning: Lisp directory `%s' does not exist.\n",
4224 #endif /* !(WINDOWSNT || HAVE_NS) */
4226 /* If the EMACSLOADPATH environment variable is set, use its value.
4227 This doesn't apply if we're dumping. */
4229 if (NILP (Vpurify_flag
)
4230 && egetenv ("EMACSLOADPATH"))
4232 Vload_path
= decode_env_path ("EMACSLOADPATH", normal
);
4236 load_in_progress
= 0;
4237 Vload_file_name
= Qnil
;
4239 load_descriptor_list
= Qnil
;
4241 Vstandard_input
= Qt
;
4242 Vloads_in_progress
= Qnil
;
4245 /* Print a warning, using format string FORMAT, that directory DIRNAME
4246 does not exist. Print it on stderr and put it in *Messages*. */
4249 dir_warning (format
, dirname
)
4251 Lisp_Object dirname
;
4254 = (char *) alloca (SCHARS (dirname
) + strlen (format
) + 5);
4256 fprintf (stderr
, format
, SDATA (dirname
));
4257 sprintf (buffer
, format
, SDATA (dirname
));
4258 /* Don't log the warning before we've initialized!! */
4260 message_dolog (buffer
, strlen (buffer
), 0, STRING_MULTIBYTE (dirname
));
4267 defsubr (&Sread_from_string
);
4269 defsubr (&Sintern_soft
);
4270 defsubr (&Sunintern
);
4271 defsubr (&Sget_load_suffixes
);
4273 defsubr (&Seval_buffer
);
4274 defsubr (&Seval_region
);
4275 defsubr (&Sread_char
);
4276 defsubr (&Sread_char_exclusive
);
4277 defsubr (&Sread_event
);
4278 defsubr (&Sget_file_char
);
4279 defsubr (&Smapatoms
);
4280 defsubr (&Slocate_file_internal
);
4282 DEFVAR_LISP ("obarray", &Vobarray
,
4283 doc
: /* Symbol table for use by `intern' and `read'.
4284 It is a vector whose length ought to be prime for best results.
4285 The vector's contents don't make sense if examined from Lisp programs;
4286 to find all the symbols in an obarray, use `mapatoms'. */);
4288 DEFVAR_LISP ("values", &Vvalues
,
4289 doc
: /* List of values of all expressions which were read, evaluated and printed.
4290 Order is reverse chronological. */);
4292 DEFVAR_LISP ("standard-input", &Vstandard_input
,
4293 doc
: /* Stream for read to get input from.
4294 See documentation of `read' for possible values. */);
4295 Vstandard_input
= Qt
;
4297 DEFVAR_LISP ("read-with-symbol-positions", &Vread_with_symbol_positions
,
4298 doc
: /* If non-nil, add position of read symbols to `read-symbol-positions-list'.
4300 If this variable is a buffer, then only forms read from that buffer
4301 will be added to `read-symbol-positions-list'.
4302 If this variable is t, then all read forms will be added.
4303 The effect of all other values other than nil are not currently
4304 defined, although they may be in the future.
4306 The positions are relative to the last call to `read' or
4307 `read-from-string'. It is probably a bad idea to set this variable at
4308 the toplevel; bind it instead. */);
4309 Vread_with_symbol_positions
= Qnil
;
4311 DEFVAR_LISP ("read-symbol-positions-list", &Vread_symbol_positions_list
,
4312 doc
: /* A list mapping read symbols to their positions.
4313 This variable is modified during calls to `read' or
4314 `read-from-string', but only when `read-with-symbol-positions' is
4317 Each element of the list looks like (SYMBOL . CHAR-POSITION), where
4318 CHAR-POSITION is an integer giving the offset of that occurrence of the
4319 symbol from the position where `read' or `read-from-string' started.
4321 Note that a symbol will appear multiple times in this list, if it was
4322 read multiple times. The list is in the same order as the symbols
4324 Vread_symbol_positions_list
= Qnil
;
4326 DEFVAR_LISP ("read-circle", &Vread_circle
,
4327 doc
: /* Non-nil means read recursive structures using #N= and #N# syntax. */);
4330 DEFVAR_LISP ("load-path", &Vload_path
,
4331 doc
: /* *List of directories to search for files to load.
4332 Each element is a string (directory name) or nil (try default directory).
4333 Initialized based on EMACSLOADPATH environment variable, if any,
4334 otherwise to default specified by file `epaths.h' when Emacs was built. */);
4336 DEFVAR_LISP ("load-suffixes", &Vload_suffixes
,
4337 doc
: /* List of suffixes for (compiled or source) Emacs Lisp files.
4338 This list should not include the empty string.
4339 `load' and related functions try to append these suffixes, in order,
4340 to the specified file name if a Lisp suffix is allowed or required. */);
4341 Vload_suffixes
= Fcons (make_pure_c_string (".elc"),
4342 Fcons (make_pure_c_string (".el"), Qnil
));
4343 DEFVAR_LISP ("load-file-rep-suffixes", &Vload_file_rep_suffixes
,
4344 doc
: /* List of suffixes that indicate representations of \
4346 This list should normally start with the empty string.
4348 Enabling Auto Compression mode appends the suffixes in
4349 `jka-compr-load-suffixes' to this list and disabling Auto Compression
4350 mode removes them again. `load' and related functions use this list to
4351 determine whether they should look for compressed versions of a file
4352 and, if so, which suffixes they should try to append to the file name
4353 in order to do so. However, if you want to customize which suffixes
4354 the loading functions recognize as compression suffixes, you should
4355 customize `jka-compr-load-suffixes' rather than the present variable. */);
4356 Vload_file_rep_suffixes
= Fcons (empty_unibyte_string
, Qnil
);
4358 DEFVAR_BOOL ("load-in-progress", &load_in_progress
,
4359 doc
: /* Non-nil if inside of `load'. */);
4360 Qload_in_progress
= intern_c_string ("load-in-progress");
4361 staticpro (&Qload_in_progress
);
4363 DEFVAR_LISP ("after-load-alist", &Vafter_load_alist
,
4364 doc
: /* An alist of expressions to be evalled when particular files are loaded.
4365 Each element looks like (REGEXP-OR-FEATURE FORMS...).
4367 REGEXP-OR-FEATURE is either a regular expression to match file names, or
4368 a symbol \(a feature name).
4370 When `load' is run and the file-name argument matches an element's
4371 REGEXP-OR-FEATURE, or when `provide' is run and provides the symbol
4372 REGEXP-OR-FEATURE, the FORMS in the element are executed.
4374 An error in FORMS does not undo the load, but does prevent execution of
4375 the rest of the FORMS. */);
4376 Vafter_load_alist
= Qnil
;
4378 DEFVAR_LISP ("load-history", &Vload_history
,
4379 doc
: /* Alist mapping loaded file names to symbols and features.
4380 Each alist element should be a list (FILE-NAME ENTRIES...), where
4381 FILE-NAME is the name of a file that has been loaded into Emacs.
4382 The file name is absolute and true (i.e. it doesn't contain symlinks).
4383 As an exception, one of the alist elements may have FILE-NAME nil,
4384 for symbols and features not associated with any file.
4386 The remaining ENTRIES in the alist element describe the functions and
4387 variables defined in that file, the features provided, and the
4388 features required. Each entry has the form `(provide . FEATURE)',
4389 `(require . FEATURE)', `(defun . FUNCTION)', `(autoload . SYMBOL)',
4390 `(defface . SYMBOL)', or `(t . SYMBOL)'. In addition, an entry `(t
4391 . SYMBOL)' may precede an entry `(defun . FUNCTION)', and means that
4392 SYMBOL was an autoload before this file redefined it as a function.
4394 During preloading, the file name recorded is relative to the main Lisp
4395 directory. These file names are converted to absolute at startup. */);
4396 Vload_history
= Qnil
;
4398 DEFVAR_LISP ("load-file-name", &Vload_file_name
,
4399 doc
: /* Full name of file being loaded by `load'. */);
4400 Vload_file_name
= Qnil
;
4402 DEFVAR_LISP ("user-init-file", &Vuser_init_file
,
4403 doc
: /* File name, including directory, of user's initialization file.
4404 If the file loaded had extension `.elc', and the corresponding source file
4405 exists, this variable contains the name of source file, suitable for use
4406 by functions like `custom-save-all' which edit the init file.
4407 While Emacs loads and evaluates the init file, value is the real name
4408 of the file, regardless of whether or not it has the `.elc' extension. */);
4409 Vuser_init_file
= Qnil
;
4411 DEFVAR_LISP ("current-load-list", &Vcurrent_load_list
,
4412 doc
: /* Used for internal purposes by `load'. */);
4413 Vcurrent_load_list
= Qnil
;
4415 DEFVAR_LISP ("load-read-function", &Vload_read_function
,
4416 doc
: /* Function used by `load' and `eval-region' for reading expressions.
4417 The default is nil, which means use the function `read'. */);
4418 Vload_read_function
= Qnil
;
4420 DEFVAR_LISP ("load-source-file-function", &Vload_source_file_function
,
4421 doc
: /* Function called in `load' for loading an Emacs Lisp source file.
4422 This function is for doing code conversion before reading the source file.
4423 If nil, loading is done without any code conversion.
4424 Arguments are FULLNAME, FILE, NOERROR, NOMESSAGE, where
4425 FULLNAME is the full name of FILE.
4426 See `load' for the meaning of the remaining arguments. */);
4427 Vload_source_file_function
= Qnil
;
4429 DEFVAR_BOOL ("load-force-doc-strings", &load_force_doc_strings
,
4430 doc
: /* Non-nil means `load' should force-load all dynamic doc strings.
4431 This is useful when the file being loaded is a temporary copy. */);
4432 load_force_doc_strings
= 0;
4434 DEFVAR_BOOL ("load-convert-to-unibyte", &load_convert_to_unibyte
,
4435 doc
: /* Non-nil means `read' converts strings to unibyte whenever possible.
4436 This is normally bound by `load' and `eval-buffer' to control `read',
4437 and is not meant for users to change. */);
4438 load_convert_to_unibyte
= 0;
4440 DEFVAR_LISP ("source-directory", &Vsource_directory
,
4441 doc
: /* Directory in which Emacs sources were found when Emacs was built.
4442 You cannot count on them to still be there! */);
4444 = Fexpand_file_name (build_string ("../"),
4445 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH
)));
4447 DEFVAR_LISP ("preloaded-file-list", &Vpreloaded_file_list
,
4448 doc
: /* List of files that were preloaded (when dumping Emacs). */);
4449 Vpreloaded_file_list
= Qnil
;
4451 DEFVAR_LISP ("byte-boolean-vars", &Vbyte_boolean_vars
,
4452 doc
: /* List of all DEFVAR_BOOL variables, used by the byte code optimizer. */);
4453 Vbyte_boolean_vars
= Qnil
;
4455 DEFVAR_BOOL ("load-dangerous-libraries", &load_dangerous_libraries
,
4456 doc
: /* Non-nil means load dangerous compiled Lisp files.
4457 Some versions of XEmacs use different byte codes than Emacs. These
4458 incompatible byte codes can make Emacs crash when it tries to execute
4460 load_dangerous_libraries
= 0;
4462 DEFVAR_BOOL ("force-load-messages", &force_load_messages
,
4463 doc
: /* Non-nil means force printing messages when loading Lisp files.
4464 This overrides the value of the NOMESSAGE argument to `load'. */);
4465 force_load_messages
= 0;
4467 DEFVAR_LISP ("bytecomp-version-regexp", &Vbytecomp_version_regexp
,
4468 doc
: /* Regular expression matching safe to load compiled Lisp files.
4469 When Emacs loads a compiled Lisp file, it reads the first 512 bytes
4470 from the file, and matches them against this regular expression.
4471 When the regular expression matches, the file is considered to be safe
4472 to load. See also `load-dangerous-libraries'. */);
4473 Vbytecomp_version_regexp
4474 = make_pure_c_string ("^;;;.\\(in Emacs version\\|bytecomp version FSF\\)");
4476 DEFVAR_LISP ("eval-buffer-list", &Veval_buffer_list
,
4477 doc
: /* List of buffers being read from by calls to `eval-buffer' and `eval-region'. */);
4478 Veval_buffer_list
= Qnil
;
4480 DEFVAR_LISP ("old-style-backquotes", &Vold_style_backquotes
,
4481 doc
: /* Set to non-nil when `read' encounters an old-style backquote. */);
4482 Vold_style_backquotes
= Qnil
;
4483 Qold_style_backquotes
= intern_c_string ("old-style-backquotes");
4484 staticpro (&Qold_style_backquotes
);
4486 /* Vsource_directory was initialized in init_lread. */
4488 load_descriptor_list
= Qnil
;
4489 staticpro (&load_descriptor_list
);
4491 Qcurrent_load_list
= intern_c_string ("current-load-list");
4492 staticpro (&Qcurrent_load_list
);
4494 Qstandard_input
= intern_c_string ("standard-input");
4495 staticpro (&Qstandard_input
);
4497 Qread_char
= intern_c_string ("read-char");
4498 staticpro (&Qread_char
);
4500 Qget_file_char
= intern_c_string ("get-file-char");
4501 staticpro (&Qget_file_char
);
4503 Qget_emacs_mule_file_char
= intern_c_string ("get-emacs-mule-file-char");
4504 staticpro (&Qget_emacs_mule_file_char
);
4506 Qload_force_doc_strings
= intern_c_string ("load-force-doc-strings");
4507 staticpro (&Qload_force_doc_strings
);
4509 Qbackquote
= intern_c_string ("`");
4510 staticpro (&Qbackquote
);
4511 Qcomma
= intern_c_string (",");
4512 staticpro (&Qcomma
);
4513 Qcomma_at
= intern_c_string (",@");
4514 staticpro (&Qcomma_at
);
4515 Qcomma_dot
= intern_c_string (",.");
4516 staticpro (&Qcomma_dot
);
4518 Qinhibit_file_name_operation
= intern_c_string ("inhibit-file-name-operation");
4519 staticpro (&Qinhibit_file_name_operation
);
4521 Qascii_character
= intern_c_string ("ascii-character");
4522 staticpro (&Qascii_character
);
4524 Qfunction
= intern_c_string ("function");
4525 staticpro (&Qfunction
);
4527 Qload
= intern_c_string ("load");
4530 Qload_file_name
= intern_c_string ("load-file-name");
4531 staticpro (&Qload_file_name
);
4533 Qeval_buffer_list
= intern_c_string ("eval-buffer-list");
4534 staticpro (&Qeval_buffer_list
);
4536 Qfile_truename
= intern_c_string ("file-truename");
4537 staticpro (&Qfile_truename
) ;
4539 Qdo_after_load_evaluation
= intern_c_string ("do-after-load-evaluation");
4540 staticpro (&Qdo_after_load_evaluation
) ;
4542 staticpro (&dump_path
);
4544 staticpro (&read_objects
);
4545 read_objects
= Qnil
;
4546 staticpro (&seen_list
);
4549 Vloads_in_progress
= Qnil
;
4550 staticpro (&Vloads_in_progress
);
4552 Qhash_table
= intern_c_string ("hash-table");
4553 staticpro (&Qhash_table
);
4554 Qdata
= intern_c_string ("data");
4556 Qtest
= intern_c_string ("test");
4558 Qsize
= intern_c_string ("size");
4560 Qweakness
= intern_c_string ("weakness");
4561 staticpro (&Qweakness
);
4562 Qrehash_size
= intern_c_string ("rehash-size");
4563 staticpro (&Qrehash_size
);
4564 Qrehash_threshold
= intern_c_string ("rehash-threshold");
4565 staticpro (&Qrehash_threshold
);
4568 /* arch-tag: a0d02733-0f96-4844-a659-9fd53c4f414d
4569 (do not change this comment) */