1 /* Evaluator for GNU Emacs Lisp interpreter.
2 Copyright (C) 1985-1987, 1993-1995, 1999-2011 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
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 3 of the License, or
9 (at your option) any later version.
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.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
24 #include "blockinput.h"
27 #include "dispextern.h"
28 #include "frame.h" /* For XFRAME. */
35 # define SIZE_MAX ((size_t) -1)
38 /* This definition is duplicated in alloc.c and keyboard.c. */
39 /* Putting it in lisp.h makes cc bomb out! */
43 struct backtrace
*next
;
44 Lisp_Object
*function
;
45 Lisp_Object
*args
; /* Points to vector of args. */
46 #define NARGS_BITS (BITS_PER_INT - 2)
47 /* Let's not use size_t because we want to allow negative values (for
48 UNEVALLED). Also let's steal 2 bits so we save a word (or more for
49 alignment). In any case I doubt Emacs would survive a function call with
50 more than 500M arguments. */
51 int nargs
: NARGS_BITS
; /* Length of vector.
52 If nargs is UNEVALLED, args points
53 to slot holding list of unevalled args. */
55 /* Nonzero means call value of debugger when done with this operation. */
56 char debug_on_exit
: 1;
59 struct backtrace
*backtrace_list
;
60 struct catchtag
*catchlist
;
63 /* Count levels of GCPRO to detect failure to UNGCPRO. */
67 Lisp_Object Qautoload
, Qmacro
, Qexit
, Qinteractive
, Qcommandp
, Qdefun
;
68 Lisp_Object Qinhibit_quit
;
69 Lisp_Object Qand_rest
;
70 static Lisp_Object Qand_optional
;
71 static Lisp_Object Qdebug_on_error
;
72 static Lisp_Object Qdeclare
;
73 Lisp_Object Qinternal_interpreter_environment
, Qclosure
;
75 static Lisp_Object Qdebug
;
77 /* This holds either the symbol `run-hooks' or nil.
78 It is nil at an early stage of startup, and when Emacs
81 Lisp_Object Vrun_hooks
;
83 /* Non-nil means record all fset's and provide's, to be undone
84 if the file being autoloaded is not fully loaded.
85 They are recorded by being consed onto the front of Vautoload_queue:
86 (FUN . ODEF) for a defun, (0 . OFEATURES) for a provide. */
88 Lisp_Object Vautoload_queue
;
90 /* Current number of specbindings allocated in specpdl. */
92 EMACS_INT specpdl_size
;
94 /* Pointer to beginning of specpdl. */
96 struct specbinding
*specpdl
;
98 /* Pointer to first unused element in specpdl. */
100 struct specbinding
*specpdl_ptr
;
102 /* Depth in Lisp evaluations and function calls. */
104 EMACS_INT lisp_eval_depth
;
106 /* The value of num_nonmacro_input_events as of the last time we
107 started to enter the debugger. If we decide to enter the debugger
108 again when this is still equal to num_nonmacro_input_events, then we
109 know that the debugger itself has an error, and we should just
110 signal the error instead of entering an infinite loop of debugger
113 int when_entered_debugger
;
115 /* The function from which the last `signal' was called. Set in
118 Lisp_Object Vsignaling_function
;
120 /* Set to non-zero while processing X events. Checked in Feval to
121 make sure the Lisp interpreter isn't called from a signal handler,
122 which is unsafe because the interpreter isn't reentrant. */
126 static Lisp_Object
funcall_lambda (Lisp_Object
, size_t, Lisp_Object
*);
127 static void unwind_to_catch (struct catchtag
*, Lisp_Object
) NO_RETURN
;
128 static int interactive_p (int);
129 static Lisp_Object
apply_lambda (Lisp_Object fun
, Lisp_Object args
);
130 INFUN (Ffetch_bytecode
, 1);
133 init_eval_once (void)
136 specpdl
= (struct specbinding
*) xmalloc (specpdl_size
* sizeof (struct specbinding
));
137 specpdl_ptr
= specpdl
;
138 /* Don't forget to update docs (lispref node "Local Variables"). */
139 max_specpdl_size
= 1300; /* 1000 is not enough for CEDET's c-by.el. */
140 max_lisp_eval_depth
= 600;
148 specpdl_ptr
= specpdl
;
153 debug_on_next_call
= 0;
158 /* This is less than the initial value of num_nonmacro_input_events. */
159 when_entered_debugger
= -1;
162 /* Unwind-protect function used by call_debugger. */
165 restore_stack_limits (Lisp_Object data
)
167 max_specpdl_size
= XINT (XCAR (data
));
168 max_lisp_eval_depth
= XINT (XCDR (data
));
172 /* Call the Lisp debugger, giving it argument ARG. */
175 call_debugger (Lisp_Object arg
)
177 int debug_while_redisplaying
;
178 int count
= SPECPDL_INDEX ();
180 EMACS_INT old_max
= max_specpdl_size
;
182 /* Temporarily bump up the stack limits,
183 so the debugger won't run out of stack. */
185 max_specpdl_size
+= 1;
186 record_unwind_protect (restore_stack_limits
,
187 Fcons (make_number (old_max
),
188 make_number (max_lisp_eval_depth
)));
189 max_specpdl_size
= old_max
;
191 if (lisp_eval_depth
+ 40 > max_lisp_eval_depth
)
192 max_lisp_eval_depth
= lisp_eval_depth
+ 40;
194 if (SPECPDL_INDEX () + 100 > max_specpdl_size
)
195 max_specpdl_size
= SPECPDL_INDEX () + 100;
197 #ifdef HAVE_WINDOW_SYSTEM
198 if (display_hourglass_p
)
202 debug_on_next_call
= 0;
203 when_entered_debugger
= num_nonmacro_input_events
;
205 /* Resetting redisplaying_p to 0 makes sure that debug output is
206 displayed if the debugger is invoked during redisplay. */
207 debug_while_redisplaying
= redisplaying_p
;
209 specbind (intern ("debugger-may-continue"),
210 debug_while_redisplaying
? Qnil
: Qt
);
211 specbind (Qinhibit_redisplay
, Qnil
);
212 specbind (Qdebug_on_error
, Qnil
);
214 #if 0 /* Binding this prevents execution of Lisp code during
215 redisplay, which necessarily leads to display problems. */
216 specbind (Qinhibit_eval_during_redisplay
, Qt
);
219 val
= apply1 (Vdebugger
, arg
);
221 /* Interrupting redisplay and resuming it later is not safe under
222 all circumstances. So, when the debugger returns, abort the
223 interrupted redisplay by going back to the top-level. */
224 if (debug_while_redisplaying
)
227 return unbind_to (count
, val
);
231 do_debug_on_call (Lisp_Object code
)
233 debug_on_next_call
= 0;
234 backtrace_list
->debug_on_exit
= 1;
235 call_debugger (Fcons (code
, Qnil
));
238 /* NOTE!!! Every function that can call EVAL must protect its args
239 and temporaries from garbage collection while it needs them.
240 The definition of `For' shows what you have to do. */
242 DEFUN ("or", For
, Sor
, 0, UNEVALLED
, 0,
243 doc
: /* Eval args until one of them yields non-nil, then return that value.
244 The remaining args are not evalled at all.
245 If all args return nil, return nil.
246 usage: (or CONDITIONS...) */)
249 register Lisp_Object val
= Qnil
;
256 val
= eval_sub (XCAR (args
));
266 DEFUN ("and", Fand
, Sand
, 0, UNEVALLED
, 0,
267 doc
: /* Eval args until one of them yields nil, then return nil.
268 The remaining args are not evalled at all.
269 If no arg yields nil, return the last arg's value.
270 usage: (and CONDITIONS...) */)
273 register Lisp_Object val
= Qt
;
280 val
= eval_sub (XCAR (args
));
290 DEFUN ("if", Fif
, Sif
, 2, UNEVALLED
, 0,
291 doc
: /* If COND yields non-nil, do THEN, else do ELSE...
292 Returns the value of THEN or the value of the last of the ELSE's.
293 THEN must be one expression, but ELSE... can be zero or more expressions.
294 If COND yields nil, and there are no ELSE's, the value is nil.
295 usage: (if COND THEN ELSE...) */)
298 register Lisp_Object cond
;
302 cond
= eval_sub (Fcar (args
));
306 return eval_sub (Fcar (Fcdr (args
)));
307 return Fprogn (Fcdr (Fcdr (args
)));
310 DEFUN ("cond", Fcond
, Scond
, 0, UNEVALLED
, 0,
311 doc
: /* Try each clause until one succeeds.
312 Each clause looks like (CONDITION BODY...). CONDITION is evaluated
313 and, if the value is non-nil, this clause succeeds:
314 then the expressions in BODY are evaluated and the last one's
315 value is the value of the cond-form.
316 If no clause succeeds, cond returns nil.
317 If a clause has one element, as in (CONDITION),
318 CONDITION's value if non-nil is returned from the cond-form.
319 usage: (cond CLAUSES...) */)
322 register Lisp_Object clause
, val
;
329 clause
= Fcar (args
);
330 val
= eval_sub (Fcar (clause
));
333 if (!EQ (XCDR (clause
), Qnil
))
334 val
= Fprogn (XCDR (clause
));
344 DEFUE ("progn", Fprogn
, Sprogn
, 0, UNEVALLED
, 0,
345 doc
: /* Eval BODY forms sequentially and return value of last one.
346 usage: (progn BODY...) */)
349 register Lisp_Object val
= Qnil
;
356 val
= eval_sub (XCAR (args
));
364 DEFUN ("prog1", Fprog1
, Sprog1
, 1, UNEVALLED
, 0,
365 doc
: /* Eval FIRST and BODY sequentially; return value from FIRST.
366 The value of FIRST is saved during the evaluation of the remaining args,
367 whose values are discarded.
368 usage: (prog1 FIRST BODY...) */)
372 register Lisp_Object args_left
;
373 struct gcpro gcpro1
, gcpro2
;
374 register int argnum
= 0;
385 Lisp_Object tem
= eval_sub (XCAR (args_left
));
388 args_left
= XCDR (args_left
);
390 while (CONSP (args_left
));
396 DEFUN ("prog2", Fprog2
, Sprog2
, 2, UNEVALLED
, 0,
397 doc
: /* Eval FORM1, FORM2 and BODY sequentially; return value from FORM2.
398 The value of FORM2 is saved during the evaluation of the
399 remaining args, whose values are discarded.
400 usage: (prog2 FORM1 FORM2 BODY...) */)
404 register Lisp_Object args_left
;
405 struct gcpro gcpro1
, gcpro2
;
406 register int argnum
= -1;
419 Lisp_Object tem
= eval_sub (XCAR (args_left
));
422 args_left
= XCDR (args_left
);
424 while (CONSP (args_left
));
430 DEFUN ("setq", Fsetq
, Ssetq
, 0, UNEVALLED
, 0,
431 doc
: /* Set each SYM to the value of its VAL.
432 The symbols SYM are variables; they are literal (not evaluated).
433 The values VAL are expressions; they are evaluated.
434 Thus, (setq x (1+ y)) sets `x' to the value of `(1+ y)'.
435 The second VAL is not computed until after the first SYM is set, and so on;
436 each VAL can use the new value of variables set earlier in the `setq'.
437 The return value of the `setq' form is the value of the last VAL.
438 usage: (setq [SYM VAL]...) */)
441 register Lisp_Object args_left
;
442 register Lisp_Object val
, sym
, lex_binding
;
453 val
= eval_sub (Fcar (Fcdr (args_left
)));
454 sym
= Fcar (args_left
);
456 /* Like for eval_sub, we do not check declared_special here since
457 it's been done when let-binding. */
458 if (!NILP (Vinternal_interpreter_environment
) /* Mere optimization! */
460 && !NILP (lex_binding
461 = Fassq (sym
, Vinternal_interpreter_environment
)))
462 XSETCDR (lex_binding
, val
); /* SYM is lexically bound. */
464 Fset (sym
, val
); /* SYM is dynamically bound. */
466 args_left
= Fcdr (Fcdr (args_left
));
468 while (!NILP(args_left
));
474 DEFUN ("quote", Fquote
, Squote
, 1, UNEVALLED
, 0,
475 doc
: /* Return the argument, without evaluating it. `(quote x)' yields `x'.
476 usage: (quote ARG) */)
479 if (!NILP (Fcdr (args
)))
480 xsignal2 (Qwrong_number_of_arguments
, Qquote
, Flength (args
));
484 DEFUN ("function", Ffunction
, Sfunction
, 1, UNEVALLED
, 0,
485 doc
: /* Like `quote', but preferred for objects which are functions.
486 In byte compilation, `function' causes its argument to be compiled.
487 `quote' cannot do that.
488 usage: (function ARG) */)
491 Lisp_Object quoted
= XCAR (args
);
493 if (!NILP (Fcdr (args
)))
494 xsignal2 (Qwrong_number_of_arguments
, Qfunction
, Flength (args
));
496 if (!NILP (Vinternal_interpreter_environment
)
498 && EQ (XCAR (quoted
), Qlambda
))
499 /* This is a lambda expression within a lexical environment;
500 return an interpreted closure instead of a simple lambda. */
501 return Fcons (Qclosure
, Fcons (Vinternal_interpreter_environment
,
504 /* Simply quote the argument. */
509 DEFUE ("interactive-p", Finteractive_p
, Sinteractive_p
, 0, 0, 0,
510 doc
: /* Return t if the containing function was run directly by user input.
511 This means that the function was called with `call-interactively'
512 \(which includes being called as the binding of a key)
513 and input is currently coming from the keyboard (not a keyboard macro),
514 and Emacs is not running in batch mode (`noninteractive' is nil).
516 The only known proper use of `interactive-p' is in deciding whether to
517 display a helpful message, or how to display it. If you're thinking
518 of using it for any other purpose, it is quite likely that you're
519 making a mistake. Think: what do you want to do when the command is
520 called from a keyboard macro?
522 To test whether your function was called with `call-interactively',
523 either (i) add an extra optional argument and give it an `interactive'
524 spec that specifies non-nil unconditionally (such as \"p\"); or (ii)
525 use `called-interactively-p'. */)
528 return interactive_p (1) ? Qt
: Qnil
;
532 DEFUN ("called-interactively-p", Fcalled_interactively_p
, Scalled_interactively_p
, 0, 1, 0,
533 doc
: /* Return t if the containing function was called by `call-interactively'.
534 If KIND is `interactive', then only return t if the call was made
535 interactively by the user, i.e. not in `noninteractive' mode nor
536 when `executing-kbd-macro'.
537 If KIND is `any', on the other hand, it will return t for any kind of
538 interactive call, including being called as the binding of a key, or
539 from a keyboard macro, or in `noninteractive' mode.
541 The only known proper use of `interactive' for KIND is in deciding
542 whether to display a helpful message, or how to display it. If you're
543 thinking of using it for any other purpose, it is quite likely that
544 you're making a mistake. Think: what do you want to do when the
545 command is called from a keyboard macro?
547 This function is meant for implementing advice and other
548 function-modifying features. Instead of using this, it is sometimes
549 cleaner to give your function an extra optional argument whose
550 `interactive' spec specifies non-nil unconditionally (\"p\" is a good
551 way to do this), or via (not (or executing-kbd-macro noninteractive)). */)
554 return ((INTERACTIVE
|| !EQ (kind
, intern ("interactive")))
555 && interactive_p (1)) ? Qt
: Qnil
;
559 /* Return 1 if function in which this appears was called using
562 EXCLUDE_SUBRS_P non-zero means always return 0 if the function
563 called is a built-in. */
566 interactive_p (int exclude_subrs_p
)
568 struct backtrace
*btp
;
571 btp
= backtrace_list
;
573 /* If this isn't a byte-compiled function, there may be a frame at
574 the top for Finteractive_p. If so, skip it. */
575 fun
= Findirect_function (*btp
->function
, Qnil
);
576 if (SUBRP (fun
) && (XSUBR (fun
) == &Sinteractive_p
577 || XSUBR (fun
) == &Scalled_interactively_p
))
580 /* If we're running an Emacs 18-style byte-compiled function, there
581 may be a frame for Fbytecode at the top level. In any version of
582 Emacs there can be Fbytecode frames for subexpressions evaluated
583 inside catch and condition-case. Skip past them.
585 If this isn't a byte-compiled function, then we may now be
586 looking at several frames for special forms. Skip past them. */
588 && (EQ (*btp
->function
, Qbytecode
)
589 || btp
->nargs
== UNEVALLED
))
592 /* `btp' now points at the frame of the innermost function that isn't
593 a special form, ignoring frames for Finteractive_p and/or
594 Fbytecode at the top. If this frame is for a built-in function
595 (such as load or eval-region) return nil. */
596 fun
= Findirect_function (*btp
->function
, Qnil
);
597 if (exclude_subrs_p
&& SUBRP (fun
))
600 /* `btp' points to the frame of a Lisp function that called interactive-p.
601 Return t if that function was called interactively. */
602 if (btp
&& btp
->next
&& EQ (*btp
->next
->function
, Qcall_interactively
))
608 DEFUN ("defun", Fdefun
, Sdefun
, 2, UNEVALLED
, 0,
609 doc
: /* Define NAME as a function.
610 The definition is (lambda ARGLIST [DOCSTRING] BODY...).
611 See also the function `interactive'.
612 usage: (defun NAME ARGLIST [DOCSTRING] BODY...) */)
615 register Lisp_Object fn_name
;
616 register Lisp_Object defn
;
618 fn_name
= Fcar (args
);
619 CHECK_SYMBOL (fn_name
);
620 defn
= Fcons (Qlambda
, Fcdr (args
));
621 if (!NILP (Vinternal_interpreter_environment
)) /* Mere optimization! */
622 defn
= Ffunction (Fcons (defn
, Qnil
));
623 if (!NILP (Vpurify_flag
))
624 defn
= Fpurecopy (defn
);
625 if (CONSP (XSYMBOL (fn_name
)->function
)
626 && EQ (XCAR (XSYMBOL (fn_name
)->function
), Qautoload
))
627 LOADHIST_ATTACH (Fcons (Qt
, fn_name
));
628 Ffset (fn_name
, defn
);
629 LOADHIST_ATTACH (Fcons (Qdefun
, fn_name
));
633 DEFUN ("defmacro", Fdefmacro
, Sdefmacro
, 2, UNEVALLED
, 0,
634 doc
: /* Define NAME as a macro.
635 The actual definition looks like
636 (macro lambda ARGLIST [DOCSTRING] [DECL] BODY...).
637 When the macro is called, as in (NAME ARGS...),
638 the function (lambda ARGLIST BODY...) is applied to
639 the list ARGS... as it appears in the expression,
640 and the result should be a form to be evaluated instead of the original.
642 DECL is a declaration, optional, which can specify how to indent
643 calls to this macro, how Edebug should handle it, and which argument
644 should be treated as documentation. It looks like this:
646 The elements can look like this:
648 Set NAME's `lisp-indent-function' property to INDENT.
651 Set NAME's `edebug-form-spec' property to DEBUG. (This is
652 equivalent to writing a `def-edebug-spec' for the macro.)
655 Set NAME's `doc-string-elt' property to ELT.
657 usage: (defmacro NAME ARGLIST [DOCSTRING] [DECL] BODY...) */)
660 register Lisp_Object fn_name
;
661 register Lisp_Object defn
;
662 Lisp_Object lambda_list
, doc
, tail
;
664 fn_name
= Fcar (args
);
665 CHECK_SYMBOL (fn_name
);
666 lambda_list
= Fcar (Fcdr (args
));
667 tail
= Fcdr (Fcdr (args
));
670 if (STRINGP (Fcar (tail
)))
676 if (CONSP (Fcar (tail
))
677 && EQ (Fcar (Fcar (tail
)), Qdeclare
))
679 if (!NILP (Vmacro_declaration_function
))
683 call2 (Vmacro_declaration_function
, fn_name
, Fcar (tail
));
691 tail
= Fcons (lambda_list
, tail
);
693 tail
= Fcons (lambda_list
, Fcons (doc
, tail
));
695 defn
= Fcons (Qlambda
, tail
);
696 if (!NILP (Vinternal_interpreter_environment
)) /* Mere optimization! */
697 defn
= Ffunction (Fcons (defn
, Qnil
));
698 defn
= Fcons (Qmacro
, defn
);
700 if (!NILP (Vpurify_flag
))
701 defn
= Fpurecopy (defn
);
702 if (CONSP (XSYMBOL (fn_name
)->function
)
703 && EQ (XCAR (XSYMBOL (fn_name
)->function
), Qautoload
))
704 LOADHIST_ATTACH (Fcons (Qt
, fn_name
));
705 Ffset (fn_name
, defn
);
706 LOADHIST_ATTACH (Fcons (Qdefun
, fn_name
));
711 DEFUN ("defvaralias", Fdefvaralias
, Sdefvaralias
, 2, 3, 0,
712 doc
: /* Make NEW-ALIAS a variable alias for symbol BASE-VARIABLE.
713 Aliased variables always have the same value; setting one sets the other.
714 Third arg DOCSTRING, if non-nil, is documentation for NEW-ALIAS. If it is
715 omitted or nil, NEW-ALIAS gets the documentation string of BASE-VARIABLE,
716 or of the variable at the end of the chain of aliases, if BASE-VARIABLE is
717 itself an alias. If NEW-ALIAS is bound, and BASE-VARIABLE is not,
718 then the value of BASE-VARIABLE is set to that of NEW-ALIAS.
719 The return value is BASE-VARIABLE. */)
720 (Lisp_Object new_alias
, Lisp_Object base_variable
, Lisp_Object docstring
)
722 struct Lisp_Symbol
*sym
;
724 CHECK_SYMBOL (new_alias
);
725 CHECK_SYMBOL (base_variable
);
727 sym
= XSYMBOL (new_alias
);
730 /* Not sure why, but why not? */
731 error ("Cannot make a constant an alias");
733 switch (sym
->redirect
)
735 case SYMBOL_FORWARDED
:
736 error ("Cannot make an internal variable an alias");
737 case SYMBOL_LOCALIZED
:
738 error ("Don't know how to make a localized variable an alias");
741 /* http://lists.gnu.org/archive/html/emacs-devel/2008-04/msg00834.html
742 If n_a is bound, but b_v is not, set the value of b_v to n_a,
743 so that old-code that affects n_a before the aliasing is setup
745 if (NILP (Fboundp (base_variable
)))
746 set_internal (base_variable
, find_symbol_value (new_alias
), Qnil
, 1);
749 struct specbinding
*p
;
751 for (p
= specpdl_ptr
- 1; p
>= specpdl
; p
--)
754 CONSP (p
->symbol
) ? XCAR (p
->symbol
) : p
->symbol
)))
755 error ("Don't know how to make a let-bound variable an alias");
758 sym
->declared_special
= 1;
759 sym
->redirect
= SYMBOL_VARALIAS
;
760 SET_SYMBOL_ALIAS (sym
, XSYMBOL (base_variable
));
761 sym
->constant
= SYMBOL_CONSTANT_P (base_variable
);
762 LOADHIST_ATTACH (new_alias
);
763 /* Even if docstring is nil: remove old docstring. */
764 Fput (new_alias
, Qvariable_documentation
, docstring
);
766 return base_variable
;
770 DEFUN ("defvar", Fdefvar
, Sdefvar
, 1, UNEVALLED
, 0,
771 doc
: /* Define SYMBOL as a variable, and return SYMBOL.
772 You are not required to define a variable in order to use it,
773 but the definition can supply documentation and an initial value
774 in a way that tags can recognize.
776 INITVALUE is evaluated, and used to set SYMBOL, only if SYMBOL's value is void.
777 If SYMBOL is buffer-local, its default value is what is set;
778 buffer-local values are not affected.
779 INITVALUE and DOCSTRING are optional.
780 If DOCSTRING starts with *, this variable is identified as a user option.
781 This means that M-x set-variable recognizes it.
782 See also `user-variable-p'.
783 If INITVALUE is missing, SYMBOL's value is not set.
785 If SYMBOL has a local binding, then this form affects the local
786 binding. This is usually not what you want. Thus, if you need to
787 load a file defining variables, with this form or with `defconst' or
788 `defcustom', you should always load that file _outside_ any bindings
789 for these variables. \(`defconst' and `defcustom' behave similarly in
791 usage: (defvar SYMBOL &optional INITVALUE DOCSTRING) */)
794 register Lisp_Object sym
, tem
, tail
;
798 if (!NILP (Fcdr (Fcdr (tail
))))
799 error ("Too many arguments");
801 tem
= Fdefault_boundp (sym
);
804 /* Do it before evaluating the initial value, for self-references. */
805 XSYMBOL (sym
)->declared_special
= 1;
807 if (SYMBOL_CONSTANT_P (sym
))
809 /* For upward compatibility, allow (defvar :foo (quote :foo)). */
810 Lisp_Object tem1
= Fcar (tail
);
812 && EQ (XCAR (tem1
), Qquote
)
813 && CONSP (XCDR (tem1
))
814 && EQ (XCAR (XCDR (tem1
)), sym
)))
815 error ("Constant symbol `%s' specified in defvar",
816 SDATA (SYMBOL_NAME (sym
)));
820 Fset_default (sym
, eval_sub (Fcar (tail
)));
822 { /* Check if there is really a global binding rather than just a let
823 binding that shadows the global unboundness of the var. */
824 volatile struct specbinding
*pdl
= specpdl_ptr
;
825 while (--pdl
>= specpdl
)
827 if (EQ (pdl
->symbol
, sym
) && !pdl
->func
828 && EQ (pdl
->old_value
, Qunbound
))
830 message_with_string ("Warning: defvar ignored because %s is let-bound",
831 SYMBOL_NAME (sym
), 1);
840 if (!NILP (Vpurify_flag
))
841 tem
= Fpurecopy (tem
);
842 Fput (sym
, Qvariable_documentation
, tem
);
844 LOADHIST_ATTACH (sym
);
846 else if (!NILP (Vinternal_interpreter_environment
)
847 && !XSYMBOL (sym
)->declared_special
)
848 /* A simple (defvar foo) with lexical scoping does "nothing" except
849 declare that var to be dynamically scoped *locally* (i.e. within
850 the current file or let-block). */
851 Vinternal_interpreter_environment
=
852 Fcons (sym
, Vinternal_interpreter_environment
);
855 /* Simple (defvar <var>) should not count as a definition at all.
856 It could get in the way of other definitions, and unloading this
857 package could try to make the variable unbound. */
863 DEFUN ("defconst", Fdefconst
, Sdefconst
, 2, UNEVALLED
, 0,
864 doc
: /* Define SYMBOL as a constant variable.
865 The intent is that neither programs nor users should ever change this value.
866 Always sets the value of SYMBOL to the result of evalling INITVALUE.
867 If SYMBOL is buffer-local, its default value is what is set;
868 buffer-local values are not affected.
869 DOCSTRING is optional.
871 If SYMBOL has a local binding, then this form sets the local binding's
872 value. However, you should normally not make local bindings for
873 variables defined with this form.
874 usage: (defconst SYMBOL INITVALUE [DOCSTRING]) */)
877 register Lisp_Object sym
, tem
;
880 if (!NILP (Fcdr (Fcdr (Fcdr (args
)))))
881 error ("Too many arguments");
883 tem
= eval_sub (Fcar (Fcdr (args
)));
884 if (!NILP (Vpurify_flag
))
885 tem
= Fpurecopy (tem
);
886 Fset_default (sym
, tem
);
887 XSYMBOL (sym
)->declared_special
= 1;
888 tem
= Fcar (Fcdr (Fcdr (args
)));
891 if (!NILP (Vpurify_flag
))
892 tem
= Fpurecopy (tem
);
893 Fput (sym
, Qvariable_documentation
, tem
);
895 Fput (sym
, Qrisky_local_variable
, Qt
);
896 LOADHIST_ATTACH (sym
);
900 /* Error handler used in Fuser_variable_p. */
902 user_variable_p_eh (Lisp_Object ignore
)
908 lisp_indirect_variable (Lisp_Object sym
)
910 struct Lisp_Symbol
*s
= indirect_variable (XSYMBOL (sym
));
915 DEFUN ("user-variable-p", Fuser_variable_p
, Suser_variable_p
, 1, 1, 0,
916 doc
: /* Return t if VARIABLE is intended to be set and modified by users.
917 \(The alternative is a variable used internally in a Lisp program.)
918 A variable is a user variable if
919 \(1) the first character of its documentation is `*', or
920 \(2) it is customizable (its property list contains a non-nil value
921 of `standard-value' or `custom-autoload'), or
922 \(3) it is an alias for another user variable.
923 Return nil if VARIABLE is an alias and there is a loop in the
924 chain of symbols. */)
925 (Lisp_Object variable
)
927 Lisp_Object documentation
;
929 if (!SYMBOLP (variable
))
932 /* If indirect and there's an alias loop, don't check anything else. */
933 if (XSYMBOL (variable
)->redirect
== SYMBOL_VARALIAS
934 && NILP (internal_condition_case_1 (lisp_indirect_variable
, variable
,
935 Qt
, user_variable_p_eh
)))
940 documentation
= Fget (variable
, Qvariable_documentation
);
941 if (INTEGERP (documentation
) && XINT (documentation
) < 0)
943 if (STRINGP (documentation
)
944 && ((unsigned char) SREF (documentation
, 0) == '*'))
946 /* If it is (STRING . INTEGER), a negative integer means a user variable. */
947 if (CONSP (documentation
)
948 && STRINGP (XCAR (documentation
))
949 && INTEGERP (XCDR (documentation
))
950 && XINT (XCDR (documentation
)) < 0)
952 /* Customizable? See `custom-variable-p'. */
953 if ((!NILP (Fget (variable
, intern ("standard-value"))))
954 || (!NILP (Fget (variable
, intern ("custom-autoload")))))
957 if (!(XSYMBOL (variable
)->redirect
== SYMBOL_VARALIAS
))
960 /* An indirect variable? Let's follow the chain. */
961 XSETSYMBOL (variable
, SYMBOL_ALIAS (XSYMBOL (variable
)));
965 DEFUN ("let*", FletX
, SletX
, 1, UNEVALLED
, 0,
966 doc
: /* Bind variables according to VARLIST then eval BODY.
967 The value of the last form in BODY is returned.
968 Each element of VARLIST is a symbol (which is bound to nil)
969 or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
970 Each VALUEFORM can refer to the symbols already bound by this VARLIST.
971 usage: (let* VARLIST BODY...) */)
974 Lisp_Object varlist
, var
, val
, elt
, lexenv
;
975 int count
= SPECPDL_INDEX ();
976 struct gcpro gcpro1
, gcpro2
, gcpro3
;
978 GCPRO3 (args
, elt
, varlist
);
980 lexenv
= Vinternal_interpreter_environment
;
982 varlist
= Fcar (args
);
983 while (CONSP (varlist
))
987 elt
= XCAR (varlist
);
993 else if (! NILP (Fcdr (Fcdr (elt
))))
994 signal_error ("`let' bindings can have only one value-form", elt
);
998 val
= eval_sub (Fcar (Fcdr (elt
)));
1001 if (!NILP (lexenv
) && SYMBOLP (var
)
1002 && !XSYMBOL (var
)->declared_special
1003 && NILP (Fmemq (var
, Vinternal_interpreter_environment
)))
1004 /* Lexically bind VAR by adding it to the interpreter's binding
1008 = Fcons (Fcons (var
, val
), Vinternal_interpreter_environment
);
1009 if (EQ (Vinternal_interpreter_environment
, lexenv
))
1010 /* Save the old lexical environment on the specpdl stack,
1011 but only for the first lexical binding, since we'll never
1012 need to revert to one of the intermediate ones. */
1013 specbind (Qinternal_interpreter_environment
, newenv
);
1015 Vinternal_interpreter_environment
= newenv
;
1018 specbind (var
, val
);
1020 varlist
= XCDR (varlist
);
1023 val
= Fprogn (Fcdr (args
));
1024 return unbind_to (count
, val
);
1027 DEFUN ("let", Flet
, Slet
, 1, UNEVALLED
, 0,
1028 doc
: /* Bind variables according to VARLIST then eval BODY.
1029 The value of the last form in BODY is returned.
1030 Each element of VARLIST is a symbol (which is bound to nil)
1031 or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
1032 All the VALUEFORMs are evalled before any symbols are bound.
1033 usage: (let VARLIST BODY...) */)
1036 Lisp_Object
*temps
, tem
, lexenv
;
1037 register Lisp_Object elt
, varlist
;
1038 int count
= SPECPDL_INDEX ();
1039 register size_t argnum
;
1040 struct gcpro gcpro1
, gcpro2
;
1043 varlist
= Fcar (args
);
1045 /* Make space to hold the values to give the bound variables. */
1046 elt
= Flength (varlist
);
1047 SAFE_ALLOCA_LISP (temps
, XFASTINT (elt
));
1049 /* Compute the values and store them in `temps'. */
1051 GCPRO2 (args
, *temps
);
1054 for (argnum
= 0; CONSP (varlist
); varlist
= XCDR (varlist
))
1057 elt
= XCAR (varlist
);
1059 temps
[argnum
++] = Qnil
;
1060 else if (! NILP (Fcdr (Fcdr (elt
))))
1061 signal_error ("`let' bindings can have only one value-form", elt
);
1063 temps
[argnum
++] = eval_sub (Fcar (Fcdr (elt
)));
1064 gcpro2
.nvars
= argnum
;
1068 lexenv
= Vinternal_interpreter_environment
;
1070 varlist
= Fcar (args
);
1071 for (argnum
= 0; CONSP (varlist
); varlist
= XCDR (varlist
))
1075 elt
= XCAR (varlist
);
1076 var
= SYMBOLP (elt
) ? elt
: Fcar (elt
);
1077 tem
= temps
[argnum
++];
1079 if (!NILP (lexenv
) && SYMBOLP (var
)
1080 && !XSYMBOL (var
)->declared_special
1081 && NILP (Fmemq (var
, Vinternal_interpreter_environment
)))
1082 /* Lexically bind VAR by adding it to the lexenv alist. */
1083 lexenv
= Fcons (Fcons (var
, tem
), lexenv
);
1085 /* Dynamically bind VAR. */
1086 specbind (var
, tem
);
1089 if (!EQ (lexenv
, Vinternal_interpreter_environment
))
1090 /* Instantiate a new lexical environment. */
1091 specbind (Qinternal_interpreter_environment
, lexenv
);
1093 elt
= Fprogn (Fcdr (args
));
1095 return unbind_to (count
, elt
);
1098 DEFUN ("while", Fwhile
, Swhile
, 1, UNEVALLED
, 0,
1099 doc
: /* If TEST yields non-nil, eval BODY... and repeat.
1100 The order of execution is thus TEST, BODY, TEST, BODY and so on
1101 until TEST returns nil.
1102 usage: (while TEST BODY...) */)
1105 Lisp_Object test
, body
;
1106 struct gcpro gcpro1
, gcpro2
;
1108 GCPRO2 (test
, body
);
1112 while (!NILP (eval_sub (test
)))
1122 DEFUN ("macroexpand", Fmacroexpand
, Smacroexpand
, 1, 2, 0,
1123 doc
: /* Return result of expanding macros at top level of FORM.
1124 If FORM is not a macro call, it is returned unchanged.
1125 Otherwise, the macro is expanded and the expansion is considered
1126 in place of FORM. When a non-macro-call results, it is returned.
1128 The second optional arg ENVIRONMENT specifies an environment of macro
1129 definitions to shadow the loaded ones for use in file byte-compilation. */)
1130 (Lisp_Object form
, Lisp_Object environment
)
1132 /* With cleanups from Hallvard Furuseth. */
1133 register Lisp_Object expander
, sym
, def
, tem
;
1137 /* Come back here each time we expand a macro call,
1138 in case it expands into another macro call. */
1141 /* Set SYM, give DEF and TEM right values in case SYM is not a symbol. */
1142 def
= sym
= XCAR (form
);
1144 /* Trace symbols aliases to other symbols
1145 until we get a symbol that is not an alias. */
1146 while (SYMBOLP (def
))
1150 tem
= Fassq (sym
, environment
);
1153 def
= XSYMBOL (sym
)->function
;
1154 if (!EQ (def
, Qunbound
))
1159 /* Right now TEM is the result from SYM in ENVIRONMENT,
1160 and if TEM is nil then DEF is SYM's function definition. */
1163 /* SYM is not mentioned in ENVIRONMENT.
1164 Look at its function definition. */
1165 if (EQ (def
, Qunbound
) || !CONSP (def
))
1166 /* Not defined or definition not suitable. */
1168 if (EQ (XCAR (def
), Qautoload
))
1170 /* Autoloading function: will it be a macro when loaded? */
1171 tem
= Fnth (make_number (4), def
);
1172 if (EQ (tem
, Qt
) || EQ (tem
, Qmacro
))
1173 /* Yes, load it and try again. */
1175 struct gcpro gcpro1
;
1177 do_autoload (def
, sym
);
1184 else if (!EQ (XCAR (def
), Qmacro
))
1186 else expander
= XCDR (def
);
1190 expander
= XCDR (tem
);
1191 if (NILP (expander
))
1194 form
= apply1 (expander
, XCDR (form
));
1199 DEFUN ("catch", Fcatch
, Scatch
, 1, UNEVALLED
, 0,
1200 doc
: /* Eval BODY allowing nonlocal exits using `throw'.
1201 TAG is evalled to get the tag to use; it must not be nil.
1203 Then the BODY is executed.
1204 Within BODY, a call to `throw' with the same TAG exits BODY and this `catch'.
1205 If no throw happens, `catch' returns the value of the last BODY form.
1206 If a throw happens, it specifies the value to return from `catch'.
1207 usage: (catch TAG BODY...) */)
1210 register Lisp_Object tag
;
1211 struct gcpro gcpro1
;
1214 tag
= eval_sub (Fcar (args
));
1216 return internal_catch (tag
, Fprogn
, Fcdr (args
));
1219 /* Set up a catch, then call C function FUNC on argument ARG.
1220 FUNC should return a Lisp_Object.
1221 This is how catches are done from within C code. */
1224 internal_catch (Lisp_Object tag
, Lisp_Object (*func
) (Lisp_Object
), Lisp_Object arg
)
1226 /* This structure is made part of the chain `catchlist'. */
1229 /* Fill in the components of c, and put it on the list. */
1233 c
.backlist
= backtrace_list
;
1234 c
.handlerlist
= handlerlist
;
1235 c
.lisp_eval_depth
= lisp_eval_depth
;
1236 c
.pdlcount
= SPECPDL_INDEX ();
1237 c
.poll_suppress_count
= poll_suppress_count
;
1238 c
.interrupt_input_blocked
= interrupt_input_blocked
;
1239 c
.gcpro
= gcprolist
;
1240 c
.byte_stack
= byte_stack_list
;
1244 if (! _setjmp (c
.jmp
))
1245 c
.val
= (*func
) (arg
);
1247 /* Throw works by a longjmp that comes right here. */
1252 /* Unwind the specbind, catch, and handler stacks back to CATCH, and
1253 jump to that CATCH, returning VALUE as the value of that catch.
1255 This is the guts Fthrow and Fsignal; they differ only in the way
1256 they choose the catch tag to throw to. A catch tag for a
1257 condition-case form has a TAG of Qnil.
1259 Before each catch is discarded, unbind all special bindings and
1260 execute all unwind-protect clauses made above that catch. Unwind
1261 the handler stack as we go, so that the proper handlers are in
1262 effect for each unwind-protect clause we run. At the end, restore
1263 some static info saved in CATCH, and longjmp to the location
1266 This is used for correct unwinding in Fthrow and Fsignal. */
1269 unwind_to_catch (struct catchtag
*catch, Lisp_Object value
)
1271 register int last_time
;
1273 /* Save the value in the tag. */
1276 /* Restore certain special C variables. */
1277 set_poll_suppress_count (catch->poll_suppress_count
);
1278 UNBLOCK_INPUT_TO (catch->interrupt_input_blocked
);
1279 handling_signal
= 0;
1284 last_time
= catchlist
== catch;
1286 /* Unwind the specpdl stack, and then restore the proper set of
1288 unbind_to (catchlist
->pdlcount
, Qnil
);
1289 handlerlist
= catchlist
->handlerlist
;
1290 catchlist
= catchlist
->next
;
1292 while (! last_time
);
1295 /* If x_catch_errors was done, turn it off now.
1296 (First we give unbind_to a chance to do that.) */
1297 #if 0 /* This would disable x_catch_errors after x_connection_closed.
1298 The catch must remain in effect during that delicate
1299 state. --lorentey */
1300 x_fully_uncatch_errors ();
1304 byte_stack_list
= catch->byte_stack
;
1305 gcprolist
= catch->gcpro
;
1307 gcpro_level
= gcprolist
? gcprolist
->level
+ 1 : 0;
1309 backtrace_list
= catch->backlist
;
1310 lisp_eval_depth
= catch->lisp_eval_depth
;
1312 _longjmp (catch->jmp
, 1);
1315 DEFUE ("throw", Fthrow
, Sthrow
, 2, 2, 0,
1316 doc
: /* Throw to the catch for TAG and return VALUE from it.
1317 Both TAG and VALUE are evalled. */)
1318 (register Lisp_Object tag
, Lisp_Object value
)
1320 register struct catchtag
*c
;
1323 for (c
= catchlist
; c
; c
= c
->next
)
1325 if (EQ (c
->tag
, tag
))
1326 unwind_to_catch (c
, value
);
1328 xsignal2 (Qno_catch
, tag
, value
);
1332 DEFUN ("unwind-protect", Funwind_protect
, Sunwind_protect
, 1, UNEVALLED
, 0,
1333 doc
: /* Do BODYFORM, protecting with UNWINDFORMS.
1334 If BODYFORM completes normally, its value is returned
1335 after executing the UNWINDFORMS.
1336 If BODYFORM exits nonlocally, the UNWINDFORMS are executed anyway.
1337 usage: (unwind-protect BODYFORM UNWINDFORMS...) */)
1341 int count
= SPECPDL_INDEX ();
1343 record_unwind_protect (Fprogn
, Fcdr (args
));
1344 val
= eval_sub (Fcar (args
));
1345 return unbind_to (count
, val
);
1348 /* Chain of condition handlers currently in effect.
1349 The elements of this chain are contained in the stack frames
1350 of Fcondition_case and internal_condition_case.
1351 When an error is signaled (by calling Fsignal, below),
1352 this chain is searched for an element that applies. */
1354 struct handler
*handlerlist
;
1356 DEFUN ("condition-case", Fcondition_case
, Scondition_case
, 2, UNEVALLED
, 0,
1357 doc
: /* Regain control when an error is signaled.
1358 Executes BODYFORM and returns its value if no error happens.
1359 Each element of HANDLERS looks like (CONDITION-NAME BODY...)
1360 where the BODY is made of Lisp expressions.
1362 A handler is applicable to an error
1363 if CONDITION-NAME is one of the error's condition names.
1364 If an error happens, the first applicable handler is run.
1366 The car of a handler may be a list of condition names
1367 instead of a single condition name. Then it handles all of them.
1369 When a handler handles an error, control returns to the `condition-case'
1370 and it executes the handler's BODY...
1371 with VAR bound to (ERROR-SYMBOL . SIGNAL-DATA) from the error.
1372 \(If VAR is nil, the handler can't access that information.)
1373 Then the value of the last BODY form is returned from the `condition-case'
1376 See also the function `signal' for more info.
1377 usage: (condition-case VAR BODYFORM &rest HANDLERS) */)
1380 register Lisp_Object bodyform
, handlers
;
1381 volatile Lisp_Object var
;
1384 bodyform
= Fcar (Fcdr (args
));
1385 handlers
= Fcdr (Fcdr (args
));
1387 return internal_lisp_condition_case (var
, bodyform
, handlers
);
1390 /* Like Fcondition_case, but the args are separate
1391 rather than passed in a list. Used by Fbyte_code. */
1394 internal_lisp_condition_case (volatile Lisp_Object var
, Lisp_Object bodyform
,
1395 Lisp_Object handlers
)
1403 for (val
= handlers
; CONSP (val
); val
= XCDR (val
))
1409 && (SYMBOLP (XCAR (tem
))
1410 || CONSP (XCAR (tem
))))))
1411 error ("Invalid condition handler");
1416 c
.backlist
= backtrace_list
;
1417 c
.handlerlist
= handlerlist
;
1418 c
.lisp_eval_depth
= lisp_eval_depth
;
1419 c
.pdlcount
= SPECPDL_INDEX ();
1420 c
.poll_suppress_count
= poll_suppress_count
;
1421 c
.interrupt_input_blocked
= interrupt_input_blocked
;
1422 c
.gcpro
= gcprolist
;
1423 c
.byte_stack
= byte_stack_list
;
1424 if (_setjmp (c
.jmp
))
1427 specbind (h
.var
, c
.val
);
1428 val
= Fprogn (Fcdr (h
.chosen_clause
));
1430 /* Note that this just undoes the binding of h.var; whoever
1431 longjumped to us unwound the stack to c.pdlcount before
1433 unbind_to (c
.pdlcount
, Qnil
);
1440 h
.handler
= handlers
;
1441 h
.next
= handlerlist
;
1445 val
= eval_sub (bodyform
);
1447 handlerlist
= h
.next
;
1451 /* Call the function BFUN with no arguments, catching errors within it
1452 according to HANDLERS. If there is an error, call HFUN with
1453 one argument which is the data that describes the error:
1456 HANDLERS can be a list of conditions to catch.
1457 If HANDLERS is Qt, catch all errors.
1458 If HANDLERS is Qerror, catch all errors
1459 but allow the debugger to run if that is enabled. */
1462 internal_condition_case (Lisp_Object (*bfun
) (void), Lisp_Object handlers
,
1463 Lisp_Object (*hfun
) (Lisp_Object
))
1469 /* Since Fsignal will close off all calls to x_catch_errors,
1470 we will get the wrong results if some are not closed now. */
1472 if (x_catching_errors ())
1478 c
.backlist
= backtrace_list
;
1479 c
.handlerlist
= handlerlist
;
1480 c
.lisp_eval_depth
= lisp_eval_depth
;
1481 c
.pdlcount
= SPECPDL_INDEX ();
1482 c
.poll_suppress_count
= poll_suppress_count
;
1483 c
.interrupt_input_blocked
= interrupt_input_blocked
;
1484 c
.gcpro
= gcprolist
;
1485 c
.byte_stack
= byte_stack_list
;
1486 if (_setjmp (c
.jmp
))
1488 return (*hfun
) (c
.val
);
1492 h
.handler
= handlers
;
1494 h
.next
= handlerlist
;
1500 handlerlist
= h
.next
;
1504 /* Like internal_condition_case but call BFUN with ARG as its argument. */
1507 internal_condition_case_1 (Lisp_Object (*bfun
) (Lisp_Object
), Lisp_Object arg
,
1508 Lisp_Object handlers
, Lisp_Object (*hfun
) (Lisp_Object
))
1514 /* Since Fsignal will close off all calls to x_catch_errors,
1515 we will get the wrong results if some are not closed now. */
1517 if (x_catching_errors ())
1523 c
.backlist
= backtrace_list
;
1524 c
.handlerlist
= handlerlist
;
1525 c
.lisp_eval_depth
= lisp_eval_depth
;
1526 c
.pdlcount
= SPECPDL_INDEX ();
1527 c
.poll_suppress_count
= poll_suppress_count
;
1528 c
.interrupt_input_blocked
= interrupt_input_blocked
;
1529 c
.gcpro
= gcprolist
;
1530 c
.byte_stack
= byte_stack_list
;
1531 if (_setjmp (c
.jmp
))
1533 return (*hfun
) (c
.val
);
1537 h
.handler
= handlers
;
1539 h
.next
= handlerlist
;
1543 val
= (*bfun
) (arg
);
1545 handlerlist
= h
.next
;
1549 /* Like internal_condition_case_1 but call BFUN with ARG1 and ARG2 as
1553 internal_condition_case_2 (Lisp_Object (*bfun
) (Lisp_Object
, Lisp_Object
),
1556 Lisp_Object handlers
,
1557 Lisp_Object (*hfun
) (Lisp_Object
))
1563 /* Since Fsignal will close off all calls to x_catch_errors,
1564 we will get the wrong results if some are not closed now. */
1566 if (x_catching_errors ())
1572 c
.backlist
= backtrace_list
;
1573 c
.handlerlist
= handlerlist
;
1574 c
.lisp_eval_depth
= lisp_eval_depth
;
1575 c
.pdlcount
= SPECPDL_INDEX ();
1576 c
.poll_suppress_count
= poll_suppress_count
;
1577 c
.interrupt_input_blocked
= interrupt_input_blocked
;
1578 c
.gcpro
= gcprolist
;
1579 c
.byte_stack
= byte_stack_list
;
1580 if (_setjmp (c
.jmp
))
1582 return (*hfun
) (c
.val
);
1586 h
.handler
= handlers
;
1588 h
.next
= handlerlist
;
1592 val
= (*bfun
) (arg1
, arg2
);
1594 handlerlist
= h
.next
;
1598 /* Like internal_condition_case but call BFUN with NARGS as first,
1599 and ARGS as second argument. */
1602 internal_condition_case_n (Lisp_Object (*bfun
) (size_t, Lisp_Object
*),
1605 Lisp_Object handlers
,
1606 Lisp_Object (*hfun
) (Lisp_Object
))
1612 /* Since Fsignal will close off all calls to x_catch_errors,
1613 we will get the wrong results if some are not closed now. */
1615 if (x_catching_errors ())
1621 c
.backlist
= backtrace_list
;
1622 c
.handlerlist
= handlerlist
;
1623 c
.lisp_eval_depth
= lisp_eval_depth
;
1624 c
.pdlcount
= SPECPDL_INDEX ();
1625 c
.poll_suppress_count
= poll_suppress_count
;
1626 c
.interrupt_input_blocked
= interrupt_input_blocked
;
1627 c
.gcpro
= gcprolist
;
1628 c
.byte_stack
= byte_stack_list
;
1629 if (_setjmp (c
.jmp
))
1631 return (*hfun
) (c
.val
);
1635 h
.handler
= handlers
;
1637 h
.next
= handlerlist
;
1641 val
= (*bfun
) (nargs
, args
);
1643 handlerlist
= h
.next
;
1648 static Lisp_Object
find_handler_clause (Lisp_Object
, Lisp_Object
,
1649 Lisp_Object
, Lisp_Object
);
1650 static int maybe_call_debugger (Lisp_Object conditions
, Lisp_Object sig
,
1653 DEFUE ("signal", Fsignal
, Ssignal
, 2, 2, 0,
1654 doc
: /* Signal an error. Args are ERROR-SYMBOL and associated DATA.
1655 This function does not return.
1657 An error symbol is a symbol with an `error-conditions' property
1658 that is a list of condition names.
1659 A handler for any of those names will get to handle this signal.
1660 The symbol `error' should normally be one of them.
1662 DATA should be a list. Its elements are printed as part of the error message.
1663 See Info anchor `(elisp)Definition of signal' for some details on how this
1664 error message is constructed.
1665 If the signal is handled, DATA is made available to the handler.
1666 See also the function `condition-case'. */)
1667 (Lisp_Object error_symbol
, Lisp_Object data
)
1669 /* When memory is full, ERROR-SYMBOL is nil,
1670 and DATA is (REAL-ERROR-SYMBOL . REAL-DATA).
1671 That is a special case--don't do this in other situations. */
1672 Lisp_Object conditions
;
1674 Lisp_Object real_error_symbol
1675 = (NILP (error_symbol
) ? Fcar (data
) : error_symbol
);
1676 register Lisp_Object clause
= Qnil
;
1678 struct backtrace
*bp
;
1680 immediate_quit
= handling_signal
= 0;
1682 if (gc_in_progress
|| waiting_for_input
)
1685 #if 0 /* rms: I don't know why this was here,
1686 but it is surely wrong for an error that is handled. */
1687 #ifdef HAVE_WINDOW_SYSTEM
1688 if (display_hourglass_p
)
1689 cancel_hourglass ();
1693 /* This hook is used by edebug. */
1694 if (! NILP (Vsignal_hook_function
)
1695 && ! NILP (error_symbol
))
1697 /* Edebug takes care of restoring these variables when it exits. */
1698 if (lisp_eval_depth
+ 20 > max_lisp_eval_depth
)
1699 max_lisp_eval_depth
= lisp_eval_depth
+ 20;
1701 if (SPECPDL_INDEX () + 40 > max_specpdl_size
)
1702 max_specpdl_size
= SPECPDL_INDEX () + 40;
1704 call2 (Vsignal_hook_function
, error_symbol
, data
);
1707 conditions
= Fget (real_error_symbol
, Qerror_conditions
);
1709 /* Remember from where signal was called. Skip over the frame for
1710 `signal' itself. If a frame for `error' follows, skip that,
1711 too. Don't do this when ERROR_SYMBOL is nil, because that
1712 is a memory-full error. */
1713 Vsignaling_function
= Qnil
;
1714 if (backtrace_list
&& !NILP (error_symbol
))
1716 bp
= backtrace_list
->next
;
1717 if (bp
&& bp
->function
&& EQ (*bp
->function
, Qerror
))
1719 if (bp
&& bp
->function
)
1720 Vsignaling_function
= *bp
->function
;
1723 for (h
= handlerlist
; h
; h
= h
->next
)
1725 clause
= find_handler_clause (h
->handler
, conditions
,
1726 error_symbol
, data
);
1731 if (/* Don't run the debugger for a memory-full error.
1732 (There is no room in memory to do that!) */
1733 !NILP (error_symbol
)
1734 && (!NILP (Vdebug_on_signal
)
1735 /* If no handler is present now, try to run the debugger. */
1737 /* Special handler that means "print a message and run debugger
1739 || EQ (h
->handler
, Qerror
)))
1742 = maybe_call_debugger (conditions
, error_symbol
, data
);
1743 /* We can't return values to code which signaled an error, but we
1744 can continue code which has signaled a quit. */
1745 if (debugger_called
&& EQ (real_error_symbol
, Qquit
))
1751 Lisp_Object unwind_data
1752 = (NILP (error_symbol
) ? data
: Fcons (error_symbol
, data
));
1754 h
->chosen_clause
= clause
;
1755 unwind_to_catch (h
->tag
, unwind_data
);
1760 Fthrow (Qtop_level
, Qt
);
1763 if (! NILP (error_symbol
))
1764 data
= Fcons (error_symbol
, data
);
1766 string
= Ferror_message_string (data
);
1767 fatal ("%s", SDATA (string
));
1770 /* Internal version of Fsignal that never returns.
1771 Used for anything but Qquit (which can return from Fsignal). */
1774 xsignal (Lisp_Object error_symbol
, Lisp_Object data
)
1776 Fsignal (error_symbol
, data
);
1780 /* Like xsignal, but takes 0, 1, 2, or 3 args instead of a list. */
1783 xsignal0 (Lisp_Object error_symbol
)
1785 xsignal (error_symbol
, Qnil
);
1789 xsignal1 (Lisp_Object error_symbol
, Lisp_Object arg
)
1791 xsignal (error_symbol
, list1 (arg
));
1795 xsignal2 (Lisp_Object error_symbol
, Lisp_Object arg1
, Lisp_Object arg2
)
1797 xsignal (error_symbol
, list2 (arg1
, arg2
));
1801 xsignal3 (Lisp_Object error_symbol
, Lisp_Object arg1
, Lisp_Object arg2
, Lisp_Object arg3
)
1803 xsignal (error_symbol
, list3 (arg1
, arg2
, arg3
));
1806 /* Signal `error' with message S, and additional arg ARG.
1807 If ARG is not a genuine list, make it a one-element list. */
1810 signal_error (const char *s
, Lisp_Object arg
)
1812 Lisp_Object tortoise
, hare
;
1814 hare
= tortoise
= arg
;
1815 while (CONSP (hare
))
1822 tortoise
= XCDR (tortoise
);
1824 if (EQ (hare
, tortoise
))
1829 arg
= Fcons (arg
, Qnil
); /* Make it a list. */
1831 xsignal (Qerror
, Fcons (build_string (s
), arg
));
1835 /* Return nonzero if LIST is a non-nil atom or
1836 a list containing one of CONDITIONS. */
1839 wants_debugger (Lisp_Object list
, Lisp_Object conditions
)
1846 while (CONSP (conditions
))
1848 Lisp_Object
this, tail
;
1849 this = XCAR (conditions
);
1850 for (tail
= list
; CONSP (tail
); tail
= XCDR (tail
))
1851 if (EQ (XCAR (tail
), this))
1853 conditions
= XCDR (conditions
);
1858 /* Return 1 if an error with condition-symbols CONDITIONS,
1859 and described by SIGNAL-DATA, should skip the debugger
1860 according to debugger-ignored-errors. */
1863 skip_debugger (Lisp_Object conditions
, Lisp_Object data
)
1866 int first_string
= 1;
1867 Lisp_Object error_message
;
1869 error_message
= Qnil
;
1870 for (tail
= Vdebug_ignored_errors
; CONSP (tail
); tail
= XCDR (tail
))
1872 if (STRINGP (XCAR (tail
)))
1876 error_message
= Ferror_message_string (data
);
1880 if (fast_string_match (XCAR (tail
), error_message
) >= 0)
1885 Lisp_Object contail
;
1887 for (contail
= conditions
; CONSP (contail
); contail
= XCDR (contail
))
1888 if (EQ (XCAR (tail
), XCAR (contail
)))
1896 /* Call the debugger if calling it is currently enabled for CONDITIONS.
1897 SIG and DATA describe the signal, as in find_handler_clause. */
1900 maybe_call_debugger (Lisp_Object conditions
, Lisp_Object sig
, Lisp_Object data
)
1902 Lisp_Object combined_data
;
1904 combined_data
= Fcons (sig
, data
);
1907 /* Don't try to run the debugger with interrupts blocked.
1908 The editing loop would return anyway. */
1910 /* Does user want to enter debugger for this kind of error? */
1913 : wants_debugger (Vdebug_on_error
, conditions
))
1914 && ! skip_debugger (conditions
, combined_data
)
1915 /* RMS: What's this for? */
1916 && when_entered_debugger
< num_nonmacro_input_events
)
1918 call_debugger (Fcons (Qerror
, Fcons (combined_data
, Qnil
)));
1925 /* Value of Qlambda means we have called debugger and user has continued.
1926 There are two ways to pass SIG and DATA:
1927 = SIG is the error symbol, and DATA is the rest of the data.
1928 = SIG is nil, and DATA is (SYMBOL . REST-OF-DATA).
1929 This is for memory-full errors only.
1931 We need to increase max_specpdl_size temporarily around
1932 anything we do that can push on the specpdl, so as not to get
1933 a second error here in case we're handling specpdl overflow. */
1936 find_handler_clause (Lisp_Object handlers
, Lisp_Object conditions
,
1937 Lisp_Object sig
, Lisp_Object data
)
1939 register Lisp_Object h
;
1941 /* t is used by handlers for all conditions, set up by C code. */
1942 if (EQ (handlers
, Qt
))
1945 /* error is used similarly, but means print an error message
1946 and run the debugger if that is enabled. */
1947 if (EQ (handlers
, Qerror
))
1950 for (h
= handlers
; CONSP (h
); h
= XCDR (h
))
1952 Lisp_Object handler
= XCAR (h
);
1953 Lisp_Object condit
, tem
;
1955 if (!CONSP (handler
))
1957 condit
= XCAR (handler
);
1958 /* Handle a single condition name in handler HANDLER. */
1959 if (SYMBOLP (condit
))
1961 tem
= Fmemq (Fcar (handler
), conditions
);
1965 /* Handle a list of condition names in handler HANDLER. */
1966 else if (CONSP (condit
))
1969 for (tail
= condit
; CONSP (tail
); tail
= XCDR (tail
))
1971 tem
= Fmemq (XCAR (tail
), conditions
);
1982 /* Dump an error message; called like vprintf. */
1984 verror (const char *m
, va_list ap
)
1987 size_t size
= sizeof buf
;
1989 min (MOST_POSITIVE_FIXNUM
, min (INT_MAX
, SIZE_MAX
- 1)) + 1;
1996 used
= vsnprintf (buffer
, size
, m
, ap
);
2000 /* Non-C99 vsnprintf, such as w32, returns -1 when SIZE is too small.
2001 Guess a larger USED to work around the incompatibility. */
2002 used
= (size
<= size_max
/ 2 ? 2 * size
2003 : size
< size_max
? size_max
- 1
2006 else if (used
< size
)
2008 if (size_max
<= used
)
2014 buffer
= (char *) xmalloc (size
);
2017 string
= make_string (buffer
, used
);
2021 xsignal1 (Qerror
, string
);
2025 /* Dump an error message; called like printf. */
2029 error (const char *m
, ...)
2037 DEFUE ("commandp", Fcommandp
, Scommandp
, 1, 2, 0,
2038 doc
: /* Non-nil if FUNCTION makes provisions for interactive calling.
2039 This means it contains a description for how to read arguments to give it.
2040 The value is nil for an invalid function or a symbol with no function
2043 Interactively callable functions include strings and vectors (treated
2044 as keyboard macros), lambda-expressions that contain a top-level call
2045 to `interactive', autoload definitions made by `autoload' with non-nil
2046 fourth argument, and some of the built-in functions of Lisp.
2048 Also, a symbol satisfies `commandp' if its function definition does so.
2050 If the optional argument FOR-CALL-INTERACTIVELY is non-nil,
2051 then strings and vectors are not accepted. */)
2052 (Lisp_Object function
, Lisp_Object for_call_interactively
)
2054 register Lisp_Object fun
;
2055 register Lisp_Object funcar
;
2056 Lisp_Object if_prop
= Qnil
;
2060 fun
= indirect_function (fun
); /* Check cycles. */
2061 if (NILP (fun
) || EQ (fun
, Qunbound
))
2064 /* Check an `interactive-form' property if present, analogous to the
2065 function-documentation property. */
2067 while (SYMBOLP (fun
))
2069 Lisp_Object tmp
= Fget (fun
, Qinteractive_form
);
2072 fun
= Fsymbol_function (fun
);
2075 /* Emacs primitives are interactive if their DEFUN specifies an
2076 interactive spec. */
2078 return XSUBR (fun
)->intspec
? Qt
: if_prop
;
2080 /* Bytecode objects are interactive if they are long enough to
2081 have an element whose index is COMPILED_INTERACTIVE, which is
2082 where the interactive spec is stored. */
2083 else if (COMPILEDP (fun
))
2084 return ((ASIZE (fun
) & PSEUDOVECTOR_SIZE_MASK
) > COMPILED_INTERACTIVE
2087 /* Strings and vectors are keyboard macros. */
2088 if (STRINGP (fun
) || VECTORP (fun
))
2089 return (NILP (for_call_interactively
) ? Qt
: Qnil
);
2091 /* Lists may represent commands. */
2094 funcar
= XCAR (fun
);
2095 if (EQ (funcar
, Qclosure
))
2096 return (!NILP (Fassq (Qinteractive
, Fcdr (Fcdr (XCDR (fun
)))))
2098 else if (EQ (funcar
, Qlambda
))
2099 return !NILP (Fassq (Qinteractive
, Fcdr (XCDR (fun
)))) ? Qt
: if_prop
;
2100 else if (EQ (funcar
, Qautoload
))
2101 return !NILP (Fcar (Fcdr (Fcdr (XCDR (fun
))))) ? Qt
: if_prop
;
2106 DEFUN ("autoload", Fautoload
, Sautoload
, 2, 5, 0,
2107 doc
: /* Define FUNCTION to autoload from FILE.
2108 FUNCTION is a symbol; FILE is a file name string to pass to `load'.
2109 Third arg DOCSTRING is documentation for the function.
2110 Fourth arg INTERACTIVE if non-nil says function can be called interactively.
2111 Fifth arg TYPE indicates the type of the object:
2112 nil or omitted says FUNCTION is a function,
2113 `keymap' says FUNCTION is really a keymap, and
2114 `macro' or t says FUNCTION is really a macro.
2115 Third through fifth args give info about the real definition.
2116 They default to nil.
2117 If FUNCTION is already defined other than as an autoload,
2118 this does nothing and returns nil. */)
2119 (Lisp_Object function
, Lisp_Object file
, Lisp_Object docstring
, Lisp_Object interactive
, Lisp_Object type
)
2121 CHECK_SYMBOL (function
);
2122 CHECK_STRING (file
);
2124 /* If function is defined and not as an autoload, don't override. */
2125 if (!EQ (XSYMBOL (function
)->function
, Qunbound
)
2126 && !(CONSP (XSYMBOL (function
)->function
)
2127 && EQ (XCAR (XSYMBOL (function
)->function
), Qautoload
)))
2130 if (NILP (Vpurify_flag
))
2131 /* Only add entries after dumping, because the ones before are
2132 not useful and else we get loads of them from the loaddefs.el. */
2133 LOADHIST_ATTACH (Fcons (Qautoload
, function
));
2135 /* We don't want the docstring in purespace (instead,
2136 Snarf-documentation should (hopefully) overwrite it).
2137 We used to use 0 here, but that leads to accidental sharing in
2138 purecopy's hash-consing, so we use a (hopefully) unique integer
2140 docstring
= make_number (XHASH (function
));
2141 return Ffset (function
,
2142 Fpurecopy (list5 (Qautoload
, file
, docstring
,
2143 interactive
, type
)));
2147 un_autoload (Lisp_Object oldqueue
)
2149 register Lisp_Object queue
, first
, second
;
2151 /* Queue to unwind is current value of Vautoload_queue.
2152 oldqueue is the shadowed value to leave in Vautoload_queue. */
2153 queue
= Vautoload_queue
;
2154 Vautoload_queue
= oldqueue
;
2155 while (CONSP (queue
))
2157 first
= XCAR (queue
);
2158 second
= Fcdr (first
);
2159 first
= Fcar (first
);
2160 if (EQ (first
, make_number (0)))
2163 Ffset (first
, second
);
2164 queue
= XCDR (queue
);
2169 /* Load an autoloaded function.
2170 FUNNAME is the symbol which is the function's name.
2171 FUNDEF is the autoload definition (a list). */
2174 do_autoload (Lisp_Object fundef
, Lisp_Object funname
)
2176 int count
= SPECPDL_INDEX ();
2178 struct gcpro gcpro1
, gcpro2
, gcpro3
;
2180 /* This is to make sure that loadup.el gives a clear picture
2181 of what files are preloaded and when. */
2182 if (! NILP (Vpurify_flag
))
2183 error ("Attempt to autoload %s while preparing to dump",
2184 SDATA (SYMBOL_NAME (funname
)));
2187 CHECK_SYMBOL (funname
);
2188 GCPRO3 (fun
, funname
, fundef
);
2190 /* Preserve the match data. */
2191 record_unwind_save_match_data ();
2193 /* If autoloading gets an error (which includes the error of failing
2194 to define the function being called), we use Vautoload_queue
2195 to undo function definitions and `provide' calls made by
2196 the function. We do this in the specific case of autoloading
2197 because autoloading is not an explicit request "load this file",
2198 but rather a request to "call this function".
2200 The value saved here is to be restored into Vautoload_queue. */
2201 record_unwind_protect (un_autoload
, Vautoload_queue
);
2202 Vautoload_queue
= Qt
;
2203 Fload (Fcar (Fcdr (fundef
)), Qnil
, Qt
, Qnil
, Qt
);
2205 /* Once loading finishes, don't undo it. */
2206 Vautoload_queue
= Qt
;
2207 unbind_to (count
, Qnil
);
2209 fun
= Findirect_function (fun
, Qnil
);
2211 if (!NILP (Fequal (fun
, fundef
)))
2212 error ("Autoloading failed to define function %s",
2213 SDATA (SYMBOL_NAME (funname
)));
2218 DEFUE ("eval", Feval
, Seval
, 1, 2, 0,
2219 doc
: /* Evaluate FORM and return its value.
2220 If LEXICAL is t, evaluate using lexical scoping. */)
2221 (Lisp_Object form
, Lisp_Object lexical
)
2223 int count
= SPECPDL_INDEX ();
2224 specbind (Qinternal_interpreter_environment
,
2225 NILP (lexical
) ? Qnil
: Fcons (Qt
, Qnil
));
2226 return unbind_to (count
, eval_sub (form
));
2229 /* Eval a sub-expression of the current expression (i.e. in the same
2232 eval_sub (Lisp_Object form
)
2234 Lisp_Object fun
, val
, original_fun
, original_args
;
2236 struct backtrace backtrace
;
2237 struct gcpro gcpro1
, gcpro2
, gcpro3
;
2239 if (handling_signal
)
2244 /* Look up its binding in the lexical environment.
2245 We do not pay attention to the declared_special flag here, since we
2246 already did that when let-binding the variable. */
2247 Lisp_Object lex_binding
2248 = !NILP (Vinternal_interpreter_environment
) /* Mere optimization! */
2249 ? Fassq (form
, Vinternal_interpreter_environment
)
2251 if (CONSP (lex_binding
))
2252 return XCDR (lex_binding
);
2254 return Fsymbol_value (form
);
2261 if ((consing_since_gc
> gc_cons_threshold
2262 && consing_since_gc
> gc_relative_threshold
)
2264 (!NILP (Vmemory_full
) && consing_since_gc
> memory_full_cons_threshold
))
2267 Fgarbage_collect ();
2271 if (++lisp_eval_depth
> max_lisp_eval_depth
)
2273 if (max_lisp_eval_depth
< 100)
2274 max_lisp_eval_depth
= 100;
2275 if (lisp_eval_depth
> max_lisp_eval_depth
)
2276 error ("Lisp nesting exceeds `max-lisp-eval-depth'");
2279 original_fun
= Fcar (form
);
2280 original_args
= Fcdr (form
);
2282 backtrace
.next
= backtrace_list
;
2283 backtrace_list
= &backtrace
;
2284 backtrace
.function
= &original_fun
; /* This also protects them from gc. */
2285 backtrace
.args
= &original_args
;
2286 backtrace
.nargs
= UNEVALLED
;
2287 backtrace
.evalargs
= 1;
2288 backtrace
.debug_on_exit
= 0;
2290 if (debug_on_next_call
)
2291 do_debug_on_call (Qt
);
2293 /* At this point, only original_fun and original_args
2294 have values that will be used below. */
2297 /* Optimize for no indirection. */
2299 if (SYMBOLP (fun
) && !EQ (fun
, Qunbound
)
2300 && (fun
= XSYMBOL (fun
)->function
, SYMBOLP (fun
)))
2301 fun
= indirect_function (fun
);
2305 Lisp_Object numargs
;
2306 Lisp_Object argvals
[8];
2307 Lisp_Object args_left
;
2308 register int i
, maxargs
;
2310 args_left
= original_args
;
2311 numargs
= Flength (args_left
);
2315 if (XINT (numargs
) < XSUBR (fun
)->min_args
2316 || (XSUBR (fun
)->max_args
>= 0
2317 && XSUBR (fun
)->max_args
< XINT (numargs
)))
2318 xsignal2 (Qwrong_number_of_arguments
, original_fun
, numargs
);
2320 else if (XSUBR (fun
)->max_args
== UNEVALLED
)
2322 backtrace
.evalargs
= 0;
2323 val
= (XSUBR (fun
)->function
.aUNEVALLED
) (args_left
);
2325 else if (XSUBR (fun
)->max_args
== MANY
)
2327 /* Pass a vector of evaluated arguments. */
2329 register size_t argnum
= 0;
2332 SAFE_ALLOCA_LISP (vals
, XINT (numargs
));
2334 GCPRO3 (args_left
, fun
, fun
);
2338 while (!NILP (args_left
))
2340 vals
[argnum
++] = eval_sub (Fcar (args_left
));
2341 args_left
= Fcdr (args_left
);
2342 gcpro3
.nvars
= argnum
;
2345 backtrace
.args
= vals
;
2346 backtrace
.nargs
= XINT (numargs
);
2348 val
= (XSUBR (fun
)->function
.aMANY
) (XINT (numargs
), vals
);
2354 GCPRO3 (args_left
, fun
, fun
);
2355 gcpro3
.var
= argvals
;
2358 maxargs
= XSUBR (fun
)->max_args
;
2359 for (i
= 0; i
< maxargs
; args_left
= Fcdr (args_left
))
2361 argvals
[i
] = eval_sub (Fcar (args_left
));
2367 backtrace
.args
= argvals
;
2368 backtrace
.nargs
= XINT (numargs
);
2373 val
= (XSUBR (fun
)->function
.a0 ());
2376 val
= (XSUBR (fun
)->function
.a1 (argvals
[0]));
2379 val
= (XSUBR (fun
)->function
.a2 (argvals
[0], argvals
[1]));
2382 val
= (XSUBR (fun
)->function
.a3
2383 (argvals
[0], argvals
[1], argvals
[2]));
2386 val
= (XSUBR (fun
)->function
.a4
2387 (argvals
[0], argvals
[1], argvals
[2], argvals
[3]));
2390 val
= (XSUBR (fun
)->function
.a5
2391 (argvals
[0], argvals
[1], argvals
[2], argvals
[3],
2395 val
= (XSUBR (fun
)->function
.a6
2396 (argvals
[0], argvals
[1], argvals
[2], argvals
[3],
2397 argvals
[4], argvals
[5]));
2400 val
= (XSUBR (fun
)->function
.a7
2401 (argvals
[0], argvals
[1], argvals
[2], argvals
[3],
2402 argvals
[4], argvals
[5], argvals
[6]));
2406 val
= (XSUBR (fun
)->function
.a8
2407 (argvals
[0], argvals
[1], argvals
[2], argvals
[3],
2408 argvals
[4], argvals
[5], argvals
[6], argvals
[7]));
2412 /* Someone has created a subr that takes more arguments than
2413 is supported by this code. We need to either rewrite the
2414 subr to use a different argument protocol, or add more
2415 cases to this switch. */
2420 else if (COMPILEDP (fun
))
2421 val
= apply_lambda (fun
, original_args
);
2424 if (EQ (fun
, Qunbound
))
2425 xsignal1 (Qvoid_function
, original_fun
);
2427 xsignal1 (Qinvalid_function
, original_fun
);
2428 funcar
= XCAR (fun
);
2429 if (!SYMBOLP (funcar
))
2430 xsignal1 (Qinvalid_function
, original_fun
);
2431 if (EQ (funcar
, Qautoload
))
2433 do_autoload (fun
, original_fun
);
2436 if (EQ (funcar
, Qmacro
))
2437 val
= eval_sub (apply1 (Fcdr (fun
), original_args
));
2438 else if (EQ (funcar
, Qlambda
)
2439 || EQ (funcar
, Qclosure
))
2440 val
= apply_lambda (fun
, original_args
);
2442 xsignal1 (Qinvalid_function
, original_fun
);
2447 if (backtrace
.debug_on_exit
)
2448 val
= call_debugger (Fcons (Qexit
, Fcons (val
, Qnil
)));
2449 backtrace_list
= backtrace
.next
;
2454 DEFUE ("apply", Fapply
, Sapply
, 2, MANY
, 0,
2455 doc
: /* Call FUNCTION with our remaining args, using our last arg as list of args.
2456 Then return the value FUNCTION returns.
2457 Thus, (apply '+ 1 2 '(3 4)) returns 10.
2458 usage: (apply FUNCTION &rest ARGUMENTS) */)
2459 (size_t nargs
, Lisp_Object
*args
)
2461 register size_t i
, numargs
;
2462 register Lisp_Object spread_arg
;
2463 register Lisp_Object
*funcall_args
;
2464 Lisp_Object fun
, retval
;
2465 struct gcpro gcpro1
;
2470 spread_arg
= args
[nargs
- 1];
2471 CHECK_LIST (spread_arg
);
2473 numargs
= XINT (Flength (spread_arg
));
2476 return Ffuncall (nargs
- 1, args
);
2477 else if (numargs
== 1)
2479 args
[nargs
- 1] = XCAR (spread_arg
);
2480 return Ffuncall (nargs
, args
);
2483 numargs
+= nargs
- 2;
2485 /* Optimize for no indirection. */
2486 if (SYMBOLP (fun
) && !EQ (fun
, Qunbound
)
2487 && (fun
= XSYMBOL (fun
)->function
, SYMBOLP (fun
)))
2488 fun
= indirect_function (fun
);
2489 if (EQ (fun
, Qunbound
))
2491 /* Let funcall get the error. */
2498 if (numargs
< XSUBR (fun
)->min_args
2499 || (XSUBR (fun
)->max_args
>= 0 && XSUBR (fun
)->max_args
< numargs
))
2500 goto funcall
; /* Let funcall get the error. */
2501 else if (XSUBR (fun
)->max_args
>= 0 && XSUBR (fun
)->max_args
> numargs
)
2503 /* Avoid making funcall cons up a yet another new vector of arguments
2504 by explicitly supplying nil's for optional values. */
2505 SAFE_ALLOCA_LISP (funcall_args
, 1 + XSUBR (fun
)->max_args
);
2506 for (i
= numargs
; i
< XSUBR (fun
)->max_args
;)
2507 funcall_args
[++i
] = Qnil
;
2508 GCPRO1 (*funcall_args
);
2509 gcpro1
.nvars
= 1 + XSUBR (fun
)->max_args
;
2513 /* We add 1 to numargs because funcall_args includes the
2514 function itself as well as its arguments. */
2517 SAFE_ALLOCA_LISP (funcall_args
, 1 + numargs
);
2518 GCPRO1 (*funcall_args
);
2519 gcpro1
.nvars
= 1 + numargs
;
2522 memcpy (funcall_args
, args
, nargs
* sizeof (Lisp_Object
));
2523 /* Spread the last arg we got. Its first element goes in
2524 the slot that it used to occupy, hence this value of I. */
2526 while (!NILP (spread_arg
))
2528 funcall_args
[i
++] = XCAR (spread_arg
);
2529 spread_arg
= XCDR (spread_arg
);
2532 /* By convention, the caller needs to gcpro Ffuncall's args. */
2533 retval
= Ffuncall (gcpro1
.nvars
, funcall_args
);
2540 /* Run hook variables in various ways. */
2543 funcall_nil (size_t nargs
, Lisp_Object
*args
)
2545 Ffuncall (nargs
, args
);
2549 DEFUE ("run-hooks", Frun_hooks
, Srun_hooks
, 0, MANY
, 0,
2550 doc
: /* Run each hook in HOOKS.
2551 Each argument should be a symbol, a hook variable.
2552 These symbols are processed in the order specified.
2553 If a hook symbol has a non-nil value, that value may be a function
2554 or a list of functions to be called to run the hook.
2555 If the value is a function, it is called with no arguments.
2556 If it is a list, the elements are called, in order, with no arguments.
2558 Major modes should not use this function directly to run their mode
2559 hook; they should use `run-mode-hooks' instead.
2561 Do not use `make-local-variable' to make a hook variable buffer-local.
2562 Instead, use `add-hook' and specify t for the LOCAL argument.
2563 usage: (run-hooks &rest HOOKS) */)
2564 (size_t nargs
, Lisp_Object
*args
)
2566 Lisp_Object hook
[1];
2569 for (i
= 0; i
< nargs
; i
++)
2572 run_hook_with_args (1, hook
, funcall_nil
);
2578 DEFUE ("run-hook-with-args", Frun_hook_with_args
,
2579 Srun_hook_with_args
, 1, MANY
, 0,
2580 doc
: /* Run HOOK with the specified arguments ARGS.
2581 HOOK should be a symbol, a hook variable. If HOOK has a non-nil
2582 value, that value may be a function or a list of functions to be
2583 called to run the hook. If the value is a function, it is called with
2584 the given arguments and its return value is returned. If it is a list
2585 of functions, those functions are called, in order,
2586 with the given arguments ARGS.
2587 It is best not to depend on the value returned by `run-hook-with-args',
2590 Do not use `make-local-variable' to make a hook variable buffer-local.
2591 Instead, use `add-hook' and specify t for the LOCAL argument.
2592 usage: (run-hook-with-args HOOK &rest ARGS) */)
2593 (size_t nargs
, Lisp_Object
*args
)
2595 return run_hook_with_args (nargs
, args
, funcall_nil
);
2598 DEFUN ("run-hook-with-args-until-success", Frun_hook_with_args_until_success
,
2599 Srun_hook_with_args_until_success
, 1, MANY
, 0,
2600 doc
: /* Run HOOK with the specified arguments ARGS.
2601 HOOK should be a symbol, a hook variable. If HOOK has a non-nil
2602 value, that value may be a function or a list of functions to be
2603 called to run the hook. If the value is a function, it is called with
2604 the given arguments and its return value is returned.
2605 If it is a list of functions, those functions are called, in order,
2606 with the given arguments ARGS, until one of them
2607 returns a non-nil value. Then we return that value.
2608 However, if they all return nil, we return nil.
2610 Do not use `make-local-variable' to make a hook variable buffer-local.
2611 Instead, use `add-hook' and specify t for the LOCAL argument.
2612 usage: (run-hook-with-args-until-success HOOK &rest ARGS) */)
2613 (size_t nargs
, Lisp_Object
*args
)
2615 return run_hook_with_args (nargs
, args
, Ffuncall
);
2619 funcall_not (size_t nargs
, Lisp_Object
*args
)
2621 return NILP (Ffuncall (nargs
, args
)) ? Qt
: Qnil
;
2624 DEFUE ("run-hook-with-args-until-failure", Frun_hook_with_args_until_failure
,
2625 Srun_hook_with_args_until_failure
, 1, MANY
, 0,
2626 doc
: /* Run HOOK with the specified arguments ARGS.
2627 HOOK should be a symbol, a hook variable. If HOOK has a non-nil
2628 value, that value may be a function or a list of functions to be
2629 called to run the hook. If the value is a function, it is called with
2630 the given arguments and its return value is returned.
2631 If it is a list of functions, those functions are called, in order,
2632 with the given arguments ARGS, until one of them returns nil.
2633 Then we return nil. However, if they all return non-nil, we return non-nil.
2635 Do not use `make-local-variable' to make a hook variable buffer-local.
2636 Instead, use `add-hook' and specify t for the LOCAL argument.
2637 usage: (run-hook-with-args-until-failure HOOK &rest ARGS) */)
2638 (size_t nargs
, Lisp_Object
*args
)
2640 return NILP (run_hook_with_args (nargs
, args
, funcall_not
)) ? Qt
: Qnil
;
2644 run_hook_wrapped_funcall (size_t nargs
, Lisp_Object
*args
)
2646 Lisp_Object tmp
= args
[0], ret
;
2649 ret
= Ffuncall (nargs
, args
);
2655 DEFUN ("run-hook-wrapped", Frun_hook_wrapped
, Srun_hook_wrapped
, 2, MANY
, 0,
2656 doc
: /* Run HOOK, passing each function through WRAP-FUNCTION.
2657 I.e. instead of calling each function FUN directly with arguments ARGS,
2658 it calls WRAP-FUNCTION with arguments FUN and ARGS.
2659 As soon as a call to WRAP-FUNCTION returns non-nil, `run-hook-wrapped'
2660 aborts and returns that value.
2661 usage: (run-hook-wrapped HOOK WRAP-FUNCTION &rest ARGS) */)
2662 (size_t nargs
, Lisp_Object
*args
)
2664 return run_hook_with_args (nargs
, args
, run_hook_wrapped_funcall
);
2667 /* ARGS[0] should be a hook symbol.
2668 Call each of the functions in the hook value, passing each of them
2669 as arguments all the rest of ARGS (all NARGS - 1 elements).
2670 FUNCALL specifies how to call each function on the hook.
2671 The caller (or its caller, etc) must gcpro all of ARGS,
2672 except that it isn't necessary to gcpro ARGS[0]. */
2675 run_hook_with_args (size_t nargs
, Lisp_Object
*args
,
2676 Lisp_Object (*funcall
) (size_t nargs
, Lisp_Object
*args
))
2678 Lisp_Object sym
, val
, ret
= Qnil
;
2679 struct gcpro gcpro1
, gcpro2
, gcpro3
;
2681 /* If we are dying or still initializing,
2682 don't do anything--it would probably crash if we tried. */
2683 if (NILP (Vrun_hooks
))
2687 val
= find_symbol_value (sym
);
2689 if (EQ (val
, Qunbound
) || NILP (val
))
2691 else if (!CONSP (val
) || EQ (XCAR (val
), Qlambda
))
2694 return funcall (nargs
, args
);
2698 Lisp_Object global_vals
= Qnil
;
2699 GCPRO3 (sym
, val
, global_vals
);
2702 CONSP (val
) && NILP (ret
);
2705 if (EQ (XCAR (val
), Qt
))
2707 /* t indicates this hook has a local binding;
2708 it means to run the global binding too. */
2709 global_vals
= Fdefault_value (sym
);
2710 if (NILP (global_vals
)) continue;
2712 if (!CONSP (global_vals
) || EQ (XCAR (global_vals
), Qlambda
))
2714 args
[0] = global_vals
;
2715 ret
= funcall (nargs
, args
);
2720 CONSP (global_vals
) && NILP (ret
);
2721 global_vals
= XCDR (global_vals
))
2723 args
[0] = XCAR (global_vals
);
2724 /* In a global value, t should not occur. If it does, we
2725 must ignore it to avoid an endless loop. */
2726 if (!EQ (args
[0], Qt
))
2727 ret
= funcall (nargs
, args
);
2733 args
[0] = XCAR (val
);
2734 ret
= funcall (nargs
, args
);
2743 /* Run the hook HOOK, giving each function the two args ARG1 and ARG2. */
2746 run_hook_with_args_2 (Lisp_Object hook
, Lisp_Object arg1
, Lisp_Object arg2
)
2748 Lisp_Object temp
[3];
2753 Frun_hook_with_args (3, temp
);
2756 /* Apply fn to arg. */
2758 apply1 (Lisp_Object fn
, Lisp_Object arg
)
2760 struct gcpro gcpro1
;
2764 RETURN_UNGCPRO (Ffuncall (1, &fn
));
2767 Lisp_Object args
[2];
2771 RETURN_UNGCPRO (Fapply (2, args
));
2775 /* Call function fn on no arguments. */
2777 call0 (Lisp_Object fn
)
2779 struct gcpro gcpro1
;
2782 RETURN_UNGCPRO (Ffuncall (1, &fn
));
2785 /* Call function fn with 1 argument arg1. */
2788 call1 (Lisp_Object fn
, Lisp_Object arg1
)
2790 struct gcpro gcpro1
;
2791 Lisp_Object args
[2];
2797 RETURN_UNGCPRO (Ffuncall (2, args
));
2800 /* Call function fn with 2 arguments arg1, arg2. */
2803 call2 (Lisp_Object fn
, Lisp_Object arg1
, Lisp_Object arg2
)
2805 struct gcpro gcpro1
;
2806 Lisp_Object args
[3];
2812 RETURN_UNGCPRO (Ffuncall (3, args
));
2815 /* Call function fn with 3 arguments arg1, arg2, arg3. */
2818 call3 (Lisp_Object fn
, Lisp_Object arg1
, Lisp_Object arg2
, Lisp_Object arg3
)
2820 struct gcpro gcpro1
;
2821 Lisp_Object args
[4];
2828 RETURN_UNGCPRO (Ffuncall (4, args
));
2831 /* Call function fn with 4 arguments arg1, arg2, arg3, arg4. */
2834 call4 (Lisp_Object fn
, Lisp_Object arg1
, Lisp_Object arg2
, Lisp_Object arg3
,
2837 struct gcpro gcpro1
;
2838 Lisp_Object args
[5];
2846 RETURN_UNGCPRO (Ffuncall (5, args
));
2849 /* Call function fn with 5 arguments arg1, arg2, arg3, arg4, arg5. */
2852 call5 (Lisp_Object fn
, Lisp_Object arg1
, Lisp_Object arg2
, Lisp_Object arg3
,
2853 Lisp_Object arg4
, Lisp_Object arg5
)
2855 struct gcpro gcpro1
;
2856 Lisp_Object args
[6];
2865 RETURN_UNGCPRO (Ffuncall (6, args
));
2868 /* Call function fn with 6 arguments arg1, arg2, arg3, arg4, arg5, arg6. */
2871 call6 (Lisp_Object fn
, Lisp_Object arg1
, Lisp_Object arg2
, Lisp_Object arg3
,
2872 Lisp_Object arg4
, Lisp_Object arg5
, Lisp_Object arg6
)
2874 struct gcpro gcpro1
;
2875 Lisp_Object args
[7];
2885 RETURN_UNGCPRO (Ffuncall (7, args
));
2888 /* Call function fn with 7 arguments arg1, arg2, arg3, arg4, arg5, arg6, arg7. */
2891 call7 (Lisp_Object fn
, Lisp_Object arg1
, Lisp_Object arg2
, Lisp_Object arg3
,
2892 Lisp_Object arg4
, Lisp_Object arg5
, Lisp_Object arg6
, Lisp_Object arg7
)
2894 struct gcpro gcpro1
;
2895 Lisp_Object args
[8];
2906 RETURN_UNGCPRO (Ffuncall (8, args
));
2909 /* The caller should GCPRO all the elements of ARGS. */
2911 DEFUE ("functionp", Ffunctionp
, Sfunctionp
, 1, 1, 0,
2912 doc
: /* Non-nil if OBJECT is a function. */)
2913 (Lisp_Object object
)
2915 if (SYMBOLP (object
) && !NILP (Ffboundp (object
)))
2917 object
= Findirect_function (object
, Qt
);
2919 if (CONSP (object
) && EQ (XCAR (object
), Qautoload
))
2921 /* Autoloaded symbols are functions, except if they load
2922 macros or keymaps. */
2924 for (i
= 0; i
< 4 && CONSP (object
); i
++)
2925 object
= XCDR (object
);
2927 return (CONSP (object
) && !NILP (XCAR (object
))) ? Qnil
: Qt
;
2932 return (XSUBR (object
)->max_args
!= UNEVALLED
) ? Qt
: Qnil
;
2933 else if (COMPILEDP (object
))
2935 else if (CONSP (object
))
2937 Lisp_Object car
= XCAR (object
);
2938 return (EQ (car
, Qlambda
) || EQ (car
, Qclosure
)) ? Qt
: Qnil
;
2944 DEFUE ("funcall", Ffuncall
, Sfuncall
, 1, MANY
, 0,
2945 doc
: /* Call first argument as a function, passing remaining arguments to it.
2946 Return the value that function returns.
2947 Thus, (funcall 'cons 'x 'y) returns (x . y).
2948 usage: (funcall FUNCTION &rest ARGUMENTS) */)
2949 (size_t nargs
, Lisp_Object
*args
)
2951 Lisp_Object fun
, original_fun
;
2953 size_t numargs
= nargs
- 1;
2954 Lisp_Object lisp_numargs
;
2956 struct backtrace backtrace
;
2957 register Lisp_Object
*internal_args
;
2961 if ((consing_since_gc
> gc_cons_threshold
2962 && consing_since_gc
> gc_relative_threshold
)
2964 (!NILP (Vmemory_full
) && consing_since_gc
> memory_full_cons_threshold
))
2965 Fgarbage_collect ();
2967 if (++lisp_eval_depth
> max_lisp_eval_depth
)
2969 if (max_lisp_eval_depth
< 100)
2970 max_lisp_eval_depth
= 100;
2971 if (lisp_eval_depth
> max_lisp_eval_depth
)
2972 error ("Lisp nesting exceeds `max-lisp-eval-depth'");
2975 backtrace
.next
= backtrace_list
;
2976 backtrace_list
= &backtrace
;
2977 backtrace
.function
= &args
[0];
2978 backtrace
.args
= &args
[1];
2979 backtrace
.nargs
= nargs
- 1;
2980 backtrace
.evalargs
= 0;
2981 backtrace
.debug_on_exit
= 0;
2983 if (debug_on_next_call
)
2984 do_debug_on_call (Qlambda
);
2988 original_fun
= args
[0];
2992 /* Optimize for no indirection. */
2994 if (SYMBOLP (fun
) && !EQ (fun
, Qunbound
)
2995 && (fun
= XSYMBOL (fun
)->function
, SYMBOLP (fun
)))
2996 fun
= indirect_function (fun
);
3000 if (numargs
< XSUBR (fun
)->min_args
3001 || (XSUBR (fun
)->max_args
>= 0 && XSUBR (fun
)->max_args
< numargs
))
3003 XSETFASTINT (lisp_numargs
, numargs
);
3004 xsignal2 (Qwrong_number_of_arguments
, original_fun
, lisp_numargs
);
3007 else if (XSUBR (fun
)->max_args
== UNEVALLED
)
3008 xsignal1 (Qinvalid_function
, original_fun
);
3010 else if (XSUBR (fun
)->max_args
== MANY
)
3011 val
= (XSUBR (fun
)->function
.aMANY
) (numargs
, args
+ 1);
3014 if (XSUBR (fun
)->max_args
> numargs
)
3016 internal_args
= (Lisp_Object
*) alloca (XSUBR (fun
)->max_args
* sizeof (Lisp_Object
));
3017 memcpy (internal_args
, args
+ 1, numargs
* sizeof (Lisp_Object
));
3018 for (i
= numargs
; i
< XSUBR (fun
)->max_args
; i
++)
3019 internal_args
[i
] = Qnil
;
3022 internal_args
= args
+ 1;
3023 switch (XSUBR (fun
)->max_args
)
3026 val
= (XSUBR (fun
)->function
.a0 ());
3029 val
= (XSUBR (fun
)->function
.a1 (internal_args
[0]));
3032 val
= (XSUBR (fun
)->function
.a2
3033 (internal_args
[0], internal_args
[1]));
3036 val
= (XSUBR (fun
)->function
.a3
3037 (internal_args
[0], internal_args
[1], internal_args
[2]));
3040 val
= (XSUBR (fun
)->function
.a4
3041 (internal_args
[0], internal_args
[1], internal_args
[2],
3045 val
= (XSUBR (fun
)->function
.a5
3046 (internal_args
[0], internal_args
[1], internal_args
[2],
3047 internal_args
[3], internal_args
[4]));
3050 val
= (XSUBR (fun
)->function
.a6
3051 (internal_args
[0], internal_args
[1], internal_args
[2],
3052 internal_args
[3], internal_args
[4], internal_args
[5]));
3055 val
= (XSUBR (fun
)->function
.a7
3056 (internal_args
[0], internal_args
[1], internal_args
[2],
3057 internal_args
[3], internal_args
[4], internal_args
[5],
3062 val
= (XSUBR (fun
)->function
.a8
3063 (internal_args
[0], internal_args
[1], internal_args
[2],
3064 internal_args
[3], internal_args
[4], internal_args
[5],
3065 internal_args
[6], internal_args
[7]));
3070 /* If a subr takes more than 8 arguments without using MANY
3071 or UNEVALLED, we need to extend this function to support it.
3072 Until this is done, there is no way to call the function. */
3077 else if (COMPILEDP (fun
))
3078 val
= funcall_lambda (fun
, numargs
, args
+ 1);
3081 if (EQ (fun
, Qunbound
))
3082 xsignal1 (Qvoid_function
, original_fun
);
3084 xsignal1 (Qinvalid_function
, original_fun
);
3085 funcar
= XCAR (fun
);
3086 if (!SYMBOLP (funcar
))
3087 xsignal1 (Qinvalid_function
, original_fun
);
3088 if (EQ (funcar
, Qlambda
)
3089 || EQ (funcar
, Qclosure
))
3090 val
= funcall_lambda (fun
, numargs
, args
+ 1);
3091 else if (EQ (funcar
, Qautoload
))
3093 do_autoload (fun
, original_fun
);
3098 xsignal1 (Qinvalid_function
, original_fun
);
3102 if (backtrace
.debug_on_exit
)
3103 val
= call_debugger (Fcons (Qexit
, Fcons (val
, Qnil
)));
3104 backtrace_list
= backtrace
.next
;
3109 apply_lambda (Lisp_Object fun
, Lisp_Object args
)
3111 Lisp_Object args_left
;
3113 register Lisp_Object
*arg_vector
;
3114 struct gcpro gcpro1
, gcpro2
, gcpro3
;
3116 register Lisp_Object tem
;
3119 numargs
= XINT (Flength (args
));
3120 SAFE_ALLOCA_LISP (arg_vector
, numargs
);
3123 GCPRO3 (*arg_vector
, args_left
, fun
);
3126 for (i
= 0; i
< numargs
; )
3128 tem
= Fcar (args_left
), args_left
= Fcdr (args_left
);
3129 tem
= eval_sub (tem
);
3130 arg_vector
[i
++] = tem
;
3136 backtrace_list
->args
= arg_vector
;
3137 backtrace_list
->nargs
= i
;
3138 backtrace_list
->evalargs
= 0;
3139 tem
= funcall_lambda (fun
, numargs
, arg_vector
);
3141 /* Do the debug-on-exit now, while arg_vector still exists. */
3142 if (backtrace_list
->debug_on_exit
)
3143 tem
= call_debugger (Fcons (Qexit
, Fcons (tem
, Qnil
)));
3144 /* Don't do it again when we return to eval. */
3145 backtrace_list
->debug_on_exit
= 0;
3150 /* Apply a Lisp function FUN to the NARGS evaluated arguments in ARG_VECTOR
3151 and return the result of evaluation.
3152 FUN must be either a lambda-expression or a compiled-code object. */
3155 funcall_lambda (Lisp_Object fun
, size_t nargs
,
3156 register Lisp_Object
*arg_vector
)
3158 Lisp_Object val
, syms_left
, next
, lexenv
;
3159 int count
= SPECPDL_INDEX ();
3165 if (EQ (XCAR (fun
), Qclosure
))
3167 fun
= XCDR (fun
); /* Drop `closure'. */
3168 lexenv
= XCAR (fun
);
3169 CHECK_LIST_CONS (fun
, fun
);
3173 syms_left
= XCDR (fun
);
3174 if (CONSP (syms_left
))
3175 syms_left
= XCAR (syms_left
);
3177 xsignal1 (Qinvalid_function
, fun
);
3179 else if (COMPILEDP (fun
))
3181 syms_left
= AREF (fun
, COMPILED_ARGLIST
);
3182 if (INTEGERP (syms_left
))
3183 /* A byte-code object with a non-nil `push args' slot means we
3184 shouldn't bind any arguments, instead just call the byte-code
3185 interpreter directly; it will push arguments as necessary.
3187 Byte-code objects with either a non-existant, or a nil value for
3188 the `push args' slot (the default), have dynamically-bound
3189 arguments, and use the argument-binding code below instead (as do
3190 all interpreted functions, even lexically bound ones). */
3192 /* If we have not actually read the bytecode string
3193 and constants vector yet, fetch them from the file. */
3194 if (CONSP (AREF (fun
, COMPILED_BYTECODE
)))
3195 Ffetch_bytecode (fun
);
3196 return exec_byte_code (AREF (fun
, COMPILED_BYTECODE
),
3197 AREF (fun
, COMPILED_CONSTANTS
),
3198 AREF (fun
, COMPILED_STACK_DEPTH
),
3207 i
= optional
= rest
= 0;
3208 for (; CONSP (syms_left
); syms_left
= XCDR (syms_left
))
3212 next
= XCAR (syms_left
);
3213 if (!SYMBOLP (next
))
3214 xsignal1 (Qinvalid_function
, fun
);
3216 if (EQ (next
, Qand_rest
))
3218 else if (EQ (next
, Qand_optional
))
3225 arg
= Flist (nargs
- i
, &arg_vector
[i
]);
3229 arg
= arg_vector
[i
++];
3231 xsignal2 (Qwrong_number_of_arguments
, fun
, make_number (nargs
));
3235 /* Bind the argument. */
3236 if (!NILP (lexenv
) && SYMBOLP (next
))
3237 /* Lexically bind NEXT by adding it to the lexenv alist. */
3238 lexenv
= Fcons (Fcons (next
, arg
), lexenv
);
3240 /* Dynamically bind NEXT. */
3241 specbind (next
, arg
);
3245 if (!NILP (syms_left
))
3246 xsignal1 (Qinvalid_function
, fun
);
3248 xsignal2 (Qwrong_number_of_arguments
, fun
, make_number (nargs
));
3250 if (!EQ (lexenv
, Vinternal_interpreter_environment
))
3251 /* Instantiate a new lexical environment. */
3252 specbind (Qinternal_interpreter_environment
, lexenv
);
3255 val
= Fprogn (XCDR (XCDR (fun
)));
3258 /* If we have not actually read the bytecode string
3259 and constants vector yet, fetch them from the file. */
3260 if (CONSP (AREF (fun
, COMPILED_BYTECODE
)))
3261 Ffetch_bytecode (fun
);
3262 val
= exec_byte_code (AREF (fun
, COMPILED_BYTECODE
),
3263 AREF (fun
, COMPILED_CONSTANTS
),
3264 AREF (fun
, COMPILED_STACK_DEPTH
),
3268 return unbind_to (count
, val
);
3271 DEFUN ("fetch-bytecode", Ffetch_bytecode
, Sfetch_bytecode
,
3273 doc
: /* If byte-compiled OBJECT is lazy-loaded, fetch it now. */)
3274 (Lisp_Object object
)
3278 if (COMPILEDP (object
) && CONSP (AREF (object
, COMPILED_BYTECODE
)))
3280 tem
= read_doc_string (AREF (object
, COMPILED_BYTECODE
));
3283 tem
= AREF (object
, COMPILED_BYTECODE
);
3284 if (CONSP (tem
) && STRINGP (XCAR (tem
)))
3285 error ("Invalid byte code in %s", SDATA (XCAR (tem
)));
3287 error ("Invalid byte code");
3289 ASET (object
, COMPILED_BYTECODE
, XCAR (tem
));
3290 ASET (object
, COMPILED_CONSTANTS
, XCDR (tem
));
3298 register int count
= SPECPDL_INDEX ();
3299 if (specpdl_size
>= max_specpdl_size
)
3301 if (max_specpdl_size
< 400)
3302 max_specpdl_size
= 400;
3303 if (specpdl_size
>= max_specpdl_size
)
3304 signal_error ("Variable binding depth exceeds max-specpdl-size", Qnil
);
3307 if (specpdl_size
> max_specpdl_size
)
3308 specpdl_size
= max_specpdl_size
;
3309 specpdl
= (struct specbinding
*) xrealloc (specpdl
, specpdl_size
* sizeof (struct specbinding
));
3310 specpdl_ptr
= specpdl
+ count
;
3313 /* `specpdl_ptr->symbol' is a field which describes which variable is
3314 let-bound, so it can be properly undone when we unbind_to.
3315 It can have the following two shapes:
3316 - SYMBOL : if it's a plain symbol, it means that we have let-bound
3317 a symbol that is not buffer-local (at least at the time
3318 the let binding started). Note also that it should not be
3319 aliased (i.e. when let-binding V1 that's aliased to V2, we want
3321 - (SYMBOL WHERE . BUFFER) : this means that it is a let-binding for
3322 variable SYMBOL which can be buffer-local. WHERE tells us
3323 which buffer is affected (or nil if the let-binding affects the
3324 global value of the variable) and BUFFER tells us which buffer was
3325 current (i.e. if WHERE is non-nil, then BUFFER==WHERE, otherwise
3326 BUFFER did not yet have a buffer-local value). */
3329 specbind (Lisp_Object symbol
, Lisp_Object value
)
3331 struct Lisp_Symbol
*sym
;
3333 eassert (!handling_signal
);
3335 CHECK_SYMBOL (symbol
);
3336 sym
= XSYMBOL (symbol
);
3337 if (specpdl_ptr
== specpdl
+ specpdl_size
)
3341 switch (sym
->redirect
)
3343 case SYMBOL_VARALIAS
:
3344 sym
= indirect_variable (sym
); XSETSYMBOL (symbol
, sym
); goto start
;
3345 case SYMBOL_PLAINVAL
:
3346 /* The most common case is that of a non-constant symbol with a
3347 trivial value. Make that as fast as we can. */
3348 specpdl_ptr
->symbol
= symbol
;
3349 specpdl_ptr
->old_value
= SYMBOL_VAL (sym
);
3350 specpdl_ptr
->func
= NULL
;
3353 SET_SYMBOL_VAL (sym
, value
);
3355 set_internal (symbol
, value
, Qnil
, 1);
3357 case SYMBOL_LOCALIZED
:
3358 if (SYMBOL_BLV (sym
)->frame_local
)
3359 error ("Frame-local vars cannot be let-bound");
3360 case SYMBOL_FORWARDED
:
3362 Lisp_Object ovalue
= find_symbol_value (symbol
);
3363 specpdl_ptr
->func
= 0;
3364 specpdl_ptr
->old_value
= ovalue
;
3366 eassert (sym
->redirect
!= SYMBOL_LOCALIZED
3367 || (EQ (SYMBOL_BLV (sym
)->where
,
3368 SYMBOL_BLV (sym
)->frame_local
?
3369 Fselected_frame () : Fcurrent_buffer ())));
3371 if (sym
->redirect
== SYMBOL_LOCALIZED
3372 || BUFFER_OBJFWDP (SYMBOL_FWD (sym
)))
3374 Lisp_Object where
, cur_buf
= Fcurrent_buffer ();
3376 /* For a local variable, record both the symbol and which
3377 buffer's or frame's value we are saving. */
3378 if (!NILP (Flocal_variable_p (symbol
, Qnil
)))
3380 eassert (sym
->redirect
!= SYMBOL_LOCALIZED
3381 || (BLV_FOUND (SYMBOL_BLV (sym
))
3382 && EQ (cur_buf
, SYMBOL_BLV (sym
)->where
)));
3385 else if (sym
->redirect
== SYMBOL_LOCALIZED
3386 && BLV_FOUND (SYMBOL_BLV (sym
)))
3387 where
= SYMBOL_BLV (sym
)->where
;
3391 /* We're not using the `unused' slot in the specbinding
3392 structure because this would mean we have to do more
3393 work for simple variables. */
3394 /* FIXME: The third value `current_buffer' is only used in
3395 let_shadows_buffer_binding_p which is itself only used
3396 in set_internal for local_if_set. */
3397 eassert (NILP (where
) || EQ (where
, cur_buf
));
3398 specpdl_ptr
->symbol
= Fcons (symbol
, Fcons (where
, cur_buf
));
3400 /* If SYMBOL is a per-buffer variable which doesn't have a
3401 buffer-local value here, make the `let' change the global
3402 value by changing the value of SYMBOL in all buffers not
3403 having their own value. This is consistent with what
3404 happens with other buffer-local variables. */
3406 && sym
->redirect
== SYMBOL_FORWARDED
)
3408 eassert (BUFFER_OBJFWDP (SYMBOL_FWD (sym
)));
3410 Fset_default (symbol
, value
);
3415 specpdl_ptr
->symbol
= symbol
;
3418 set_internal (symbol
, value
, Qnil
, 1);
3426 record_unwind_protect (Lisp_Object (*function
) (Lisp_Object
), Lisp_Object arg
)
3428 eassert (!handling_signal
);
3430 if (specpdl_ptr
== specpdl
+ specpdl_size
)
3432 specpdl_ptr
->func
= function
;
3433 specpdl_ptr
->symbol
= Qnil
;
3434 specpdl_ptr
->old_value
= arg
;
3439 unbind_to (int count
, Lisp_Object value
)
3441 Lisp_Object quitf
= Vquit_flag
;
3442 struct gcpro gcpro1
, gcpro2
;
3444 GCPRO2 (value
, quitf
);
3447 while (specpdl_ptr
!= specpdl
+ count
)
3449 /* Copy the binding, and decrement specpdl_ptr, before we do
3450 the work to unbind it. We decrement first
3451 so that an error in unbinding won't try to unbind
3452 the same entry again, and we copy the binding first
3453 in case more bindings are made during some of the code we run. */
3455 struct specbinding this_binding
;
3456 this_binding
= *--specpdl_ptr
;
3458 if (this_binding
.func
!= 0)
3459 (*this_binding
.func
) (this_binding
.old_value
);
3460 /* If the symbol is a list, it is really (SYMBOL WHERE
3461 . CURRENT-BUFFER) where WHERE is either nil, a buffer, or a
3462 frame. If WHERE is a buffer or frame, this indicates we
3463 bound a variable that had a buffer-local or frame-local
3464 binding. WHERE nil means that the variable had the default
3465 value when it was bound. CURRENT-BUFFER is the buffer that
3466 was current when the variable was bound. */
3467 else if (CONSP (this_binding
.symbol
))
3469 Lisp_Object symbol
, where
;
3471 symbol
= XCAR (this_binding
.symbol
);
3472 where
= XCAR (XCDR (this_binding
.symbol
));
3475 Fset_default (symbol
, this_binding
.old_value
);
3476 /* If `where' is non-nil, reset the value in the appropriate
3477 local binding, but only if that binding still exists. */
3478 else if (BUFFERP (where
)
3479 ? !NILP (Flocal_variable_p (symbol
, where
))
3480 : !NILP (Fassq (symbol
, XFRAME (where
)->param_alist
)))
3481 set_internal (symbol
, this_binding
.old_value
, where
, 1);
3483 /* If variable has a trivial value (no forwarding), we can
3484 just set it. No need to check for constant symbols here,
3485 since that was already done by specbind. */
3486 else if (XSYMBOL (this_binding
.symbol
)->redirect
== SYMBOL_PLAINVAL
)
3487 SET_SYMBOL_VAL (XSYMBOL (this_binding
.symbol
),
3488 this_binding
.old_value
);
3490 /* NOTE: we only ever come here if make_local_foo was used for
3491 the first time on this var within this let. */
3492 Fset_default (this_binding
.symbol
, this_binding
.old_value
);
3495 if (NILP (Vquit_flag
) && !NILP (quitf
))
3502 DEFUN ("special-variable-p", Fspecial_variable_p
, Sspecial_variable_p
, 1, 1, 0,
3503 doc
: /* Return non-nil if SYMBOL's global binding has been declared special.
3504 A special variable is one that will be bound dynamically, even in a
3505 context where binding is lexical by default. */)
3506 (Lisp_Object symbol
)
3508 CHECK_SYMBOL (symbol
);
3509 return XSYMBOL (symbol
)->declared_special
? Qt
: Qnil
;
3513 DEFUN ("backtrace-debug", Fbacktrace_debug
, Sbacktrace_debug
, 2, 2, 0,
3514 doc
: /* Set the debug-on-exit flag of eval frame LEVEL levels down to FLAG.
3515 The debugger is entered when that frame exits, if the flag is non-nil. */)
3516 (Lisp_Object level
, Lisp_Object flag
)
3518 register struct backtrace
*backlist
= backtrace_list
;
3521 CHECK_NUMBER (level
);
3523 for (i
= 0; backlist
&& i
< XINT (level
); i
++)
3525 backlist
= backlist
->next
;
3529 backlist
->debug_on_exit
= !NILP (flag
);
3534 DEFUN ("backtrace", Fbacktrace
, Sbacktrace
, 0, 0, "",
3535 doc
: /* Print a trace of Lisp function calls currently active.
3536 Output stream used is value of `standard-output'. */)
3539 register struct backtrace
*backlist
= backtrace_list
;
3542 struct gcpro gcpro1
;
3543 Lisp_Object old_print_level
= Vprint_level
;
3545 if (NILP (Vprint_level
))
3546 XSETFASTINT (Vprint_level
, 8);
3553 write_string (backlist
->debug_on_exit
? "* " : " ", 2);
3554 if (backlist
->nargs
== UNEVALLED
)
3556 Fprin1 (Fcons (*backlist
->function
, *backlist
->args
), Qnil
);
3557 write_string ("\n", -1);
3561 tem
= *backlist
->function
;
3562 Fprin1 (tem
, Qnil
); /* This can QUIT. */
3563 write_string ("(", -1);
3564 if (backlist
->nargs
== MANY
)
3565 { /* FIXME: Can this happen? */
3567 for (tail
= *backlist
->args
, i
= 0;
3569 tail
= Fcdr (tail
), i
= 1)
3571 if (i
) write_string (" ", -1);
3572 Fprin1 (Fcar (tail
), Qnil
);
3578 for (i
= 0; i
< backlist
->nargs
; i
++)
3580 if (i
) write_string (" ", -1);
3581 Fprin1 (backlist
->args
[i
], Qnil
);
3584 write_string (")\n", -1);
3586 backlist
= backlist
->next
;
3589 Vprint_level
= old_print_level
;
3594 DEFUN ("backtrace-frame", Fbacktrace_frame
, Sbacktrace_frame
, 1, 1, NULL
,
3595 doc
: /* Return the function and arguments NFRAMES up from current execution point.
3596 If that frame has not evaluated the arguments yet (or is a special form),
3597 the value is (nil FUNCTION ARG-FORMS...).
3598 If that frame has evaluated its arguments and called its function already,
3599 the value is (t FUNCTION ARG-VALUES...).
3600 A &rest arg is represented as the tail of the list ARG-VALUES.
3601 FUNCTION is whatever was supplied as car of evaluated list,
3602 or a lambda expression for macro calls.
3603 If NFRAMES is more than the number of frames, the value is nil. */)
3604 (Lisp_Object nframes
)
3606 register struct backtrace
*backlist
= backtrace_list
;
3607 register EMACS_INT i
;
3610 CHECK_NATNUM (nframes
);
3612 /* Find the frame requested. */
3613 for (i
= 0; backlist
&& i
< XFASTINT (nframes
); i
++)
3614 backlist
= backlist
->next
;
3618 if (backlist
->nargs
== UNEVALLED
)
3619 return Fcons (Qnil
, Fcons (*backlist
->function
, *backlist
->args
));
3622 if (backlist
->nargs
== MANY
) /* FIXME: Can this happen? */
3623 tem
= *backlist
->args
;
3625 tem
= Flist (backlist
->nargs
, backlist
->args
);
3627 return Fcons (Qt
, Fcons (*backlist
->function
, tem
));
3633 mark_backtrace (void)
3635 register struct backtrace
*backlist
;
3638 for (backlist
= backtrace_list
; backlist
; backlist
= backlist
->next
)
3640 mark_object (*backlist
->function
);
3642 if (backlist
->nargs
== UNEVALLED
3643 || backlist
->nargs
== MANY
) /* FIXME: Can this happen? */
3646 i
= backlist
->nargs
;
3648 mark_object (backlist
->args
[i
]);
3655 DEFVAR_INT ("max-specpdl-size", max_specpdl_size
,
3656 doc
: /* *Limit on number of Lisp variable bindings and `unwind-protect's.
3657 If Lisp code tries to increase the total number past this amount,
3658 an error is signaled.
3659 You can safely use a value considerably larger than the default value,
3660 if that proves inconveniently small. However, if you increase it too far,
3661 Emacs could run out of memory trying to make the stack bigger. */);
3663 DEFVAR_INT ("max-lisp-eval-depth", max_lisp_eval_depth
,
3664 doc
: /* *Limit on depth in `eval', `apply' and `funcall' before error.
3666 This limit serves to catch infinite recursions for you before they cause
3667 actual stack overflow in C, which would be fatal for Emacs.
3668 You can safely make it considerably larger than its default value,
3669 if that proves inconveniently small. However, if you increase it too far,
3670 Emacs could overflow the real C stack, and crash. */);
3672 DEFVAR_LISP ("quit-flag", Vquit_flag
,
3673 doc
: /* Non-nil causes `eval' to abort, unless `inhibit-quit' is non-nil.
3674 If the value is t, that means do an ordinary quit.
3675 If the value equals `throw-on-input', that means quit by throwing
3676 to the tag specified in `throw-on-input'; it's for handling `while-no-input'.
3677 Typing C-g sets `quit-flag' to t, regardless of `inhibit-quit',
3678 but `inhibit-quit' non-nil prevents anything from taking notice of that. */);
3681 DEFVAR_LISP ("inhibit-quit", Vinhibit_quit
,
3682 doc
: /* Non-nil inhibits C-g quitting from happening immediately.
3683 Note that `quit-flag' will still be set by typing C-g,
3684 so a quit will be signaled as soon as `inhibit-quit' is nil.
3685 To prevent this happening, set `quit-flag' to nil
3686 before making `inhibit-quit' nil. */);
3687 Vinhibit_quit
= Qnil
;
3689 Qinhibit_quit
= intern_c_string ("inhibit-quit");
3690 staticpro (&Qinhibit_quit
);
3692 Qautoload
= intern_c_string ("autoload");
3693 staticpro (&Qautoload
);
3695 Qdebug_on_error
= intern_c_string ("debug-on-error");
3696 staticpro (&Qdebug_on_error
);
3698 Qmacro
= intern_c_string ("macro");
3699 staticpro (&Qmacro
);
3701 Qdeclare
= intern_c_string ("declare");
3702 staticpro (&Qdeclare
);
3704 /* Note that the process handling also uses Qexit, but we don't want
3705 to staticpro it twice, so we just do it here. */
3706 Qexit
= intern_c_string ("exit");
3709 Qinteractive
= intern_c_string ("interactive");
3710 staticpro (&Qinteractive
);
3712 Qcommandp
= intern_c_string ("commandp");
3713 staticpro (&Qcommandp
);
3715 Qdefun
= intern_c_string ("defun");
3716 staticpro (&Qdefun
);
3718 Qand_rest
= intern_c_string ("&rest");
3719 staticpro (&Qand_rest
);
3721 Qand_optional
= intern_c_string ("&optional");
3722 staticpro (&Qand_optional
);
3724 Qclosure
= intern_c_string ("closure");
3725 staticpro (&Qclosure
);
3727 Qdebug
= intern_c_string ("debug");
3728 staticpro (&Qdebug
);
3730 DEFVAR_LISP ("debug-on-error", Vdebug_on_error
,
3731 doc
: /* *Non-nil means enter debugger if an error is signaled.
3732 Does not apply to errors handled by `condition-case' or those
3733 matched by `debug-ignored-errors'.
3734 If the value is a list, an error only means to enter the debugger
3735 if one of its condition symbols appears in the list.
3736 When you evaluate an expression interactively, this variable
3737 is temporarily non-nil if `eval-expression-debug-on-error' is non-nil.
3738 The command `toggle-debug-on-error' toggles this.
3739 See also the variable `debug-on-quit'. */);
3740 Vdebug_on_error
= Qnil
;
3742 DEFVAR_LISP ("debug-ignored-errors", Vdebug_ignored_errors
,
3743 doc
: /* *List of errors for which the debugger should not be called.
3744 Each element may be a condition-name or a regexp that matches error messages.
3745 If any element applies to a given error, that error skips the debugger
3746 and just returns to top level.
3747 This overrides the variable `debug-on-error'.
3748 It does not apply to errors handled by `condition-case'. */);
3749 Vdebug_ignored_errors
= Qnil
;
3751 DEFVAR_BOOL ("debug-on-quit", debug_on_quit
,
3752 doc
: /* *Non-nil means enter debugger if quit is signaled (C-g, for example).
3753 Does not apply if quit is handled by a `condition-case'. */);
3756 DEFVAR_BOOL ("debug-on-next-call", debug_on_next_call
,
3757 doc
: /* Non-nil means enter debugger before next `eval', `apply' or `funcall'. */);
3759 DEFVAR_BOOL ("debugger-may-continue", debugger_may_continue
,
3760 doc
: /* Non-nil means debugger may continue execution.
3761 This is nil when the debugger is called under circumstances where it
3762 might not be safe to continue. */);
3763 debugger_may_continue
= 1;
3765 DEFVAR_LISP ("debugger", Vdebugger
,
3766 doc
: /* Function to call to invoke debugger.
3767 If due to frame exit, args are `exit' and the value being returned;
3768 this function's value will be returned instead of that.
3769 If due to error, args are `error' and a list of the args to `signal'.
3770 If due to `apply' or `funcall' entry, one arg, `lambda'.
3771 If due to `eval' entry, one arg, t. */);
3774 DEFVAR_LISP ("signal-hook-function", Vsignal_hook_function
,
3775 doc
: /* If non-nil, this is a function for `signal' to call.
3776 It receives the same arguments that `signal' was given.
3777 The Edebug package uses this to regain control. */);
3778 Vsignal_hook_function
= Qnil
;
3780 DEFVAR_LISP ("debug-on-signal", Vdebug_on_signal
,
3781 doc
: /* *Non-nil means call the debugger regardless of condition handlers.
3782 Note that `debug-on-error', `debug-on-quit' and friends
3783 still determine whether to handle the particular condition. */);
3784 Vdebug_on_signal
= Qnil
;
3786 DEFVAR_LISP ("macro-declaration-function", Vmacro_declaration_function
,
3787 doc
: /* Function to process declarations in a macro definition.
3788 The function will be called with two args MACRO and DECL.
3789 MACRO is the name of the macro being defined.
3790 DECL is a list `(declare ...)' containing the declarations.
3791 The value the function returns is not used. */);
3792 Vmacro_declaration_function
= Qnil
;
3794 /* When lexical binding is being used,
3795 vinternal_interpreter_environment is non-nil, and contains an alist
3796 of lexically-bound variable, or (t), indicating an empty
3797 environment. The lisp name of this variable would be
3798 `internal-interpreter-environment' if it weren't hidden.
3799 Every element of this list can be either a cons (VAR . VAL)
3800 specifying a lexical binding, or a single symbol VAR indicating
3801 that this variable should use dynamic scoping. */
3802 Qinternal_interpreter_environment
3803 = intern_c_string ("internal-interpreter-environment");
3804 staticpro (&Qinternal_interpreter_environment
);
3805 DEFVAR_LISP ("internal-interpreter-environment",
3806 Vinternal_interpreter_environment
,
3807 doc
: /* If non-nil, the current lexical environment of the lisp interpreter.
3808 When lexical binding is not being used, this variable is nil.
3809 A value of `(t)' indicates an empty environment, otherwise it is an
3810 alist of active lexical bindings. */);
3811 Vinternal_interpreter_environment
= Qnil
;
3812 /* Don't export this variable to Elisp, so noone can mess with it
3813 (Just imagine if someone makes it buffer-local). */
3814 Funintern (Qinternal_interpreter_environment
, Qnil
);
3816 Vrun_hooks
= intern_c_string ("run-hooks");
3817 staticpro (&Vrun_hooks
);
3819 staticpro (&Vautoload_queue
);
3820 Vautoload_queue
= Qnil
;
3821 staticpro (&Vsignaling_function
);
3822 Vsignaling_function
= Qnil
;
3833 defsubr (&Sfunction
);
3835 defsubr (&Sdefmacro
);
3837 defsubr (&Sdefvaralias
);
3838 defsubr (&Sdefconst
);
3839 defsubr (&Suser_variable_p
);
3843 defsubr (&Smacroexpand
);
3846 defsubr (&Sunwind_protect
);
3847 defsubr (&Scondition_case
);
3849 defsubr (&Sinteractive_p
);
3850 defsubr (&Scalled_interactively_p
);
3851 defsubr (&Scommandp
);
3852 defsubr (&Sautoload
);
3855 defsubr (&Sfuncall
);
3856 defsubr (&Srun_hooks
);
3857 defsubr (&Srun_hook_with_args
);
3858 defsubr (&Srun_hook_with_args_until_success
);
3859 defsubr (&Srun_hook_with_args_until_failure
);
3860 defsubr (&Srun_hook_wrapped
);
3861 defsubr (&Sfetch_bytecode
);
3862 defsubr (&Sbacktrace_debug
);
3863 defsubr (&Sbacktrace
);
3864 defsubr (&Sbacktrace_frame
);
3865 defsubr (&Sspecial_variable_p
);
3866 defsubr (&Sfunctionp
);