272
|
1 /* Evaluator for GNU Emacs Lisp interpreter.
|
2961
|
2 Copyright (C) 1985, 1986, 1987, 1993 Free Software Foundation, Inc.
|
272
|
3
|
|
4 This file is part of GNU Emacs.
|
|
5
|
|
6 GNU Emacs is free software; you can redistribute it and/or modify
|
|
7 it under the terms of the GNU General Public License as published by
|
|
8 the Free Software Foundation; either version 1, or (at your option)
|
|
9 any later version.
|
|
10
|
|
11 GNU Emacs is distributed in the hope that it will be useful,
|
|
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
14 GNU General Public License for more details.
|
|
15
|
|
16 You should have received a copy of the GNU General Public License
|
|
17 along with GNU Emacs; see the file COPYING. If not, write to
|
|
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
|
|
19
|
|
20
|
|
21 #include "config.h"
|
|
22 #include "lisp.h"
|
2439
|
23 #include "blockinput.h"
|
272
|
24
|
|
25 #ifndef standalone
|
|
26 #include "commands.h"
|
515
|
27 #include "keyboard.h"
|
272
|
28 #else
|
|
29 #define INTERACTIVE 1
|
|
30 #endif
|
|
31
|
|
32 #include <setjmp.h>
|
|
33
|
|
34 /* This definition is duplicated in alloc.c and keyboard.c */
|
|
35 /* Putting it in lisp.h makes cc bomb out! */
|
|
36
|
|
37 struct backtrace
|
|
38 {
|
|
39 struct backtrace *next;
|
|
40 Lisp_Object *function;
|
|
41 Lisp_Object *args; /* Points to vector of args. */
|
727
|
42 int nargs; /* Length of vector.
|
|
43 If nargs is UNEVALLED, args points to slot holding
|
|
44 list of unevalled args */
|
272
|
45 char evalargs;
|
|
46 /* Nonzero means call value of debugger when done with this operation. */
|
|
47 char debug_on_exit;
|
|
48 };
|
|
49
|
|
50 struct backtrace *backtrace_list;
|
|
51
|
1196
|
52 /* This structure helps implement the `catch' and `throw' control
|
|
53 structure. A struct catchtag contains all the information needed
|
|
54 to restore the state of the interpreter after a non-local jump.
|
|
55
|
|
56 Handlers for error conditions (represented by `struct handler'
|
|
57 structures) just point to a catch tag to do the cleanup required
|
|
58 for their jumps.
|
|
59
|
|
60 catchtag structures are chained together in the C calling stack;
|
|
61 the `next' member points to the next outer catchtag.
|
|
62
|
|
63 A call like (throw TAG VAL) searches for a catchtag whose `tag'
|
|
64 member is TAG, and then unbinds to it. The `val' member is used to
|
|
65 hold VAL while the stack is unwound; `val' is returned as the value
|
|
66 of the catch form.
|
|
67
|
|
68 All the other members are concerned with restoring the interpreter
|
|
69 state. */
|
272
|
70 struct catchtag
|
|
71 {
|
|
72 Lisp_Object tag;
|
|
73 Lisp_Object val;
|
|
74 struct catchtag *next;
|
|
75 struct gcpro *gcpro;
|
|
76 jmp_buf jmp;
|
|
77 struct backtrace *backlist;
|
|
78 struct handler *handlerlist;
|
|
79 int lisp_eval_depth;
|
|
80 int pdlcount;
|
|
81 int poll_suppress_count;
|
|
82 };
|
|
83
|
|
84 struct catchtag *catchlist;
|
|
85
|
|
86 Lisp_Object Qautoload, Qmacro, Qexit, Qinteractive, Qcommandp, Qdefun;
|
381
|
87 Lisp_Object Qinhibit_quit, Vinhibit_quit, Vquit_flag;
|
272
|
88 Lisp_Object Qmocklisp_arguments, Vmocklisp_arguments, Qmocklisp;
|
|
89 Lisp_Object Qand_rest, Qand_optional;
|
|
90 Lisp_Object Qdebug_on_error;
|
|
91
|
|
92 Lisp_Object Vrun_hooks;
|
|
93
|
|
94 /* Non-nil means record all fset's and provide's, to be undone
|
|
95 if the file being autoloaded is not fully loaded.
|
|
96 They are recorded by being consed onto the front of Vautoload_queue:
|
|
97 (FUN . ODEF) for a defun, (OFEATURES . nil) for a provide. */
|
|
98
|
|
99 Lisp_Object Vautoload_queue;
|
|
100
|
|
101 /* Current number of specbindings allocated in specpdl. */
|
|
102 int specpdl_size;
|
|
103
|
|
104 /* Pointer to beginning of specpdl. */
|
|
105 struct specbinding *specpdl;
|
|
106
|
|
107 /* Pointer to first unused element in specpdl. */
|
|
108 struct specbinding *specpdl_ptr;
|
|
109
|
|
110 /* Maximum size allowed for specpdl allocation */
|
|
111 int max_specpdl_size;
|
|
112
|
|
113 /* Depth in Lisp evaluations and function calls. */
|
|
114 int lisp_eval_depth;
|
|
115
|
|
116 /* Maximum allowed depth in Lisp evaluations and function calls. */
|
|
117 int max_lisp_eval_depth;
|
|
118
|
|
119 /* Nonzero means enter debugger before next function call */
|
|
120 int debug_on_next_call;
|
|
121
|
684
|
122 /* List of conditions (non-nil atom means all) which cause a backtrace
|
706
|
123 if an error is handled by the command loop's error handler. */
|
684
|
124 Lisp_Object Vstack_trace_on_error;
|
272
|
125
|
684
|
126 /* List of conditions (non-nil atom means all) which enter the debugger
|
706
|
127 if an error is handled by the command loop's error handler. */
|
684
|
128 Lisp_Object Vdebug_on_error;
|
272
|
129
|
|
130 /* Nonzero means enter debugger if a quit signal
|
684
|
131 is handled by the command loop's error handler. */
|
272
|
132 int debug_on_quit;
|
|
133
|
1196
|
134 /* The value of num_nonmacro_input_chars as of the last time we
|
|
135 started to enter the debugger. If we decide to enter the debugger
|
|
136 again when this is still equal to num_nonmacro_input_chars, then we
|
|
137 know that the debugger itself has an error, and we should just
|
|
138 signal the error instead of entering an infinite loop of debugger
|
|
139 invocations. */
|
|
140 int when_entered_debugger;
|
272
|
141
|
|
142 Lisp_Object Vdebugger;
|
|
143
|
|
144 void specbind (), record_unwind_protect ();
|
|
145
|
|
146 Lisp_Object funcall_lambda ();
|
|
147 extern Lisp_Object ml_apply (); /* Apply a mocklisp function to unevaluated argument list */
|
|
148
|
|
149 init_eval_once ()
|
|
150 {
|
|
151 specpdl_size = 50;
|
|
152 specpdl = (struct specbinding *) malloc (specpdl_size * sizeof (struct specbinding));
|
|
153 max_specpdl_size = 600;
|
|
154 max_lisp_eval_depth = 200;
|
|
155 }
|
|
156
|
|
157 init_eval ()
|
|
158 {
|
|
159 specpdl_ptr = specpdl;
|
|
160 catchlist = 0;
|
|
161 handlerlist = 0;
|
|
162 backtrace_list = 0;
|
|
163 Vquit_flag = Qnil;
|
|
164 debug_on_next_call = 0;
|
|
165 lisp_eval_depth = 0;
|
1196
|
166 when_entered_debugger = 0;
|
272
|
167 }
|
|
168
|
|
169 Lisp_Object
|
|
170 call_debugger (arg)
|
|
171 Lisp_Object arg;
|
|
172 {
|
|
173 if (lisp_eval_depth + 20 > max_lisp_eval_depth)
|
|
174 max_lisp_eval_depth = lisp_eval_depth + 20;
|
|
175 if (specpdl_size + 40 > max_specpdl_size)
|
|
176 max_specpdl_size = specpdl_size + 40;
|
|
177 debug_on_next_call = 0;
|
1196
|
178 when_entered_debugger = num_nonmacro_input_chars;
|
272
|
179 return apply1 (Vdebugger, arg);
|
|
180 }
|
|
181
|
|
182 do_debug_on_call (code)
|
|
183 Lisp_Object code;
|
|
184 {
|
|
185 debug_on_next_call = 0;
|
|
186 backtrace_list->debug_on_exit = 1;
|
|
187 call_debugger (Fcons (code, Qnil));
|
|
188 }
|
|
189
|
|
190 /* NOTE!!! Every function that can call EVAL must protect its args
|
|
191 and temporaries from garbage collection while it needs them.
|
|
192 The definition of `For' shows what you have to do. */
|
|
193
|
|
194 DEFUN ("or", For, Sor, 0, UNEVALLED, 0,
|
|
195 "Eval args until one of them yields non-nil, then return that value.\n\
|
|
196 The remaining args are not evalled at all.\n\
|
|
197 If all args return nil, return nil.")
|
|
198 (args)
|
|
199 Lisp_Object args;
|
|
200 {
|
|
201 register Lisp_Object val;
|
|
202 Lisp_Object args_left;
|
|
203 struct gcpro gcpro1;
|
|
204
|
485
|
205 if (NILP(args))
|
272
|
206 return Qnil;
|
|
207
|
|
208 args_left = args;
|
|
209 GCPRO1 (args_left);
|
|
210
|
|
211 do
|
|
212 {
|
|
213 val = Feval (Fcar (args_left));
|
485
|
214 if (!NILP (val))
|
272
|
215 break;
|
|
216 args_left = Fcdr (args_left);
|
|
217 }
|
485
|
218 while (!NILP(args_left));
|
272
|
219
|
|
220 UNGCPRO;
|
|
221 return val;
|
|
222 }
|
|
223
|
|
224 DEFUN ("and", Fand, Sand, 0, UNEVALLED, 0,
|
|
225 "Eval args until one of them yields nil, then return nil.\n\
|
|
226 The remaining args are not evalled at all.\n\
|
|
227 If no arg yields nil, return the last arg's value.")
|
|
228 (args)
|
|
229 Lisp_Object args;
|
|
230 {
|
|
231 register Lisp_Object val;
|
|
232 Lisp_Object args_left;
|
|
233 struct gcpro gcpro1;
|
|
234
|
485
|
235 if (NILP(args))
|
272
|
236 return Qt;
|
|
237
|
|
238 args_left = args;
|
|
239 GCPRO1 (args_left);
|
|
240
|
|
241 do
|
|
242 {
|
|
243 val = Feval (Fcar (args_left));
|
485
|
244 if (NILP (val))
|
272
|
245 break;
|
|
246 args_left = Fcdr (args_left);
|
|
247 }
|
485
|
248 while (!NILP(args_left));
|
272
|
249
|
|
250 UNGCPRO;
|
|
251 return val;
|
|
252 }
|
|
253
|
|
254 DEFUN ("if", Fif, Sif, 2, UNEVALLED, 0,
|
|
255 "(if COND THEN ELSE...): if COND yields non-nil, do THEN, else do ELSE...\n\
|
|
256 Returns the value of THEN or the value of the last of the ELSE's.\n\
|
|
257 THEN must be one expression, but ELSE... can be zero or more expressions.\n\
|
|
258 If COND yields nil, and there are no ELSE's, the value is nil.")
|
|
259 (args)
|
|
260 Lisp_Object args;
|
|
261 {
|
|
262 register Lisp_Object cond;
|
|
263 struct gcpro gcpro1;
|
|
264
|
|
265 GCPRO1 (args);
|
|
266 cond = Feval (Fcar (args));
|
|
267 UNGCPRO;
|
|
268
|
485
|
269 if (!NILP (cond))
|
272
|
270 return Feval (Fcar (Fcdr (args)));
|
|
271 return Fprogn (Fcdr (Fcdr (args)));
|
|
272 }
|
|
273
|
|
274 DEFUN ("cond", Fcond, Scond, 0, UNEVALLED, 0,
|
|
275 "(cond CLAUSES...): try each clause until one succeeds.\n\
|
|
276 Each clause looks like (CONDITION BODY...). CONDITION is evaluated\n\
|
|
277 and, if the value is non-nil, this clause succeeds:\n\
|
|
278 then the expressions in BODY are evaluated and the last one's\n\
|
|
279 value is the value of the cond-form.\n\
|
|
280 If no clause succeeds, cond returns nil.\n\
|
|
281 If a clause has one element, as in (CONDITION),\n\
|
|
282 CONDITION's value if non-nil is returned from the cond-form.")
|
|
283 (args)
|
|
284 Lisp_Object args;
|
|
285 {
|
|
286 register Lisp_Object clause, val;
|
|
287 struct gcpro gcpro1;
|
|
288
|
|
289 val = Qnil;
|
|
290 GCPRO1 (args);
|
485
|
291 while (!NILP (args))
|
272
|
292 {
|
|
293 clause = Fcar (args);
|
|
294 val = Feval (Fcar (clause));
|
485
|
295 if (!NILP (val))
|
272
|
296 {
|
|
297 if (!EQ (XCONS (clause)->cdr, Qnil))
|
|
298 val = Fprogn (XCONS (clause)->cdr);
|
|
299 break;
|
|
300 }
|
|
301 args = XCONS (args)->cdr;
|
|
302 }
|
|
303 UNGCPRO;
|
|
304
|
|
305 return val;
|
|
306 }
|
|
307
|
|
308 DEFUN ("progn", Fprogn, Sprogn, 0, UNEVALLED, 0,
|
|
309 "(progn BODY...): eval BODY forms sequentially and return value of last one.")
|
|
310 (args)
|
|
311 Lisp_Object args;
|
|
312 {
|
|
313 register Lisp_Object val, tem;
|
|
314 Lisp_Object args_left;
|
|
315 struct gcpro gcpro1;
|
|
316
|
|
317 /* In Mocklisp code, symbols at the front of the progn arglist
|
|
318 are to be bound to zero. */
|
|
319 if (!EQ (Vmocklisp_arguments, Qt))
|
|
320 {
|
|
321 val = make_number (0);
|
485
|
322 while (!NILP (args) && (tem = Fcar (args), XTYPE (tem) == Lisp_Symbol))
|
272
|
323 {
|
|
324 QUIT;
|
|
325 specbind (tem, val), args = Fcdr (args);
|
|
326 }
|
|
327 }
|
|
328
|
485
|
329 if (NILP(args))
|
272
|
330 return Qnil;
|
|
331
|
|
332 args_left = args;
|
|
333 GCPRO1 (args_left);
|
|
334
|
|
335 do
|
|
336 {
|
|
337 val = Feval (Fcar (args_left));
|
|
338 args_left = Fcdr (args_left);
|
|
339 }
|
485
|
340 while (!NILP(args_left));
|
272
|
341
|
|
342 UNGCPRO;
|
|
343 return val;
|
|
344 }
|
|
345
|
|
346 DEFUN ("prog1", Fprog1, Sprog1, 1, UNEVALLED, 0,
|
|
347 "(prog1 FIRST BODY...): eval FIRST and BODY sequentially; value from FIRST.\n\
|
|
348 The value of FIRST is saved during the evaluation of the remaining args,\n\
|
|
349 whose values are discarded.")
|
|
350 (args)
|
|
351 Lisp_Object args;
|
|
352 {
|
|
353 Lisp_Object val;
|
|
354 register Lisp_Object args_left;
|
|
355 struct gcpro gcpro1, gcpro2;
|
|
356 register int argnum = 0;
|
|
357
|
485
|
358 if (NILP(args))
|
272
|
359 return Qnil;
|
|
360
|
|
361 args_left = args;
|
|
362 val = Qnil;
|
|
363 GCPRO2 (args, val);
|
|
364
|
|
365 do
|
|
366 {
|
|
367 if (!(argnum++))
|
|
368 val = Feval (Fcar (args_left));
|
|
369 else
|
|
370 Feval (Fcar (args_left));
|
|
371 args_left = Fcdr (args_left);
|
|
372 }
|
485
|
373 while (!NILP(args_left));
|
272
|
374
|
|
375 UNGCPRO;
|
|
376 return val;
|
|
377 }
|
|
378
|
|
379 DEFUN ("prog2", Fprog2, Sprog2, 2, UNEVALLED, 0,
|
|
380 "(prog1 X Y BODY...): eval X, Y and BODY sequentially; value from Y.\n\
|
|
381 The value of Y is saved during the evaluation of the remaining args,\n\
|
|
382 whose values are discarded.")
|
|
383 (args)
|
|
384 Lisp_Object args;
|
|
385 {
|
|
386 Lisp_Object val;
|
|
387 register Lisp_Object args_left;
|
|
388 struct gcpro gcpro1, gcpro2;
|
|
389 register int argnum = -1;
|
|
390
|
|
391 val = Qnil;
|
|
392
|
485
|
393 if (NILP(args))
|
272
|
394 return Qnil;
|
|
395
|
|
396 args_left = args;
|
|
397 val = Qnil;
|
|
398 GCPRO2 (args, val);
|
|
399
|
|
400 do
|
|
401 {
|
|
402 if (!(argnum++))
|
|
403 val = Feval (Fcar (args_left));
|
|
404 else
|
|
405 Feval (Fcar (args_left));
|
|
406 args_left = Fcdr (args_left);
|
|
407 }
|
485
|
408 while (!NILP(args_left));
|
272
|
409
|
|
410 UNGCPRO;
|
|
411 return val;
|
|
412 }
|
|
413
|
|
414 DEFUN ("setq", Fsetq, Ssetq, 0, UNEVALLED, 0,
|
|
415 "(setq SYM VAL SYM VAL ...): set each SYM to the value of its VAL.\n\
|
|
416 The SYMs are not evaluated. Thus (setq x y) sets x to the value of y.\n\
|
|
417 Each SYM is set before the next VAL is computed.")
|
|
418 (args)
|
|
419 Lisp_Object args;
|
|
420 {
|
|
421 register Lisp_Object args_left;
|
|
422 register Lisp_Object val, sym;
|
|
423 struct gcpro gcpro1;
|
|
424
|
485
|
425 if (NILP(args))
|
272
|
426 return Qnil;
|
|
427
|
|
428 args_left = args;
|
|
429 GCPRO1 (args);
|
|
430
|
|
431 do
|
|
432 {
|
|
433 val = Feval (Fcar (Fcdr (args_left)));
|
|
434 sym = Fcar (args_left);
|
|
435 Fset (sym, val);
|
|
436 args_left = Fcdr (Fcdr (args_left));
|
|
437 }
|
485
|
438 while (!NILP(args_left));
|
272
|
439
|
|
440 UNGCPRO;
|
|
441 return val;
|
|
442 }
|
|
443
|
|
444 DEFUN ("quote", Fquote, Squote, 1, UNEVALLED, 0,
|
|
445 "Return the argument, without evaluating it. `(quote x)' yields `x'.")
|
|
446 (args)
|
|
447 Lisp_Object args;
|
|
448 {
|
|
449 return Fcar (args);
|
|
450 }
|
|
451
|
|
452 DEFUN ("function", Ffunction, Sfunction, 1, UNEVALLED, 0,
|
|
453 "Like `quote', but preferred for objects which are functions.\n\
|
|
454 In byte compilation, `function' causes its argument to be compiled.\n\
|
|
455 `quote' cannot do that.")
|
|
456 (args)
|
|
457 Lisp_Object args;
|
|
458 {
|
|
459 return Fcar (args);
|
|
460 }
|
|
461
|
|
462 DEFUN ("interactive-p", Finteractive_p, Sinteractive_p, 0, 0, 0,
|
|
463 "Return t if function in which this appears was called interactively.\n\
|
|
464 This means that the function was called with call-interactively (which\n\
|
|
465 includes being called as the binding of a key)\n\
|
|
466 and input is currently coming from the keyboard (not in keyboard macro).")
|
|
467 ()
|
|
468 {
|
|
469 register struct backtrace *btp;
|
|
470 register Lisp_Object fun;
|
|
471
|
|
472 if (!INTERACTIVE)
|
|
473 return Qnil;
|
|
474
|
|
475 btp = backtrace_list;
|
727
|
476
|
|
477 /* If this isn't a byte-compiled function, there may be a frame at
|
|
478 the top for Finteractive_p itself. If so, skip it. */
|
|
479 fun = Findirect_function (*btp->function);
|
|
480 if (XTYPE (fun) == Lisp_Subr
|
|
481 && (struct Lisp_Subr *) XPNTR (fun) == &Sinteractive_p)
|
323
|
482 btp = btp->next;
|
|
483
|
727
|
484 /* If we're running an Emacs 18-style byte-compiled function, there
|
|
485 may be a frame for Fbytecode. Now, given the strictest
|
|
486 definition, this function isn't really being called
|
|
487 interactively, but because that's the way Emacs 18 always builds
|
|
488 byte-compiled functions, we'll accept it for now. */
|
|
489 if (EQ (*btp->function, Qbytecode))
|
|
490 btp = btp->next;
|
|
491
|
|
492 /* If this isn't a byte-compiled function, then we may now be
|
|
493 looking at several frames for special forms. Skip past them. */
|
|
494 while (btp &&
|
|
495 btp->nargs == UNEVALLED)
|
|
496 btp = btp->next;
|
|
497
|
|
498 /* btp now points at the frame of the innermost function that isn't
|
|
499 a special form, ignoring frames for Finteractive_p and/or
|
|
500 Fbytecode at the top. If this frame is for a built-in function
|
|
501 (such as load or eval-region) return nil. */
|
648
|
502 fun = Findirect_function (*btp->function);
|
272
|
503 if (XTYPE (fun) == Lisp_Subr)
|
|
504 return Qnil;
|
|
505 /* btp points to the frame of a Lisp function that called interactive-p.
|
|
506 Return t if that function was called interactively. */
|
|
507 if (btp && btp->next && EQ (*btp->next->function, Qcall_interactively))
|
|
508 return Qt;
|
|
509 return Qnil;
|
|
510 }
|
|
511
|
|
512 DEFUN ("defun", Fdefun, Sdefun, 2, UNEVALLED, 0,
|
|
513 "(defun NAME ARGLIST [DOCSTRING] BODY...): define NAME as a function.\n\
|
|
514 The definition is (lambda ARGLIST [DOCSTRING] BODY...).\n\
|
|
515 See also the function `interactive'.")
|
|
516 (args)
|
|
517 Lisp_Object args;
|
|
518 {
|
|
519 register Lisp_Object fn_name;
|
|
520 register Lisp_Object defn;
|
|
521
|
|
522 fn_name = Fcar (args);
|
|
523 defn = Fcons (Qlambda, Fcdr (args));
|
485
|
524 if (!NILP (Vpurify_flag))
|
272
|
525 defn = Fpurecopy (defn);
|
|
526 Ffset (fn_name, defn);
|
2547
|
527 LOADHIST_ATTACH (fn_name);
|
272
|
528 return fn_name;
|
|
529 }
|
|
530
|
|
531 DEFUN ("defmacro", Fdefmacro, Sdefmacro, 2, UNEVALLED, 0,
|
|
532 "(defmacro NAME ARGLIST [DOCSTRING] BODY...): define NAME as a macro.\n\
|
|
533 The definition is (macro lambda ARGLIST [DOCSTRING] BODY...).\n\
|
|
534 When the macro is called, as in (NAME ARGS...),\n\
|
|
535 the function (lambda ARGLIST BODY...) is applied to\n\
|
|
536 the list ARGS... as it appears in the expression,\n\
|
|
537 and the result should be a form to be evaluated instead of the original.")
|
|
538 (args)
|
|
539 Lisp_Object args;
|
|
540 {
|
|
541 register Lisp_Object fn_name;
|
|
542 register Lisp_Object defn;
|
|
543
|
|
544 fn_name = Fcar (args);
|
|
545 defn = Fcons (Qmacro, Fcons (Qlambda, Fcdr (args)));
|
485
|
546 if (!NILP (Vpurify_flag))
|
272
|
547 defn = Fpurecopy (defn);
|
|
548 Ffset (fn_name, defn);
|
2547
|
549 LOADHIST_ATTACH (fn_name);
|
272
|
550 return fn_name;
|
|
551 }
|
|
552
|
|
553 DEFUN ("defvar", Fdefvar, Sdefvar, 1, UNEVALLED, 0,
|
|
554 "(defvar SYMBOL INITVALUE DOCSTRING): define SYMBOL as a variable.\n\
|
|
555 You are not required to define a variable in order to use it,\n\
|
|
556 but the definition can supply documentation and an initial value\n\
|
|
557 in a way that tags can recognize.\n\n\
|
|
558 INITVALUE is evaluated, and used to set SYMBOL, only if SYMBOL's value is void.\n\
|
687
|
559 If SYMBOL is buffer-local, its default value is what is set;\n\
|
|
560 buffer-local values are not affected.\n\
|
272
|
561 INITVALUE and DOCSTRING are optional.\n\
|
|
562 If DOCSTRING starts with *, this variable is identified as a user option.\n\
|
|
563 This means that M-x set-variable and M-x edit-options recognize it.\n\
|
|
564 If INITVALUE is missing, SYMBOL's value is not set.")
|
|
565 (args)
|
|
566 Lisp_Object args;
|
|
567 {
|
|
568 register Lisp_Object sym, tem;
|
|
569
|
|
570 sym = Fcar (args);
|
|
571 tem = Fcdr (args);
|
485
|
572 if (!NILP (tem))
|
272
|
573 {
|
|
574 tem = Fdefault_boundp (sym);
|
485
|
575 if (NILP (tem))
|
272
|
576 Fset_default (sym, Feval (Fcar (Fcdr (args))));
|
|
577 }
|
|
578 tem = Fcar (Fcdr (Fcdr (args)));
|
485
|
579 if (!NILP (tem))
|
272
|
580 {
|
485
|
581 if (!NILP (Vpurify_flag))
|
272
|
582 tem = Fpurecopy (tem);
|
|
583 Fput (sym, Qvariable_documentation, tem);
|
|
584 }
|
2547
|
585 LOADHIST_ATTACH (sym);
|
272
|
586 return sym;
|
|
587 }
|
|
588
|
|
589 DEFUN ("defconst", Fdefconst, Sdefconst, 2, UNEVALLED, 0,
|
|
590 "(defconst SYMBOL INITVALUE DOCSTRING): define SYMBOL as a constant variable.\n\
|
|
591 The intent is that programs do not change this value, but users may.\n\
|
|
592 Always sets the value of SYMBOL to the result of evalling INITVALUE.\n\
|
687
|
593 If SYMBOL is buffer-local, its default value is what is set;\n\
|
|
594 buffer-local values are not affected.\n\
|
272
|
595 DOCSTRING is optional.\n\
|
|
596 If DOCSTRING starts with *, this variable is identified as a user option.\n\
|
|
597 This means that M-x set-variable and M-x edit-options recognize it.\n\n\
|
|
598 Note: do not use `defconst' for user options in libraries that are not\n\
|
|
599 normally loaded, since it is useful for users to be able to specify\n\
|
|
600 their own values for such variables before loading the library.\n\
|
|
601 Since `defconst' unconditionally assigns the variable,\n\
|
|
602 it would override the user's choice.")
|
|
603 (args)
|
|
604 Lisp_Object args;
|
|
605 {
|
|
606 register Lisp_Object sym, tem;
|
|
607
|
|
608 sym = Fcar (args);
|
|
609 Fset_default (sym, Feval (Fcar (Fcdr (args))));
|
|
610 tem = Fcar (Fcdr (Fcdr (args)));
|
485
|
611 if (!NILP (tem))
|
272
|
612 {
|
485
|
613 if (!NILP (Vpurify_flag))
|
272
|
614 tem = Fpurecopy (tem);
|
|
615 Fput (sym, Qvariable_documentation, tem);
|
|
616 }
|
2547
|
617 LOADHIST_ATTACH (sym);
|
272
|
618 return sym;
|
|
619 }
|
|
620
|
|
621 DEFUN ("user-variable-p", Fuser_variable_p, Suser_variable_p, 1, 1, 0,
|
|
622 "Returns t if VARIABLE is intended to be set and modified by users.\n\
|
|
623 \(The alternative is a variable used internally in a Lisp program.)\n\
|
|
624 Determined by whether the first character of the documentation\n\
|
|
625 for the variable is \"*\"")
|
|
626 (variable)
|
|
627 Lisp_Object variable;
|
|
628 {
|
|
629 Lisp_Object documentation;
|
|
630
|
|
631 documentation = Fget (variable, Qvariable_documentation);
|
|
632 if (XTYPE (documentation) == Lisp_Int && XINT (documentation) < 0)
|
|
633 return Qt;
|
|
634 if ((XTYPE (documentation) == Lisp_String) &&
|
|
635 ((unsigned char) XSTRING (documentation)->data[0] == '*'))
|
|
636 return Qt;
|
|
637 return Qnil;
|
|
638 }
|
|
639
|
|
640 DEFUN ("let*", FletX, SletX, 1, UNEVALLED, 0,
|
|
641 "(let* VARLIST BODY...): bind variables according to VARLIST then eval BODY.\n\
|
|
642 The value of the last form in BODY is returned.\n\
|
|
643 Each element of VARLIST is a symbol (which is bound to nil)\n\
|
|
644 or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).\n\
|
|
645 Each VALUEFORM can refer to the symbols already bound by this VARLIST.")
|
|
646 (args)
|
|
647 Lisp_Object args;
|
|
648 {
|
|
649 Lisp_Object varlist, val, elt;
|
|
650 int count = specpdl_ptr - specpdl;
|
|
651 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
652
|
|
653 GCPRO3 (args, elt, varlist);
|
|
654
|
|
655 varlist = Fcar (args);
|
485
|
656 while (!NILP (varlist))
|
272
|
657 {
|
|
658 QUIT;
|
|
659 elt = Fcar (varlist);
|
|
660 if (XTYPE (elt) == Lisp_Symbol)
|
|
661 specbind (elt, Qnil);
|
604
|
662 else if (! NILP (Fcdr (Fcdr (elt))))
|
|
663 Fsignal (Qerror,
|
|
664 Fcons (build_string ("`let' bindings can have only one value-form"),
|
|
665 elt));
|
272
|
666 else
|
|
667 {
|
|
668 val = Feval (Fcar (Fcdr (elt)));
|
|
669 specbind (Fcar (elt), val);
|
|
670 }
|
|
671 varlist = Fcdr (varlist);
|
|
672 }
|
|
673 UNGCPRO;
|
|
674 val = Fprogn (Fcdr (args));
|
|
675 return unbind_to (count, val);
|
|
676 }
|
|
677
|
|
678 DEFUN ("let", Flet, Slet, 1, UNEVALLED, 0,
|
|
679 "(let VARLIST BODY...): bind variables according to VARLIST then eval BODY.\n\
|
|
680 The value of the last form in BODY is returned.\n\
|
|
681 Each element of VARLIST is a symbol (which is bound to nil)\n\
|
|
682 or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).\n\
|
|
683 All the VALUEFORMs are evalled before any symbols are bound.")
|
|
684 (args)
|
|
685 Lisp_Object args;
|
|
686 {
|
|
687 Lisp_Object *temps, tem;
|
|
688 register Lisp_Object elt, varlist;
|
|
689 int count = specpdl_ptr - specpdl;
|
|
690 register int argnum;
|
|
691 struct gcpro gcpro1, gcpro2;
|
|
692
|
|
693 varlist = Fcar (args);
|
|
694
|
|
695 /* Make space to hold the values to give the bound variables */
|
|
696 elt = Flength (varlist);
|
|
697 temps = (Lisp_Object *) alloca (XFASTINT (elt) * sizeof (Lisp_Object));
|
|
698
|
|
699 /* Compute the values and store them in `temps' */
|
|
700
|
|
701 GCPRO2 (args, *temps);
|
|
702 gcpro2.nvars = 0;
|
|
703
|
485
|
704 for (argnum = 0; !NILP (varlist); varlist = Fcdr (varlist))
|
272
|
705 {
|
|
706 QUIT;
|
|
707 elt = Fcar (varlist);
|
|
708 if (XTYPE (elt) == Lisp_Symbol)
|
|
709 temps [argnum++] = Qnil;
|
604
|
710 else if (! NILP (Fcdr (Fcdr (elt))))
|
|
711 Fsignal (Qerror,
|
|
712 Fcons (build_string ("`let' bindings can have only one value-form"),
|
|
713 elt));
|
272
|
714 else
|
|
715 temps [argnum++] = Feval (Fcar (Fcdr (elt)));
|
|
716 gcpro2.nvars = argnum;
|
|
717 }
|
|
718 UNGCPRO;
|
|
719
|
|
720 varlist = Fcar (args);
|
485
|
721 for (argnum = 0; !NILP (varlist); varlist = Fcdr (varlist))
|
272
|
722 {
|
|
723 elt = Fcar (varlist);
|
|
724 tem = temps[argnum++];
|
|
725 if (XTYPE (elt) == Lisp_Symbol)
|
|
726 specbind (elt, tem);
|
|
727 else
|
|
728 specbind (Fcar (elt), tem);
|
|
729 }
|
|
730
|
|
731 elt = Fprogn (Fcdr (args));
|
|
732 return unbind_to (count, elt);
|
|
733 }
|
|
734
|
|
735 DEFUN ("while", Fwhile, Swhile, 1, UNEVALLED, 0,
|
|
736 "(while TEST BODY...): if TEST yields non-nil, eval BODY... and repeat.\n\
|
|
737 The order of execution is thus TEST, BODY, TEST, BODY and so on\n\
|
|
738 until TEST returns nil.")
|
|
739 (args)
|
|
740 Lisp_Object args;
|
|
741 {
|
|
742 Lisp_Object test, body, tem;
|
|
743 struct gcpro gcpro1, gcpro2;
|
|
744
|
|
745 GCPRO2 (test, body);
|
|
746
|
|
747 test = Fcar (args);
|
|
748 body = Fcdr (args);
|
485
|
749 while (tem = Feval (test), !NILP (tem))
|
272
|
750 {
|
|
751 QUIT;
|
|
752 Fprogn (body);
|
|
753 }
|
|
754
|
|
755 UNGCPRO;
|
|
756 return Qnil;
|
|
757 }
|
|
758
|
|
759 DEFUN ("macroexpand", Fmacroexpand, Smacroexpand, 1, 2, 0,
|
|
760 "Return result of expanding macros at top level of FORM.\n\
|
|
761 If FORM is not a macro call, it is returned unchanged.\n\
|
|
762 Otherwise, the macro is expanded and the expansion is considered\n\
|
|
763 in place of FORM. When a non-macro-call results, it is returned.\n\n\
|
|
764 The second optional arg ENVIRONMENT species an environment of macro\n\
|
|
765 definitions to shadow the loaded ones for use in file byte-compilation.")
|
|
766 (form, env)
|
|
767 register Lisp_Object form;
|
|
768 Lisp_Object env;
|
|
769 {
|
753
|
770 /* With cleanups from Hallvard Furuseth. */
|
272
|
771 register Lisp_Object expander, sym, def, tem;
|
|
772
|
|
773 while (1)
|
|
774 {
|
|
775 /* Come back here each time we expand a macro call,
|
|
776 in case it expands into another macro call. */
|
|
777 if (XTYPE (form) != Lisp_Cons)
|
|
778 break;
|
753
|
779 /* Set SYM, give DEF and TEM right values in case SYM is not a symbol. */
|
|
780 def = sym = XCONS (form)->car;
|
|
781 tem = Qnil;
|
272
|
782 /* Trace symbols aliases to other symbols
|
|
783 until we get a symbol that is not an alias. */
|
753
|
784 while (XTYPE (def) == Lisp_Symbol)
|
272
|
785 {
|
|
786 QUIT;
|
753
|
787 sym = def;
|
272
|
788 tem = Fassq (sym, env);
|
485
|
789 if (NILP (tem))
|
272
|
790 {
|
|
791 def = XSYMBOL (sym)->function;
|
753
|
792 if (!EQ (def, Qunbound))
|
|
793 continue;
|
272
|
794 }
|
753
|
795 break;
|
272
|
796 }
|
|
797 /* Right now TEM is the result from SYM in ENV,
|
|
798 and if TEM is nil then DEF is SYM's function definition. */
|
485
|
799 if (NILP (tem))
|
272
|
800 {
|
|
801 /* SYM is not mentioned in ENV.
|
|
802 Look at its function definition. */
|
|
803 if (EQ (def, Qunbound)
|
|
804 || XTYPE (def) != Lisp_Cons)
|
|
805 /* Not defined or definition not suitable */
|
|
806 break;
|
|
807 if (EQ (XCONS (def)->car, Qautoload))
|
|
808 {
|
|
809 /* Autoloading function: will it be a macro when loaded? */
|
1564
|
810 tem = Fnth (make_number (4), def);
|
|
811 if (EQ (XCONS (tem)->car, Qt)
|
|
812 || EQ (XCONS (tem)->car, Qmacro))
|
|
813 /* Yes, load it and try again. */
|
|
814 {
|
|
815 do_autoload (def, sym);
|
|
816 continue;
|
|
817 }
|
|
818 else
|
272
|
819 break;
|
|
820 }
|
|
821 else if (!EQ (XCONS (def)->car, Qmacro))
|
|
822 break;
|
|
823 else expander = XCONS (def)->cdr;
|
|
824 }
|
|
825 else
|
|
826 {
|
|
827 expander = XCONS (tem)->cdr;
|
485
|
828 if (NILP (expander))
|
272
|
829 break;
|
|
830 }
|
|
831 form = apply1 (expander, XCONS (form)->cdr);
|
|
832 }
|
|
833 return form;
|
|
834 }
|
|
835
|
|
836 DEFUN ("catch", Fcatch, Scatch, 1, UNEVALLED, 0,
|
|
837 "(catch TAG BODY...): eval BODY allowing nonlocal exits using `throw'.\n\
|
|
838 TAG is evalled to get the tag to use. Then the BODY is executed.\n\
|
|
839 Within BODY, (throw TAG) with same tag exits BODY and exits this `catch'.\n\
|
|
840 If no throw happens, `catch' returns the value of the last BODY form.\n\
|
|
841 If a throw happens, it specifies the value to return from `catch'.")
|
|
842 (args)
|
|
843 Lisp_Object args;
|
|
844 {
|
|
845 register Lisp_Object tag;
|
|
846 struct gcpro gcpro1;
|
|
847
|
|
848 GCPRO1 (args);
|
|
849 tag = Feval (Fcar (args));
|
|
850 UNGCPRO;
|
|
851 return internal_catch (tag, Fprogn, Fcdr (args));
|
|
852 }
|
|
853
|
|
854 /* Set up a catch, then call C function FUNC on argument ARG.
|
|
855 FUNC should return a Lisp_Object.
|
|
856 This is how catches are done from within C code. */
|
|
857
|
|
858 Lisp_Object
|
|
859 internal_catch (tag, func, arg)
|
|
860 Lisp_Object tag;
|
|
861 Lisp_Object (*func) ();
|
|
862 Lisp_Object arg;
|
|
863 {
|
|
864 /* This structure is made part of the chain `catchlist'. */
|
|
865 struct catchtag c;
|
|
866
|
|
867 /* Fill in the components of c, and put it on the list. */
|
|
868 c.next = catchlist;
|
|
869 c.tag = tag;
|
|
870 c.val = Qnil;
|
|
871 c.backlist = backtrace_list;
|
|
872 c.handlerlist = handlerlist;
|
|
873 c.lisp_eval_depth = lisp_eval_depth;
|
|
874 c.pdlcount = specpdl_ptr - specpdl;
|
|
875 c.poll_suppress_count = poll_suppress_count;
|
|
876 c.gcpro = gcprolist;
|
|
877 catchlist = &c;
|
|
878
|
|
879 /* Call FUNC. */
|
|
880 if (! _setjmp (c.jmp))
|
|
881 c.val = (*func) (arg);
|
|
882
|
|
883 /* Throw works by a longjmp that comes right here. */
|
|
884 catchlist = c.next;
|
|
885 return c.val;
|
|
886 }
|
|
887
|
1199
|
888 /* Unwind the specbind, catch, and handler stacks back to CATCH, and
|
|
889 jump to that CATCH, returning VALUE as the value of that catch.
|
|
890
|
|
891 This is the guts Fthrow and Fsignal; they differ only in the way
|
|
892 they choose the catch tag to throw to. A catch tag for a
|
|
893 condition-case form has a TAG of Qnil.
|
272
|
894
|
1199
|
895 Before each catch is discarded, unbind all special bindings and
|
|
896 execute all unwind-protect clauses made above that catch. Unwind
|
|
897 the handler stack as we go, so that the proper handlers are in
|
|
898 effect for each unwind-protect clause we run. At the end, restore
|
|
899 some static info saved in CATCH, and longjmp to the location
|
|
900 specified in the
|
272
|
901
|
1199
|
902 This is used for correct unwinding in Fthrow and Fsignal. */
|
272
|
903
|
|
904 static void
|
1199
|
905 unwind_to_catch (catch, value)
|
272
|
906 struct catchtag *catch;
|
1199
|
907 Lisp_Object value;
|
272
|
908 {
|
|
909 register int last_time;
|
|
910
|
1199
|
911 /* Save the value in the tag. */
|
|
912 catch->val = value;
|
|
913
|
1196
|
914 /* Restore the polling-suppression count. */
|
|
915 if (catch->poll_suppress_count > poll_suppress_count)
|
|
916 abort ();
|
|
917 while (catch->poll_suppress_count < poll_suppress_count)
|
|
918 start_polling ();
|
|
919
|
272
|
920 do
|
|
921 {
|
|
922 last_time = catchlist == catch;
|
1196
|
923
|
|
924 /* Unwind the specpdl stack, and then restore the proper set of
|
|
925 handlers. */
|
272
|
926 unbind_to (catchlist->pdlcount, Qnil);
|
|
927 handlerlist = catchlist->handlerlist;
|
|
928 catchlist = catchlist->next;
|
|
929 }
|
|
930 while (! last_time);
|
|
931
|
|
932 gcprolist = catch->gcpro;
|
|
933 backtrace_list = catch->backlist;
|
|
934 lisp_eval_depth = catch->lisp_eval_depth;
|
1199
|
935
|
|
936 _longjmp (catch->jmp, 1);
|
272
|
937 }
|
|
938
|
|
939 DEFUN ("throw", Fthrow, Sthrow, 2, 2, 0,
|
|
940 "(throw TAG VALUE): throw to the catch for TAG and return VALUE from it.\n\
|
|
941 Both TAG and VALUE are evalled.")
|
|
942 (tag, val)
|
|
943 register Lisp_Object tag, val;
|
|
944 {
|
|
945 register struct catchtag *c;
|
|
946
|
|
947 while (1)
|
|
948 {
|
485
|
949 if (!NILP (tag))
|
272
|
950 for (c = catchlist; c; c = c->next)
|
|
951 {
|
|
952 if (EQ (c->tag, tag))
|
1199
|
953 unwind_to_catch (c, val);
|
272
|
954 }
|
|
955 tag = Fsignal (Qno_catch, Fcons (tag, Fcons (val, Qnil)));
|
|
956 }
|
|
957 }
|
|
958
|
|
959
|
|
960 DEFUN ("unwind-protect", Funwind_protect, Sunwind_protect, 1, UNEVALLED, 0,
|
|
961 "Do BODYFORM, protecting with UNWINDFORMS.\n\
|
|
962 Usage looks like (unwind-protect BODYFORM UNWINDFORMS...).\n\
|
|
963 If BODYFORM completes normally, its value is returned\n\
|
|
964 after executing the UNWINDFORMS.\n\
|
|
965 If BODYFORM exits nonlocally, the UNWINDFORMS are executed anyway.")
|
|
966 (args)
|
|
967 Lisp_Object args;
|
|
968 {
|
|
969 Lisp_Object val;
|
|
970 int count = specpdl_ptr - specpdl;
|
|
971
|
|
972 record_unwind_protect (0, Fcdr (args));
|
|
973 val = Feval (Fcar (args));
|
|
974 return unbind_to (count, val);
|
|
975 }
|
|
976
|
|
977 /* Chain of condition handlers currently in effect.
|
|
978 The elements of this chain are contained in the stack frames
|
|
979 of Fcondition_case and internal_condition_case.
|
|
980 When an error is signaled (by calling Fsignal, below),
|
|
981 this chain is searched for an element that applies. */
|
|
982
|
|
983 struct handler *handlerlist;
|
|
984
|
|
985 DEFUN ("condition-case", Fcondition_case, Scondition_case, 2, UNEVALLED, 0,
|
|
986 "Regain control when an error is signaled.\n\
|
|
987 Usage looks like (condition-case VAR BODYFORM HANDLERS...).\n\
|
|
988 executes BODYFORM and returns its value if no error happens.\n\
|
|
989 Each element of HANDLERS looks like (CONDITION-NAME BODY...)\n\
|
|
990 where the BODY is made of Lisp expressions.\n\n\
|
|
991 A handler is applicable to an error\n\
|
|
992 if CONDITION-NAME is one of the error's condition names.\n\
|
|
993 If an error happens, the first applicable handler is run.\n\
|
|
994 \n\
|
|
995 When a handler handles an error,\n\
|
|
996 control returns to the condition-case and the handler BODY... is executed\n\
|
|
997 with VAR bound to (SIGNALED-CONDITIONS . SIGNAL-DATA).\n\
|
|
998 VAR may be nil; then you do not get access to the signal information.\n\
|
|
999 \n\
|
|
1000 The value of the last BODY form is returned from the condition-case.\n\
|
|
1001 See also the function `signal' for more info.")
|
|
1002 (args)
|
|
1003 Lisp_Object args;
|
|
1004 {
|
|
1005 Lisp_Object val;
|
|
1006 struct catchtag c;
|
|
1007 struct handler h;
|
1196
|
1008 register Lisp_Object var, bodyform, handlers;
|
|
1009
|
|
1010 var = Fcar (args);
|
|
1011 bodyform = Fcar (Fcdr (args));
|
|
1012 handlers = Fcdr (Fcdr (args));
|
|
1013 CHECK_SYMBOL (var, 0);
|
272
|
1014
|
1196
|
1015 for (val = handlers; ! NILP (val); val = Fcdr (val))
|
|
1016 {
|
|
1017 Lisp_Object tem;
|
|
1018 tem = Fcar (val);
|
|
1019 if ((!NILP (tem)) &&
|
|
1020 (!CONSP (tem) || (XTYPE (XCONS (tem)->car) != Lisp_Symbol)))
|
|
1021 error ("Invalid condition handler", tem);
|
|
1022 }
|
272
|
1023
|
|
1024 c.tag = Qnil;
|
|
1025 c.val = Qnil;
|
|
1026 c.backlist = backtrace_list;
|
|
1027 c.handlerlist = handlerlist;
|
|
1028 c.lisp_eval_depth = lisp_eval_depth;
|
|
1029 c.pdlcount = specpdl_ptr - specpdl;
|
|
1030 c.poll_suppress_count = poll_suppress_count;
|
|
1031 c.gcpro = gcprolist;
|
|
1032 if (_setjmp (c.jmp))
|
|
1033 {
|
485
|
1034 if (!NILP (h.var))
|
272
|
1035 specbind (h.var, Fcdr (c.val));
|
|
1036 val = Fprogn (Fcdr (Fcar (c.val)));
|
1196
|
1037
|
|
1038 /* Note that this just undoes the binding of h.var; whoever
|
|
1039 longjumped to us unwound the stack to c.pdlcount before
|
|
1040 throwing. */
|
272
|
1041 unbind_to (c.pdlcount, Qnil);
|
|
1042 return val;
|
|
1043 }
|
|
1044 c.next = catchlist;
|
|
1045 catchlist = &c;
|
|
1046
|
1196
|
1047 h.var = var;
|
|
1048 h.handler = handlers;
|
272
|
1049 h.next = handlerlist;
|
|
1050 h.tag = &c;
|
|
1051 handlerlist = &h;
|
|
1052
|
1196
|
1053 val = Feval (bodyform);
|
272
|
1054 catchlist = c.next;
|
|
1055 handlerlist = h.next;
|
|
1056 return val;
|
|
1057 }
|
|
1058
|
|
1059 Lisp_Object
|
|
1060 internal_condition_case (bfun, handlers, hfun)
|
|
1061 Lisp_Object (*bfun) ();
|
|
1062 Lisp_Object handlers;
|
|
1063 Lisp_Object (*hfun) ();
|
|
1064 {
|
|
1065 Lisp_Object val;
|
|
1066 struct catchtag c;
|
|
1067 struct handler h;
|
|
1068
|
|
1069 c.tag = Qnil;
|
|
1070 c.val = Qnil;
|
|
1071 c.backlist = backtrace_list;
|
|
1072 c.handlerlist = handlerlist;
|
|
1073 c.lisp_eval_depth = lisp_eval_depth;
|
|
1074 c.pdlcount = specpdl_ptr - specpdl;
|
|
1075 c.poll_suppress_count = poll_suppress_count;
|
|
1076 c.gcpro = gcprolist;
|
|
1077 if (_setjmp (c.jmp))
|
|
1078 {
|
|
1079 return (*hfun) (Fcdr (c.val));
|
|
1080 }
|
|
1081 c.next = catchlist;
|
|
1082 catchlist = &c;
|
|
1083 h.handler = handlers;
|
|
1084 h.var = Qnil;
|
|
1085 h.next = handlerlist;
|
|
1086 h.tag = &c;
|
|
1087 handlerlist = &h;
|
|
1088
|
|
1089 val = (*bfun) ();
|
|
1090 catchlist = c.next;
|
|
1091 handlerlist = h.next;
|
|
1092 return val;
|
|
1093 }
|
|
1094
|
|
1095 static Lisp_Object find_handler_clause ();
|
|
1096
|
|
1097 DEFUN ("signal", Fsignal, Ssignal, 2, 2, 0,
|
|
1098 "Signal an error. Args are SIGNAL-NAME, and associated DATA.\n\
|
|
1099 This function does not return.\n\n\
|
|
1100 A signal name is a symbol with an `error-conditions' property\n\
|
|
1101 that is a list of condition names.\n\
|
|
1102 A handler for any of those names will get to handle this signal.\n\
|
|
1103 The symbol `error' should normally be one of them.\n\
|
|
1104 \n\
|
|
1105 DATA should be a list. Its elements are printed as part of the error message.\n\
|
|
1106 If the signal is handled, DATA is made available to the handler.\n\
|
|
1107 See also the function `condition-case'.")
|
|
1108 (sig, data)
|
|
1109 Lisp_Object sig, data;
|
|
1110 {
|
|
1111 register struct handler *allhandlers = handlerlist;
|
|
1112 Lisp_Object conditions;
|
|
1113 extern int gc_in_progress;
|
|
1114 extern int waiting_for_input;
|
|
1115 Lisp_Object debugger_value;
|
|
1116
|
|
1117 quit_error_check ();
|
|
1118 immediate_quit = 0;
|
|
1119 if (gc_in_progress || waiting_for_input)
|
|
1120 abort ();
|
|
1121
|
732
|
1122 #ifdef HAVE_X_WINDOWS
|
272
|
1123 TOTALLY_UNBLOCK_INPUT;
|
732
|
1124 #endif
|
272
|
1125
|
|
1126 conditions = Fget (sig, Qerror_conditions);
|
|
1127
|
|
1128 for (; handlerlist; handlerlist = handlerlist->next)
|
|
1129 {
|
|
1130 register Lisp_Object clause;
|
|
1131 clause = find_handler_clause (handlerlist->handler, conditions,
|
|
1132 sig, data, &debugger_value);
|
|
1133
|
|
1134 #if 0 /* Most callers are not prepared to handle gc if this returns.
|
|
1135 So, since this feature is not very useful, take it out. */
|
|
1136 /* If have called debugger and user wants to continue,
|
|
1137 just return nil. */
|
|
1138 if (EQ (clause, Qlambda))
|
|
1139 return debugger_value;
|
|
1140 #else
|
|
1141 if (EQ (clause, Qlambda))
|
1196
|
1142 {
|
|
1143 /* We can't return values to code which signalled an error, but we
|
|
1144 can continue code which has signalled a quit. */
|
|
1145 if (EQ (sig, Qquit))
|
|
1146 return Qnil;
|
|
1147 else
|
272
|
1148 error ("Returning a value from an error is no longer supported");
|
1196
|
1149 }
|
272
|
1150 #endif
|
|
1151
|
485
|
1152 if (!NILP (clause))
|
272
|
1153 {
|
|
1154 struct handler *h = handlerlist;
|
|
1155 handlerlist = allhandlers;
|
1199
|
1156 unwind_to_catch (h->tag, Fcons (clause, Fcons (sig, data)));
|
272
|
1157 }
|
|
1158 }
|
|
1159
|
|
1160 handlerlist = allhandlers;
|
|
1161 /* If no handler is present now, try to run the debugger,
|
|
1162 and if that fails, throw to top level. */
|
|
1163 find_handler_clause (Qerror, conditions, sig, data, &debugger_value);
|
|
1164 Fthrow (Qtop_level, Qt);
|
|
1165 }
|
|
1166
|
684
|
1167 /* Return nonzero iff LIST is a non-nil atom or
|
|
1168 a list containing one of CONDITIONS. */
|
|
1169
|
|
1170 static int
|
|
1171 wants_debugger (list, conditions)
|
|
1172 Lisp_Object list, conditions;
|
|
1173 {
|
706
|
1174 if (NILP (list))
|
684
|
1175 return 0;
|
|
1176 if (! CONSP (list))
|
|
1177 return 1;
|
|
1178
|
878
|
1179 while (CONSP (conditions))
|
684
|
1180 {
|
878
|
1181 Lisp_Object this, tail;
|
|
1182 this = XCONS (conditions)->car;
|
|
1183 for (tail = list; CONSP (tail); tail = XCONS (tail)->cdr)
|
|
1184 if (EQ (XCONS (tail)->car, this))
|
684
|
1185 return 1;
|
|
1186 conditions = XCONS (conditions)->cdr;
|
|
1187 }
|
878
|
1188 return 0;
|
684
|
1189 }
|
|
1190
|
|
1191 /* Value of Qlambda means we have called debugger and user has continued.
|
|
1192 Store value returned from debugger into *DEBUGGER_VALUE_PTR. */
|
272
|
1193
|
|
1194 static Lisp_Object
|
|
1195 find_handler_clause (handlers, conditions, sig, data, debugger_value_ptr)
|
|
1196 Lisp_Object handlers, conditions, sig, data;
|
|
1197 Lisp_Object *debugger_value_ptr;
|
|
1198 {
|
|
1199 register Lisp_Object h;
|
|
1200 register Lisp_Object tem;
|
|
1201 register Lisp_Object tem1;
|
|
1202
|
|
1203 if (EQ (handlers, Qt)) /* t is used by handlers for all conditions, set up by C code. */
|
|
1204 return Qt;
|
|
1205 if (EQ (handlers, Qerror)) /* error is used similarly, but means display a backtrace too */
|
|
1206 {
|
684
|
1207 if (wants_debugger (Vstack_trace_on_error, conditions))
|
272
|
1208 internal_with_output_to_temp_buffer ("*Backtrace*", Fbacktrace, Qnil);
|
1199
|
1209 if ((EQ (sig, Qquit)
|
|
1210 ? debug_on_quit
|
|
1211 : wants_debugger (Vdebug_on_error, conditions))
|
|
1212 && when_entered_debugger < num_nonmacro_input_chars)
|
272
|
1213 {
|
|
1214 int count = specpdl_ptr - specpdl;
|
|
1215 specbind (Qdebug_on_error, Qnil);
|
|
1216 *debugger_value_ptr =
|
|
1217 call_debugger (Fcons (Qerror,
|
|
1218 Fcons (Fcons (sig, data),
|
|
1219 Qnil)));
|
|
1220 return unbind_to (count, Qlambda);
|
|
1221 }
|
|
1222 return Qt;
|
|
1223 }
|
|
1224 for (h = handlers; CONSP (h); h = Fcdr (h))
|
|
1225 {
|
|
1226 tem1 = Fcar (h);
|
|
1227 if (!CONSP (tem1))
|
|
1228 continue;
|
|
1229 tem = Fmemq (Fcar (tem1), conditions);
|
485
|
1230 if (!NILP (tem))
|
272
|
1231 return tem1;
|
|
1232 }
|
|
1233 return Qnil;
|
|
1234 }
|
|
1235
|
|
1236 /* dump an error message; called like printf */
|
|
1237
|
|
1238 /* VARARGS 1 */
|
|
1239 void
|
|
1240 error (m, a1, a2, a3)
|
|
1241 char *m;
|
|
1242 {
|
|
1243 char buf[200];
|
|
1244 sprintf (buf, m, a1, a2, a3);
|
|
1245
|
|
1246 while (1)
|
|
1247 Fsignal (Qerror, Fcons (build_string (buf), Qnil));
|
|
1248 }
|
|
1249
|
|
1250 DEFUN ("commandp", Fcommandp, Scommandp, 1, 1, 0,
|
|
1251 "T if FUNCTION makes provisions for interactive calling.\n\
|
|
1252 This means it contains a description for how to read arguments to give it.\n\
|
|
1253 The value is nil for an invalid function or a symbol with no function\n\
|
|
1254 definition.\n\
|
|
1255 \n\
|
|
1256 Interactively callable functions include strings and vectors (treated\n\
|
|
1257 as keyboard macros), lambda-expressions that contain a top-level call\n\
|
|
1258 to `interactive', autoload definitions made by `autoload' with non-nil\n\
|
|
1259 fourth argument, and some of the built-in functions of Lisp.\n\
|
|
1260 \n\
|
|
1261 Also, a symbol satisfies `commandp' if its function definition does so.")
|
|
1262 (function)
|
|
1263 Lisp_Object function;
|
|
1264 {
|
|
1265 register Lisp_Object fun;
|
|
1266 register Lisp_Object funcar;
|
|
1267 register Lisp_Object tem;
|
|
1268 register int i = 0;
|
|
1269
|
|
1270 fun = function;
|
|
1271
|
648
|
1272 fun = indirect_function (fun);
|
|
1273 if (EQ (fun, Qunbound))
|
|
1274 return Qnil;
|
272
|
1275
|
|
1276 /* Emacs primitives are interactive if their DEFUN specifies an
|
|
1277 interactive spec. */
|
|
1278 if (XTYPE (fun) == Lisp_Subr)
|
|
1279 {
|
|
1280 if (XSUBR (fun)->prompt)
|
|
1281 return Qt;
|
|
1282 else
|
|
1283 return Qnil;
|
|
1284 }
|
|
1285
|
|
1286 /* Bytecode objects are interactive if they are long enough to
|
|
1287 have an element whose index is COMPILED_INTERACTIVE, which is
|
|
1288 where the interactive spec is stored. */
|
|
1289 else if (XTYPE (fun) == Lisp_Compiled)
|
|
1290 return (XVECTOR (fun)->size > COMPILED_INTERACTIVE
|
|
1291 ? Qt : Qnil);
|
|
1292
|
|
1293 /* Strings and vectors are keyboard macros. */
|
|
1294 if (XTYPE (fun) == Lisp_String
|
|
1295 || XTYPE (fun) == Lisp_Vector)
|
|
1296 return Qt;
|
|
1297
|
|
1298 /* Lists may represent commands. */
|
|
1299 if (!CONSP (fun))
|
|
1300 return Qnil;
|
|
1301 funcar = Fcar (fun);
|
|
1302 if (XTYPE (funcar) != Lisp_Symbol)
|
|
1303 return Fsignal (Qinvalid_function, Fcons (fun, Qnil));
|
|
1304 if (EQ (funcar, Qlambda))
|
|
1305 return Fassq (Qinteractive, Fcdr (Fcdr (fun)));
|
|
1306 if (EQ (funcar, Qmocklisp))
|
|
1307 return Qt; /* All mocklisp functions can be called interactively */
|
|
1308 if (EQ (funcar, Qautoload))
|
|
1309 return Fcar (Fcdr (Fcdr (Fcdr (fun))));
|
|
1310 else
|
|
1311 return Qnil;
|
|
1312 }
|
|
1313
|
|
1314 /* ARGSUSED */
|
|
1315 DEFUN ("autoload", Fautoload, Sautoload, 2, 5, 0,
|
|
1316 "Define FUNCTION to autoload from FILE.\n\
|
|
1317 FUNCTION is a symbol; FILE is a file name string to pass to `load'.\n\
|
|
1318 Third arg DOCSTRING is documentation for the function.\n\
|
|
1319 Fourth arg INTERACTIVE if non-nil says function can be called interactively.\n\
|
1564
|
1320 Fifth arg TYPE indicates the type of the object:\n\
|
|
1321 nil or omitted says FUNCTION is a function,\n\
|
|
1322 `keymap' says FUNCTION is really a keymap, and\n\
|
|
1323 `macro' or t says FUNCTION is really a macro.\n\
|
272
|
1324 Third through fifth args give info about the real definition.\n\
|
|
1325 They default to nil.\n\
|
|
1326 If FUNCTION is already defined other than as an autoload,\n\
|
|
1327 this does nothing and returns nil.")
|
1564
|
1328 (function, file, docstring, interactive, type)
|
|
1329 Lisp_Object function, file, docstring, interactive, type;
|
272
|
1330 {
|
|
1331 #ifdef NO_ARG_ARRAY
|
|
1332 Lisp_Object args[4];
|
|
1333 #endif
|
|
1334
|
|
1335 CHECK_SYMBOL (function, 0);
|
|
1336 CHECK_STRING (file, 1);
|
|
1337
|
|
1338 /* If function is defined and not as an autoload, don't override */
|
|
1339 if (!EQ (XSYMBOL (function)->function, Qunbound)
|
|
1340 && !(XTYPE (XSYMBOL (function)->function) == Lisp_Cons
|
|
1341 && EQ (XCONS (XSYMBOL (function)->function)->car, Qautoload)))
|
|
1342 return Qnil;
|
|
1343
|
|
1344 #ifdef NO_ARG_ARRAY
|
|
1345 args[0] = file;
|
|
1346 args[1] = docstring;
|
|
1347 args[2] = interactive;
|
1564
|
1348 args[3] = type;
|
272
|
1349
|
|
1350 return Ffset (function, Fcons (Qautoload, Flist (4, &args[0])));
|
|
1351 #else /* NO_ARG_ARRAY */
|
|
1352 return Ffset (function, Fcons (Qautoload, Flist (4, &file)));
|
|
1353 #endif /* not NO_ARG_ARRAY */
|
|
1354 }
|
|
1355
|
|
1356 Lisp_Object
|
|
1357 un_autoload (oldqueue)
|
|
1358 Lisp_Object oldqueue;
|
|
1359 {
|
|
1360 register Lisp_Object queue, first, second;
|
|
1361
|
|
1362 /* Queue to unwind is current value of Vautoload_queue.
|
|
1363 oldqueue is the shadowed value to leave in Vautoload_queue. */
|
|
1364 queue = Vautoload_queue;
|
|
1365 Vautoload_queue = oldqueue;
|
|
1366 while (CONSP (queue))
|
|
1367 {
|
|
1368 first = Fcar (queue);
|
|
1369 second = Fcdr (first);
|
|
1370 first = Fcar (first);
|
|
1371 if (EQ (second, Qnil))
|
|
1372 Vfeatures = first;
|
|
1373 else
|
|
1374 Ffset (first, second);
|
|
1375 queue = Fcdr (queue);
|
|
1376 }
|
|
1377 return Qnil;
|
|
1378 }
|
|
1379
|
|
1380 do_autoload (fundef, funname)
|
|
1381 Lisp_Object fundef, funname;
|
|
1382 {
|
|
1383 int count = specpdl_ptr - specpdl;
|
2547
|
1384 Lisp_Object fun, val, queue, first, second;
|
272
|
1385
|
|
1386 fun = funname;
|
|
1387 CHECK_SYMBOL (funname, 0);
|
|
1388
|
|
1389 /* Value saved here is to be restored into Vautoload_queue */
|
|
1390 record_unwind_protect (un_autoload, Vautoload_queue);
|
|
1391 Vautoload_queue = Qt;
|
|
1392 Fload (Fcar (Fcdr (fundef)), Qnil, noninteractive ? Qt : Qnil, Qnil);
|
2547
|
1393
|
|
1394 /* Save the old autoloads, in case we ever do an unload. */
|
|
1395 queue = Vautoload_queue;
|
|
1396 while (CONSP (queue))
|
|
1397 {
|
|
1398 first = Fcar (queue);
|
|
1399 second = Fcdr (first);
|
|
1400 first = Fcar (first);
|
2599
5122736c0a03
(do_autoload): Fixed the bug in the autoload-saving code.
Eric S. Raymond <esr@snark.thyrsus.com>
diff
changeset
|
1401
|
5122736c0a03
(do_autoload): Fixed the bug in the autoload-saving code.
Eric S. Raymond <esr@snark.thyrsus.com>
diff
changeset
|
1402 /* Note: This test is subtle. The cdr of an autoload-queue entry
|
5122736c0a03
(do_autoload): Fixed the bug in the autoload-saving code.
Eric S. Raymond <esr@snark.thyrsus.com>
diff
changeset
|
1403 may be an atom if the autoload entry was generated by a defalias
|
5122736c0a03
(do_autoload): Fixed the bug in the autoload-saving code.
Eric S. Raymond <esr@snark.thyrsus.com>
diff
changeset
|
1404 or fset. */
|
5122736c0a03
(do_autoload): Fixed the bug in the autoload-saving code.
Eric S. Raymond <esr@snark.thyrsus.com>
diff
changeset
|
1405 if (CONSP (second))
|
2547
|
1406 Fput(first, Qautoload, (Fcdr (second)));
|
2599
5122736c0a03
(do_autoload): Fixed the bug in the autoload-saving code.
Eric S. Raymond <esr@snark.thyrsus.com>
diff
changeset
|
1407
|
2547
|
1408 queue = Fcdr (queue);
|
|
1409 }
|
|
1410
|
272
|
1411 /* Once loading finishes, don't undo it. */
|
|
1412 Vautoload_queue = Qt;
|
|
1413 unbind_to (count, Qnil);
|
|
1414
|
648
|
1415 fun = Findirect_function (fun);
|
|
1416
|
272
|
1417 if (XTYPE (fun) == Lisp_Cons
|
|
1418 && EQ (XCONS (fun)->car, Qautoload))
|
|
1419 error ("Autoloading failed to define function %s",
|
|
1420 XSYMBOL (funname)->name->data);
|
|
1421 }
|
|
1422
|
|
1423 DEFUN ("eval", Feval, Seval, 1, 1, 0,
|
|
1424 "Evaluate FORM and return its value.")
|
|
1425 (form)
|
|
1426 Lisp_Object form;
|
|
1427 {
|
|
1428 Lisp_Object fun, val, original_fun, original_args;
|
|
1429 Lisp_Object funcar;
|
|
1430 struct backtrace backtrace;
|
|
1431 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
1432
|
|
1433 if (XTYPE (form) == Lisp_Symbol)
|
|
1434 {
|
|
1435 if (EQ (Vmocklisp_arguments, Qt))
|
|
1436 return Fsymbol_value (form);
|
|
1437 val = Fsymbol_value (form);
|
485
|
1438 if (NILP (val))
|
272
|
1439 XFASTINT (val) = 0;
|
|
1440 else if (EQ (val, Qt))
|
|
1441 XFASTINT (val) = 1;
|
|
1442 return val;
|
|
1443 }
|
|
1444 if (!CONSP (form))
|
|
1445 return form;
|
|
1446
|
|
1447 QUIT;
|
|
1448 if (consing_since_gc > gc_cons_threshold)
|
|
1449 {
|
|
1450 GCPRO1 (form);
|
|
1451 Fgarbage_collect ();
|
|
1452 UNGCPRO;
|
|
1453 }
|
|
1454
|
|
1455 if (++lisp_eval_depth > max_lisp_eval_depth)
|
|
1456 {
|
|
1457 if (max_lisp_eval_depth < 100)
|
|
1458 max_lisp_eval_depth = 100;
|
|
1459 if (lisp_eval_depth > max_lisp_eval_depth)
|
|
1460 error ("Lisp nesting exceeds max-lisp-eval-depth");
|
|
1461 }
|
|
1462
|
|
1463 original_fun = Fcar (form);
|
|
1464 original_args = Fcdr (form);
|
|
1465
|
|
1466 backtrace.next = backtrace_list;
|
|
1467 backtrace_list = &backtrace;
|
|
1468 backtrace.function = &original_fun; /* This also protects them from gc */
|
|
1469 backtrace.args = &original_args;
|
|
1470 backtrace.nargs = UNEVALLED;
|
|
1471 backtrace.evalargs = 1;
|
|
1472 backtrace.debug_on_exit = 0;
|
|
1473
|
|
1474 if (debug_on_next_call)
|
|
1475 do_debug_on_call (Qt);
|
|
1476
|
|
1477 /* At this point, only original_fun and original_args
|
|
1478 have values that will be used below */
|
|
1479 retry:
|
648
|
1480 fun = Findirect_function (original_fun);
|
272
|
1481
|
|
1482 if (XTYPE (fun) == Lisp_Subr)
|
|
1483 {
|
|
1484 Lisp_Object numargs;
|
|
1485 Lisp_Object argvals[7];
|
|
1486 Lisp_Object args_left;
|
|
1487 register int i, maxargs;
|
|
1488
|
|
1489 args_left = original_args;
|
|
1490 numargs = Flength (args_left);
|
|
1491
|
|
1492 if (XINT (numargs) < XSUBR (fun)->min_args ||
|
|
1493 (XSUBR (fun)->max_args >= 0 && XSUBR (fun)->max_args < XINT (numargs)))
|
|
1494 return Fsignal (Qwrong_number_of_arguments, Fcons (fun, Fcons (numargs, Qnil)));
|
|
1495
|
|
1496 if (XSUBR (fun)->max_args == UNEVALLED)
|
|
1497 {
|
|
1498 backtrace.evalargs = 0;
|
|
1499 val = (*XSUBR (fun)->function) (args_left);
|
|
1500 goto done;
|
|
1501 }
|
|
1502
|
|
1503 if (XSUBR (fun)->max_args == MANY)
|
|
1504 {
|
|
1505 /* Pass a vector of evaluated arguments */
|
|
1506 Lisp_Object *vals;
|
|
1507 register int argnum = 0;
|
|
1508
|
|
1509 vals = (Lisp_Object *) alloca (XINT (numargs) * sizeof (Lisp_Object));
|
|
1510
|
|
1511 GCPRO3 (args_left, fun, fun);
|
|
1512 gcpro3.var = vals;
|
|
1513 gcpro3.nvars = 0;
|
|
1514
|
485
|
1515 while (!NILP (args_left))
|
272
|
1516 {
|
|
1517 vals[argnum++] = Feval (Fcar (args_left));
|
|
1518 args_left = Fcdr (args_left);
|
|
1519 gcpro3.nvars = argnum;
|
|
1520 }
|
|
1521
|
|
1522 backtrace.args = vals;
|
|
1523 backtrace.nargs = XINT (numargs);
|
|
1524
|
|
1525 val = (*XSUBR (fun)->function) (XINT (numargs), vals);
|
323
|
1526 UNGCPRO;
|
272
|
1527 goto done;
|
|
1528 }
|
|
1529
|
|
1530 GCPRO3 (args_left, fun, fun);
|
|
1531 gcpro3.var = argvals;
|
|
1532 gcpro3.nvars = 0;
|
|
1533
|
|
1534 maxargs = XSUBR (fun)->max_args;
|
|
1535 for (i = 0; i < maxargs; args_left = Fcdr (args_left))
|
|
1536 {
|
|
1537 argvals[i] = Feval (Fcar (args_left));
|
|
1538 gcpro3.nvars = ++i;
|
|
1539 }
|
|
1540
|
|
1541 UNGCPRO;
|
|
1542
|
|
1543 backtrace.args = argvals;
|
|
1544 backtrace.nargs = XINT (numargs);
|
|
1545
|
|
1546 switch (i)
|
|
1547 {
|
|
1548 case 0:
|
|
1549 val = (*XSUBR (fun)->function) ();
|
|
1550 goto done;
|
|
1551 case 1:
|
|
1552 val = (*XSUBR (fun)->function) (argvals[0]);
|
|
1553 goto done;
|
|
1554 case 2:
|
|
1555 val = (*XSUBR (fun)->function) (argvals[0], argvals[1]);
|
|
1556 goto done;
|
|
1557 case 3:
|
|
1558 val = (*XSUBR (fun)->function) (argvals[0], argvals[1],
|
|
1559 argvals[2]);
|
|
1560 goto done;
|
|
1561 case 4:
|
|
1562 val = (*XSUBR (fun)->function) (argvals[0], argvals[1],
|
|
1563 argvals[2], argvals[3]);
|
|
1564 goto done;
|
|
1565 case 5:
|
|
1566 val = (*XSUBR (fun)->function) (argvals[0], argvals[1], argvals[2],
|
|
1567 argvals[3], argvals[4]);
|
|
1568 goto done;
|
|
1569 case 6:
|
|
1570 val = (*XSUBR (fun)->function) (argvals[0], argvals[1], argvals[2],
|
|
1571 argvals[3], argvals[4], argvals[5]);
|
|
1572 goto done;
|
863
|
1573 case 7:
|
|
1574 val = (*XSUBR (fun)->function) (argvals[0], argvals[1], argvals[2],
|
|
1575 argvals[3], argvals[4], argvals[5],
|
|
1576 argvals[6]);
|
|
1577 goto done;
|
272
|
1578
|
|
1579 default:
|
604
|
1580 /* Someone has created a subr that takes more arguments than
|
|
1581 is supported by this code. We need to either rewrite the
|
|
1582 subr to use a different argument protocol, or add more
|
|
1583 cases to this switch. */
|
|
1584 abort ();
|
272
|
1585 }
|
|
1586 }
|
|
1587 if (XTYPE (fun) == Lisp_Compiled)
|
|
1588 val = apply_lambda (fun, original_args, 1);
|
|
1589 else
|
|
1590 {
|
|
1591 if (!CONSP (fun))
|
|
1592 return Fsignal (Qinvalid_function, Fcons (fun, Qnil));
|
|
1593 funcar = Fcar (fun);
|
|
1594 if (XTYPE (funcar) != Lisp_Symbol)
|
|
1595 return Fsignal (Qinvalid_function, Fcons (fun, Qnil));
|
|
1596 if (EQ (funcar, Qautoload))
|
|
1597 {
|
|
1598 do_autoload (fun, original_fun);
|
|
1599 goto retry;
|
|
1600 }
|
|
1601 if (EQ (funcar, Qmacro))
|
|
1602 val = Feval (apply1 (Fcdr (fun), original_args));
|
|
1603 else if (EQ (funcar, Qlambda))
|
|
1604 val = apply_lambda (fun, original_args, 1);
|
|
1605 else if (EQ (funcar, Qmocklisp))
|
|
1606 val = ml_apply (fun, original_args);
|
|
1607 else
|
|
1608 return Fsignal (Qinvalid_function, Fcons (fun, Qnil));
|
|
1609 }
|
|
1610 done:
|
|
1611 if (!EQ (Vmocklisp_arguments, Qt))
|
|
1612 {
|
485
|
1613 if (NILP (val))
|
272
|
1614 XFASTINT (val) = 0;
|
|
1615 else if (EQ (val, Qt))
|
|
1616 XFASTINT (val) = 1;
|
|
1617 }
|
|
1618 lisp_eval_depth--;
|
|
1619 if (backtrace.debug_on_exit)
|
|
1620 val = call_debugger (Fcons (Qexit, Fcons (val, Qnil)));
|
|
1621 backtrace_list = backtrace.next;
|
|
1622 return val;
|
|
1623 }
|
|
1624
|
|
1625 DEFUN ("apply", Fapply, Sapply, 2, MANY, 0,
|
|
1626 "Call FUNCTION with our remaining args, using our last arg as list of args.\n\
|
|
1627 Thus, (apply '+ 1 2 '(3 4)) returns 10.")
|
|
1628 (nargs, args)
|
|
1629 int nargs;
|
|
1630 Lisp_Object *args;
|
|
1631 {
|
|
1632 register int i, numargs;
|
|
1633 register Lisp_Object spread_arg;
|
|
1634 register Lisp_Object *funcall_args;
|
|
1635 Lisp_Object fun;
|
323
|
1636 struct gcpro gcpro1;
|
272
|
1637
|
|
1638 fun = args [0];
|
|
1639 funcall_args = 0;
|
|
1640 spread_arg = args [nargs - 1];
|
|
1641 CHECK_LIST (spread_arg, nargs);
|
|
1642
|
|
1643 numargs = XINT (Flength (spread_arg));
|
|
1644
|
|
1645 if (numargs == 0)
|
|
1646 return Ffuncall (nargs - 1, args);
|
|
1647 else if (numargs == 1)
|
|
1648 {
|
|
1649 args [nargs - 1] = XCONS (spread_arg)->car;
|
|
1650 return Ffuncall (nargs, args);
|
|
1651 }
|
|
1652
|
323
|
1653 numargs += nargs - 2;
|
272
|
1654
|
648
|
1655 fun = indirect_function (fun);
|
|
1656 if (EQ (fun, Qunbound))
|
272
|
1657 {
|
648
|
1658 /* Let funcall get the error */
|
|
1659 fun = args[0];
|
|
1660 goto funcall;
|
272
|
1661 }
|
|
1662
|
|
1663 if (XTYPE (fun) == Lisp_Subr)
|
|
1664 {
|
|
1665 if (numargs < XSUBR (fun)->min_args
|
|
1666 || (XSUBR (fun)->max_args >= 0 && XSUBR (fun)->max_args < numargs))
|
|
1667 goto funcall; /* Let funcall get the error */
|
|
1668 else if (XSUBR (fun)->max_args > numargs)
|
|
1669 {
|
|
1670 /* Avoid making funcall cons up a yet another new vector of arguments
|
|
1671 by explicitly supplying nil's for optional values */
|
|
1672 funcall_args = (Lisp_Object *) alloca ((1 + XSUBR (fun)->max_args)
|
|
1673 * sizeof (Lisp_Object));
|
|
1674 for (i = numargs; i < XSUBR (fun)->max_args;)
|
|
1675 funcall_args[++i] = Qnil;
|
323
|
1676 GCPRO1 (*funcall_args);
|
|
1677 gcpro1.nvars = 1 + XSUBR (fun)->max_args;
|
272
|
1678 }
|
|
1679 }
|
|
1680 funcall:
|
|
1681 /* We add 1 to numargs because funcall_args includes the
|
|
1682 function itself as well as its arguments. */
|
|
1683 if (!funcall_args)
|
323
|
1684 {
|
|
1685 funcall_args = (Lisp_Object *) alloca ((1 + numargs)
|
|
1686 * sizeof (Lisp_Object));
|
|
1687 GCPRO1 (*funcall_args);
|
|
1688 gcpro1.nvars = 1 + numargs;
|
|
1689 }
|
|
1690
|
272
|
1691 bcopy (args, funcall_args, nargs * sizeof (Lisp_Object));
|
|
1692 /* Spread the last arg we got. Its first element goes in
|
|
1693 the slot that it used to occupy, hence this value of I. */
|
|
1694 i = nargs - 1;
|
485
|
1695 while (!NILP (spread_arg))
|
272
|
1696 {
|
|
1697 funcall_args [i++] = XCONS (spread_arg)->car;
|
|
1698 spread_arg = XCONS (spread_arg)->cdr;
|
|
1699 }
|
323
|
1700
|
|
1701 RETURN_UNGCPRO (Ffuncall (gcpro1.nvars, funcall_args));
|
272
|
1702 }
|
|
1703
|
|
1704 /* Apply fn to arg */
|
|
1705 Lisp_Object
|
|
1706 apply1 (fn, arg)
|
|
1707 Lisp_Object fn, arg;
|
|
1708 {
|
323
|
1709 struct gcpro gcpro1;
|
|
1710
|
|
1711 GCPRO1 (fn);
|
485
|
1712 if (NILP (arg))
|
323
|
1713 RETURN_UNGCPRO (Ffuncall (1, &fn));
|
|
1714 gcpro1.nvars = 2;
|
272
|
1715 #ifdef NO_ARG_ARRAY
|
|
1716 {
|
|
1717 Lisp_Object args[2];
|
|
1718 args[0] = fn;
|
|
1719 args[1] = arg;
|
323
|
1720 gcpro1.var = args;
|
|
1721 RETURN_UNGCPRO (Fapply (2, args));
|
272
|
1722 }
|
|
1723 #else /* not NO_ARG_ARRAY */
|
323
|
1724 RETURN_UNGCPRO (Fapply (2, &fn));
|
272
|
1725 #endif /* not NO_ARG_ARRAY */
|
|
1726 }
|
|
1727
|
|
1728 /* Call function fn on no arguments */
|
|
1729 Lisp_Object
|
|
1730 call0 (fn)
|
|
1731 Lisp_Object fn;
|
|
1732 {
|
323
|
1733 struct gcpro gcpro1;
|
|
1734
|
|
1735 GCPRO1 (fn);
|
|
1736 RETURN_UNGCPRO (Ffuncall (1, &fn));
|
272
|
1737 }
|
|
1738
|
|
1739 /* Call function fn with argument arg */
|
|
1740 /* ARGSUSED */
|
|
1741 Lisp_Object
|
|
1742 call1 (fn, arg)
|
|
1743 Lisp_Object fn, arg;
|
|
1744 {
|
323
|
1745 struct gcpro gcpro1;
|
272
|
1746 #ifdef NO_ARG_ARRAY
|
323
|
1747 Lisp_Object args[2];
|
|
1748
|
272
|
1749 args[0] = fn;
|
|
1750 args[1] = arg;
|
323
|
1751 GCPRO1 (args[0]);
|
|
1752 gcpro1.nvars = 2;
|
|
1753 RETURN_UNGCPRO (Ffuncall (2, args));
|
272
|
1754 #else /* not NO_ARG_ARRAY */
|
323
|
1755 GCPRO1 (fn);
|
|
1756 gcpro1.nvars = 2;
|
|
1757 RETURN_UNGCPRO (Ffuncall (2, &fn));
|
272
|
1758 #endif /* not NO_ARG_ARRAY */
|
|
1759 }
|
|
1760
|
|
1761 /* Call function fn with arguments arg, arg1 */
|
|
1762 /* ARGSUSED */
|
|
1763 Lisp_Object
|
|
1764 call2 (fn, arg, arg1)
|
|
1765 Lisp_Object fn, arg, arg1;
|
|
1766 {
|
323
|
1767 struct gcpro gcpro1;
|
272
|
1768 #ifdef NO_ARG_ARRAY
|
|
1769 Lisp_Object args[3];
|
|
1770 args[0] = fn;
|
|
1771 args[1] = arg;
|
|
1772 args[2] = arg1;
|
323
|
1773 GCPRO1 (args[0]);
|
|
1774 gcpro1.nvars = 3;
|
|
1775 RETURN_UNGCPRO (Ffuncall (3, args));
|
272
|
1776 #else /* not NO_ARG_ARRAY */
|
323
|
1777 GCPRO1 (fn);
|
|
1778 gcpro1.nvars = 3;
|
|
1779 RETURN_UNGCPRO (Ffuncall (3, &fn));
|
272
|
1780 #endif /* not NO_ARG_ARRAY */
|
|
1781 }
|
|
1782
|
|
1783 /* Call function fn with arguments arg, arg1, arg2 */
|
|
1784 /* ARGSUSED */
|
|
1785 Lisp_Object
|
|
1786 call3 (fn, arg, arg1, arg2)
|
|
1787 Lisp_Object fn, arg, arg1, arg2;
|
|
1788 {
|
323
|
1789 struct gcpro gcpro1;
|
272
|
1790 #ifdef NO_ARG_ARRAY
|
|
1791 Lisp_Object args[4];
|
|
1792 args[0] = fn;
|
|
1793 args[1] = arg;
|
|
1794 args[2] = arg1;
|
|
1795 args[3] = arg2;
|
323
|
1796 GCPRO1 (args[0]);
|
|
1797 gcpro1.nvars = 4;
|
|
1798 RETURN_UNGCPRO (Ffuncall (4, args));
|
272
|
1799 #else /* not NO_ARG_ARRAY */
|
323
|
1800 GCPRO1 (fn);
|
|
1801 gcpro1.nvars = 4;
|
|
1802 RETURN_UNGCPRO (Ffuncall (4, &fn));
|
272
|
1803 #endif /* not NO_ARG_ARRAY */
|
|
1804 }
|
|
1805
|
|
1806 DEFUN ("funcall", Ffuncall, Sfuncall, 1, MANY, 0,
|
|
1807 "Call first argument as a function, passing remaining arguments to it.\n\
|
|
1808 Thus, (funcall 'cons 'x 'y) returns (x . y).")
|
|
1809 (nargs, args)
|
|
1810 int nargs;
|
|
1811 Lisp_Object *args;
|
|
1812 {
|
|
1813 Lisp_Object fun;
|
|
1814 Lisp_Object funcar;
|
|
1815 int numargs = nargs - 1;
|
|
1816 Lisp_Object lisp_numargs;
|
|
1817 Lisp_Object val;
|
|
1818 struct backtrace backtrace;
|
|
1819 register Lisp_Object *internal_args;
|
|
1820 register int i;
|
|
1821
|
|
1822 QUIT;
|
|
1823 if (consing_since_gc > gc_cons_threshold)
|
323
|
1824 Fgarbage_collect ();
|
272
|
1825
|
|
1826 if (++lisp_eval_depth > max_lisp_eval_depth)
|
|
1827 {
|
|
1828 if (max_lisp_eval_depth < 100)
|
|
1829 max_lisp_eval_depth = 100;
|
|
1830 if (lisp_eval_depth > max_lisp_eval_depth)
|
|
1831 error ("Lisp nesting exceeds max-lisp-eval-depth");
|
|
1832 }
|
|
1833
|
|
1834 backtrace.next = backtrace_list;
|
|
1835 backtrace_list = &backtrace;
|
|
1836 backtrace.function = &args[0];
|
|
1837 backtrace.args = &args[1];
|
|
1838 backtrace.nargs = nargs - 1;
|
|
1839 backtrace.evalargs = 0;
|
|
1840 backtrace.debug_on_exit = 0;
|
|
1841
|
|
1842 if (debug_on_next_call)
|
|
1843 do_debug_on_call (Qlambda);
|
|
1844
|
|
1845 retry:
|
|
1846
|
|
1847 fun = args[0];
|
648
|
1848
|
|
1849 fun = Findirect_function (fun);
|
272
|
1850
|
|
1851 if (XTYPE (fun) == Lisp_Subr)
|
|
1852 {
|
|
1853 if (numargs < XSUBR (fun)->min_args
|
|
1854 || (XSUBR (fun)->max_args >= 0 && XSUBR (fun)->max_args < numargs))
|
|
1855 {
|
|
1856 XFASTINT (lisp_numargs) = numargs;
|
|
1857 return Fsignal (Qwrong_number_of_arguments, Fcons (fun, Fcons (lisp_numargs, Qnil)));
|
|
1858 }
|
|
1859
|
|
1860 if (XSUBR (fun)->max_args == UNEVALLED)
|
|
1861 return Fsignal (Qinvalid_function, Fcons (fun, Qnil));
|
|
1862
|
|
1863 if (XSUBR (fun)->max_args == MANY)
|
|
1864 {
|
|
1865 val = (*XSUBR (fun)->function) (numargs, args + 1);
|
|
1866 goto done;
|
|
1867 }
|
|
1868
|
|
1869 if (XSUBR (fun)->max_args > numargs)
|
|
1870 {
|
|
1871 internal_args = (Lisp_Object *) alloca (XSUBR (fun)->max_args * sizeof (Lisp_Object));
|
|
1872 bcopy (args + 1, internal_args, numargs * sizeof (Lisp_Object));
|
|
1873 for (i = numargs; i < XSUBR (fun)->max_args; i++)
|
|
1874 internal_args[i] = Qnil;
|
|
1875 }
|
|
1876 else
|
|
1877 internal_args = args + 1;
|
|
1878 switch (XSUBR (fun)->max_args)
|
|
1879 {
|
|
1880 case 0:
|
|
1881 val = (*XSUBR (fun)->function) ();
|
|
1882 goto done;
|
|
1883 case 1:
|
|
1884 val = (*XSUBR (fun)->function) (internal_args[0]);
|
|
1885 goto done;
|
|
1886 case 2:
|
|
1887 val = (*XSUBR (fun)->function) (internal_args[0],
|
|
1888 internal_args[1]);
|
|
1889 goto done;
|
|
1890 case 3:
|
|
1891 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
|
1892 internal_args[2]);
|
|
1893 goto done;
|
|
1894 case 4:
|
|
1895 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
|
1896 internal_args[2],
|
|
1897 internal_args[3]);
|
|
1898 goto done;
|
|
1899 case 5:
|
|
1900 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
|
1901 internal_args[2], internal_args[3],
|
|
1902 internal_args[4]);
|
|
1903 goto done;
|
|
1904 case 6:
|
|
1905 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
|
1906 internal_args[2], internal_args[3],
|
|
1907 internal_args[4], internal_args[5]);
|
|
1908 goto done;
|
863
|
1909 case 7:
|
|
1910 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
|
1911 internal_args[2], internal_args[3],
|
|
1912 internal_args[4], internal_args[5],
|
|
1913 internal_args[6]);
|
|
1914 goto done;
|
272
|
1915
|
|
1916 default:
|
573
|
1917
|
|
1918 /* If a subr takes more than 6 arguments without using MANY
|
|
1919 or UNEVALLED, we need to extend this function to support it.
|
|
1920 Until this is done, there is no way to call the function. */
|
|
1921 abort ();
|
272
|
1922 }
|
|
1923 }
|
|
1924 if (XTYPE (fun) == Lisp_Compiled)
|
|
1925 val = funcall_lambda (fun, numargs, args + 1);
|
|
1926 else
|
|
1927 {
|
|
1928 if (!CONSP (fun))
|
|
1929 return Fsignal (Qinvalid_function, Fcons (fun, Qnil));
|
|
1930 funcar = Fcar (fun);
|
|
1931 if (XTYPE (funcar) != Lisp_Symbol)
|
|
1932 return Fsignal (Qinvalid_function, Fcons (fun, Qnil));
|
|
1933 if (EQ (funcar, Qlambda))
|
|
1934 val = funcall_lambda (fun, numargs, args + 1);
|
|
1935 else if (EQ (funcar, Qmocklisp))
|
|
1936 val = ml_apply (fun, Flist (numargs, args + 1));
|
|
1937 else if (EQ (funcar, Qautoload))
|
|
1938 {
|
|
1939 do_autoload (fun, args[0]);
|
|
1940 goto retry;
|
|
1941 }
|
|
1942 else
|
|
1943 return Fsignal (Qinvalid_function, Fcons (fun, Qnil));
|
|
1944 }
|
|
1945 done:
|
|
1946 lisp_eval_depth--;
|
|
1947 if (backtrace.debug_on_exit)
|
|
1948 val = call_debugger (Fcons (Qexit, Fcons (val, Qnil)));
|
|
1949 backtrace_list = backtrace.next;
|
|
1950 return val;
|
|
1951 }
|
|
1952
|
|
1953 Lisp_Object
|
|
1954 apply_lambda (fun, args, eval_flag)
|
|
1955 Lisp_Object fun, args;
|
|
1956 int eval_flag;
|
|
1957 {
|
|
1958 Lisp_Object args_left;
|
|
1959 Lisp_Object numargs;
|
|
1960 register Lisp_Object *arg_vector;
|
|
1961 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
1962 register int i;
|
|
1963 register Lisp_Object tem;
|
|
1964
|
|
1965 numargs = Flength (args);
|
|
1966 arg_vector = (Lisp_Object *) alloca (XINT (numargs) * sizeof (Lisp_Object));
|
|
1967 args_left = args;
|
|
1968
|
|
1969 GCPRO3 (*arg_vector, args_left, fun);
|
|
1970 gcpro1.nvars = 0;
|
|
1971
|
|
1972 for (i = 0; i < XINT (numargs);)
|
|
1973 {
|
|
1974 tem = Fcar (args_left), args_left = Fcdr (args_left);
|
|
1975 if (eval_flag) tem = Feval (tem);
|
|
1976 arg_vector[i++] = tem;
|
|
1977 gcpro1.nvars = i;
|
|
1978 }
|
|
1979
|
|
1980 UNGCPRO;
|
|
1981
|
|
1982 if (eval_flag)
|
|
1983 {
|
|
1984 backtrace_list->args = arg_vector;
|
|
1985 backtrace_list->nargs = i;
|
|
1986 }
|
|
1987 backtrace_list->evalargs = 0;
|
|
1988 tem = funcall_lambda (fun, XINT (numargs), arg_vector);
|
|
1989
|
|
1990 /* Do the debug-on-exit now, while arg_vector still exists. */
|
|
1991 if (backtrace_list->debug_on_exit)
|
|
1992 tem = call_debugger (Fcons (Qexit, Fcons (tem, Qnil)));
|
|
1993 /* Don't do it again when we return to eval. */
|
|
1994 backtrace_list->debug_on_exit = 0;
|
|
1995 return tem;
|
|
1996 }
|
|
1997
|
|
1998 /* Apply a Lisp function FUN to the NARGS evaluated arguments in ARG_VECTOR
|
|
1999 and return the result of evaluation.
|
|
2000 FUN must be either a lambda-expression or a compiled-code object. */
|
|
2001
|
|
2002 Lisp_Object
|
|
2003 funcall_lambda (fun, nargs, arg_vector)
|
|
2004 Lisp_Object fun;
|
|
2005 int nargs;
|
|
2006 register Lisp_Object *arg_vector;
|
|
2007 {
|
|
2008 Lisp_Object val, tem;
|
|
2009 register Lisp_Object syms_left;
|
|
2010 Lisp_Object numargs;
|
|
2011 register Lisp_Object next;
|
|
2012 int count = specpdl_ptr - specpdl;
|
|
2013 register int i;
|
|
2014 int optional = 0, rest = 0;
|
|
2015
|
|
2016 specbind (Qmocklisp_arguments, Qt); /* t means NOT mocklisp! */
|
|
2017
|
|
2018 XFASTINT (numargs) = nargs;
|
|
2019
|
|
2020 if (XTYPE (fun) == Lisp_Cons)
|
|
2021 syms_left = Fcar (Fcdr (fun));
|
|
2022 else if (XTYPE (fun) == Lisp_Compiled)
|
|
2023 syms_left = XVECTOR (fun)->contents[COMPILED_ARGLIST];
|
|
2024 else abort ();
|
|
2025
|
|
2026 i = 0;
|
485
|
2027 for (; !NILP (syms_left); syms_left = Fcdr (syms_left))
|
272
|
2028 {
|
|
2029 QUIT;
|
|
2030 next = Fcar (syms_left);
|
431
|
2031 while (XTYPE (next) != Lisp_Symbol)
|
|
2032 next = Fsignal (Qinvalid_function, Fcons (fun, Qnil));
|
272
|
2033 if (EQ (next, Qand_rest))
|
|
2034 rest = 1;
|
|
2035 else if (EQ (next, Qand_optional))
|
|
2036 optional = 1;
|
|
2037 else if (rest)
|
|
2038 {
|
431
|
2039 specbind (next, Flist (nargs - i, &arg_vector[i]));
|
272
|
2040 i = nargs;
|
|
2041 }
|
|
2042 else if (i < nargs)
|
|
2043 {
|
|
2044 tem = arg_vector[i++];
|
|
2045 specbind (next, tem);
|
|
2046 }
|
|
2047 else if (!optional)
|
|
2048 return Fsignal (Qwrong_number_of_arguments, Fcons (fun, Fcons (numargs, Qnil)));
|
|
2049 else
|
|
2050 specbind (next, Qnil);
|
|
2051 }
|
|
2052
|
|
2053 if (i < nargs)
|
|
2054 return Fsignal (Qwrong_number_of_arguments, Fcons (fun, Fcons (numargs, Qnil)));
|
|
2055
|
|
2056 if (XTYPE (fun) == Lisp_Cons)
|
|
2057 val = Fprogn (Fcdr (Fcdr (fun)));
|
|
2058 else
|
|
2059 val = Fbyte_code (XVECTOR (fun)->contents[COMPILED_BYTECODE],
|
|
2060 XVECTOR (fun)->contents[COMPILED_CONSTANTS],
|
|
2061 XVECTOR (fun)->contents[COMPILED_STACK_DEPTH]);
|
|
2062 return unbind_to (count, val);
|
|
2063 }
|
|
2064
|
|
2065 void
|
|
2066 grow_specpdl ()
|
|
2067 {
|
|
2068 register int count = specpdl_ptr - specpdl;
|
|
2069 if (specpdl_size >= max_specpdl_size)
|
|
2070 {
|
|
2071 if (max_specpdl_size < 400)
|
|
2072 max_specpdl_size = 400;
|
|
2073 if (specpdl_size >= max_specpdl_size)
|
|
2074 {
|
1452
|
2075 if (!NILP (Vdebug_on_error))
|
|
2076 /* Leave room for some specpdl in the debugger. */
|
|
2077 max_specpdl_size = specpdl_size + 100;
|
272
|
2078 Fsignal (Qerror,
|
|
2079 Fcons (build_string ("Variable binding depth exceeds max-specpdl-size"), Qnil));
|
|
2080 }
|
|
2081 }
|
|
2082 specpdl_size *= 2;
|
|
2083 if (specpdl_size > max_specpdl_size)
|
|
2084 specpdl_size = max_specpdl_size;
|
|
2085 specpdl = (struct specbinding *) xrealloc (specpdl, specpdl_size * sizeof (struct specbinding));
|
|
2086 specpdl_ptr = specpdl + count;
|
|
2087 }
|
|
2088
|
|
2089 void
|
|
2090 specbind (symbol, value)
|
|
2091 Lisp_Object symbol, value;
|
|
2092 {
|
|
2093 extern void store_symval_forwarding (); /* in eval.c */
|
|
2094 Lisp_Object ovalue;
|
|
2095
|
431
|
2096 CHECK_SYMBOL (symbol, 0);
|
|
2097
|
272
|
2098 if (specpdl_ptr == specpdl + specpdl_size)
|
|
2099 grow_specpdl ();
|
|
2100 specpdl_ptr->symbol = symbol;
|
|
2101 specpdl_ptr->func = 0;
|
|
2102 ovalue = XSYMBOL (symbol)->value;
|
|
2103 specpdl_ptr->old_value = EQ (ovalue, Qunbound) ? Qunbound : Fsymbol_value (symbol);
|
|
2104 specpdl_ptr++;
|
|
2105 if (XTYPE (ovalue) == Lisp_Buffer_Objfwd)
|
|
2106 store_symval_forwarding (symbol, ovalue, value);
|
|
2107 else
|
|
2108 Fset (symbol, value);
|
|
2109 }
|
|
2110
|
|
2111 void
|
|
2112 record_unwind_protect (function, arg)
|
|
2113 Lisp_Object (*function)();
|
|
2114 Lisp_Object arg;
|
|
2115 {
|
|
2116 if (specpdl_ptr == specpdl + specpdl_size)
|
|
2117 grow_specpdl ();
|
|
2118 specpdl_ptr->func = function;
|
|
2119 specpdl_ptr->symbol = Qnil;
|
|
2120 specpdl_ptr->old_value = arg;
|
|
2121 specpdl_ptr++;
|
|
2122 }
|
|
2123
|
|
2124 Lisp_Object
|
|
2125 unbind_to (count, value)
|
|
2126 int count;
|
|
2127 Lisp_Object value;
|
|
2128 {
|
485
|
2129 int quitf = !NILP (Vquit_flag);
|
272
|
2130 struct gcpro gcpro1;
|
|
2131
|
|
2132 GCPRO1 (value);
|
|
2133
|
|
2134 Vquit_flag = Qnil;
|
|
2135
|
|
2136 while (specpdl_ptr != specpdl + count)
|
|
2137 {
|
|
2138 --specpdl_ptr;
|
|
2139 if (specpdl_ptr->func != 0)
|
|
2140 (*specpdl_ptr->func) (specpdl_ptr->old_value);
|
|
2141 /* Note that a "binding" of nil is really an unwind protect,
|
|
2142 so in that case the "old value" is a list of forms to evaluate. */
|
485
|
2143 else if (NILP (specpdl_ptr->symbol))
|
272
|
2144 Fprogn (specpdl_ptr->old_value);
|
|
2145 else
|
|
2146 Fset (specpdl_ptr->symbol, specpdl_ptr->old_value);
|
|
2147 }
|
485
|
2148 if (NILP (Vquit_flag) && quitf) Vquit_flag = Qt;
|
272
|
2149
|
|
2150 UNGCPRO;
|
|
2151
|
|
2152 return value;
|
|
2153 }
|
|
2154
|
|
2155 #if 0
|
|
2156
|
|
2157 /* Get the value of symbol's global binding, even if that binding
|
|
2158 is not now dynamically visible. */
|
|
2159
|
|
2160 Lisp_Object
|
|
2161 top_level_value (symbol)
|
|
2162 Lisp_Object symbol;
|
|
2163 {
|
|
2164 register struct specbinding *ptr = specpdl;
|
|
2165
|
|
2166 CHECK_SYMBOL (symbol, 0);
|
|
2167 for (; ptr != specpdl_ptr; ptr++)
|
|
2168 {
|
|
2169 if (EQ (ptr->symbol, symbol))
|
|
2170 return ptr->old_value;
|
|
2171 }
|
|
2172 return Fsymbol_value (symbol);
|
|
2173 }
|
|
2174
|
|
2175 Lisp_Object
|
|
2176 top_level_set (symbol, newval)
|
|
2177 Lisp_Object symbol, newval;
|
|
2178 {
|
|
2179 register struct specbinding *ptr = specpdl;
|
|
2180
|
|
2181 CHECK_SYMBOL (symbol, 0);
|
|
2182 for (; ptr != specpdl_ptr; ptr++)
|
|
2183 {
|
|
2184 if (EQ (ptr->symbol, symbol))
|
|
2185 {
|
|
2186 ptr->old_value = newval;
|
|
2187 return newval;
|
|
2188 }
|
|
2189 }
|
|
2190 return Fset (symbol, newval);
|
|
2191 }
|
|
2192
|
|
2193 #endif /* 0 */
|
|
2194
|
|
2195 DEFUN ("backtrace-debug", Fbacktrace_debug, Sbacktrace_debug, 2, 2, 0,
|
|
2196 "Set the debug-on-exit flag of eval frame LEVEL levels down to FLAG.\n\
|
|
2197 The debugger is entered when that frame exits, if the flag is non-nil.")
|
|
2198 (level, flag)
|
|
2199 Lisp_Object level, flag;
|
|
2200 {
|
|
2201 register struct backtrace *backlist = backtrace_list;
|
|
2202 register int i;
|
|
2203
|
|
2204 CHECK_NUMBER (level, 0);
|
|
2205
|
|
2206 for (i = 0; backlist && i < XINT (level); i++)
|
|
2207 {
|
|
2208 backlist = backlist->next;
|
|
2209 }
|
|
2210
|
|
2211 if (backlist)
|
485
|
2212 backlist->debug_on_exit = !NILP (flag);
|
272
|
2213
|
|
2214 return flag;
|
|
2215 }
|
|
2216
|
|
2217 DEFUN ("backtrace", Fbacktrace, Sbacktrace, 0, 0, "",
|
|
2218 "Print a trace of Lisp function calls currently active.\n\
|
|
2219 Output stream used is value of `standard-output'.")
|
|
2220 ()
|
|
2221 {
|
|
2222 register struct backtrace *backlist = backtrace_list;
|
|
2223 register int i;
|
|
2224 Lisp_Object tail;
|
|
2225 Lisp_Object tem;
|
|
2226 extern Lisp_Object Vprint_level;
|
|
2227 struct gcpro gcpro1;
|
|
2228
|
|
2229 XFASTINT (Vprint_level) = 3;
|
|
2230
|
|
2231 tail = Qnil;
|
|
2232 GCPRO1 (tail);
|
|
2233
|
|
2234 while (backlist)
|
|
2235 {
|
|
2236 write_string (backlist->debug_on_exit ? "* " : " ", 2);
|
|
2237 if (backlist->nargs == UNEVALLED)
|
|
2238 {
|
|
2239 Fprin1 (Fcons (*backlist->function, *backlist->args), Qnil);
|
|
2240 }
|
|
2241 else
|
|
2242 {
|
|
2243 tem = *backlist->function;
|
|
2244 Fprin1 (tem, Qnil); /* This can QUIT */
|
|
2245 write_string ("(", -1);
|
|
2246 if (backlist->nargs == MANY)
|
|
2247 {
|
|
2248 for (tail = *backlist->args, i = 0;
|
485
|
2249 !NILP (tail);
|
272
|
2250 tail = Fcdr (tail), i++)
|
|
2251 {
|
|
2252 if (i) write_string (" ", -1);
|
|
2253 Fprin1 (Fcar (tail), Qnil);
|
|
2254 }
|
|
2255 }
|
|
2256 else
|
|
2257 {
|
|
2258 for (i = 0; i < backlist->nargs; i++)
|
|
2259 {
|
|
2260 if (i) write_string (" ", -1);
|
|
2261 Fprin1 (backlist->args[i], Qnil);
|
|
2262 }
|
|
2263 }
|
|
2264 }
|
|
2265 write_string (")\n", -1);
|
|
2266 backlist = backlist->next;
|
|
2267 }
|
|
2268
|
|
2269 Vprint_level = Qnil;
|
|
2270 UNGCPRO;
|
|
2271 return Qnil;
|
|
2272 }
|
|
2273
|
|
2274 DEFUN ("backtrace-frame", Fbacktrace_frame, Sbacktrace_frame, 1, 1, "",
|
|
2275 "Return the function and arguments N frames up from current execution point.\n\
|
|
2276 If that frame has not evaluated the arguments yet (or is a special form),\n\
|
|
2277 the value is (nil FUNCTION ARG-FORMS...).\n\
|
|
2278 If that frame has evaluated its arguments and called its function already,\n\
|
|
2279 the value is (t FUNCTION ARG-VALUES...).\n\
|
|
2280 A &rest arg is represented as the tail of the list ARG-VALUES.\n\
|
|
2281 FUNCTION is whatever was supplied as car of evaluated list,\n\
|
|
2282 or a lambda expression for macro calls.\n\
|
|
2283 If N is more than the number of frames, the value is nil.")
|
|
2284 (nframes)
|
|
2285 Lisp_Object nframes;
|
|
2286 {
|
|
2287 register struct backtrace *backlist = backtrace_list;
|
|
2288 register int i;
|
|
2289 Lisp_Object tem;
|
|
2290
|
|
2291 CHECK_NATNUM (nframes, 0);
|
|
2292
|
|
2293 /* Find the frame requested. */
|
|
2294 for (i = 0; i < XFASTINT (nframes); i++)
|
|
2295 backlist = backlist->next;
|
|
2296
|
|
2297 if (!backlist)
|
|
2298 return Qnil;
|
|
2299 if (backlist->nargs == UNEVALLED)
|
|
2300 return Fcons (Qnil, Fcons (*backlist->function, *backlist->args));
|
|
2301 else
|
|
2302 {
|
|
2303 if (backlist->nargs == MANY)
|
|
2304 tem = *backlist->args;
|
|
2305 else
|
|
2306 tem = Flist (backlist->nargs, backlist->args);
|
|
2307
|
|
2308 return Fcons (Qt, Fcons (*backlist->function, tem));
|
|
2309 }
|
|
2310 }
|
|
2311
|
|
2312 syms_of_eval ()
|
|
2313 {
|
|
2314 DEFVAR_INT ("max-specpdl-size", &max_specpdl_size,
|
|
2315 "Limit on number of Lisp variable bindings & unwind-protects before error.");
|
|
2316
|
|
2317 DEFVAR_INT ("max-lisp-eval-depth", &max_lisp_eval_depth,
|
|
2318 "Limit on depth in `eval', `apply' and `funcall' before error.\n\
|
|
2319 This limit is to catch infinite recursions for you before they cause\n\
|
|
2320 actual stack overflow in C, which would be fatal for Emacs.\n\
|
|
2321 You can safely make it considerably larger than its default value,\n\
|
|
2322 if that proves inconveniently small.");
|
|
2323
|
|
2324 DEFVAR_LISP ("quit-flag", &Vquit_flag,
|
|
2325 "Non-nil causes `eval' to abort, unless `inhibit-quit' is non-nil.\n\
|
|
2326 Typing C-G sets `quit-flag' non-nil, regardless of `inhibit-quit'.");
|
|
2327 Vquit_flag = Qnil;
|
|
2328
|
|
2329 DEFVAR_LISP ("inhibit-quit", &Vinhibit_quit,
|
|
2330 "Non-nil inhibits C-g quitting from happening immediately.\n\
|
|
2331 Note that `quit-flag' will still be set by typing C-g,\n\
|
|
2332 so a quit will be signalled as soon as `inhibit-quit' is nil.\n\
|
|
2333 To prevent this happening, set `quit-flag' to nil\n\
|
|
2334 before making `inhibit-quit' nil.");
|
|
2335 Vinhibit_quit = Qnil;
|
|
2336
|
381
|
2337 Qinhibit_quit = intern ("inhibit-quit");
|
|
2338 staticpro (&Qinhibit_quit);
|
|
2339
|
272
|
2340 Qautoload = intern ("autoload");
|
|
2341 staticpro (&Qautoload);
|
|
2342
|
|
2343 Qdebug_on_error = intern ("debug-on-error");
|
|
2344 staticpro (&Qdebug_on_error);
|
|
2345
|
|
2346 Qmacro = intern ("macro");
|
|
2347 staticpro (&Qmacro);
|
|
2348
|
|
2349 /* Note that the process handling also uses Qexit, but we don't want
|
|
2350 to staticpro it twice, so we just do it here. */
|
|
2351 Qexit = intern ("exit");
|
|
2352 staticpro (&Qexit);
|
|
2353
|
|
2354 Qinteractive = intern ("interactive");
|
|
2355 staticpro (&Qinteractive);
|
|
2356
|
|
2357 Qcommandp = intern ("commandp");
|
|
2358 staticpro (&Qcommandp);
|
|
2359
|
|
2360 Qdefun = intern ("defun");
|
|
2361 staticpro (&Qdefun);
|
|
2362
|
|
2363 Qand_rest = intern ("&rest");
|
|
2364 staticpro (&Qand_rest);
|
|
2365
|
|
2366 Qand_optional = intern ("&optional");
|
|
2367 staticpro (&Qand_optional);
|
|
2368
|
684
|
2369 DEFVAR_LISP ("stack-trace-on-error", &Vstack_trace_on_error,
|
272
|
2370 "*Non-nil means automatically display a backtrace buffer\n\
|
684
|
2371 after any error that is handled by the editor command loop.\n\
|
|
2372 If the value is a list, an error only means to display a backtrace\n\
|
|
2373 if one of its condition symbols appears in the list.");
|
|
2374 Vstack_trace_on_error = Qnil;
|
272
|
2375
|
684
|
2376 DEFVAR_LISP ("debug-on-error", &Vdebug_on_error,
|
272
|
2377 "*Non-nil means enter debugger if an error is signaled.\n\
|
|
2378 Does not apply to errors handled by `condition-case'.\n\
|
684
|
2379 If the value is a list, an error only means to enter the debugger\n\
|
|
2380 if one of its condition symbols appears in the list.\n\
|
272
|
2381 See also variable `debug-on-quit'.");
|
684
|
2382 Vdebug_on_error = Qnil;
|
272
|
2383
|
|
2384 DEFVAR_BOOL ("debug-on-quit", &debug_on_quit,
|
|
2385 "*Non-nil means enter debugger if quit is signaled (C-G, for example).\n\
|
940
|
2386 Does not apply if quit is handled by a `condition-case'.");
|
272
|
2387 debug_on_quit = 0;
|
|
2388
|
|
2389 DEFVAR_BOOL ("debug-on-next-call", &debug_on_next_call,
|
|
2390 "Non-nil means enter debugger before next `eval', `apply' or `funcall'.");
|
|
2391
|
|
2392 DEFVAR_LISP ("debugger", &Vdebugger,
|
|
2393 "Function to call to invoke debugger.\n\
|
|
2394 If due to frame exit, args are `exit' and the value being returned;\n\
|
|
2395 this function's value will be returned instead of that.\n\
|
|
2396 If due to error, args are `error' and a list of the args to `signal'.\n\
|
|
2397 If due to `apply' or `funcall' entry, one arg, `lambda'.\n\
|
|
2398 If due to `eval' entry, one arg, t.");
|
|
2399 Vdebugger = Qnil;
|
|
2400
|
|
2401 Qmocklisp_arguments = intern ("mocklisp-arguments");
|
|
2402 staticpro (&Qmocklisp_arguments);
|
|
2403 DEFVAR_LISP ("mocklisp-arguments", &Vmocklisp_arguments,
|
|
2404 "While in a mocklisp function, the list of its unevaluated args.");
|
|
2405 Vmocklisp_arguments = Qt;
|
|
2406
|
|
2407 DEFVAR_LISP ("run-hooks", &Vrun_hooks,
|
|
2408 "Set to the function `run-hooks', if that function has been defined.\n\
|
|
2409 Otherwise, nil (in a bare Emacs without preloaded Lisp code).");
|
|
2410 Vrun_hooks = Qnil;
|
|
2411
|
|
2412 staticpro (&Vautoload_queue);
|
|
2413 Vautoload_queue = Qnil;
|
|
2414
|
|
2415 defsubr (&Sor);
|
|
2416 defsubr (&Sand);
|
|
2417 defsubr (&Sif);
|
|
2418 defsubr (&Scond);
|
|
2419 defsubr (&Sprogn);
|
|
2420 defsubr (&Sprog1);
|
|
2421 defsubr (&Sprog2);
|
|
2422 defsubr (&Ssetq);
|
|
2423 defsubr (&Squote);
|
|
2424 defsubr (&Sfunction);
|
|
2425 defsubr (&Sdefun);
|
|
2426 defsubr (&Sdefmacro);
|
|
2427 defsubr (&Sdefvar);
|
|
2428 defsubr (&Sdefconst);
|
|
2429 defsubr (&Suser_variable_p);
|
|
2430 defsubr (&Slet);
|
|
2431 defsubr (&SletX);
|
|
2432 defsubr (&Swhile);
|
|
2433 defsubr (&Smacroexpand);
|
|
2434 defsubr (&Scatch);
|
|
2435 defsubr (&Sthrow);
|
|
2436 defsubr (&Sunwind_protect);
|
|
2437 defsubr (&Scondition_case);
|
|
2438 defsubr (&Ssignal);
|
|
2439 defsubr (&Sinteractive_p);
|
|
2440 defsubr (&Scommandp);
|
|
2441 defsubr (&Sautoload);
|
|
2442 defsubr (&Seval);
|
|
2443 defsubr (&Sapply);
|
|
2444 defsubr (&Sfuncall);
|
|
2445 defsubr (&Sbacktrace_debug);
|
|
2446 defsubr (&Sbacktrace);
|
|
2447 defsubr (&Sbacktrace_frame);
|
|
2448 }
|