Use gnulib's alloca-opt module.
[emacs.git] / src / data.c
blobcf01d38036d248f92cb1a0e0c6b4a25c0312873d
1 /* Primitive operations on Lisp data types for GNU Emacs Lisp interpreter.
2 Copyright (C) 1985-1986, 1988, 1993-1995, 1997-2011
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 #include <config.h>
22 #include <signal.h>
23 #include <stdio.h>
24 #include <setjmp.h>
26 #include <intprops.h>
28 #include "lisp.h"
29 #include "puresize.h"
30 #include "character.h"
31 #include "buffer.h"
32 #include "keyboard.h"
33 #include "frame.h"
34 #include "syssignal.h"
35 #include "termhooks.h" /* For FRAME_KBOARD reference in y-or-n-p. */
36 #include "font.h"
38 #ifdef STDC_HEADERS
39 #include <float.h>
40 #endif
42 /* If IEEE_FLOATING_POINT isn't defined, default it from FLT_*. */
43 #ifndef IEEE_FLOATING_POINT
44 #if (FLT_RADIX == 2 && FLT_MANT_DIG == 24 \
45 && FLT_MIN_EXP == -125 && FLT_MAX_EXP == 128)
46 #define IEEE_FLOATING_POINT 1
47 #else
48 #define IEEE_FLOATING_POINT 0
49 #endif
50 #endif
52 #include <math.h>
54 Lisp_Object Qnil, Qt, Qquote, Qlambda, Qunbound;
55 static Lisp_Object Qsubr;
56 Lisp_Object Qerror_conditions, Qerror_message, Qtop_level;
57 Lisp_Object Qerror, Qquit, Qargs_out_of_range;
58 static Lisp_Object Qwrong_type_argument;
59 Lisp_Object Qvoid_variable, Qvoid_function;
60 static Lisp_Object Qcyclic_function_indirection;
61 static Lisp_Object Qcyclic_variable_indirection;
62 Lisp_Object Qcircular_list;
63 static Lisp_Object Qsetting_constant;
64 Lisp_Object Qinvalid_read_syntax;
65 Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
66 Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
67 Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
68 Lisp_Object Qtext_read_only;
70 Lisp_Object Qintegerp, Qwholenump, Qsymbolp, Qlistp, Qconsp;
71 static Lisp_Object Qnatnump;
72 Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp;
73 Lisp_Object Qchar_or_string_p, Qmarkerp, Qinteger_or_marker_p, Qvectorp;
74 Lisp_Object Qbuffer_or_string_p;
75 static Lisp_Object Qkeywordp, Qboundp;
76 Lisp_Object Qfboundp;
77 Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
79 Lisp_Object Qcdr;
80 static Lisp_Object Qad_advice_info, Qad_activate_internal;
82 Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
83 Lisp_Object Qoverflow_error, Qunderflow_error;
85 Lisp_Object Qfloatp;
86 Lisp_Object Qnumberp, Qnumber_or_marker_p;
88 Lisp_Object Qinteger;
89 static Lisp_Object Qsymbol, Qstring, Qcons, Qmarker, Qoverlay;
90 Lisp_Object Qwindow;
91 static Lisp_Object Qfloat, Qwindow_configuration;
92 static Lisp_Object Qprocess;
93 static Lisp_Object Qcompiled_function, Qframe, Qvector;
94 Lisp_Object Qbuffer;
95 static Lisp_Object Qchar_table, Qbool_vector, Qhash_table;
96 static Lisp_Object Qsubrp, Qmany, Qunevalled;
97 Lisp_Object Qfont_spec, Qfont_entity, Qfont_object;
99 Lisp_Object Qinteractive_form;
101 static void swap_in_symval_forwarding (struct Lisp_Symbol *, struct Lisp_Buffer_Local_Value *);
104 Lisp_Object
105 wrong_type_argument (register Lisp_Object predicate, register Lisp_Object value)
107 /* If VALUE is not even a valid Lisp object, we'd want to abort here
108 where we can get a backtrace showing where it came from. We used
109 to try and do that by checking the tagbits, but nowadays all
110 tagbits are potentially valid. */
111 /* if ((unsigned int) XTYPE (value) >= Lisp_Type_Limit)
112 * abort (); */
114 xsignal2 (Qwrong_type_argument, predicate, value);
117 void
118 pure_write_error (void)
120 error ("Attempt to modify read-only object");
123 void
124 args_out_of_range (Lisp_Object a1, Lisp_Object a2)
126 xsignal2 (Qargs_out_of_range, a1, a2);
129 void
130 args_out_of_range_3 (Lisp_Object a1, Lisp_Object a2, Lisp_Object a3)
132 xsignal3 (Qargs_out_of_range, a1, a2, a3);
136 /* Data type predicates */
138 DEFUN ("eq", Feq, Seq, 2, 2, 0,
139 doc: /* Return t if the two args are the same Lisp object. */)
140 (Lisp_Object obj1, Lisp_Object obj2)
142 if (EQ (obj1, obj2))
143 return Qt;
144 return Qnil;
147 DEFUN ("null", Fnull, Snull, 1, 1, 0,
148 doc: /* Return t if OBJECT is nil. */)
149 (Lisp_Object object)
151 if (NILP (object))
152 return Qt;
153 return Qnil;
156 DEFUN ("type-of", Ftype_of, Stype_of, 1, 1, 0,
157 doc: /* Return a symbol representing the type of OBJECT.
158 The symbol returned names the object's basic type;
159 for example, (type-of 1) returns `integer'. */)
160 (Lisp_Object object)
162 switch (XTYPE (object))
164 case_Lisp_Int:
165 return Qinteger;
167 case Lisp_Symbol:
168 return Qsymbol;
170 case Lisp_String:
171 return Qstring;
173 case Lisp_Cons:
174 return Qcons;
176 case Lisp_Misc:
177 switch (XMISCTYPE (object))
179 case Lisp_Misc_Marker:
180 return Qmarker;
181 case Lisp_Misc_Overlay:
182 return Qoverlay;
183 case Lisp_Misc_Float:
184 return Qfloat;
186 abort ();
188 case Lisp_Vectorlike:
189 if (WINDOW_CONFIGURATIONP (object))
190 return Qwindow_configuration;
191 if (PROCESSP (object))
192 return Qprocess;
193 if (WINDOWP (object))
194 return Qwindow;
195 if (SUBRP (object))
196 return Qsubr;
197 if (COMPILEDP (object))
198 return Qcompiled_function;
199 if (BUFFERP (object))
200 return Qbuffer;
201 if (CHAR_TABLE_P (object))
202 return Qchar_table;
203 if (BOOL_VECTOR_P (object))
204 return Qbool_vector;
205 if (FRAMEP (object))
206 return Qframe;
207 if (HASH_TABLE_P (object))
208 return Qhash_table;
209 if (FONT_SPEC_P (object))
210 return Qfont_spec;
211 if (FONT_ENTITY_P (object))
212 return Qfont_entity;
213 if (FONT_OBJECT_P (object))
214 return Qfont_object;
215 return Qvector;
217 case Lisp_Float:
218 return Qfloat;
220 default:
221 abort ();
225 DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0,
226 doc: /* Return t if OBJECT is a cons cell. */)
227 (Lisp_Object object)
229 if (CONSP (object))
230 return Qt;
231 return Qnil;
234 DEFUN ("atom", Fatom, Satom, 1, 1, 0,
235 doc: /* Return t if OBJECT is not a cons cell. This includes nil. */)
236 (Lisp_Object object)
238 if (CONSP (object))
239 return Qnil;
240 return Qt;
243 DEFUN ("listp", Flistp, Slistp, 1, 1, 0,
244 doc: /* Return t if OBJECT is a list, that is, a cons cell or nil.
245 Otherwise, return nil. */)
246 (Lisp_Object object)
248 if (CONSP (object) || NILP (object))
249 return Qt;
250 return Qnil;
253 DEFUN ("nlistp", Fnlistp, Snlistp, 1, 1, 0,
254 doc: /* Return t if OBJECT is not a list. Lists include nil. */)
255 (Lisp_Object object)
257 if (CONSP (object) || NILP (object))
258 return Qnil;
259 return Qt;
262 DEFUN ("symbolp", Fsymbolp, Ssymbolp, 1, 1, 0,
263 doc: /* Return t if OBJECT is a symbol. */)
264 (Lisp_Object object)
266 if (SYMBOLP (object))
267 return Qt;
268 return Qnil;
271 /* Define this in C to avoid unnecessarily consing up the symbol
272 name. */
273 DEFUN ("keywordp", Fkeywordp, Skeywordp, 1, 1, 0,
274 doc: /* Return t if OBJECT is a keyword.
275 This means that it is a symbol with a print name beginning with `:'
276 interned in the initial obarray. */)
277 (Lisp_Object object)
279 if (SYMBOLP (object)
280 && SREF (SYMBOL_NAME (object), 0) == ':'
281 && SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P (object))
282 return Qt;
283 return Qnil;
286 DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
287 doc: /* Return t if OBJECT is a vector. */)
288 (Lisp_Object object)
290 if (VECTORP (object))
291 return Qt;
292 return Qnil;
295 DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
296 doc: /* Return t if OBJECT is a string. */)
297 (Lisp_Object object)
299 if (STRINGP (object))
300 return Qt;
301 return Qnil;
304 DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p,
305 1, 1, 0,
306 doc: /* Return t if OBJECT is a multibyte string. */)
307 (Lisp_Object object)
309 if (STRINGP (object) && STRING_MULTIBYTE (object))
310 return Qt;
311 return Qnil;
314 DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0,
315 doc: /* Return t if OBJECT is a char-table. */)
316 (Lisp_Object object)
318 if (CHAR_TABLE_P (object))
319 return Qt;
320 return Qnil;
323 DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p,
324 Svector_or_char_table_p, 1, 1, 0,
325 doc: /* Return t if OBJECT is a char-table or vector. */)
326 (Lisp_Object object)
328 if (VECTORP (object) || CHAR_TABLE_P (object))
329 return Qt;
330 return Qnil;
333 DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0,
334 doc: /* Return t if OBJECT is a bool-vector. */)
335 (Lisp_Object object)
337 if (BOOL_VECTOR_P (object))
338 return Qt;
339 return Qnil;
342 DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0,
343 doc: /* Return t if OBJECT is an array (string or vector). */)
344 (Lisp_Object object)
346 if (ARRAYP (object))
347 return Qt;
348 return Qnil;
351 DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
352 doc: /* Return t if OBJECT is a sequence (list or array). */)
353 (register Lisp_Object object)
355 if (CONSP (object) || NILP (object) || ARRAYP (object))
356 return Qt;
357 return Qnil;
360 DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0,
361 doc: /* Return t if OBJECT is an editor buffer. */)
362 (Lisp_Object object)
364 if (BUFFERP (object))
365 return Qt;
366 return Qnil;
369 DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0,
370 doc: /* Return t if OBJECT is a marker (editor pointer). */)
371 (Lisp_Object object)
373 if (MARKERP (object))
374 return Qt;
375 return Qnil;
378 DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0,
379 doc: /* Return t if OBJECT is a built-in function. */)
380 (Lisp_Object object)
382 if (SUBRP (object))
383 return Qt;
384 return Qnil;
387 DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
388 1, 1, 0,
389 doc: /* Return t if OBJECT is a byte-compiled function object. */)
390 (Lisp_Object object)
392 if (COMPILEDP (object))
393 return Qt;
394 return Qnil;
397 DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0,
398 doc: /* Return t if OBJECT is a character or a string. */)
399 (register Lisp_Object object)
401 if (CHARACTERP (object) || STRINGP (object))
402 return Qt;
403 return Qnil;
406 DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0,
407 doc: /* Return t if OBJECT is an integer. */)
408 (Lisp_Object object)
410 if (INTEGERP (object))
411 return Qt;
412 return Qnil;
415 DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0,
416 doc: /* Return t if OBJECT is an integer or a marker (editor pointer). */)
417 (register Lisp_Object object)
419 if (MARKERP (object) || INTEGERP (object))
420 return Qt;
421 return Qnil;
424 DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
425 doc: /* Return t if OBJECT is a nonnegative integer. */)
426 (Lisp_Object object)
428 if (NATNUMP (object))
429 return Qt;
430 return Qnil;
433 DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
434 doc: /* Return t if OBJECT is a number (floating point or integer). */)
435 (Lisp_Object object)
437 if (NUMBERP (object))
438 return Qt;
439 else
440 return Qnil;
443 DEFUN ("number-or-marker-p", Fnumber_or_marker_p,
444 Snumber_or_marker_p, 1, 1, 0,
445 doc: /* Return t if OBJECT is a number or a marker. */)
446 (Lisp_Object object)
448 if (NUMBERP (object) || MARKERP (object))
449 return Qt;
450 return Qnil;
453 DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
454 doc: /* Return t if OBJECT is a floating point number. */)
455 (Lisp_Object object)
457 if (FLOATP (object))
458 return Qt;
459 return Qnil;
463 /* Extract and set components of lists */
465 DEFUN ("car", Fcar, Scar, 1, 1, 0,
466 doc: /* Return the car of LIST. If arg is nil, return nil.
467 Error if arg is not nil and not a cons cell. See also `car-safe'.
469 See Info node `(elisp)Cons Cells' for a discussion of related basic
470 Lisp concepts such as car, cdr, cons cell and list. */)
471 (register Lisp_Object list)
473 return CAR (list);
476 DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0,
477 doc: /* Return the car of OBJECT if it is a cons cell, or else nil. */)
478 (Lisp_Object object)
480 return CAR_SAFE (object);
483 DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
484 doc: /* Return the cdr of LIST. If arg is nil, return nil.
485 Error if arg is not nil and not a cons cell. See also `cdr-safe'.
487 See Info node `(elisp)Cons Cells' for a discussion of related basic
488 Lisp concepts such as cdr, car, cons cell and list. */)
489 (register Lisp_Object list)
491 return CDR (list);
494 DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0,
495 doc: /* Return the cdr of OBJECT if it is a cons cell, or else nil. */)
496 (Lisp_Object object)
498 return CDR_SAFE (object);
501 DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
502 doc: /* Set the car of CELL to be NEWCAR. Returns NEWCAR. */)
503 (register Lisp_Object cell, Lisp_Object newcar)
505 CHECK_CONS (cell);
506 CHECK_IMPURE (cell);
507 XSETCAR (cell, newcar);
508 return newcar;
511 DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
512 doc: /* Set the cdr of CELL to be NEWCDR. Returns NEWCDR. */)
513 (register Lisp_Object cell, Lisp_Object newcdr)
515 CHECK_CONS (cell);
516 CHECK_IMPURE (cell);
517 XSETCDR (cell, newcdr);
518 return newcdr;
521 /* Extract and set components of symbols */
523 DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0,
524 doc: /* Return t if SYMBOL's value is not void. */)
525 (register Lisp_Object symbol)
527 Lisp_Object valcontents;
528 struct Lisp_Symbol *sym;
529 CHECK_SYMBOL (symbol);
530 sym = XSYMBOL (symbol);
532 start:
533 switch (sym->redirect)
535 case SYMBOL_PLAINVAL: valcontents = SYMBOL_VAL (sym); break;
536 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
537 case SYMBOL_LOCALIZED:
539 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
540 if (blv->fwd)
541 /* In set_internal, we un-forward vars when their value is
542 set to Qunbound. */
543 return Qt;
544 else
546 swap_in_symval_forwarding (sym, blv);
547 valcontents = BLV_VALUE (blv);
549 break;
551 case SYMBOL_FORWARDED:
552 /* In set_internal, we un-forward vars when their value is
553 set to Qunbound. */
554 return Qt;
555 default: abort ();
558 return (EQ (valcontents, Qunbound) ? Qnil : Qt);
561 DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0,
562 doc: /* Return t if SYMBOL's function definition is not void. */)
563 (register Lisp_Object symbol)
565 CHECK_SYMBOL (symbol);
566 return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
569 DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0,
570 doc: /* Make SYMBOL's value be void.
571 Return SYMBOL. */)
572 (register Lisp_Object symbol)
574 CHECK_SYMBOL (symbol);
575 if (SYMBOL_CONSTANT_P (symbol))
576 xsignal1 (Qsetting_constant, symbol);
577 Fset (symbol, Qunbound);
578 return symbol;
581 DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0,
582 doc: /* Make SYMBOL's function definition be void.
583 Return SYMBOL. */)
584 (register Lisp_Object symbol)
586 CHECK_SYMBOL (symbol);
587 if (NILP (symbol) || EQ (symbol, Qt))
588 xsignal1 (Qsetting_constant, symbol);
589 XSYMBOL (symbol)->function = Qunbound;
590 return symbol;
593 DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0,
594 doc: /* Return SYMBOL's function definition. Error if that is void. */)
595 (register Lisp_Object symbol)
597 CHECK_SYMBOL (symbol);
598 if (!EQ (XSYMBOL (symbol)->function, Qunbound))
599 return XSYMBOL (symbol)->function;
600 xsignal1 (Qvoid_function, symbol);
603 DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0,
604 doc: /* Return SYMBOL's property list. */)
605 (register Lisp_Object symbol)
607 CHECK_SYMBOL (symbol);
608 return XSYMBOL (symbol)->plist;
611 DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0,
612 doc: /* Return SYMBOL's name, a string. */)
613 (register Lisp_Object symbol)
615 register Lisp_Object name;
617 CHECK_SYMBOL (symbol);
618 name = SYMBOL_NAME (symbol);
619 return name;
622 DEFUN ("fset", Ffset, Sfset, 2, 2, 0,
623 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION. */)
624 (register Lisp_Object symbol, Lisp_Object definition)
626 register Lisp_Object function;
628 CHECK_SYMBOL (symbol);
629 if (NILP (symbol) || EQ (symbol, Qt))
630 xsignal1 (Qsetting_constant, symbol);
632 function = XSYMBOL (symbol)->function;
634 if (!NILP (Vautoload_queue) && !EQ (function, Qunbound))
635 Vautoload_queue = Fcons (Fcons (symbol, function), Vautoload_queue);
637 if (CONSP (function) && EQ (XCAR (function), Qautoload))
638 Fput (symbol, Qautoload, XCDR (function));
640 XSYMBOL (symbol)->function = definition;
641 /* Handle automatic advice activation */
642 if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
644 call2 (Qad_activate_internal, symbol, Qnil);
645 definition = XSYMBOL (symbol)->function;
647 return definition;
650 DEFUN ("defalias", Fdefalias, Sdefalias, 2, 3, 0,
651 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION.
652 Associates the function with the current load file, if any.
653 The optional third argument DOCSTRING specifies the documentation string
654 for SYMBOL; if it is omitted or nil, SYMBOL uses the documentation string
655 determined by DEFINITION. */)
656 (register Lisp_Object symbol, Lisp_Object definition, Lisp_Object docstring)
658 CHECK_SYMBOL (symbol);
659 if (CONSP (XSYMBOL (symbol)->function)
660 && EQ (XCAR (XSYMBOL (symbol)->function), Qautoload))
661 LOADHIST_ATTACH (Fcons (Qt, symbol));
662 definition = Ffset (symbol, definition);
663 LOADHIST_ATTACH (Fcons (Qdefun, symbol));
664 if (!NILP (docstring))
665 Fput (symbol, Qfunction_documentation, docstring);
666 return definition;
669 DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
670 doc: /* Set SYMBOL's property list to NEWPLIST, and return NEWPLIST. */)
671 (register Lisp_Object symbol, Lisp_Object newplist)
673 CHECK_SYMBOL (symbol);
674 XSYMBOL (symbol)->plist = newplist;
675 return newplist;
678 DEFUN ("subr-arity", Fsubr_arity, Ssubr_arity, 1, 1, 0,
679 doc: /* Return minimum and maximum number of args allowed for SUBR.
680 SUBR must be a built-in function.
681 The returned value is a pair (MIN . MAX). MIN is the minimum number
682 of args. MAX is the maximum number or the symbol `many', for a
683 function with `&rest' args, or `unevalled' for a special form. */)
684 (Lisp_Object subr)
686 short minargs, maxargs;
687 CHECK_SUBR (subr);
688 minargs = XSUBR (subr)->min_args;
689 maxargs = XSUBR (subr)->max_args;
690 if (maxargs == MANY)
691 return Fcons (make_number (minargs), Qmany);
692 else if (maxargs == UNEVALLED)
693 return Fcons (make_number (minargs), Qunevalled);
694 else
695 return Fcons (make_number (minargs), make_number (maxargs));
698 DEFUN ("subr-name", Fsubr_name, Ssubr_name, 1, 1, 0,
699 doc: /* Return name of subroutine SUBR.
700 SUBR must be a built-in function. */)
701 (Lisp_Object subr)
703 const char *name;
704 CHECK_SUBR (subr);
705 name = XSUBR (subr)->symbol_name;
706 return make_string (name, strlen (name));
709 DEFUN ("interactive-form", Finteractive_form, Sinteractive_form, 1, 1, 0,
710 doc: /* Return the interactive form of CMD or nil if none.
711 If CMD is not a command, the return value is nil.
712 Value, if non-nil, is a list \(interactive SPEC). */)
713 (Lisp_Object cmd)
715 Lisp_Object fun = indirect_function (cmd); /* Check cycles. */
717 if (NILP (fun) || EQ (fun, Qunbound))
718 return Qnil;
720 /* Use an `interactive-form' property if present, analogous to the
721 function-documentation property. */
722 fun = cmd;
723 while (SYMBOLP (fun))
725 Lisp_Object tmp = Fget (fun, Qinteractive_form);
726 if (!NILP (tmp))
727 return tmp;
728 else
729 fun = Fsymbol_function (fun);
732 if (SUBRP (fun))
734 const char *spec = XSUBR (fun)->intspec;
735 if (spec)
736 return list2 (Qinteractive,
737 (*spec != '(') ? build_string (spec) :
738 Fcar (Fread_from_string (build_string (spec), Qnil, Qnil)));
740 else if (COMPILEDP (fun))
742 if ((ASIZE (fun) & PSEUDOVECTOR_SIZE_MASK) > COMPILED_INTERACTIVE)
743 return list2 (Qinteractive, AREF (fun, COMPILED_INTERACTIVE));
745 else if (CONSP (fun))
747 Lisp_Object funcar = XCAR (fun);
748 if (EQ (funcar, Qclosure))
749 return Fassq (Qinteractive, Fcdr (Fcdr (XCDR (fun))));
750 else if (EQ (funcar, Qlambda))
751 return Fassq (Qinteractive, Fcdr (XCDR (fun)));
752 else if (EQ (funcar, Qautoload))
754 struct gcpro gcpro1;
755 GCPRO1 (cmd);
756 do_autoload (fun, cmd);
757 UNGCPRO;
758 return Finteractive_form (cmd);
761 return Qnil;
765 /***********************************************************************
766 Getting and Setting Values of Symbols
767 ***********************************************************************/
769 /* Return the symbol holding SYMBOL's value. Signal
770 `cyclic-variable-indirection' if SYMBOL's chain of variable
771 indirections contains a loop. */
773 struct Lisp_Symbol *
774 indirect_variable (struct Lisp_Symbol *symbol)
776 struct Lisp_Symbol *tortoise, *hare;
778 hare = tortoise = symbol;
780 while (hare->redirect == SYMBOL_VARALIAS)
782 hare = SYMBOL_ALIAS (hare);
783 if (hare->redirect != SYMBOL_VARALIAS)
784 break;
786 hare = SYMBOL_ALIAS (hare);
787 tortoise = SYMBOL_ALIAS (tortoise);
789 if (hare == tortoise)
791 Lisp_Object tem;
792 XSETSYMBOL (tem, symbol);
793 xsignal1 (Qcyclic_variable_indirection, tem);
797 return hare;
801 DEFUN ("indirect-variable", Findirect_variable, Sindirect_variable, 1, 1, 0,
802 doc: /* Return the variable at the end of OBJECT's variable chain.
803 If OBJECT is a symbol, follow all variable indirections and return the final
804 variable. If OBJECT is not a symbol, just return it.
805 Signal a cyclic-variable-indirection error if there is a loop in the
806 variable chain of symbols. */)
807 (Lisp_Object object)
809 if (SYMBOLP (object))
811 struct Lisp_Symbol *sym = indirect_variable (XSYMBOL (object));
812 XSETSYMBOL (object, sym);
814 return object;
818 /* Given the raw contents of a symbol value cell,
819 return the Lisp value of the symbol.
820 This does not handle buffer-local variables; use
821 swap_in_symval_forwarding for that. */
823 Lisp_Object
824 do_symval_forwarding (register union Lisp_Fwd *valcontents)
826 register Lisp_Object val;
827 switch (XFWDTYPE (valcontents))
829 case Lisp_Fwd_Int:
830 XSETINT (val, *XINTFWD (valcontents)->intvar);
831 return val;
833 case Lisp_Fwd_Bool:
834 return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
836 case Lisp_Fwd_Obj:
837 return *XOBJFWD (valcontents)->objvar;
839 case Lisp_Fwd_Buffer_Obj:
840 return PER_BUFFER_VALUE (current_buffer,
841 XBUFFER_OBJFWD (valcontents)->offset);
843 case Lisp_Fwd_Kboard_Obj:
844 /* We used to simply use current_kboard here, but from Lisp
845 code, it's value is often unexpected. It seems nicer to
846 allow constructions like this to work as intuitively expected:
848 (with-selected-frame frame
849 (define-key local-function-map "\eOP" [f1]))
851 On the other hand, this affects the semantics of
852 last-command and real-last-command, and people may rely on
853 that. I took a quick look at the Lisp codebase, and I
854 don't think anything will break. --lorentey */
855 return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
856 + (char *)FRAME_KBOARD (SELECTED_FRAME ()));
857 default: abort ();
861 /* Store NEWVAL into SYMBOL, where VALCONTENTS is found in the value cell
862 of SYMBOL. If SYMBOL is buffer-local, VALCONTENTS should be the
863 buffer-independent contents of the value cell: forwarded just one
864 step past the buffer-localness.
866 BUF non-zero means set the value in buffer BUF instead of the
867 current buffer. This only plays a role for per-buffer variables. */
869 static void
870 store_symval_forwarding (union Lisp_Fwd *valcontents, register Lisp_Object newval, struct buffer *buf)
872 switch (XFWDTYPE (valcontents))
874 case Lisp_Fwd_Int:
875 CHECK_NUMBER (newval);
876 *XINTFWD (valcontents)->intvar = XINT (newval);
877 break;
879 case Lisp_Fwd_Bool:
880 *XBOOLFWD (valcontents)->boolvar = !NILP (newval);
881 break;
883 case Lisp_Fwd_Obj:
884 *XOBJFWD (valcontents)->objvar = newval;
886 /* If this variable is a default for something stored
887 in the buffer itself, such as default-fill-column,
888 find the buffers that don't have local values for it
889 and update them. */
890 if (XOBJFWD (valcontents)->objvar > (Lisp_Object *) &buffer_defaults
891 && XOBJFWD (valcontents)->objvar < (Lisp_Object *) (&buffer_defaults + 1))
893 int offset = ((char *) XOBJFWD (valcontents)->objvar
894 - (char *) &buffer_defaults);
895 int idx = PER_BUFFER_IDX (offset);
897 Lisp_Object tail;
899 if (idx <= 0)
900 break;
902 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
904 Lisp_Object lbuf;
905 struct buffer *b;
907 lbuf = Fcdr (XCAR (tail));
908 if (!BUFFERP (lbuf)) continue;
909 b = XBUFFER (lbuf);
911 if (! PER_BUFFER_VALUE_P (b, idx))
912 PER_BUFFER_VALUE (b, offset) = newval;
915 break;
917 case Lisp_Fwd_Buffer_Obj:
919 int offset = XBUFFER_OBJFWD (valcontents)->offset;
920 Lisp_Object type = XBUFFER_OBJFWD (valcontents)->slottype;
922 if (!(NILP (type) || NILP (newval)
923 || (XINT (type) == LISP_INT_TAG
924 ? INTEGERP (newval)
925 : XTYPE (newval) == XINT (type))))
926 buffer_slot_type_mismatch (newval, XINT (type));
928 if (buf == NULL)
929 buf = current_buffer;
930 PER_BUFFER_VALUE (buf, offset) = newval;
932 break;
934 case Lisp_Fwd_Kboard_Obj:
936 char *base = (char *) FRAME_KBOARD (SELECTED_FRAME ());
937 char *p = base + XKBOARD_OBJFWD (valcontents)->offset;
938 *(Lisp_Object *) p = newval;
940 break;
942 default:
943 abort (); /* goto def; */
947 /* Set up SYMBOL to refer to its global binding.
948 This makes it safe to alter the status of other bindings. */
950 void
951 swap_in_global_binding (struct Lisp_Symbol *symbol)
953 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (symbol);
955 /* Unload the previously loaded binding. */
956 if (blv->fwd)
957 SET_BLV_VALUE (blv, do_symval_forwarding (blv->fwd));
959 /* Select the global binding in the symbol. */
960 blv->valcell = blv->defcell;
961 if (blv->fwd)
962 store_symval_forwarding (blv->fwd, XCDR (blv->defcell), NULL);
964 /* Indicate that the global binding is set up now. */
965 blv->where = Qnil;
966 SET_BLV_FOUND (blv, 0);
969 /* Set up the buffer-local symbol SYMBOL for validity in the current buffer.
970 VALCONTENTS is the contents of its value cell,
971 which points to a struct Lisp_Buffer_Local_Value.
973 Return the value forwarded one step past the buffer-local stage.
974 This could be another forwarding pointer. */
976 static void
977 swap_in_symval_forwarding (struct Lisp_Symbol *symbol, struct Lisp_Buffer_Local_Value *blv)
979 register Lisp_Object tem1;
981 eassert (blv == SYMBOL_BLV (symbol));
983 tem1 = blv->where;
985 if (NILP (tem1)
986 || (blv->frame_local
987 ? !EQ (selected_frame, tem1)
988 : current_buffer != XBUFFER (tem1)))
991 /* Unload the previously loaded binding. */
992 tem1 = blv->valcell;
993 if (blv->fwd)
994 SET_BLV_VALUE (blv, do_symval_forwarding (blv->fwd));
995 /* Choose the new binding. */
997 Lisp_Object var;
998 XSETSYMBOL (var, symbol);
999 if (blv->frame_local)
1001 tem1 = assq_no_quit (var, XFRAME (selected_frame)->param_alist);
1002 blv->where = selected_frame;
1004 else
1006 tem1 = assq_no_quit (var, BVAR (current_buffer, local_var_alist));
1007 XSETBUFFER (blv->where, current_buffer);
1010 if (!(blv->found = !NILP (tem1)))
1011 tem1 = blv->defcell;
1013 /* Load the new binding. */
1014 blv->valcell = tem1;
1015 if (blv->fwd)
1016 store_symval_forwarding (blv->fwd, BLV_VALUE (blv), NULL);
1020 /* Find the value of a symbol, returning Qunbound if it's not bound.
1021 This is helpful for code which just wants to get a variable's value
1022 if it has one, without signaling an error.
1023 Note that it must not be possible to quit
1024 within this function. Great care is required for this. */
1026 Lisp_Object
1027 find_symbol_value (Lisp_Object symbol)
1029 struct Lisp_Symbol *sym;
1031 CHECK_SYMBOL (symbol);
1032 sym = XSYMBOL (symbol);
1034 start:
1035 switch (sym->redirect)
1037 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1038 case SYMBOL_PLAINVAL: return SYMBOL_VAL (sym);
1039 case SYMBOL_LOCALIZED:
1041 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1042 swap_in_symval_forwarding (sym, blv);
1043 return blv->fwd ? do_symval_forwarding (blv->fwd) : BLV_VALUE (blv);
1045 /* FALLTHROUGH */
1046 case SYMBOL_FORWARDED:
1047 return do_symval_forwarding (SYMBOL_FWD (sym));
1048 default: abort ();
1052 DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
1053 doc: /* Return SYMBOL's value. Error if that is void. */)
1054 (Lisp_Object symbol)
1056 Lisp_Object val;
1058 val = find_symbol_value (symbol);
1059 if (!EQ (val, Qunbound))
1060 return val;
1062 xsignal1 (Qvoid_variable, symbol);
1065 DEFUN ("set", Fset, Sset, 2, 2, 0,
1066 doc: /* Set SYMBOL's value to NEWVAL, and return NEWVAL. */)
1067 (register Lisp_Object symbol, Lisp_Object newval)
1069 set_internal (symbol, newval, Qnil, 0);
1070 return newval;
1073 /* Return 1 if SYMBOL currently has a let-binding
1074 which was made in the buffer that is now current. */
1076 static int
1077 let_shadows_buffer_binding_p (struct Lisp_Symbol *symbol)
1079 struct specbinding *p;
1081 for (p = specpdl_ptr - 1; p >= specpdl; p--)
1082 if (p->func == NULL
1083 && CONSP (p->symbol))
1085 struct Lisp_Symbol *let_bound_symbol = XSYMBOL (XCAR (p->symbol));
1086 eassert (let_bound_symbol->redirect != SYMBOL_VARALIAS);
1087 if (symbol == let_bound_symbol
1088 && XBUFFER (XCDR (XCDR (p->symbol))) == current_buffer)
1089 break;
1092 return p >= specpdl;
1095 static int
1096 let_shadows_global_binding_p (Lisp_Object symbol)
1098 struct specbinding *p;
1100 for (p = specpdl_ptr - 1; p >= specpdl; p--)
1101 if (p->func == NULL && EQ (p->symbol, symbol))
1102 break;
1104 return p >= specpdl;
1107 /* Store the value NEWVAL into SYMBOL.
1108 If buffer/frame-locality is an issue, WHERE specifies which context to use.
1109 (nil stands for the current buffer/frame).
1111 If BINDFLAG is zero, then if this symbol is supposed to become
1112 local in every buffer where it is set, then we make it local.
1113 If BINDFLAG is nonzero, we don't do that. */
1115 void
1116 set_internal (register Lisp_Object symbol, register Lisp_Object newval, register Lisp_Object where, int bindflag)
1118 int voide = EQ (newval, Qunbound);
1119 struct Lisp_Symbol *sym;
1120 Lisp_Object tem1;
1122 /* If restoring in a dead buffer, do nothing. */
1123 /* if (BUFFERP (where) && NILP (XBUFFER (where)->name))
1124 return; */
1126 CHECK_SYMBOL (symbol);
1127 if (SYMBOL_CONSTANT_P (symbol))
1129 if (NILP (Fkeywordp (symbol))
1130 || !EQ (newval, Fsymbol_value (symbol)))
1131 xsignal1 (Qsetting_constant, symbol);
1132 else
1133 /* Allow setting keywords to their own value. */
1134 return;
1137 sym = XSYMBOL (symbol);
1139 start:
1140 switch (sym->redirect)
1142 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1143 case SYMBOL_PLAINVAL: SET_SYMBOL_VAL (sym , newval); return;
1144 case SYMBOL_LOCALIZED:
1146 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1147 if (NILP (where))
1149 if (blv->frame_local)
1150 where = selected_frame;
1151 else
1152 XSETBUFFER (where, current_buffer);
1154 /* If the current buffer is not the buffer whose binding is
1155 loaded, or if there may be frame-local bindings and the frame
1156 isn't the right one, or if it's a Lisp_Buffer_Local_Value and
1157 the default binding is loaded, the loaded binding may be the
1158 wrong one. */
1159 if (!EQ (blv->where, where)
1160 /* Also unload a global binding (if the var is local_if_set). */
1161 || (EQ (blv->valcell, blv->defcell)))
1163 /* The currently loaded binding is not necessarily valid.
1164 We need to unload it, and choose a new binding. */
1166 /* Write out `realvalue' to the old loaded binding. */
1167 if (blv->fwd)
1168 SET_BLV_VALUE (blv, do_symval_forwarding (blv->fwd));
1170 /* Find the new binding. */
1171 XSETSYMBOL (symbol, sym); /* May have changed via aliasing. */
1172 tem1 = Fassq (symbol,
1173 (blv->frame_local
1174 ? XFRAME (where)->param_alist
1175 : BVAR (XBUFFER (where), local_var_alist)));
1176 blv->where = where;
1177 blv->found = 1;
1179 if (NILP (tem1))
1181 /* This buffer still sees the default value. */
1183 /* If the variable is a Lisp_Some_Buffer_Local_Value,
1184 or if this is `let' rather than `set',
1185 make CURRENT-ALIST-ELEMENT point to itself,
1186 indicating that we're seeing the default value.
1187 Likewise if the variable has been let-bound
1188 in the current buffer. */
1189 if (bindflag || !blv->local_if_set
1190 || let_shadows_buffer_binding_p (sym))
1192 blv->found = 0;
1193 tem1 = blv->defcell;
1195 /* If it's a local_if_set, being set not bound,
1196 and we're not within a let that was made for this buffer,
1197 create a new buffer-local binding for the variable.
1198 That means, give this buffer a new assoc for a local value
1199 and load that binding. */
1200 else
1202 /* local_if_set is only supported for buffer-local
1203 bindings, not for frame-local bindings. */
1204 eassert (!blv->frame_local);
1205 tem1 = Fcons (symbol, XCDR (blv->defcell));
1206 BVAR (XBUFFER (where), local_var_alist)
1207 = Fcons (tem1, BVAR (XBUFFER (where), local_var_alist));
1211 /* Record which binding is now loaded. */
1212 blv->valcell = tem1;
1215 /* Store the new value in the cons cell. */
1216 SET_BLV_VALUE (blv, newval);
1218 if (blv->fwd)
1220 if (voide)
1221 /* If storing void (making the symbol void), forward only through
1222 buffer-local indicator, not through Lisp_Objfwd, etc. */
1223 blv->fwd = NULL;
1224 else
1225 store_symval_forwarding (blv->fwd, newval,
1226 BUFFERP (where)
1227 ? XBUFFER (where) : current_buffer);
1229 break;
1231 case SYMBOL_FORWARDED:
1233 struct buffer *buf
1234 = BUFFERP (where) ? XBUFFER (where) : current_buffer;
1235 union Lisp_Fwd *innercontents = SYMBOL_FWD (sym);
1236 if (BUFFER_OBJFWDP (innercontents))
1238 int offset = XBUFFER_OBJFWD (innercontents)->offset;
1239 int idx = PER_BUFFER_IDX (offset);
1240 if (idx > 0
1241 && !bindflag
1242 && !let_shadows_buffer_binding_p (sym))
1243 SET_PER_BUFFER_VALUE_P (buf, idx, 1);
1246 if (voide)
1247 { /* If storing void (making the symbol void), forward only through
1248 buffer-local indicator, not through Lisp_Objfwd, etc. */
1249 sym->redirect = SYMBOL_PLAINVAL;
1250 SET_SYMBOL_VAL (sym, newval);
1252 else
1253 store_symval_forwarding (/* sym, */ innercontents, newval, buf);
1254 break;
1256 default: abort ();
1258 return;
1261 /* Access or set a buffer-local symbol's default value. */
1263 /* Return the default value of SYMBOL, but don't check for voidness.
1264 Return Qunbound if it is void. */
1266 static Lisp_Object
1267 default_value (Lisp_Object symbol)
1269 struct Lisp_Symbol *sym;
1271 CHECK_SYMBOL (symbol);
1272 sym = XSYMBOL (symbol);
1274 start:
1275 switch (sym->redirect)
1277 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1278 case SYMBOL_PLAINVAL: return SYMBOL_VAL (sym);
1279 case SYMBOL_LOCALIZED:
1281 /* If var is set up for a buffer that lacks a local value for it,
1282 the current value is nominally the default value.
1283 But the `realvalue' slot may be more up to date, since
1284 ordinary setq stores just that slot. So use that. */
1285 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1286 if (blv->fwd && EQ (blv->valcell, blv->defcell))
1287 return do_symval_forwarding (blv->fwd);
1288 else
1289 return XCDR (blv->defcell);
1291 case SYMBOL_FORWARDED:
1293 union Lisp_Fwd *valcontents = SYMBOL_FWD (sym);
1295 /* For a built-in buffer-local variable, get the default value
1296 rather than letting do_symval_forwarding get the current value. */
1297 if (BUFFER_OBJFWDP (valcontents))
1299 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1300 if (PER_BUFFER_IDX (offset) != 0)
1301 return PER_BUFFER_DEFAULT (offset);
1304 /* For other variables, get the current value. */
1305 return do_symval_forwarding (valcontents);
1307 default: abort ();
1311 DEFUN ("default-boundp", Fdefault_boundp, Sdefault_boundp, 1, 1, 0,
1312 doc: /* Return t if SYMBOL has a non-void default value.
1313 This is the value that is seen in buffers that do not have their own values
1314 for this variable. */)
1315 (Lisp_Object symbol)
1317 register Lisp_Object value;
1319 value = default_value (symbol);
1320 return (EQ (value, Qunbound) ? Qnil : Qt);
1323 DEFUN ("default-value", Fdefault_value, Sdefault_value, 1, 1, 0,
1324 doc: /* Return SYMBOL's default value.
1325 This is the value that is seen in buffers that do not have their own values
1326 for this variable. The default value is meaningful for variables with
1327 local bindings in certain buffers. */)
1328 (Lisp_Object symbol)
1330 register Lisp_Object value;
1332 value = default_value (symbol);
1333 if (!EQ (value, Qunbound))
1334 return value;
1336 xsignal1 (Qvoid_variable, symbol);
1339 DEFUN ("set-default", Fset_default, Sset_default, 2, 2, 0,
1340 doc: /* Set SYMBOL's default value to VALUE. SYMBOL and VALUE are evaluated.
1341 The default value is seen in buffers that do not have their own values
1342 for this variable. */)
1343 (Lisp_Object symbol, Lisp_Object value)
1345 struct Lisp_Symbol *sym;
1347 CHECK_SYMBOL (symbol);
1348 if (SYMBOL_CONSTANT_P (symbol))
1350 if (NILP (Fkeywordp (symbol))
1351 || !EQ (value, Fdefault_value (symbol)))
1352 xsignal1 (Qsetting_constant, symbol);
1353 else
1354 /* Allow setting keywords to their own value. */
1355 return value;
1357 sym = XSYMBOL (symbol);
1359 start:
1360 switch (sym->redirect)
1362 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1363 case SYMBOL_PLAINVAL: return Fset (symbol, value);
1364 case SYMBOL_LOCALIZED:
1366 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1368 /* Store new value into the DEFAULT-VALUE slot. */
1369 XSETCDR (blv->defcell, value);
1371 /* If the default binding is now loaded, set the REALVALUE slot too. */
1372 if (blv->fwd && EQ (blv->defcell, blv->valcell))
1373 store_symval_forwarding (blv->fwd, value, NULL);
1374 return value;
1376 case SYMBOL_FORWARDED:
1378 union Lisp_Fwd *valcontents = SYMBOL_FWD (sym);
1380 /* Handle variables like case-fold-search that have special slots
1381 in the buffer.
1382 Make them work apparently like Lisp_Buffer_Local_Value variables. */
1383 if (BUFFER_OBJFWDP (valcontents))
1385 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1386 int idx = PER_BUFFER_IDX (offset);
1388 PER_BUFFER_DEFAULT (offset) = value;
1390 /* If this variable is not always local in all buffers,
1391 set it in the buffers that don't nominally have a local value. */
1392 if (idx > 0)
1394 struct buffer *b;
1396 for (b = all_buffers; b; b = b->header.next.buffer)
1397 if (!PER_BUFFER_VALUE_P (b, idx))
1398 PER_BUFFER_VALUE (b, offset) = value;
1400 return value;
1402 else
1403 return Fset (symbol, value);
1405 default: abort ();
1409 DEFUN ("setq-default", Fsetq_default, Ssetq_default, 0, UNEVALLED, 0,
1410 doc: /* Set the default value of variable VAR to VALUE.
1411 VAR, the variable name, is literal (not evaluated);
1412 VALUE is an expression: it is evaluated and its value returned.
1413 The default value of a variable is seen in buffers
1414 that do not have their own values for the variable.
1416 More generally, you can use multiple variables and values, as in
1417 (setq-default VAR VALUE VAR VALUE...)
1418 This sets each VAR's default value to the corresponding VALUE.
1419 The VALUE for the Nth VAR can refer to the new default values
1420 of previous VARs.
1421 usage: (setq-default [VAR VALUE]...) */)
1422 (Lisp_Object args)
1424 register Lisp_Object args_left;
1425 register Lisp_Object val, symbol;
1426 struct gcpro gcpro1;
1428 if (NILP (args))
1429 return Qnil;
1431 args_left = args;
1432 GCPRO1 (args);
1436 val = eval_sub (Fcar (Fcdr (args_left)));
1437 symbol = XCAR (args_left);
1438 Fset_default (symbol, val);
1439 args_left = Fcdr (XCDR (args_left));
1441 while (!NILP (args_left));
1443 UNGCPRO;
1444 return val;
1447 /* Lisp functions for creating and removing buffer-local variables. */
1449 union Lisp_Val_Fwd
1451 Lisp_Object value;
1452 union Lisp_Fwd *fwd;
1455 static struct Lisp_Buffer_Local_Value *
1456 make_blv (struct Lisp_Symbol *sym, int forwarded, union Lisp_Val_Fwd valcontents)
1458 struct Lisp_Buffer_Local_Value *blv
1459 = xmalloc (sizeof (struct Lisp_Buffer_Local_Value));
1460 Lisp_Object symbol;
1461 Lisp_Object tem;
1463 XSETSYMBOL (symbol, sym);
1464 tem = Fcons (symbol, (forwarded
1465 ? do_symval_forwarding (valcontents.fwd)
1466 : valcontents.value));
1468 /* Buffer_Local_Values cannot have as realval a buffer-local
1469 or keyboard-local forwarding. */
1470 eassert (!(forwarded && BUFFER_OBJFWDP (valcontents.fwd)));
1471 eassert (!(forwarded && KBOARD_OBJFWDP (valcontents.fwd)));
1472 blv->fwd = forwarded ? valcontents.fwd : NULL;
1473 blv->where = Qnil;
1474 blv->frame_local = 0;
1475 blv->local_if_set = 0;
1476 blv->defcell = tem;
1477 blv->valcell = tem;
1478 SET_BLV_FOUND (blv, 0);
1479 return blv;
1482 DEFUN ("make-variable-buffer-local", Fmake_variable_buffer_local,
1483 Smake_variable_buffer_local, 1, 1, "vMake Variable Buffer Local: ",
1484 doc: /* Make VARIABLE become buffer-local whenever it is set.
1485 At any time, the value for the current buffer is in effect,
1486 unless the variable has never been set in this buffer,
1487 in which case the default value is in effect.
1488 Note that binding the variable with `let', or setting it while
1489 a `let'-style binding made in this buffer is in effect,
1490 does not make the variable buffer-local. Return VARIABLE.
1492 In most cases it is better to use `make-local-variable',
1493 which makes a variable local in just one buffer.
1495 The function `default-value' gets the default value and `set-default' sets it. */)
1496 (register Lisp_Object variable)
1498 struct Lisp_Symbol *sym;
1499 struct Lisp_Buffer_Local_Value *blv = NULL;
1500 union Lisp_Val_Fwd valcontents IF_LINT (= {0});
1501 int forwarded IF_LINT (= 0);
1503 CHECK_SYMBOL (variable);
1504 sym = XSYMBOL (variable);
1506 start:
1507 switch (sym->redirect)
1509 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1510 case SYMBOL_PLAINVAL:
1511 forwarded = 0; valcontents.value = SYMBOL_VAL (sym);
1512 if (EQ (valcontents.value, Qunbound))
1513 valcontents.value = Qnil;
1514 break;
1515 case SYMBOL_LOCALIZED:
1516 blv = SYMBOL_BLV (sym);
1517 if (blv->frame_local)
1518 error ("Symbol %s may not be buffer-local",
1519 SDATA (SYMBOL_NAME (variable)));
1520 break;
1521 case SYMBOL_FORWARDED:
1522 forwarded = 1; valcontents.fwd = SYMBOL_FWD (sym);
1523 if (KBOARD_OBJFWDP (valcontents.fwd))
1524 error ("Symbol %s may not be buffer-local",
1525 SDATA (SYMBOL_NAME (variable)));
1526 else if (BUFFER_OBJFWDP (valcontents.fwd))
1527 return variable;
1528 break;
1529 default: abort ();
1532 if (sym->constant)
1533 error ("Symbol %s may not be buffer-local", SDATA (SYMBOL_NAME (variable)));
1535 if (!blv)
1537 blv = make_blv (sym, forwarded, valcontents);
1538 sym->redirect = SYMBOL_LOCALIZED;
1539 SET_SYMBOL_BLV (sym, blv);
1541 Lisp_Object symbol;
1542 XSETSYMBOL (symbol, sym); /* In case `variable' is aliased. */
1543 if (let_shadows_global_binding_p (symbol))
1544 message ("Making %s buffer-local while let-bound!",
1545 SDATA (SYMBOL_NAME (variable)));
1549 blv->local_if_set = 1;
1550 return variable;
1553 DEFUN ("make-local-variable", Fmake_local_variable, Smake_local_variable,
1554 1, 1, "vMake Local Variable: ",
1555 doc: /* Make VARIABLE have a separate value in the current buffer.
1556 Other buffers will continue to share a common default value.
1557 \(The buffer-local value of VARIABLE starts out as the same value
1558 VARIABLE previously had. If VARIABLE was void, it remains void.\)
1559 Return VARIABLE.
1561 If the variable is already arranged to become local when set,
1562 this function causes a local value to exist for this buffer,
1563 just as setting the variable would do.
1565 This function returns VARIABLE, and therefore
1566 (set (make-local-variable 'VARIABLE) VALUE-EXP)
1567 works.
1569 See also `make-variable-buffer-local'.
1571 Do not use `make-local-variable' to make a hook variable buffer-local.
1572 Instead, use `add-hook' and specify t for the LOCAL argument. */)
1573 (register Lisp_Object variable)
1575 register Lisp_Object tem;
1576 int forwarded IF_LINT (= 0);
1577 union Lisp_Val_Fwd valcontents IF_LINT (= {0});
1578 struct Lisp_Symbol *sym;
1579 struct Lisp_Buffer_Local_Value *blv = NULL;
1581 CHECK_SYMBOL (variable);
1582 sym = XSYMBOL (variable);
1584 start:
1585 switch (sym->redirect)
1587 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1588 case SYMBOL_PLAINVAL:
1589 forwarded = 0; valcontents.value = SYMBOL_VAL (sym); break;
1590 case SYMBOL_LOCALIZED:
1591 blv = SYMBOL_BLV (sym);
1592 if (blv->frame_local)
1593 error ("Symbol %s may not be buffer-local",
1594 SDATA (SYMBOL_NAME (variable)));
1595 break;
1596 case SYMBOL_FORWARDED:
1597 forwarded = 1; valcontents.fwd = SYMBOL_FWD (sym);
1598 if (KBOARD_OBJFWDP (valcontents.fwd))
1599 error ("Symbol %s may not be buffer-local",
1600 SDATA (SYMBOL_NAME (variable)));
1601 break;
1602 default: abort ();
1605 if (sym->constant)
1606 error ("Symbol %s may not be buffer-local",
1607 SDATA (SYMBOL_NAME (variable)));
1609 if (blv ? blv->local_if_set
1610 : (forwarded && BUFFER_OBJFWDP (valcontents.fwd)))
1612 tem = Fboundp (variable);
1613 /* Make sure the symbol has a local value in this particular buffer,
1614 by setting it to the same value it already has. */
1615 Fset (variable, (EQ (tem, Qt) ? Fsymbol_value (variable) : Qunbound));
1616 return variable;
1618 if (!blv)
1620 blv = make_blv (sym, forwarded, valcontents);
1621 sym->redirect = SYMBOL_LOCALIZED;
1622 SET_SYMBOL_BLV (sym, blv);
1624 Lisp_Object symbol;
1625 XSETSYMBOL (symbol, sym); /* In case `variable' is aliased. */
1626 if (let_shadows_global_binding_p (symbol))
1627 message ("Making %s local to %s while let-bound!",
1628 SDATA (SYMBOL_NAME (variable)),
1629 SDATA (BVAR (current_buffer, name)));
1633 /* Make sure this buffer has its own value of symbol. */
1634 XSETSYMBOL (variable, sym); /* Update in case of aliasing. */
1635 tem = Fassq (variable, BVAR (current_buffer, local_var_alist));
1636 if (NILP (tem))
1638 if (let_shadows_buffer_binding_p (sym))
1639 message ("Making %s buffer-local while locally let-bound!",
1640 SDATA (SYMBOL_NAME (variable)));
1642 /* Swap out any local binding for some other buffer, and make
1643 sure the current value is permanently recorded, if it's the
1644 default value. */
1645 find_symbol_value (variable);
1647 BVAR (current_buffer, local_var_alist)
1648 = Fcons (Fcons (variable, XCDR (blv->defcell)),
1649 BVAR (current_buffer, local_var_alist));
1651 /* Make sure symbol does not think it is set up for this buffer;
1652 force it to look once again for this buffer's value. */
1653 if (current_buffer == XBUFFER (blv->where))
1654 blv->where = Qnil;
1655 /* blv->valcell = blv->defcell;
1656 * SET_BLV_FOUND (blv, 0); */
1657 blv->found = 0;
1660 /* If the symbol forwards into a C variable, then load the binding
1661 for this buffer now. If C code modifies the variable before we
1662 load the binding in, then that new value will clobber the default
1663 binding the next time we unload it. */
1664 if (blv->fwd)
1665 swap_in_symval_forwarding (sym, blv);
1667 return variable;
1670 DEFUN ("kill-local-variable", Fkill_local_variable, Skill_local_variable,
1671 1, 1, "vKill Local Variable: ",
1672 doc: /* Make VARIABLE no longer have a separate value in the current buffer.
1673 From now on the default value will apply in this buffer. Return VARIABLE. */)
1674 (register Lisp_Object variable)
1676 register Lisp_Object tem;
1677 struct Lisp_Buffer_Local_Value *blv;
1678 struct Lisp_Symbol *sym;
1680 CHECK_SYMBOL (variable);
1681 sym = XSYMBOL (variable);
1683 start:
1684 switch (sym->redirect)
1686 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1687 case SYMBOL_PLAINVAL: return variable;
1688 case SYMBOL_FORWARDED:
1690 union Lisp_Fwd *valcontents = SYMBOL_FWD (sym);
1691 if (BUFFER_OBJFWDP (valcontents))
1693 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1694 int idx = PER_BUFFER_IDX (offset);
1696 if (idx > 0)
1698 SET_PER_BUFFER_VALUE_P (current_buffer, idx, 0);
1699 PER_BUFFER_VALUE (current_buffer, offset)
1700 = PER_BUFFER_DEFAULT (offset);
1703 return variable;
1705 case SYMBOL_LOCALIZED:
1706 blv = SYMBOL_BLV (sym);
1707 if (blv->frame_local)
1708 return variable;
1709 break;
1710 default: abort ();
1713 /* Get rid of this buffer's alist element, if any. */
1714 XSETSYMBOL (variable, sym); /* Propagate variable indirection. */
1715 tem = Fassq (variable, BVAR (current_buffer, local_var_alist));
1716 if (!NILP (tem))
1717 BVAR (current_buffer, local_var_alist)
1718 = Fdelq (tem, BVAR (current_buffer, local_var_alist));
1720 /* If the symbol is set up with the current buffer's binding
1721 loaded, recompute its value. We have to do it now, or else
1722 forwarded objects won't work right. */
1724 Lisp_Object buf; XSETBUFFER (buf, current_buffer);
1725 if (EQ (buf, blv->where))
1727 blv->where = Qnil;
1728 /* blv->valcell = blv->defcell;
1729 * SET_BLV_FOUND (blv, 0); */
1730 blv->found = 0;
1731 find_symbol_value (variable);
1735 return variable;
1738 /* Lisp functions for creating and removing buffer-local variables. */
1740 /* Obsolete since 22.2. NB adjust doc of modify-frame-parameters
1741 when/if this is removed. */
1743 DEFUN ("make-variable-frame-local", Fmake_variable_frame_local, Smake_variable_frame_local,
1744 1, 1, "vMake Variable Frame Local: ",
1745 doc: /* Enable VARIABLE to have frame-local bindings.
1746 This does not create any frame-local bindings for VARIABLE,
1747 it just makes them possible.
1749 A frame-local binding is actually a frame parameter value.
1750 If a frame F has a value for the frame parameter named VARIABLE,
1751 that also acts as a frame-local binding for VARIABLE in F--
1752 provided this function has been called to enable VARIABLE
1753 to have frame-local bindings at all.
1755 The only way to create a frame-local binding for VARIABLE in a frame
1756 is to set the VARIABLE frame parameter of that frame. See
1757 `modify-frame-parameters' for how to set frame parameters.
1759 Note that since Emacs 23.1, variables cannot be both buffer-local and
1760 frame-local any more (buffer-local bindings used to take precedence over
1761 frame-local bindings). */)
1762 (register Lisp_Object variable)
1764 int forwarded;
1765 union Lisp_Val_Fwd valcontents;
1766 struct Lisp_Symbol *sym;
1767 struct Lisp_Buffer_Local_Value *blv = NULL;
1769 CHECK_SYMBOL (variable);
1770 sym = XSYMBOL (variable);
1772 start:
1773 switch (sym->redirect)
1775 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1776 case SYMBOL_PLAINVAL:
1777 forwarded = 0; valcontents.value = SYMBOL_VAL (sym);
1778 if (EQ (valcontents.value, Qunbound))
1779 valcontents.value = Qnil;
1780 break;
1781 case SYMBOL_LOCALIZED:
1782 if (SYMBOL_BLV (sym)->frame_local)
1783 return variable;
1784 else
1785 error ("Symbol %s may not be frame-local",
1786 SDATA (SYMBOL_NAME (variable)));
1787 case SYMBOL_FORWARDED:
1788 forwarded = 1; valcontents.fwd = SYMBOL_FWD (sym);
1789 if (KBOARD_OBJFWDP (valcontents.fwd) || BUFFER_OBJFWDP (valcontents.fwd))
1790 error ("Symbol %s may not be frame-local",
1791 SDATA (SYMBOL_NAME (variable)));
1792 break;
1793 default: abort ();
1796 if (sym->constant)
1797 error ("Symbol %s may not be frame-local", SDATA (SYMBOL_NAME (variable)));
1799 blv = make_blv (sym, forwarded, valcontents);
1800 blv->frame_local = 1;
1801 sym->redirect = SYMBOL_LOCALIZED;
1802 SET_SYMBOL_BLV (sym, blv);
1804 Lisp_Object symbol;
1805 XSETSYMBOL (symbol, sym); /* In case `variable' is aliased. */
1806 if (let_shadows_global_binding_p (symbol))
1807 message ("Making %s frame-local while let-bound!",
1808 SDATA (SYMBOL_NAME (variable)));
1810 return variable;
1813 DEFUN ("local-variable-p", Flocal_variable_p, Slocal_variable_p,
1814 1, 2, 0,
1815 doc: /* Non-nil if VARIABLE has a local binding in buffer BUFFER.
1816 BUFFER defaults to the current buffer. */)
1817 (register Lisp_Object variable, Lisp_Object buffer)
1819 register struct buffer *buf;
1820 struct Lisp_Symbol *sym;
1822 if (NILP (buffer))
1823 buf = current_buffer;
1824 else
1826 CHECK_BUFFER (buffer);
1827 buf = XBUFFER (buffer);
1830 CHECK_SYMBOL (variable);
1831 sym = XSYMBOL (variable);
1833 start:
1834 switch (sym->redirect)
1836 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1837 case SYMBOL_PLAINVAL: return Qnil;
1838 case SYMBOL_LOCALIZED:
1840 Lisp_Object tail, elt, tmp;
1841 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1842 XSETBUFFER (tmp, buf);
1843 XSETSYMBOL (variable, sym); /* Update in case of aliasing. */
1845 for (tail = BVAR (buf, local_var_alist); CONSP (tail); tail = XCDR (tail))
1847 elt = XCAR (tail);
1848 if (EQ (variable, XCAR (elt)))
1850 eassert (!blv->frame_local);
1851 eassert (BLV_FOUND (blv) || !EQ (blv->where, tmp));
1852 return Qt;
1855 eassert (!BLV_FOUND (blv) || !EQ (blv->where, tmp));
1856 return Qnil;
1858 case SYMBOL_FORWARDED:
1860 union Lisp_Fwd *valcontents = SYMBOL_FWD (sym);
1861 if (BUFFER_OBJFWDP (valcontents))
1863 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1864 int idx = PER_BUFFER_IDX (offset);
1865 if (idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
1866 return Qt;
1868 return Qnil;
1870 default: abort ();
1874 DEFUN ("local-variable-if-set-p", Flocal_variable_if_set_p, Slocal_variable_if_set_p,
1875 1, 2, 0,
1876 doc: /* Non-nil if VARIABLE will be local in buffer BUFFER when set there.
1877 More precisely, this means that setting the variable \(with `set' or`setq'),
1878 while it does not have a `let'-style binding that was made in BUFFER,
1879 will produce a buffer local binding. See Info node
1880 `(elisp)Creating Buffer-Local'.
1881 BUFFER defaults to the current buffer. */)
1882 (register Lisp_Object variable, Lisp_Object buffer)
1884 struct Lisp_Symbol *sym;
1886 CHECK_SYMBOL (variable);
1887 sym = XSYMBOL (variable);
1889 start:
1890 switch (sym->redirect)
1892 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1893 case SYMBOL_PLAINVAL: return Qnil;
1894 case SYMBOL_LOCALIZED:
1896 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1897 if (blv->local_if_set)
1898 return Qt;
1899 XSETSYMBOL (variable, sym); /* Update in case of aliasing. */
1900 return Flocal_variable_p (variable, buffer);
1902 case SYMBOL_FORWARDED:
1903 /* All BUFFER_OBJFWD slots become local if they are set. */
1904 return (BUFFER_OBJFWDP (SYMBOL_FWD (sym)) ? Qt : Qnil);
1905 default: abort ();
1909 DEFUN ("variable-binding-locus", Fvariable_binding_locus, Svariable_binding_locus,
1910 1, 1, 0,
1911 doc: /* Return a value indicating where VARIABLE's current binding comes from.
1912 If the current binding is buffer-local, the value is the current buffer.
1913 If the current binding is frame-local, the value is the selected frame.
1914 If the current binding is global (the default), the value is nil. */)
1915 (register Lisp_Object variable)
1917 struct Lisp_Symbol *sym;
1919 CHECK_SYMBOL (variable);
1920 sym = XSYMBOL (variable);
1922 /* Make sure the current binding is actually swapped in. */
1923 find_symbol_value (variable);
1925 start:
1926 switch (sym->redirect)
1928 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1929 case SYMBOL_PLAINVAL: return Qnil;
1930 case SYMBOL_FORWARDED:
1932 union Lisp_Fwd *valcontents = SYMBOL_FWD (sym);
1933 if (KBOARD_OBJFWDP (valcontents))
1934 return Fframe_terminal (Fselected_frame ());
1935 else if (!BUFFER_OBJFWDP (valcontents))
1936 return Qnil;
1938 /* FALLTHROUGH */
1939 case SYMBOL_LOCALIZED:
1940 /* For a local variable, record both the symbol and which
1941 buffer's or frame's value we are saving. */
1942 if (!NILP (Flocal_variable_p (variable, Qnil)))
1943 return Fcurrent_buffer ();
1944 else if (sym->redirect == SYMBOL_LOCALIZED
1945 && BLV_FOUND (SYMBOL_BLV (sym)))
1946 return SYMBOL_BLV (sym)->where;
1947 else
1948 return Qnil;
1949 default: abort ();
1953 /* This code is disabled now that we use the selected frame to return
1954 keyboard-local-values. */
1955 #if 0
1956 extern struct terminal *get_terminal (Lisp_Object display, int);
1958 DEFUN ("terminal-local-value", Fterminal_local_value,
1959 Sterminal_local_value, 2, 2, 0,
1960 doc: /* Return the terminal-local value of SYMBOL on TERMINAL.
1961 If SYMBOL is not a terminal-local variable, then return its normal
1962 value, like `symbol-value'.
1964 TERMINAL may be a terminal object, a frame, or nil (meaning the
1965 selected frame's terminal device). */)
1966 (Lisp_Object symbol, Lisp_Object terminal)
1968 Lisp_Object result;
1969 struct terminal *t = get_terminal (terminal, 1);
1970 push_kboard (t->kboard);
1971 result = Fsymbol_value (symbol);
1972 pop_kboard ();
1973 return result;
1976 DEFUN ("set-terminal-local-value", Fset_terminal_local_value,
1977 Sset_terminal_local_value, 3, 3, 0,
1978 doc: /* Set the terminal-local binding of SYMBOL on TERMINAL to VALUE.
1979 If VARIABLE is not a terminal-local variable, then set its normal
1980 binding, like `set'.
1982 TERMINAL may be a terminal object, a frame, or nil (meaning the
1983 selected frame's terminal device). */)
1984 (Lisp_Object symbol, Lisp_Object terminal, Lisp_Object value)
1986 Lisp_Object result;
1987 struct terminal *t = get_terminal (terminal, 1);
1988 push_kboard (d->kboard);
1989 result = Fset (symbol, value);
1990 pop_kboard ();
1991 return result;
1993 #endif
1995 /* Find the function at the end of a chain of symbol function indirections. */
1997 /* If OBJECT is a symbol, find the end of its function chain and
1998 return the value found there. If OBJECT is not a symbol, just
1999 return it. If there is a cycle in the function chain, signal a
2000 cyclic-function-indirection error.
2002 This is like Findirect_function, except that it doesn't signal an
2003 error if the chain ends up unbound. */
2004 Lisp_Object
2005 indirect_function (register Lisp_Object object)
2007 Lisp_Object tortoise, hare;
2009 hare = tortoise = object;
2011 for (;;)
2013 if (!SYMBOLP (hare) || EQ (hare, Qunbound))
2014 break;
2015 hare = XSYMBOL (hare)->function;
2016 if (!SYMBOLP (hare) || EQ (hare, Qunbound))
2017 break;
2018 hare = XSYMBOL (hare)->function;
2020 tortoise = XSYMBOL (tortoise)->function;
2022 if (EQ (hare, tortoise))
2023 xsignal1 (Qcyclic_function_indirection, object);
2026 return hare;
2029 DEFUN ("indirect-function", Findirect_function, Sindirect_function, 1, 2, 0,
2030 doc: /* Return the function at the end of OBJECT's function chain.
2031 If OBJECT is not a symbol, just return it. Otherwise, follow all
2032 function indirections to find the final function binding and return it.
2033 If the final symbol in the chain is unbound, signal a void-function error.
2034 Optional arg NOERROR non-nil means to return nil instead of signalling.
2035 Signal a cyclic-function-indirection error if there is a loop in the
2036 function chain of symbols. */)
2037 (register Lisp_Object object, Lisp_Object noerror)
2039 Lisp_Object result;
2041 /* Optimize for no indirection. */
2042 result = object;
2043 if (SYMBOLP (result) && !EQ (result, Qunbound)
2044 && (result = XSYMBOL (result)->function, SYMBOLP (result)))
2045 result = indirect_function (result);
2046 if (!EQ (result, Qunbound))
2047 return result;
2049 if (NILP (noerror))
2050 xsignal1 (Qvoid_function, object);
2052 return Qnil;
2055 /* Extract and set vector and string elements */
2057 DEFUN ("aref", Faref, Saref, 2, 2, 0,
2058 doc: /* Return the element of ARRAY at index IDX.
2059 ARRAY may be a vector, a string, a char-table, a bool-vector,
2060 or a byte-code object. IDX starts at 0. */)
2061 (register Lisp_Object array, Lisp_Object idx)
2063 register EMACS_INT idxval;
2065 CHECK_NUMBER (idx);
2066 idxval = XINT (idx);
2067 if (STRINGP (array))
2069 int c;
2070 EMACS_INT idxval_byte;
2072 if (idxval < 0 || idxval >= SCHARS (array))
2073 args_out_of_range (array, idx);
2074 if (! STRING_MULTIBYTE (array))
2075 return make_number ((unsigned char) SREF (array, idxval));
2076 idxval_byte = string_char_to_byte (array, idxval);
2078 c = STRING_CHAR (SDATA (array) + idxval_byte);
2079 return make_number (c);
2081 else if (BOOL_VECTOR_P (array))
2083 int val;
2085 if (idxval < 0 || idxval >= XBOOL_VECTOR (array)->size)
2086 args_out_of_range (array, idx);
2088 val = (unsigned char) XBOOL_VECTOR (array)->data[idxval / BOOL_VECTOR_BITS_PER_CHAR];
2089 return (val & (1 << (idxval % BOOL_VECTOR_BITS_PER_CHAR)) ? Qt : Qnil);
2091 else if (CHAR_TABLE_P (array))
2093 CHECK_CHARACTER (idx);
2094 return CHAR_TABLE_REF (array, idxval);
2096 else
2098 int size = 0;
2099 if (VECTORP (array))
2100 size = ASIZE (array);
2101 else if (COMPILEDP (array))
2102 size = ASIZE (array) & PSEUDOVECTOR_SIZE_MASK;
2103 else
2104 wrong_type_argument (Qarrayp, array);
2106 if (idxval < 0 || idxval >= size)
2107 args_out_of_range (array, idx);
2108 return AREF (array, idxval);
2112 DEFUN ("aset", Faset, Saset, 3, 3, 0,
2113 doc: /* Store into the element of ARRAY at index IDX the value NEWELT.
2114 Return NEWELT. ARRAY may be a vector, a string, a char-table or a
2115 bool-vector. IDX starts at 0. */)
2116 (register Lisp_Object array, Lisp_Object idx, Lisp_Object newelt)
2118 register EMACS_INT idxval;
2120 CHECK_NUMBER (idx);
2121 idxval = XINT (idx);
2122 CHECK_ARRAY (array, Qarrayp);
2123 CHECK_IMPURE (array);
2125 if (VECTORP (array))
2127 if (idxval < 0 || idxval >= ASIZE (array))
2128 args_out_of_range (array, idx);
2129 XVECTOR (array)->contents[idxval] = newelt;
2131 else if (BOOL_VECTOR_P (array))
2133 int val;
2135 if (idxval < 0 || idxval >= XBOOL_VECTOR (array)->size)
2136 args_out_of_range (array, idx);
2138 val = (unsigned char) XBOOL_VECTOR (array)->data[idxval / BOOL_VECTOR_BITS_PER_CHAR];
2140 if (! NILP (newelt))
2141 val |= 1 << (idxval % BOOL_VECTOR_BITS_PER_CHAR);
2142 else
2143 val &= ~(1 << (idxval % BOOL_VECTOR_BITS_PER_CHAR));
2144 XBOOL_VECTOR (array)->data[idxval / BOOL_VECTOR_BITS_PER_CHAR] = val;
2146 else if (CHAR_TABLE_P (array))
2148 CHECK_CHARACTER (idx);
2149 CHAR_TABLE_SET (array, idxval, newelt);
2151 else
2153 int c;
2155 if (idxval < 0 || idxval >= SCHARS (array))
2156 args_out_of_range (array, idx);
2157 CHECK_CHARACTER (newelt);
2158 c = XFASTINT (newelt);
2160 if (STRING_MULTIBYTE (array))
2162 EMACS_INT idxval_byte, prev_bytes, new_bytes, nbytes;
2163 unsigned char workbuf[MAX_MULTIBYTE_LENGTH], *p0 = workbuf, *p1;
2165 nbytes = SBYTES (array);
2166 idxval_byte = string_char_to_byte (array, idxval);
2167 p1 = SDATA (array) + idxval_byte;
2168 prev_bytes = BYTES_BY_CHAR_HEAD (*p1);
2169 new_bytes = CHAR_STRING (c, p0);
2170 if (prev_bytes != new_bytes)
2172 /* We must relocate the string data. */
2173 EMACS_INT nchars = SCHARS (array);
2174 unsigned char *str;
2175 USE_SAFE_ALLOCA;
2177 SAFE_ALLOCA (str, unsigned char *, nbytes);
2178 memcpy (str, SDATA (array), nbytes);
2179 allocate_string_data (XSTRING (array), nchars,
2180 nbytes + new_bytes - prev_bytes);
2181 memcpy (SDATA (array), str, idxval_byte);
2182 p1 = SDATA (array) + idxval_byte;
2183 memcpy (p1 + new_bytes, str + idxval_byte + prev_bytes,
2184 nbytes - (idxval_byte + prev_bytes));
2185 SAFE_FREE ();
2186 clear_string_char_byte_cache ();
2188 while (new_bytes--)
2189 *p1++ = *p0++;
2191 else
2193 if (! SINGLE_BYTE_CHAR_P (c))
2195 int i;
2197 for (i = SBYTES (array) - 1; i >= 0; i--)
2198 if (SREF (array, i) >= 0x80)
2199 args_out_of_range (array, newelt);
2200 /* ARRAY is an ASCII string. Convert it to a multibyte
2201 string, and try `aset' again. */
2202 STRING_SET_MULTIBYTE (array);
2203 return Faset (array, idx, newelt);
2205 SSET (array, idxval, c);
2209 return newelt;
2212 /* Arithmetic functions */
2214 enum comparison { equal, notequal, less, grtr, less_or_equal, grtr_or_equal };
2216 static Lisp_Object
2217 arithcompare (Lisp_Object num1, Lisp_Object num2, enum comparison comparison)
2219 double f1 = 0, f2 = 0;
2220 int floatp = 0;
2222 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num1);
2223 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num2);
2225 if (FLOATP (num1) || FLOATP (num2))
2227 floatp = 1;
2228 f1 = (FLOATP (num1)) ? XFLOAT_DATA (num1) : XINT (num1);
2229 f2 = (FLOATP (num2)) ? XFLOAT_DATA (num2) : XINT (num2);
2232 switch (comparison)
2234 case equal:
2235 if (floatp ? f1 == f2 : XINT (num1) == XINT (num2))
2236 return Qt;
2237 return Qnil;
2239 case notequal:
2240 if (floatp ? f1 != f2 : XINT (num1) != XINT (num2))
2241 return Qt;
2242 return Qnil;
2244 case less:
2245 if (floatp ? f1 < f2 : XINT (num1) < XINT (num2))
2246 return Qt;
2247 return Qnil;
2249 case less_or_equal:
2250 if (floatp ? f1 <= f2 : XINT (num1) <= XINT (num2))
2251 return Qt;
2252 return Qnil;
2254 case grtr:
2255 if (floatp ? f1 > f2 : XINT (num1) > XINT (num2))
2256 return Qt;
2257 return Qnil;
2259 case grtr_or_equal:
2260 if (floatp ? f1 >= f2 : XINT (num1) >= XINT (num2))
2261 return Qt;
2262 return Qnil;
2264 default:
2265 abort ();
2269 DEFUN ("=", Feqlsign, Seqlsign, 2, 2, 0,
2270 doc: /* Return t if two args, both numbers or markers, are equal. */)
2271 (register Lisp_Object num1, Lisp_Object num2)
2273 return arithcompare (num1, num2, equal);
2276 DEFUN ("<", Flss, Slss, 2, 2, 0,
2277 doc: /* Return t if first arg is less than second arg. Both must be numbers or markers. */)
2278 (register Lisp_Object num1, Lisp_Object num2)
2280 return arithcompare (num1, num2, less);
2283 DEFUN (">", Fgtr, Sgtr, 2, 2, 0,
2284 doc: /* Return t if first arg is greater than second arg. Both must be numbers or markers. */)
2285 (register Lisp_Object num1, Lisp_Object num2)
2287 return arithcompare (num1, num2, grtr);
2290 DEFUN ("<=", Fleq, Sleq, 2, 2, 0,
2291 doc: /* Return t if first arg is less than or equal to second arg.
2292 Both must be numbers or markers. */)
2293 (register Lisp_Object num1, Lisp_Object num2)
2295 return arithcompare (num1, num2, less_or_equal);
2298 DEFUN (">=", Fgeq, Sgeq, 2, 2, 0,
2299 doc: /* Return t if first arg is greater than or equal to second arg.
2300 Both must be numbers or markers. */)
2301 (register Lisp_Object num1, Lisp_Object num2)
2303 return arithcompare (num1, num2, grtr_or_equal);
2306 DEFUN ("/=", Fneq, Sneq, 2, 2, 0,
2307 doc: /* Return t if first arg is not equal to second arg. Both must be numbers or markers. */)
2308 (register Lisp_Object num1, Lisp_Object num2)
2310 return arithcompare (num1, num2, notequal);
2313 DEFUN ("zerop", Fzerop, Szerop, 1, 1, 0,
2314 doc: /* Return t if NUMBER is zero. */)
2315 (register Lisp_Object number)
2317 CHECK_NUMBER_OR_FLOAT (number);
2319 if (FLOATP (number))
2321 if (XFLOAT_DATA (number) == 0.0)
2322 return Qt;
2323 return Qnil;
2326 if (!XINT (number))
2327 return Qt;
2328 return Qnil;
2331 /* Convert the cons-of-integers, integer, or float value C to an
2332 unsigned value with maximum value MAX. Signal an error if C does not
2333 have a valid format or is out of range. */
2334 uintmax_t
2335 cons_to_unsigned (Lisp_Object c, uintmax_t max)
2337 int valid = 0;
2338 uintmax_t val IF_LINT (= 0);
2339 if (INTEGERP (c))
2341 valid = 0 <= XINT (c);
2342 val = XINT (c);
2344 else if (FLOATP (c))
2346 double d = XFLOAT_DATA (c);
2347 if (0 <= d
2348 && d < (max == UINTMAX_MAX ? (double) UINTMAX_MAX + 1 : max + 1))
2350 val = d;
2351 valid = 1;
2354 else if (CONSP (c) && NATNUMP (XCAR (c)))
2356 uintmax_t top = XFASTINT (XCAR (c));
2357 Lisp_Object rest = XCDR (c);
2358 if (top <= UINTMAX_MAX >> 24 >> 16
2359 && CONSP (rest)
2360 && NATNUMP (XCAR (rest)) && XFASTINT (XCAR (rest)) < 1 << 24
2361 && NATNUMP (XCDR (rest)) && XFASTINT (XCDR (rest)) < 1 << 16)
2363 uintmax_t mid = XFASTINT (XCAR (rest));
2364 val = top << 24 << 16 | mid << 16 | XFASTINT (XCDR (rest));
2365 valid = 1;
2367 else if (top <= UINTMAX_MAX >> 16)
2369 if (CONSP (rest))
2370 rest = XCAR (rest);
2371 if (NATNUMP (rest) && XFASTINT (rest) < 1 << 16)
2373 val = top << 16 | XFASTINT (rest);
2374 valid = 1;
2379 if (! (valid && val <= max))
2380 error ("Not an in-range integer, float, or cons of integers");
2381 return val;
2384 /* Convert the cons-of-integers, integer, or float value C to a signed
2385 value with extrema MIN and MAX. Signal an error if C does not have
2386 a valid format or is out of range. */
2387 intmax_t
2388 cons_to_signed (Lisp_Object c, intmax_t min, intmax_t max)
2390 int valid = 0;
2391 intmax_t val IF_LINT (= 0);
2392 if (INTEGERP (c))
2394 val = XINT (c);
2395 valid = 1;
2397 else if (FLOATP (c))
2399 double d = XFLOAT_DATA (c);
2400 if (min <= d
2401 && d < (max == INTMAX_MAX ? (double) INTMAX_MAX + 1 : max + 1))
2403 val = d;
2404 valid = 1;
2407 else if (CONSP (c) && INTEGERP (XCAR (c)))
2409 intmax_t top = XINT (XCAR (c));
2410 Lisp_Object rest = XCDR (c);
2411 if (INTMAX_MIN >> 24 >> 16 <= top && top <= INTMAX_MAX >> 24 >> 16
2412 && CONSP (rest)
2413 && NATNUMP (XCAR (rest)) && XFASTINT (XCAR (rest)) < 1 << 24
2414 && NATNUMP (XCDR (rest)) && XFASTINT (XCDR (rest)) < 1 << 16)
2416 intmax_t mid = XFASTINT (XCAR (rest));
2417 val = top << 24 << 16 | mid << 16 | XFASTINT (XCDR (rest));
2418 valid = 1;
2420 else if (INTMAX_MIN >> 16 <= top && top <= INTMAX_MAX >> 16)
2422 if (CONSP (rest))
2423 rest = XCAR (rest);
2424 if (NATNUMP (rest) && XFASTINT (rest) < 1 << 16)
2426 val = top << 16 | XFASTINT (rest);
2427 valid = 1;
2432 if (! (valid && min <= val && val <= max))
2433 error ("Not an in-range integer, float, or cons of integers");
2434 return val;
2437 DEFUN ("number-to-string", Fnumber_to_string, Snumber_to_string, 1, 1, 0,
2438 doc: /* Return the decimal representation of NUMBER as a string.
2439 Uses a minus sign if negative.
2440 NUMBER may be an integer or a floating point number. */)
2441 (Lisp_Object number)
2443 char buffer[VALBITS];
2445 CHECK_NUMBER_OR_FLOAT (number);
2447 if (FLOATP (number))
2449 char pigbuf[FLOAT_TO_STRING_BUFSIZE];
2451 float_to_string (pigbuf, XFLOAT_DATA (number));
2452 return build_string (pigbuf);
2455 sprintf (buffer, "%"pI"d", XINT (number));
2456 return build_string (buffer);
2459 DEFUN ("string-to-number", Fstring_to_number, Sstring_to_number, 1, 2, 0,
2460 doc: /* Parse STRING as a decimal number and return the number.
2461 This parses both integers and floating point numbers.
2462 It ignores leading spaces and tabs, and all trailing chars.
2464 If BASE, interpret STRING as a number in that base. If BASE isn't
2465 present, base 10 is used. BASE must be between 2 and 16 (inclusive).
2466 If the base used is not 10, STRING is always parsed as integer. */)
2467 (register Lisp_Object string, Lisp_Object base)
2469 register char *p;
2470 register int b;
2471 Lisp_Object val;
2473 CHECK_STRING (string);
2475 if (NILP (base))
2476 b = 10;
2477 else
2479 CHECK_NUMBER (base);
2480 b = XINT (base);
2481 if (b < 2 || b > 16)
2482 xsignal1 (Qargs_out_of_range, base);
2485 p = SSDATA (string);
2486 while (*p == ' ' || *p == '\t')
2487 p++;
2489 val = string_to_number (p, b, 1);
2490 return NILP (val) ? make_number (0) : val;
2493 enum arithop
2495 Aadd,
2496 Asub,
2497 Amult,
2498 Adiv,
2499 Alogand,
2500 Alogior,
2501 Alogxor,
2502 Amax,
2503 Amin
2506 static Lisp_Object float_arith_driver (double, ptrdiff_t, enum arithop,
2507 ptrdiff_t, Lisp_Object *);
2508 static Lisp_Object
2509 arith_driver (enum arithop code, ptrdiff_t nargs, Lisp_Object *args)
2511 register Lisp_Object val;
2512 ptrdiff_t argnum;
2513 register EMACS_INT accum = 0;
2514 register EMACS_INT next;
2516 int overflow = 0;
2517 ptrdiff_t ok_args;
2518 EMACS_INT ok_accum;
2520 switch (SWITCH_ENUM_CAST (code))
2522 case Alogior:
2523 case Alogxor:
2524 case Aadd:
2525 case Asub:
2526 accum = 0;
2527 break;
2528 case Amult:
2529 accum = 1;
2530 break;
2531 case Alogand:
2532 accum = -1;
2533 break;
2534 default:
2535 break;
2538 for (argnum = 0; argnum < nargs; argnum++)
2540 if (! overflow)
2542 ok_args = argnum;
2543 ok_accum = accum;
2546 /* Using args[argnum] as argument to CHECK_NUMBER_... */
2547 val = args[argnum];
2548 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2550 if (FLOATP (val))
2551 return float_arith_driver (ok_accum, ok_args, code,
2552 nargs, args);
2553 args[argnum] = val;
2554 next = XINT (args[argnum]);
2555 switch (SWITCH_ENUM_CAST (code))
2557 case Aadd:
2558 if (INT_ADD_OVERFLOW (accum, next))
2560 overflow = 1;
2561 accum &= INTMASK;
2563 accum += next;
2564 break;
2565 case Asub:
2566 if (INT_SUBTRACT_OVERFLOW (accum, next))
2568 overflow = 1;
2569 accum &= INTMASK;
2571 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2572 break;
2573 case Amult:
2574 if (INT_MULTIPLY_OVERFLOW (accum, next))
2576 EMACS_UINT a = accum, b = next, ab = a * b;
2577 overflow = 1;
2578 accum = ab & INTMASK;
2580 else
2581 accum *= next;
2582 break;
2583 case Adiv:
2584 if (!argnum)
2585 accum = next;
2586 else
2588 if (next == 0)
2589 xsignal0 (Qarith_error);
2590 accum /= next;
2592 break;
2593 case Alogand:
2594 accum &= next;
2595 break;
2596 case Alogior:
2597 accum |= next;
2598 break;
2599 case Alogxor:
2600 accum ^= next;
2601 break;
2602 case Amax:
2603 if (!argnum || next > accum)
2604 accum = next;
2605 break;
2606 case Amin:
2607 if (!argnum || next < accum)
2608 accum = next;
2609 break;
2613 XSETINT (val, accum);
2614 return val;
2617 #undef isnan
2618 #define isnan(x) ((x) != (x))
2620 static Lisp_Object
2621 float_arith_driver (double accum, ptrdiff_t argnum, enum arithop code,
2622 ptrdiff_t nargs, Lisp_Object *args)
2624 register Lisp_Object val;
2625 double next;
2627 for (; argnum < nargs; argnum++)
2629 val = args[argnum]; /* using args[argnum] as argument to CHECK_NUMBER_... */
2630 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2632 if (FLOATP (val))
2634 next = XFLOAT_DATA (val);
2636 else
2638 args[argnum] = val; /* runs into a compiler bug. */
2639 next = XINT (args[argnum]);
2641 switch (SWITCH_ENUM_CAST (code))
2643 case Aadd:
2644 accum += next;
2645 break;
2646 case Asub:
2647 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2648 break;
2649 case Amult:
2650 accum *= next;
2651 break;
2652 case Adiv:
2653 if (!argnum)
2654 accum = next;
2655 else
2657 if (! IEEE_FLOATING_POINT && next == 0)
2658 xsignal0 (Qarith_error);
2659 accum /= next;
2661 break;
2662 case Alogand:
2663 case Alogior:
2664 case Alogxor:
2665 return wrong_type_argument (Qinteger_or_marker_p, val);
2666 case Amax:
2667 if (!argnum || isnan (next) || next > accum)
2668 accum = next;
2669 break;
2670 case Amin:
2671 if (!argnum || isnan (next) || next < accum)
2672 accum = next;
2673 break;
2677 return make_float (accum);
2681 DEFUN ("+", Fplus, Splus, 0, MANY, 0,
2682 doc: /* Return sum of any number of arguments, which are numbers or markers.
2683 usage: (+ &rest NUMBERS-OR-MARKERS) */)
2684 (ptrdiff_t nargs, Lisp_Object *args)
2686 return arith_driver (Aadd, nargs, args);
2689 DEFUN ("-", Fminus, Sminus, 0, MANY, 0,
2690 doc: /* Negate number or subtract numbers or markers and return the result.
2691 With one arg, negates it. With more than one arg,
2692 subtracts all but the first from the first.
2693 usage: (- &optional NUMBER-OR-MARKER &rest MORE-NUMBERS-OR-MARKERS) */)
2694 (ptrdiff_t nargs, Lisp_Object *args)
2696 return arith_driver (Asub, nargs, args);
2699 DEFUN ("*", Ftimes, Stimes, 0, MANY, 0,
2700 doc: /* Return product of any number of arguments, which are numbers or markers.
2701 usage: (* &rest NUMBERS-OR-MARKERS) */)
2702 (ptrdiff_t nargs, Lisp_Object *args)
2704 return arith_driver (Amult, nargs, args);
2707 DEFUN ("/", Fquo, Squo, 2, MANY, 0,
2708 doc: /* Return first argument divided by all the remaining arguments.
2709 The arguments must be numbers or markers.
2710 usage: (/ DIVIDEND DIVISOR &rest DIVISORS) */)
2711 (ptrdiff_t nargs, Lisp_Object *args)
2713 ptrdiff_t argnum;
2714 for (argnum = 2; argnum < nargs; argnum++)
2715 if (FLOATP (args[argnum]))
2716 return float_arith_driver (0, 0, Adiv, nargs, args);
2717 return arith_driver (Adiv, nargs, args);
2720 DEFUN ("%", Frem, Srem, 2, 2, 0,
2721 doc: /* Return remainder of X divided by Y.
2722 Both must be integers or markers. */)
2723 (register Lisp_Object x, Lisp_Object y)
2725 Lisp_Object val;
2727 CHECK_NUMBER_COERCE_MARKER (x);
2728 CHECK_NUMBER_COERCE_MARKER (y);
2730 if (XFASTINT (y) == 0)
2731 xsignal0 (Qarith_error);
2733 XSETINT (val, XINT (x) % XINT (y));
2734 return val;
2737 #ifndef HAVE_FMOD
2738 double
2739 fmod (f1, f2)
2740 double f1, f2;
2742 double r = f1;
2744 if (f2 < 0.0)
2745 f2 = -f2;
2747 /* If the magnitude of the result exceeds that of the divisor, or
2748 the sign of the result does not agree with that of the dividend,
2749 iterate with the reduced value. This does not yield a
2750 particularly accurate result, but at least it will be in the
2751 range promised by fmod. */
2753 r -= f2 * floor (r / f2);
2754 while (f2 <= (r < 0 ? -r : r) || ((r < 0) != (f1 < 0) && ! isnan (r)));
2756 return r;
2758 #endif /* ! HAVE_FMOD */
2760 DEFUN ("mod", Fmod, Smod, 2, 2, 0,
2761 doc: /* Return X modulo Y.
2762 The result falls between zero (inclusive) and Y (exclusive).
2763 Both X and Y must be numbers or markers. */)
2764 (register Lisp_Object x, Lisp_Object y)
2766 Lisp_Object val;
2767 EMACS_INT i1, i2;
2769 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (x);
2770 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (y);
2772 if (FLOATP (x) || FLOATP (y))
2773 return fmod_float (x, y);
2775 i1 = XINT (x);
2776 i2 = XINT (y);
2778 if (i2 == 0)
2779 xsignal0 (Qarith_error);
2781 i1 %= i2;
2783 /* If the "remainder" comes out with the wrong sign, fix it. */
2784 if (i2 < 0 ? i1 > 0 : i1 < 0)
2785 i1 += i2;
2787 XSETINT (val, i1);
2788 return val;
2791 DEFUN ("max", Fmax, Smax, 1, MANY, 0,
2792 doc: /* Return largest of all the arguments (which must be numbers or markers).
2793 The value is always a number; markers are converted to numbers.
2794 usage: (max NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2795 (ptrdiff_t nargs, Lisp_Object *args)
2797 return arith_driver (Amax, nargs, args);
2800 DEFUN ("min", Fmin, Smin, 1, MANY, 0,
2801 doc: /* Return smallest of all the arguments (which must be numbers or markers).
2802 The value is always a number; markers are converted to numbers.
2803 usage: (min NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2804 (ptrdiff_t nargs, Lisp_Object *args)
2806 return arith_driver (Amin, nargs, args);
2809 DEFUN ("logand", Flogand, Slogand, 0, MANY, 0,
2810 doc: /* Return bitwise-and of all the arguments.
2811 Arguments may be integers, or markers converted to integers.
2812 usage: (logand &rest INTS-OR-MARKERS) */)
2813 (ptrdiff_t nargs, Lisp_Object *args)
2815 return arith_driver (Alogand, nargs, args);
2818 DEFUN ("logior", Flogior, Slogior, 0, MANY, 0,
2819 doc: /* Return bitwise-or of all the arguments.
2820 Arguments may be integers, or markers converted to integers.
2821 usage: (logior &rest INTS-OR-MARKERS) */)
2822 (ptrdiff_t nargs, Lisp_Object *args)
2824 return arith_driver (Alogior, nargs, args);
2827 DEFUN ("logxor", Flogxor, Slogxor, 0, MANY, 0,
2828 doc: /* Return bitwise-exclusive-or of all the arguments.
2829 Arguments may be integers, or markers converted to integers.
2830 usage: (logxor &rest INTS-OR-MARKERS) */)
2831 (ptrdiff_t nargs, Lisp_Object *args)
2833 return arith_driver (Alogxor, nargs, args);
2836 DEFUN ("ash", Fash, Sash, 2, 2, 0,
2837 doc: /* Return VALUE with its bits shifted left by COUNT.
2838 If COUNT is negative, shifting is actually to the right.
2839 In this case, the sign bit is duplicated. */)
2840 (register Lisp_Object value, Lisp_Object count)
2842 register Lisp_Object val;
2844 CHECK_NUMBER (value);
2845 CHECK_NUMBER (count);
2847 if (XINT (count) >= BITS_PER_EMACS_INT)
2848 XSETINT (val, 0);
2849 else if (XINT (count) > 0)
2850 XSETINT (val, XINT (value) << XFASTINT (count));
2851 else if (XINT (count) <= -BITS_PER_EMACS_INT)
2852 XSETINT (val, XINT (value) < 0 ? -1 : 0);
2853 else
2854 XSETINT (val, XINT (value) >> -XINT (count));
2855 return val;
2858 DEFUN ("lsh", Flsh, Slsh, 2, 2, 0,
2859 doc: /* Return VALUE with its bits shifted left by COUNT.
2860 If COUNT is negative, shifting is actually to the right.
2861 In this case, zeros are shifted in on the left. */)
2862 (register Lisp_Object value, Lisp_Object count)
2864 register Lisp_Object val;
2866 CHECK_NUMBER (value);
2867 CHECK_NUMBER (count);
2869 if (XINT (count) >= BITS_PER_EMACS_INT)
2870 XSETINT (val, 0);
2871 else if (XINT (count) > 0)
2872 XSETINT (val, XUINT (value) << XFASTINT (count));
2873 else if (XINT (count) <= -BITS_PER_EMACS_INT)
2874 XSETINT (val, 0);
2875 else
2876 XSETINT (val, XUINT (value) >> -XINT (count));
2877 return val;
2880 DEFUN ("1+", Fadd1, Sadd1, 1, 1, 0,
2881 doc: /* Return NUMBER plus one. NUMBER may be a number or a marker.
2882 Markers are converted to integers. */)
2883 (register Lisp_Object number)
2885 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
2887 if (FLOATP (number))
2888 return (make_float (1.0 + XFLOAT_DATA (number)));
2890 XSETINT (number, XINT (number) + 1);
2891 return number;
2894 DEFUN ("1-", Fsub1, Ssub1, 1, 1, 0,
2895 doc: /* Return NUMBER minus one. NUMBER may be a number or a marker.
2896 Markers are converted to integers. */)
2897 (register Lisp_Object number)
2899 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
2901 if (FLOATP (number))
2902 return (make_float (-1.0 + XFLOAT_DATA (number)));
2904 XSETINT (number, XINT (number) - 1);
2905 return number;
2908 DEFUN ("lognot", Flognot, Slognot, 1, 1, 0,
2909 doc: /* Return the bitwise complement of NUMBER. NUMBER must be an integer. */)
2910 (register Lisp_Object number)
2912 CHECK_NUMBER (number);
2913 XSETINT (number, ~XINT (number));
2914 return number;
2917 DEFUN ("byteorder", Fbyteorder, Sbyteorder, 0, 0, 0,
2918 doc: /* Return the byteorder for the machine.
2919 Returns 66 (ASCII uppercase B) for big endian machines or 108 (ASCII
2920 lowercase l) for small endian machines. */)
2921 (void)
2923 unsigned i = 0x04030201;
2924 int order = *(char *)&i == 1 ? 108 : 66;
2926 return make_number (order);
2931 void
2932 syms_of_data (void)
2934 Lisp_Object error_tail, arith_tail;
2936 DEFSYM (Qquote, "quote");
2937 DEFSYM (Qlambda, "lambda");
2938 DEFSYM (Qsubr, "subr");
2939 DEFSYM (Qerror_conditions, "error-conditions");
2940 DEFSYM (Qerror_message, "error-message");
2941 DEFSYM (Qtop_level, "top-level");
2943 DEFSYM (Qerror, "error");
2944 DEFSYM (Qquit, "quit");
2945 DEFSYM (Qwrong_type_argument, "wrong-type-argument");
2946 DEFSYM (Qargs_out_of_range, "args-out-of-range");
2947 DEFSYM (Qvoid_function, "void-function");
2948 DEFSYM (Qcyclic_function_indirection, "cyclic-function-indirection");
2949 DEFSYM (Qcyclic_variable_indirection, "cyclic-variable-indirection");
2950 DEFSYM (Qvoid_variable, "void-variable");
2951 DEFSYM (Qsetting_constant, "setting-constant");
2952 DEFSYM (Qinvalid_read_syntax, "invalid-read-syntax");
2954 DEFSYM (Qinvalid_function, "invalid-function");
2955 DEFSYM (Qwrong_number_of_arguments, "wrong-number-of-arguments");
2956 DEFSYM (Qno_catch, "no-catch");
2957 DEFSYM (Qend_of_file, "end-of-file");
2958 DEFSYM (Qarith_error, "arith-error");
2959 DEFSYM (Qbeginning_of_buffer, "beginning-of-buffer");
2960 DEFSYM (Qend_of_buffer, "end-of-buffer");
2961 DEFSYM (Qbuffer_read_only, "buffer-read-only");
2962 DEFSYM (Qtext_read_only, "text-read-only");
2963 DEFSYM (Qmark_inactive, "mark-inactive");
2965 DEFSYM (Qlistp, "listp");
2966 DEFSYM (Qconsp, "consp");
2967 DEFSYM (Qsymbolp, "symbolp");
2968 DEFSYM (Qkeywordp, "keywordp");
2969 DEFSYM (Qintegerp, "integerp");
2970 DEFSYM (Qnatnump, "natnump");
2971 DEFSYM (Qwholenump, "wholenump");
2972 DEFSYM (Qstringp, "stringp");
2973 DEFSYM (Qarrayp, "arrayp");
2974 DEFSYM (Qsequencep, "sequencep");
2975 DEFSYM (Qbufferp, "bufferp");
2976 DEFSYM (Qvectorp, "vectorp");
2977 DEFSYM (Qchar_or_string_p, "char-or-string-p");
2978 DEFSYM (Qmarkerp, "markerp");
2979 DEFSYM (Qbuffer_or_string_p, "buffer-or-string-p");
2980 DEFSYM (Qinteger_or_marker_p, "integer-or-marker-p");
2981 DEFSYM (Qboundp, "boundp");
2982 DEFSYM (Qfboundp, "fboundp");
2984 DEFSYM (Qfloatp, "floatp");
2985 DEFSYM (Qnumberp, "numberp");
2986 DEFSYM (Qnumber_or_marker_p, "number-or-marker-p");
2988 DEFSYM (Qchar_table_p, "char-table-p");
2989 DEFSYM (Qvector_or_char_table_p, "vector-or-char-table-p");
2991 DEFSYM (Qsubrp, "subrp");
2992 DEFSYM (Qunevalled, "unevalled");
2993 DEFSYM (Qmany, "many");
2995 DEFSYM (Qcdr, "cdr");
2997 /* Handle automatic advice activation. */
2998 DEFSYM (Qad_advice_info, "ad-advice-info");
2999 DEFSYM (Qad_activate_internal, "ad-activate-internal");
3001 error_tail = pure_cons (Qerror, Qnil);
3003 /* ERROR is used as a signaler for random errors for which nothing else is
3004 right. */
3006 Fput (Qerror, Qerror_conditions,
3007 error_tail);
3008 Fput (Qerror, Qerror_message,
3009 make_pure_c_string ("error"));
3011 Fput (Qquit, Qerror_conditions,
3012 pure_cons (Qquit, Qnil));
3013 Fput (Qquit, Qerror_message,
3014 make_pure_c_string ("Quit"));
3016 Fput (Qwrong_type_argument, Qerror_conditions,
3017 pure_cons (Qwrong_type_argument, error_tail));
3018 Fput (Qwrong_type_argument, Qerror_message,
3019 make_pure_c_string ("Wrong type argument"));
3021 Fput (Qargs_out_of_range, Qerror_conditions,
3022 pure_cons (Qargs_out_of_range, error_tail));
3023 Fput (Qargs_out_of_range, Qerror_message,
3024 make_pure_c_string ("Args out of range"));
3026 Fput (Qvoid_function, Qerror_conditions,
3027 pure_cons (Qvoid_function, error_tail));
3028 Fput (Qvoid_function, Qerror_message,
3029 make_pure_c_string ("Symbol's function definition is void"));
3031 Fput (Qcyclic_function_indirection, Qerror_conditions,
3032 pure_cons (Qcyclic_function_indirection, error_tail));
3033 Fput (Qcyclic_function_indirection, Qerror_message,
3034 make_pure_c_string ("Symbol's chain of function indirections contains a loop"));
3036 Fput (Qcyclic_variable_indirection, Qerror_conditions,
3037 pure_cons (Qcyclic_variable_indirection, error_tail));
3038 Fput (Qcyclic_variable_indirection, Qerror_message,
3039 make_pure_c_string ("Symbol's chain of variable indirections contains a loop"));
3041 DEFSYM (Qcircular_list, "circular-list");
3042 Fput (Qcircular_list, Qerror_conditions,
3043 pure_cons (Qcircular_list, error_tail));
3044 Fput (Qcircular_list, Qerror_message,
3045 make_pure_c_string ("List contains a loop"));
3047 Fput (Qvoid_variable, Qerror_conditions,
3048 pure_cons (Qvoid_variable, error_tail));
3049 Fput (Qvoid_variable, Qerror_message,
3050 make_pure_c_string ("Symbol's value as variable is void"));
3052 Fput (Qsetting_constant, Qerror_conditions,
3053 pure_cons (Qsetting_constant, error_tail));
3054 Fput (Qsetting_constant, Qerror_message,
3055 make_pure_c_string ("Attempt to set a constant symbol"));
3057 Fput (Qinvalid_read_syntax, Qerror_conditions,
3058 pure_cons (Qinvalid_read_syntax, error_tail));
3059 Fput (Qinvalid_read_syntax, Qerror_message,
3060 make_pure_c_string ("Invalid read syntax"));
3062 Fput (Qinvalid_function, Qerror_conditions,
3063 pure_cons (Qinvalid_function, error_tail));
3064 Fput (Qinvalid_function, Qerror_message,
3065 make_pure_c_string ("Invalid function"));
3067 Fput (Qwrong_number_of_arguments, Qerror_conditions,
3068 pure_cons (Qwrong_number_of_arguments, error_tail));
3069 Fput (Qwrong_number_of_arguments, Qerror_message,
3070 make_pure_c_string ("Wrong number of arguments"));
3072 Fput (Qno_catch, Qerror_conditions,
3073 pure_cons (Qno_catch, error_tail));
3074 Fput (Qno_catch, Qerror_message,
3075 make_pure_c_string ("No catch for tag"));
3077 Fput (Qend_of_file, Qerror_conditions,
3078 pure_cons (Qend_of_file, error_tail));
3079 Fput (Qend_of_file, Qerror_message,
3080 make_pure_c_string ("End of file during parsing"));
3082 arith_tail = pure_cons (Qarith_error, error_tail);
3083 Fput (Qarith_error, Qerror_conditions,
3084 arith_tail);
3085 Fput (Qarith_error, Qerror_message,
3086 make_pure_c_string ("Arithmetic error"));
3088 Fput (Qbeginning_of_buffer, Qerror_conditions,
3089 pure_cons (Qbeginning_of_buffer, error_tail));
3090 Fput (Qbeginning_of_buffer, Qerror_message,
3091 make_pure_c_string ("Beginning of buffer"));
3093 Fput (Qend_of_buffer, Qerror_conditions,
3094 pure_cons (Qend_of_buffer, error_tail));
3095 Fput (Qend_of_buffer, Qerror_message,
3096 make_pure_c_string ("End of buffer"));
3098 Fput (Qbuffer_read_only, Qerror_conditions,
3099 pure_cons (Qbuffer_read_only, error_tail));
3100 Fput (Qbuffer_read_only, Qerror_message,
3101 make_pure_c_string ("Buffer is read-only"));
3103 Fput (Qtext_read_only, Qerror_conditions,
3104 pure_cons (Qtext_read_only, error_tail));
3105 Fput (Qtext_read_only, Qerror_message,
3106 make_pure_c_string ("Text is read-only"));
3108 DEFSYM (Qrange_error, "range-error");
3109 DEFSYM (Qdomain_error, "domain-error");
3110 DEFSYM (Qsingularity_error, "singularity-error");
3111 DEFSYM (Qoverflow_error, "overflow-error");
3112 DEFSYM (Qunderflow_error, "underflow-error");
3114 Fput (Qdomain_error, Qerror_conditions,
3115 pure_cons (Qdomain_error, arith_tail));
3116 Fput (Qdomain_error, Qerror_message,
3117 make_pure_c_string ("Arithmetic domain error"));
3119 Fput (Qrange_error, Qerror_conditions,
3120 pure_cons (Qrange_error, arith_tail));
3121 Fput (Qrange_error, Qerror_message,
3122 make_pure_c_string ("Arithmetic range error"));
3124 Fput (Qsingularity_error, Qerror_conditions,
3125 pure_cons (Qsingularity_error, Fcons (Qdomain_error, arith_tail)));
3126 Fput (Qsingularity_error, Qerror_message,
3127 make_pure_c_string ("Arithmetic singularity error"));
3129 Fput (Qoverflow_error, Qerror_conditions,
3130 pure_cons (Qoverflow_error, Fcons (Qdomain_error, arith_tail)));
3131 Fput (Qoverflow_error, Qerror_message,
3132 make_pure_c_string ("Arithmetic overflow error"));
3134 Fput (Qunderflow_error, Qerror_conditions,
3135 pure_cons (Qunderflow_error, Fcons (Qdomain_error, arith_tail)));
3136 Fput (Qunderflow_error, Qerror_message,
3137 make_pure_c_string ("Arithmetic underflow error"));
3139 staticpro (&Qnil);
3140 staticpro (&Qt);
3141 staticpro (&Qunbound);
3143 /* Types that type-of returns. */
3144 DEFSYM (Qinteger, "integer");
3145 DEFSYM (Qsymbol, "symbol");
3146 DEFSYM (Qstring, "string");
3147 DEFSYM (Qcons, "cons");
3148 DEFSYM (Qmarker, "marker");
3149 DEFSYM (Qoverlay, "overlay");
3150 DEFSYM (Qfloat, "float");
3151 DEFSYM (Qwindow_configuration, "window-configuration");
3152 DEFSYM (Qprocess, "process");
3153 DEFSYM (Qwindow, "window");
3154 /* DEFSYM (Qsubr, "subr"); */
3155 DEFSYM (Qcompiled_function, "compiled-function");
3156 DEFSYM (Qbuffer, "buffer");
3157 DEFSYM (Qframe, "frame");
3158 DEFSYM (Qvector, "vector");
3159 DEFSYM (Qchar_table, "char-table");
3160 DEFSYM (Qbool_vector, "bool-vector");
3161 DEFSYM (Qhash_table, "hash-table");
3163 DEFSYM (Qfont_spec, "font-spec");
3164 DEFSYM (Qfont_entity, "font-entity");
3165 DEFSYM (Qfont_object, "font-object");
3167 DEFSYM (Qinteractive_form, "interactive-form");
3169 defsubr (&Sindirect_variable);
3170 defsubr (&Sinteractive_form);
3171 defsubr (&Seq);
3172 defsubr (&Snull);
3173 defsubr (&Stype_of);
3174 defsubr (&Slistp);
3175 defsubr (&Snlistp);
3176 defsubr (&Sconsp);
3177 defsubr (&Satom);
3178 defsubr (&Sintegerp);
3179 defsubr (&Sinteger_or_marker_p);
3180 defsubr (&Snumberp);
3181 defsubr (&Snumber_or_marker_p);
3182 defsubr (&Sfloatp);
3183 defsubr (&Snatnump);
3184 defsubr (&Ssymbolp);
3185 defsubr (&Skeywordp);
3186 defsubr (&Sstringp);
3187 defsubr (&Smultibyte_string_p);
3188 defsubr (&Svectorp);
3189 defsubr (&Schar_table_p);
3190 defsubr (&Svector_or_char_table_p);
3191 defsubr (&Sbool_vector_p);
3192 defsubr (&Sarrayp);
3193 defsubr (&Ssequencep);
3194 defsubr (&Sbufferp);
3195 defsubr (&Smarkerp);
3196 defsubr (&Ssubrp);
3197 defsubr (&Sbyte_code_function_p);
3198 defsubr (&Schar_or_string_p);
3199 defsubr (&Scar);
3200 defsubr (&Scdr);
3201 defsubr (&Scar_safe);
3202 defsubr (&Scdr_safe);
3203 defsubr (&Ssetcar);
3204 defsubr (&Ssetcdr);
3205 defsubr (&Ssymbol_function);
3206 defsubr (&Sindirect_function);
3207 defsubr (&Ssymbol_plist);
3208 defsubr (&Ssymbol_name);
3209 defsubr (&Smakunbound);
3210 defsubr (&Sfmakunbound);
3211 defsubr (&Sboundp);
3212 defsubr (&Sfboundp);
3213 defsubr (&Sfset);
3214 defsubr (&Sdefalias);
3215 defsubr (&Ssetplist);
3216 defsubr (&Ssymbol_value);
3217 defsubr (&Sset);
3218 defsubr (&Sdefault_boundp);
3219 defsubr (&Sdefault_value);
3220 defsubr (&Sset_default);
3221 defsubr (&Ssetq_default);
3222 defsubr (&Smake_variable_buffer_local);
3223 defsubr (&Smake_local_variable);
3224 defsubr (&Skill_local_variable);
3225 defsubr (&Smake_variable_frame_local);
3226 defsubr (&Slocal_variable_p);
3227 defsubr (&Slocal_variable_if_set_p);
3228 defsubr (&Svariable_binding_locus);
3229 #if 0 /* XXX Remove this. --lorentey */
3230 defsubr (&Sterminal_local_value);
3231 defsubr (&Sset_terminal_local_value);
3232 #endif
3233 defsubr (&Saref);
3234 defsubr (&Saset);
3235 defsubr (&Snumber_to_string);
3236 defsubr (&Sstring_to_number);
3237 defsubr (&Seqlsign);
3238 defsubr (&Slss);
3239 defsubr (&Sgtr);
3240 defsubr (&Sleq);
3241 defsubr (&Sgeq);
3242 defsubr (&Sneq);
3243 defsubr (&Szerop);
3244 defsubr (&Splus);
3245 defsubr (&Sminus);
3246 defsubr (&Stimes);
3247 defsubr (&Squo);
3248 defsubr (&Srem);
3249 defsubr (&Smod);
3250 defsubr (&Smax);
3251 defsubr (&Smin);
3252 defsubr (&Slogand);
3253 defsubr (&Slogior);
3254 defsubr (&Slogxor);
3255 defsubr (&Slsh);
3256 defsubr (&Sash);
3257 defsubr (&Sadd1);
3258 defsubr (&Ssub1);
3259 defsubr (&Slognot);
3260 defsubr (&Sbyteorder);
3261 defsubr (&Ssubr_arity);
3262 defsubr (&Ssubr_name);
3264 XSYMBOL (Qwholenump)->function = XSYMBOL (Qnatnump)->function;
3266 DEFVAR_LISP ("most-positive-fixnum", Vmost_positive_fixnum,
3267 doc: /* The largest value that is representable in a Lisp integer. */);
3268 Vmost_positive_fixnum = make_number (MOST_POSITIVE_FIXNUM);
3269 XSYMBOL (intern_c_string ("most-positive-fixnum"))->constant = 1;
3271 DEFVAR_LISP ("most-negative-fixnum", Vmost_negative_fixnum,
3272 doc: /* The smallest value that is representable in a Lisp integer. */);
3273 Vmost_negative_fixnum = make_number (MOST_NEGATIVE_FIXNUM);
3274 XSYMBOL (intern_c_string ("most-negative-fixnum"))->constant = 1;
3277 #ifndef FORWARD_SIGNAL_TO_MAIN_THREAD
3278 static void arith_error (int) NO_RETURN;
3279 #endif
3281 static void
3282 arith_error (int signo)
3284 sigsetmask (SIGEMPTYMASK);
3286 SIGNAL_THREAD_CHECK (signo);
3287 xsignal0 (Qarith_error);
3290 void
3291 init_data (void)
3293 /* Don't do this if just dumping out.
3294 We don't want to call `signal' in this case
3295 so that we don't have trouble with dumping
3296 signal-delivering routines in an inconsistent state. */
3297 #ifndef CANNOT_DUMP
3298 if (!initialized)
3299 return;
3300 #endif /* CANNOT_DUMP */
3301 signal (SIGFPE, arith_error);