]> code.delx.au - gnu-emacs/blob - src/lread.c
Replace IF_LINT by NONVOLATILE and UNINIT
[gnu-emacs] / src / lread.c
1 /* Lisp parsing and input streams.
2
3 Copyright (C) 1985-1989, 1993-1995, 1997-2016 Free Software Foundation,
4 Inc.
5
6 This file is part of GNU Emacs.
7
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 (at
11 your option) any later version.
12
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.
17
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/>. */
20
21 /* Tell globals.h to define tables needed by init_obarray. */
22 #define DEFINE_SYMBOLS
23
24 #include <config.h>
25 #include "sysstdio.h"
26 #include <sys/types.h>
27 #include <sys/stat.h>
28 #include <sys/file.h>
29 #include <errno.h>
30 #include <limits.h> /* For CHAR_BIT. */
31 #include <math.h>
32 #include <stat-time.h>
33 #include "lisp.h"
34 #include "dispextern.h"
35 #include "intervals.h"
36 #include "character.h"
37 #include "buffer.h"
38 #include "charset.h"
39 #include "coding.h"
40 #include <epaths.h>
41 #include "commands.h"
42 #include "keyboard.h"
43 #include "systime.h"
44 #include "termhooks.h"
45 #include "blockinput.h"
46 #include <c-ctype.h>
47
48 #ifdef MSDOS
49 #include "msdos.h"
50 #if __DJGPP__ == 2 && __DJGPP_MINOR__ < 5
51 # define INFINITY __builtin_inf()
52 # define NAN __builtin_nan("")
53 #endif
54 #endif
55
56 #ifdef HAVE_NS
57 #include "nsterm.h"
58 #endif
59
60 #include <unistd.h>
61
62 #ifdef HAVE_SETLOCALE
63 #include <locale.h>
64 #endif /* HAVE_SETLOCALE */
65
66 #include <fcntl.h>
67
68 #ifdef HAVE_FSEEKO
69 #define file_offset off_t
70 #define file_tell ftello
71 #else
72 #define file_offset long
73 #define file_tell ftell
74 #endif
75
76 /* The association list of objects read with the #n=object form.
77 Each member of the list has the form (n . object), and is used to
78 look up the object for the corresponding #n# construct.
79 It must be set to nil before all top-level calls to read0. */
80 static Lisp_Object read_objects;
81
82 /* File for get_file_char to read from. Use by load. */
83 static FILE *instream;
84
85 /* For use within read-from-string (this reader is non-reentrant!!) */
86 static ptrdiff_t read_from_string_index;
87 static ptrdiff_t read_from_string_index_byte;
88 static ptrdiff_t read_from_string_limit;
89
90 /* Number of characters read in the current call to Fread or
91 Fread_from_string. */
92 static EMACS_INT readchar_count;
93
94 /* This contains the last string skipped with #@. */
95 static char *saved_doc_string;
96 /* Length of buffer allocated in saved_doc_string. */
97 static ptrdiff_t saved_doc_string_size;
98 /* Length of actual data in saved_doc_string. */
99 static ptrdiff_t saved_doc_string_length;
100 /* This is the file position that string came from. */
101 static file_offset saved_doc_string_position;
102
103 /* This contains the previous string skipped with #@.
104 We copy it from saved_doc_string when a new string
105 is put in saved_doc_string. */
106 static char *prev_saved_doc_string;
107 /* Length of buffer allocated in prev_saved_doc_string. */
108 static ptrdiff_t prev_saved_doc_string_size;
109 /* Length of actual data in prev_saved_doc_string. */
110 static ptrdiff_t prev_saved_doc_string_length;
111 /* This is the file position that string came from. */
112 static file_offset prev_saved_doc_string_position;
113
114 /* True means inside a new-style backquote
115 with no surrounding parentheses.
116 Fread initializes this to false, so we need not specbind it
117 or worry about what happens to it when there is an error. */
118 static bool new_backquote_flag;
119
120 /* A list of file names for files being loaded in Fload. Used to
121 check for recursive loads. */
122
123 static Lisp_Object Vloads_in_progress;
124
125 static int read_emacs_mule_char (int, int (*) (int, Lisp_Object),
126 Lisp_Object);
127
128 static void readevalloop (Lisp_Object, FILE *, Lisp_Object, bool,
129 Lisp_Object, Lisp_Object,
130 Lisp_Object, Lisp_Object);
131 \f
132 /* Functions that read one byte from the current source READCHARFUN
133 or unreads one byte. If the integer argument C is -1, it returns
134 one read byte, or -1 when there's no more byte in the source. If C
135 is 0 or positive, it unreads C, and the return value is not
136 interesting. */
137
138 static int readbyte_for_lambda (int, Lisp_Object);
139 static int readbyte_from_file (int, Lisp_Object);
140 static int readbyte_from_string (int, Lisp_Object);
141
142 /* Handle unreading and rereading of characters.
143 Write READCHAR to read a character,
144 UNREAD(c) to unread c to be read again.
145
146 These macros correctly read/unread multibyte characters. */
147
148 #define READCHAR readchar (readcharfun, NULL)
149 #define UNREAD(c) unreadchar (readcharfun, c)
150
151 /* Same as READCHAR but set *MULTIBYTE to the multibyteness of the source. */
152 #define READCHAR_REPORT_MULTIBYTE(multibyte) readchar (readcharfun, multibyte)
153
154 /* When READCHARFUN is Qget_file_char, Qget_emacs_mule_file_char,
155 Qlambda, or a cons, we use this to keep an unread character because
156 a file stream can't handle multibyte-char unreading. The value -1
157 means that there's no unread character. */
158 static int unread_char;
159
160 static int
161 readchar (Lisp_Object readcharfun, bool *multibyte)
162 {
163 Lisp_Object tem;
164 register int c;
165 int (*readbyte) (int, Lisp_Object);
166 unsigned char buf[MAX_MULTIBYTE_LENGTH];
167 int i, len;
168 bool emacs_mule_encoding = 0;
169
170 if (multibyte)
171 *multibyte = 0;
172
173 readchar_count++;
174
175 if (BUFFERP (readcharfun))
176 {
177 register struct buffer *inbuffer = XBUFFER (readcharfun);
178
179 ptrdiff_t pt_byte = BUF_PT_BYTE (inbuffer);
180
181 if (! BUFFER_LIVE_P (inbuffer))
182 return -1;
183
184 if (pt_byte >= BUF_ZV_BYTE (inbuffer))
185 return -1;
186
187 if (! NILP (BVAR (inbuffer, enable_multibyte_characters)))
188 {
189 /* Fetch the character code from the buffer. */
190 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, pt_byte);
191 BUF_INC_POS (inbuffer, pt_byte);
192 c = STRING_CHAR (p);
193 if (multibyte)
194 *multibyte = 1;
195 }
196 else
197 {
198 c = BUF_FETCH_BYTE (inbuffer, pt_byte);
199 if (! ASCII_CHAR_P (c))
200 c = BYTE8_TO_CHAR (c);
201 pt_byte++;
202 }
203 SET_BUF_PT_BOTH (inbuffer, BUF_PT (inbuffer) + 1, pt_byte);
204
205 return c;
206 }
207 if (MARKERP (readcharfun))
208 {
209 register struct buffer *inbuffer = XMARKER (readcharfun)->buffer;
210
211 ptrdiff_t bytepos = marker_byte_position (readcharfun);
212
213 if (bytepos >= BUF_ZV_BYTE (inbuffer))
214 return -1;
215
216 if (! NILP (BVAR (inbuffer, enable_multibyte_characters)))
217 {
218 /* Fetch the character code from the buffer. */
219 unsigned char *p = BUF_BYTE_ADDRESS (inbuffer, bytepos);
220 BUF_INC_POS (inbuffer, bytepos);
221 c = STRING_CHAR (p);
222 if (multibyte)
223 *multibyte = 1;
224 }
225 else
226 {
227 c = BUF_FETCH_BYTE (inbuffer, bytepos);
228 if (! ASCII_CHAR_P (c))
229 c = BYTE8_TO_CHAR (c);
230 bytepos++;
231 }
232
233 XMARKER (readcharfun)->bytepos = bytepos;
234 XMARKER (readcharfun)->charpos++;
235
236 return c;
237 }
238
239 if (EQ (readcharfun, Qlambda))
240 {
241 readbyte = readbyte_for_lambda;
242 goto read_multibyte;
243 }
244
245 if (EQ (readcharfun, Qget_file_char))
246 {
247 readbyte = readbyte_from_file;
248 goto read_multibyte;
249 }
250
251 if (STRINGP (readcharfun))
252 {
253 if (read_from_string_index >= read_from_string_limit)
254 c = -1;
255 else if (STRING_MULTIBYTE (readcharfun))
256 {
257 if (multibyte)
258 *multibyte = 1;
259 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c, readcharfun,
260 read_from_string_index,
261 read_from_string_index_byte);
262 }
263 else
264 {
265 c = SREF (readcharfun, read_from_string_index_byte);
266 read_from_string_index++;
267 read_from_string_index_byte++;
268 }
269 return c;
270 }
271
272 if (CONSP (readcharfun) && STRINGP (XCAR (readcharfun)))
273 {
274 /* This is the case that read_vector is reading from a unibyte
275 string that contains a byte sequence previously skipped
276 because of #@NUMBER. The car part of readcharfun is that
277 string, and the cdr part is a value of readcharfun given to
278 read_vector. */
279 readbyte = readbyte_from_string;
280 if (EQ (XCDR (readcharfun), Qget_emacs_mule_file_char))
281 emacs_mule_encoding = 1;
282 goto read_multibyte;
283 }
284
285 if (EQ (readcharfun, Qget_emacs_mule_file_char))
286 {
287 readbyte = readbyte_from_file;
288 emacs_mule_encoding = 1;
289 goto read_multibyte;
290 }
291
292 tem = call0 (readcharfun);
293
294 if (NILP (tem))
295 return -1;
296 return XINT (tem);
297
298 read_multibyte:
299 if (unread_char >= 0)
300 {
301 c = unread_char;
302 unread_char = -1;
303 return c;
304 }
305 c = (*readbyte) (-1, readcharfun);
306 if (c < 0)
307 return c;
308 if (multibyte)
309 *multibyte = 1;
310 if (ASCII_CHAR_P (c))
311 return c;
312 if (emacs_mule_encoding)
313 return read_emacs_mule_char (c, readbyte, readcharfun);
314 i = 0;
315 buf[i++] = c;
316 len = BYTES_BY_CHAR_HEAD (c);
317 while (i < len)
318 {
319 c = (*readbyte) (-1, readcharfun);
320 if (c < 0 || ! TRAILING_CODE_P (c))
321 {
322 while (--i > 1)
323 (*readbyte) (buf[i], readcharfun);
324 return BYTE8_TO_CHAR (buf[0]);
325 }
326 buf[i++] = c;
327 }
328 return STRING_CHAR (buf);
329 }
330
331 #define FROM_FILE_P(readcharfun) \
332 (EQ (readcharfun, Qget_file_char) \
333 || EQ (readcharfun, Qget_emacs_mule_file_char))
334
335 static void
336 skip_dyn_bytes (Lisp_Object readcharfun, ptrdiff_t n)
337 {
338 if (FROM_FILE_P (readcharfun))
339 {
340 block_input (); /* FIXME: Not sure if it's needed. */
341 fseek (instream, n, SEEK_CUR);
342 unblock_input ();
343 }
344 else
345 { /* We're not reading directly from a file. In that case, it's difficult
346 to reliably count bytes, since these are usually meant for the file's
347 encoding, whereas we're now typically in the internal encoding.
348 But luckily, skip_dyn_bytes is used to skip over a single
349 dynamic-docstring (or dynamic byte-code) which is always quoted such
350 that \037 is the final char. */
351 int c;
352 do {
353 c = READCHAR;
354 } while (c >= 0 && c != '\037');
355 }
356 }
357
358 static void
359 skip_dyn_eof (Lisp_Object readcharfun)
360 {
361 if (FROM_FILE_P (readcharfun))
362 {
363 block_input (); /* FIXME: Not sure if it's needed. */
364 fseek (instream, 0, SEEK_END);
365 unblock_input ();
366 }
367 else
368 while (READCHAR >= 0);
369 }
370
371 /* Unread the character C in the way appropriate for the stream READCHARFUN.
372 If the stream is a user function, call it with the char as argument. */
373
374 static void
375 unreadchar (Lisp_Object readcharfun, int c)
376 {
377 readchar_count--;
378 if (c == -1)
379 /* Don't back up the pointer if we're unreading the end-of-input mark,
380 since readchar didn't advance it when we read it. */
381 ;
382 else if (BUFFERP (readcharfun))
383 {
384 struct buffer *b = XBUFFER (readcharfun);
385 ptrdiff_t charpos = BUF_PT (b);
386 ptrdiff_t bytepos = BUF_PT_BYTE (b);
387
388 if (! NILP (BVAR (b, enable_multibyte_characters)))
389 BUF_DEC_POS (b, bytepos);
390 else
391 bytepos--;
392
393 SET_BUF_PT_BOTH (b, charpos - 1, bytepos);
394 }
395 else if (MARKERP (readcharfun))
396 {
397 struct buffer *b = XMARKER (readcharfun)->buffer;
398 ptrdiff_t bytepos = XMARKER (readcharfun)->bytepos;
399
400 XMARKER (readcharfun)->charpos--;
401 if (! NILP (BVAR (b, enable_multibyte_characters)))
402 BUF_DEC_POS (b, bytepos);
403 else
404 bytepos--;
405
406 XMARKER (readcharfun)->bytepos = bytepos;
407 }
408 else if (STRINGP (readcharfun))
409 {
410 read_from_string_index--;
411 read_from_string_index_byte
412 = string_char_to_byte (readcharfun, read_from_string_index);
413 }
414 else if (CONSP (readcharfun) && STRINGP (XCAR (readcharfun)))
415 {
416 unread_char = c;
417 }
418 else if (EQ (readcharfun, Qlambda))
419 {
420 unread_char = c;
421 }
422 else if (FROM_FILE_P (readcharfun))
423 {
424 unread_char = c;
425 }
426 else
427 call1 (readcharfun, make_number (c));
428 }
429
430 static int
431 readbyte_for_lambda (int c, Lisp_Object readcharfun)
432 {
433 return read_bytecode_char (c >= 0);
434 }
435
436
437 static int
438 readbyte_from_file (int c, Lisp_Object readcharfun)
439 {
440 if (c >= 0)
441 {
442 block_input ();
443 ungetc (c, instream);
444 unblock_input ();
445 return 0;
446 }
447
448 block_input ();
449 c = getc (instream);
450
451 /* Interrupted reads have been observed while reading over the network. */
452 while (c == EOF && ferror (instream) && errno == EINTR)
453 {
454 unblock_input ();
455 QUIT;
456 block_input ();
457 clearerr (instream);
458 c = getc (instream);
459 }
460
461 unblock_input ();
462
463 return (c == EOF ? -1 : c);
464 }
465
466 static int
467 readbyte_from_string (int c, Lisp_Object readcharfun)
468 {
469 Lisp_Object string = XCAR (readcharfun);
470
471 if (c >= 0)
472 {
473 read_from_string_index--;
474 read_from_string_index_byte
475 = string_char_to_byte (string, read_from_string_index);
476 }
477
478 if (read_from_string_index >= read_from_string_limit)
479 c = -1;
480 else
481 FETCH_STRING_CHAR_ADVANCE (c, string,
482 read_from_string_index,
483 read_from_string_index_byte);
484 return c;
485 }
486
487
488 /* Read one non-ASCII character from INSTREAM. The character is
489 encoded in `emacs-mule' and the first byte is already read in
490 C. */
491
492 static int
493 read_emacs_mule_char (int c, int (*readbyte) (int, Lisp_Object), Lisp_Object readcharfun)
494 {
495 /* Emacs-mule coding uses at most 4-byte for one character. */
496 unsigned char buf[4];
497 int len = emacs_mule_bytes[c];
498 struct charset *charset;
499 int i;
500 unsigned code;
501
502 if (len == 1)
503 /* C is not a valid leading-code of `emacs-mule'. */
504 return BYTE8_TO_CHAR (c);
505
506 i = 0;
507 buf[i++] = c;
508 while (i < len)
509 {
510 c = (*readbyte) (-1, readcharfun);
511 if (c < 0xA0)
512 {
513 while (--i > 1)
514 (*readbyte) (buf[i], readcharfun);
515 return BYTE8_TO_CHAR (buf[0]);
516 }
517 buf[i++] = c;
518 }
519
520 if (len == 2)
521 {
522 charset = CHARSET_FROM_ID (emacs_mule_charset[buf[0]]);
523 code = buf[1] & 0x7F;
524 }
525 else if (len == 3)
526 {
527 if (buf[0] == EMACS_MULE_LEADING_CODE_PRIVATE_11
528 || buf[0] == EMACS_MULE_LEADING_CODE_PRIVATE_12)
529 {
530 charset = CHARSET_FROM_ID (emacs_mule_charset[buf[1]]);
531 code = buf[2] & 0x7F;
532 }
533 else
534 {
535 charset = CHARSET_FROM_ID (emacs_mule_charset[buf[0]]);
536 code = ((buf[1] << 8) | buf[2]) & 0x7F7F;
537 }
538 }
539 else
540 {
541 charset = CHARSET_FROM_ID (emacs_mule_charset[buf[1]]);
542 code = ((buf[2] << 8) | buf[3]) & 0x7F7F;
543 }
544 c = DECODE_CHAR (charset, code);
545 if (c < 0)
546 Fsignal (Qinvalid_read_syntax,
547 list1 (build_string ("invalid multibyte form")));
548 return c;
549 }
550
551
552 static Lisp_Object read_internal_start (Lisp_Object, Lisp_Object,
553 Lisp_Object);
554 static Lisp_Object read0 (Lisp_Object);
555 static Lisp_Object read1 (Lisp_Object, int *, bool);
556
557 static Lisp_Object read_list (bool, Lisp_Object);
558 static Lisp_Object read_vector (Lisp_Object, bool);
559
560 static Lisp_Object substitute_object_recurse (Lisp_Object, Lisp_Object,
561 Lisp_Object);
562 static void substitute_object_in_subtree (Lisp_Object,
563 Lisp_Object);
564 static void substitute_in_interval (INTERVAL, Lisp_Object);
565
566 \f
567 /* Get a character from the tty. */
568
569 /* Read input events until we get one that's acceptable for our purposes.
570
571 If NO_SWITCH_FRAME, switch-frame events are stashed
572 until we get a character we like, and then stuffed into
573 unread_switch_frame.
574
575 If ASCII_REQUIRED, check function key events to see
576 if the unmodified version of the symbol has a Qascii_character
577 property, and use that character, if present.
578
579 If ERROR_NONASCII, signal an error if the input we
580 get isn't an ASCII character with modifiers. If it's false but
581 ASCII_REQUIRED is true, just re-read until we get an ASCII
582 character.
583
584 If INPUT_METHOD, invoke the current input method
585 if the character warrants that.
586
587 If SECONDS is a number, wait that many seconds for input, and
588 return Qnil if no input arrives within that time. */
589
590 static Lisp_Object
591 read_filtered_event (bool no_switch_frame, bool ascii_required,
592 bool error_nonascii, bool input_method, Lisp_Object seconds)
593 {
594 Lisp_Object val, delayed_switch_frame;
595 struct timespec end_time;
596
597 #ifdef HAVE_WINDOW_SYSTEM
598 if (display_hourglass_p)
599 cancel_hourglass ();
600 #endif
601
602 delayed_switch_frame = Qnil;
603
604 /* Compute timeout. */
605 if (NUMBERP (seconds))
606 {
607 double duration = extract_float (seconds);
608 struct timespec wait_time = dtotimespec (duration);
609 end_time = timespec_add (current_timespec (), wait_time);
610 }
611
612 /* Read until we get an acceptable event. */
613 retry:
614 do
615 val = read_char (0, Qnil, (input_method ? Qnil : Qt), 0,
616 NUMBERP (seconds) ? &end_time : NULL);
617 while (INTEGERP (val) && XINT (val) == -2); /* wrong_kboard_jmpbuf */
618
619 if (BUFFERP (val))
620 goto retry;
621
622 /* `switch-frame' events are put off until after the next ASCII
623 character. This is better than signaling an error just because
624 the last characters were typed to a separate minibuffer frame,
625 for example. Eventually, some code which can deal with
626 switch-frame events will read it and process it. */
627 if (no_switch_frame
628 && EVENT_HAS_PARAMETERS (val)
629 && EQ (EVENT_HEAD_KIND (EVENT_HEAD (val)), Qswitch_frame))
630 {
631 delayed_switch_frame = val;
632 goto retry;
633 }
634
635 if (ascii_required && !(NUMBERP (seconds) && NILP (val)))
636 {
637 /* Convert certain symbols to their ASCII equivalents. */
638 if (SYMBOLP (val))
639 {
640 Lisp_Object tem, tem1;
641 tem = Fget (val, Qevent_symbol_element_mask);
642 if (!NILP (tem))
643 {
644 tem1 = Fget (Fcar (tem), Qascii_character);
645 /* Merge this symbol's modifier bits
646 with the ASCII equivalent of its basic code. */
647 if (!NILP (tem1))
648 XSETFASTINT (val, XINT (tem1) | XINT (Fcar (Fcdr (tem))));
649 }
650 }
651
652 /* If we don't have a character now, deal with it appropriately. */
653 if (!INTEGERP (val))
654 {
655 if (error_nonascii)
656 {
657 Vunread_command_events = list1 (val);
658 error ("Non-character input-event");
659 }
660 else
661 goto retry;
662 }
663 }
664
665 if (! NILP (delayed_switch_frame))
666 unread_switch_frame = delayed_switch_frame;
667
668 #if 0
669
670 #ifdef HAVE_WINDOW_SYSTEM
671 if (display_hourglass_p)
672 start_hourglass ();
673 #endif
674
675 #endif
676
677 return val;
678 }
679
680 DEFUN ("read-char", Fread_char, Sread_char, 0, 3, 0,
681 doc: /* Read a character from the command input (keyboard or macro).
682 It is returned as a number.
683 If the character has modifiers, they are resolved and reflected to the
684 character code if possible (e.g. C-SPC -> 0).
685
686 If the user generates an event which is not a character (i.e. a mouse
687 click or function key event), `read-char' signals an error. As an
688 exception, switch-frame events are put off until non-character events
689 can be read.
690 If you want to read non-character events, or ignore them, call
691 `read-event' or `read-char-exclusive' instead.
692
693 If the optional argument PROMPT is non-nil, display that as a prompt.
694 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
695 input method is turned on in the current buffer, that input method
696 is used for reading a character.
697 If the optional argument SECONDS is non-nil, it should be a number
698 specifying the maximum number of seconds to wait for input. If no
699 input arrives in that time, return nil. SECONDS may be a
700 floating-point value. */)
701 (Lisp_Object prompt, Lisp_Object inherit_input_method, Lisp_Object seconds)
702 {
703 Lisp_Object val;
704
705 if (! NILP (prompt))
706 message_with_string ("%s", prompt, 0);
707 val = read_filtered_event (1, 1, 1, ! NILP (inherit_input_method), seconds);
708
709 return (NILP (val) ? Qnil
710 : make_number (char_resolve_modifier_mask (XINT (val))));
711 }
712
713 DEFUN ("read-event", Fread_event, Sread_event, 0, 3, 0,
714 doc: /* Read an event object from the input stream.
715 If the optional argument PROMPT is non-nil, display that as a prompt.
716 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
717 input method is turned on in the current buffer, that input method
718 is used for reading a character.
719 If the optional argument SECONDS is non-nil, it should be a number
720 specifying the maximum number of seconds to wait for input. If no
721 input arrives in that time, return nil. SECONDS may be a
722 floating-point value. */)
723 (Lisp_Object prompt, Lisp_Object inherit_input_method, Lisp_Object seconds)
724 {
725 if (! NILP (prompt))
726 message_with_string ("%s", prompt, 0);
727 return read_filtered_event (0, 0, 0, ! NILP (inherit_input_method), seconds);
728 }
729
730 DEFUN ("read-char-exclusive", Fread_char_exclusive, Sread_char_exclusive, 0, 3, 0,
731 doc: /* Read a character from the command input (keyboard or macro).
732 It is returned as a number. Non-character events are ignored.
733 If the character has modifiers, they are resolved and reflected to the
734 character code if possible (e.g. C-SPC -> 0).
735
736 If the optional argument PROMPT is non-nil, display that as a prompt.
737 If the optional argument INHERIT-INPUT-METHOD is non-nil and some
738 input method is turned on in the current buffer, that input method
739 is used for reading a character.
740 If the optional argument SECONDS is non-nil, it should be a number
741 specifying the maximum number of seconds to wait for input. If no
742 input arrives in that time, return nil. SECONDS may be a
743 floating-point value. */)
744 (Lisp_Object prompt, Lisp_Object inherit_input_method, Lisp_Object seconds)
745 {
746 Lisp_Object val;
747
748 if (! NILP (prompt))
749 message_with_string ("%s", prompt, 0);
750
751 val = read_filtered_event (1, 1, 0, ! NILP (inherit_input_method), seconds);
752
753 return (NILP (val) ? Qnil
754 : make_number (char_resolve_modifier_mask (XINT (val))));
755 }
756
757 DEFUN ("get-file-char", Fget_file_char, Sget_file_char, 0, 0, 0,
758 doc: /* Don't use this yourself. */)
759 (void)
760 {
761 register Lisp_Object val;
762 block_input ();
763 XSETINT (val, getc (instream));
764 unblock_input ();
765 return val;
766 }
767
768
769 \f
770
771 /* Return true if the lisp code read using READCHARFUN defines a non-nil
772 `lexical-binding' file variable. After returning, the stream is
773 positioned following the first line, if it is a comment or #! line,
774 otherwise nothing is read. */
775
776 static bool
777 lisp_file_lexically_bound_p (Lisp_Object readcharfun)
778 {
779 int ch = READCHAR;
780
781 if (ch == '#')
782 {
783 ch = READCHAR;
784 if (ch != '!')
785 {
786 UNREAD (ch);
787 UNREAD ('#');
788 return 0;
789 }
790 while (ch != '\n' && ch != EOF)
791 ch = READCHAR;
792 if (ch == '\n') ch = READCHAR;
793 /* It is OK to leave the position after a #! line, since
794 that is what read1 does. */
795 }
796
797 if (ch != ';')
798 /* The first line isn't a comment, just give up. */
799 {
800 UNREAD (ch);
801 return 0;
802 }
803 else
804 /* Look for an appropriate file-variable in the first line. */
805 {
806 bool rv = 0;
807 enum {
808 NOMINAL, AFTER_FIRST_DASH, AFTER_ASTERIX
809 } beg_end_state = NOMINAL;
810 bool in_file_vars = 0;
811
812 #define UPDATE_BEG_END_STATE(ch) \
813 if (beg_end_state == NOMINAL) \
814 beg_end_state = (ch == '-' ? AFTER_FIRST_DASH : NOMINAL); \
815 else if (beg_end_state == AFTER_FIRST_DASH) \
816 beg_end_state = (ch == '*' ? AFTER_ASTERIX : NOMINAL); \
817 else if (beg_end_state == AFTER_ASTERIX) \
818 { \
819 if (ch == '-') \
820 in_file_vars = !in_file_vars; \
821 beg_end_state = NOMINAL; \
822 }
823
824 /* Skip until we get to the file vars, if any. */
825 do
826 {
827 ch = READCHAR;
828 UPDATE_BEG_END_STATE (ch);
829 }
830 while (!in_file_vars && ch != '\n' && ch != EOF);
831
832 while (in_file_vars)
833 {
834 char var[100], val[100];
835 unsigned i;
836
837 ch = READCHAR;
838
839 /* Read a variable name. */
840 while (ch == ' ' || ch == '\t')
841 ch = READCHAR;
842
843 i = 0;
844 while (ch != ':' && ch != '\n' && ch != EOF && in_file_vars)
845 {
846 if (i < sizeof var - 1)
847 var[i++] = ch;
848 UPDATE_BEG_END_STATE (ch);
849 ch = READCHAR;
850 }
851
852 /* Stop scanning if no colon was found before end marker. */
853 if (!in_file_vars || ch == '\n' || ch == EOF)
854 break;
855
856 while (i > 0 && (var[i - 1] == ' ' || var[i - 1] == '\t'))
857 i--;
858 var[i] = '\0';
859
860 if (ch == ':')
861 {
862 /* Read a variable value. */
863 ch = READCHAR;
864
865 while (ch == ' ' || ch == '\t')
866 ch = READCHAR;
867
868 i = 0;
869 while (ch != ';' && ch != '\n' && ch != EOF && in_file_vars)
870 {
871 if (i < sizeof val - 1)
872 val[i++] = ch;
873 UPDATE_BEG_END_STATE (ch);
874 ch = READCHAR;
875 }
876 if (! in_file_vars)
877 /* The value was terminated by an end-marker, which remove. */
878 i -= 3;
879 while (i > 0 && (val[i - 1] == ' ' || val[i - 1] == '\t'))
880 i--;
881 val[i] = '\0';
882
883 if (strcmp (var, "lexical-binding") == 0)
884 /* This is it... */
885 {
886 rv = (strcmp (val, "nil") != 0);
887 break;
888 }
889 }
890 }
891
892 while (ch != '\n' && ch != EOF)
893 ch = READCHAR;
894
895 return rv;
896 }
897 }
898 \f
899 /* Value is a version number of byte compiled code if the file
900 associated with file descriptor FD is a compiled Lisp file that's
901 safe to load. Only files compiled with Emacs are safe to load.
902 Files compiled with XEmacs can lead to a crash in Fbyte_code
903 because of an incompatible change in the byte compiler. */
904
905 static int
906 safe_to_load_version (int fd)
907 {
908 char buf[512];
909 int nbytes, i;
910 int version = 1;
911
912 /* Read the first few bytes from the file, and look for a line
913 specifying the byte compiler version used. */
914 nbytes = emacs_read (fd, buf, sizeof buf);
915 if (nbytes > 0)
916 {
917 /* Skip to the next newline, skipping over the initial `ELC'
918 with NUL bytes following it, but note the version. */
919 for (i = 0; i < nbytes && buf[i] != '\n'; ++i)
920 if (i == 4)
921 version = buf[i];
922
923 if (i >= nbytes
924 || fast_c_string_match_ignore_case (Vbytecomp_version_regexp,
925 buf + i, nbytes - i) < 0)
926 version = 0;
927 }
928
929 lseek (fd, 0, SEEK_SET);
930 return version;
931 }
932
933
934 /* Callback for record_unwind_protect. Restore the old load list OLD,
935 after loading a file successfully. */
936
937 static void
938 record_load_unwind (Lisp_Object old)
939 {
940 Vloads_in_progress = old;
941 }
942
943 /* This handler function is used via internal_condition_case_1. */
944
945 static Lisp_Object
946 load_error_handler (Lisp_Object data)
947 {
948 return Qnil;
949 }
950
951 static void
952 load_warn_old_style_backquotes (Lisp_Object file)
953 {
954 if (!NILP (Vold_style_backquotes))
955 {
956 AUTO_STRING (format, "Loading `%s': old-style backquotes detected!");
957 CALLN (Fmessage, format, file);
958 }
959 }
960
961 DEFUN ("get-load-suffixes", Fget_load_suffixes, Sget_load_suffixes, 0, 0, 0,
962 doc: /* Return the suffixes that `load' should try if a suffix is \
963 required.
964 This uses the variables `load-suffixes' and `load-file-rep-suffixes'. */)
965 (void)
966 {
967 Lisp_Object lst = Qnil, suffixes = Vload_suffixes, suffix, ext;
968 while (CONSP (suffixes))
969 {
970 Lisp_Object exts = Vload_file_rep_suffixes;
971 suffix = XCAR (suffixes);
972 suffixes = XCDR (suffixes);
973 while (CONSP (exts))
974 {
975 ext = XCAR (exts);
976 exts = XCDR (exts);
977 lst = Fcons (concat2 (suffix, ext), lst);
978 }
979 }
980 return Fnreverse (lst);
981 }
982
983 /* Returns true if STRING ends with SUFFIX */
984 static bool
985 suffix_p (Lisp_Object string, const char *suffix)
986 {
987 ptrdiff_t suffix_len = strlen (suffix);
988 ptrdiff_t string_len = SBYTES (string);
989
990 return string_len >= suffix_len && !strcmp (SSDATA (string) + string_len - suffix_len, suffix);
991 }
992
993 DEFUN ("load", Fload, Sload, 1, 5, 0,
994 doc: /* Execute a file of Lisp code named FILE.
995 First try FILE with `.elc' appended, then try with `.el', then try
996 with a system-dependent suffix of dynamic modules (see `load-suffixes'),
997 then try FILE unmodified (the exact suffixes in the exact order are
998 determined by `load-suffixes'). Environment variable references in
999 FILE are replaced with their values by calling `substitute-in-file-name'.
1000 This function searches the directories in `load-path'.
1001
1002 If optional second arg NOERROR is non-nil,
1003 report no error if FILE doesn't exist.
1004 Print messages at start and end of loading unless
1005 optional third arg NOMESSAGE is non-nil (but `force-load-messages'
1006 overrides that).
1007 If optional fourth arg NOSUFFIX is non-nil, don't try adding
1008 suffixes to the specified name FILE.
1009 If optional fifth arg MUST-SUFFIX is non-nil, insist on
1010 the suffix `.elc' or `.el' or the module suffix; don't accept just
1011 FILE unless it ends in one of those suffixes or includes a directory name.
1012
1013 If NOSUFFIX is nil, then if a file could not be found, try looking for
1014 a different representation of the file by adding non-empty suffixes to
1015 its name, before trying another file. Emacs uses this feature to find
1016 compressed versions of files when Auto Compression mode is enabled.
1017 If NOSUFFIX is non-nil, disable this feature.
1018
1019 The suffixes that this function tries out, when NOSUFFIX is nil, are
1020 given by the return value of `get-load-suffixes' and the values listed
1021 in `load-file-rep-suffixes'. If MUST-SUFFIX is non-nil, only the
1022 return value of `get-load-suffixes' is used, i.e. the file name is
1023 required to have a non-empty suffix.
1024
1025 When searching suffixes, this function normally stops at the first
1026 one that exists. If the option `load-prefer-newer' is non-nil,
1027 however, it tries all suffixes, and uses whichever file is the newest.
1028
1029 Loading a file records its definitions, and its `provide' and
1030 `require' calls, in an element of `load-history' whose
1031 car is the file name loaded. See `load-history'.
1032
1033 While the file is in the process of being loaded, the variable
1034 `load-in-progress' is non-nil and the variable `load-file-name'
1035 is bound to the file's name.
1036
1037 Return t if the file exists and loads successfully. */)
1038 (Lisp_Object file, Lisp_Object noerror, Lisp_Object nomessage,
1039 Lisp_Object nosuffix, Lisp_Object must_suffix)
1040 {
1041 FILE *stream;
1042 int fd;
1043 int fd_index UNINIT;
1044 ptrdiff_t count = SPECPDL_INDEX ();
1045 Lisp_Object found, efound, hist_file_name;
1046 /* True means we printed the ".el is newer" message. */
1047 bool newer = 0;
1048 /* True means we are loading a compiled file. */
1049 bool compiled = 0;
1050 Lisp_Object handler;
1051 bool safe_p = 1;
1052 const char *fmode = "r" FOPEN_TEXT;
1053 int version;
1054
1055 CHECK_STRING (file);
1056
1057 /* If file name is magic, call the handler. */
1058 /* This shouldn't be necessary any more now that `openp' handles it right.
1059 handler = Ffind_file_name_handler (file, Qload);
1060 if (!NILP (handler))
1061 return call5 (handler, Qload, file, noerror, nomessage, nosuffix); */
1062
1063 /* The presence of this call is the result of a historical accident:
1064 it used to be in every file-operation and when it got removed
1065 everywhere, it accidentally stayed here. Since then, enough people
1066 supposedly have things like (load "$PROJECT/foo.el") in their .emacs
1067 that it seemed risky to remove. */
1068 if (! NILP (noerror))
1069 {
1070 file = internal_condition_case_1 (Fsubstitute_in_file_name, file,
1071 Qt, load_error_handler);
1072 if (NILP (file))
1073 return Qnil;
1074 }
1075 else
1076 file = Fsubstitute_in_file_name (file);
1077
1078 /* Avoid weird lossage with null string as arg,
1079 since it would try to load a directory as a Lisp file. */
1080 if (SCHARS (file) == 0)
1081 {
1082 fd = -1;
1083 errno = ENOENT;
1084 }
1085 else
1086 {
1087 Lisp_Object suffixes;
1088 found = Qnil;
1089
1090 if (! NILP (must_suffix))
1091 {
1092 /* Don't insist on adding a suffix if FILE already ends with one. */
1093 if (suffix_p (file, ".el")
1094 || suffix_p (file, ".elc")
1095 #ifdef HAVE_MODULES
1096 || suffix_p (file, MODULES_SUFFIX)
1097 #endif
1098 )
1099 must_suffix = Qnil;
1100 /* Don't insist on adding a suffix
1101 if the argument includes a directory name. */
1102 else if (! NILP (Ffile_name_directory (file)))
1103 must_suffix = Qnil;
1104 }
1105
1106 if (!NILP (nosuffix))
1107 suffixes = Qnil;
1108 else
1109 {
1110 suffixes = Fget_load_suffixes ();
1111 if (NILP (must_suffix))
1112 suffixes = CALLN (Fappend, suffixes, Vload_file_rep_suffixes);
1113 }
1114
1115 fd = openp (Vload_path, file, suffixes, &found, Qnil, load_prefer_newer);
1116 }
1117
1118 if (fd == -1)
1119 {
1120 if (NILP (noerror))
1121 report_file_error ("Cannot open load file", file);
1122 return Qnil;
1123 }
1124
1125 /* Tell startup.el whether or not we found the user's init file. */
1126 if (EQ (Qt, Vuser_init_file))
1127 Vuser_init_file = found;
1128
1129 /* If FD is -2, that means openp found a magic file. */
1130 if (fd == -2)
1131 {
1132 if (NILP (Fequal (found, file)))
1133 /* If FOUND is a different file name from FILE,
1134 find its handler even if we have already inhibited
1135 the `load' operation on FILE. */
1136 handler = Ffind_file_name_handler (found, Qt);
1137 else
1138 handler = Ffind_file_name_handler (found, Qload);
1139 if (! NILP (handler))
1140 return call5 (handler, Qload, found, noerror, nomessage, Qt);
1141 #ifdef DOS_NT
1142 /* Tramp has to deal with semi-broken packages that prepend
1143 drive letters to remote files. For that reason, Tramp
1144 catches file operations that test for file existence, which
1145 makes openp think X:/foo.elc files are remote. However,
1146 Tramp does not catch `load' operations for such files, so we
1147 end up with a nil as the `load' handler above. If we would
1148 continue with fd = -2, we will behave wrongly, and in
1149 particular try reading a .elc file in the "rt" mode instead
1150 of "rb". See bug #9311 for the results. To work around
1151 this, we try to open the file locally, and go with that if it
1152 succeeds. */
1153 fd = emacs_open (SSDATA (ENCODE_FILE (found)), O_RDONLY, 0);
1154 if (fd == -1)
1155 fd = -2;
1156 #endif
1157 }
1158
1159 if (0 <= fd)
1160 {
1161 fd_index = SPECPDL_INDEX ();
1162 record_unwind_protect_int (close_file_unwind, fd);
1163 }
1164
1165 #ifdef HAVE_MODULES
1166 if (suffix_p (found, MODULES_SUFFIX))
1167 return unbind_to (count, Fmodule_load (found));
1168 #endif
1169
1170 /* Check if we're stuck in a recursive load cycle.
1171
1172 2000-09-21: It's not possible to just check for the file loaded
1173 being a member of Vloads_in_progress. This fails because of the
1174 way the byte compiler currently works; `provide's are not
1175 evaluated, see font-lock.el/jit-lock.el as an example. This
1176 leads to a certain amount of ``normal'' recursion.
1177
1178 Also, just loading a file recursively is not always an error in
1179 the general case; the second load may do something different. */
1180 {
1181 int load_count = 0;
1182 Lisp_Object tem;
1183 for (tem = Vloads_in_progress; CONSP (tem); tem = XCDR (tem))
1184 if (!NILP (Fequal (found, XCAR (tem))) && (++load_count > 3))
1185 signal_error ("Recursive load", Fcons (found, Vloads_in_progress));
1186 record_unwind_protect (record_load_unwind, Vloads_in_progress);
1187 Vloads_in_progress = Fcons (found, Vloads_in_progress);
1188 }
1189
1190 /* All loads are by default dynamic, unless the file itself specifies
1191 otherwise using a file-variable in the first line. This is bound here
1192 so that it takes effect whether or not we use
1193 Vload_source_file_function. */
1194 specbind (Qlexical_binding, Qnil);
1195
1196 /* Get the name for load-history. */
1197 hist_file_name = (! NILP (Vpurify_flag)
1198 ? concat2 (Ffile_name_directory (file),
1199 Ffile_name_nondirectory (found))
1200 : found) ;
1201
1202 version = -1;
1203
1204 /* Check for the presence of old-style quotes and warn about them. */
1205 specbind (Qold_style_backquotes, Qnil);
1206 record_unwind_protect (load_warn_old_style_backquotes, file);
1207
1208 if (suffix_p (found, ".elc") || (fd >= 0 && (version = safe_to_load_version (fd)) > 0))
1209 /* Load .elc files directly, but not when they are
1210 remote and have no handler! */
1211 {
1212 if (fd != -2)
1213 {
1214 struct stat s1, s2;
1215 int result;
1216
1217 if (version < 0
1218 && ! (version = safe_to_load_version (fd)))
1219 {
1220 safe_p = 0;
1221 if (!load_dangerous_libraries)
1222 error ("File `%s' was not compiled in Emacs", SDATA (found));
1223 else if (!NILP (nomessage) && !force_load_messages)
1224 message_with_string ("File `%s' not compiled in Emacs", found, 1);
1225 }
1226
1227 compiled = 1;
1228
1229 efound = ENCODE_FILE (found);
1230 fmode = "r" FOPEN_BINARY;
1231
1232 /* openp already checked for newness, no point doing it again.
1233 FIXME would be nice to get a message when openp
1234 ignores suffix order due to load_prefer_newer. */
1235 if (!load_prefer_newer)
1236 {
1237 result = stat (SSDATA (efound), &s1);
1238 if (result == 0)
1239 {
1240 SSET (efound, SBYTES (efound) - 1, 0);
1241 result = stat (SSDATA (efound), &s2);
1242 SSET (efound, SBYTES (efound) - 1, 'c');
1243 }
1244
1245 if (result == 0
1246 && timespec_cmp (get_stat_mtime (&s1), get_stat_mtime (&s2)) < 0)
1247 {
1248 /* Make the progress messages mention that source is newer. */
1249 newer = 1;
1250
1251 /* If we won't print another message, mention this anyway. */
1252 if (!NILP (nomessage) && !force_load_messages)
1253 {
1254 Lisp_Object msg_file;
1255 msg_file = Fsubstring (found, make_number (0), make_number (-1));
1256 message_with_string ("Source file `%s' newer than byte-compiled file",
1257 msg_file, 1);
1258 }
1259 }
1260 } /* !load_prefer_newer */
1261 }
1262 }
1263 else
1264 {
1265 /* We are loading a source file (*.el). */
1266 if (!NILP (Vload_source_file_function))
1267 {
1268 Lisp_Object val;
1269
1270 if (fd >= 0)
1271 {
1272 emacs_close (fd);
1273 clear_unwind_protect (fd_index);
1274 }
1275 val = call4 (Vload_source_file_function, found, hist_file_name,
1276 NILP (noerror) ? Qnil : Qt,
1277 (NILP (nomessage) || force_load_messages) ? Qnil : Qt);
1278 return unbind_to (count, val);
1279 }
1280 }
1281
1282 if (fd < 0)
1283 {
1284 /* We somehow got here with fd == -2, meaning the file is deemed
1285 to be remote. Don't even try to reopen the file locally;
1286 just force a failure. */
1287 stream = NULL;
1288 errno = EINVAL;
1289 }
1290 else
1291 {
1292 #ifdef WINDOWSNT
1293 emacs_close (fd);
1294 clear_unwind_protect (fd_index);
1295 efound = ENCODE_FILE (found);
1296 stream = emacs_fopen (SSDATA (efound), fmode);
1297 #else
1298 stream = fdopen (fd, fmode);
1299 #endif
1300 }
1301 if (! stream)
1302 report_file_error ("Opening stdio stream", file);
1303 set_unwind_protect_ptr (fd_index, fclose_unwind, stream);
1304
1305 if (! NILP (Vpurify_flag))
1306 Vpreloaded_file_list = Fcons (Fpurecopy (file), Vpreloaded_file_list);
1307
1308 if (NILP (nomessage) || force_load_messages)
1309 {
1310 if (!safe_p)
1311 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...",
1312 file, 1);
1313 else if (!compiled)
1314 message_with_string ("Loading %s (source)...", file, 1);
1315 else if (newer)
1316 message_with_string ("Loading %s (compiled; note, source file is newer)...",
1317 file, 1);
1318 else /* The typical case; compiled file newer than source file. */
1319 message_with_string ("Loading %s...", file, 1);
1320 }
1321
1322 specbind (Qload_file_name, found);
1323 specbind (Qinhibit_file_name_operation, Qnil);
1324 specbind (Qload_in_progress, Qt);
1325
1326 instream = stream;
1327 if (lisp_file_lexically_bound_p (Qget_file_char))
1328 Fset (Qlexical_binding, Qt);
1329
1330 if (! version || version >= 22)
1331 readevalloop (Qget_file_char, stream, hist_file_name,
1332 0, Qnil, Qnil, Qnil, Qnil);
1333 else
1334 {
1335 /* We can't handle a file which was compiled with
1336 byte-compile-dynamic by older version of Emacs. */
1337 specbind (Qload_force_doc_strings, Qt);
1338 readevalloop (Qget_emacs_mule_file_char, stream, hist_file_name,
1339 0, Qnil, Qnil, Qnil, Qnil);
1340 }
1341 unbind_to (count, Qnil);
1342
1343 /* Run any eval-after-load forms for this file. */
1344 if (!NILP (Ffboundp (Qdo_after_load_evaluation)))
1345 call1 (Qdo_after_load_evaluation, hist_file_name) ;
1346
1347 xfree (saved_doc_string);
1348 saved_doc_string = 0;
1349 saved_doc_string_size = 0;
1350
1351 xfree (prev_saved_doc_string);
1352 prev_saved_doc_string = 0;
1353 prev_saved_doc_string_size = 0;
1354
1355 if (!noninteractive && (NILP (nomessage) || force_load_messages))
1356 {
1357 if (!safe_p)
1358 message_with_string ("Loading %s (compiled; note unsafe, not compiled in Emacs)...done",
1359 file, 1);
1360 else if (!compiled)
1361 message_with_string ("Loading %s (source)...done", file, 1);
1362 else if (newer)
1363 message_with_string ("Loading %s (compiled; note, source file is newer)...done",
1364 file, 1);
1365 else /* The typical case; compiled file newer than source file. */
1366 message_with_string ("Loading %s...done", file, 1);
1367 }
1368
1369 return Qt;
1370 }
1371 \f
1372 static bool
1373 complete_filename_p (Lisp_Object pathname)
1374 {
1375 const unsigned char *s = SDATA (pathname);
1376 return (IS_DIRECTORY_SEP (s[0])
1377 || (SCHARS (pathname) > 2
1378 && IS_DEVICE_SEP (s[1]) && IS_DIRECTORY_SEP (s[2])));
1379 }
1380
1381 DEFUN ("locate-file-internal", Flocate_file_internal, Slocate_file_internal, 2, 4, 0,
1382 doc: /* Search for FILENAME through PATH.
1383 Returns the file's name in absolute form, or nil if not found.
1384 If SUFFIXES is non-nil, it should be a list of suffixes to append to
1385 file name when searching.
1386 If non-nil, PREDICATE is used instead of `file-readable-p'.
1387 PREDICATE can also be an integer to pass to the faccessat(2) function,
1388 in which case file-name-handlers are ignored.
1389 This function will normally skip directories, so if you want it to find
1390 directories, make sure the PREDICATE function returns `dir-ok' for them. */)
1391 (Lisp_Object filename, Lisp_Object path, Lisp_Object suffixes, Lisp_Object predicate)
1392 {
1393 Lisp_Object file;
1394 int fd = openp (path, filename, suffixes, &file, predicate, false);
1395 if (NILP (predicate) && fd >= 0)
1396 emacs_close (fd);
1397 return file;
1398 }
1399
1400 /* Search for a file whose name is STR, looking in directories
1401 in the Lisp list PATH, and trying suffixes from SUFFIX.
1402 On success, return a file descriptor (or 1 or -2 as described below).
1403 On failure, return -1 and set errno.
1404
1405 SUFFIXES is a list of strings containing possible suffixes.
1406 The empty suffix is automatically added if the list is empty.
1407
1408 PREDICATE t means the files are binary.
1409 PREDICATE non-nil and non-t means don't open the files,
1410 just look for one that satisfies the predicate. In this case,
1411 return 1 on success. The predicate can be a lisp function or
1412 an integer to pass to `access' (in which case file-name-handlers
1413 are ignored).
1414
1415 If STOREPTR is nonzero, it points to a slot where the name of
1416 the file actually found should be stored as a Lisp string.
1417 nil is stored there on failure.
1418
1419 If the file we find is remote, return -2
1420 but store the found remote file name in *STOREPTR.
1421
1422 If NEWER is true, try all SUFFIXes and return the result for the
1423 newest file that exists. Does not apply to remote files,
1424 or if a non-nil and non-t PREDICATE is specified. */
1425
1426 int
1427 openp (Lisp_Object path, Lisp_Object str, Lisp_Object suffixes,
1428 Lisp_Object *storeptr, Lisp_Object predicate, bool newer)
1429 {
1430 ptrdiff_t fn_size = 100;
1431 char buf[100];
1432 char *fn = buf;
1433 bool absolute;
1434 ptrdiff_t want_length;
1435 Lisp_Object filename;
1436 Lisp_Object string, tail, encoded_fn, save_string;
1437 ptrdiff_t max_suffix_len = 0;
1438 int last_errno = ENOENT;
1439 int save_fd = -1;
1440 USE_SAFE_ALLOCA;
1441
1442 /* The last-modified time of the newest matching file found.
1443 Initialize it to something less than all valid timestamps. */
1444 struct timespec save_mtime = make_timespec (TYPE_MINIMUM (time_t), -1);
1445
1446 CHECK_STRING (str);
1447
1448 for (tail = suffixes; CONSP (tail); tail = XCDR (tail))
1449 {
1450 CHECK_STRING_CAR (tail);
1451 max_suffix_len = max (max_suffix_len,
1452 SBYTES (XCAR (tail)));
1453 }
1454
1455 string = filename = encoded_fn = save_string = Qnil;
1456
1457 if (storeptr)
1458 *storeptr = Qnil;
1459
1460 absolute = complete_filename_p (str);
1461
1462 for (; CONSP (path); path = XCDR (path))
1463 {
1464 filename = Fexpand_file_name (str, XCAR (path));
1465 if (!complete_filename_p (filename))
1466 /* If there are non-absolute elts in PATH (eg "."). */
1467 /* Of course, this could conceivably lose if luser sets
1468 default-directory to be something non-absolute... */
1469 {
1470 filename = Fexpand_file_name (filename, BVAR (current_buffer, directory));
1471 if (!complete_filename_p (filename))
1472 /* Give up on this path element! */
1473 continue;
1474 }
1475
1476 /* Calculate maximum length of any filename made from
1477 this path element/specified file name and any possible suffix. */
1478 want_length = max_suffix_len + SBYTES (filename);
1479 if (fn_size <= want_length)
1480 {
1481 fn_size = 100 + want_length;
1482 fn = SAFE_ALLOCA (fn_size);
1483 }
1484
1485 /* Loop over suffixes. */
1486 for (tail = NILP (suffixes) ? list1 (empty_unibyte_string) : suffixes;
1487 CONSP (tail); tail = XCDR (tail))
1488 {
1489 Lisp_Object suffix = XCAR (tail);
1490 ptrdiff_t fnlen, lsuffix = SBYTES (suffix);
1491 Lisp_Object handler;
1492
1493 /* Concatenate path element/specified name with the suffix.
1494 If the directory starts with /:, remove that. */
1495 int prefixlen = ((SCHARS (filename) > 2
1496 && SREF (filename, 0) == '/'
1497 && SREF (filename, 1) == ':')
1498 ? 2 : 0);
1499 fnlen = SBYTES (filename) - prefixlen;
1500 memcpy (fn, SDATA (filename) + prefixlen, fnlen);
1501 memcpy (fn + fnlen, SDATA (suffix), lsuffix + 1);
1502 fnlen += lsuffix;
1503 /* Check that the file exists and is not a directory. */
1504 /* We used to only check for handlers on non-absolute file names:
1505 if (absolute)
1506 handler = Qnil;
1507 else
1508 handler = Ffind_file_name_handler (filename, Qfile_exists_p);
1509 It's not clear why that was the case and it breaks things like
1510 (load "/bar.el") where the file is actually "/bar.el.gz". */
1511 /* make_string has its own ideas on when to return a unibyte
1512 string and when a multibyte string, but we know better.
1513 We must have a unibyte string when dumping, since
1514 file-name encoding is shaky at best at that time, and in
1515 particular default-file-name-coding-system is reset
1516 several times during loadup. We therefore don't want to
1517 encode the file before passing it to file I/O library
1518 functions. */
1519 if (!STRING_MULTIBYTE (filename) && !STRING_MULTIBYTE (suffix))
1520 string = make_unibyte_string (fn, fnlen);
1521 else
1522 string = make_string (fn, fnlen);
1523 handler = Ffind_file_name_handler (string, Qfile_exists_p);
1524 if ((!NILP (handler) || (!NILP (predicate) && !EQ (predicate, Qt)))
1525 && !NATNUMP (predicate))
1526 {
1527 bool exists;
1528 if (NILP (predicate) || EQ (predicate, Qt))
1529 exists = !NILP (Ffile_readable_p (string));
1530 else
1531 {
1532 Lisp_Object tmp = call1 (predicate, string);
1533 if (NILP (tmp))
1534 exists = false;
1535 else if (EQ (tmp, Qdir_ok)
1536 || NILP (Ffile_directory_p (string)))
1537 exists = true;
1538 else
1539 {
1540 exists = false;
1541 last_errno = EISDIR;
1542 }
1543 }
1544
1545 if (exists)
1546 {
1547 /* We succeeded; return this descriptor and filename. */
1548 if (storeptr)
1549 *storeptr = string;
1550 SAFE_FREE ();
1551 return -2;
1552 }
1553 }
1554 else
1555 {
1556 int fd;
1557 const char *pfn;
1558 struct stat st;
1559
1560 encoded_fn = ENCODE_FILE (string);
1561 pfn = SSDATA (encoded_fn);
1562
1563 /* Check that we can access or open it. */
1564 if (NATNUMP (predicate))
1565 {
1566 fd = -1;
1567 if (INT_MAX < XFASTINT (predicate))
1568 last_errno = EINVAL;
1569 else if (faccessat (AT_FDCWD, pfn, XFASTINT (predicate),
1570 AT_EACCESS)
1571 == 0)
1572 {
1573 if (file_directory_p (pfn))
1574 last_errno = EISDIR;
1575 else
1576 fd = 1;
1577 }
1578 }
1579 else
1580 {
1581 fd = emacs_open (pfn, O_RDONLY, 0);
1582 if (fd < 0)
1583 {
1584 if (errno != ENOENT)
1585 last_errno = errno;
1586 }
1587 else
1588 {
1589 int err = (fstat (fd, &st) != 0 ? errno
1590 : S_ISDIR (st.st_mode) ? EISDIR : 0);
1591 if (err)
1592 {
1593 last_errno = err;
1594 emacs_close (fd);
1595 fd = -1;
1596 }
1597 }
1598 }
1599
1600 if (fd >= 0)
1601 {
1602 if (newer && !NATNUMP (predicate))
1603 {
1604 struct timespec mtime = get_stat_mtime (&st);
1605
1606 if (timespec_cmp (mtime, save_mtime) <= 0)
1607 emacs_close (fd);
1608 else
1609 {
1610 if (0 <= save_fd)
1611 emacs_close (save_fd);
1612 save_fd = fd;
1613 save_mtime = mtime;
1614 save_string = string;
1615 }
1616 }
1617 else
1618 {
1619 /* We succeeded; return this descriptor and filename. */
1620 if (storeptr)
1621 *storeptr = string;
1622 SAFE_FREE ();
1623 return fd;
1624 }
1625 }
1626
1627 /* No more suffixes. Return the newest. */
1628 if (0 <= save_fd && ! CONSP (XCDR (tail)))
1629 {
1630 if (storeptr)
1631 *storeptr = save_string;
1632 SAFE_FREE ();
1633 return save_fd;
1634 }
1635 }
1636 }
1637 if (absolute)
1638 break;
1639 }
1640
1641 SAFE_FREE ();
1642 errno = last_errno;
1643 return -1;
1644 }
1645
1646 \f
1647 /* Merge the list we've accumulated of globals from the current input source
1648 into the load_history variable. The details depend on whether
1649 the source has an associated file name or not.
1650
1651 FILENAME is the file name that we are loading from.
1652
1653 ENTIRE is true if loading that entire file, false if evaluating
1654 part of it. */
1655
1656 static void
1657 build_load_history (Lisp_Object filename, bool entire)
1658 {
1659 Lisp_Object tail, prev, newelt;
1660 Lisp_Object tem, tem2;
1661 bool foundit = 0;
1662
1663 tail = Vload_history;
1664 prev = Qnil;
1665
1666 while (CONSP (tail))
1667 {
1668 tem = XCAR (tail);
1669
1670 /* Find the feature's previous assoc list... */
1671 if (!NILP (Fequal (filename, Fcar (tem))))
1672 {
1673 foundit = 1;
1674
1675 /* If we're loading the entire file, remove old data. */
1676 if (entire)
1677 {
1678 if (NILP (prev))
1679 Vload_history = XCDR (tail);
1680 else
1681 Fsetcdr (prev, XCDR (tail));
1682 }
1683
1684 /* Otherwise, cons on new symbols that are not already members. */
1685 else
1686 {
1687 tem2 = Vcurrent_load_list;
1688
1689 while (CONSP (tem2))
1690 {
1691 newelt = XCAR (tem2);
1692
1693 if (NILP (Fmember (newelt, tem)))
1694 Fsetcar (tail, Fcons (XCAR (tem),
1695 Fcons (newelt, XCDR (tem))));
1696
1697 tem2 = XCDR (tem2);
1698 QUIT;
1699 }
1700 }
1701 }
1702 else
1703 prev = tail;
1704 tail = XCDR (tail);
1705 QUIT;
1706 }
1707
1708 /* If we're loading an entire file, cons the new assoc onto the
1709 front of load-history, the most-recently-loaded position. Also
1710 do this if we didn't find an existing member for the file. */
1711 if (entire || !foundit)
1712 Vload_history = Fcons (Fnreverse (Vcurrent_load_list),
1713 Vload_history);
1714 }
1715
1716 static void
1717 readevalloop_1 (int old)
1718 {
1719 load_convert_to_unibyte = old;
1720 }
1721
1722 /* Signal an `end-of-file' error, if possible with file name
1723 information. */
1724
1725 static _Noreturn void
1726 end_of_file_error (void)
1727 {
1728 if (STRINGP (Vload_file_name))
1729 xsignal1 (Qend_of_file, Vload_file_name);
1730
1731 xsignal0 (Qend_of_file);
1732 }
1733
1734 static Lisp_Object
1735 readevalloop_eager_expand_eval (Lisp_Object val, Lisp_Object macroexpand)
1736 {
1737 /* If we macroexpand the toplevel form non-recursively and it ends
1738 up being a `progn' (or if it was a progn to start), treat each
1739 form in the progn as a top-level form. This way, if one form in
1740 the progn defines a macro, that macro is in effect when we expand
1741 the remaining forms. See similar code in bytecomp.el. */
1742 val = call2 (macroexpand, val, Qnil);
1743 if (EQ (CAR_SAFE (val), Qprogn))
1744 {
1745 Lisp_Object subforms = XCDR (val);
1746
1747 for (val = Qnil; CONSP (subforms); subforms = XCDR (subforms))
1748 val = readevalloop_eager_expand_eval (XCAR (subforms),
1749 macroexpand);
1750 }
1751 else
1752 val = eval_sub (call2 (macroexpand, val, Qt));
1753 return val;
1754 }
1755
1756 /* UNIBYTE specifies how to set load_convert_to_unibyte
1757 for this invocation.
1758 READFUN, if non-nil, is used instead of `read'.
1759
1760 START, END specify region to read in current buffer (from eval-region).
1761 If the input is not from a buffer, they must be nil. */
1762
1763 static void
1764 readevalloop (Lisp_Object readcharfun,
1765 FILE *stream,
1766 Lisp_Object sourcename,
1767 bool printflag,
1768 Lisp_Object unibyte, Lisp_Object readfun,
1769 Lisp_Object start, Lisp_Object end)
1770 {
1771 int c;
1772 Lisp_Object val;
1773 ptrdiff_t count = SPECPDL_INDEX ();
1774 struct buffer *b = 0;
1775 bool continue_reading_p;
1776 Lisp_Object lex_bound;
1777 /* True if reading an entire buffer. */
1778 bool whole_buffer = 0;
1779 /* True on the first time around. */
1780 bool first_sexp = 1;
1781 Lisp_Object macroexpand = intern ("internal-macroexpand-for-load");
1782
1783 if (NILP (Ffboundp (macroexpand))
1784 /* Don't macroexpand in .elc files, since it should have been done
1785 already. We actually don't know whether we're in a .elc file or not,
1786 so we use circumstantial evidence: .el files normally go through
1787 Vload_source_file_function -> load-with-code-conversion
1788 -> eval-buffer. */
1789 || EQ (readcharfun, Qget_file_char)
1790 || EQ (readcharfun, Qget_emacs_mule_file_char))
1791 macroexpand = Qnil;
1792
1793 if (MARKERP (readcharfun))
1794 {
1795 if (NILP (start))
1796 start = readcharfun;
1797 }
1798
1799 if (BUFFERP (readcharfun))
1800 b = XBUFFER (readcharfun);
1801 else if (MARKERP (readcharfun))
1802 b = XMARKER (readcharfun)->buffer;
1803
1804 /* We assume START is nil when input is not from a buffer. */
1805 if (! NILP (start) && !b)
1806 emacs_abort ();
1807
1808 specbind (Qstandard_input, readcharfun);
1809 specbind (Qcurrent_load_list, Qnil);
1810 record_unwind_protect_int (readevalloop_1, load_convert_to_unibyte);
1811 load_convert_to_unibyte = !NILP (unibyte);
1812
1813 /* If lexical binding is active (either because it was specified in
1814 the file's header, or via a buffer-local variable), create an empty
1815 lexical environment, otherwise, turn off lexical binding. */
1816 lex_bound = find_symbol_value (Qlexical_binding);
1817 specbind (Qinternal_interpreter_environment,
1818 (NILP (lex_bound) || EQ (lex_bound, Qunbound)
1819 ? Qnil : list1 (Qt)));
1820
1821 /* Try to ensure sourcename is a truename, except whilst preloading. */
1822 if (NILP (Vpurify_flag)
1823 && !NILP (sourcename) && !NILP (Ffile_name_absolute_p (sourcename))
1824 && !NILP (Ffboundp (Qfile_truename)))
1825 sourcename = call1 (Qfile_truename, sourcename) ;
1826
1827 LOADHIST_ATTACH (sourcename);
1828
1829 continue_reading_p = 1;
1830 while (continue_reading_p)
1831 {
1832 ptrdiff_t count1 = SPECPDL_INDEX ();
1833
1834 if (b != 0 && !BUFFER_LIVE_P (b))
1835 error ("Reading from killed buffer");
1836
1837 if (!NILP (start))
1838 {
1839 /* Switch to the buffer we are reading from. */
1840 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1841 set_buffer_internal (b);
1842
1843 /* Save point in it. */
1844 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1845 /* Save ZV in it. */
1846 record_unwind_protect (save_restriction_restore, save_restriction_save ());
1847 /* Those get unbound after we read one expression. */
1848
1849 /* Set point and ZV around stuff to be read. */
1850 Fgoto_char (start);
1851 if (!NILP (end))
1852 Fnarrow_to_region (make_number (BEGV), end);
1853
1854 /* Just for cleanliness, convert END to a marker
1855 if it is an integer. */
1856 if (INTEGERP (end))
1857 end = Fpoint_max_marker ();
1858 }
1859
1860 /* On the first cycle, we can easily test here
1861 whether we are reading the whole buffer. */
1862 if (b && first_sexp)
1863 whole_buffer = (PT == BEG && ZV == Z);
1864
1865 instream = stream;
1866 read_next:
1867 c = READCHAR;
1868 if (c == ';')
1869 {
1870 while ((c = READCHAR) != '\n' && c != -1);
1871 goto read_next;
1872 }
1873 if (c < 0)
1874 {
1875 unbind_to (count1, Qnil);
1876 break;
1877 }
1878
1879 /* Ignore whitespace here, so we can detect eof. */
1880 if (c == ' ' || c == '\t' || c == '\n' || c == '\f' || c == '\r'
1881 || c == NO_BREAK_SPACE)
1882 goto read_next;
1883
1884 if (!NILP (Vpurify_flag) && c == '(')
1885 {
1886 val = read_list (0, readcharfun);
1887 }
1888 else
1889 {
1890 UNREAD (c);
1891 read_objects = Qnil;
1892 if (!NILP (readfun))
1893 {
1894 val = call1 (readfun, readcharfun);
1895
1896 /* If READCHARFUN has set point to ZV, we should
1897 stop reading, even if the form read sets point
1898 to a different value when evaluated. */
1899 if (BUFFERP (readcharfun))
1900 {
1901 struct buffer *buf = XBUFFER (readcharfun);
1902 if (BUF_PT (buf) == BUF_ZV (buf))
1903 continue_reading_p = 0;
1904 }
1905 }
1906 else if (! NILP (Vload_read_function))
1907 val = call1 (Vload_read_function, readcharfun);
1908 else
1909 val = read_internal_start (readcharfun, Qnil, Qnil);
1910 }
1911
1912 if (!NILP (start) && continue_reading_p)
1913 start = Fpoint_marker ();
1914
1915 /* Restore saved point and BEGV. */
1916 unbind_to (count1, Qnil);
1917
1918 /* Now eval what we just read. */
1919 if (!NILP (macroexpand))
1920 val = readevalloop_eager_expand_eval (val, macroexpand);
1921 else
1922 val = eval_sub (val);
1923
1924 if (printflag)
1925 {
1926 Vvalues = Fcons (val, Vvalues);
1927 if (EQ (Vstandard_output, Qt))
1928 Fprin1 (val, Qnil);
1929 else
1930 Fprint (val, Qnil);
1931 }
1932
1933 first_sexp = 0;
1934 }
1935
1936 build_load_history (sourcename,
1937 stream || whole_buffer);
1938
1939 unbind_to (count, Qnil);
1940 }
1941
1942 DEFUN ("eval-buffer", Feval_buffer, Seval_buffer, 0, 5, "",
1943 doc: /* Execute the accessible portion of current buffer as Lisp code.
1944 You can use \\[narrow-to-region] to limit the part of buffer to be evaluated.
1945 When called from a Lisp program (i.e., not interactively), this
1946 function accepts up to five optional arguments:
1947 BUFFER is the buffer to evaluate (nil means use current buffer),
1948 or a name of a buffer (a string).
1949 PRINTFLAG controls printing of output by any output functions in the
1950 evaluated code, such as `print', `princ', and `prin1':
1951 a value of nil means discard it; anything else is the stream to print to.
1952 See Info node `(elisp)Output Streams' for details on streams.
1953 FILENAME specifies the file name to use for `load-history'.
1954 UNIBYTE, if non-nil, specifies `load-convert-to-unibyte' for this
1955 invocation.
1956 DO-ALLOW-PRINT, if non-nil, specifies that output functions in the
1957 evaluated code should work normally even if PRINTFLAG is nil, in
1958 which case the output is displayed in the echo area.
1959
1960 This function preserves the position of point. */)
1961 (Lisp_Object buffer, Lisp_Object printflag, Lisp_Object filename, Lisp_Object unibyte, Lisp_Object do_allow_print)
1962 {
1963 ptrdiff_t count = SPECPDL_INDEX ();
1964 Lisp_Object tem, buf;
1965
1966 if (NILP (buffer))
1967 buf = Fcurrent_buffer ();
1968 else
1969 buf = Fget_buffer (buffer);
1970 if (NILP (buf))
1971 error ("No such buffer");
1972
1973 if (NILP (printflag) && NILP (do_allow_print))
1974 tem = Qsymbolp;
1975 else
1976 tem = printflag;
1977
1978 if (NILP (filename))
1979 filename = BVAR (XBUFFER (buf), filename);
1980
1981 specbind (Qeval_buffer_list, Fcons (buf, Veval_buffer_list));
1982 specbind (Qstandard_output, tem);
1983 record_unwind_protect (save_excursion_restore, save_excursion_save ());
1984 BUF_TEMP_SET_PT (XBUFFER (buf), BUF_BEGV (XBUFFER (buf)));
1985 specbind (Qlexical_binding, lisp_file_lexically_bound_p (buf) ? Qt : Qnil);
1986 readevalloop (buf, 0, filename,
1987 !NILP (printflag), unibyte, Qnil, Qnil, Qnil);
1988 unbind_to (count, Qnil);
1989
1990 return Qnil;
1991 }
1992
1993 DEFUN ("eval-region", Feval_region, Seval_region, 2, 4, "r",
1994 doc: /* Execute the region as Lisp code.
1995 When called from programs, expects two arguments,
1996 giving starting and ending indices in the current buffer
1997 of the text to be executed.
1998 Programs can pass third argument PRINTFLAG which controls output:
1999 a value of nil means discard it; anything else is stream for printing it.
2000 See Info node `(elisp)Output Streams' for details on streams.
2001 Also the fourth argument READ-FUNCTION, if non-nil, is used
2002 instead of `read' to read each expression. It gets one argument
2003 which is the input stream for reading characters.
2004
2005 This function does not move point. */)
2006 (Lisp_Object start, Lisp_Object end, Lisp_Object printflag, Lisp_Object read_function)
2007 {
2008 /* FIXME: Do the eval-sexp-add-defvars dance! */
2009 ptrdiff_t count = SPECPDL_INDEX ();
2010 Lisp_Object tem, cbuf;
2011
2012 cbuf = Fcurrent_buffer ();
2013
2014 if (NILP (printflag))
2015 tem = Qsymbolp;
2016 else
2017 tem = printflag;
2018 specbind (Qstandard_output, tem);
2019 specbind (Qeval_buffer_list, Fcons (cbuf, Veval_buffer_list));
2020
2021 /* `readevalloop' calls functions which check the type of start and end. */
2022 readevalloop (cbuf, 0, BVAR (XBUFFER (cbuf), filename),
2023 !NILP (printflag), Qnil, read_function,
2024 start, end);
2025
2026 return unbind_to (count, Qnil);
2027 }
2028
2029 \f
2030 DEFUN ("read", Fread, Sread, 0, 1, 0,
2031 doc: /* Read one Lisp expression as text from STREAM, return as Lisp object.
2032 If STREAM is nil, use the value of `standard-input' (which see).
2033 STREAM or the value of `standard-input' may be:
2034 a buffer (read from point and advance it)
2035 a marker (read from where it points and advance it)
2036 a function (call it with no arguments for each character,
2037 call it with a char as argument to push a char back)
2038 a string (takes text from string, starting at the beginning)
2039 t (read text line using minibuffer and use it, or read from
2040 standard input in batch mode). */)
2041 (Lisp_Object stream)
2042 {
2043 if (NILP (stream))
2044 stream = Vstandard_input;
2045 if (EQ (stream, Qt))
2046 stream = Qread_char;
2047 if (EQ (stream, Qread_char))
2048 /* FIXME: ?! When is this used !? */
2049 return call1 (intern ("read-minibuffer"),
2050 build_string ("Lisp expression: "));
2051
2052 return read_internal_start (stream, Qnil, Qnil);
2053 }
2054
2055 DEFUN ("read-from-string", Fread_from_string, Sread_from_string, 1, 3, 0,
2056 doc: /* Read one Lisp expression which is represented as text by STRING.
2057 Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
2058 FINAL-STRING-INDEX is an integer giving the position of the next
2059 remaining character in STRING. START and END optionally delimit
2060 a substring of STRING from which to read; they default to 0 and
2061 \(length STRING) respectively. Negative values are counted from
2062 the end of STRING. */)
2063 (Lisp_Object string, Lisp_Object start, Lisp_Object end)
2064 {
2065 Lisp_Object ret;
2066 CHECK_STRING (string);
2067 /* `read_internal_start' sets `read_from_string_index'. */
2068 ret = read_internal_start (string, start, end);
2069 return Fcons (ret, make_number (read_from_string_index));
2070 }
2071
2072 /* Function to set up the global context we need in toplevel read
2073 calls. START and END only used when STREAM is a string. */
2074 static Lisp_Object
2075 read_internal_start (Lisp_Object stream, Lisp_Object start, Lisp_Object end)
2076 {
2077 Lisp_Object retval;
2078
2079 readchar_count = 0;
2080 new_backquote_flag = 0;
2081 read_objects = Qnil;
2082 if (EQ (Vread_with_symbol_positions, Qt)
2083 || EQ (Vread_with_symbol_positions, stream))
2084 Vread_symbol_positions_list = Qnil;
2085
2086 if (STRINGP (stream)
2087 || ((CONSP (stream) && STRINGP (XCAR (stream)))))
2088 {
2089 ptrdiff_t startval, endval;
2090 Lisp_Object string;
2091
2092 if (STRINGP (stream))
2093 string = stream;
2094 else
2095 string = XCAR (stream);
2096
2097 validate_subarray (string, start, end, SCHARS (string),
2098 &startval, &endval);
2099
2100 read_from_string_index = startval;
2101 read_from_string_index_byte = string_char_to_byte (string, startval);
2102 read_from_string_limit = endval;
2103 }
2104
2105 retval = read0 (stream);
2106 if (EQ (Vread_with_symbol_positions, Qt)
2107 || EQ (Vread_with_symbol_positions, stream))
2108 Vread_symbol_positions_list = Fnreverse (Vread_symbol_positions_list);
2109 return retval;
2110 }
2111 \f
2112
2113 /* Signal Qinvalid_read_syntax error.
2114 S is error string of length N (if > 0) */
2115
2116 static _Noreturn void
2117 invalid_syntax (const char *s)
2118 {
2119 xsignal1 (Qinvalid_read_syntax, build_string (s));
2120 }
2121
2122
2123 /* Use this for recursive reads, in contexts where internal tokens
2124 are not allowed. */
2125
2126 static Lisp_Object
2127 read0 (Lisp_Object readcharfun)
2128 {
2129 register Lisp_Object val;
2130 int c;
2131
2132 val = read1 (readcharfun, &c, 0);
2133 if (!c)
2134 return val;
2135
2136 xsignal1 (Qinvalid_read_syntax,
2137 Fmake_string (make_number (1), make_number (c)));
2138 }
2139 \f
2140 static ptrdiff_t read_buffer_size;
2141 static char *read_buffer;
2142
2143 /* Grow the read buffer by at least MAX_MULTIBYTE_LENGTH bytes. */
2144
2145 static void
2146 grow_read_buffer (void)
2147 {
2148 read_buffer = xpalloc (read_buffer, &read_buffer_size,
2149 MAX_MULTIBYTE_LENGTH, -1, 1);
2150 }
2151
2152 /* Return the scalar value that has the Unicode character name NAME.
2153 Raise 'invalid-read-syntax' if there is no such character. */
2154 static int
2155 character_name_to_code (char const *name, ptrdiff_t name_len)
2156 {
2157 /* For "U+XXXX", pass the leading '+' to string_to_number to reject
2158 monstrosities like "U+-0000". */
2159 Lisp_Object code
2160 = (name[0] == 'U' && name[1] == '+'
2161 ? string_to_number (name + 1, 16, false)
2162 : call2 (Qchar_from_name, make_unibyte_string (name, name_len), Qt));
2163
2164 if (! RANGED_INTEGERP (0, code, MAX_UNICODE_CHAR)
2165 || char_surrogate_p (XINT (code)))
2166 {
2167 AUTO_STRING (format, "\\N{%s}");
2168 AUTO_STRING_WITH_LEN (namestr, name, name_len);
2169 xsignal1 (Qinvalid_read_syntax, CALLN (Fformat, format, namestr));
2170 }
2171
2172 return XINT (code);
2173 }
2174
2175 /* Bound on the length of a Unicode character name. As of
2176 Unicode 9.0.0 the maximum is 83, so this should be safe. */
2177 enum { UNICODE_CHARACTER_NAME_LENGTH_BOUND = 200 };
2178
2179 /* Read a \-escape sequence, assuming we already read the `\'.
2180 If the escape sequence forces unibyte, return eight-bit char. */
2181
2182 static int
2183 read_escape (Lisp_Object readcharfun, bool stringp)
2184 {
2185 int c = READCHAR;
2186 /* \u allows up to four hex digits, \U up to eight. Default to the
2187 behavior for \u, and change this value in the case that \U is seen. */
2188 int unicode_hex_count = 4;
2189
2190 switch (c)
2191 {
2192 case -1:
2193 end_of_file_error ();
2194
2195 case 'a':
2196 return '\007';
2197 case 'b':
2198 return '\b';
2199 case 'd':
2200 return 0177;
2201 case 'e':
2202 return 033;
2203 case 'f':
2204 return '\f';
2205 case 'n':
2206 return '\n';
2207 case 'r':
2208 return '\r';
2209 case 't':
2210 return '\t';
2211 case 'v':
2212 return '\v';
2213 case '\n':
2214 return -1;
2215 case ' ':
2216 if (stringp)
2217 return -1;
2218 return ' ';
2219
2220 case 'M':
2221 c = READCHAR;
2222 if (c != '-')
2223 error ("Invalid escape character syntax");
2224 c = READCHAR;
2225 if (c == '\\')
2226 c = read_escape (readcharfun, 0);
2227 return c | meta_modifier;
2228
2229 case 'S':
2230 c = READCHAR;
2231 if (c != '-')
2232 error ("Invalid escape character syntax");
2233 c = READCHAR;
2234 if (c == '\\')
2235 c = read_escape (readcharfun, 0);
2236 return c | shift_modifier;
2237
2238 case 'H':
2239 c = READCHAR;
2240 if (c != '-')
2241 error ("Invalid escape character syntax");
2242 c = READCHAR;
2243 if (c == '\\')
2244 c = read_escape (readcharfun, 0);
2245 return c | hyper_modifier;
2246
2247 case 'A':
2248 c = READCHAR;
2249 if (c != '-')
2250 error ("Invalid escape character syntax");
2251 c = READCHAR;
2252 if (c == '\\')
2253 c = read_escape (readcharfun, 0);
2254 return c | alt_modifier;
2255
2256 case 's':
2257 c = READCHAR;
2258 if (stringp || c != '-')
2259 {
2260 UNREAD (c);
2261 return ' ';
2262 }
2263 c = READCHAR;
2264 if (c == '\\')
2265 c = read_escape (readcharfun, 0);
2266 return c | super_modifier;
2267
2268 case 'C':
2269 c = READCHAR;
2270 if (c != '-')
2271 error ("Invalid escape character syntax");
2272 case '^':
2273 c = READCHAR;
2274 if (c == '\\')
2275 c = read_escape (readcharfun, 0);
2276 if ((c & ~CHAR_MODIFIER_MASK) == '?')
2277 return 0177 | (c & CHAR_MODIFIER_MASK);
2278 else if (! SINGLE_BYTE_CHAR_P ((c & ~CHAR_MODIFIER_MASK)))
2279 return c | ctrl_modifier;
2280 /* ASCII control chars are made from letters (both cases),
2281 as well as the non-letters within 0100...0137. */
2282 else if ((c & 0137) >= 0101 && (c & 0137) <= 0132)
2283 return (c & (037 | ~0177));
2284 else if ((c & 0177) >= 0100 && (c & 0177) <= 0137)
2285 return (c & (037 | ~0177));
2286 else
2287 return c | ctrl_modifier;
2288
2289 case '0':
2290 case '1':
2291 case '2':
2292 case '3':
2293 case '4':
2294 case '5':
2295 case '6':
2296 case '7':
2297 /* An octal escape, as in ANSI C. */
2298 {
2299 register int i = c - '0';
2300 register int count = 0;
2301 while (++count < 3)
2302 {
2303 if ((c = READCHAR) >= '0' && c <= '7')
2304 {
2305 i *= 8;
2306 i += c - '0';
2307 }
2308 else
2309 {
2310 UNREAD (c);
2311 break;
2312 }
2313 }
2314
2315 if (i >= 0x80 && i < 0x100)
2316 i = BYTE8_TO_CHAR (i);
2317 return i;
2318 }
2319
2320 case 'x':
2321 /* A hex escape, as in ANSI C. */
2322 {
2323 unsigned int i = 0;
2324 int count = 0;
2325 while (1)
2326 {
2327 c = READCHAR;
2328 if (c >= '0' && c <= '9')
2329 {
2330 i *= 16;
2331 i += c - '0';
2332 }
2333 else if ((c >= 'a' && c <= 'f')
2334 || (c >= 'A' && c <= 'F'))
2335 {
2336 i *= 16;
2337 if (c >= 'a' && c <= 'f')
2338 i += c - 'a' + 10;
2339 else
2340 i += c - 'A' + 10;
2341 }
2342 else
2343 {
2344 UNREAD (c);
2345 break;
2346 }
2347 /* Allow hex escapes as large as ?\xfffffff, because some
2348 packages use them to denote characters with modifiers. */
2349 if ((CHAR_META | (CHAR_META - 1)) < i)
2350 error ("Hex character out of range: \\x%x...", i);
2351 count += count < 3;
2352 }
2353
2354 if (count < 3 && i >= 0x80)
2355 return BYTE8_TO_CHAR (i);
2356 return i;
2357 }
2358
2359 case 'U':
2360 /* Post-Unicode-2.0: Up to eight hex chars. */
2361 unicode_hex_count = 8;
2362 case 'u':
2363
2364 /* A Unicode escape. We only permit them in strings and characters,
2365 not arbitrarily in the source code, as in some other languages. */
2366 {
2367 unsigned int i = 0;
2368 int count = 0;
2369
2370 while (++count <= unicode_hex_count)
2371 {
2372 c = READCHAR;
2373 /* `isdigit' and `isalpha' may be locale-specific, which we don't
2374 want. */
2375 if (c >= '0' && c <= '9') i = (i << 4) + (c - '0');
2376 else if (c >= 'a' && c <= 'f') i = (i << 4) + (c - 'a') + 10;
2377 else if (c >= 'A' && c <= 'F') i = (i << 4) + (c - 'A') + 10;
2378 else
2379 error ("Non-hex digit used for Unicode escape");
2380 }
2381 if (i > 0x10FFFF)
2382 error ("Non-Unicode character: 0x%x", i);
2383 return i;
2384 }
2385
2386 case 'N':
2387 /* Named character. */
2388 {
2389 c = READCHAR;
2390 if (c != '{')
2391 invalid_syntax ("Expected opening brace after \\N");
2392 char name[UNICODE_CHARACTER_NAME_LENGTH_BOUND + 1];
2393 bool whitespace = false;
2394 ptrdiff_t length = 0;
2395 while (true)
2396 {
2397 c = READCHAR;
2398 if (c < 0)
2399 end_of_file_error ();
2400 if (c == '}')
2401 break;
2402 if (! (0 < c && c < 0x80))
2403 {
2404 AUTO_STRING (format,
2405 "Invalid character U+%04X in character name");
2406 xsignal1 (Qinvalid_read_syntax,
2407 CALLN (Fformat, format, make_natnum (c)));
2408 }
2409 /* Treat multiple adjacent whitespace characters as a
2410 single space character. This makes it easier to use
2411 character names in e.g. multi-line strings. */
2412 if (c_isspace (c))
2413 {
2414 if (whitespace)
2415 continue;
2416 c = ' ';
2417 whitespace = true;
2418 }
2419 else
2420 whitespace = false;
2421 name[length++] = c;
2422 if (length >= sizeof name)
2423 invalid_syntax ("Character name too long");
2424 }
2425 if (length == 0)
2426 invalid_syntax ("Empty character name");
2427 name[length] = '\0';
2428 return character_name_to_code (name, length);
2429 }
2430
2431 default:
2432 return c;
2433 }
2434 }
2435
2436 /* Return the digit that CHARACTER stands for in the given BASE.
2437 Return -1 if CHARACTER is out of range for BASE,
2438 and -2 if CHARACTER is not valid for any supported BASE. */
2439 static int
2440 digit_to_number (int character, int base)
2441 {
2442 int digit;
2443
2444 if ('0' <= character && character <= '9')
2445 digit = character - '0';
2446 else if ('a' <= character && character <= 'z')
2447 digit = character - 'a' + 10;
2448 else if ('A' <= character && character <= 'Z')
2449 digit = character - 'A' + 10;
2450 else
2451 return -2;
2452
2453 return digit < base ? digit : -1;
2454 }
2455
2456 /* Read an integer in radix RADIX using READCHARFUN to read
2457 characters. RADIX must be in the interval [2..36]; if it isn't, a
2458 read error is signaled . Value is the integer read. Signals an
2459 error if encountering invalid read syntax or if RADIX is out of
2460 range. */
2461
2462 static Lisp_Object
2463 read_integer (Lisp_Object readcharfun, EMACS_INT radix)
2464 {
2465 /* Room for sign, leading 0, other digits, trailing null byte.
2466 Also, room for invalid syntax diagnostic. */
2467 char buf[max (1 + 1 + sizeof (uintmax_t) * CHAR_BIT + 1,
2468 sizeof "integer, radix " + INT_STRLEN_BOUND (EMACS_INT))];
2469
2470 int valid = -1; /* 1 if valid, 0 if not, -1 if incomplete. */
2471
2472 if (radix < 2 || radix > 36)
2473 valid = 0;
2474 else
2475 {
2476 char *p = buf;
2477 int c, digit;
2478
2479 c = READCHAR;
2480 if (c == '-' || c == '+')
2481 {
2482 *p++ = c;
2483 c = READCHAR;
2484 }
2485
2486 if (c == '0')
2487 {
2488 *p++ = c;
2489 valid = 1;
2490
2491 /* Ignore redundant leading zeros, so the buffer doesn't
2492 fill up with them. */
2493 do
2494 c = READCHAR;
2495 while (c == '0');
2496 }
2497
2498 while ((digit = digit_to_number (c, radix)) >= -1)
2499 {
2500 if (digit == -1)
2501 valid = 0;
2502 if (valid < 0)
2503 valid = 1;
2504
2505 if (p < buf + sizeof buf - 1)
2506 *p++ = c;
2507 else
2508 valid = 0;
2509
2510 c = READCHAR;
2511 }
2512
2513 UNREAD (c);
2514 *p = '\0';
2515 }
2516
2517 if (! valid)
2518 {
2519 sprintf (buf, "integer, radix %"pI"d", radix);
2520 invalid_syntax (buf);
2521 }
2522
2523 return string_to_number (buf, radix, 0);
2524 }
2525
2526
2527 /* If the next token is ')' or ']' or '.', we store that character
2528 in *PCH and the return value is not interesting. Else, we store
2529 zero in *PCH and we read and return one lisp object.
2530
2531 FIRST_IN_LIST is true if this is the first element of a list. */
2532
2533 static Lisp_Object
2534 read1 (Lisp_Object readcharfun, int *pch, bool first_in_list)
2535 {
2536 int c;
2537 bool uninterned_symbol = 0;
2538 bool multibyte;
2539
2540 *pch = 0;
2541
2542 retry:
2543
2544 c = READCHAR_REPORT_MULTIBYTE (&multibyte);
2545 if (c < 0)
2546 end_of_file_error ();
2547
2548 switch (c)
2549 {
2550 case '(':
2551 return read_list (0, readcharfun);
2552
2553 case '[':
2554 return read_vector (readcharfun, 0);
2555
2556 case ')':
2557 case ']':
2558 {
2559 *pch = c;
2560 return Qnil;
2561 }
2562
2563 case '#':
2564 c = READCHAR;
2565 if (c == 's')
2566 {
2567 c = READCHAR;
2568 if (c == '(')
2569 {
2570 /* Accept extended format for hashtables (extensible to
2571 other types), e.g.
2572 #s(hash-table size 2 test equal data (k1 v1 k2 v2)) */
2573 Lisp_Object tmp = read_list (0, readcharfun);
2574 Lisp_Object head = CAR_SAFE (tmp);
2575 Lisp_Object data = Qnil;
2576 Lisp_Object val = Qnil;
2577 /* The size is 2 * number of allowed keywords to
2578 make-hash-table. */
2579 Lisp_Object params[10];
2580 Lisp_Object ht;
2581 Lisp_Object key = Qnil;
2582 int param_count = 0;
2583
2584 if (!EQ (head, Qhash_table))
2585 error ("Invalid extended read marker at head of #s list "
2586 "(only hash-table allowed)");
2587
2588 tmp = CDR_SAFE (tmp);
2589
2590 /* This is repetitive but fast and simple. */
2591 params[param_count] = QCsize;
2592 params[param_count + 1] = Fplist_get (tmp, Qsize);
2593 if (!NILP (params[param_count + 1]))
2594 param_count += 2;
2595
2596 params[param_count] = QCtest;
2597 params[param_count + 1] = Fplist_get (tmp, Qtest);
2598 if (!NILP (params[param_count + 1]))
2599 param_count += 2;
2600
2601 params[param_count] = QCweakness;
2602 params[param_count + 1] = Fplist_get (tmp, Qweakness);
2603 if (!NILP (params[param_count + 1]))
2604 param_count += 2;
2605
2606 params[param_count] = QCrehash_size;
2607 params[param_count + 1] = Fplist_get (tmp, Qrehash_size);
2608 if (!NILP (params[param_count + 1]))
2609 param_count += 2;
2610
2611 params[param_count] = QCrehash_threshold;
2612 params[param_count + 1] = Fplist_get (tmp, Qrehash_threshold);
2613 if (!NILP (params[param_count + 1]))
2614 param_count += 2;
2615
2616 /* This is the hashtable data. */
2617 data = Fplist_get (tmp, Qdata);
2618
2619 /* Now use params to make a new hashtable and fill it. */
2620 ht = Fmake_hash_table (param_count, params);
2621
2622 while (CONSP (data))
2623 {
2624 key = XCAR (data);
2625 data = XCDR (data);
2626 if (!CONSP (data))
2627 error ("Odd number of elements in hashtable data");
2628 val = XCAR (data);
2629 data = XCDR (data);
2630 Fputhash (key, val, ht);
2631 }
2632
2633 return ht;
2634 }
2635 UNREAD (c);
2636 invalid_syntax ("#");
2637 }
2638 if (c == '^')
2639 {
2640 c = READCHAR;
2641 if (c == '[')
2642 {
2643 Lisp_Object tmp;
2644 tmp = read_vector (readcharfun, 0);
2645 if (ASIZE (tmp) < CHAR_TABLE_STANDARD_SLOTS)
2646 error ("Invalid size char-table");
2647 XSETPVECTYPE (XVECTOR (tmp), PVEC_CHAR_TABLE);
2648 return tmp;
2649 }
2650 else if (c == '^')
2651 {
2652 c = READCHAR;
2653 if (c == '[')
2654 {
2655 /* Sub char-table can't be read as a regular
2656 vector because of a two C integer fields. */
2657 Lisp_Object tbl, tmp = read_list (1, readcharfun);
2658 ptrdiff_t size = XINT (Flength (tmp));
2659 int i, depth, min_char;
2660 struct Lisp_Cons *cell;
2661
2662 if (size == 0)
2663 error ("Zero-sized sub char-table");
2664
2665 if (! RANGED_INTEGERP (1, XCAR (tmp), 3))
2666 error ("Invalid depth in sub char-table");
2667 depth = XINT (XCAR (tmp));
2668 if (chartab_size[depth] != size - 2)
2669 error ("Invalid size in sub char-table");
2670 cell = XCONS (tmp), tmp = XCDR (tmp), size--;
2671 free_cons (cell);
2672
2673 if (! RANGED_INTEGERP (0, XCAR (tmp), MAX_CHAR))
2674 error ("Invalid minimum character in sub-char-table");
2675 min_char = XINT (XCAR (tmp));
2676 cell = XCONS (tmp), tmp = XCDR (tmp), size--;
2677 free_cons (cell);
2678
2679 tbl = make_uninit_sub_char_table (depth, min_char);
2680 for (i = 0; i < size; i++)
2681 {
2682 XSUB_CHAR_TABLE (tbl)->contents[i] = XCAR (tmp);
2683 cell = XCONS (tmp), tmp = XCDR (tmp);
2684 free_cons (cell);
2685 }
2686 return tbl;
2687 }
2688 invalid_syntax ("#^^");
2689 }
2690 invalid_syntax ("#^");
2691 }
2692 if (c == '&')
2693 {
2694 Lisp_Object length;
2695 length = read1 (readcharfun, pch, first_in_list);
2696 c = READCHAR;
2697 if (c == '"')
2698 {
2699 Lisp_Object tmp, val;
2700 EMACS_INT size_in_chars = bool_vector_bytes (XFASTINT (length));
2701 unsigned char *data;
2702
2703 UNREAD (c);
2704 tmp = read1 (readcharfun, pch, first_in_list);
2705 if (STRING_MULTIBYTE (tmp)
2706 || (size_in_chars != SCHARS (tmp)
2707 /* We used to print 1 char too many
2708 when the number of bits was a multiple of 8.
2709 Accept such input in case it came from an old
2710 version. */
2711 && ! (XFASTINT (length)
2712 == (SCHARS (tmp) - 1) * BOOL_VECTOR_BITS_PER_CHAR)))
2713 invalid_syntax ("#&...");
2714
2715 val = make_uninit_bool_vector (XFASTINT (length));
2716 data = bool_vector_uchar_data (val);
2717 memcpy (data, SDATA (tmp), size_in_chars);
2718 /* Clear the extraneous bits in the last byte. */
2719 if (XINT (length) != size_in_chars * BOOL_VECTOR_BITS_PER_CHAR)
2720 data[size_in_chars - 1]
2721 &= (1 << (XINT (length) % BOOL_VECTOR_BITS_PER_CHAR)) - 1;
2722 return val;
2723 }
2724 invalid_syntax ("#&...");
2725 }
2726 if (c == '[')
2727 {
2728 /* Accept compiled functions at read-time so that we don't have to
2729 build them using function calls. */
2730 Lisp_Object tmp;
2731 struct Lisp_Vector *vec;
2732 tmp = read_vector (readcharfun, 1);
2733 vec = XVECTOR (tmp);
2734 if (vec->header.size == 0)
2735 invalid_syntax ("Empty byte-code object");
2736 make_byte_code (vec);
2737 return tmp;
2738 }
2739 if (c == '(')
2740 {
2741 Lisp_Object tmp;
2742 int ch;
2743
2744 /* Read the string itself. */
2745 tmp = read1 (readcharfun, &ch, 0);
2746 if (ch != 0 || !STRINGP (tmp))
2747 invalid_syntax ("#");
2748 /* Read the intervals and their properties. */
2749 while (1)
2750 {
2751 Lisp_Object beg, end, plist;
2752
2753 beg = read1 (readcharfun, &ch, 0);
2754 end = plist = Qnil;
2755 if (ch == ')')
2756 break;
2757 if (ch == 0)
2758 end = read1 (readcharfun, &ch, 0);
2759 if (ch == 0)
2760 plist = read1 (readcharfun, &ch, 0);
2761 if (ch)
2762 invalid_syntax ("Invalid string property list");
2763 Fset_text_properties (beg, end, plist, tmp);
2764 }
2765
2766 return tmp;
2767 }
2768
2769 /* #@NUMBER is used to skip NUMBER following bytes.
2770 That's used in .elc files to skip over doc strings
2771 and function definitions. */
2772 if (c == '@')
2773 {
2774 enum { extra = 100 };
2775 ptrdiff_t i, nskip = 0, digits = 0;
2776
2777 /* Read a decimal integer. */
2778 while ((c = READCHAR) >= 0
2779 && c >= '0' && c <= '9')
2780 {
2781 if ((STRING_BYTES_BOUND - extra) / 10 <= nskip)
2782 string_overflow ();
2783 digits++;
2784 nskip *= 10;
2785 nskip += c - '0';
2786 if (digits == 2 && nskip == 0)
2787 { /* We've just seen #@00, which means "skip to end". */
2788 skip_dyn_eof (readcharfun);
2789 return Qnil;
2790 }
2791 }
2792 if (nskip > 0)
2793 /* We can't use UNREAD here, because in the code below we side-step
2794 READCHAR. Instead, assume the first char after #@NNN occupies
2795 a single byte, which is the case normally since it's just
2796 a space. */
2797 nskip--;
2798 else
2799 UNREAD (c);
2800
2801 if (load_force_doc_strings
2802 && (FROM_FILE_P (readcharfun)))
2803 {
2804 /* If we are supposed to force doc strings into core right now,
2805 record the last string that we skipped,
2806 and record where in the file it comes from. */
2807
2808 /* But first exchange saved_doc_string
2809 with prev_saved_doc_string, so we save two strings. */
2810 {
2811 char *temp = saved_doc_string;
2812 ptrdiff_t temp_size = saved_doc_string_size;
2813 file_offset temp_pos = saved_doc_string_position;
2814 ptrdiff_t temp_len = saved_doc_string_length;
2815
2816 saved_doc_string = prev_saved_doc_string;
2817 saved_doc_string_size = prev_saved_doc_string_size;
2818 saved_doc_string_position = prev_saved_doc_string_position;
2819 saved_doc_string_length = prev_saved_doc_string_length;
2820
2821 prev_saved_doc_string = temp;
2822 prev_saved_doc_string_size = temp_size;
2823 prev_saved_doc_string_position = temp_pos;
2824 prev_saved_doc_string_length = temp_len;
2825 }
2826
2827 if (saved_doc_string_size == 0)
2828 {
2829 saved_doc_string = xmalloc (nskip + extra);
2830 saved_doc_string_size = nskip + extra;
2831 }
2832 if (nskip > saved_doc_string_size)
2833 {
2834 saved_doc_string = xrealloc (saved_doc_string, nskip + extra);
2835 saved_doc_string_size = nskip + extra;
2836 }
2837
2838 saved_doc_string_position = file_tell (instream);
2839
2840 /* Copy that many characters into saved_doc_string. */
2841 block_input ();
2842 for (i = 0; i < nskip && c >= 0; i++)
2843 saved_doc_string[i] = c = getc (instream);
2844 unblock_input ();
2845
2846 saved_doc_string_length = i;
2847 }
2848 else
2849 /* Skip that many bytes. */
2850 skip_dyn_bytes (readcharfun, nskip);
2851
2852 goto retry;
2853 }
2854 if (c == '!')
2855 {
2856 /* #! appears at the beginning of an executable file.
2857 Skip the first line. */
2858 while (c != '\n' && c >= 0)
2859 c = READCHAR;
2860 goto retry;
2861 }
2862 if (c == '$')
2863 return Vload_file_name;
2864 if (c == '\'')
2865 return list2 (Qfunction, read0 (readcharfun));
2866 /* #:foo is the uninterned symbol named foo. */
2867 if (c == ':')
2868 {
2869 uninterned_symbol = 1;
2870 c = READCHAR;
2871 if (!(c > 040
2872 && c != NO_BREAK_SPACE
2873 && (c >= 0200
2874 || strchr ("\"';()[]#`,", c) == NULL)))
2875 {
2876 /* No symbol character follows, this is the empty
2877 symbol. */
2878 UNREAD (c);
2879 return Fmake_symbol (empty_unibyte_string);
2880 }
2881 goto read_symbol;
2882 }
2883 /* ## is the empty symbol. */
2884 if (c == '#')
2885 return Fintern (empty_unibyte_string, Qnil);
2886 /* Reader forms that can reuse previously read objects. */
2887 if (c >= '0' && c <= '9')
2888 {
2889 EMACS_INT n = 0;
2890 Lisp_Object tem;
2891
2892 /* Read a non-negative integer. */
2893 while (c >= '0' && c <= '9')
2894 {
2895 if (MOST_POSITIVE_FIXNUM / 10 < n
2896 || MOST_POSITIVE_FIXNUM < n * 10 + c - '0')
2897 n = MOST_POSITIVE_FIXNUM + 1;
2898 else
2899 n = n * 10 + c - '0';
2900 c = READCHAR;
2901 }
2902
2903 if (n <= MOST_POSITIVE_FIXNUM)
2904 {
2905 if (c == 'r' || c == 'R')
2906 return read_integer (readcharfun, n);
2907
2908 if (! NILP (Vread_circle))
2909 {
2910 /* #n=object returns object, but associates it with
2911 n for #n#. */
2912 if (c == '=')
2913 {
2914 /* Make a placeholder for #n# to use temporarily. */
2915 AUTO_CONS (placeholder, Qnil, Qnil);
2916 Lisp_Object cell = Fcons (make_number (n), placeholder);
2917 read_objects = Fcons (cell, read_objects);
2918
2919 /* Read the object itself. */
2920 tem = read0 (readcharfun);
2921
2922 /* Now put it everywhere the placeholder was... */
2923 substitute_object_in_subtree (tem, placeholder);
2924
2925 /* ...and #n# will use the real value from now on. */
2926 Fsetcdr (cell, tem);
2927
2928 return tem;
2929 }
2930
2931 /* #n# returns a previously read object. */
2932 if (c == '#')
2933 {
2934 tem = Fassq (make_number (n), read_objects);
2935 if (CONSP (tem))
2936 return XCDR (tem);
2937 }
2938 }
2939 }
2940 /* Fall through to error message. */
2941 }
2942 else if (c == 'x' || c == 'X')
2943 return read_integer (readcharfun, 16);
2944 else if (c == 'o' || c == 'O')
2945 return read_integer (readcharfun, 8);
2946 else if (c == 'b' || c == 'B')
2947 return read_integer (readcharfun, 2);
2948
2949 UNREAD (c);
2950 invalid_syntax ("#");
2951
2952 case ';':
2953 while ((c = READCHAR) >= 0 && c != '\n');
2954 goto retry;
2955
2956 case '\'':
2957 return list2 (Qquote, read0 (readcharfun));
2958
2959 case '`':
2960 {
2961 int next_char = READCHAR;
2962 UNREAD (next_char);
2963 /* Transition from old-style to new-style:
2964 If we see "(`" it used to mean old-style, which usually works
2965 fine because ` should almost never appear in such a position
2966 for new-style. But occasionally we need "(`" to mean new
2967 style, so we try to distinguish the two by the fact that we
2968 can either write "( `foo" or "(` foo", where the first
2969 intends to use new-style whereas the second intends to use
2970 old-style. For Emacs-25, we should completely remove this
2971 first_in_list exception (old-style can still be obtained via
2972 "(\`" anyway). */
2973 if (!new_backquote_flag && first_in_list && next_char == ' ')
2974 {
2975 Vold_style_backquotes = Qt;
2976 goto default_label;
2977 }
2978 else
2979 {
2980 Lisp_Object value;
2981 bool saved_new_backquote_flag = new_backquote_flag;
2982
2983 new_backquote_flag = 1;
2984 value = read0 (readcharfun);
2985 new_backquote_flag = saved_new_backquote_flag;
2986
2987 return list2 (Qbackquote, value);
2988 }
2989 }
2990 case ',':
2991 {
2992 int next_char = READCHAR;
2993 UNREAD (next_char);
2994 /* Transition from old-style to new-style:
2995 It used to be impossible to have a new-style , other than within
2996 a new-style `. This is sufficient when ` and , are used in the
2997 normal way, but ` and , can also appear in args to macros that
2998 will not interpret them in the usual way, in which case , may be
2999 used without any ` anywhere near.
3000 So we now use the same heuristic as for backquote: old-style
3001 unquotes are only recognized when first on a list, and when
3002 followed by a space.
3003 Because it's more difficult to peek 2 chars ahead, a new-style
3004 ,@ can still not be used outside of a `, unless it's in the middle
3005 of a list. */
3006 if (new_backquote_flag
3007 || !first_in_list
3008 || (next_char != ' ' && next_char != '@'))
3009 {
3010 Lisp_Object comma_type = Qnil;
3011 Lisp_Object value;
3012 int ch = READCHAR;
3013
3014 if (ch == '@')
3015 comma_type = Qcomma_at;
3016 else if (ch == '.')
3017 comma_type = Qcomma_dot;
3018 else
3019 {
3020 if (ch >= 0) UNREAD (ch);
3021 comma_type = Qcomma;
3022 }
3023
3024 value = read0 (readcharfun);
3025 return list2 (comma_type, value);
3026 }
3027 else
3028 {
3029 Vold_style_backquotes = Qt;
3030 goto default_label;
3031 }
3032 }
3033 case '?':
3034 {
3035 int modifiers;
3036 int next_char;
3037 bool ok;
3038
3039 c = READCHAR;
3040 if (c < 0)
3041 end_of_file_error ();
3042
3043 /* Accept `single space' syntax like (list ? x) where the
3044 whitespace character is SPC or TAB.
3045 Other literal whitespace like NL, CR, and FF are not accepted,
3046 as there are well-established escape sequences for these. */
3047 if (c == ' ' || c == '\t')
3048 return make_number (c);
3049
3050 if (c == '\\')
3051 c = read_escape (readcharfun, 0);
3052 modifiers = c & CHAR_MODIFIER_MASK;
3053 c &= ~CHAR_MODIFIER_MASK;
3054 if (CHAR_BYTE8_P (c))
3055 c = CHAR_TO_BYTE8 (c);
3056 c |= modifiers;
3057
3058 next_char = READCHAR;
3059 ok = (next_char <= 040
3060 || (next_char < 0200
3061 && strchr ("\"';()[]#?`,.", next_char) != NULL));
3062 UNREAD (next_char);
3063 if (ok)
3064 return make_number (c);
3065
3066 invalid_syntax ("?");
3067 }
3068
3069 case '"':
3070 {
3071 char *p = read_buffer;
3072 char *end = read_buffer + read_buffer_size;
3073 int ch;
3074 /* True if we saw an escape sequence specifying
3075 a multibyte character. */
3076 bool force_multibyte = 0;
3077 /* True if we saw an escape sequence specifying
3078 a single-byte character. */
3079 bool force_singlebyte = 0;
3080 bool cancel = 0;
3081 ptrdiff_t nchars = 0;
3082
3083 while ((ch = READCHAR) >= 0
3084 && ch != '\"')
3085 {
3086 if (end - p < MAX_MULTIBYTE_LENGTH)
3087 {
3088 ptrdiff_t offset = p - read_buffer;
3089 grow_read_buffer ();
3090 p = read_buffer + offset;
3091 end = read_buffer + read_buffer_size;
3092 }
3093
3094 if (ch == '\\')
3095 {
3096 int modifiers;
3097
3098 ch = read_escape (readcharfun, 1);
3099
3100 /* CH is -1 if \ newline or \ space has just been seen. */
3101 if (ch == -1)
3102 {
3103 if (p == read_buffer)
3104 cancel = 1;
3105 continue;
3106 }
3107
3108 modifiers = ch & CHAR_MODIFIER_MASK;
3109 ch = ch & ~CHAR_MODIFIER_MASK;
3110
3111 if (CHAR_BYTE8_P (ch))
3112 force_singlebyte = 1;
3113 else if (! ASCII_CHAR_P (ch))
3114 force_multibyte = 1;
3115 else /* I.e. ASCII_CHAR_P (ch). */
3116 {
3117 /* Allow `\C- ' and `\C-?'. */
3118 if (modifiers == CHAR_CTL)
3119 {
3120 if (ch == ' ')
3121 ch = 0, modifiers = 0;
3122 else if (ch == '?')
3123 ch = 127, modifiers = 0;
3124 }
3125 if (modifiers & CHAR_SHIFT)
3126 {
3127 /* Shift modifier is valid only with [A-Za-z]. */
3128 if (ch >= 'A' && ch <= 'Z')
3129 modifiers &= ~CHAR_SHIFT;
3130 else if (ch >= 'a' && ch <= 'z')
3131 ch -= ('a' - 'A'), modifiers &= ~CHAR_SHIFT;
3132 }
3133
3134 if (modifiers & CHAR_META)
3135 {
3136 /* Move the meta bit to the right place for a
3137 string. */
3138 modifiers &= ~CHAR_META;
3139 ch = BYTE8_TO_CHAR (ch | 0x80);
3140 force_singlebyte = 1;
3141 }
3142 }
3143
3144 /* Any modifiers remaining are invalid. */
3145 if (modifiers)
3146 error ("Invalid modifier in string");
3147 p += CHAR_STRING (ch, (unsigned char *) p);
3148 }
3149 else
3150 {
3151 p += CHAR_STRING (ch, (unsigned char *) p);
3152 if (CHAR_BYTE8_P (ch))
3153 force_singlebyte = 1;
3154 else if (! ASCII_CHAR_P (ch))
3155 force_multibyte = 1;
3156 }
3157 nchars++;
3158 }
3159
3160 if (ch < 0)
3161 end_of_file_error ();
3162
3163 /* If purifying, and string starts with \ newline,
3164 return zero instead. This is for doc strings
3165 that we are really going to find in etc/DOC.nn.nn. */
3166 if (!NILP (Vpurify_flag) && NILP (Vdoc_file_name) && cancel)
3167 return make_number (0);
3168
3169 if (! force_multibyte && force_singlebyte)
3170 {
3171 /* READ_BUFFER contains raw 8-bit bytes and no multibyte
3172 forms. Convert it to unibyte. */
3173 nchars = str_as_unibyte ((unsigned char *) read_buffer,
3174 p - read_buffer);
3175 p = read_buffer + nchars;
3176 }
3177
3178 return make_specified_string (read_buffer, nchars, p - read_buffer,
3179 (force_multibyte
3180 || (p - read_buffer != nchars)));
3181 }
3182
3183 case '.':
3184 {
3185 int next_char = READCHAR;
3186 UNREAD (next_char);
3187
3188 if (next_char <= 040
3189 || (next_char < 0200
3190 && strchr ("\"';([#?`,", next_char) != NULL))
3191 {
3192 *pch = c;
3193 return Qnil;
3194 }
3195
3196 /* Otherwise, we fall through! Note that the atom-reading loop
3197 below will now loop at least once, assuring that we will not
3198 try to UNREAD two characters in a row. */
3199 }
3200 default:
3201 default_label:
3202 if (c <= 040) goto retry;
3203 if (c == NO_BREAK_SPACE)
3204 goto retry;
3205
3206 read_symbol:
3207 {
3208 char *p = read_buffer;
3209 bool quoted = 0;
3210 EMACS_INT start_position = readchar_count - 1;
3211
3212 {
3213 char *end = read_buffer + read_buffer_size;
3214
3215 do
3216 {
3217 if (end - p < MAX_MULTIBYTE_LENGTH)
3218 {
3219 ptrdiff_t offset = p - read_buffer;
3220 grow_read_buffer ();
3221 p = read_buffer + offset;
3222 end = read_buffer + read_buffer_size;
3223 }
3224
3225 if (c == '\\')
3226 {
3227 c = READCHAR;
3228 if (c == -1)
3229 end_of_file_error ();
3230 quoted = 1;
3231 }
3232
3233 if (multibyte)
3234 p += CHAR_STRING (c, (unsigned char *) p);
3235 else
3236 *p++ = c;
3237 c = READCHAR;
3238 }
3239 while (c > 040
3240 && c != NO_BREAK_SPACE
3241 && (c >= 0200
3242 || strchr ("\"';()[]#`,", c) == NULL));
3243
3244 if (p == end)
3245 {
3246 ptrdiff_t offset = p - read_buffer;
3247 grow_read_buffer ();
3248 p = read_buffer + offset;
3249 end = read_buffer + read_buffer_size;
3250 }
3251 *p = 0;
3252 UNREAD (c);
3253 }
3254
3255 if (!quoted && !uninterned_symbol)
3256 {
3257 Lisp_Object result = string_to_number (read_buffer, 10, 0);
3258 if (! NILP (result))
3259 return result;
3260 }
3261 {
3262 Lisp_Object name, result;
3263 ptrdiff_t nbytes = p - read_buffer;
3264 ptrdiff_t nchars
3265 = (multibyte
3266 ? multibyte_chars_in_text ((unsigned char *) read_buffer,
3267 nbytes)
3268 : nbytes);
3269
3270 name = ((uninterned_symbol && ! NILP (Vpurify_flag)
3271 ? make_pure_string : make_specified_string)
3272 (read_buffer, nchars, nbytes, multibyte));
3273 result = (uninterned_symbol ? Fmake_symbol (name)
3274 : Fintern (name, Qnil));
3275
3276 if (EQ (Vread_with_symbol_positions, Qt)
3277 || EQ (Vread_with_symbol_positions, readcharfun))
3278 Vread_symbol_positions_list
3279 = Fcons (Fcons (result, make_number (start_position)),
3280 Vread_symbol_positions_list);
3281 return result;
3282 }
3283 }
3284 }
3285 }
3286 \f
3287
3288 /* List of nodes we've seen during substitute_object_in_subtree. */
3289 static Lisp_Object seen_list;
3290
3291 static void
3292 substitute_object_in_subtree (Lisp_Object object, Lisp_Object placeholder)
3293 {
3294 Lisp_Object check_object;
3295
3296 /* We haven't seen any objects when we start. */
3297 seen_list = Qnil;
3298
3299 /* Make all the substitutions. */
3300 check_object
3301 = substitute_object_recurse (object, placeholder, object);
3302
3303 /* Clear seen_list because we're done with it. */
3304 seen_list = Qnil;
3305
3306 /* The returned object here is expected to always eq the
3307 original. */
3308 if (!EQ (check_object, object))
3309 error ("Unexpected mutation error in reader");
3310 }
3311
3312 /* Feval doesn't get called from here, so no gc protection is needed. */
3313 #define SUBSTITUTE(get_val, set_val) \
3314 do { \
3315 Lisp_Object old_value = get_val; \
3316 Lisp_Object true_value \
3317 = substitute_object_recurse (object, placeholder, \
3318 old_value); \
3319 \
3320 if (!EQ (old_value, true_value)) \
3321 { \
3322 set_val; \
3323 } \
3324 } while (0)
3325
3326 static Lisp_Object
3327 substitute_object_recurse (Lisp_Object object, Lisp_Object placeholder, Lisp_Object subtree)
3328 {
3329 /* If we find the placeholder, return the target object. */
3330 if (EQ (placeholder, subtree))
3331 return object;
3332
3333 /* If we've been to this node before, don't explore it again. */
3334 if (!EQ (Qnil, Fmemq (subtree, seen_list)))
3335 return subtree;
3336
3337 /* If this node can be the entry point to a cycle, remember that
3338 we've seen it. It can only be such an entry point if it was made
3339 by #n=, which means that we can find it as a value in
3340 read_objects. */
3341 if (!EQ (Qnil, Frassq (subtree, read_objects)))
3342 seen_list = Fcons (subtree, seen_list);
3343
3344 /* Recurse according to subtree's type.
3345 Every branch must return a Lisp_Object. */
3346 switch (XTYPE (subtree))
3347 {
3348 case Lisp_Vectorlike:
3349 {
3350 ptrdiff_t i = 0, length = 0;
3351 if (BOOL_VECTOR_P (subtree))
3352 return subtree; /* No sub-objects anyway. */
3353 else if (CHAR_TABLE_P (subtree) || SUB_CHAR_TABLE_P (subtree)
3354 || COMPILEDP (subtree) || HASH_TABLE_P (subtree))
3355 length = ASIZE (subtree) & PSEUDOVECTOR_SIZE_MASK;
3356 else if (VECTORP (subtree))
3357 length = ASIZE (subtree);
3358 else
3359 /* An unknown pseudovector may contain non-Lisp fields, so we
3360 can't just blindly traverse all its fields. We used to call
3361 `Flength' which signaled `sequencep', so I just preserved this
3362 behavior. */
3363 wrong_type_argument (Qsequencep, subtree);
3364
3365 if (SUB_CHAR_TABLE_P (subtree))
3366 i = 2;
3367 for ( ; i < length; i++)
3368 SUBSTITUTE (AREF (subtree, i),
3369 ASET (subtree, i, true_value));
3370 return subtree;
3371 }
3372
3373 case Lisp_Cons:
3374 {
3375 SUBSTITUTE (XCAR (subtree),
3376 XSETCAR (subtree, true_value));
3377 SUBSTITUTE (XCDR (subtree),
3378 XSETCDR (subtree, true_value));
3379 return subtree;
3380 }
3381
3382 case Lisp_String:
3383 {
3384 /* Check for text properties in each interval.
3385 substitute_in_interval contains part of the logic. */
3386
3387 INTERVAL root_interval = string_intervals (subtree);
3388 AUTO_CONS (arg, object, placeholder);
3389
3390 traverse_intervals_noorder (root_interval,
3391 &substitute_in_interval, arg);
3392
3393 return subtree;
3394 }
3395
3396 /* Other types don't recurse any further. */
3397 default:
3398 return subtree;
3399 }
3400 }
3401
3402 /* Helper function for substitute_object_recurse. */
3403 static void
3404 substitute_in_interval (INTERVAL interval, Lisp_Object arg)
3405 {
3406 Lisp_Object object = Fcar (arg);
3407 Lisp_Object placeholder = Fcdr (arg);
3408
3409 SUBSTITUTE (interval->plist, set_interval_plist (interval, true_value));
3410 }
3411
3412 \f
3413 #define LEAD_INT 1
3414 #define DOT_CHAR 2
3415 #define TRAIL_INT 4
3416 #define E_EXP 16
3417
3418
3419 /* Convert STRING to a number, assuming base BASE. Return a fixnum if CP has
3420 integer syntax and fits in a fixnum, else return the nearest float if CP has
3421 either floating point or integer syntax and BASE is 10, else return nil. If
3422 IGNORE_TRAILING, consider just the longest prefix of CP that has
3423 valid floating point syntax. Signal an overflow if BASE is not 10 and the
3424 number has integer syntax but does not fit. */
3425
3426 Lisp_Object
3427 string_to_number (char const *string, int base, bool ignore_trailing)
3428 {
3429 int state;
3430 char const *cp = string;
3431 int leading_digit;
3432 bool float_syntax = 0;
3433 double value = 0;
3434
3435 /* Negate the value ourselves. This treats 0, NaNs, and infinity properly on
3436 IEEE floating point hosts, and works around a formerly-common bug where
3437 atof ("-0.0") drops the sign. */
3438 bool negative = *cp == '-';
3439
3440 bool signedp = negative || *cp == '+';
3441 cp += signedp;
3442
3443 state = 0;
3444
3445 leading_digit = digit_to_number (*cp, base);
3446 if (leading_digit >= 0)
3447 {
3448 state |= LEAD_INT;
3449 do
3450 ++cp;
3451 while (digit_to_number (*cp, base) >= 0);
3452 }
3453 if (*cp == '.')
3454 {
3455 state |= DOT_CHAR;
3456 cp++;
3457 }
3458
3459 if (base == 10)
3460 {
3461 if ('0' <= *cp && *cp <= '9')
3462 {
3463 state |= TRAIL_INT;
3464 do
3465 cp++;
3466 while ('0' <= *cp && *cp <= '9');
3467 }
3468 if (*cp == 'e' || *cp == 'E')
3469 {
3470 char const *ecp = cp;
3471 cp++;
3472 if (*cp == '+' || *cp == '-')
3473 cp++;
3474 if ('0' <= *cp && *cp <= '9')
3475 {
3476 state |= E_EXP;
3477 do
3478 cp++;
3479 while ('0' <= *cp && *cp <= '9');
3480 }
3481 else if (cp[-1] == '+'
3482 && cp[0] == 'I' && cp[1] == 'N' && cp[2] == 'F')
3483 {
3484 state |= E_EXP;
3485 cp += 3;
3486 value = INFINITY;
3487 }
3488 else if (cp[-1] == '+'
3489 && cp[0] == 'N' && cp[1] == 'a' && cp[2] == 'N')
3490 {
3491 state |= E_EXP;
3492 cp += 3;
3493 /* NAN is a "positive" NaN on all known Emacs hosts. */
3494 value = NAN;
3495 }
3496 else
3497 cp = ecp;
3498 }
3499
3500 float_syntax = ((state & (DOT_CHAR|TRAIL_INT)) == (DOT_CHAR|TRAIL_INT)
3501 || state == (LEAD_INT|E_EXP));
3502 }
3503
3504 /* Return nil if the number uses invalid syntax. If IGNORE_TRAILING, accept
3505 any prefix that matches. Otherwise, the entire string must match. */
3506 if (! (ignore_trailing
3507 ? ((state & LEAD_INT) != 0 || float_syntax)
3508 : (!*cp && ((state & ~DOT_CHAR) == LEAD_INT || float_syntax))))
3509 return Qnil;
3510
3511 /* If the number uses integer and not float syntax, and is in C-language
3512 range, use its value, preferably as a fixnum. */
3513 if (leading_digit >= 0 && ! float_syntax)
3514 {
3515 uintmax_t n;
3516
3517 /* Fast special case for single-digit integers. This also avoids a
3518 glitch when BASE is 16 and IGNORE_TRAILING, because in that
3519 case some versions of strtoumax accept numbers like "0x1" that Emacs
3520 does not allow. */
3521 if (digit_to_number (string[signedp + 1], base) < 0)
3522 return make_number (negative ? -leading_digit : leading_digit);
3523
3524 errno = 0;
3525 n = strtoumax (string + signedp, NULL, base);
3526 if (errno == ERANGE)
3527 {
3528 /* Unfortunately there's no simple and accurate way to convert
3529 non-base-10 numbers that are out of C-language range. */
3530 if (base != 10)
3531 xsignal1 (Qoverflow_error, build_string (string));
3532 }
3533 else if (n <= (negative ? -MOST_NEGATIVE_FIXNUM : MOST_POSITIVE_FIXNUM))
3534 {
3535 EMACS_INT signed_n = n;
3536 return make_number (negative ? -signed_n : signed_n);
3537 }
3538 else
3539 value = n;
3540 }
3541
3542 /* Either the number uses float syntax, or it does not fit into a fixnum.
3543 Convert it from string to floating point, unless the value is already
3544 known because it is an infinity, a NAN, or its absolute value fits in
3545 uintmax_t. */
3546 if (! value)
3547 value = atof (string + signedp);
3548
3549 return make_float (negative ? -value : value);
3550 }
3551
3552 \f
3553 static Lisp_Object
3554 read_vector (Lisp_Object readcharfun, bool bytecodeflag)
3555 {
3556 ptrdiff_t i, size;
3557 Lisp_Object *ptr;
3558 Lisp_Object tem, item, vector;
3559 struct Lisp_Cons *otem;
3560 Lisp_Object len;
3561
3562 tem = read_list (1, readcharfun);
3563 len = Flength (tem);
3564 vector = Fmake_vector (len, Qnil);
3565
3566 size = ASIZE (vector);
3567 ptr = XVECTOR (vector)->contents;
3568 for (i = 0; i < size; i++)
3569 {
3570 item = Fcar (tem);
3571 /* If `load-force-doc-strings' is t when reading a lazily-loaded
3572 bytecode object, the docstring containing the bytecode and
3573 constants values must be treated as unibyte and passed to
3574 Fread, to get the actual bytecode string and constants vector. */
3575 if (bytecodeflag && load_force_doc_strings)
3576 {
3577 if (i == COMPILED_BYTECODE)
3578 {
3579 if (!STRINGP (item))
3580 error ("Invalid byte code");
3581
3582 /* Delay handling the bytecode slot until we know whether
3583 it is lazily-loaded (we can tell by whether the
3584 constants slot is nil). */
3585 ASET (vector, COMPILED_CONSTANTS, item);
3586 item = Qnil;
3587 }
3588 else if (i == COMPILED_CONSTANTS)
3589 {
3590 Lisp_Object bytestr = ptr[COMPILED_CONSTANTS];
3591
3592 if (NILP (item))
3593 {
3594 /* Coerce string to unibyte (like string-as-unibyte,
3595 but without generating extra garbage and
3596 guaranteeing no change in the contents). */
3597 STRING_SET_CHARS (bytestr, SBYTES (bytestr));
3598 STRING_SET_UNIBYTE (bytestr);
3599
3600 item = Fread (Fcons (bytestr, readcharfun));
3601 if (!CONSP (item))
3602 error ("Invalid byte code");
3603
3604 otem = XCONS (item);
3605 bytestr = XCAR (item);
3606 item = XCDR (item);
3607 free_cons (otem);
3608 }
3609
3610 /* Now handle the bytecode slot. */
3611 ASET (vector, COMPILED_BYTECODE, bytestr);
3612 }
3613 else if (i == COMPILED_DOC_STRING
3614 && STRINGP (item)
3615 && ! STRING_MULTIBYTE (item))
3616 {
3617 if (EQ (readcharfun, Qget_emacs_mule_file_char))
3618 item = Fdecode_coding_string (item, Qemacs_mule, Qnil, Qnil);
3619 else
3620 item = Fstring_as_multibyte (item);
3621 }
3622 }
3623 ASET (vector, i, item);
3624 otem = XCONS (tem);
3625 tem = Fcdr (tem);
3626 free_cons (otem);
3627 }
3628 return vector;
3629 }
3630
3631 /* FLAG means check for ']' to terminate rather than ')' and '.'. */
3632
3633 static Lisp_Object
3634 read_list (bool flag, Lisp_Object readcharfun)
3635 {
3636 Lisp_Object val, tail;
3637 Lisp_Object elt, tem;
3638 /* 0 is the normal case.
3639 1 means this list is a doc reference; replace it with the number 0.
3640 2 means this list is a doc reference; replace it with the doc string. */
3641 int doc_reference = 0;
3642
3643 /* Initialize this to 1 if we are reading a list. */
3644 bool first_in_list = flag <= 0;
3645
3646 val = Qnil;
3647 tail = Qnil;
3648
3649 while (1)
3650 {
3651 int ch;
3652 elt = read1 (readcharfun, &ch, first_in_list);
3653
3654 first_in_list = 0;
3655
3656 /* While building, if the list starts with #$, treat it specially. */
3657 if (EQ (elt, Vload_file_name)
3658 && ! NILP (elt)
3659 && !NILP (Vpurify_flag))
3660 {
3661 if (NILP (Vdoc_file_name))
3662 /* We have not yet called Snarf-documentation, so assume
3663 this file is described in the DOC file
3664 and Snarf-documentation will fill in the right value later.
3665 For now, replace the whole list with 0. */
3666 doc_reference = 1;
3667 else
3668 /* We have already called Snarf-documentation, so make a relative
3669 file name for this file, so it can be found properly
3670 in the installed Lisp directory.
3671 We don't use Fexpand_file_name because that would make
3672 the directory absolute now. */
3673 {
3674 AUTO_STRING (dot_dot_lisp, "../lisp/");
3675 elt = concat2 (dot_dot_lisp, Ffile_name_nondirectory (elt));
3676 }
3677 }
3678 else if (EQ (elt, Vload_file_name)
3679 && ! NILP (elt)
3680 && load_force_doc_strings)
3681 doc_reference = 2;
3682
3683 if (ch)
3684 {
3685 if (flag > 0)
3686 {
3687 if (ch == ']')
3688 return val;
3689 invalid_syntax (") or . in a vector");
3690 }
3691 if (ch == ')')
3692 return val;
3693 if (ch == '.')
3694 {
3695 if (!NILP (tail))
3696 XSETCDR (tail, read0 (readcharfun));
3697 else
3698 val = read0 (readcharfun);
3699 read1 (readcharfun, &ch, 0);
3700
3701 if (ch == ')')
3702 {
3703 if (doc_reference == 1)
3704 return make_number (0);
3705 if (doc_reference == 2 && INTEGERP (XCDR (val)))
3706 {
3707 char *saved = NULL;
3708 file_offset saved_position;
3709 /* Get a doc string from the file we are loading.
3710 If it's in saved_doc_string, get it from there.
3711
3712 Here, we don't know if the string is a
3713 bytecode string or a doc string. As a
3714 bytecode string must be unibyte, we always
3715 return a unibyte string. If it is actually a
3716 doc string, caller must make it
3717 multibyte. */
3718
3719 /* Position is negative for user variables. */
3720 EMACS_INT pos = eabs (XINT (XCDR (val)));
3721 if (pos >= saved_doc_string_position
3722 && pos < (saved_doc_string_position
3723 + saved_doc_string_length))
3724 {
3725 saved = saved_doc_string;
3726 saved_position = saved_doc_string_position;
3727 }
3728 /* Look in prev_saved_doc_string the same way. */
3729 else if (pos >= prev_saved_doc_string_position
3730 && pos < (prev_saved_doc_string_position
3731 + prev_saved_doc_string_length))
3732 {
3733 saved = prev_saved_doc_string;
3734 saved_position = prev_saved_doc_string_position;
3735 }
3736 if (saved)
3737 {
3738 ptrdiff_t start = pos - saved_position;
3739 ptrdiff_t from, to;
3740
3741 /* Process quoting with ^A,
3742 and find the end of the string,
3743 which is marked with ^_ (037). */
3744 for (from = start, to = start;
3745 saved[from] != 037;)
3746 {
3747 int c = saved[from++];
3748 if (c == 1)
3749 {
3750 c = saved[from++];
3751 saved[to++] = (c == 1 ? c
3752 : c == '0' ? 0
3753 : c == '_' ? 037
3754 : c);
3755 }
3756 else
3757 saved[to++] = c;
3758 }
3759
3760 return make_unibyte_string (saved + start,
3761 to - start);
3762 }
3763 else
3764 return get_doc_string (val, 1, 0);
3765 }
3766
3767 return val;
3768 }
3769 invalid_syntax (". in wrong context");
3770 }
3771 invalid_syntax ("] in a list");
3772 }
3773 tem = list1 (elt);
3774 if (!NILP (tail))
3775 XSETCDR (tail, tem);
3776 else
3777 val = tem;
3778 tail = tem;
3779 }
3780 }
3781 \f
3782 static Lisp_Object initial_obarray;
3783
3784 /* `oblookup' stores the bucket number here, for the sake of Funintern. */
3785
3786 static size_t oblookup_last_bucket_number;
3787
3788 /* Get an error if OBARRAY is not an obarray.
3789 If it is one, return it. */
3790
3791 Lisp_Object
3792 check_obarray (Lisp_Object obarray)
3793 {
3794 /* We don't want to signal a wrong-type-argument error when we are
3795 shutting down due to a fatal error, and we don't want to hit
3796 assertions in VECTORP and ASIZE if the fatal error was during GC. */
3797 if (!fatal_error_in_progress
3798 && (!VECTORP (obarray) || ASIZE (obarray) == 0))
3799 {
3800 /* If Vobarray is now invalid, force it to be valid. */
3801 if (EQ (Vobarray, obarray)) Vobarray = initial_obarray;
3802 wrong_type_argument (Qvectorp, obarray);
3803 }
3804 return obarray;
3805 }
3806
3807 /* Intern symbol SYM in OBARRAY using bucket INDEX. */
3808
3809 static Lisp_Object
3810 intern_sym (Lisp_Object sym, Lisp_Object obarray, Lisp_Object index)
3811 {
3812 Lisp_Object *ptr;
3813
3814 XSYMBOL (sym)->interned = (EQ (obarray, initial_obarray)
3815 ? SYMBOL_INTERNED_IN_INITIAL_OBARRAY
3816 : SYMBOL_INTERNED);
3817
3818 if (SREF (SYMBOL_NAME (sym), 0) == ':' && EQ (obarray, initial_obarray))
3819 {
3820 XSYMBOL (sym)->constant = 1;
3821 XSYMBOL (sym)->redirect = SYMBOL_PLAINVAL;
3822 SET_SYMBOL_VAL (XSYMBOL (sym), sym);
3823 }
3824
3825 ptr = aref_addr (obarray, XINT (index));
3826 set_symbol_next (sym, SYMBOLP (*ptr) ? XSYMBOL (*ptr) : NULL);
3827 *ptr = sym;
3828 return sym;
3829 }
3830
3831 /* Intern a symbol with name STRING in OBARRAY using bucket INDEX. */
3832
3833 Lisp_Object
3834 intern_driver (Lisp_Object string, Lisp_Object obarray, Lisp_Object index)
3835 {
3836 return intern_sym (Fmake_symbol (string), obarray, index);
3837 }
3838
3839 /* Intern the C string STR: return a symbol with that name,
3840 interned in the current obarray. */
3841
3842 Lisp_Object
3843 intern_1 (const char *str, ptrdiff_t len)
3844 {
3845 Lisp_Object obarray = check_obarray (Vobarray);
3846 Lisp_Object tem = oblookup (obarray, str, len, len);
3847
3848 return (SYMBOLP (tem) ? tem
3849 /* The above `oblookup' was done on the basis of nchars==nbytes, so
3850 the string has to be unibyte. */
3851 : intern_driver (make_unibyte_string (str, len),
3852 obarray, tem));
3853 }
3854
3855 Lisp_Object
3856 intern_c_string_1 (const char *str, ptrdiff_t len)
3857 {
3858 Lisp_Object obarray = check_obarray (Vobarray);
3859 Lisp_Object tem = oblookup (obarray, str, len, len);
3860
3861 if (!SYMBOLP (tem))
3862 {
3863 /* Creating a non-pure string from a string literal not implemented yet.
3864 We could just use make_string here and live with the extra copy. */
3865 eassert (!NILP (Vpurify_flag));
3866 tem = intern_driver (make_pure_c_string (str, len), obarray, tem);
3867 }
3868 return tem;
3869 }
3870
3871 static void
3872 define_symbol (Lisp_Object sym, char const *str)
3873 {
3874 ptrdiff_t len = strlen (str);
3875 Lisp_Object string = make_pure_c_string (str, len);
3876 init_symbol (sym, string);
3877
3878 /* Qunbound is uninterned, so that it's not confused with any symbol
3879 'unbound' created by a Lisp program. */
3880 if (! EQ (sym, Qunbound))
3881 {
3882 Lisp_Object bucket = oblookup (initial_obarray, str, len, len);
3883 eassert (INTEGERP (bucket));
3884 intern_sym (sym, initial_obarray, bucket);
3885 }
3886 }
3887 \f
3888 DEFUN ("intern", Fintern, Sintern, 1, 2, 0,
3889 doc: /* Return the canonical symbol whose name is STRING.
3890 If there is none, one is created by this function and returned.
3891 A second optional argument specifies the obarray to use;
3892 it defaults to the value of `obarray'. */)
3893 (Lisp_Object string, Lisp_Object obarray)
3894 {
3895 Lisp_Object tem;
3896
3897 obarray = check_obarray (NILP (obarray) ? Vobarray : obarray);
3898 CHECK_STRING (string);
3899
3900 tem = oblookup (obarray, SSDATA (string), SCHARS (string), SBYTES (string));
3901 if (!SYMBOLP (tem))
3902 tem = intern_driver (NILP (Vpurify_flag) ? string : Fpurecopy (string),
3903 obarray, tem);
3904 return tem;
3905 }
3906
3907 DEFUN ("intern-soft", Fintern_soft, Sintern_soft, 1, 2, 0,
3908 doc: /* Return the canonical symbol named NAME, or nil if none exists.
3909 NAME may be a string or a symbol. If it is a symbol, that exact
3910 symbol is searched for.
3911 A second optional argument specifies the obarray to use;
3912 it defaults to the value of `obarray'. */)
3913 (Lisp_Object name, Lisp_Object obarray)
3914 {
3915 register Lisp_Object tem, string;
3916
3917 if (NILP (obarray)) obarray = Vobarray;
3918 obarray = check_obarray (obarray);
3919
3920 if (!SYMBOLP (name))
3921 {
3922 CHECK_STRING (name);
3923 string = name;
3924 }
3925 else
3926 string = SYMBOL_NAME (name);
3927
3928 tem = oblookup (obarray, SSDATA (string), SCHARS (string), SBYTES (string));
3929 if (INTEGERP (tem) || (SYMBOLP (name) && !EQ (name, tem)))
3930 return Qnil;
3931 else
3932 return tem;
3933 }
3934 \f
3935 DEFUN ("unintern", Funintern, Sunintern, 1, 2, 0,
3936 doc: /* Delete the symbol named NAME, if any, from OBARRAY.
3937 The value is t if a symbol was found and deleted, nil otherwise.
3938 NAME may be a string or a symbol. If it is a symbol, that symbol
3939 is deleted, if it belongs to OBARRAY--no other symbol is deleted.
3940 OBARRAY, if nil, defaults to the value of the variable `obarray'.
3941 usage: (unintern NAME OBARRAY) */)
3942 (Lisp_Object name, Lisp_Object obarray)
3943 {
3944 register Lisp_Object string, tem;
3945 size_t hash;
3946
3947 if (NILP (obarray)) obarray = Vobarray;
3948 obarray = check_obarray (obarray);
3949
3950 if (SYMBOLP (name))
3951 string = SYMBOL_NAME (name);
3952 else
3953 {
3954 CHECK_STRING (name);
3955 string = name;
3956 }
3957
3958 tem = oblookup (obarray, SSDATA (string),
3959 SCHARS (string),
3960 SBYTES (string));
3961 if (INTEGERP (tem))
3962 return Qnil;
3963 /* If arg was a symbol, don't delete anything but that symbol itself. */
3964 if (SYMBOLP (name) && !EQ (name, tem))
3965 return Qnil;
3966
3967 /* There are plenty of other symbols which will screw up the Emacs
3968 session if we unintern them, as well as even more ways to use
3969 `setq' or `fset' or whatnot to make the Emacs session
3970 unusable. Let's not go down this silly road. --Stef */
3971 /* if (EQ (tem, Qnil) || EQ (tem, Qt))
3972 error ("Attempt to unintern t or nil"); */
3973
3974 XSYMBOL (tem)->interned = SYMBOL_UNINTERNED;
3975
3976 hash = oblookup_last_bucket_number;
3977
3978 if (EQ (AREF (obarray, hash), tem))
3979 {
3980 if (XSYMBOL (tem)->next)
3981 {
3982 Lisp_Object sym;
3983 XSETSYMBOL (sym, XSYMBOL (tem)->next);
3984 ASET (obarray, hash, sym);
3985 }
3986 else
3987 ASET (obarray, hash, make_number (0));
3988 }
3989 else
3990 {
3991 Lisp_Object tail, following;
3992
3993 for (tail = AREF (obarray, hash);
3994 XSYMBOL (tail)->next;
3995 tail = following)
3996 {
3997 XSETSYMBOL (following, XSYMBOL (tail)->next);
3998 if (EQ (following, tem))
3999 {
4000 set_symbol_next (tail, XSYMBOL (following)->next);
4001 break;
4002 }
4003 }
4004 }
4005
4006 return Qt;
4007 }
4008 \f
4009 /* Return the symbol in OBARRAY whose names matches the string
4010 of SIZE characters (SIZE_BYTE bytes) at PTR.
4011 If there is no such symbol, return the integer bucket number of
4012 where the symbol would be if it were present.
4013
4014 Also store the bucket number in oblookup_last_bucket_number. */
4015
4016 Lisp_Object
4017 oblookup (Lisp_Object obarray, register const char *ptr, ptrdiff_t size, ptrdiff_t size_byte)
4018 {
4019 size_t hash;
4020 size_t obsize;
4021 register Lisp_Object tail;
4022 Lisp_Object bucket, tem;
4023
4024 obarray = check_obarray (obarray);
4025 /* This is sometimes needed in the middle of GC. */
4026 obsize = gc_asize (obarray);
4027 hash = hash_string (ptr, size_byte) % obsize;
4028 bucket = AREF (obarray, hash);
4029 oblookup_last_bucket_number = hash;
4030 if (EQ (bucket, make_number (0)))
4031 ;
4032 else if (!SYMBOLP (bucket))
4033 error ("Bad data in guts of obarray"); /* Like CADR error message. */
4034 else
4035 for (tail = bucket; ; XSETSYMBOL (tail, XSYMBOL (tail)->next))
4036 {
4037 if (SBYTES (SYMBOL_NAME (tail)) == size_byte
4038 && SCHARS (SYMBOL_NAME (tail)) == size
4039 && !memcmp (SDATA (SYMBOL_NAME (tail)), ptr, size_byte))
4040 return tail;
4041 else if (XSYMBOL (tail)->next == 0)
4042 break;
4043 }
4044 XSETINT (tem, hash);
4045 return tem;
4046 }
4047 \f
4048 void
4049 map_obarray (Lisp_Object obarray, void (*fn) (Lisp_Object, Lisp_Object), Lisp_Object arg)
4050 {
4051 ptrdiff_t i;
4052 register Lisp_Object tail;
4053 CHECK_VECTOR (obarray);
4054 for (i = ASIZE (obarray) - 1; i >= 0; i--)
4055 {
4056 tail = AREF (obarray, i);
4057 if (SYMBOLP (tail))
4058 while (1)
4059 {
4060 (*fn) (tail, arg);
4061 if (XSYMBOL (tail)->next == 0)
4062 break;
4063 XSETSYMBOL (tail, XSYMBOL (tail)->next);
4064 }
4065 }
4066 }
4067
4068 static void
4069 mapatoms_1 (Lisp_Object sym, Lisp_Object function)
4070 {
4071 call1 (function, sym);
4072 }
4073
4074 DEFUN ("mapatoms", Fmapatoms, Smapatoms, 1, 2, 0,
4075 doc: /* Call FUNCTION on every symbol in OBARRAY.
4076 OBARRAY defaults to the value of `obarray'. */)
4077 (Lisp_Object function, Lisp_Object obarray)
4078 {
4079 if (NILP (obarray)) obarray = Vobarray;
4080 obarray = check_obarray (obarray);
4081
4082 map_obarray (obarray, mapatoms_1, function);
4083 return Qnil;
4084 }
4085
4086 #define OBARRAY_SIZE 1511
4087
4088 void
4089 init_obarray (void)
4090 {
4091 Lisp_Object oblength;
4092 ptrdiff_t size = 100 + MAX_MULTIBYTE_LENGTH;
4093
4094 XSETFASTINT (oblength, OBARRAY_SIZE);
4095
4096 Vobarray = Fmake_vector (oblength, make_number (0));
4097 initial_obarray = Vobarray;
4098 staticpro (&initial_obarray);
4099
4100 for (int i = 0; i < ARRAYELTS (lispsym); i++)
4101 define_symbol (builtin_lisp_symbol (i), defsym_name[i]);
4102
4103 DEFSYM (Qunbound, "unbound");
4104
4105 DEFSYM (Qnil, "nil");
4106 SET_SYMBOL_VAL (XSYMBOL (Qnil), Qnil);
4107 XSYMBOL (Qnil)->constant = 1;
4108 XSYMBOL (Qnil)->declared_special = true;
4109
4110 DEFSYM (Qt, "t");
4111 SET_SYMBOL_VAL (XSYMBOL (Qt), Qt);
4112 XSYMBOL (Qt)->constant = 1;
4113 XSYMBOL (Qt)->declared_special = true;
4114
4115 /* Qt is correct even if CANNOT_DUMP. loadup.el will set to nil at end. */
4116 Vpurify_flag = Qt;
4117
4118 DEFSYM (Qvariable_documentation, "variable-documentation");
4119
4120 read_buffer = xmalloc (size);
4121 read_buffer_size = size;
4122 }
4123 \f
4124 void
4125 defsubr (struct Lisp_Subr *sname)
4126 {
4127 Lisp_Object sym, tem;
4128 sym = intern_c_string (sname->symbol_name);
4129 XSETPVECTYPE (sname, PVEC_SUBR);
4130 XSETSUBR (tem, sname);
4131 set_symbol_function (sym, tem);
4132 }
4133
4134 #ifdef NOTDEF /* Use fset in subr.el now! */
4135 void
4136 defalias (struct Lisp_Subr *sname, char *string)
4137 {
4138 Lisp_Object sym;
4139 sym = intern (string);
4140 XSETSUBR (XSYMBOL (sym)->function, sname);
4141 }
4142 #endif /* NOTDEF */
4143
4144 /* Define an "integer variable"; a symbol whose value is forwarded to a
4145 C variable of type EMACS_INT. Sample call (with "xx" to fool make-docfile):
4146 DEFxxVAR_INT ("emacs-priority", &emacs_priority, "Documentation"); */
4147 void
4148 defvar_int (struct Lisp_Intfwd *i_fwd,
4149 const char *namestring, EMACS_INT *address)
4150 {
4151 Lisp_Object sym;
4152 sym = intern_c_string (namestring);
4153 i_fwd->type = Lisp_Fwd_Int;
4154 i_fwd->intvar = address;
4155 XSYMBOL (sym)->declared_special = 1;
4156 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
4157 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)i_fwd);
4158 }
4159
4160 /* Similar but define a variable whose value is t if address contains 1,
4161 nil if address contains 0. */
4162 void
4163 defvar_bool (struct Lisp_Boolfwd *b_fwd,
4164 const char *namestring, bool *address)
4165 {
4166 Lisp_Object sym;
4167 sym = intern_c_string (namestring);
4168 b_fwd->type = Lisp_Fwd_Bool;
4169 b_fwd->boolvar = address;
4170 XSYMBOL (sym)->declared_special = 1;
4171 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
4172 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)b_fwd);
4173 Vbyte_boolean_vars = Fcons (sym, Vbyte_boolean_vars);
4174 }
4175
4176 /* Similar but define a variable whose value is the Lisp Object stored
4177 at address. Two versions: with and without gc-marking of the C
4178 variable. The nopro version is used when that variable will be
4179 gc-marked for some other reason, since marking the same slot twice
4180 can cause trouble with strings. */
4181 void
4182 defvar_lisp_nopro (struct Lisp_Objfwd *o_fwd,
4183 const char *namestring, Lisp_Object *address)
4184 {
4185 Lisp_Object sym;
4186 sym = intern_c_string (namestring);
4187 o_fwd->type = Lisp_Fwd_Obj;
4188 o_fwd->objvar = address;
4189 XSYMBOL (sym)->declared_special = 1;
4190 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
4191 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)o_fwd);
4192 }
4193
4194 void
4195 defvar_lisp (struct Lisp_Objfwd *o_fwd,
4196 const char *namestring, Lisp_Object *address)
4197 {
4198 defvar_lisp_nopro (o_fwd, namestring, address);
4199 staticpro (address);
4200 }
4201
4202 /* Similar but define a variable whose value is the Lisp Object stored
4203 at a particular offset in the current kboard object. */
4204
4205 void
4206 defvar_kboard (struct Lisp_Kboard_Objfwd *ko_fwd,
4207 const char *namestring, int offset)
4208 {
4209 Lisp_Object sym;
4210 sym = intern_c_string (namestring);
4211 ko_fwd->type = Lisp_Fwd_Kboard_Obj;
4212 ko_fwd->offset = offset;
4213 XSYMBOL (sym)->declared_special = 1;
4214 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
4215 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)ko_fwd);
4216 }
4217 \f
4218 /* Check that the elements of lpath exist. */
4219
4220 static void
4221 load_path_check (Lisp_Object lpath)
4222 {
4223 Lisp_Object path_tail;
4224
4225 /* The only elements that might not exist are those from
4226 PATH_LOADSEARCH, EMACSLOADPATH. Anything else is only added if
4227 it exists. */
4228 for (path_tail = lpath; !NILP (path_tail); path_tail = XCDR (path_tail))
4229 {
4230 Lisp_Object dirfile;
4231 dirfile = Fcar (path_tail);
4232 if (STRINGP (dirfile))
4233 {
4234 dirfile = Fdirectory_file_name (dirfile);
4235 if (! file_accessible_directory_p (dirfile))
4236 dir_warning ("Lisp directory", XCAR (path_tail));
4237 }
4238 }
4239 }
4240
4241 /* Return the default load-path, to be used if EMACSLOADPATH is unset.
4242 This does not include the standard site-lisp directories
4243 under the installation prefix (i.e., PATH_SITELOADSEARCH),
4244 but it does (unless no_site_lisp is set) include site-lisp
4245 directories in the source/build directories if those exist and we
4246 are running uninstalled.
4247
4248 Uses the following logic:
4249 If CANNOT_DUMP: Use PATH_LOADSEARCH.
4250 The remainder is what happens when dumping works:
4251 If purify-flag (ie dumping) just use PATH_DUMPLOADSEARCH.
4252 Otherwise use PATH_LOADSEARCH.
4253
4254 If !initialized, then just return PATH_DUMPLOADSEARCH.
4255 If initialized:
4256 If Vinstallation_directory is not nil (ie, running uninstalled):
4257 If installation-dir/lisp exists and not already a member,
4258 we must be running uninstalled. Reset the load-path
4259 to just installation-dir/lisp. (The default PATH_LOADSEARCH
4260 refers to the eventual installation directories. Since we
4261 are not yet installed, we should not use them, even if they exist.)
4262 If installation-dir/lisp does not exist, just add
4263 PATH_DUMPLOADSEARCH at the end instead.
4264 Add installation-dir/site-lisp (if !no_site_lisp, and exists
4265 and not already a member) at the front.
4266 If installation-dir != source-dir (ie running an uninstalled,
4267 out-of-tree build) AND install-dir/src/Makefile exists BUT
4268 install-dir/src/Makefile.in does NOT exist (this is a sanity
4269 check), then repeat the above steps for source-dir/lisp, site-lisp. */
4270
4271 static Lisp_Object
4272 load_path_default (void)
4273 {
4274 Lisp_Object lpath = Qnil;
4275 const char *normal;
4276
4277 #ifdef CANNOT_DUMP
4278 #ifdef HAVE_NS
4279 const char *loadpath = ns_load_path ();
4280 #endif
4281
4282 normal = PATH_LOADSEARCH;
4283 #ifdef HAVE_NS
4284 lpath = decode_env_path (0, loadpath ? loadpath : normal, 0);
4285 #else
4286 lpath = decode_env_path (0, normal, 0);
4287 #endif
4288
4289 #else /* !CANNOT_DUMP */
4290
4291 normal = NILP (Vpurify_flag) ? PATH_LOADSEARCH : PATH_DUMPLOADSEARCH;
4292
4293 if (initialized)
4294 {
4295 #ifdef HAVE_NS
4296 const char *loadpath = ns_load_path ();
4297 lpath = decode_env_path (0, loadpath ? loadpath : normal, 0);
4298 #else
4299 lpath = decode_env_path (0, normal, 0);
4300 #endif
4301 if (!NILP (Vinstallation_directory))
4302 {
4303 Lisp_Object tem, tem1;
4304
4305 /* Add to the path the lisp subdir of the installation
4306 dir, if it is accessible. Note: in out-of-tree builds,
4307 this directory is empty save for Makefile. */
4308 tem = Fexpand_file_name (build_string ("lisp"),
4309 Vinstallation_directory);
4310 tem1 = Ffile_accessible_directory_p (tem);
4311 if (!NILP (tem1))
4312 {
4313 if (NILP (Fmember (tem, lpath)))
4314 {
4315 /* We are running uninstalled. The default load-path
4316 points to the eventual installed lisp directories.
4317 We should not use those now, even if they exist,
4318 so start over from a clean slate. */
4319 lpath = list1 (tem);
4320 }
4321 }
4322 else
4323 /* That dir doesn't exist, so add the build-time
4324 Lisp dirs instead. */
4325 {
4326 Lisp_Object dump_path =
4327 decode_env_path (0, PATH_DUMPLOADSEARCH, 0);
4328 lpath = nconc2 (lpath, dump_path);
4329 }
4330
4331 /* Add site-lisp under the installation dir, if it exists. */
4332 if (!no_site_lisp)
4333 {
4334 tem = Fexpand_file_name (build_string ("site-lisp"),
4335 Vinstallation_directory);
4336 tem1 = Ffile_accessible_directory_p (tem);
4337 if (!NILP (tem1))
4338 {
4339 if (NILP (Fmember (tem, lpath)))
4340 lpath = Fcons (tem, lpath);
4341 }
4342 }
4343
4344 /* If Emacs was not built in the source directory,
4345 and it is run from where it was built, add to load-path
4346 the lisp and site-lisp dirs under that directory. */
4347
4348 if (NILP (Fequal (Vinstallation_directory, Vsource_directory)))
4349 {
4350 Lisp_Object tem2;
4351
4352 tem = Fexpand_file_name (build_string ("src/Makefile"),
4353 Vinstallation_directory);
4354 tem1 = Ffile_exists_p (tem);
4355
4356 /* Don't be fooled if they moved the entire source tree
4357 AFTER dumping Emacs. If the build directory is indeed
4358 different from the source dir, src/Makefile.in and
4359 src/Makefile will not be found together. */
4360 tem = Fexpand_file_name (build_string ("src/Makefile.in"),
4361 Vinstallation_directory);
4362 tem2 = Ffile_exists_p (tem);
4363 if (!NILP (tem1) && NILP (tem2))
4364 {
4365 tem = Fexpand_file_name (build_string ("lisp"),
4366 Vsource_directory);
4367
4368 if (NILP (Fmember (tem, lpath)))
4369 lpath = Fcons (tem, lpath);
4370
4371 if (!no_site_lisp)
4372 {
4373 tem = Fexpand_file_name (build_string ("site-lisp"),
4374 Vsource_directory);
4375 tem1 = Ffile_accessible_directory_p (tem);
4376 if (!NILP (tem1))
4377 {
4378 if (NILP (Fmember (tem, lpath)))
4379 lpath = Fcons (tem, lpath);
4380 }
4381 }
4382 }
4383 } /* Vinstallation_directory != Vsource_directory */
4384
4385 } /* if Vinstallation_directory */
4386 }
4387 else /* !initialized */
4388 {
4389 /* NORMAL refers to PATH_DUMPLOADSEARCH, ie the lisp dir in the
4390 source directory. We used to add ../lisp (ie the lisp dir in
4391 the build directory) at the front here, but that should not
4392 be necessary, since in out of tree builds lisp/ is empty, save
4393 for Makefile. */
4394 lpath = decode_env_path (0, normal, 0);
4395 }
4396 #endif /* !CANNOT_DUMP */
4397
4398 return lpath;
4399 }
4400
4401 void
4402 init_lread (void)
4403 {
4404 /* First, set Vload_path. */
4405
4406 /* Ignore EMACSLOADPATH when dumping. */
4407 #ifdef CANNOT_DUMP
4408 bool use_loadpath = true;
4409 #else
4410 bool use_loadpath = NILP (Vpurify_flag);
4411 #endif
4412
4413 if (use_loadpath && egetenv ("EMACSLOADPATH"))
4414 {
4415 Vload_path = decode_env_path ("EMACSLOADPATH", 0, 1);
4416
4417 /* Check (non-nil) user-supplied elements. */
4418 load_path_check (Vload_path);
4419
4420 /* If no nils in the environment variable, use as-is.
4421 Otherwise, replace any nils with the default. */
4422 if (! NILP (Fmemq (Qnil, Vload_path)))
4423 {
4424 Lisp_Object elem, elpath = Vload_path;
4425 Lisp_Object default_lpath = load_path_default ();
4426
4427 /* Check defaults, before adding site-lisp. */
4428 load_path_check (default_lpath);
4429
4430 /* Add the site-lisp directories to the front of the default. */
4431 if (!no_site_lisp && PATH_SITELOADSEARCH[0] != '\0')
4432 {
4433 Lisp_Object sitelisp;
4434 sitelisp = decode_env_path (0, PATH_SITELOADSEARCH, 0);
4435 if (! NILP (sitelisp))
4436 default_lpath = nconc2 (sitelisp, default_lpath);
4437 }
4438
4439 Vload_path = Qnil;
4440
4441 /* Replace nils from EMACSLOADPATH by default. */
4442 while (CONSP (elpath))
4443 {
4444 elem = XCAR (elpath);
4445 elpath = XCDR (elpath);
4446 Vload_path = CALLN (Fappend, Vload_path,
4447 NILP (elem) ? default_lpath : list1 (elem));
4448 }
4449 } /* Fmemq (Qnil, Vload_path) */
4450 }
4451 else
4452 {
4453 Vload_path = load_path_default ();
4454
4455 /* Check before adding site-lisp directories.
4456 The install should have created them, but they are not
4457 required, so no need to warn if they are absent.
4458 Or we might be running before installation. */
4459 load_path_check (Vload_path);
4460
4461 /* Add the site-lisp directories at the front. */
4462 if (initialized && !no_site_lisp && PATH_SITELOADSEARCH[0] != '\0')
4463 {
4464 Lisp_Object sitelisp;
4465 sitelisp = decode_env_path (0, PATH_SITELOADSEARCH, 0);
4466 if (! NILP (sitelisp)) Vload_path = nconc2 (sitelisp, Vload_path);
4467 }
4468 }
4469
4470 Vvalues = Qnil;
4471
4472 load_in_progress = 0;
4473 Vload_file_name = Qnil;
4474 Vstandard_input = Qt;
4475 Vloads_in_progress = Qnil;
4476 }
4477
4478 /* Print a warning that directory intended for use USE and with name
4479 DIRNAME cannot be accessed. On entry, errno should correspond to
4480 the access failure. Print the warning on stderr and put it in
4481 *Messages*. */
4482
4483 void
4484 dir_warning (char const *use, Lisp_Object dirname)
4485 {
4486 static char const format[] = "Warning: %s '%s': %s\n";
4487 int access_errno = errno;
4488 fprintf (stderr, format, use, SSDATA (ENCODE_SYSTEM (dirname)),
4489 strerror (access_errno));
4490
4491 /* Don't log the warning before we've initialized!! */
4492 if (initialized)
4493 {
4494 char const *diagnostic = emacs_strerror (access_errno);
4495 USE_SAFE_ALLOCA;
4496 char *buffer = SAFE_ALLOCA (sizeof format - 3 * (sizeof "%s" - 1)
4497 + strlen (use) + SBYTES (dirname)
4498 + strlen (diagnostic));
4499 ptrdiff_t message_len = esprintf (buffer, format, use, SSDATA (dirname),
4500 diagnostic);
4501 message_dolog (buffer, message_len, 0, STRING_MULTIBYTE (dirname));
4502 SAFE_FREE ();
4503 }
4504 }
4505
4506 void
4507 syms_of_lread (void)
4508 {
4509 defsubr (&Sread);
4510 defsubr (&Sread_from_string);
4511 defsubr (&Sintern);
4512 defsubr (&Sintern_soft);
4513 defsubr (&Sunintern);
4514 defsubr (&Sget_load_suffixes);
4515 defsubr (&Sload);
4516 defsubr (&Seval_buffer);
4517 defsubr (&Seval_region);
4518 defsubr (&Sread_char);
4519 defsubr (&Sread_char_exclusive);
4520 defsubr (&Sread_event);
4521 defsubr (&Sget_file_char);
4522 defsubr (&Smapatoms);
4523 defsubr (&Slocate_file_internal);
4524
4525 DEFVAR_LISP ("obarray", Vobarray,
4526 doc: /* Symbol table for use by `intern' and `read'.
4527 It is a vector whose length ought to be prime for best results.
4528 The vector's contents don't make sense if examined from Lisp programs;
4529 to find all the symbols in an obarray, use `mapatoms'. */);
4530
4531 DEFVAR_LISP ("values", Vvalues,
4532 doc: /* List of values of all expressions which were read, evaluated and printed.
4533 Order is reverse chronological. */);
4534 XSYMBOL (intern ("values"))->declared_special = 0;
4535
4536 DEFVAR_LISP ("standard-input", Vstandard_input,
4537 doc: /* Stream for read to get input from.
4538 See documentation of `read' for possible values. */);
4539 Vstandard_input = Qt;
4540
4541 DEFVAR_LISP ("read-with-symbol-positions", Vread_with_symbol_positions,
4542 doc: /* If non-nil, add position of read symbols to `read-symbol-positions-list'.
4543
4544 If this variable is a buffer, then only forms read from that buffer
4545 will be added to `read-symbol-positions-list'.
4546 If this variable is t, then all read forms will be added.
4547 The effect of all other values other than nil are not currently
4548 defined, although they may be in the future.
4549
4550 The positions are relative to the last call to `read' or
4551 `read-from-string'. It is probably a bad idea to set this variable at
4552 the toplevel; bind it instead. */);
4553 Vread_with_symbol_positions = Qnil;
4554
4555 DEFVAR_LISP ("read-symbol-positions-list", Vread_symbol_positions_list,
4556 doc: /* A list mapping read symbols to their positions.
4557 This variable is modified during calls to `read' or
4558 `read-from-string', but only when `read-with-symbol-positions' is
4559 non-nil.
4560
4561 Each element of the list looks like (SYMBOL . CHAR-POSITION), where
4562 CHAR-POSITION is an integer giving the offset of that occurrence of the
4563 symbol from the position where `read' or `read-from-string' started.
4564
4565 Note that a symbol will appear multiple times in this list, if it was
4566 read multiple times. The list is in the same order as the symbols
4567 were read in. */);
4568 Vread_symbol_positions_list = Qnil;
4569
4570 DEFVAR_LISP ("read-circle", Vread_circle,
4571 doc: /* Non-nil means read recursive structures using #N= and #N# syntax. */);
4572 Vread_circle = Qt;
4573
4574 DEFVAR_LISP ("load-path", Vload_path,
4575 doc: /* List of directories to search for files to load.
4576 Each element is a string (directory file name) or nil (meaning
4577 `default-directory').
4578 This list is consulted by the `require' function.
4579 Initialized during startup as described in Info node `(elisp)Library Search'.
4580 Use `directory-file-name' when adding items to this path. However, Lisp
4581 programs that process this list should tolerate directories both with
4582 and without trailing slashes. */);
4583
4584 DEFVAR_LISP ("load-suffixes", Vload_suffixes,
4585 doc: /* List of suffixes for Emacs Lisp files and dynamic modules.
4586 This list includes suffixes for both compiled and source Emacs Lisp files.
4587 This list should not include the empty string.
4588 `load' and related functions try to append these suffixes, in order,
4589 to the specified file name if a suffix is allowed or required. */);
4590 #ifdef HAVE_MODULES
4591 Vload_suffixes = list3 (build_pure_c_string (".elc"),
4592 build_pure_c_string (".el"),
4593 build_pure_c_string (MODULES_SUFFIX));
4594 #else
4595 Vload_suffixes = list2 (build_pure_c_string (".elc"),
4596 build_pure_c_string (".el"));
4597 #endif
4598 DEFVAR_LISP ("module-file-suffix", Vmodule_file_suffix,
4599 doc: /* Suffix of loadable module file, or nil of modules are not supported. */);
4600 #ifdef HAVE_MODULES
4601 Vmodule_file_suffix = build_pure_c_string (MODULES_SUFFIX);
4602 #else
4603 Vmodule_file_suffix = Qnil;
4604 #endif
4605 DEFVAR_LISP ("load-file-rep-suffixes", Vload_file_rep_suffixes,
4606 doc: /* List of suffixes that indicate representations of \
4607 the same file.
4608 This list should normally start with the empty string.
4609
4610 Enabling Auto Compression mode appends the suffixes in
4611 `jka-compr-load-suffixes' to this list and disabling Auto Compression
4612 mode removes them again. `load' and related functions use this list to
4613 determine whether they should look for compressed versions of a file
4614 and, if so, which suffixes they should try to append to the file name
4615 in order to do so. However, if you want to customize which suffixes
4616 the loading functions recognize as compression suffixes, you should
4617 customize `jka-compr-load-suffixes' rather than the present variable. */);
4618 Vload_file_rep_suffixes = list1 (empty_unibyte_string);
4619
4620 DEFVAR_BOOL ("load-in-progress", load_in_progress,
4621 doc: /* Non-nil if inside of `load'. */);
4622 DEFSYM (Qload_in_progress, "load-in-progress");
4623
4624 DEFVAR_LISP ("after-load-alist", Vafter_load_alist,
4625 doc: /* An alist of functions to be evalled when particular files are loaded.
4626 Each element looks like (REGEXP-OR-FEATURE FUNCS...).
4627
4628 REGEXP-OR-FEATURE is either a regular expression to match file names, or
4629 a symbol (a feature name).
4630
4631 When `load' is run and the file-name argument matches an element's
4632 REGEXP-OR-FEATURE, or when `provide' is run and provides the symbol
4633 REGEXP-OR-FEATURE, the FUNCS in the element are called.
4634
4635 An error in FORMS does not undo the load, but does prevent execution of
4636 the rest of the FORMS. */);
4637 Vafter_load_alist = Qnil;
4638
4639 DEFVAR_LISP ("load-history", Vload_history,
4640 doc: /* Alist mapping loaded file names to symbols and features.
4641 Each alist element should be a list (FILE-NAME ENTRIES...), where
4642 FILE-NAME is the name of a file that has been loaded into Emacs.
4643 The file name is absolute and true (i.e. it doesn't contain symlinks).
4644 As an exception, one of the alist elements may have FILE-NAME nil,
4645 for symbols and features not associated with any file.
4646
4647 The remaining ENTRIES in the alist element describe the functions and
4648 variables defined in that file, the features provided, and the
4649 features required. Each entry has the form `(provide . FEATURE)',
4650 `(require . FEATURE)', `(defun . FUNCTION)', `(autoload . SYMBOL)',
4651 `(defface . SYMBOL)', or `(t . SYMBOL)'. Entries like `(t . SYMBOL)'
4652 may precede a `(defun . FUNCTION)' entry, and means that SYMBOL was an
4653 autoload before this file redefined it as a function. In addition,
4654 entries may also be single symbols, which means that SYMBOL was
4655 defined by `defvar' or `defconst'.
4656
4657 During preloading, the file name recorded is relative to the main Lisp
4658 directory. These file names are converted to absolute at startup. */);
4659 Vload_history = Qnil;
4660
4661 DEFVAR_LISP ("load-file-name", Vload_file_name,
4662 doc: /* Full name of file being loaded by `load'. */);
4663 Vload_file_name = Qnil;
4664
4665 DEFVAR_LISP ("user-init-file", Vuser_init_file,
4666 doc: /* File name, including directory, of user's initialization file.
4667 If the file loaded had extension `.elc', and the corresponding source file
4668 exists, this variable contains the name of source file, suitable for use
4669 by functions like `custom-save-all' which edit the init file.
4670 While Emacs loads and evaluates the init file, value is the real name
4671 of the file, regardless of whether or not it has the `.elc' extension. */);
4672 Vuser_init_file = Qnil;
4673
4674 DEFVAR_LISP ("current-load-list", Vcurrent_load_list,
4675 doc: /* Used for internal purposes by `load'. */);
4676 Vcurrent_load_list = Qnil;
4677
4678 DEFVAR_LISP ("load-read-function", Vload_read_function,
4679 doc: /* Function used by `load' and `eval-region' for reading expressions.
4680 Called with a single argument (the stream from which to read).
4681 The default is to use the function `read'. */);
4682 DEFSYM (Qread, "read");
4683 Vload_read_function = Qread;
4684
4685 DEFVAR_LISP ("load-source-file-function", Vload_source_file_function,
4686 doc: /* Function called in `load' to load an Emacs Lisp source file.
4687 The value should be a function for doing code conversion before
4688 reading a source file. It can also be nil, in which case loading is
4689 done without any code conversion.
4690
4691 If the value is a function, it is called with four arguments,
4692 FULLNAME, FILE, NOERROR, NOMESSAGE. FULLNAME is the absolute name of
4693 the file to load, FILE is the non-absolute name (for messages etc.),
4694 and NOERROR and NOMESSAGE are the corresponding arguments passed to
4695 `load'. The function should return t if the file was loaded. */);
4696 Vload_source_file_function = Qnil;
4697
4698 DEFVAR_BOOL ("load-force-doc-strings", load_force_doc_strings,
4699 doc: /* Non-nil means `load' should force-load all dynamic doc strings.
4700 This is useful when the file being loaded is a temporary copy. */);
4701 load_force_doc_strings = 0;
4702
4703 DEFVAR_BOOL ("load-convert-to-unibyte", load_convert_to_unibyte,
4704 doc: /* Non-nil means `read' converts strings to unibyte whenever possible.
4705 This is normally bound by `load' and `eval-buffer' to control `read',
4706 and is not meant for users to change. */);
4707 load_convert_to_unibyte = 0;
4708
4709 DEFVAR_LISP ("source-directory", Vsource_directory,
4710 doc: /* Directory in which Emacs sources were found when Emacs was built.
4711 You cannot count on them to still be there! */);
4712 Vsource_directory
4713 = Fexpand_file_name (build_string ("../"),
4714 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH, 0)));
4715
4716 DEFVAR_LISP ("preloaded-file-list", Vpreloaded_file_list,
4717 doc: /* List of files that were preloaded (when dumping Emacs). */);
4718 Vpreloaded_file_list = Qnil;
4719
4720 DEFVAR_LISP ("byte-boolean-vars", Vbyte_boolean_vars,
4721 doc: /* List of all DEFVAR_BOOL variables, used by the byte code optimizer. */);
4722 Vbyte_boolean_vars = Qnil;
4723
4724 DEFVAR_BOOL ("load-dangerous-libraries", load_dangerous_libraries,
4725 doc: /* Non-nil means load dangerous compiled Lisp files.
4726 Some versions of XEmacs use different byte codes than Emacs. These
4727 incompatible byte codes can make Emacs crash when it tries to execute
4728 them. */);
4729 load_dangerous_libraries = 0;
4730
4731 DEFVAR_BOOL ("force-load-messages", force_load_messages,
4732 doc: /* Non-nil means force printing messages when loading Lisp files.
4733 This overrides the value of the NOMESSAGE argument to `load'. */);
4734 force_load_messages = 0;
4735
4736 DEFVAR_LISP ("bytecomp-version-regexp", Vbytecomp_version_regexp,
4737 doc: /* Regular expression matching safe to load compiled Lisp files.
4738 When Emacs loads a compiled Lisp file, it reads the first 512 bytes
4739 from the file, and matches them against this regular expression.
4740 When the regular expression matches, the file is considered to be safe
4741 to load. See also `load-dangerous-libraries'. */);
4742 Vbytecomp_version_regexp
4743 = build_pure_c_string ("^;;;.\\(in Emacs version\\|bytecomp version FSF\\)");
4744
4745 DEFSYM (Qlexical_binding, "lexical-binding");
4746 DEFVAR_LISP ("lexical-binding", Vlexical_binding,
4747 doc: /* Whether to use lexical binding when evaluating code.
4748 Non-nil means that the code in the current buffer should be evaluated
4749 with lexical binding.
4750 This variable is automatically set from the file variables of an
4751 interpreted Lisp file read using `load'. Unlike other file local
4752 variables, this must be set in the first line of a file. */);
4753 Vlexical_binding = Qnil;
4754 Fmake_variable_buffer_local (Qlexical_binding);
4755
4756 DEFVAR_LISP ("eval-buffer-list", Veval_buffer_list,
4757 doc: /* List of buffers being read from by calls to `eval-buffer' and `eval-region'. */);
4758 Veval_buffer_list = Qnil;
4759
4760 DEFVAR_LISP ("old-style-backquotes", Vold_style_backquotes,
4761 doc: /* Set to non-nil when `read' encounters an old-style backquote. */);
4762 Vold_style_backquotes = Qnil;
4763 DEFSYM (Qold_style_backquotes, "old-style-backquotes");
4764
4765 DEFVAR_BOOL ("load-prefer-newer", load_prefer_newer,
4766 doc: /* Non-nil means `load' prefers the newest version of a file.
4767 This applies when a filename suffix is not explicitly specified and
4768 `load' is trying various possible suffixes (see `load-suffixes' and
4769 `load-file-rep-suffixes'). Normally, it stops at the first file
4770 that exists unless you explicitly specify one or the other. If this
4771 option is non-nil, it checks all suffixes and uses whichever file is
4772 newest.
4773 Note that if you customize this, obviously it will not affect files
4774 that are loaded before your customizations are read! */);
4775 load_prefer_newer = 0;
4776
4777 /* Vsource_directory was initialized in init_lread. */
4778
4779 DEFSYM (Qcurrent_load_list, "current-load-list");
4780 DEFSYM (Qstandard_input, "standard-input");
4781 DEFSYM (Qread_char, "read-char");
4782 DEFSYM (Qget_file_char, "get-file-char");
4783
4784 /* Used instead of Qget_file_char while loading *.elc files compiled
4785 by Emacs 21 or older. */
4786 DEFSYM (Qget_emacs_mule_file_char, "get-emacs-mule-file-char");
4787
4788 DEFSYM (Qload_force_doc_strings, "load-force-doc-strings");
4789
4790 DEFSYM (Qbackquote, "`");
4791 DEFSYM (Qcomma, ",");
4792 DEFSYM (Qcomma_at, ",@");
4793 DEFSYM (Qcomma_dot, ",.");
4794
4795 DEFSYM (Qinhibit_file_name_operation, "inhibit-file-name-operation");
4796 DEFSYM (Qascii_character, "ascii-character");
4797 DEFSYM (Qfunction, "function");
4798 DEFSYM (Qload, "load");
4799 DEFSYM (Qload_file_name, "load-file-name");
4800 DEFSYM (Qeval_buffer_list, "eval-buffer-list");
4801 DEFSYM (Qfile_truename, "file-truename");
4802 DEFSYM (Qdir_ok, "dir-ok");
4803 DEFSYM (Qdo_after_load_evaluation, "do-after-load-evaluation");
4804
4805 staticpro (&read_objects);
4806 read_objects = Qnil;
4807 staticpro (&seen_list);
4808 seen_list = Qnil;
4809
4810 Vloads_in_progress = Qnil;
4811 staticpro (&Vloads_in_progress);
4812
4813 DEFSYM (Qhash_table, "hash-table");
4814 DEFSYM (Qdata, "data");
4815 DEFSYM (Qtest, "test");
4816 DEFSYM (Qsize, "size");
4817 DEFSYM (Qweakness, "weakness");
4818 DEFSYM (Qrehash_size, "rehash-size");
4819 DEFSYM (Qrehash_threshold, "rehash-threshold");
4820
4821 DEFSYM (Qchar_from_name, "char-from-name");
4822 }