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