(completion-all-sorted-completions): New var.
[emacs.git] / src / data.c
blobf86d5c7c61b4d7070d77321366313a712433ec9b
1 /* Primitive operations on Lisp data types for GNU Emacs Lisp interpreter.
2 Copyright (C) 1985, 1986, 1988, 1993, 1994, 1995, 1997, 1998, 1999, 2000,
3 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
4 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
22 #include <config.h>
23 #include <signal.h>
24 #include <stdio.h>
25 #include "lisp.h"
26 #include "puresize.h"
27 #include "character.h"
28 #include "buffer.h"
29 #include "keyboard.h"
30 #include "frame.h"
31 #include "syssignal.h"
32 #include "termhooks.h" /* For FRAME_KBOARD reference in y-or-n-p. */
34 #ifdef STDC_HEADERS
35 #include <float.h>
36 #endif
38 /* If IEEE_FLOATING_POINT isn't defined, default it from FLT_*. */
39 #ifndef IEEE_FLOATING_POINT
40 #if (FLT_RADIX == 2 && FLT_MANT_DIG == 24 \
41 && FLT_MIN_EXP == -125 && FLT_MAX_EXP == 128)
42 #define IEEE_FLOATING_POINT 1
43 #else
44 #define IEEE_FLOATING_POINT 0
45 #endif
46 #endif
48 /* Work around a problem that happens because math.h on hpux 7
49 defines two static variables--which, in Emacs, are not really static,
50 because `static' is defined as nothing. The problem is that they are
51 here, in floatfns.c, and in lread.c.
52 These macros prevent the name conflict. */
53 #if defined (HPUX) && !defined (HPUX8)
54 #define _MAXLDBL data_c_maxldbl
55 #define _NMAXLDBL data_c_nmaxldbl
56 #endif
58 #include <math.h>
60 #if !defined (atof)
61 extern double atof ();
62 #endif /* !atof */
64 Lisp_Object Qnil, Qt, Qquote, Qlambda, Qsubr, Qunbound;
65 Lisp_Object Qerror_conditions, Qerror_message, Qtop_level;
66 Lisp_Object Qerror, Qquit, Qwrong_type_argument, Qargs_out_of_range;
67 Lisp_Object Qvoid_variable, Qvoid_function, Qcyclic_function_indirection;
68 Lisp_Object Qcyclic_variable_indirection, Qcircular_list;
69 Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
70 Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
71 Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
72 Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
73 Lisp_Object Qtext_read_only;
75 Lisp_Object Qintegerp, Qnatnump, Qwholenump, Qsymbolp, Qlistp, Qconsp;
76 Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp;
77 Lisp_Object Qchar_or_string_p, Qmarkerp, Qinteger_or_marker_p, Qvectorp;
78 Lisp_Object Qbuffer_or_string_p, Qkeywordp;
79 Lisp_Object Qboundp, Qfboundp;
80 Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
82 Lisp_Object Qcdr;
83 Lisp_Object Qad_advice_info, Qad_activate_internal;
85 Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
86 Lisp_Object Qoverflow_error, Qunderflow_error;
88 Lisp_Object Qfloatp;
89 Lisp_Object Qnumberp, Qnumber_or_marker_p;
91 Lisp_Object Qinteger;
92 static Lisp_Object Qsymbol, Qstring, Qcons, Qmarker, Qoverlay;
93 static Lisp_Object Qfloat, Qwindow_configuration, Qwindow;
94 Lisp_Object Qprocess;
95 static Lisp_Object Qcompiled_function, Qbuffer, Qframe, Qvector;
96 static Lisp_Object Qchar_table, Qbool_vector, Qhash_table;
97 static Lisp_Object Qsubrp, Qmany, Qunevalled;
99 static Lisp_Object swap_in_symval_forwarding P_ ((Lisp_Object, Lisp_Object));
101 Lisp_Object Vmost_positive_fixnum, Vmost_negative_fixnum;
104 void
105 circular_list_error (list)
106 Lisp_Object list;
108 xsignal (Qcircular_list, list);
112 Lisp_Object
113 wrong_type_argument (predicate, value)
114 register Lisp_Object predicate, value;
116 /* If VALUE is not even a valid Lisp object, abort here
117 where we can get a backtrace showing where it came from. */
118 if ((unsigned int) XTYPE (value) >= Lisp_Type_Limit)
119 abort ();
121 xsignal2 (Qwrong_type_argument, predicate, value);
124 void
125 pure_write_error ()
127 error ("Attempt to modify read-only object");
130 void
131 args_out_of_range (a1, a2)
132 Lisp_Object a1, a2;
134 xsignal2 (Qargs_out_of_range, a1, a2);
137 void
138 args_out_of_range_3 (a1, a2, a3)
139 Lisp_Object a1, a2, a3;
141 xsignal3 (Qargs_out_of_range, a1, a2, a3);
144 /* On some machines, XINT needs a temporary location.
145 Here it is, in case it is needed. */
147 int sign_extend_temp;
149 /* On a few machines, XINT can only be done by calling this. */
152 sign_extend_lisp_int (num)
153 EMACS_INT num;
155 if (num & (((EMACS_INT) 1) << (VALBITS - 1)))
156 return num | (((EMACS_INT) (-1)) << VALBITS);
157 else
158 return num & ((((EMACS_INT) 1) << VALBITS) - 1);
161 /* Data type predicates */
163 DEFUN ("eq", Feq, Seq, 2, 2, 0,
164 doc: /* Return t if the two args are the same Lisp object. */)
165 (obj1, obj2)
166 Lisp_Object obj1, obj2;
168 if (EQ (obj1, obj2))
169 return Qt;
170 return Qnil;
173 DEFUN ("null", Fnull, Snull, 1, 1, 0,
174 doc: /* Return t if OBJECT is nil. */)
175 (object)
176 Lisp_Object object;
178 if (NILP (object))
179 return Qt;
180 return Qnil;
183 DEFUN ("type-of", Ftype_of, Stype_of, 1, 1, 0,
184 doc: /* Return a symbol representing the type of OBJECT.
185 The symbol returned names the object's basic type;
186 for example, (type-of 1) returns `integer'. */)
187 (object)
188 Lisp_Object object;
190 switch (XTYPE (object))
192 case Lisp_Int:
193 return Qinteger;
195 case Lisp_Symbol:
196 return Qsymbol;
198 case Lisp_String:
199 return Qstring;
201 case Lisp_Cons:
202 return Qcons;
204 case Lisp_Misc:
205 switch (XMISCTYPE (object))
207 case Lisp_Misc_Marker:
208 return Qmarker;
209 case Lisp_Misc_Overlay:
210 return Qoverlay;
211 case Lisp_Misc_Float:
212 return Qfloat;
214 abort ();
216 case Lisp_Vectorlike:
217 if (WINDOW_CONFIGURATIONP (object))
218 return Qwindow_configuration;
219 if (PROCESSP (object))
220 return Qprocess;
221 if (WINDOWP (object))
222 return Qwindow;
223 if (SUBRP (object))
224 return Qsubr;
225 if (COMPILEDP (object))
226 return Qcompiled_function;
227 if (BUFFERP (object))
228 return Qbuffer;
229 if (CHAR_TABLE_P (object))
230 return Qchar_table;
231 if (BOOL_VECTOR_P (object))
232 return Qbool_vector;
233 if (FRAMEP (object))
234 return Qframe;
235 if (HASH_TABLE_P (object))
236 return Qhash_table;
237 return Qvector;
239 case Lisp_Float:
240 return Qfloat;
242 default:
243 abort ();
247 DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0,
248 doc: /* Return t if OBJECT is a cons cell. */)
249 (object)
250 Lisp_Object object;
252 if (CONSP (object))
253 return Qt;
254 return Qnil;
257 DEFUN ("atom", Fatom, Satom, 1, 1, 0,
258 doc: /* Return t if OBJECT is not a cons cell. This includes nil. */)
259 (object)
260 Lisp_Object object;
262 if (CONSP (object))
263 return Qnil;
264 return Qt;
267 DEFUN ("listp", Flistp, Slistp, 1, 1, 0,
268 doc: /* Return t if OBJECT is a list, that is, a cons cell or nil.
269 Otherwise, return nil. */)
270 (object)
271 Lisp_Object object;
273 if (CONSP (object) || NILP (object))
274 return Qt;
275 return Qnil;
278 DEFUN ("nlistp", Fnlistp, Snlistp, 1, 1, 0,
279 doc: /* Return t if OBJECT is not a list. Lists include nil. */)
280 (object)
281 Lisp_Object object;
283 if (CONSP (object) || NILP (object))
284 return Qnil;
285 return Qt;
288 DEFUN ("symbolp", Fsymbolp, Ssymbolp, 1, 1, 0,
289 doc: /* Return t if OBJECT is a symbol. */)
290 (object)
291 Lisp_Object object;
293 if (SYMBOLP (object))
294 return Qt;
295 return Qnil;
298 /* Define this in C to avoid unnecessarily consing up the symbol
299 name. */
300 DEFUN ("keywordp", Fkeywordp, Skeywordp, 1, 1, 0,
301 doc: /* Return t if OBJECT is a keyword.
302 This means that it is a symbol with a print name beginning with `:'
303 interned in the initial obarray. */)
304 (object)
305 Lisp_Object object;
307 if (SYMBOLP (object)
308 && SREF (SYMBOL_NAME (object), 0) == ':'
309 && SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P (object))
310 return Qt;
311 return Qnil;
314 DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
315 doc: /* Return t if OBJECT is a vector. */)
316 (object)
317 Lisp_Object object;
319 if (VECTORP (object))
320 return Qt;
321 return Qnil;
324 DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
325 doc: /* Return t if OBJECT is a string. */)
326 (object)
327 Lisp_Object object;
329 if (STRINGP (object))
330 return Qt;
331 return Qnil;
334 DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p,
335 1, 1, 0,
336 doc: /* Return t if OBJECT is a multibyte string. */)
337 (object)
338 Lisp_Object object;
340 if (STRINGP (object) && STRING_MULTIBYTE (object))
341 return Qt;
342 return Qnil;
345 DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0,
346 doc: /* Return t if OBJECT is a char-table. */)
347 (object)
348 Lisp_Object object;
350 if (CHAR_TABLE_P (object))
351 return Qt;
352 return Qnil;
355 DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p,
356 Svector_or_char_table_p, 1, 1, 0,
357 doc: /* Return t if OBJECT is a char-table or vector. */)
358 (object)
359 Lisp_Object object;
361 if (VECTORP (object) || CHAR_TABLE_P (object))
362 return Qt;
363 return Qnil;
366 DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0,
367 doc: /* Return t if OBJECT is a bool-vector. */)
368 (object)
369 Lisp_Object object;
371 if (BOOL_VECTOR_P (object))
372 return Qt;
373 return Qnil;
376 DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0,
377 doc: /* Return t if OBJECT is an array (string or vector). */)
378 (object)
379 Lisp_Object object;
381 if (ARRAYP (object))
382 return Qt;
383 return Qnil;
386 DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
387 doc: /* Return t if OBJECT is a sequence (list or array). */)
388 (object)
389 register Lisp_Object object;
391 if (CONSP (object) || NILP (object) || ARRAYP (object))
392 return Qt;
393 return Qnil;
396 DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0,
397 doc: /* Return t if OBJECT is an editor buffer. */)
398 (object)
399 Lisp_Object object;
401 if (BUFFERP (object))
402 return Qt;
403 return Qnil;
406 DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0,
407 doc: /* Return t if OBJECT is a marker (editor pointer). */)
408 (object)
409 Lisp_Object object;
411 if (MARKERP (object))
412 return Qt;
413 return Qnil;
416 DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0,
417 doc: /* Return t if OBJECT is a built-in function. */)
418 (object)
419 Lisp_Object object;
421 if (SUBRP (object))
422 return Qt;
423 return Qnil;
426 DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
427 1, 1, 0,
428 doc: /* Return t if OBJECT is a byte-compiled function object. */)
429 (object)
430 Lisp_Object object;
432 if (COMPILEDP (object))
433 return Qt;
434 return Qnil;
437 DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0,
438 doc: /* Return t if OBJECT is a character or a string. */)
439 (object)
440 register Lisp_Object object;
442 if (CHARACTERP (object) || STRINGP (object))
443 return Qt;
444 return Qnil;
447 DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0,
448 doc: /* Return t if OBJECT is an integer. */)
449 (object)
450 Lisp_Object object;
452 if (INTEGERP (object))
453 return Qt;
454 return Qnil;
457 DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0,
458 doc: /* Return t if OBJECT is an integer or a marker (editor pointer). */)
459 (object)
460 register Lisp_Object object;
462 if (MARKERP (object) || INTEGERP (object))
463 return Qt;
464 return Qnil;
467 DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
468 doc: /* Return t if OBJECT is a nonnegative integer. */)
469 (object)
470 Lisp_Object object;
472 if (NATNUMP (object))
473 return Qt;
474 return Qnil;
477 DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
478 doc: /* Return t if OBJECT is a number (floating point or integer). */)
479 (object)
480 Lisp_Object object;
482 if (NUMBERP (object))
483 return Qt;
484 else
485 return Qnil;
488 DEFUN ("number-or-marker-p", Fnumber_or_marker_p,
489 Snumber_or_marker_p, 1, 1, 0,
490 doc: /* Return t if OBJECT is a number or a marker. */)
491 (object)
492 Lisp_Object object;
494 if (NUMBERP (object) || MARKERP (object))
495 return Qt;
496 return Qnil;
499 DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
500 doc: /* Return t if OBJECT is a floating point number. */)
501 (object)
502 Lisp_Object object;
504 if (FLOATP (object))
505 return Qt;
506 return Qnil;
510 /* Extract and set components of lists */
512 DEFUN ("car", Fcar, Scar, 1, 1, 0,
513 doc: /* Return the car of LIST. If arg is nil, return nil.
514 Error if arg is not nil and not a cons cell. See also `car-safe'.
516 See Info node `(elisp)Cons Cells' for a discussion of related basic
517 Lisp concepts such as car, cdr, cons cell and list. */)
518 (list)
519 register Lisp_Object list;
521 return CAR (list);
524 DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0,
525 doc: /* Return the car of OBJECT if it is a cons cell, or else nil. */)
526 (object)
527 Lisp_Object object;
529 return CAR_SAFE (object);
532 DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
533 doc: /* Return the cdr of LIST. If arg is nil, return nil.
534 Error if arg is not nil and not a cons cell. See also `cdr-safe'.
536 See Info node `(elisp)Cons Cells' for a discussion of related basic
537 Lisp concepts such as cdr, car, cons cell and list. */)
538 (list)
539 register Lisp_Object list;
541 return CDR (list);
544 DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0,
545 doc: /* Return the cdr of OBJECT if it is a cons cell, or else nil. */)
546 (object)
547 Lisp_Object object;
549 return CDR_SAFE (object);
552 DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
553 doc: /* Set the car of CELL to be NEWCAR. Returns NEWCAR. */)
554 (cell, newcar)
555 register Lisp_Object cell, newcar;
557 CHECK_CONS (cell);
558 CHECK_IMPURE (cell);
559 XSETCAR (cell, newcar);
560 return newcar;
563 DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
564 doc: /* Set the cdr of CELL to be NEWCDR. Returns NEWCDR. */)
565 (cell, newcdr)
566 register Lisp_Object cell, newcdr;
568 CHECK_CONS (cell);
569 CHECK_IMPURE (cell);
570 XSETCDR (cell, newcdr);
571 return newcdr;
574 /* Extract and set components of symbols */
576 DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0,
577 doc: /* Return t if SYMBOL's value is not void. */)
578 (symbol)
579 register Lisp_Object symbol;
581 Lisp_Object valcontents;
582 CHECK_SYMBOL (symbol);
584 valcontents = SYMBOL_VALUE (symbol);
586 if (BUFFER_LOCAL_VALUEP (valcontents))
587 valcontents = swap_in_symval_forwarding (symbol, valcontents);
589 return (EQ (valcontents, Qunbound) ? Qnil : Qt);
592 DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0,
593 doc: /* Return t if SYMBOL's function definition is not void. */)
594 (symbol)
595 register Lisp_Object symbol;
597 CHECK_SYMBOL (symbol);
598 return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
601 DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0,
602 doc: /* Make SYMBOL's value be void.
603 Return SYMBOL. */)
604 (symbol)
605 register Lisp_Object symbol;
607 CHECK_SYMBOL (symbol);
608 if (SYMBOL_CONSTANT_P (symbol))
609 xsignal1 (Qsetting_constant, symbol);
610 Fset (symbol, Qunbound);
611 return symbol;
614 DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0,
615 doc: /* Make SYMBOL's function definition be void.
616 Return SYMBOL. */)
617 (symbol)
618 register Lisp_Object symbol;
620 CHECK_SYMBOL (symbol);
621 if (NILP (symbol) || EQ (symbol, Qt))
622 xsignal1 (Qsetting_constant, symbol);
623 XSYMBOL (symbol)->function = Qunbound;
624 return symbol;
627 DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0,
628 doc: /* Return SYMBOL's function definition. Error if that is void. */)
629 (symbol)
630 register Lisp_Object symbol;
632 CHECK_SYMBOL (symbol);
633 if (!EQ (XSYMBOL (symbol)->function, Qunbound))
634 return XSYMBOL (symbol)->function;
635 xsignal1 (Qvoid_function, symbol);
638 DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0,
639 doc: /* Return SYMBOL's property list. */)
640 (symbol)
641 register Lisp_Object symbol;
643 CHECK_SYMBOL (symbol);
644 return XSYMBOL (symbol)->plist;
647 DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0,
648 doc: /* Return SYMBOL's name, a string. */)
649 (symbol)
650 register Lisp_Object symbol;
652 register Lisp_Object name;
654 CHECK_SYMBOL (symbol);
655 name = SYMBOL_NAME (symbol);
656 return name;
659 DEFUN ("fset", Ffset, Sfset, 2, 2, 0,
660 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION. */)
661 (symbol, definition)
662 register Lisp_Object symbol, definition;
664 register Lisp_Object function;
666 CHECK_SYMBOL (symbol);
667 if (NILP (symbol) || EQ (symbol, Qt))
668 xsignal1 (Qsetting_constant, symbol);
670 function = XSYMBOL (symbol)->function;
672 if (!NILP (Vautoload_queue) && !EQ (function, Qunbound))
673 Vautoload_queue = Fcons (Fcons (symbol, function), Vautoload_queue);
675 if (CONSP (function) && EQ (XCAR (function), Qautoload))
676 Fput (symbol, Qautoload, XCDR (function));
678 XSYMBOL (symbol)->function = definition;
679 /* Handle automatic advice activation */
680 if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
682 call2 (Qad_activate_internal, symbol, Qnil);
683 definition = XSYMBOL (symbol)->function;
685 return definition;
688 extern Lisp_Object Qfunction_documentation;
690 DEFUN ("defalias", Fdefalias, Sdefalias, 2, 3, 0,
691 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION.
692 Associates the function with the current load file, if any.
693 The optional third argument DOCSTRING specifies the documentation string
694 for SYMBOL; if it is omitted or nil, SYMBOL uses the documentation string
695 determined by DEFINITION. */)
696 (symbol, definition, docstring)
697 register Lisp_Object symbol, definition, docstring;
699 CHECK_SYMBOL (symbol);
700 if (CONSP (XSYMBOL (symbol)->function)
701 && EQ (XCAR (XSYMBOL (symbol)->function), Qautoload))
702 LOADHIST_ATTACH (Fcons (Qt, symbol));
703 definition = Ffset (symbol, definition);
704 LOADHIST_ATTACH (Fcons (Qdefun, symbol));
705 if (!NILP (docstring))
706 Fput (symbol, Qfunction_documentation, docstring);
707 return definition;
710 DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
711 doc: /* Set SYMBOL's property list to NEWPLIST, and return NEWPLIST. */)
712 (symbol, newplist)
713 register Lisp_Object symbol, newplist;
715 CHECK_SYMBOL (symbol);
716 XSYMBOL (symbol)->plist = newplist;
717 return newplist;
720 DEFUN ("subr-arity", Fsubr_arity, Ssubr_arity, 1, 1, 0,
721 doc: /* Return minimum and maximum number of args allowed for SUBR.
722 SUBR must be a built-in function.
723 The returned value is a pair (MIN . MAX). MIN is the minimum number
724 of args. MAX is the maximum number or the symbol `many', for a
725 function with `&rest' args, or `unevalled' for a special form. */)
726 (subr)
727 Lisp_Object subr;
729 short minargs, maxargs;
730 CHECK_SUBR (subr);
731 minargs = XSUBR (subr)->min_args;
732 maxargs = XSUBR (subr)->max_args;
733 if (maxargs == MANY)
734 return Fcons (make_number (minargs), Qmany);
735 else if (maxargs == UNEVALLED)
736 return Fcons (make_number (minargs), Qunevalled);
737 else
738 return Fcons (make_number (minargs), make_number (maxargs));
741 DEFUN ("subr-name", Fsubr_name, Ssubr_name, 1, 1, 0,
742 doc: /* Return name of subroutine SUBR.
743 SUBR must be a built-in function. */)
744 (subr)
745 Lisp_Object subr;
747 const char *name;
748 CHECK_SUBR (subr);
749 name = XSUBR (subr)->symbol_name;
750 return make_string (name, strlen (name));
753 DEFUN ("interactive-form", Finteractive_form, Sinteractive_form, 1, 1, 0,
754 doc: /* Return the interactive form of CMD or nil if none.
755 If CMD is not a command, the return value is nil.
756 Value, if non-nil, is a list \(interactive SPEC). */)
757 (cmd)
758 Lisp_Object cmd;
760 Lisp_Object fun = indirect_function (cmd); /* Check cycles. */
762 if (NILP (fun) || EQ (fun, Qunbound))
763 return Qnil;
765 /* Use an `interactive-form' property if present, analogous to the
766 function-documentation property. */
767 fun = cmd;
768 while (SYMBOLP (fun))
770 Lisp_Object tmp = Fget (fun, intern ("interactive-form"));
771 if (!NILP (tmp))
772 return tmp;
773 else
774 fun = Fsymbol_function (fun);
777 if (SUBRP (fun))
779 char *spec = XSUBR (fun)->intspec;
780 if (spec)
781 return list2 (Qinteractive,
782 (*spec != '(') ? build_string (spec) :
783 Fcar (Fread_from_string (build_string (spec), Qnil, Qnil)));
785 else if (COMPILEDP (fun))
787 if ((ASIZE (fun) & PSEUDOVECTOR_SIZE_MASK) > COMPILED_INTERACTIVE)
788 return list2 (Qinteractive, AREF (fun, COMPILED_INTERACTIVE));
790 else if (CONSP (fun))
792 Lisp_Object funcar = XCAR (fun);
793 if (EQ (funcar, Qlambda))
794 return Fassq (Qinteractive, Fcdr (XCDR (fun)));
795 else if (EQ (funcar, Qautoload))
797 struct gcpro gcpro1;
798 GCPRO1 (cmd);
799 do_autoload (fun, cmd);
800 UNGCPRO;
801 return Finteractive_form (cmd);
804 return Qnil;
808 /***********************************************************************
809 Getting and Setting Values of Symbols
810 ***********************************************************************/
812 /* Return the symbol holding SYMBOL's value. Signal
813 `cyclic-variable-indirection' if SYMBOL's chain of variable
814 indirections contains a loop. */
816 struct Lisp_Symbol *
817 indirect_variable (symbol)
818 struct Lisp_Symbol *symbol;
820 struct Lisp_Symbol *tortoise, *hare;
822 hare = tortoise = symbol;
824 while (hare->indirect_variable)
826 hare = XSYMBOL (hare->value);
827 if (!hare->indirect_variable)
828 break;
830 hare = XSYMBOL (hare->value);
831 tortoise = XSYMBOL (tortoise->value);
833 if (hare == tortoise)
835 Lisp_Object tem;
836 XSETSYMBOL (tem, symbol);
837 xsignal1 (Qcyclic_variable_indirection, tem);
841 return hare;
845 DEFUN ("indirect-variable", Findirect_variable, Sindirect_variable, 1, 1, 0,
846 doc: /* Return the variable at the end of OBJECT's variable chain.
847 If OBJECT is a symbol, follow all variable indirections and return the final
848 variable. If OBJECT is not a symbol, just return it.
849 Signal a cyclic-variable-indirection error if there is a loop in the
850 variable chain of symbols. */)
851 (object)
852 Lisp_Object object;
854 if (SYMBOLP (object))
855 XSETSYMBOL (object, indirect_variable (XSYMBOL (object)));
856 return object;
860 /* Given the raw contents of a symbol value cell,
861 return the Lisp value of the symbol.
862 This does not handle buffer-local variables; use
863 swap_in_symval_forwarding for that. */
865 Lisp_Object
866 do_symval_forwarding (valcontents)
867 register Lisp_Object valcontents;
869 register Lisp_Object val;
870 if (MISCP (valcontents))
871 switch (XMISCTYPE (valcontents))
873 case Lisp_Misc_Intfwd:
874 XSETINT (val, *XINTFWD (valcontents)->intvar);
875 return val;
877 case Lisp_Misc_Boolfwd:
878 return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
880 case Lisp_Misc_Objfwd:
881 return *XOBJFWD (valcontents)->objvar;
883 case Lisp_Misc_Buffer_Objfwd:
884 return PER_BUFFER_VALUE (current_buffer,
885 XBUFFER_OBJFWD (valcontents)->offset);
887 case Lisp_Misc_Kboard_Objfwd:
888 /* We used to simply use current_kboard here, but from Lisp
889 code, it's value is often unexpected. It seems nicer to
890 allow constructions like this to work as intuitively expected:
892 (with-selected-frame frame
893 (define-key local-function-map "\eOP" [f1]))
895 On the other hand, this affects the semantics of
896 last-command and real-last-command, and people may rely on
897 that. I took a quick look at the Lisp codebase, and I
898 don't think anything will break. --lorentey */
899 return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
900 + (char *)FRAME_KBOARD (SELECTED_FRAME ()));
902 return valcontents;
905 /* Store NEWVAL into SYMBOL, where VALCONTENTS is found in the value cell
906 of SYMBOL. If SYMBOL is buffer-local, VALCONTENTS should be the
907 buffer-independent contents of the value cell: forwarded just one
908 step past the buffer-localness.
910 BUF non-zero means set the value in buffer BUF instead of the
911 current buffer. This only plays a role for per-buffer variables. */
913 void
914 store_symval_forwarding (symbol, valcontents, newval, buf)
915 Lisp_Object symbol;
916 register Lisp_Object valcontents, newval;
917 struct buffer *buf;
919 switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
921 case Lisp_Misc:
922 switch (XMISCTYPE (valcontents))
924 case Lisp_Misc_Intfwd:
925 CHECK_NUMBER (newval);
926 *XINTFWD (valcontents)->intvar = XINT (newval);
927 /* This can never happen since intvar points to an EMACS_INT
928 which is at least large enough to hold a Lisp_Object.
929 if (*XINTFWD (valcontents)->intvar != XINT (newval))
930 error ("Value out of range for variable `%s'",
931 SDATA (SYMBOL_NAME (symbol))); */
932 break;
934 case Lisp_Misc_Boolfwd:
935 *XBOOLFWD (valcontents)->boolvar = !NILP (newval);
936 break;
938 case Lisp_Misc_Objfwd:
939 *XOBJFWD (valcontents)->objvar = newval;
941 /* If this variable is a default for something stored
942 in the buffer itself, such as default-fill-column,
943 find the buffers that don't have local values for it
944 and update them. */
945 if (XOBJFWD (valcontents)->objvar > (Lisp_Object *) &buffer_defaults
946 && XOBJFWD (valcontents)->objvar < (Lisp_Object *) (&buffer_defaults + 1))
948 int offset = ((char *) XOBJFWD (valcontents)->objvar
949 - (char *) &buffer_defaults);
950 int idx = PER_BUFFER_IDX (offset);
952 Lisp_Object tail;
954 if (idx <= 0)
955 break;
957 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
959 Lisp_Object buf;
960 struct buffer *b;
962 buf = Fcdr (XCAR (tail));
963 if (!BUFFERP (buf)) continue;
964 b = XBUFFER (buf);
966 if (! PER_BUFFER_VALUE_P (b, idx))
967 PER_BUFFER_VALUE (b, offset) = newval;
970 break;
972 case Lisp_Misc_Buffer_Objfwd:
974 int offset = XBUFFER_OBJFWD (valcontents)->offset;
975 Lisp_Object type = XBUFFER_OBJFWD (valcontents)->slottype;
977 if (! NILP (type) && ! NILP (newval)
978 && XTYPE (newval) != XINT (type))
979 buffer_slot_type_mismatch (newval, XINT (type));
981 if (buf == NULL)
982 buf = current_buffer;
983 PER_BUFFER_VALUE (buf, offset) = newval;
985 break;
987 case Lisp_Misc_Kboard_Objfwd:
989 char *base = (char *) FRAME_KBOARD (SELECTED_FRAME ());
990 char *p = base + XKBOARD_OBJFWD (valcontents)->offset;
991 *(Lisp_Object *) p = newval;
993 break;
995 default:
996 goto def;
998 break;
1000 default:
1001 def:
1002 valcontents = SYMBOL_VALUE (symbol);
1003 if (BUFFER_LOCAL_VALUEP (valcontents))
1004 XBUFFER_LOCAL_VALUE (valcontents)->realvalue = newval;
1005 else
1006 SET_SYMBOL_VALUE (symbol, newval);
1010 /* Set up SYMBOL to refer to its global binding.
1011 This makes it safe to alter the status of other bindings. */
1013 void
1014 swap_in_global_binding (symbol)
1015 Lisp_Object symbol;
1017 Lisp_Object valcontents = SYMBOL_VALUE (symbol);
1018 struct Lisp_Buffer_Local_Value *blv = XBUFFER_LOCAL_VALUE (valcontents);
1019 Lisp_Object cdr = blv->cdr;
1021 /* Unload the previously loaded binding. */
1022 Fsetcdr (XCAR (cdr),
1023 do_symval_forwarding (blv->realvalue));
1025 /* Select the global binding in the symbol. */
1026 XSETCAR (cdr, cdr);
1027 store_symval_forwarding (symbol, blv->realvalue, XCDR (cdr), NULL);
1029 /* Indicate that the global binding is set up now. */
1030 blv->frame = Qnil;
1031 blv->buffer = Qnil;
1032 blv->found_for_frame = 0;
1033 blv->found_for_buffer = 0;
1036 /* Set up the buffer-local symbol SYMBOL for validity in the current buffer.
1037 VALCONTENTS is the contents of its value cell,
1038 which points to a struct Lisp_Buffer_Local_Value.
1040 Return the value forwarded one step past the buffer-local stage.
1041 This could be another forwarding pointer. */
1043 static Lisp_Object
1044 swap_in_symval_forwarding (symbol, valcontents)
1045 Lisp_Object symbol, valcontents;
1047 register Lisp_Object tem1;
1049 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1051 if (NILP (tem1)
1052 || current_buffer != XBUFFER (tem1)
1053 || (XBUFFER_LOCAL_VALUE (valcontents)->check_frame
1054 && ! EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame)))
1056 struct Lisp_Symbol *sym = XSYMBOL (symbol);
1057 if (sym->indirect_variable)
1059 sym = indirect_variable (sym);
1060 XSETSYMBOL (symbol, sym);
1063 /* Unload the previously loaded binding. */
1064 tem1 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1065 Fsetcdr (tem1,
1066 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
1067 /* Choose the new binding. */
1068 tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
1069 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
1070 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1071 if (NILP (tem1))
1073 if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
1074 tem1 = assq_no_quit (symbol, XFRAME (selected_frame)->param_alist);
1075 if (! NILP (tem1))
1076 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 1;
1077 else
1078 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
1080 else
1081 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 1;
1083 /* Load the new binding. */
1084 XSETCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr, tem1);
1085 XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, current_buffer);
1086 XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
1087 store_symval_forwarding (symbol,
1088 XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1089 Fcdr (tem1), NULL);
1091 return XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
1094 /* Find the value of a symbol, returning Qunbound if it's not bound.
1095 This is helpful for code which just wants to get a variable's value
1096 if it has one, without signaling an error.
1097 Note that it must not be possible to quit
1098 within this function. Great care is required for this. */
1100 Lisp_Object
1101 find_symbol_value (symbol)
1102 Lisp_Object symbol;
1104 register Lisp_Object valcontents;
1105 register Lisp_Object val;
1107 CHECK_SYMBOL (symbol);
1108 valcontents = SYMBOL_VALUE (symbol);
1110 if (BUFFER_LOCAL_VALUEP (valcontents))
1111 valcontents = swap_in_symval_forwarding (symbol, valcontents);
1113 return do_symval_forwarding (valcontents);
1116 DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
1117 doc: /* Return SYMBOL's value. Error if that is void. */)
1118 (symbol)
1119 Lisp_Object symbol;
1121 Lisp_Object val;
1123 val = find_symbol_value (symbol);
1124 if (!EQ (val, Qunbound))
1125 return val;
1127 xsignal1 (Qvoid_variable, symbol);
1130 DEFUN ("set", Fset, Sset, 2, 2, 0,
1131 doc: /* Set SYMBOL's value to NEWVAL, and return NEWVAL. */)
1132 (symbol, newval)
1133 register Lisp_Object symbol, newval;
1135 return set_internal (symbol, newval, current_buffer, 0);
1138 /* Return 1 if SYMBOL currently has a let-binding
1139 which was made in the buffer that is now current. */
1141 static int
1142 let_shadows_buffer_binding_p (symbol)
1143 struct Lisp_Symbol *symbol;
1145 volatile struct specbinding *p;
1147 for (p = specpdl_ptr - 1; p >= specpdl; p--)
1148 if (p->func == NULL
1149 && CONSP (p->symbol))
1151 struct Lisp_Symbol *let_bound_symbol = XSYMBOL (XCAR (p->symbol));
1152 if ((symbol == let_bound_symbol
1153 || (let_bound_symbol->indirect_variable
1154 && symbol == indirect_variable (let_bound_symbol)))
1155 && XBUFFER (XCDR (XCDR (p->symbol))) == current_buffer)
1156 break;
1159 return p >= specpdl;
1162 /* Store the value NEWVAL into SYMBOL.
1163 If buffer-locality is an issue, BUF specifies which buffer to use.
1164 (0 stands for the current buffer.)
1166 If BINDFLAG is zero, then if this symbol is supposed to become
1167 local in every buffer where it is set, then we make it local.
1168 If BINDFLAG is nonzero, we don't do that. */
1170 Lisp_Object
1171 set_internal (symbol, newval, buf, bindflag)
1172 register Lisp_Object symbol, newval;
1173 struct buffer *buf;
1174 int bindflag;
1176 int voide = EQ (newval, Qunbound);
1178 register Lisp_Object valcontents, innercontents, tem1, current_alist_element;
1180 if (buf == 0)
1181 buf = current_buffer;
1183 /* If restoring in a dead buffer, do nothing. */
1184 if (NILP (buf->name))
1185 return newval;
1187 CHECK_SYMBOL (symbol);
1188 if (SYMBOL_CONSTANT_P (symbol)
1189 && (NILP (Fkeywordp (symbol))
1190 || !EQ (newval, SYMBOL_VALUE (symbol))))
1191 xsignal1 (Qsetting_constant, symbol);
1193 innercontents = valcontents = SYMBOL_VALUE (symbol);
1195 if (BUFFER_OBJFWDP (valcontents))
1197 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1198 int idx = PER_BUFFER_IDX (offset);
1199 if (idx > 0
1200 && !bindflag
1201 && !let_shadows_buffer_binding_p (symbol))
1202 SET_PER_BUFFER_VALUE_P (buf, idx, 1);
1204 else if (BUFFER_LOCAL_VALUEP (valcontents))
1206 /* valcontents is a struct Lisp_Buffer_Local_Value. */
1207 if (XSYMBOL (symbol)->indirect_variable)
1208 XSETSYMBOL (symbol, indirect_variable (XSYMBOL (symbol)));
1210 /* What binding is loaded right now? */
1211 current_alist_element
1212 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1214 /* If the current buffer is not the buffer whose binding is
1215 loaded, or if there may be frame-local bindings and the frame
1216 isn't the right one, or if it's a Lisp_Buffer_Local_Value and
1217 the default binding is loaded, the loaded binding may be the
1218 wrong one. */
1219 if (!BUFFERP (XBUFFER_LOCAL_VALUE (valcontents)->buffer)
1220 || buf != XBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer)
1221 || (XBUFFER_LOCAL_VALUE (valcontents)->check_frame
1222 && !EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame))
1223 /* Also unload a global binding (if the var is local_if_set). */
1224 || (EQ (XCAR (current_alist_element),
1225 current_alist_element)))
1227 /* The currently loaded binding is not necessarily valid.
1228 We need to unload it, and choose a new binding. */
1230 /* Write out `realvalue' to the old loaded binding. */
1231 Fsetcdr (current_alist_element,
1232 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
1234 /* Find the new binding. */
1235 tem1 = Fassq (symbol, buf->local_var_alist);
1236 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 1;
1237 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
1239 if (NILP (tem1))
1241 /* This buffer still sees the default value. */
1243 /* If the variable is not local_if_set,
1244 or if this is `let' rather than `set',
1245 make CURRENT-ALIST-ELEMENT point to itself,
1246 indicating that we're seeing the default value.
1247 Likewise if the variable has been let-bound
1248 in the current buffer. */
1249 if (bindflag || !XBUFFER_LOCAL_VALUE (valcontents)->local_if_set
1250 || let_shadows_buffer_binding_p (XSYMBOL (symbol)))
1252 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1254 if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
1255 tem1 = Fassq (symbol,
1256 XFRAME (selected_frame)->param_alist);
1258 if (! NILP (tem1))
1259 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 1;
1260 else
1261 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
1263 /* If it's a Lisp_Buffer_Local_Value, being set not bound,
1264 and we're not within a let that was made for this buffer,
1265 create a new buffer-local binding for the variable.
1266 That means, give this buffer a new assoc for a local value
1267 and load that binding. */
1268 else
1270 tem1 = Fcons (symbol, XCDR (current_alist_element));
1271 buf->local_var_alist
1272 = Fcons (tem1, buf->local_var_alist);
1276 /* Record which binding is now loaded. */
1277 XSETCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr, tem1);
1279 /* Set `buffer' and `frame' slots for the binding now loaded. */
1280 XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, buf);
1281 XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
1283 innercontents = XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
1285 /* Store the new value in the cons-cell. */
1286 XSETCDR (XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr), newval);
1289 /* If storing void (making the symbol void), forward only through
1290 buffer-local indicator, not through Lisp_Objfwd, etc. */
1291 if (voide)
1292 store_symval_forwarding (symbol, Qnil, newval, buf);
1293 else
1294 store_symval_forwarding (symbol, innercontents, newval, buf);
1296 return newval;
1299 /* Access or set a buffer-local symbol's default value. */
1301 /* Return the default value of SYMBOL, but don't check for voidness.
1302 Return Qunbound if it is void. */
1304 Lisp_Object
1305 default_value (symbol)
1306 Lisp_Object symbol;
1308 register Lisp_Object valcontents;
1310 CHECK_SYMBOL (symbol);
1311 valcontents = SYMBOL_VALUE (symbol);
1313 /* For a built-in buffer-local variable, get the default value
1314 rather than letting do_symval_forwarding get the current value. */
1315 if (BUFFER_OBJFWDP (valcontents))
1317 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1318 if (PER_BUFFER_IDX (offset) != 0)
1319 return PER_BUFFER_DEFAULT (offset);
1322 /* Handle user-created local variables. */
1323 if (BUFFER_LOCAL_VALUEP (valcontents))
1325 /* If var is set up for a buffer that lacks a local value for it,
1326 the current value is nominally the default value.
1327 But the `realvalue' slot may be more up to date, since
1328 ordinary setq stores just that slot. So use that. */
1329 Lisp_Object current_alist_element, alist_element_car;
1330 current_alist_element
1331 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1332 alist_element_car = XCAR (current_alist_element);
1333 if (EQ (alist_element_car, current_alist_element))
1334 return do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue);
1335 else
1336 return XCDR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1338 /* For other variables, get the current value. */
1339 return do_symval_forwarding (valcontents);
1342 DEFUN ("default-boundp", Fdefault_boundp, Sdefault_boundp, 1, 1, 0,
1343 doc: /* Return t if SYMBOL has a non-void default value.
1344 This is the value that is seen in buffers that do not have their own values
1345 for this variable. */)
1346 (symbol)
1347 Lisp_Object symbol;
1349 register Lisp_Object value;
1351 value = default_value (symbol);
1352 return (EQ (value, Qunbound) ? Qnil : Qt);
1355 DEFUN ("default-value", Fdefault_value, Sdefault_value, 1, 1, 0,
1356 doc: /* Return SYMBOL's default value.
1357 This is the value that is seen in buffers that do not have their own values
1358 for this variable. The default value is meaningful for variables with
1359 local bindings in certain buffers. */)
1360 (symbol)
1361 Lisp_Object symbol;
1363 register Lisp_Object value;
1365 value = default_value (symbol);
1366 if (!EQ (value, Qunbound))
1367 return value;
1369 xsignal1 (Qvoid_variable, symbol);
1372 DEFUN ("set-default", Fset_default, Sset_default, 2, 2, 0,
1373 doc: /* Set SYMBOL's default value to VALUE. SYMBOL and VALUE are evaluated.
1374 The default value is seen in buffers that do not have their own values
1375 for this variable. */)
1376 (symbol, value)
1377 Lisp_Object symbol, value;
1379 register Lisp_Object valcontents, current_alist_element, alist_element_buffer;
1381 CHECK_SYMBOL (symbol);
1382 valcontents = SYMBOL_VALUE (symbol);
1384 /* Handle variables like case-fold-search that have special slots
1385 in the buffer. Make them work apparently like Lisp_Buffer_Local_Value
1386 variables. */
1387 if (BUFFER_OBJFWDP (valcontents))
1389 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1390 int idx = PER_BUFFER_IDX (offset);
1392 PER_BUFFER_DEFAULT (offset) = value;
1394 /* If this variable is not always local in all buffers,
1395 set it in the buffers that don't nominally have a local value. */
1396 if (idx > 0)
1398 struct buffer *b;
1400 for (b = all_buffers; b; b = b->next)
1401 if (!PER_BUFFER_VALUE_P (b, idx))
1402 PER_BUFFER_VALUE (b, offset) = value;
1404 return value;
1407 if (!BUFFER_LOCAL_VALUEP (valcontents))
1408 return Fset (symbol, value);
1410 /* Store new value into the DEFAULT-VALUE slot. */
1411 XSETCDR (XBUFFER_LOCAL_VALUE (valcontents)->cdr, value);
1413 /* If the default binding is now loaded, set the REALVALUE slot too. */
1414 current_alist_element
1415 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1416 alist_element_buffer = Fcar (current_alist_element);
1417 if (EQ (alist_element_buffer, current_alist_element))
1418 store_symval_forwarding (symbol,
1419 XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1420 value, NULL);
1422 return value;
1425 DEFUN ("setq-default", Fsetq_default, Ssetq_default, 0, UNEVALLED, 0,
1426 doc: /* Set the default value of variable VAR to VALUE.
1427 VAR, the variable name, is literal (not evaluated);
1428 VALUE is an expression: it is evaluated and its value returned.
1429 The default value of a variable is seen in buffers
1430 that do not have their own values for the variable.
1432 More generally, you can use multiple variables and values, as in
1433 (setq-default VAR VALUE VAR VALUE...)
1434 This sets each VAR's default value to the corresponding VALUE.
1435 The VALUE for the Nth VAR can refer to the new default values
1436 of previous VARs.
1437 usage: (setq-default [VAR VALUE]...) */)
1438 (args)
1439 Lisp_Object args;
1441 register Lisp_Object args_left;
1442 register Lisp_Object val, symbol;
1443 struct gcpro gcpro1;
1445 if (NILP (args))
1446 return Qnil;
1448 args_left = args;
1449 GCPRO1 (args);
1453 val = Feval (Fcar (Fcdr (args_left)));
1454 symbol = XCAR (args_left);
1455 Fset_default (symbol, val);
1456 args_left = Fcdr (XCDR (args_left));
1458 while (!NILP (args_left));
1460 UNGCPRO;
1461 return val;
1464 /* Lisp functions for creating and removing buffer-local variables. */
1466 DEFUN ("make-variable-buffer-local", Fmake_variable_buffer_local, Smake_variable_buffer_local,
1467 1, 1, "vMake Variable Buffer Local: ",
1468 doc: /* Make VARIABLE become buffer-local whenever it is set.
1469 At any time, the value for the current buffer is in effect,
1470 unless the variable has never been set in this buffer,
1471 in which case the default value is in effect.
1472 Note that binding the variable with `let', or setting it while
1473 a `let'-style binding made in this buffer is in effect,
1474 does not make the variable buffer-local. Return VARIABLE.
1476 In most cases it is better to use `make-local-variable',
1477 which makes a variable local in just one buffer.
1479 The function `default-value' gets the default value and `set-default' sets it. */)
1480 (variable)
1481 register Lisp_Object variable;
1483 register Lisp_Object tem, valcontents, newval;
1484 struct Lisp_Symbol *sym;
1486 CHECK_SYMBOL (variable);
1487 sym = indirect_variable (XSYMBOL (variable));
1489 valcontents = sym->value;
1490 if (sym->constant || KBOARD_OBJFWDP (valcontents))
1491 error ("Symbol %s may not be buffer-local", SDATA (sym->xname));
1493 if (BUFFER_OBJFWDP (valcontents))
1494 return variable;
1495 else if (BUFFER_LOCAL_VALUEP (valcontents))
1496 newval = valcontents;
1497 else
1499 if (EQ (valcontents, Qunbound))
1500 sym->value = Qnil;
1501 tem = Fcons (Qnil, Fsymbol_value (variable));
1502 XSETCAR (tem, tem);
1503 newval = allocate_misc ();
1504 XMISCTYPE (newval) = Lisp_Misc_Buffer_Local_Value;
1505 XBUFFER_LOCAL_VALUE (newval)->realvalue = sym->value;
1506 XBUFFER_LOCAL_VALUE (newval)->buffer = Fcurrent_buffer ();
1507 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1508 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1509 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1510 XBUFFER_LOCAL_VALUE (newval)->check_frame = 0;
1511 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1512 sym->value = newval;
1514 XBUFFER_LOCAL_VALUE (newval)->local_if_set = 1;
1515 return variable;
1518 DEFUN ("make-local-variable", Fmake_local_variable, Smake_local_variable,
1519 1, 1, "vMake Local Variable: ",
1520 doc: /* Make VARIABLE have a separate value in the current buffer.
1521 Other buffers will continue to share a common default value.
1522 \(The buffer-local value of VARIABLE starts out as the same value
1523 VARIABLE previously had. If VARIABLE was void, it remains void.\)
1524 Return VARIABLE.
1526 If the variable is already arranged to become local when set,
1527 this function causes a local value to exist for this buffer,
1528 just as setting the variable would do.
1530 This function returns VARIABLE, and therefore
1531 (set (make-local-variable 'VARIABLE) VALUE-EXP)
1532 works.
1534 See also `make-variable-buffer-local'.
1536 Do not use `make-local-variable' to make a hook variable buffer-local.
1537 Instead, use `add-hook' and specify t for the LOCAL argument. */)
1538 (variable)
1539 register Lisp_Object variable;
1541 register Lisp_Object tem, valcontents;
1542 struct Lisp_Symbol *sym;
1544 CHECK_SYMBOL (variable);
1545 sym = indirect_variable (XSYMBOL (variable));
1547 valcontents = sym->value;
1548 if (sym->constant || KBOARD_OBJFWDP (valcontents))
1549 error ("Symbol %s may not be buffer-local", SDATA (sym->xname));
1551 if ((BUFFER_LOCAL_VALUEP (valcontents)
1552 && XBUFFER_LOCAL_VALUE (valcontents)->local_if_set)
1553 || BUFFER_OBJFWDP (valcontents))
1555 tem = Fboundp (variable);
1557 /* Make sure the symbol has a local value in this particular buffer,
1558 by setting it to the same value it already has. */
1559 Fset (variable, (EQ (tem, Qt) ? Fsymbol_value (variable) : Qunbound));
1560 return variable;
1562 /* Make sure symbol is set up to hold per-buffer values. */
1563 if (!BUFFER_LOCAL_VALUEP (valcontents))
1565 Lisp_Object newval;
1566 tem = Fcons (Qnil, do_symval_forwarding (valcontents));
1567 XSETCAR (tem, tem);
1568 newval = allocate_misc ();
1569 XMISCTYPE (newval) = Lisp_Misc_Buffer_Local_Value;
1570 XBUFFER_LOCAL_VALUE (newval)->realvalue = sym->value;
1571 XBUFFER_LOCAL_VALUE (newval)->buffer = Qnil;
1572 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1573 XBUFFER_LOCAL_VALUE (newval)->local_if_set = 0;
1574 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1575 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1576 XBUFFER_LOCAL_VALUE (newval)->check_frame = 0;
1577 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1578 sym->value = newval;
1580 /* Make sure this buffer has its own value of symbol. */
1581 XSETSYMBOL (variable, sym); /* Propagate variable indirections. */
1582 tem = Fassq (variable, current_buffer->local_var_alist);
1583 if (NILP (tem))
1585 /* Swap out any local binding for some other buffer, and make
1586 sure the current value is permanently recorded, if it's the
1587 default value. */
1588 find_symbol_value (variable);
1590 current_buffer->local_var_alist
1591 = Fcons (Fcons (variable, XCDR (XBUFFER_LOCAL_VALUE (sym->value)->cdr)),
1592 current_buffer->local_var_alist);
1594 /* Make sure symbol does not think it is set up for this buffer;
1595 force it to look once again for this buffer's value. */
1597 Lisp_Object *pvalbuf;
1599 valcontents = sym->value;
1601 pvalbuf = &XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1602 if (current_buffer == XBUFFER (*pvalbuf))
1603 *pvalbuf = Qnil;
1604 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1608 /* If the symbol forwards into a C variable, then load the binding
1609 for this buffer now. If C code modifies the variable before we
1610 load the binding in, then that new value will clobber the default
1611 binding the next time we unload it. */
1612 valcontents = XBUFFER_LOCAL_VALUE (sym->value)->realvalue;
1613 if (INTFWDP (valcontents) || BOOLFWDP (valcontents) || OBJFWDP (valcontents))
1614 swap_in_symval_forwarding (variable, sym->value);
1616 return variable;
1619 DEFUN ("kill-local-variable", Fkill_local_variable, Skill_local_variable,
1620 1, 1, "vKill Local Variable: ",
1621 doc: /* Make VARIABLE no longer have a separate value in the current buffer.
1622 From now on the default value will apply in this buffer. Return VARIABLE. */)
1623 (variable)
1624 register Lisp_Object variable;
1626 register Lisp_Object tem, valcontents;
1627 struct Lisp_Symbol *sym;
1629 CHECK_SYMBOL (variable);
1630 sym = indirect_variable (XSYMBOL (variable));
1632 valcontents = sym->value;
1634 if (BUFFER_OBJFWDP (valcontents))
1636 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1637 int idx = PER_BUFFER_IDX (offset);
1639 if (idx > 0)
1641 SET_PER_BUFFER_VALUE_P (current_buffer, idx, 0);
1642 PER_BUFFER_VALUE (current_buffer, offset)
1643 = PER_BUFFER_DEFAULT (offset);
1645 return variable;
1648 if (!BUFFER_LOCAL_VALUEP (valcontents))
1649 return variable;
1651 /* Get rid of this buffer's alist element, if any. */
1652 XSETSYMBOL (variable, sym); /* Propagate variable indirection. */
1653 tem = Fassq (variable, current_buffer->local_var_alist);
1654 if (!NILP (tem))
1655 current_buffer->local_var_alist
1656 = Fdelq (tem, current_buffer->local_var_alist);
1658 /* If the symbol is set up with the current buffer's binding
1659 loaded, recompute its value. We have to do it now, or else
1660 forwarded objects won't work right. */
1662 Lisp_Object *pvalbuf, buf;
1663 valcontents = sym->value;
1664 pvalbuf = &XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1665 XSETBUFFER (buf, current_buffer);
1666 if (EQ (buf, *pvalbuf))
1668 *pvalbuf = Qnil;
1669 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1670 find_symbol_value (variable);
1674 return variable;
1677 /* Lisp functions for creating and removing buffer-local variables. */
1679 DEFUN ("make-variable-frame-local", Fmake_variable_frame_local, Smake_variable_frame_local,
1680 1, 1, "vMake Variable Frame Local: ",
1681 doc: /* Enable VARIABLE to have frame-local bindings.
1682 This does not create any frame-local bindings for VARIABLE,
1683 it just makes them possible.
1685 A frame-local binding is actually a frame parameter value.
1686 If a frame F has a value for the frame parameter named VARIABLE,
1687 that also acts as a frame-local binding for VARIABLE in F--
1688 provided this function has been called to enable VARIABLE
1689 to have frame-local bindings at all.
1691 The only way to create a frame-local binding for VARIABLE in a frame
1692 is to set the VARIABLE frame parameter of that frame. See
1693 `modify-frame-parameters' for how to set frame parameters.
1695 Buffer-local bindings take precedence over frame-local bindings. */)
1696 (variable)
1697 register Lisp_Object variable;
1699 register Lisp_Object tem, valcontents, newval;
1700 struct Lisp_Symbol *sym;
1702 CHECK_SYMBOL (variable);
1703 sym = indirect_variable (XSYMBOL (variable));
1705 valcontents = sym->value;
1706 if (sym->constant || KBOARD_OBJFWDP (valcontents)
1707 || BUFFER_OBJFWDP (valcontents))
1708 error ("Symbol %s may not be frame-local", SDATA (sym->xname));
1710 if (BUFFER_LOCAL_VALUEP (valcontents))
1712 XBUFFER_LOCAL_VALUE (valcontents)->check_frame = 1;
1713 return variable;
1716 if (EQ (valcontents, Qunbound))
1717 sym->value = Qnil;
1718 tem = Fcons (Qnil, Fsymbol_value (variable));
1719 XSETCAR (tem, tem);
1720 newval = allocate_misc ();
1721 XMISCTYPE (newval) = Lisp_Misc_Buffer_Local_Value;
1722 XBUFFER_LOCAL_VALUE (newval)->realvalue = sym->value;
1723 XBUFFER_LOCAL_VALUE (newval)->buffer = Qnil;
1724 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1725 XBUFFER_LOCAL_VALUE (newval)->local_if_set = 0;
1726 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1727 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1728 XBUFFER_LOCAL_VALUE (newval)->check_frame = 1;
1729 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1730 sym->value = newval;
1731 return variable;
1734 DEFUN ("local-variable-p", Flocal_variable_p, Slocal_variable_p,
1735 1, 2, 0,
1736 doc: /* Non-nil if VARIABLE has a local binding in buffer BUFFER.
1737 BUFFER defaults to the current buffer. */)
1738 (variable, buffer)
1739 register Lisp_Object variable, buffer;
1741 Lisp_Object valcontents;
1742 register struct buffer *buf;
1743 struct Lisp_Symbol *sym;
1745 if (NILP (buffer))
1746 buf = current_buffer;
1747 else
1749 CHECK_BUFFER (buffer);
1750 buf = XBUFFER (buffer);
1753 CHECK_SYMBOL (variable);
1754 sym = indirect_variable (XSYMBOL (variable));
1755 XSETSYMBOL (variable, sym);
1757 valcontents = sym->value;
1758 if (BUFFER_LOCAL_VALUEP (valcontents))
1760 Lisp_Object tail, elt;
1762 for (tail = buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1764 elt = XCAR (tail);
1765 if (EQ (variable, XCAR (elt)))
1766 return Qt;
1769 if (BUFFER_OBJFWDP (valcontents))
1771 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1772 int idx = PER_BUFFER_IDX (offset);
1773 if (idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
1774 return Qt;
1776 return Qnil;
1779 DEFUN ("local-variable-if-set-p", Flocal_variable_if_set_p, Slocal_variable_if_set_p,
1780 1, 2, 0,
1781 doc: /* Non-nil if VARIABLE will be local in buffer BUFFER when set there.
1782 More precisely, this means that setting the variable \(with `set' or`setq'),
1783 while it does not have a `let'-style binding that was made in BUFFER,
1784 will produce a buffer local binding. See Info node
1785 `(elisp)Creating Buffer-Local'.
1786 BUFFER defaults to the current buffer. */)
1787 (variable, buffer)
1788 register Lisp_Object variable, buffer;
1790 Lisp_Object valcontents;
1791 register struct buffer *buf;
1792 struct Lisp_Symbol *sym;
1794 if (NILP (buffer))
1795 buf = current_buffer;
1796 else
1798 CHECK_BUFFER (buffer);
1799 buf = XBUFFER (buffer);
1802 CHECK_SYMBOL (variable);
1803 sym = indirect_variable (XSYMBOL (variable));
1804 XSETSYMBOL (variable, sym);
1806 valcontents = sym->value;
1808 if (BUFFER_OBJFWDP (valcontents))
1809 /* All these slots become local if they are set. */
1810 return Qt;
1811 else if (BUFFER_LOCAL_VALUEP (valcontents))
1813 Lisp_Object tail, elt;
1814 if (XBUFFER_LOCAL_VALUE (valcontents)->local_if_set)
1815 return Qt;
1816 for (tail = buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1818 elt = XCAR (tail);
1819 if (EQ (variable, XCAR (elt)))
1820 return Qt;
1823 return Qnil;
1826 DEFUN ("variable-binding-locus", Fvariable_binding_locus, Svariable_binding_locus,
1827 1, 1, 0,
1828 doc: /* Return a value indicating where VARIABLE's current binding comes from.
1829 If the current binding is buffer-local, the value is the current buffer.
1830 If the current binding is frame-local, the value is the selected frame.
1831 If the current binding is global (the default), the value is nil. */)
1832 (variable)
1833 register Lisp_Object variable;
1835 Lisp_Object valcontents;
1836 struct Lisp_Symbol *sym;
1838 CHECK_SYMBOL (variable);
1839 sym = indirect_variable (XSYMBOL (variable));
1841 /* Make sure the current binding is actually swapped in. */
1842 find_symbol_value (variable);
1844 valcontents = sym->value;
1846 if (BUFFER_LOCAL_VALUEP (valcontents)
1847 || BUFFER_OBJFWDP (valcontents))
1849 /* For a local variable, record both the symbol and which
1850 buffer's or frame's value we are saving. */
1851 if (!NILP (Flocal_variable_p (variable, Qnil)))
1852 return Fcurrent_buffer ();
1853 else if (BUFFER_LOCAL_VALUEP (valcontents)
1854 && XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame)
1855 return XBUFFER_LOCAL_VALUE (valcontents)->frame;
1858 return Qnil;
1861 /* This code is disabled now that we use the selected frame to return
1862 keyboard-local-values. */
1863 #if 0
1864 extern struct terminal *get_terminal P_ ((Lisp_Object display, int));
1866 DEFUN ("terminal-local-value", Fterminal_local_value, Sterminal_local_value, 2, 2, 0,
1867 doc: /* Return the terminal-local value of SYMBOL on TERMINAL.
1868 If SYMBOL is not a terminal-local variable, then return its normal
1869 value, like `symbol-value'.
1871 TERMINAL may be a terminal id, a frame, or nil (meaning the
1872 selected frame's terminal device). */)
1873 (symbol, terminal)
1874 Lisp_Object symbol;
1875 Lisp_Object terminal;
1877 Lisp_Object result;
1878 struct terminal *t = get_terminal (terminal, 1);
1879 push_kboard (t->kboard);
1880 result = Fsymbol_value (symbol);
1881 pop_kboard ();
1882 return result;
1885 DEFUN ("set-terminal-local-value", Fset_terminal_local_value, Sset_terminal_local_value, 3, 3, 0,
1886 doc: /* Set the terminal-local binding of SYMBOL on TERMINAL to VALUE.
1887 If VARIABLE is not a terminal-local variable, then set its normal
1888 binding, like `set'.
1890 TERMINAL may be a terminal id, a frame, or nil (meaning the
1891 selected frame's terminal device). */)
1892 (symbol, terminal, value)
1893 Lisp_Object symbol;
1894 Lisp_Object terminal;
1895 Lisp_Object value;
1897 Lisp_Object result;
1898 struct terminal *t = get_terminal (terminal, 1);
1899 push_kboard (d->kboard);
1900 result = Fset (symbol, value);
1901 pop_kboard ();
1902 return result;
1904 #endif
1906 /* Find the function at the end of a chain of symbol function indirections. */
1908 /* If OBJECT is a symbol, find the end of its function chain and
1909 return the value found there. If OBJECT is not a symbol, just
1910 return it. If there is a cycle in the function chain, signal a
1911 cyclic-function-indirection error.
1913 This is like Findirect_function, except that it doesn't signal an
1914 error if the chain ends up unbound. */
1915 Lisp_Object
1916 indirect_function (object)
1917 register Lisp_Object object;
1919 Lisp_Object tortoise, hare;
1921 hare = tortoise = object;
1923 for (;;)
1925 if (!SYMBOLP (hare) || EQ (hare, Qunbound))
1926 break;
1927 hare = XSYMBOL (hare)->function;
1928 if (!SYMBOLP (hare) || EQ (hare, Qunbound))
1929 break;
1930 hare = XSYMBOL (hare)->function;
1932 tortoise = XSYMBOL (tortoise)->function;
1934 if (EQ (hare, tortoise))
1935 xsignal1 (Qcyclic_function_indirection, object);
1938 return hare;
1941 DEFUN ("indirect-function", Findirect_function, Sindirect_function, 1, 2, 0,
1942 doc: /* Return the function at the end of OBJECT's function chain.
1943 If OBJECT is not a symbol, just return it. Otherwise, follow all
1944 function indirections to find the final function binding and return it.
1945 If the final symbol in the chain is unbound, signal a void-function error.
1946 Optional arg NOERROR non-nil means to return nil instead of signalling.
1947 Signal a cyclic-function-indirection error if there is a loop in the
1948 function chain of symbols. */)
1949 (object, noerror)
1950 register Lisp_Object object;
1951 Lisp_Object noerror;
1953 Lisp_Object result;
1955 /* Optimize for no indirection. */
1956 result = object;
1957 if (SYMBOLP (result) && !EQ (result, Qunbound)
1958 && (result = XSYMBOL (result)->function, SYMBOLP (result)))
1959 result = indirect_function (result);
1960 if (!EQ (result, Qunbound))
1961 return result;
1963 if (NILP (noerror))
1964 xsignal1 (Qvoid_function, object);
1966 return Qnil;
1969 /* Extract and set vector and string elements */
1971 DEFUN ("aref", Faref, Saref, 2, 2, 0,
1972 doc: /* Return the element of ARRAY at index IDX.
1973 ARRAY may be a vector, a string, a char-table, a bool-vector,
1974 or a byte-code object. IDX starts at 0. */)
1975 (array, idx)
1976 register Lisp_Object array;
1977 Lisp_Object idx;
1979 register int idxval;
1981 CHECK_NUMBER (idx);
1982 idxval = XINT (idx);
1983 if (STRINGP (array))
1985 int c, idxval_byte;
1987 if (idxval < 0 || idxval >= SCHARS (array))
1988 args_out_of_range (array, idx);
1989 if (! STRING_MULTIBYTE (array))
1990 return make_number ((unsigned char) SREF (array, idxval));
1991 idxval_byte = string_char_to_byte (array, idxval);
1993 c = STRING_CHAR (SDATA (array) + idxval_byte,
1994 SBYTES (array) - idxval_byte);
1995 return make_number (c);
1997 else if (BOOL_VECTOR_P (array))
1999 int val;
2001 if (idxval < 0 || idxval >= XBOOL_VECTOR (array)->size)
2002 args_out_of_range (array, idx);
2004 val = (unsigned char) XBOOL_VECTOR (array)->data[idxval / BOOL_VECTOR_BITS_PER_CHAR];
2005 return (val & (1 << (idxval % BOOL_VECTOR_BITS_PER_CHAR)) ? Qt : Qnil);
2007 else if (CHAR_TABLE_P (array))
2009 CHECK_CHARACTER (idx);
2010 return CHAR_TABLE_REF (array, idxval);
2012 else
2014 int size = 0;
2015 if (VECTORP (array))
2016 size = XVECTOR (array)->size;
2017 else if (COMPILEDP (array))
2018 size = XVECTOR (array)->size & PSEUDOVECTOR_SIZE_MASK;
2019 else
2020 wrong_type_argument (Qarrayp, array);
2022 if (idxval < 0 || idxval >= size)
2023 args_out_of_range (array, idx);
2024 return XVECTOR (array)->contents[idxval];
2028 DEFUN ("aset", Faset, Saset, 3, 3, 0,
2029 doc: /* Store into the element of ARRAY at index IDX the value NEWELT.
2030 Return NEWELT. ARRAY may be a vector, a string, a char-table or a
2031 bool-vector. IDX starts at 0. */)
2032 (array, idx, newelt)
2033 register Lisp_Object array;
2034 Lisp_Object idx, newelt;
2036 register int idxval;
2038 CHECK_NUMBER (idx);
2039 idxval = XINT (idx);
2040 CHECK_ARRAY (array, Qarrayp);
2041 CHECK_IMPURE (array);
2043 if (VECTORP (array))
2045 if (idxval < 0 || idxval >= XVECTOR (array)->size)
2046 args_out_of_range (array, idx);
2047 XVECTOR (array)->contents[idxval] = newelt;
2049 else if (BOOL_VECTOR_P (array))
2051 int val;
2053 if (idxval < 0 || idxval >= XBOOL_VECTOR (array)->size)
2054 args_out_of_range (array, idx);
2056 val = (unsigned char) XBOOL_VECTOR (array)->data[idxval / BOOL_VECTOR_BITS_PER_CHAR];
2058 if (! NILP (newelt))
2059 val |= 1 << (idxval % BOOL_VECTOR_BITS_PER_CHAR);
2060 else
2061 val &= ~(1 << (idxval % BOOL_VECTOR_BITS_PER_CHAR));
2062 XBOOL_VECTOR (array)->data[idxval / BOOL_VECTOR_BITS_PER_CHAR] = val;
2064 else if (CHAR_TABLE_P (array))
2066 CHECK_CHARACTER (idx);
2067 CHAR_TABLE_SET (array, idxval, newelt);
2069 else if (STRING_MULTIBYTE (array))
2071 int idxval_byte, prev_bytes, new_bytes, nbytes;
2072 unsigned char workbuf[MAX_MULTIBYTE_LENGTH], *p0 = workbuf, *p1;
2074 if (idxval < 0 || idxval >= SCHARS (array))
2075 args_out_of_range (array, idx);
2076 CHECK_CHARACTER (newelt);
2078 nbytes = SBYTES (array);
2080 idxval_byte = string_char_to_byte (array, idxval);
2081 p1 = SDATA (array) + idxval_byte;
2082 PARSE_MULTIBYTE_SEQ (p1, nbytes - idxval_byte, prev_bytes);
2083 new_bytes = CHAR_STRING (XINT (newelt), p0);
2084 if (prev_bytes != new_bytes)
2086 /* We must relocate the string data. */
2087 int nchars = SCHARS (array);
2088 unsigned char *str;
2089 USE_SAFE_ALLOCA;
2091 SAFE_ALLOCA (str, unsigned char *, nbytes);
2092 bcopy (SDATA (array), str, nbytes);
2093 allocate_string_data (XSTRING (array), nchars,
2094 nbytes + new_bytes - prev_bytes);
2095 bcopy (str, SDATA (array), idxval_byte);
2096 p1 = SDATA (array) + idxval_byte;
2097 bcopy (str + idxval_byte + prev_bytes, p1 + new_bytes,
2098 nbytes - (idxval_byte + prev_bytes));
2099 SAFE_FREE ();
2100 clear_string_char_byte_cache ();
2102 while (new_bytes--)
2103 *p1++ = *p0++;
2105 else
2107 if (idxval < 0 || idxval >= SCHARS (array))
2108 args_out_of_range (array, idx);
2109 CHECK_NUMBER (newelt);
2111 if (XINT (newelt) >= 0 && ! SINGLE_BYTE_CHAR_P (XINT (newelt)))
2113 int i;
2115 for (i = SBYTES (array) - 1; i >= 0; i--)
2116 if (SREF (array, i) >= 0x80)
2117 args_out_of_range (array, newelt);
2118 /* ARRAY is an ASCII string. Convert it to a multibyte
2119 string, and try `aset' again. */
2120 STRING_SET_MULTIBYTE (array);
2121 return Faset (array, idx, newelt);
2123 SSET (array, idxval, XINT (newelt));
2126 return newelt;
2129 /* Arithmetic functions */
2131 enum comparison { equal, notequal, less, grtr, less_or_equal, grtr_or_equal };
2133 Lisp_Object
2134 arithcompare (num1, num2, comparison)
2135 Lisp_Object num1, num2;
2136 enum comparison comparison;
2138 double f1 = 0, f2 = 0;
2139 int floatp = 0;
2141 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num1);
2142 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num2);
2144 if (FLOATP (num1) || FLOATP (num2))
2146 floatp = 1;
2147 f1 = (FLOATP (num1)) ? XFLOAT_DATA (num1) : XINT (num1);
2148 f2 = (FLOATP (num2)) ? XFLOAT_DATA (num2) : XINT (num2);
2151 switch (comparison)
2153 case equal:
2154 if (floatp ? f1 == f2 : XINT (num1) == XINT (num2))
2155 return Qt;
2156 return Qnil;
2158 case notequal:
2159 if (floatp ? f1 != f2 : XINT (num1) != XINT (num2))
2160 return Qt;
2161 return Qnil;
2163 case less:
2164 if (floatp ? f1 < f2 : XINT (num1) < XINT (num2))
2165 return Qt;
2166 return Qnil;
2168 case less_or_equal:
2169 if (floatp ? f1 <= f2 : XINT (num1) <= XINT (num2))
2170 return Qt;
2171 return Qnil;
2173 case grtr:
2174 if (floatp ? f1 > f2 : XINT (num1) > XINT (num2))
2175 return Qt;
2176 return Qnil;
2178 case grtr_or_equal:
2179 if (floatp ? f1 >= f2 : XINT (num1) >= XINT (num2))
2180 return Qt;
2181 return Qnil;
2183 default:
2184 abort ();
2188 DEFUN ("=", Feqlsign, Seqlsign, 2, 2, 0,
2189 doc: /* Return t if two args, both numbers or markers, are equal. */)
2190 (num1, num2)
2191 register Lisp_Object num1, num2;
2193 return arithcompare (num1, num2, equal);
2196 DEFUN ("<", Flss, Slss, 2, 2, 0,
2197 doc: /* Return t if first arg is less than second arg. Both must be numbers or markers. */)
2198 (num1, num2)
2199 register Lisp_Object num1, num2;
2201 return arithcompare (num1, num2, less);
2204 DEFUN (">", Fgtr, Sgtr, 2, 2, 0,
2205 doc: /* Return t if first arg is greater than second arg. Both must be numbers or markers. */)
2206 (num1, num2)
2207 register Lisp_Object num1, num2;
2209 return arithcompare (num1, num2, grtr);
2212 DEFUN ("<=", Fleq, Sleq, 2, 2, 0,
2213 doc: /* Return t if first arg is less than or equal to second arg.
2214 Both must be numbers or markers. */)
2215 (num1, num2)
2216 register Lisp_Object num1, num2;
2218 return arithcompare (num1, num2, less_or_equal);
2221 DEFUN (">=", Fgeq, Sgeq, 2, 2, 0,
2222 doc: /* Return t if first arg is greater than or equal to second arg.
2223 Both must be numbers or markers. */)
2224 (num1, num2)
2225 register Lisp_Object num1, num2;
2227 return arithcompare (num1, num2, grtr_or_equal);
2230 DEFUN ("/=", Fneq, Sneq, 2, 2, 0,
2231 doc: /* Return t if first arg is not equal to second arg. Both must be numbers or markers. */)
2232 (num1, num2)
2233 register Lisp_Object num1, num2;
2235 return arithcompare (num1, num2, notequal);
2238 DEFUN ("zerop", Fzerop, Szerop, 1, 1, 0,
2239 doc: /* Return t if NUMBER is zero. */)
2240 (number)
2241 register Lisp_Object number;
2243 CHECK_NUMBER_OR_FLOAT (number);
2245 if (FLOATP (number))
2247 if (XFLOAT_DATA (number) == 0.0)
2248 return Qt;
2249 return Qnil;
2252 if (!XINT (number))
2253 return Qt;
2254 return Qnil;
2257 /* Convert between long values and pairs of Lisp integers.
2258 Note that long_to_cons returns a single Lisp integer
2259 when the value fits in one. */
2261 Lisp_Object
2262 long_to_cons (i)
2263 unsigned long i;
2265 unsigned long top = i >> 16;
2266 unsigned int bot = i & 0xFFFF;
2267 if (top == 0)
2268 return make_number (bot);
2269 if (top == (unsigned long)-1 >> 16)
2270 return Fcons (make_number (-1), make_number (bot));
2271 return Fcons (make_number (top), make_number (bot));
2274 unsigned long
2275 cons_to_long (c)
2276 Lisp_Object c;
2278 Lisp_Object top, bot;
2279 if (INTEGERP (c))
2280 return XINT (c);
2281 top = XCAR (c);
2282 bot = XCDR (c);
2283 if (CONSP (bot))
2284 bot = XCAR (bot);
2285 return ((XINT (top) << 16) | XINT (bot));
2288 DEFUN ("number-to-string", Fnumber_to_string, Snumber_to_string, 1, 1, 0,
2289 doc: /* Return the decimal representation of NUMBER as a string.
2290 Uses a minus sign if negative.
2291 NUMBER may be an integer or a floating point number. */)
2292 (number)
2293 Lisp_Object number;
2295 char buffer[VALBITS];
2297 CHECK_NUMBER_OR_FLOAT (number);
2299 if (FLOATP (number))
2301 char pigbuf[350]; /* see comments in float_to_string */
2303 float_to_string (pigbuf, XFLOAT_DATA (number));
2304 return build_string (pigbuf);
2307 if (sizeof (int) == sizeof (EMACS_INT))
2308 sprintf (buffer, "%d", (int) XINT (number));
2309 else if (sizeof (long) == sizeof (EMACS_INT))
2310 sprintf (buffer, "%ld", (long) XINT (number));
2311 else
2312 abort ();
2313 return build_string (buffer);
2316 INLINE static int
2317 digit_to_number (character, base)
2318 int character, base;
2320 int digit;
2322 if (character >= '0' && character <= '9')
2323 digit = character - '0';
2324 else if (character >= 'a' && character <= 'z')
2325 digit = character - 'a' + 10;
2326 else if (character >= 'A' && character <= 'Z')
2327 digit = character - 'A' + 10;
2328 else
2329 return -1;
2331 if (digit >= base)
2332 return -1;
2333 else
2334 return digit;
2337 DEFUN ("string-to-number", Fstring_to_number, Sstring_to_number, 1, 2, 0,
2338 doc: /* Parse STRING as a decimal number and return the number.
2339 This parses both integers and floating point numbers.
2340 It ignores leading spaces and tabs.
2342 If BASE, interpret STRING as a number in that base. If BASE isn't
2343 present, base 10 is used. BASE must be between 2 and 16 (inclusive).
2344 If the base used is not 10, floating point is not recognized. */)
2345 (string, base)
2346 register Lisp_Object string, base;
2348 register unsigned char *p;
2349 register int b;
2350 int sign = 1;
2351 Lisp_Object val;
2353 CHECK_STRING (string);
2355 if (NILP (base))
2356 b = 10;
2357 else
2359 CHECK_NUMBER (base);
2360 b = XINT (base);
2361 if (b < 2 || b > 16)
2362 xsignal1 (Qargs_out_of_range, base);
2365 /* Skip any whitespace at the front of the number. Some versions of
2366 atoi do this anyway, so we might as well make Emacs lisp consistent. */
2367 p = SDATA (string);
2368 while (*p == ' ' || *p == '\t')
2369 p++;
2371 if (*p == '-')
2373 sign = -1;
2374 p++;
2376 else if (*p == '+')
2377 p++;
2379 if (isfloat_string (p) && b == 10)
2380 val = make_float (sign * atof (p));
2381 else
2383 double v = 0;
2385 while (1)
2387 int digit = digit_to_number (*p++, b);
2388 if (digit < 0)
2389 break;
2390 v = v * b + digit;
2393 val = make_fixnum_or_float (sign * v);
2396 return val;
2400 enum arithop
2402 Aadd,
2403 Asub,
2404 Amult,
2405 Adiv,
2406 Alogand,
2407 Alogior,
2408 Alogxor,
2409 Amax,
2410 Amin
2413 static Lisp_Object float_arith_driver P_ ((double, int, enum arithop,
2414 int, Lisp_Object *));
2415 extern Lisp_Object fmod_float ();
2417 Lisp_Object
2418 arith_driver (code, nargs, args)
2419 enum arithop code;
2420 int nargs;
2421 register Lisp_Object *args;
2423 register Lisp_Object val;
2424 register int argnum;
2425 register EMACS_INT accum = 0;
2426 register EMACS_INT next;
2428 switch (SWITCH_ENUM_CAST (code))
2430 case Alogior:
2431 case Alogxor:
2432 case Aadd:
2433 case Asub:
2434 accum = 0;
2435 break;
2436 case Amult:
2437 accum = 1;
2438 break;
2439 case Alogand:
2440 accum = -1;
2441 break;
2442 default:
2443 break;
2446 for (argnum = 0; argnum < nargs; argnum++)
2448 /* Using args[argnum] as argument to CHECK_NUMBER_... */
2449 val = args[argnum];
2450 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2452 if (FLOATP (val))
2453 return float_arith_driver ((double) accum, argnum, code,
2454 nargs, args);
2455 args[argnum] = val;
2456 next = XINT (args[argnum]);
2457 switch (SWITCH_ENUM_CAST (code))
2459 case Aadd:
2460 accum += next;
2461 break;
2462 case Asub:
2463 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2464 break;
2465 case Amult:
2466 accum *= next;
2467 break;
2468 case Adiv:
2469 if (!argnum)
2470 accum = next;
2471 else
2473 if (next == 0)
2474 xsignal0 (Qarith_error);
2475 accum /= next;
2477 break;
2478 case Alogand:
2479 accum &= next;
2480 break;
2481 case Alogior:
2482 accum |= next;
2483 break;
2484 case Alogxor:
2485 accum ^= next;
2486 break;
2487 case Amax:
2488 if (!argnum || next > accum)
2489 accum = next;
2490 break;
2491 case Amin:
2492 if (!argnum || next < accum)
2493 accum = next;
2494 break;
2498 XSETINT (val, accum);
2499 return val;
2502 #undef isnan
2503 #define isnan(x) ((x) != (x))
2505 static Lisp_Object
2506 float_arith_driver (accum, argnum, code, nargs, args)
2507 double accum;
2508 register int argnum;
2509 enum arithop code;
2510 int nargs;
2511 register Lisp_Object *args;
2513 register Lisp_Object val;
2514 double next;
2516 for (; argnum < nargs; argnum++)
2518 val = args[argnum]; /* using args[argnum] as argument to CHECK_NUMBER_... */
2519 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2521 if (FLOATP (val))
2523 next = XFLOAT_DATA (val);
2525 else
2527 args[argnum] = val; /* runs into a compiler bug. */
2528 next = XINT (args[argnum]);
2530 switch (SWITCH_ENUM_CAST (code))
2532 case Aadd:
2533 accum += next;
2534 break;
2535 case Asub:
2536 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2537 break;
2538 case Amult:
2539 accum *= next;
2540 break;
2541 case Adiv:
2542 if (!argnum)
2543 accum = next;
2544 else
2546 if (! IEEE_FLOATING_POINT && next == 0)
2547 xsignal0 (Qarith_error);
2548 accum /= next;
2550 break;
2551 case Alogand:
2552 case Alogior:
2553 case Alogxor:
2554 return wrong_type_argument (Qinteger_or_marker_p, val);
2555 case Amax:
2556 if (!argnum || isnan (next) || next > accum)
2557 accum = next;
2558 break;
2559 case Amin:
2560 if (!argnum || isnan (next) || next < accum)
2561 accum = next;
2562 break;
2566 return make_float (accum);
2570 DEFUN ("+", Fplus, Splus, 0, MANY, 0,
2571 doc: /* Return sum of any number of arguments, which are numbers or markers.
2572 usage: (+ &rest NUMBERS-OR-MARKERS) */)
2573 (nargs, args)
2574 int nargs;
2575 Lisp_Object *args;
2577 return arith_driver (Aadd, nargs, args);
2580 DEFUN ("-", Fminus, Sminus, 0, MANY, 0,
2581 doc: /* Negate number or subtract numbers or markers and return the result.
2582 With one arg, negates it. With more than one arg,
2583 subtracts all but the first from the first.
2584 usage: (- &optional NUMBER-OR-MARKER &rest MORE-NUMBERS-OR-MARKERS) */)
2585 (nargs, args)
2586 int nargs;
2587 Lisp_Object *args;
2589 return arith_driver (Asub, nargs, args);
2592 DEFUN ("*", Ftimes, Stimes, 0, MANY, 0,
2593 doc: /* Return product of any number of arguments, which are numbers or markers.
2594 usage: (* &rest NUMBERS-OR-MARKERS) */)
2595 (nargs, args)
2596 int nargs;
2597 Lisp_Object *args;
2599 return arith_driver (Amult, nargs, args);
2602 DEFUN ("/", Fquo, Squo, 2, MANY, 0,
2603 doc: /* Return first argument divided by all the remaining arguments.
2604 The arguments must be numbers or markers.
2605 usage: (/ DIVIDEND DIVISOR &rest DIVISORS) */)
2606 (nargs, args)
2607 int nargs;
2608 Lisp_Object *args;
2610 int argnum;
2611 for (argnum = 2; argnum < nargs; argnum++)
2612 if (FLOATP (args[argnum]))
2613 return float_arith_driver (0, 0, Adiv, nargs, args);
2614 return arith_driver (Adiv, nargs, args);
2617 DEFUN ("%", Frem, Srem, 2, 2, 0,
2618 doc: /* Return remainder of X divided by Y.
2619 Both must be integers or markers. */)
2620 (x, y)
2621 register Lisp_Object x, y;
2623 Lisp_Object val;
2625 CHECK_NUMBER_COERCE_MARKER (x);
2626 CHECK_NUMBER_COERCE_MARKER (y);
2628 if (XFASTINT (y) == 0)
2629 xsignal0 (Qarith_error);
2631 XSETINT (val, XINT (x) % XINT (y));
2632 return val;
2635 #ifndef HAVE_FMOD
2636 double
2637 fmod (f1, f2)
2638 double f1, f2;
2640 double r = f1;
2642 if (f2 < 0.0)
2643 f2 = -f2;
2645 /* If the magnitude of the result exceeds that of the divisor, or
2646 the sign of the result does not agree with that of the dividend,
2647 iterate with the reduced value. This does not yield a
2648 particularly accurate result, but at least it will be in the
2649 range promised by fmod. */
2651 r -= f2 * floor (r / f2);
2652 while (f2 <= (r < 0 ? -r : r) || ((r < 0) != (f1 < 0) && ! isnan (r)));
2654 return r;
2656 #endif /* ! HAVE_FMOD */
2658 DEFUN ("mod", Fmod, Smod, 2, 2, 0,
2659 doc: /* Return X modulo Y.
2660 The result falls between zero (inclusive) and Y (exclusive).
2661 Both X and Y must be numbers or markers. */)
2662 (x, y)
2663 register Lisp_Object x, y;
2665 Lisp_Object val;
2666 EMACS_INT i1, i2;
2668 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (x);
2669 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (y);
2671 if (FLOATP (x) || FLOATP (y))
2672 return fmod_float (x, y);
2674 i1 = XINT (x);
2675 i2 = XINT (y);
2677 if (i2 == 0)
2678 xsignal0 (Qarith_error);
2680 i1 %= i2;
2682 /* If the "remainder" comes out with the wrong sign, fix it. */
2683 if (i2 < 0 ? i1 > 0 : i1 < 0)
2684 i1 += i2;
2686 XSETINT (val, i1);
2687 return val;
2690 DEFUN ("max", Fmax, Smax, 1, MANY, 0,
2691 doc: /* Return largest of all the arguments (which must be numbers or markers).
2692 The value is always a number; markers are converted to numbers.
2693 usage: (max NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2694 (nargs, args)
2695 int nargs;
2696 Lisp_Object *args;
2698 return arith_driver (Amax, nargs, args);
2701 DEFUN ("min", Fmin, Smin, 1, MANY, 0,
2702 doc: /* Return smallest of all the arguments (which must be numbers or markers).
2703 The value is always a number; markers are converted to numbers.
2704 usage: (min NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2705 (nargs, args)
2706 int nargs;
2707 Lisp_Object *args;
2709 return arith_driver (Amin, nargs, args);
2712 DEFUN ("logand", Flogand, Slogand, 0, MANY, 0,
2713 doc: /* Return bitwise-and of all the arguments.
2714 Arguments may be integers, or markers converted to integers.
2715 usage: (logand &rest INTS-OR-MARKERS) */)
2716 (nargs, args)
2717 int nargs;
2718 Lisp_Object *args;
2720 return arith_driver (Alogand, nargs, args);
2723 DEFUN ("logior", Flogior, Slogior, 0, MANY, 0,
2724 doc: /* Return bitwise-or of all the arguments.
2725 Arguments may be integers, or markers converted to integers.
2726 usage: (logior &rest INTS-OR-MARKERS) */)
2727 (nargs, args)
2728 int nargs;
2729 Lisp_Object *args;
2731 return arith_driver (Alogior, nargs, args);
2734 DEFUN ("logxor", Flogxor, Slogxor, 0, MANY, 0,
2735 doc: /* Return bitwise-exclusive-or of all the arguments.
2736 Arguments may be integers, or markers converted to integers.
2737 usage: (logxor &rest INTS-OR-MARKERS) */)
2738 (nargs, args)
2739 int nargs;
2740 Lisp_Object *args;
2742 return arith_driver (Alogxor, nargs, args);
2745 DEFUN ("ash", Fash, Sash, 2, 2, 0,
2746 doc: /* Return VALUE with its bits shifted left by COUNT.
2747 If COUNT is negative, shifting is actually to the right.
2748 In this case, the sign bit is duplicated. */)
2749 (value, count)
2750 register Lisp_Object value, count;
2752 register Lisp_Object val;
2754 CHECK_NUMBER (value);
2755 CHECK_NUMBER (count);
2757 if (XINT (count) >= BITS_PER_EMACS_INT)
2758 XSETINT (val, 0);
2759 else if (XINT (count) > 0)
2760 XSETINT (val, XINT (value) << XFASTINT (count));
2761 else if (XINT (count) <= -BITS_PER_EMACS_INT)
2762 XSETINT (val, XINT (value) < 0 ? -1 : 0);
2763 else
2764 XSETINT (val, XINT (value) >> -XINT (count));
2765 return val;
2768 DEFUN ("lsh", Flsh, Slsh, 2, 2, 0,
2769 doc: /* Return VALUE with its bits shifted left by COUNT.
2770 If COUNT is negative, shifting is actually to the right.
2771 In this case, zeros are shifted in on the left. */)
2772 (value, count)
2773 register Lisp_Object value, count;
2775 register Lisp_Object val;
2777 CHECK_NUMBER (value);
2778 CHECK_NUMBER (count);
2780 if (XINT (count) >= BITS_PER_EMACS_INT)
2781 XSETINT (val, 0);
2782 else if (XINT (count) > 0)
2783 XSETINT (val, (EMACS_UINT) XUINT (value) << XFASTINT (count));
2784 else if (XINT (count) <= -BITS_PER_EMACS_INT)
2785 XSETINT (val, 0);
2786 else
2787 XSETINT (val, (EMACS_UINT) XUINT (value) >> -XINT (count));
2788 return val;
2791 DEFUN ("1+", Fadd1, Sadd1, 1, 1, 0,
2792 doc: /* Return NUMBER plus one. NUMBER may be a number or a marker.
2793 Markers are converted to integers. */)
2794 (number)
2795 register Lisp_Object number;
2797 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
2799 if (FLOATP (number))
2800 return (make_float (1.0 + XFLOAT_DATA (number)));
2802 XSETINT (number, XINT (number) + 1);
2803 return number;
2806 DEFUN ("1-", Fsub1, Ssub1, 1, 1, 0,
2807 doc: /* Return NUMBER minus one. NUMBER may be a number or a marker.
2808 Markers are converted to integers. */)
2809 (number)
2810 register Lisp_Object number;
2812 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
2814 if (FLOATP (number))
2815 return (make_float (-1.0 + XFLOAT_DATA (number)));
2817 XSETINT (number, XINT (number) - 1);
2818 return number;
2821 DEFUN ("lognot", Flognot, Slognot, 1, 1, 0,
2822 doc: /* Return the bitwise complement of NUMBER. NUMBER must be an integer. */)
2823 (number)
2824 register Lisp_Object number;
2826 CHECK_NUMBER (number);
2827 XSETINT (number, ~XINT (number));
2828 return number;
2831 DEFUN ("byteorder", Fbyteorder, Sbyteorder, 0, 0, 0,
2832 doc: /* Return the byteorder for the machine.
2833 Returns 66 (ASCII uppercase B) for big endian machines or 108 (ASCII
2834 lowercase l) for small endian machines. */)
2837 unsigned i = 0x04030201;
2838 int order = *(char *)&i == 1 ? 108 : 66;
2840 return make_number (order);
2845 void
2846 syms_of_data ()
2848 Lisp_Object error_tail, arith_tail;
2850 Qquote = intern ("quote");
2851 Qlambda = intern ("lambda");
2852 Qsubr = intern ("subr");
2853 Qerror_conditions = intern ("error-conditions");
2854 Qerror_message = intern ("error-message");
2855 Qtop_level = intern ("top-level");
2857 Qerror = intern ("error");
2858 Qquit = intern ("quit");
2859 Qwrong_type_argument = intern ("wrong-type-argument");
2860 Qargs_out_of_range = intern ("args-out-of-range");
2861 Qvoid_function = intern ("void-function");
2862 Qcyclic_function_indirection = intern ("cyclic-function-indirection");
2863 Qcyclic_variable_indirection = intern ("cyclic-variable-indirection");
2864 Qvoid_variable = intern ("void-variable");
2865 Qsetting_constant = intern ("setting-constant");
2866 Qinvalid_read_syntax = intern ("invalid-read-syntax");
2868 Qinvalid_function = intern ("invalid-function");
2869 Qwrong_number_of_arguments = intern ("wrong-number-of-arguments");
2870 Qno_catch = intern ("no-catch");
2871 Qend_of_file = intern ("end-of-file");
2872 Qarith_error = intern ("arith-error");
2873 Qbeginning_of_buffer = intern ("beginning-of-buffer");
2874 Qend_of_buffer = intern ("end-of-buffer");
2875 Qbuffer_read_only = intern ("buffer-read-only");
2876 Qtext_read_only = intern ("text-read-only");
2877 Qmark_inactive = intern ("mark-inactive");
2879 Qlistp = intern ("listp");
2880 Qconsp = intern ("consp");
2881 Qsymbolp = intern ("symbolp");
2882 Qkeywordp = intern ("keywordp");
2883 Qintegerp = intern ("integerp");
2884 Qnatnump = intern ("natnump");
2885 Qwholenump = intern ("wholenump");
2886 Qstringp = intern ("stringp");
2887 Qarrayp = intern ("arrayp");
2888 Qsequencep = intern ("sequencep");
2889 Qbufferp = intern ("bufferp");
2890 Qvectorp = intern ("vectorp");
2891 Qchar_or_string_p = intern ("char-or-string-p");
2892 Qmarkerp = intern ("markerp");
2893 Qbuffer_or_string_p = intern ("buffer-or-string-p");
2894 Qinteger_or_marker_p = intern ("integer-or-marker-p");
2895 Qboundp = intern ("boundp");
2896 Qfboundp = intern ("fboundp");
2898 Qfloatp = intern ("floatp");
2899 Qnumberp = intern ("numberp");
2900 Qnumber_or_marker_p = intern ("number-or-marker-p");
2902 Qchar_table_p = intern ("char-table-p");
2903 Qvector_or_char_table_p = intern ("vector-or-char-table-p");
2905 Qsubrp = intern ("subrp");
2906 Qunevalled = intern ("unevalled");
2907 Qmany = intern ("many");
2909 Qcdr = intern ("cdr");
2911 /* Handle automatic advice activation */
2912 Qad_advice_info = intern ("ad-advice-info");
2913 Qad_activate_internal = intern ("ad-activate-internal");
2915 error_tail = Fcons (Qerror, Qnil);
2917 /* ERROR is used as a signaler for random errors for which nothing else is right */
2919 Fput (Qerror, Qerror_conditions,
2920 error_tail);
2921 Fput (Qerror, Qerror_message,
2922 build_string ("error"));
2924 Fput (Qquit, Qerror_conditions,
2925 Fcons (Qquit, Qnil));
2926 Fput (Qquit, Qerror_message,
2927 build_string ("Quit"));
2929 Fput (Qwrong_type_argument, Qerror_conditions,
2930 Fcons (Qwrong_type_argument, error_tail));
2931 Fput (Qwrong_type_argument, Qerror_message,
2932 build_string ("Wrong type argument"));
2934 Fput (Qargs_out_of_range, Qerror_conditions,
2935 Fcons (Qargs_out_of_range, error_tail));
2936 Fput (Qargs_out_of_range, Qerror_message,
2937 build_string ("Args out of range"));
2939 Fput (Qvoid_function, Qerror_conditions,
2940 Fcons (Qvoid_function, error_tail));
2941 Fput (Qvoid_function, Qerror_message,
2942 build_string ("Symbol's function definition is void"));
2944 Fput (Qcyclic_function_indirection, Qerror_conditions,
2945 Fcons (Qcyclic_function_indirection, error_tail));
2946 Fput (Qcyclic_function_indirection, Qerror_message,
2947 build_string ("Symbol's chain of function indirections contains a loop"));
2949 Fput (Qcyclic_variable_indirection, Qerror_conditions,
2950 Fcons (Qcyclic_variable_indirection, error_tail));
2951 Fput (Qcyclic_variable_indirection, Qerror_message,
2952 build_string ("Symbol's chain of variable indirections contains a loop"));
2954 Qcircular_list = intern ("circular-list");
2955 staticpro (&Qcircular_list);
2956 Fput (Qcircular_list, Qerror_conditions,
2957 Fcons (Qcircular_list, error_tail));
2958 Fput (Qcircular_list, Qerror_message,
2959 build_string ("List contains a loop"));
2961 Fput (Qvoid_variable, Qerror_conditions,
2962 Fcons (Qvoid_variable, error_tail));
2963 Fput (Qvoid_variable, Qerror_message,
2964 build_string ("Symbol's value as variable is void"));
2966 Fput (Qsetting_constant, Qerror_conditions,
2967 Fcons (Qsetting_constant, error_tail));
2968 Fput (Qsetting_constant, Qerror_message,
2969 build_string ("Attempt to set a constant symbol"));
2971 Fput (Qinvalid_read_syntax, Qerror_conditions,
2972 Fcons (Qinvalid_read_syntax, error_tail));
2973 Fput (Qinvalid_read_syntax, Qerror_message,
2974 build_string ("Invalid read syntax"));
2976 Fput (Qinvalid_function, Qerror_conditions,
2977 Fcons (Qinvalid_function, error_tail));
2978 Fput (Qinvalid_function, Qerror_message,
2979 build_string ("Invalid function"));
2981 Fput (Qwrong_number_of_arguments, Qerror_conditions,
2982 Fcons (Qwrong_number_of_arguments, error_tail));
2983 Fput (Qwrong_number_of_arguments, Qerror_message,
2984 build_string ("Wrong number of arguments"));
2986 Fput (Qno_catch, Qerror_conditions,
2987 Fcons (Qno_catch, error_tail));
2988 Fput (Qno_catch, Qerror_message,
2989 build_string ("No catch for tag"));
2991 Fput (Qend_of_file, Qerror_conditions,
2992 Fcons (Qend_of_file, error_tail));
2993 Fput (Qend_of_file, Qerror_message,
2994 build_string ("End of file during parsing"));
2996 arith_tail = Fcons (Qarith_error, error_tail);
2997 Fput (Qarith_error, Qerror_conditions,
2998 arith_tail);
2999 Fput (Qarith_error, Qerror_message,
3000 build_string ("Arithmetic error"));
3002 Fput (Qbeginning_of_buffer, Qerror_conditions,
3003 Fcons (Qbeginning_of_buffer, error_tail));
3004 Fput (Qbeginning_of_buffer, Qerror_message,
3005 build_string ("Beginning of buffer"));
3007 Fput (Qend_of_buffer, Qerror_conditions,
3008 Fcons (Qend_of_buffer, error_tail));
3009 Fput (Qend_of_buffer, Qerror_message,
3010 build_string ("End of buffer"));
3012 Fput (Qbuffer_read_only, Qerror_conditions,
3013 Fcons (Qbuffer_read_only, error_tail));
3014 Fput (Qbuffer_read_only, Qerror_message,
3015 build_string ("Buffer is read-only"));
3017 Fput (Qtext_read_only, Qerror_conditions,
3018 Fcons (Qtext_read_only, error_tail));
3019 Fput (Qtext_read_only, Qerror_message,
3020 build_string ("Text is read-only"));
3022 Qrange_error = intern ("range-error");
3023 Qdomain_error = intern ("domain-error");
3024 Qsingularity_error = intern ("singularity-error");
3025 Qoverflow_error = intern ("overflow-error");
3026 Qunderflow_error = intern ("underflow-error");
3028 Fput (Qdomain_error, Qerror_conditions,
3029 Fcons (Qdomain_error, arith_tail));
3030 Fput (Qdomain_error, Qerror_message,
3031 build_string ("Arithmetic domain error"));
3033 Fput (Qrange_error, Qerror_conditions,
3034 Fcons (Qrange_error, arith_tail));
3035 Fput (Qrange_error, Qerror_message,
3036 build_string ("Arithmetic range error"));
3038 Fput (Qsingularity_error, Qerror_conditions,
3039 Fcons (Qsingularity_error, Fcons (Qdomain_error, arith_tail)));
3040 Fput (Qsingularity_error, Qerror_message,
3041 build_string ("Arithmetic singularity error"));
3043 Fput (Qoverflow_error, Qerror_conditions,
3044 Fcons (Qoverflow_error, Fcons (Qdomain_error, arith_tail)));
3045 Fput (Qoverflow_error, Qerror_message,
3046 build_string ("Arithmetic overflow error"));
3048 Fput (Qunderflow_error, Qerror_conditions,
3049 Fcons (Qunderflow_error, Fcons (Qdomain_error, arith_tail)));
3050 Fput (Qunderflow_error, Qerror_message,
3051 build_string ("Arithmetic underflow error"));
3053 staticpro (&Qrange_error);
3054 staticpro (&Qdomain_error);
3055 staticpro (&Qsingularity_error);
3056 staticpro (&Qoverflow_error);
3057 staticpro (&Qunderflow_error);
3059 staticpro (&Qnil);
3060 staticpro (&Qt);
3061 staticpro (&Qquote);
3062 staticpro (&Qlambda);
3063 staticpro (&Qsubr);
3064 staticpro (&Qunbound);
3065 staticpro (&Qerror_conditions);
3066 staticpro (&Qerror_message);
3067 staticpro (&Qtop_level);
3069 staticpro (&Qerror);
3070 staticpro (&Qquit);
3071 staticpro (&Qwrong_type_argument);
3072 staticpro (&Qargs_out_of_range);
3073 staticpro (&Qvoid_function);
3074 staticpro (&Qcyclic_function_indirection);
3075 staticpro (&Qcyclic_variable_indirection);
3076 staticpro (&Qvoid_variable);
3077 staticpro (&Qsetting_constant);
3078 staticpro (&Qinvalid_read_syntax);
3079 staticpro (&Qwrong_number_of_arguments);
3080 staticpro (&Qinvalid_function);
3081 staticpro (&Qno_catch);
3082 staticpro (&Qend_of_file);
3083 staticpro (&Qarith_error);
3084 staticpro (&Qbeginning_of_buffer);
3085 staticpro (&Qend_of_buffer);
3086 staticpro (&Qbuffer_read_only);
3087 staticpro (&Qtext_read_only);
3088 staticpro (&Qmark_inactive);
3090 staticpro (&Qlistp);
3091 staticpro (&Qconsp);
3092 staticpro (&Qsymbolp);
3093 staticpro (&Qkeywordp);
3094 staticpro (&Qintegerp);
3095 staticpro (&Qnatnump);
3096 staticpro (&Qwholenump);
3097 staticpro (&Qstringp);
3098 staticpro (&Qarrayp);
3099 staticpro (&Qsequencep);
3100 staticpro (&Qbufferp);
3101 staticpro (&Qvectorp);
3102 staticpro (&Qchar_or_string_p);
3103 staticpro (&Qmarkerp);
3104 staticpro (&Qbuffer_or_string_p);
3105 staticpro (&Qinteger_or_marker_p);
3106 staticpro (&Qfloatp);
3107 staticpro (&Qnumberp);
3108 staticpro (&Qnumber_or_marker_p);
3109 staticpro (&Qchar_table_p);
3110 staticpro (&Qvector_or_char_table_p);
3111 staticpro (&Qsubrp);
3112 staticpro (&Qmany);
3113 staticpro (&Qunevalled);
3115 staticpro (&Qboundp);
3116 staticpro (&Qfboundp);
3117 staticpro (&Qcdr);
3118 staticpro (&Qad_advice_info);
3119 staticpro (&Qad_activate_internal);
3121 /* Types that type-of returns. */
3122 Qinteger = intern ("integer");
3123 Qsymbol = intern ("symbol");
3124 Qstring = intern ("string");
3125 Qcons = intern ("cons");
3126 Qmarker = intern ("marker");
3127 Qoverlay = intern ("overlay");
3128 Qfloat = intern ("float");
3129 Qwindow_configuration = intern ("window-configuration");
3130 Qprocess = intern ("process");
3131 Qwindow = intern ("window");
3132 /* Qsubr = intern ("subr"); */
3133 Qcompiled_function = intern ("compiled-function");
3134 Qbuffer = intern ("buffer");
3135 Qframe = intern ("frame");
3136 Qvector = intern ("vector");
3137 Qchar_table = intern ("char-table");
3138 Qbool_vector = intern ("bool-vector");
3139 Qhash_table = intern ("hash-table");
3141 staticpro (&Qinteger);
3142 staticpro (&Qsymbol);
3143 staticpro (&Qstring);
3144 staticpro (&Qcons);
3145 staticpro (&Qmarker);
3146 staticpro (&Qoverlay);
3147 staticpro (&Qfloat);
3148 staticpro (&Qwindow_configuration);
3149 staticpro (&Qprocess);
3150 staticpro (&Qwindow);
3151 /* staticpro (&Qsubr); */
3152 staticpro (&Qcompiled_function);
3153 staticpro (&Qbuffer);
3154 staticpro (&Qframe);
3155 staticpro (&Qvector);
3156 staticpro (&Qchar_table);
3157 staticpro (&Qbool_vector);
3158 staticpro (&Qhash_table);
3160 defsubr (&Sindirect_variable);
3161 defsubr (&Sinteractive_form);
3162 defsubr (&Seq);
3163 defsubr (&Snull);
3164 defsubr (&Stype_of);
3165 defsubr (&Slistp);
3166 defsubr (&Snlistp);
3167 defsubr (&Sconsp);
3168 defsubr (&Satom);
3169 defsubr (&Sintegerp);
3170 defsubr (&Sinteger_or_marker_p);
3171 defsubr (&Snumberp);
3172 defsubr (&Snumber_or_marker_p);
3173 defsubr (&Sfloatp);
3174 defsubr (&Snatnump);
3175 defsubr (&Ssymbolp);
3176 defsubr (&Skeywordp);
3177 defsubr (&Sstringp);
3178 defsubr (&Smultibyte_string_p);
3179 defsubr (&Svectorp);
3180 defsubr (&Schar_table_p);
3181 defsubr (&Svector_or_char_table_p);
3182 defsubr (&Sbool_vector_p);
3183 defsubr (&Sarrayp);
3184 defsubr (&Ssequencep);
3185 defsubr (&Sbufferp);
3186 defsubr (&Smarkerp);
3187 defsubr (&Ssubrp);
3188 defsubr (&Sbyte_code_function_p);
3189 defsubr (&Schar_or_string_p);
3190 defsubr (&Scar);
3191 defsubr (&Scdr);
3192 defsubr (&Scar_safe);
3193 defsubr (&Scdr_safe);
3194 defsubr (&Ssetcar);
3195 defsubr (&Ssetcdr);
3196 defsubr (&Ssymbol_function);
3197 defsubr (&Sindirect_function);
3198 defsubr (&Ssymbol_plist);
3199 defsubr (&Ssymbol_name);
3200 defsubr (&Smakunbound);
3201 defsubr (&Sfmakunbound);
3202 defsubr (&Sboundp);
3203 defsubr (&Sfboundp);
3204 defsubr (&Sfset);
3205 defsubr (&Sdefalias);
3206 defsubr (&Ssetplist);
3207 defsubr (&Ssymbol_value);
3208 defsubr (&Sset);
3209 defsubr (&Sdefault_boundp);
3210 defsubr (&Sdefault_value);
3211 defsubr (&Sset_default);
3212 defsubr (&Ssetq_default);
3213 defsubr (&Smake_variable_buffer_local);
3214 defsubr (&Smake_local_variable);
3215 defsubr (&Skill_local_variable);
3216 defsubr (&Smake_variable_frame_local);
3217 defsubr (&Slocal_variable_p);
3218 defsubr (&Slocal_variable_if_set_p);
3219 defsubr (&Svariable_binding_locus);
3220 #if 0 /* XXX Remove this. --lorentey */
3221 defsubr (&Sterminal_local_value);
3222 defsubr (&Sset_terminal_local_value);
3223 #endif
3224 defsubr (&Saref);
3225 defsubr (&Saset);
3226 defsubr (&Snumber_to_string);
3227 defsubr (&Sstring_to_number);
3228 defsubr (&Seqlsign);
3229 defsubr (&Slss);
3230 defsubr (&Sgtr);
3231 defsubr (&Sleq);
3232 defsubr (&Sgeq);
3233 defsubr (&Sneq);
3234 defsubr (&Szerop);
3235 defsubr (&Splus);
3236 defsubr (&Sminus);
3237 defsubr (&Stimes);
3238 defsubr (&Squo);
3239 defsubr (&Srem);
3240 defsubr (&Smod);
3241 defsubr (&Smax);
3242 defsubr (&Smin);
3243 defsubr (&Slogand);
3244 defsubr (&Slogior);
3245 defsubr (&Slogxor);
3246 defsubr (&Slsh);
3247 defsubr (&Sash);
3248 defsubr (&Sadd1);
3249 defsubr (&Ssub1);
3250 defsubr (&Slognot);
3251 defsubr (&Sbyteorder);
3252 defsubr (&Ssubr_arity);
3253 defsubr (&Ssubr_name);
3255 XSYMBOL (Qwholenump)->function = XSYMBOL (Qnatnump)->function;
3257 DEFVAR_LISP ("most-positive-fixnum", &Vmost_positive_fixnum,
3258 doc: /* The largest value that is representable in a Lisp integer. */);
3259 Vmost_positive_fixnum = make_number (MOST_POSITIVE_FIXNUM);
3260 XSYMBOL (intern ("most-positive-fixnum"))->constant = 1;
3262 DEFVAR_LISP ("most-negative-fixnum", &Vmost_negative_fixnum,
3263 doc: /* The smallest value that is representable in a Lisp integer. */);
3264 Vmost_negative_fixnum = make_number (MOST_NEGATIVE_FIXNUM);
3265 XSYMBOL (intern ("most-negative-fixnum"))->constant = 1;
3268 SIGTYPE
3269 arith_error (signo)
3270 int signo;
3272 #if defined(USG) && !defined(POSIX_SIGNALS)
3273 /* USG systems forget handlers when they are used;
3274 must reestablish each time */
3275 signal (signo, arith_error);
3276 #endif /* USG */
3277 #ifdef VMS
3278 /* VMS systems are like USG. */
3279 signal (signo, arith_error);
3280 #endif /* VMS */
3281 #ifdef BSD4_1
3282 sigrelse (SIGFPE);
3283 #else /* not BSD4_1 */
3284 sigsetmask (SIGEMPTYMASK);
3285 #endif /* not BSD4_1 */
3287 SIGNAL_THREAD_CHECK (signo);
3288 xsignal0 (Qarith_error);
3291 void
3292 init_data ()
3294 /* Don't do this if just dumping out.
3295 We don't want to call `signal' in this case
3296 so that we don't have trouble with dumping
3297 signal-delivering routines in an inconsistent state. */
3298 #ifndef CANNOT_DUMP
3299 if (!initialized)
3300 return;
3301 #endif /* CANNOT_DUMP */
3302 signal (SIGFPE, arith_error);
3304 #ifdef uts
3305 signal (SIGEMT, arith_error);
3306 #endif /* uts */
3309 /* arch-tag: 25879798-b84d-479a-9c89-7d148e2109f7
3310 (do not change this comment) */