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