Undo the DEFUN->DEFUE change.
[bpt/emacs.git] / 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 int fn_size = 100;
1415 char buf[100];
1416 register char *fn = buf;
1417 int absolute = 0;
1418 int want_size;
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 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 size of any filename made from
1458 this path element/specified file name and any possible suffix. */
1459 want_size = max_suffix_len + SBYTES (filename) + 1;
1460 if (fn_size < want_size)
1461 fn = (char *) alloca (fn_size = 100 + want_size);
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 (XVECTOR (tmp)->size < 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 = XVECTOR (tmp)->size - 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 (XVECTOR (tmp)->size,
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 register char *p1;
3009 p1 = read_buffer;
3010 if (*p1 == '+' || *p1 == '-') p1++;
3011 /* Is it an integer? */
3012 if (p1 != p)
3013 {
3014 while (p1 != p && (c = *p1) >= '0' && c <= '9') p1++;
3015 /* Integers can have trailing decimal points. */
3016 if (p1 > read_buffer && p1 < p && *p1 == '.') p1++;
3017 if (p1 == p)
3018 /* It is an integer. */
3019 {
3020 if (p1[-1] == '.')
3021 p1[-1] = '\0';
3022 {
3023 /* EMACS_INT n = atol (read_buffer); */
3024 char *endptr = NULL;
3025 EMACS_INT n = (errno = 0,
3026 strtol (read_buffer, &endptr, 10));
3027 if (errno == ERANGE && endptr)
3028 {
3029 Lisp_Object args
3030 = Fcons (make_string (read_buffer,
3031 endptr - read_buffer),
3032 Qnil);
3033 xsignal (Qoverflow_error, args);
3034 }
3035 return make_fixnum_or_float (n);
3036 }
3037 }
3038 }
3039 if (isfloat_string (read_buffer, 0))
3040 {
3041 /* Compute NaN and infinities using 0.0 in a variable,
3042 to cope with compilers that think they are smarter
3043 than we are. */
3044 double zero = 0.0;
3045
3046 double value;
3047
3048 /* Negate the value ourselves. This treats 0, NaNs,
3049 and infinity properly on IEEE floating point hosts,
3050 and works around a common bug where atof ("-0.0")
3051 drops the sign. */
3052 int negative = read_buffer[0] == '-';
3053
3054 /* The only way p[-1] can be 'F' or 'N', after isfloat_string
3055 returns 1, is if the input ends in e+INF or e+NaN. */
3056 switch (p[-1])
3057 {
3058 case 'F':
3059 value = 1.0 / zero;
3060 break;
3061 case 'N':
3062 value = zero / zero;
3063
3064 /* If that made a "negative" NaN, negate it. */
3065
3066 {
3067 int i;
3068 union { double d; char c[sizeof (double)]; } u_data, u_minus_zero;
3069
3070 u_data.d = value;
3071 u_minus_zero.d = - 0.0;
3072 for (i = 0; i < sizeof (double); i++)
3073 if (u_data.c[i] & u_minus_zero.c[i])
3074 {
3075 value = - value;
3076 break;
3077 }
3078 }
3079 /* Now VALUE is a positive NaN. */
3080 break;
3081 default:
3082 value = atof (read_buffer + negative);
3083 break;
3084 }
3085
3086 return make_float (negative ? - value : value);
3087 }
3088 }
3089 {
3090 Lisp_Object name, result;
3091 EMACS_INT nbytes = p - read_buffer;
3092 EMACS_INT nchars
3093 = (multibyte
3094 ? multibyte_chars_in_text ((unsigned char *) read_buffer,
3095 nbytes)
3096 : nbytes);
3097
3098 if (uninterned_symbol && ! NILP (Vpurify_flag))
3099 name = make_pure_string (read_buffer, nchars, nbytes, multibyte);
3100 else
3101 name = make_specified_string (read_buffer, nchars, nbytes,multibyte);
3102 result = (uninterned_symbol ? Fmake_symbol (name)
3103 : Fintern (name, Qnil));
3104
3105 if (EQ (Vread_with_symbol_positions, Qt)
3106 || EQ (Vread_with_symbol_positions, readcharfun))
3107 Vread_symbol_positions_list =
3108 /* Kind of a hack; this will probably fail if characters
3109 in the symbol name were escaped. Not really a big
3110 deal, though. */
3111 Fcons (Fcons (result,
3112 make_number (readchar_count
3113 - XFASTINT (Flength (Fsymbol_name (result))))),
3114 Vread_symbol_positions_list);
3115 return result;
3116 }
3117 }
3118 }
3119 }
3120 \f
3121
3122 /* List of nodes we've seen during substitute_object_in_subtree. */
3123 static Lisp_Object seen_list;
3124
3125 static void
3126 substitute_object_in_subtree (Lisp_Object object, Lisp_Object placeholder)
3127 {
3128 Lisp_Object check_object;
3129
3130 /* We haven't seen any objects when we start. */
3131 seen_list = Qnil;
3132
3133 /* Make all the substitutions. */
3134 check_object
3135 = substitute_object_recurse (object, placeholder, object);
3136
3137 /* Clear seen_list because we're done with it. */
3138 seen_list = Qnil;
3139
3140 /* The returned object here is expected to always eq the
3141 original. */
3142 if (!EQ (check_object, object))
3143 error ("Unexpected mutation error in reader");
3144 }
3145
3146 /* Feval doesn't get called from here, so no gc protection is needed. */
3147 #define SUBSTITUTE(get_val, set_val) \
3148 do { \
3149 Lisp_Object old_value = get_val; \
3150 Lisp_Object true_value \
3151 = substitute_object_recurse (object, placeholder, \
3152 old_value); \
3153 \
3154 if (!EQ (old_value, true_value)) \
3155 { \
3156 set_val; \
3157 } \
3158 } while (0)
3159
3160 static Lisp_Object
3161 substitute_object_recurse (Lisp_Object object, Lisp_Object placeholder, Lisp_Object subtree)
3162 {
3163 /* If we find the placeholder, return the target object. */
3164 if (EQ (placeholder, subtree))
3165 return object;
3166
3167 /* If we've been to this node before, don't explore it again. */
3168 if (!EQ (Qnil, Fmemq (subtree, seen_list)))
3169 return subtree;
3170
3171 /* If this node can be the entry point to a cycle, remember that
3172 we've seen it. It can only be such an entry point if it was made
3173 by #n=, which means that we can find it as a value in
3174 read_objects. */
3175 if (!EQ (Qnil, Frassq (subtree, read_objects)))
3176 seen_list = Fcons (subtree, seen_list);
3177
3178 /* Recurse according to subtree's type.
3179 Every branch must return a Lisp_Object. */
3180 switch (XTYPE (subtree))
3181 {
3182 case Lisp_Vectorlike:
3183 {
3184 int i, length = 0;
3185 if (BOOL_VECTOR_P (subtree))
3186 return subtree; /* No sub-objects anyway. */
3187 else if (CHAR_TABLE_P (subtree) || SUB_CHAR_TABLE_P (subtree)
3188 || COMPILEDP (subtree))
3189 length = ASIZE (subtree) & PSEUDOVECTOR_SIZE_MASK;
3190 else if (VECTORP (subtree))
3191 length = ASIZE (subtree);
3192 else
3193 /* An unknown pseudovector may contain non-Lisp fields, so we
3194 can't just blindly traverse all its fields. We used to call
3195 `Flength' which signaled `sequencep', so I just preserved this
3196 behavior. */
3197 wrong_type_argument (Qsequencep, subtree);
3198
3199 for (i = 0; i < length; i++)
3200 SUBSTITUTE (AREF (subtree, i),
3201 ASET (subtree, i, true_value));
3202 return subtree;
3203 }
3204
3205 case Lisp_Cons:
3206 {
3207 SUBSTITUTE (XCAR (subtree),
3208 XSETCAR (subtree, true_value));
3209 SUBSTITUTE (XCDR (subtree),
3210 XSETCDR (subtree, true_value));
3211 return subtree;
3212 }
3213
3214 case Lisp_String:
3215 {
3216 /* Check for text properties in each interval.
3217 substitute_in_interval contains part of the logic. */
3218
3219 INTERVAL root_interval = STRING_INTERVALS (subtree);
3220 Lisp_Object arg = Fcons (object, placeholder);
3221
3222 traverse_intervals_noorder (root_interval,
3223 &substitute_in_interval, arg);
3224
3225 return subtree;
3226 }
3227
3228 /* Other types don't recurse any further. */
3229 default:
3230 return subtree;
3231 }
3232 }
3233
3234 /* Helper function for substitute_object_recurse. */
3235 static void
3236 substitute_in_interval (INTERVAL interval, Lisp_Object arg)
3237 {
3238 Lisp_Object object = Fcar (arg);
3239 Lisp_Object placeholder = Fcdr (arg);
3240
3241 SUBSTITUTE (interval->plist, interval->plist = true_value);
3242 }
3243
3244 \f
3245 #define LEAD_INT 1
3246 #define DOT_CHAR 2
3247 #define TRAIL_INT 4
3248 #define E_CHAR 8
3249 #define EXP_INT 16
3250
3251 int
3252 isfloat_string (const char *cp, int ignore_trailing)
3253 {
3254 int state;
3255 const char *start = cp;
3256
3257 state = 0;
3258 if (*cp == '+' || *cp == '-')
3259 cp++;
3260
3261 if (*cp >= '0' && *cp <= '9')
3262 {
3263 state |= LEAD_INT;
3264 while (*cp >= '0' && *cp <= '9')
3265 cp++;
3266 }
3267 if (*cp == '.')
3268 {
3269 state |= DOT_CHAR;
3270 cp++;
3271 }
3272 if (*cp >= '0' && *cp <= '9')
3273 {
3274 state |= TRAIL_INT;
3275 while (*cp >= '0' && *cp <= '9')
3276 cp++;
3277 }
3278 if (*cp == 'e' || *cp == 'E')
3279 {
3280 state |= E_CHAR;
3281 cp++;
3282 if (*cp == '+' || *cp == '-')
3283 cp++;
3284 }
3285
3286 if (*cp >= '0' && *cp <= '9')
3287 {
3288 state |= EXP_INT;
3289 while (*cp >= '0' && *cp <= '9')
3290 cp++;
3291 }
3292 else if (cp == start)
3293 ;
3294 else if (cp[-1] == '+' && cp[0] == 'I' && cp[1] == 'N' && cp[2] == 'F')
3295 {
3296 state |= EXP_INT;
3297 cp += 3;
3298 }
3299 else if (cp[-1] == '+' && cp[0] == 'N' && cp[1] == 'a' && cp[2] == 'N')
3300 {
3301 state |= EXP_INT;
3302 cp += 3;
3303 }
3304
3305 return ((ignore_trailing
3306 || *cp == 0 || *cp == ' ' || *cp == '\t' || *cp == '\n'
3307 || *cp == '\r' || *cp == '\f')
3308 && (state == (LEAD_INT|DOT_CHAR|TRAIL_INT)
3309 || state == (DOT_CHAR|TRAIL_INT)
3310 || state == (LEAD_INT|E_CHAR|EXP_INT)
3311 || state == (LEAD_INT|DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)
3312 || state == (DOT_CHAR|TRAIL_INT|E_CHAR|EXP_INT)));
3313 }
3314
3315 \f
3316 static Lisp_Object
3317 read_vector (Lisp_Object readcharfun, int bytecodeflag)
3318 {
3319 register int i;
3320 register int size;
3321 register Lisp_Object *ptr;
3322 register Lisp_Object tem, item, vector;
3323 register struct Lisp_Cons *otem;
3324 Lisp_Object len;
3325
3326 tem = read_list (1, readcharfun);
3327 len = Flength (tem);
3328 vector = (read_pure ? make_pure_vector (XINT (len)) : Fmake_vector (len, Qnil));
3329
3330 size = XVECTOR (vector)->size;
3331 ptr = XVECTOR (vector)->contents;
3332 for (i = 0; i < size; i++)
3333 {
3334 item = Fcar (tem);
3335 /* If `load-force-doc-strings' is t when reading a lazily-loaded
3336 bytecode object, the docstring containing the bytecode and
3337 constants values must be treated as unibyte and passed to
3338 Fread, to get the actual bytecode string and constants vector. */
3339 if (bytecodeflag && load_force_doc_strings)
3340 {
3341 if (i == COMPILED_BYTECODE)
3342 {
3343 if (!STRINGP (item))
3344 error ("Invalid byte code");
3345
3346 /* Delay handling the bytecode slot until we know whether
3347 it is lazily-loaded (we can tell by whether the
3348 constants slot is nil). */
3349 ptr[COMPILED_CONSTANTS] = item;
3350 item = Qnil;
3351 }
3352 else if (i == COMPILED_CONSTANTS)
3353 {
3354 Lisp_Object bytestr = ptr[COMPILED_CONSTANTS];
3355
3356 if (NILP (item))
3357 {
3358 /* Coerce string to unibyte (like string-as-unibyte,
3359 but without generating extra garbage and
3360 guaranteeing no change in the contents). */
3361 STRING_SET_CHARS (bytestr, SBYTES (bytestr));
3362 STRING_SET_UNIBYTE (bytestr);
3363
3364 item = Fread (Fcons (bytestr, readcharfun));
3365 if (!CONSP (item))
3366 error ("Invalid byte code");
3367
3368 otem = XCONS (item);
3369 bytestr = XCAR (item);
3370 item = XCDR (item);
3371 free_cons (otem);
3372 }
3373
3374 /* Now handle the bytecode slot. */
3375 ptr[COMPILED_BYTECODE] = read_pure ? Fpurecopy (bytestr) : bytestr;
3376 }
3377 else if (i == COMPILED_DOC_STRING
3378 && STRINGP (item)
3379 && ! STRING_MULTIBYTE (item))
3380 {
3381 if (EQ (readcharfun, Qget_emacs_mule_file_char))
3382 item = Fdecode_coding_string (item, Qemacs_mule, Qnil, Qnil);
3383 else
3384 item = Fstring_as_multibyte (item);
3385 }
3386 }
3387 ptr[i] = read_pure ? Fpurecopy (item) : item;
3388 otem = XCONS (tem);
3389 tem = Fcdr (tem);
3390 free_cons (otem);
3391 }
3392 return vector;
3393 }
3394
3395 /* FLAG = 1 means check for ] to terminate rather than ) and .
3396 FLAG = -1 means check for starting with defun
3397 and make structure pure. */
3398
3399 static Lisp_Object
3400 read_list (int flag, register Lisp_Object readcharfun)
3401 {
3402 /* -1 means check next element for defun,
3403 0 means don't check,
3404 1 means already checked and found defun. */
3405 int defunflag = flag < 0 ? -1 : 0;
3406 Lisp_Object val, tail;
3407 register Lisp_Object elt, tem;
3408 struct gcpro gcpro1, gcpro2;
3409 /* 0 is the normal case.
3410 1 means this list is a doc reference; replace it with the number 0.
3411 2 means this list is a doc reference; replace it with the doc string. */
3412 int doc_reference = 0;
3413
3414 /* Initialize this to 1 if we are reading a list. */
3415 int first_in_list = flag <= 0;
3416
3417 val = Qnil;
3418 tail = Qnil;
3419
3420 while (1)
3421 {
3422 int ch;
3423 GCPRO2 (val, tail);
3424 elt = read1 (readcharfun, &ch, first_in_list);
3425 UNGCPRO;
3426
3427 first_in_list = 0;
3428
3429 /* While building, if the list starts with #$, treat it specially. */
3430 if (EQ (elt, Vload_file_name)
3431 && ! NILP (elt)
3432 && !NILP (Vpurify_flag))
3433 {
3434 if (NILP (Vdoc_file_name))
3435 /* We have not yet called Snarf-documentation, so assume
3436 this file is described in the DOC-MM.NN file
3437 and Snarf-documentation will fill in the right value later.
3438 For now, replace the whole list with 0. */
3439 doc_reference = 1;
3440 else
3441 /* We have already called Snarf-documentation, so make a relative
3442 file name for this file, so it can be found properly
3443 in the installed Lisp directory.
3444 We don't use Fexpand_file_name because that would make
3445 the directory absolute now. */
3446 elt = concat2 (build_string ("../lisp/"),
3447 Ffile_name_nondirectory (elt));
3448 }
3449 else if (EQ (elt, Vload_file_name)
3450 && ! NILP (elt)
3451 && load_force_doc_strings)
3452 doc_reference = 2;
3453
3454 if (ch)
3455 {
3456 if (flag > 0)
3457 {
3458 if (ch == ']')
3459 return val;
3460 invalid_syntax (") or . in a vector", 18);
3461 }
3462 if (ch == ')')
3463 return val;
3464 if (ch == '.')
3465 {
3466 GCPRO2 (val, tail);
3467 if (!NILP (tail))
3468 XSETCDR (tail, read0 (readcharfun));
3469 else
3470 val = read0 (readcharfun);
3471 read1 (readcharfun, &ch, 0);
3472 UNGCPRO;
3473 if (ch == ')')
3474 {
3475 if (doc_reference == 1)
3476 return make_number (0);
3477 if (doc_reference == 2)
3478 {
3479 /* Get a doc string from the file we are loading.
3480 If it's in saved_doc_string, get it from there.
3481
3482 Here, we don't know if the string is a
3483 bytecode string or a doc string. As a
3484 bytecode string must be unibyte, we always
3485 return a unibyte string. If it is actually a
3486 doc string, caller must make it
3487 multibyte. */
3488
3489 int pos = XINT (XCDR (val));
3490 /* Position is negative for user variables. */
3491 if (pos < 0) pos = -pos;
3492 if (pos >= saved_doc_string_position
3493 && pos < (saved_doc_string_position
3494 + saved_doc_string_length))
3495 {
3496 int start = pos - saved_doc_string_position;
3497 int from, to;
3498
3499 /* Process quoting with ^A,
3500 and find the end of the string,
3501 which is marked with ^_ (037). */
3502 for (from = start, to = start;
3503 saved_doc_string[from] != 037;)
3504 {
3505 int c = saved_doc_string[from++];
3506 if (c == 1)
3507 {
3508 c = saved_doc_string[from++];
3509 if (c == 1)
3510 saved_doc_string[to++] = c;
3511 else if (c == '0')
3512 saved_doc_string[to++] = 0;
3513 else if (c == '_')
3514 saved_doc_string[to++] = 037;
3515 }
3516 else
3517 saved_doc_string[to++] = c;
3518 }
3519
3520 return make_unibyte_string (saved_doc_string + start,
3521 to - start);
3522 }
3523 /* Look in prev_saved_doc_string the same way. */
3524 else if (pos >= prev_saved_doc_string_position
3525 && pos < (prev_saved_doc_string_position
3526 + prev_saved_doc_string_length))
3527 {
3528 int start = pos - prev_saved_doc_string_position;
3529 int from, to;
3530
3531 /* Process quoting with ^A,
3532 and find the end of the string,
3533 which is marked with ^_ (037). */
3534 for (from = start, to = start;
3535 prev_saved_doc_string[from] != 037;)
3536 {
3537 int c = prev_saved_doc_string[from++];
3538 if (c == 1)
3539 {
3540 c = prev_saved_doc_string[from++];
3541 if (c == 1)
3542 prev_saved_doc_string[to++] = c;
3543 else if (c == '0')
3544 prev_saved_doc_string[to++] = 0;
3545 else if (c == '_')
3546 prev_saved_doc_string[to++] = 037;
3547 }
3548 else
3549 prev_saved_doc_string[to++] = c;
3550 }
3551
3552 return make_unibyte_string (prev_saved_doc_string
3553 + start,
3554 to - start);
3555 }
3556 else
3557 return get_doc_string (val, 1, 0);
3558 }
3559
3560 return val;
3561 }
3562 invalid_syntax (". in wrong context", 18);
3563 }
3564 invalid_syntax ("] in a list", 11);
3565 }
3566 tem = (read_pure && flag <= 0
3567 ? pure_cons (elt, Qnil)
3568 : Fcons (elt, Qnil));
3569 if (!NILP (tail))
3570 XSETCDR (tail, tem);
3571 else
3572 val = tem;
3573 tail = tem;
3574 if (defunflag < 0)
3575 defunflag = EQ (elt, Qdefun);
3576 else if (defunflag > 0)
3577 read_pure = 1;
3578 }
3579 }
3580 \f
3581 static Lisp_Object initial_obarray;
3582
3583 /* oblookup stores the bucket number here, for the sake of Funintern. */
3584
3585 static int oblookup_last_bucket_number;
3586
3587 static int hash_string (const char *ptr, int len);
3588
3589 /* Get an error if OBARRAY is not an obarray.
3590 If it is one, return it. */
3591
3592 Lisp_Object
3593 check_obarray (Lisp_Object obarray)
3594 {
3595 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3596 {
3597 /* If Vobarray is now invalid, force it to be valid. */
3598 if (EQ (Vobarray, obarray)) Vobarray = initial_obarray;
3599 wrong_type_argument (Qvectorp, obarray);
3600 }
3601 return obarray;
3602 }
3603
3604 /* Intern the C string STR: return a symbol with that name,
3605 interned in the current obarray. */
3606
3607 Lisp_Object
3608 intern (const char *str)
3609 {
3610 Lisp_Object tem;
3611 int len = strlen (str);
3612 Lisp_Object obarray;
3613
3614 obarray = Vobarray;
3615 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3616 obarray = check_obarray (obarray);
3617 tem = oblookup (obarray, str, len, len);
3618 if (SYMBOLP (tem))
3619 return tem;
3620 return Fintern (make_string (str, len), obarray);
3621 }
3622
3623 Lisp_Object
3624 intern_c_string (const char *str)
3625 {
3626 Lisp_Object tem;
3627 int len = strlen (str);
3628 Lisp_Object obarray;
3629
3630 obarray = Vobarray;
3631 if (!VECTORP (obarray) || XVECTOR (obarray)->size == 0)
3632 obarray = check_obarray (obarray);
3633 tem = oblookup (obarray, str, len, len);
3634 if (SYMBOLP (tem))
3635 return tem;
3636
3637 if (NILP (Vpurify_flag))
3638 /* Creating a non-pure string from a string literal not
3639 implemented yet. We could just use make_string here and live
3640 with the extra copy. */
3641 abort ();
3642
3643 return Fintern (make_pure_c_string (str), obarray);
3644 }
3645 \f
3646 DEFUN ("intern", Fintern, Sintern, 1, 2, 0,
3647 doc: /* Return the canonical symbol whose name is STRING.
3648 If there is none, one is created by this function and returned.
3649 A second optional argument specifies the obarray to use;
3650 it defaults to the value of `obarray'. */)
3651 (Lisp_Object string, Lisp_Object obarray)
3652 {
3653 register Lisp_Object tem, sym, *ptr;
3654
3655 if (NILP (obarray)) obarray = Vobarray;
3656 obarray = check_obarray (obarray);
3657
3658 CHECK_STRING (string);
3659
3660 tem = oblookup (obarray, SSDATA (string),
3661 SCHARS (string),
3662 SBYTES (string));
3663 if (!INTEGERP (tem))
3664 return tem;
3665
3666 if (!NILP (Vpurify_flag))
3667 string = Fpurecopy (string);
3668 sym = Fmake_symbol (string);
3669
3670 if (EQ (obarray, initial_obarray))
3671 XSYMBOL (sym)->interned = SYMBOL_INTERNED_IN_INITIAL_OBARRAY;
3672 else
3673 XSYMBOL (sym)->interned = SYMBOL_INTERNED;
3674
3675 if ((SREF (string, 0) == ':')
3676 && EQ (obarray, initial_obarray))
3677 {
3678 XSYMBOL (sym)->constant = 1;
3679 XSYMBOL (sym)->redirect = SYMBOL_PLAINVAL;
3680 SET_SYMBOL_VAL (XSYMBOL (sym), sym);
3681 }
3682
3683 ptr = &XVECTOR (obarray)->contents[XINT (tem)];
3684 if (SYMBOLP (*ptr))
3685 XSYMBOL (sym)->next = XSYMBOL (*ptr);
3686 else
3687 XSYMBOL (sym)->next = 0;
3688 *ptr = sym;
3689 return sym;
3690 }
3691
3692 DEFUN ("intern-soft", Fintern_soft, Sintern_soft, 1, 2, 0,
3693 doc: /* Return the canonical symbol named NAME, or nil if none exists.
3694 NAME may be a string or a symbol. If it is a symbol, that exact
3695 symbol is searched for.
3696 A second optional argument specifies the obarray to use;
3697 it defaults to the value of `obarray'. */)
3698 (Lisp_Object name, Lisp_Object obarray)
3699 {
3700 register Lisp_Object tem, string;
3701
3702 if (NILP (obarray)) obarray = Vobarray;
3703 obarray = check_obarray (obarray);
3704
3705 if (!SYMBOLP (name))
3706 {
3707 CHECK_STRING (name);
3708 string = name;
3709 }
3710 else
3711 string = SYMBOL_NAME (name);
3712
3713 tem = oblookup (obarray, SSDATA (string), SCHARS (string), SBYTES (string));
3714 if (INTEGERP (tem) || (SYMBOLP (name) && !EQ (name, tem)))
3715 return Qnil;
3716 else
3717 return tem;
3718 }
3719 \f
3720 DEFUN ("unintern", Funintern, Sunintern, 1, 2, 0,
3721 doc: /* Delete the symbol named NAME, if any, from OBARRAY.
3722 The value is t if a symbol was found and deleted, nil otherwise.
3723 NAME may be a string or a symbol. If it is a symbol, that symbol
3724 is deleted, if it belongs to OBARRAY--no other symbol is deleted.
3725 OBARRAY defaults to the value of the variable `obarray'. */)
3726 (Lisp_Object name, Lisp_Object obarray)
3727 {
3728 register Lisp_Object string, tem;
3729 int hash;
3730
3731 if (NILP (obarray)) obarray = Vobarray;
3732 obarray = check_obarray (obarray);
3733
3734 if (SYMBOLP (name))
3735 string = SYMBOL_NAME (name);
3736 else
3737 {
3738 CHECK_STRING (name);
3739 string = name;
3740 }
3741
3742 tem = oblookup (obarray, SSDATA (string),
3743 SCHARS (string),
3744 SBYTES (string));
3745 if (INTEGERP (tem))
3746 return Qnil;
3747 /* If arg was a symbol, don't delete anything but that symbol itself. */
3748 if (SYMBOLP (name) && !EQ (name, tem))
3749 return Qnil;
3750
3751 /* There are plenty of other symbols which will screw up the Emacs
3752 session if we unintern them, as well as even more ways to use
3753 `setq' or `fset' or whatnot to make the Emacs session
3754 unusable. Let's not go down this silly road. --Stef */
3755 /* if (EQ (tem, Qnil) || EQ (tem, Qt))
3756 error ("Attempt to unintern t or nil"); */
3757
3758 XSYMBOL (tem)->interned = SYMBOL_UNINTERNED;
3759
3760 hash = oblookup_last_bucket_number;
3761
3762 if (EQ (XVECTOR (obarray)->contents[hash], tem))
3763 {
3764 if (XSYMBOL (tem)->next)
3765 XSETSYMBOL (XVECTOR (obarray)->contents[hash], XSYMBOL (tem)->next);
3766 else
3767 XSETINT (XVECTOR (obarray)->contents[hash], 0);
3768 }
3769 else
3770 {
3771 Lisp_Object tail, following;
3772
3773 for (tail = XVECTOR (obarray)->contents[hash];
3774 XSYMBOL (tail)->next;
3775 tail = following)
3776 {
3777 XSETSYMBOL (following, XSYMBOL (tail)->next);
3778 if (EQ (following, tem))
3779 {
3780 XSYMBOL (tail)->next = XSYMBOL (following)->next;
3781 break;
3782 }
3783 }
3784 }
3785
3786 return Qt;
3787 }
3788 \f
3789 /* Return the symbol in OBARRAY whose names matches the string
3790 of SIZE characters (SIZE_BYTE bytes) at PTR.
3791 If there is no such symbol in OBARRAY, return nil.
3792
3793 Also store the bucket number in oblookup_last_bucket_number. */
3794
3795 Lisp_Object
3796 oblookup (Lisp_Object obarray, register const char *ptr, EMACS_INT size, EMACS_INT size_byte)
3797 {
3798 int hash;
3799 int obsize;
3800 register Lisp_Object tail;
3801 Lisp_Object bucket, tem;
3802
3803 if (!VECTORP (obarray)
3804 || (obsize = XVECTOR (obarray)->size) == 0)
3805 {
3806 obarray = check_obarray (obarray);
3807 obsize = XVECTOR (obarray)->size;
3808 }
3809 /* This is sometimes needed in the middle of GC. */
3810 obsize &= ~ARRAY_MARK_FLAG;
3811 hash = hash_string (ptr, size_byte) % obsize;
3812 bucket = XVECTOR (obarray)->contents[hash];
3813 oblookup_last_bucket_number = hash;
3814 if (EQ (bucket, make_number (0)))
3815 ;
3816 else if (!SYMBOLP (bucket))
3817 error ("Bad data in guts of obarray"); /* Like CADR error message */
3818 else
3819 for (tail = bucket; ; XSETSYMBOL (tail, XSYMBOL (tail)->next))
3820 {
3821 if (SBYTES (SYMBOL_NAME (tail)) == size_byte
3822 && SCHARS (SYMBOL_NAME (tail)) == size
3823 && !memcmp (SDATA (SYMBOL_NAME (tail)), ptr, size_byte))
3824 return tail;
3825 else if (XSYMBOL (tail)->next == 0)
3826 break;
3827 }
3828 XSETINT (tem, hash);
3829 return tem;
3830 }
3831
3832 static int
3833 hash_string (const char *ptr, int len)
3834 {
3835 register const char *p = ptr;
3836 register const char *end = p + len;
3837 register unsigned char c;
3838 register int hash = 0;
3839
3840 while (p != end)
3841 {
3842 c = *p++;
3843 if (c >= 0140) c -= 40;
3844 hash = ((hash<<3) + (hash>>28) + c);
3845 }
3846 return hash & 07777777777;
3847 }
3848 \f
3849 void
3850 map_obarray (Lisp_Object obarray, void (*fn) (Lisp_Object, Lisp_Object), Lisp_Object arg)
3851 {
3852 register int i;
3853 register Lisp_Object tail;
3854 CHECK_VECTOR (obarray);
3855 for (i = XVECTOR (obarray)->size - 1; i >= 0; i--)
3856 {
3857 tail = XVECTOR (obarray)->contents[i];
3858 if (SYMBOLP (tail))
3859 while (1)
3860 {
3861 (*fn) (tail, arg);
3862 if (XSYMBOL (tail)->next == 0)
3863 break;
3864 XSETSYMBOL (tail, XSYMBOL (tail)->next);
3865 }
3866 }
3867 }
3868
3869 static void
3870 mapatoms_1 (Lisp_Object sym, Lisp_Object function)
3871 {
3872 call1 (function, sym);
3873 }
3874
3875 DEFUN ("mapatoms", Fmapatoms, Smapatoms, 1, 2, 0,
3876 doc: /* Call FUNCTION on every symbol in OBARRAY.
3877 OBARRAY defaults to the value of `obarray'. */)
3878 (Lisp_Object function, Lisp_Object obarray)
3879 {
3880 if (NILP (obarray)) obarray = Vobarray;
3881 obarray = check_obarray (obarray);
3882
3883 map_obarray (obarray, mapatoms_1, function);
3884 return Qnil;
3885 }
3886
3887 #define OBARRAY_SIZE 1511
3888
3889 void
3890 init_obarray (void)
3891 {
3892 Lisp_Object oblength;
3893
3894 XSETFASTINT (oblength, OBARRAY_SIZE);
3895
3896 Vobarray = Fmake_vector (oblength, make_number (0));
3897 initial_obarray = Vobarray;
3898 staticpro (&initial_obarray);
3899
3900 Qunbound = Fmake_symbol (make_pure_c_string ("unbound"));
3901 /* Set temporary dummy values to Qnil and Vpurify_flag to satisfy the
3902 NILP (Vpurify_flag) check in intern_c_string. */
3903 Qnil = make_number (-1); Vpurify_flag = make_number (1);
3904 Qnil = intern_c_string ("nil");
3905
3906 /* Fmake_symbol inits fields of new symbols with Qunbound and Qnil,
3907 so those two need to be fixed manally. */
3908 SET_SYMBOL_VAL (XSYMBOL (Qunbound), Qunbound);
3909 XSYMBOL (Qunbound)->function = Qunbound;
3910 XSYMBOL (Qunbound)->plist = Qnil;
3911 /* XSYMBOL (Qnil)->function = Qunbound; */
3912 SET_SYMBOL_VAL (XSYMBOL (Qnil), Qnil);
3913 XSYMBOL (Qnil)->constant = 1;
3914 XSYMBOL (Qnil)->plist = Qnil;
3915
3916 Qt = intern_c_string ("t");
3917 SET_SYMBOL_VAL (XSYMBOL (Qt), Qt);
3918 XSYMBOL (Qt)->constant = 1;
3919
3920 /* Qt is correct even if CANNOT_DUMP. loadup.el will set to nil at end. */
3921 Vpurify_flag = Qt;
3922
3923 Qvariable_documentation = intern_c_string ("variable-documentation");
3924 staticpro (&Qvariable_documentation);
3925
3926 read_buffer_size = 100 + MAX_MULTIBYTE_LENGTH;
3927 read_buffer = (char *) xmalloc (read_buffer_size);
3928 }
3929 \f
3930 void
3931 defsubr (struct Lisp_Subr *sname)
3932 {
3933 Lisp_Object sym;
3934 sym = intern_c_string (sname->symbol_name);
3935 XSETPVECTYPE (sname, PVEC_SUBR);
3936 XSETSUBR (XSYMBOL (sym)->function, sname);
3937 }
3938
3939 #ifdef NOTDEF /* use fset in subr.el now */
3940 void
3941 defalias (sname, string)
3942 struct Lisp_Subr *sname;
3943 char *string;
3944 {
3945 Lisp_Object sym;
3946 sym = intern (string);
3947 XSETSUBR (XSYMBOL (sym)->function, sname);
3948 }
3949 #endif /* NOTDEF */
3950
3951 /* Define an "integer variable"; a symbol whose value is forwarded to a
3952 C variable of type int. Sample call (munged w "xx" to fool make-docfile):
3953 DEFxxVAR_INT ("emacs-priority", &emacs_priority, "Documentation"); */
3954 void
3955 defvar_int (struct Lisp_Intfwd *i_fwd,
3956 const char *namestring, EMACS_INT *address)
3957 {
3958 Lisp_Object sym;
3959 sym = intern_c_string (namestring);
3960 i_fwd->type = Lisp_Fwd_Int;
3961 i_fwd->intvar = address;
3962 XSYMBOL (sym)->declared_special = 1;
3963 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
3964 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)i_fwd);
3965 }
3966
3967 /* Similar but define a variable whose value is t if address contains 1,
3968 nil if address contains 0. */
3969 void
3970 defvar_bool (struct Lisp_Boolfwd *b_fwd,
3971 const char *namestring, int *address)
3972 {
3973 Lisp_Object sym;
3974 sym = intern_c_string (namestring);
3975 b_fwd->type = Lisp_Fwd_Bool;
3976 b_fwd->boolvar = address;
3977 XSYMBOL (sym)->declared_special = 1;
3978 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
3979 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)b_fwd);
3980 Vbyte_boolean_vars = Fcons (sym, Vbyte_boolean_vars);
3981 }
3982
3983 /* Similar but define a variable whose value is the Lisp Object stored
3984 at address. Two versions: with and without gc-marking of the C
3985 variable. The nopro version is used when that variable will be
3986 gc-marked for some other reason, since marking the same slot twice
3987 can cause trouble with strings. */
3988 void
3989 defvar_lisp_nopro (struct Lisp_Objfwd *o_fwd,
3990 const char *namestring, Lisp_Object *address)
3991 {
3992 Lisp_Object sym;
3993 sym = intern_c_string (namestring);
3994 o_fwd->type = Lisp_Fwd_Obj;
3995 o_fwd->objvar = address;
3996 XSYMBOL (sym)->declared_special = 1;
3997 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
3998 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)o_fwd);
3999 }
4000
4001 void
4002 defvar_lisp (struct Lisp_Objfwd *o_fwd,
4003 const char *namestring, Lisp_Object *address)
4004 {
4005 defvar_lisp_nopro (o_fwd, namestring, address);
4006 staticpro (address);
4007 }
4008
4009 /* Similar but define a variable whose value is the Lisp Object stored
4010 at a particular offset in the current kboard object. */
4011
4012 void
4013 defvar_kboard (struct Lisp_Kboard_Objfwd *ko_fwd,
4014 const char *namestring, int offset)
4015 {
4016 Lisp_Object sym;
4017 sym = intern_c_string (namestring);
4018 ko_fwd->type = Lisp_Fwd_Kboard_Obj;
4019 ko_fwd->offset = offset;
4020 XSYMBOL (sym)->declared_special = 1;
4021 XSYMBOL (sym)->redirect = SYMBOL_FORWARDED;
4022 SET_SYMBOL_FWD (XSYMBOL (sym), (union Lisp_Fwd *)ko_fwd);
4023 }
4024 \f
4025 /* Record the value of load-path used at the start of dumping
4026 so we can see if the site changed it later during dumping. */
4027 static Lisp_Object dump_path;
4028
4029 void
4030 init_lread (void)
4031 {
4032 const char *normal;
4033 int turn_off_warning = 0;
4034
4035 /* Compute the default load-path. */
4036 #ifdef CANNOT_DUMP
4037 normal = PATH_LOADSEARCH;
4038 Vload_path = decode_env_path (0, normal);
4039 #else
4040 if (NILP (Vpurify_flag))
4041 normal = PATH_LOADSEARCH;
4042 else
4043 normal = PATH_DUMPLOADSEARCH;
4044
4045 /* In a dumped Emacs, we normally have to reset the value of
4046 Vload_path from PATH_LOADSEARCH, since the value that was dumped
4047 uses ../lisp, instead of the path of the installed elisp
4048 libraries. However, if it appears that Vload_path was changed
4049 from the default before dumping, don't override that value. */
4050 if (initialized)
4051 {
4052 if (! NILP (Fequal (dump_path, Vload_path)))
4053 {
4054 Vload_path = decode_env_path (0, normal);
4055 if (!NILP (Vinstallation_directory))
4056 {
4057 Lisp_Object tem, tem1, sitelisp;
4058
4059 /* Remove site-lisp dirs from path temporarily and store
4060 them in sitelisp, then conc them on at the end so
4061 they're always first in path. */
4062 sitelisp = Qnil;
4063 while (1)
4064 {
4065 tem = Fcar (Vload_path);
4066 tem1 = Fstring_match (build_string ("site-lisp"),
4067 tem, Qnil);
4068 if (!NILP (tem1))
4069 {
4070 Vload_path = Fcdr (Vload_path);
4071 sitelisp = Fcons (tem, sitelisp);
4072 }
4073 else
4074 break;
4075 }
4076
4077 /* Add to the path the lisp subdir of the
4078 installation dir, if it exists. */
4079 tem = Fexpand_file_name (build_string ("lisp"),
4080 Vinstallation_directory);
4081 tem1 = Ffile_exists_p (tem);
4082 if (!NILP (tem1))
4083 {
4084 if (NILP (Fmember (tem, Vload_path)))
4085 {
4086 turn_off_warning = 1;
4087 Vload_path = Fcons (tem, Vload_path);
4088 }
4089 }
4090 else
4091 /* That dir doesn't exist, so add the build-time
4092 Lisp dirs instead. */
4093 Vload_path = nconc2 (Vload_path, dump_path);
4094
4095 /* Add leim under the installation dir, if it exists. */
4096 tem = Fexpand_file_name (build_string ("leim"),
4097 Vinstallation_directory);
4098 tem1 = Ffile_exists_p (tem);
4099 if (!NILP (tem1))
4100 {
4101 if (NILP (Fmember (tem, Vload_path)))
4102 Vload_path = Fcons (tem, Vload_path);
4103 }
4104
4105 /* Add site-lisp under the installation dir, if it exists. */
4106 tem = Fexpand_file_name (build_string ("site-lisp"),
4107 Vinstallation_directory);
4108 tem1 = Ffile_exists_p (tem);
4109 if (!NILP (tem1))
4110 {
4111 if (NILP (Fmember (tem, Vload_path)))
4112 Vload_path = Fcons (tem, Vload_path);
4113 }
4114
4115 /* If Emacs was not built in the source directory,
4116 and it is run from where it was built, add to load-path
4117 the lisp, leim and site-lisp dirs under that directory. */
4118
4119 if (NILP (Fequal (Vinstallation_directory, Vsource_directory)))
4120 {
4121 Lisp_Object tem2;
4122
4123 tem = Fexpand_file_name (build_string ("src/Makefile"),
4124 Vinstallation_directory);
4125 tem1 = Ffile_exists_p (tem);
4126
4127 /* Don't be fooled if they moved the entire source tree
4128 AFTER dumping Emacs. If the build directory is indeed
4129 different from the source dir, src/Makefile.in and
4130 src/Makefile will not be found together. */
4131 tem = Fexpand_file_name (build_string ("src/Makefile.in"),
4132 Vinstallation_directory);
4133 tem2 = Ffile_exists_p (tem);
4134 if (!NILP (tem1) && NILP (tem2))
4135 {
4136 tem = Fexpand_file_name (build_string ("lisp"),
4137 Vsource_directory);
4138
4139 if (NILP (Fmember (tem, Vload_path)))
4140 Vload_path = Fcons (tem, Vload_path);
4141
4142 tem = Fexpand_file_name (build_string ("leim"),
4143 Vsource_directory);
4144
4145 if (NILP (Fmember (tem, Vload_path)))
4146 Vload_path = Fcons (tem, Vload_path);
4147
4148 tem = Fexpand_file_name (build_string ("site-lisp"),
4149 Vsource_directory);
4150
4151 if (NILP (Fmember (tem, Vload_path)))
4152 Vload_path = Fcons (tem, Vload_path);
4153 }
4154 }
4155 if (!NILP (sitelisp) && !no_site_lisp)
4156 Vload_path = nconc2 (Fnreverse (sitelisp), Vload_path);
4157 }
4158 }
4159 }
4160 else
4161 {
4162 /* NORMAL refers to the lisp dir in the source directory. */
4163 /* We used to add ../lisp at the front here, but
4164 that caused trouble because it was copied from dump_path
4165 into Vload_path, above, when Vinstallation_directory was non-nil.
4166 It should be unnecessary. */
4167 Vload_path = decode_env_path (0, normal);
4168 dump_path = Vload_path;
4169 }
4170 #endif
4171
4172 #if (!(defined (WINDOWSNT) || (defined (HAVE_NS))))
4173 /* When Emacs is invoked over network shares on NT, PATH_LOADSEARCH is
4174 almost never correct, thereby causing a warning to be printed out that
4175 confuses users. Since PATH_LOADSEARCH is always overridden by the
4176 EMACSLOADPATH environment variable below, disable the warning on NT. */
4177
4178 /* Warn if dirs in the *standard* path don't exist. */
4179 if (!turn_off_warning)
4180 {
4181 Lisp_Object path_tail;
4182
4183 for (path_tail = Vload_path;
4184 !NILP (path_tail);
4185 path_tail = XCDR (path_tail))
4186 {
4187 Lisp_Object dirfile;
4188 dirfile = Fcar (path_tail);
4189 if (STRINGP (dirfile))
4190 {
4191 dirfile = Fdirectory_file_name (dirfile);
4192 if (access (SSDATA (dirfile), 0) < 0)
4193 dir_warning ("Warning: Lisp directory `%s' does not exist.\n",
4194 XCAR (path_tail));
4195 }
4196 }
4197 }
4198 #endif /* !(WINDOWSNT || HAVE_NS) */
4199
4200 /* If the EMACSLOADPATH environment variable is set, use its value.
4201 This doesn't apply if we're dumping. */
4202 #ifndef CANNOT_DUMP
4203 if (NILP (Vpurify_flag)
4204 && egetenv ("EMACSLOADPATH"))
4205 #endif
4206 Vload_path = decode_env_path ("EMACSLOADPATH", normal);
4207
4208 Vvalues = Qnil;
4209
4210 load_in_progress = 0;
4211 Vload_file_name = Qnil;
4212
4213 load_descriptor_list = Qnil;
4214
4215 Vstandard_input = Qt;
4216 Vloads_in_progress = Qnil;
4217 }
4218
4219 /* Print a warning, using format string FORMAT, that directory DIRNAME
4220 does not exist. Print it on stderr and put it in *Messages*. */
4221
4222 void
4223 dir_warning (const char *format, Lisp_Object dirname)
4224 {
4225 char *buffer
4226 = (char *) alloca (SCHARS (dirname) + strlen (format) + 5);
4227
4228 fprintf (stderr, format, SDATA (dirname));
4229 sprintf (buffer, format, SDATA (dirname));
4230 /* Don't log the warning before we've initialized!! */
4231 if (initialized)
4232 message_dolog (buffer, strlen (buffer), 0, STRING_MULTIBYTE (dirname));
4233 }
4234
4235 void
4236 syms_of_lread (void)
4237 {
4238 defsubr (&Sread);
4239 defsubr (&Sread_from_string);
4240 defsubr (&Sintern);
4241 defsubr (&Sintern_soft);
4242 defsubr (&Sunintern);
4243 defsubr (&Sget_load_suffixes);
4244 defsubr (&Sload);
4245 defsubr (&Seval_buffer);
4246 defsubr (&Seval_region);
4247 defsubr (&Sread_char);
4248 defsubr (&Sread_char_exclusive);
4249 defsubr (&Sread_event);
4250 defsubr (&Sget_file_char);
4251 defsubr (&Smapatoms);
4252 defsubr (&Slocate_file_internal);
4253
4254 DEFVAR_LISP ("obarray", Vobarray,
4255 doc: /* Symbol table for use by `intern' and `read'.
4256 It is a vector whose length ought to be prime for best results.
4257 The vector's contents don't make sense if examined from Lisp programs;
4258 to find all the symbols in an obarray, use `mapatoms'. */);
4259
4260 DEFVAR_LISP ("values", Vvalues,
4261 doc: /* List of values of all expressions which were read, evaluated and printed.
4262 Order is reverse chronological. */);
4263
4264 DEFVAR_LISP ("standard-input", Vstandard_input,
4265 doc: /* Stream for read to get input from.
4266 See documentation of `read' for possible values. */);
4267 Vstandard_input = Qt;
4268
4269 DEFVAR_LISP ("read-with-symbol-positions", Vread_with_symbol_positions,
4270 doc: /* If non-nil, add position of read symbols to `read-symbol-positions-list'.
4271
4272 If this variable is a buffer, then only forms read from that buffer
4273 will be added to `read-symbol-positions-list'.
4274 If this variable is t, then all read forms will be added.
4275 The effect of all other values other than nil are not currently
4276 defined, although they may be in the future.
4277
4278 The positions are relative to the last call to `read' or
4279 `read-from-string'. It is probably a bad idea to set this variable at
4280 the toplevel; bind it instead. */);
4281 Vread_with_symbol_positions = Qnil;
4282
4283 DEFVAR_LISP ("read-symbol-positions-list", Vread_symbol_positions_list,
4284 doc: /* A list mapping read symbols to their positions.
4285 This variable is modified during calls to `read' or
4286 `read-from-string', but only when `read-with-symbol-positions' is
4287 non-nil.
4288
4289 Each element of the list looks like (SYMBOL . CHAR-POSITION), where
4290 CHAR-POSITION is an integer giving the offset of that occurrence of the
4291 symbol from the position where `read' or `read-from-string' started.
4292
4293 Note that a symbol will appear multiple times in this list, if it was
4294 read multiple times. The list is in the same order as the symbols
4295 were read in. */);
4296 Vread_symbol_positions_list = Qnil;
4297
4298 DEFVAR_LISP ("read-circle", Vread_circle,
4299 doc: /* Non-nil means read recursive structures using #N= and #N# syntax. */);
4300 Vread_circle = Qt;
4301
4302 DEFVAR_LISP ("load-path", Vload_path,
4303 doc: /* *List of directories to search for files to load.
4304 Each element is a string (directory name) or nil (try default directory).
4305 Initialized based on EMACSLOADPATH environment variable, if any,
4306 otherwise to default specified by file `epaths.h' when Emacs was built. */);
4307
4308 DEFVAR_LISP ("load-suffixes", Vload_suffixes,
4309 doc: /* List of suffixes for (compiled or source) Emacs Lisp files.
4310 This list should not include the empty string.
4311 `load' and related functions try to append these suffixes, in order,
4312 to the specified file name if a Lisp suffix is allowed or required. */);
4313 Vload_suffixes = Fcons (make_pure_c_string (".elc"),
4314 Fcons (make_pure_c_string (".el"), Qnil));
4315 DEFVAR_LISP ("load-file-rep-suffixes", Vload_file_rep_suffixes,
4316 doc: /* List of suffixes that indicate representations of \
4317 the same file.
4318 This list should normally start with the empty string.
4319
4320 Enabling Auto Compression mode appends the suffixes in
4321 `jka-compr-load-suffixes' to this list and disabling Auto Compression
4322 mode removes them again. `load' and related functions use this list to
4323 determine whether they should look for compressed versions of a file
4324 and, if so, which suffixes they should try to append to the file name
4325 in order to do so. However, if you want to customize which suffixes
4326 the loading functions recognize as compression suffixes, you should
4327 customize `jka-compr-load-suffixes' rather than the present variable. */);
4328 Vload_file_rep_suffixes = Fcons (empty_unibyte_string, Qnil);
4329
4330 DEFVAR_BOOL ("load-in-progress", load_in_progress,
4331 doc: /* Non-nil if inside of `load'. */);
4332 Qload_in_progress = intern_c_string ("load-in-progress");
4333 staticpro (&Qload_in_progress);
4334
4335 DEFVAR_LISP ("after-load-alist", Vafter_load_alist,
4336 doc: /* An alist of expressions to be evalled when particular files are loaded.
4337 Each element looks like (REGEXP-OR-FEATURE FORMS...).
4338
4339 REGEXP-OR-FEATURE is either a regular expression to match file names, or
4340 a symbol \(a feature name).
4341
4342 When `load' is run and the file-name argument matches an element's
4343 REGEXP-OR-FEATURE, or when `provide' is run and provides the symbol
4344 REGEXP-OR-FEATURE, the FORMS in the element are executed.
4345
4346 An error in FORMS does not undo the load, but does prevent execution of
4347 the rest of the FORMS. */);
4348 Vafter_load_alist = Qnil;
4349
4350 DEFVAR_LISP ("load-history", Vload_history,
4351 doc: /* Alist mapping loaded file names to symbols and features.
4352 Each alist element should be a list (FILE-NAME ENTRIES...), where
4353 FILE-NAME is the name of a file that has been loaded into Emacs.
4354 The file name is absolute and true (i.e. it doesn't contain symlinks).
4355 As an exception, one of the alist elements may have FILE-NAME nil,
4356 for symbols and features not associated with any file.
4357
4358 The remaining ENTRIES in the alist element describe the functions and
4359 variables defined in that file, the features provided, and the
4360 features required. Each entry has the form `(provide . FEATURE)',
4361 `(require . FEATURE)', `(defun . FUNCTION)', `(autoload . SYMBOL)',
4362 `(defface . SYMBOL)', or `(t . SYMBOL)'. In addition, an entry `(t
4363 . SYMBOL)' may precede an entry `(defun . FUNCTION)', and means that
4364 SYMBOL was an autoload before this file redefined it as a function.
4365
4366 During preloading, the file name recorded is relative to the main Lisp
4367 directory. These file names are converted to absolute at startup. */);
4368 Vload_history = Qnil;
4369
4370 DEFVAR_LISP ("load-file-name", Vload_file_name,
4371 doc: /* Full name of file being loaded by `load'. */);
4372 Vload_file_name = Qnil;
4373
4374 DEFVAR_LISP ("user-init-file", Vuser_init_file,
4375 doc: /* File name, including directory, of user's initialization file.
4376 If the file loaded had extension `.elc', and the corresponding source file
4377 exists, this variable contains the name of source file, suitable for use
4378 by functions like `custom-save-all' which edit the init file.
4379 While Emacs loads and evaluates the init file, value is the real name
4380 of the file, regardless of whether or not it has the `.elc' extension. */);
4381 Vuser_init_file = Qnil;
4382
4383 DEFVAR_LISP ("current-load-list", Vcurrent_load_list,
4384 doc: /* Used for internal purposes by `load'. */);
4385 Vcurrent_load_list = Qnil;
4386
4387 DEFVAR_LISP ("load-read-function", Vload_read_function,
4388 doc: /* Function used by `load' and `eval-region' for reading expressions.
4389 The default is nil, which means use the function `read'. */);
4390 Vload_read_function = Qnil;
4391
4392 DEFVAR_LISP ("load-source-file-function", Vload_source_file_function,
4393 doc: /* Function called in `load' for loading an Emacs Lisp source file.
4394 This function is for doing code conversion before reading the source file.
4395 If nil, loading is done without any code conversion.
4396 Arguments are FULLNAME, FILE, NOERROR, NOMESSAGE, where
4397 FULLNAME is the full name of FILE.
4398 See `load' for the meaning of the remaining arguments. */);
4399 Vload_source_file_function = Qnil;
4400
4401 DEFVAR_BOOL ("load-force-doc-strings", load_force_doc_strings,
4402 doc: /* Non-nil means `load' should force-load all dynamic doc strings.
4403 This is useful when the file being loaded is a temporary copy. */);
4404 load_force_doc_strings = 0;
4405
4406 DEFVAR_BOOL ("load-convert-to-unibyte", load_convert_to_unibyte,
4407 doc: /* Non-nil means `read' converts strings to unibyte whenever possible.
4408 This is normally bound by `load' and `eval-buffer' to control `read',
4409 and is not meant for users to change. */);
4410 load_convert_to_unibyte = 0;
4411
4412 DEFVAR_LISP ("source-directory", Vsource_directory,
4413 doc: /* Directory in which Emacs sources were found when Emacs was built.
4414 You cannot count on them to still be there! */);
4415 Vsource_directory
4416 = Fexpand_file_name (build_string ("../"),
4417 Fcar (decode_env_path (0, PATH_DUMPLOADSEARCH)));
4418
4419 DEFVAR_LISP ("preloaded-file-list", Vpreloaded_file_list,
4420 doc: /* List of files that were preloaded (when dumping Emacs). */);
4421 Vpreloaded_file_list = Qnil;
4422
4423 DEFVAR_LISP ("byte-boolean-vars", Vbyte_boolean_vars,
4424 doc: /* List of all DEFVAR_BOOL variables, used by the byte code optimizer. */);
4425 Vbyte_boolean_vars = Qnil;
4426
4427 DEFVAR_BOOL ("load-dangerous-libraries", load_dangerous_libraries,
4428 doc: /* Non-nil means load dangerous compiled Lisp files.
4429 Some versions of XEmacs use different byte codes than Emacs. These
4430 incompatible byte codes can make Emacs crash when it tries to execute
4431 them. */);
4432 load_dangerous_libraries = 0;
4433
4434 DEFVAR_BOOL ("force-load-messages", force_load_messages,
4435 doc: /* Non-nil means force printing messages when loading Lisp files.
4436 This overrides the value of the NOMESSAGE argument to `load'. */);
4437 force_load_messages = 0;
4438
4439 DEFVAR_LISP ("bytecomp-version-regexp", Vbytecomp_version_regexp,
4440 doc: /* Regular expression matching safe to load compiled Lisp files.
4441 When Emacs loads a compiled Lisp file, it reads the first 512 bytes
4442 from the file, and matches them against this regular expression.
4443 When the regular expression matches, the file is considered to be safe
4444 to load. See also `load-dangerous-libraries'. */);
4445 Vbytecomp_version_regexp
4446 = make_pure_c_string ("^;;;.\\(in Emacs version\\|bytecomp version FSF\\)");
4447
4448 Qlexical_binding = intern ("lexical-binding");
4449 staticpro (&Qlexical_binding);
4450 DEFVAR_LISP ("lexical-binding", Vlexical_binding,
4451 doc: /* If non-nil, use lexical binding when evaluating code.
4452 This only applies to code evaluated by `eval-buffer' and `eval-region'.
4453 This variable is automatically set from the file variables of an interpreted
4454 Lisp file read using `load'. */);
4455 Fmake_variable_buffer_local (Qlexical_binding);
4456
4457 DEFVAR_LISP ("eval-buffer-list", Veval_buffer_list,
4458 doc: /* List of buffers being read from by calls to `eval-buffer' and `eval-region'. */);
4459 Veval_buffer_list = Qnil;
4460
4461 DEFVAR_LISP ("old-style-backquotes", Vold_style_backquotes,
4462 doc: /* Set to non-nil when `read' encounters an old-style backquote. */);
4463 Vold_style_backquotes = Qnil;
4464 Qold_style_backquotes = intern_c_string ("old-style-backquotes");
4465 staticpro (&Qold_style_backquotes);
4466
4467 /* Vsource_directory was initialized in init_lread. */
4468
4469 load_descriptor_list = Qnil;
4470 staticpro (&load_descriptor_list);
4471
4472 Qcurrent_load_list = intern_c_string ("current-load-list");
4473 staticpro (&Qcurrent_load_list);
4474
4475 Qstandard_input = intern_c_string ("standard-input");
4476 staticpro (&Qstandard_input);
4477
4478 Qread_char = intern_c_string ("read-char");
4479 staticpro (&Qread_char);
4480
4481 Qget_file_char = intern_c_string ("get-file-char");
4482 staticpro (&Qget_file_char);
4483
4484 Qget_emacs_mule_file_char = intern_c_string ("get-emacs-mule-file-char");
4485 staticpro (&Qget_emacs_mule_file_char);
4486
4487 Qload_force_doc_strings = intern_c_string ("load-force-doc-strings");
4488 staticpro (&Qload_force_doc_strings);
4489
4490 Qbackquote = intern_c_string ("`");
4491 staticpro (&Qbackquote);
4492 Qcomma = intern_c_string (",");
4493 staticpro (&Qcomma);
4494 Qcomma_at = intern_c_string (",@");
4495 staticpro (&Qcomma_at);
4496 Qcomma_dot = intern_c_string (",.");
4497 staticpro (&Qcomma_dot);
4498
4499 Qinhibit_file_name_operation = intern_c_string ("inhibit-file-name-operation");
4500 staticpro (&Qinhibit_file_name_operation);
4501
4502 Qascii_character = intern_c_string ("ascii-character");
4503 staticpro (&Qascii_character);
4504
4505 Qfunction = intern_c_string ("function");
4506 staticpro (&Qfunction);
4507
4508 Qload = intern_c_string ("load");
4509 staticpro (&Qload);
4510
4511 Qload_file_name = intern_c_string ("load-file-name");
4512 staticpro (&Qload_file_name);
4513
4514 Qeval_buffer_list = intern_c_string ("eval-buffer-list");
4515 staticpro (&Qeval_buffer_list);
4516
4517 Qfile_truename = intern_c_string ("file-truename");
4518 staticpro (&Qfile_truename) ;
4519
4520 Qdir_ok = intern_c_string ("dir-ok");
4521 staticpro (&Qdir_ok);
4522
4523 Qdo_after_load_evaluation = intern_c_string ("do-after-load-evaluation");
4524 staticpro (&Qdo_after_load_evaluation) ;
4525
4526 staticpro (&dump_path);
4527
4528 staticpro (&read_objects);
4529 read_objects = Qnil;
4530 staticpro (&seen_list);
4531 seen_list = Qnil;
4532
4533 Vloads_in_progress = Qnil;
4534 staticpro (&Vloads_in_progress);
4535
4536 Qhash_table = intern_c_string ("hash-table");
4537 staticpro (&Qhash_table);
4538 Qdata = intern_c_string ("data");
4539 staticpro (&Qdata);
4540 Qtest = intern_c_string ("test");
4541 staticpro (&Qtest);
4542 Qsize = intern_c_string ("size");
4543 staticpro (&Qsize);
4544 Qweakness = intern_c_string ("weakness");
4545 staticpro (&Qweakness);
4546 Qrehash_size = intern_c_string ("rehash-size");
4547 staticpro (&Qrehash_size);
4548 Qrehash_threshold = intern_c_string ("rehash-threshold");
4549 staticpro (&Qrehash_threshold);
4550 }