(isearch-forward-regexp, isearch-forward-word)
[emacs.git] / src / data.c
blob54c0d7c211cfddef85146b4e0f1b0afb23a56c33
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 #include <math.h>
50 #if !defined (atof)
51 extern double atof ();
52 #endif /* !atof */
54 Lisp_Object Qnil, Qt, Qquote, Qlambda, Qsubr, Qunbound;
55 Lisp_Object Qerror_conditions, Qerror_message, Qtop_level;
56 Lisp_Object Qerror, Qquit, Qwrong_type_argument, Qargs_out_of_range;
57 Lisp_Object Qvoid_variable, Qvoid_function, Qcyclic_function_indirection;
58 Lisp_Object Qcyclic_variable_indirection, Qcircular_list;
59 Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
60 Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
61 Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
62 Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
63 Lisp_Object Qtext_read_only;
65 Lisp_Object Qintegerp, Qnatnump, Qwholenump, Qsymbolp, Qlistp, Qconsp;
66 Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp;
67 Lisp_Object Qchar_or_string_p, Qmarkerp, Qinteger_or_marker_p, Qvectorp;
68 Lisp_Object Qbuffer_or_string_p, Qkeywordp;
69 Lisp_Object Qboundp, Qfboundp;
70 Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
72 Lisp_Object Qcdr;
73 Lisp_Object Qad_advice_info, Qad_activate_internal;
75 Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
76 Lisp_Object Qoverflow_error, Qunderflow_error;
78 Lisp_Object Qfloatp;
79 Lisp_Object Qnumberp, Qnumber_or_marker_p;
81 Lisp_Object Qinteger;
82 static Lisp_Object Qsymbol, Qstring, Qcons, Qmarker, Qoverlay;
83 static Lisp_Object Qfloat, Qwindow_configuration, Qwindow;
84 Lisp_Object Qprocess;
85 static Lisp_Object Qcompiled_function, Qbuffer, Qframe, Qvector;
86 static Lisp_Object Qchar_table, Qbool_vector, Qhash_table;
87 static Lisp_Object Qsubrp, Qmany, Qunevalled;
89 static Lisp_Object swap_in_symval_forwarding P_ ((Lisp_Object, Lisp_Object));
91 Lisp_Object Vmost_positive_fixnum, Vmost_negative_fixnum;
94 void
95 circular_list_error (list)
96 Lisp_Object list;
98 xsignal (Qcircular_list, list);
102 Lisp_Object
103 wrong_type_argument (predicate, value)
104 register Lisp_Object predicate, value;
106 /* If VALUE is not even a valid Lisp object, abort here
107 where we can get a backtrace showing where it came from. */
108 if ((unsigned int) XTYPE (value) >= Lisp_Type_Limit)
109 abort ();
111 xsignal2 (Qwrong_type_argument, predicate, value);
114 void
115 pure_write_error ()
117 error ("Attempt to modify read-only object");
120 void
121 args_out_of_range (a1, a2)
122 Lisp_Object a1, a2;
124 xsignal2 (Qargs_out_of_range, a1, a2);
127 void
128 args_out_of_range_3 (a1, a2, a3)
129 Lisp_Object a1, a2, a3;
131 xsignal3 (Qargs_out_of_range, a1, a2, a3);
134 /* On some machines, XINT needs a temporary location.
135 Here it is, in case it is needed. */
137 int sign_extend_temp;
139 /* On a few machines, XINT can only be done by calling this. */
142 sign_extend_lisp_int (num)
143 EMACS_INT num;
145 if (num & (((EMACS_INT) 1) << (VALBITS - 1)))
146 return num | (((EMACS_INT) (-1)) << VALBITS);
147 else
148 return num & ((((EMACS_INT) 1) << VALBITS) - 1);
151 /* Data type predicates */
153 DEFUN ("eq", Feq, Seq, 2, 2, 0,
154 doc: /* Return t if the two args are the same Lisp object. */)
155 (obj1, obj2)
156 Lisp_Object obj1, obj2;
158 if (EQ (obj1, obj2))
159 return Qt;
160 return Qnil;
163 DEFUN ("null", Fnull, Snull, 1, 1, 0,
164 doc: /* Return t if OBJECT is nil. */)
165 (object)
166 Lisp_Object object;
168 if (NILP (object))
169 return Qt;
170 return Qnil;
173 DEFUN ("type-of", Ftype_of, Stype_of, 1, 1, 0,
174 doc: /* Return a symbol representing the type of OBJECT.
175 The symbol returned names the object's basic type;
176 for example, (type-of 1) returns `integer'. */)
177 (object)
178 Lisp_Object object;
180 switch (XTYPE (object))
182 case Lisp_Int:
183 return Qinteger;
185 case Lisp_Symbol:
186 return Qsymbol;
188 case Lisp_String:
189 return Qstring;
191 case Lisp_Cons:
192 return Qcons;
194 case Lisp_Misc:
195 switch (XMISCTYPE (object))
197 case Lisp_Misc_Marker:
198 return Qmarker;
199 case Lisp_Misc_Overlay:
200 return Qoverlay;
201 case Lisp_Misc_Float:
202 return Qfloat;
204 abort ();
206 case Lisp_Vectorlike:
207 if (WINDOW_CONFIGURATIONP (object))
208 return Qwindow_configuration;
209 if (PROCESSP (object))
210 return Qprocess;
211 if (WINDOWP (object))
212 return Qwindow;
213 if (SUBRP (object))
214 return Qsubr;
215 if (COMPILEDP (object))
216 return Qcompiled_function;
217 if (BUFFERP (object))
218 return Qbuffer;
219 if (CHAR_TABLE_P (object))
220 return Qchar_table;
221 if (BOOL_VECTOR_P (object))
222 return Qbool_vector;
223 if (FRAMEP (object))
224 return Qframe;
225 if (HASH_TABLE_P (object))
226 return Qhash_table;
227 return Qvector;
229 case Lisp_Float:
230 return Qfloat;
232 default:
233 abort ();
237 DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0,
238 doc: /* Return t if OBJECT is a cons cell. */)
239 (object)
240 Lisp_Object object;
242 if (CONSP (object))
243 return Qt;
244 return Qnil;
247 DEFUN ("atom", Fatom, Satom, 1, 1, 0,
248 doc: /* Return t if OBJECT is not a cons cell. This includes nil. */)
249 (object)
250 Lisp_Object object;
252 if (CONSP (object))
253 return Qnil;
254 return Qt;
257 DEFUN ("listp", Flistp, Slistp, 1, 1, 0,
258 doc: /* Return t if OBJECT is a list, that is, a cons cell or nil.
259 Otherwise, return nil. */)
260 (object)
261 Lisp_Object object;
263 if (CONSP (object) || NILP (object))
264 return Qt;
265 return Qnil;
268 DEFUN ("nlistp", Fnlistp, Snlistp, 1, 1, 0,
269 doc: /* Return t if OBJECT is not a list. Lists include nil. */)
270 (object)
271 Lisp_Object object;
273 if (CONSP (object) || NILP (object))
274 return Qnil;
275 return Qt;
278 DEFUN ("symbolp", Fsymbolp, Ssymbolp, 1, 1, 0,
279 doc: /* Return t if OBJECT is a symbol. */)
280 (object)
281 Lisp_Object object;
283 if (SYMBOLP (object))
284 return Qt;
285 return Qnil;
288 /* Define this in C to avoid unnecessarily consing up the symbol
289 name. */
290 DEFUN ("keywordp", Fkeywordp, Skeywordp, 1, 1, 0,
291 doc: /* Return t if OBJECT is a keyword.
292 This means that it is a symbol with a print name beginning with `:'
293 interned in the initial obarray. */)
294 (object)
295 Lisp_Object object;
297 if (SYMBOLP (object)
298 && SREF (SYMBOL_NAME (object), 0) == ':'
299 && SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P (object))
300 return Qt;
301 return Qnil;
304 DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
305 doc: /* Return t if OBJECT is a vector. */)
306 (object)
307 Lisp_Object object;
309 if (VECTORP (object))
310 return Qt;
311 return Qnil;
314 DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
315 doc: /* Return t if OBJECT is a string. */)
316 (object)
317 Lisp_Object object;
319 if (STRINGP (object))
320 return Qt;
321 return Qnil;
324 DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p,
325 1, 1, 0,
326 doc: /* Return t if OBJECT is a multibyte string. */)
327 (object)
328 Lisp_Object object;
330 if (STRINGP (object) && STRING_MULTIBYTE (object))
331 return Qt;
332 return Qnil;
335 DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0,
336 doc: /* Return t if OBJECT is a char-table. */)
337 (object)
338 Lisp_Object object;
340 if (CHAR_TABLE_P (object))
341 return Qt;
342 return Qnil;
345 DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p,
346 Svector_or_char_table_p, 1, 1, 0,
347 doc: /* Return t if OBJECT is a char-table or vector. */)
348 (object)
349 Lisp_Object object;
351 if (VECTORP (object) || CHAR_TABLE_P (object))
352 return Qt;
353 return Qnil;
356 DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0,
357 doc: /* Return t if OBJECT is a bool-vector. */)
358 (object)
359 Lisp_Object object;
361 if (BOOL_VECTOR_P (object))
362 return Qt;
363 return Qnil;
366 DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0,
367 doc: /* Return t if OBJECT is an array (string or vector). */)
368 (object)
369 Lisp_Object object;
371 if (ARRAYP (object))
372 return Qt;
373 return Qnil;
376 DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
377 doc: /* Return t if OBJECT is a sequence (list or array). */)
378 (object)
379 register Lisp_Object object;
381 if (CONSP (object) || NILP (object) || ARRAYP (object))
382 return Qt;
383 return Qnil;
386 DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0,
387 doc: /* Return t if OBJECT is an editor buffer. */)
388 (object)
389 Lisp_Object object;
391 if (BUFFERP (object))
392 return Qt;
393 return Qnil;
396 DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0,
397 doc: /* Return t if OBJECT is a marker (editor pointer). */)
398 (object)
399 Lisp_Object object;
401 if (MARKERP (object))
402 return Qt;
403 return Qnil;
406 DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0,
407 doc: /* Return t if OBJECT is a built-in function. */)
408 (object)
409 Lisp_Object object;
411 if (SUBRP (object))
412 return Qt;
413 return Qnil;
416 DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
417 1, 1, 0,
418 doc: /* Return t if OBJECT is a byte-compiled function object. */)
419 (object)
420 Lisp_Object object;
422 if (COMPILEDP (object))
423 return Qt;
424 return Qnil;
427 DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0,
428 doc: /* Return t if OBJECT is a character or a string. */)
429 (object)
430 register Lisp_Object object;
432 if (CHARACTERP (object) || STRINGP (object))
433 return Qt;
434 return Qnil;
437 DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0,
438 doc: /* Return t if OBJECT is an integer. */)
439 (object)
440 Lisp_Object object;
442 if (INTEGERP (object))
443 return Qt;
444 return Qnil;
447 DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0,
448 doc: /* Return t if OBJECT is an integer or a marker (editor pointer). */)
449 (object)
450 register Lisp_Object object;
452 if (MARKERP (object) || INTEGERP (object))
453 return Qt;
454 return Qnil;
457 DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
458 doc: /* Return t if OBJECT is a nonnegative integer. */)
459 (object)
460 Lisp_Object object;
462 if (NATNUMP (object))
463 return Qt;
464 return Qnil;
467 DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
468 doc: /* Return t if OBJECT is a number (floating point or integer). */)
469 (object)
470 Lisp_Object object;
472 if (NUMBERP (object))
473 return Qt;
474 else
475 return Qnil;
478 DEFUN ("number-or-marker-p", Fnumber_or_marker_p,
479 Snumber_or_marker_p, 1, 1, 0,
480 doc: /* Return t if OBJECT is a number or a marker. */)
481 (object)
482 Lisp_Object object;
484 if (NUMBERP (object) || MARKERP (object))
485 return Qt;
486 return Qnil;
489 DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
490 doc: /* Return t if OBJECT is a floating point number. */)
491 (object)
492 Lisp_Object object;
494 if (FLOATP (object))
495 return Qt;
496 return Qnil;
500 /* Extract and set components of lists */
502 DEFUN ("car", Fcar, Scar, 1, 1, 0,
503 doc: /* Return the car of LIST. If arg is nil, return nil.
504 Error if arg is not nil and not a cons cell. See also `car-safe'.
506 See Info node `(elisp)Cons Cells' for a discussion of related basic
507 Lisp concepts such as car, cdr, cons cell and list. */)
508 (list)
509 register Lisp_Object list;
511 return CAR (list);
514 DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0,
515 doc: /* Return the car of OBJECT if it is a cons cell, or else nil. */)
516 (object)
517 Lisp_Object object;
519 return CAR_SAFE (object);
522 DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
523 doc: /* Return the cdr of LIST. If arg is nil, return nil.
524 Error if arg is not nil and not a cons cell. See also `cdr-safe'.
526 See Info node `(elisp)Cons Cells' for a discussion of related basic
527 Lisp concepts such as cdr, car, cons cell and list. */)
528 (list)
529 register Lisp_Object list;
531 return CDR (list);
534 DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0,
535 doc: /* Return the cdr of OBJECT if it is a cons cell, or else nil. */)
536 (object)
537 Lisp_Object object;
539 return CDR_SAFE (object);
542 DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
543 doc: /* Set the car of CELL to be NEWCAR. Returns NEWCAR. */)
544 (cell, newcar)
545 register Lisp_Object cell, newcar;
547 CHECK_CONS (cell);
548 CHECK_IMPURE (cell);
549 XSETCAR (cell, newcar);
550 return newcar;
553 DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
554 doc: /* Set the cdr of CELL to be NEWCDR. Returns NEWCDR. */)
555 (cell, newcdr)
556 register Lisp_Object cell, newcdr;
558 CHECK_CONS (cell);
559 CHECK_IMPURE (cell);
560 XSETCDR (cell, newcdr);
561 return newcdr;
564 /* Extract and set components of symbols */
566 DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0,
567 doc: /* Return t if SYMBOL's value is not void. */)
568 (symbol)
569 register Lisp_Object symbol;
571 Lisp_Object valcontents;
572 CHECK_SYMBOL (symbol);
574 valcontents = SYMBOL_VALUE (symbol);
576 if (BUFFER_LOCAL_VALUEP (valcontents))
577 valcontents = swap_in_symval_forwarding (symbol, valcontents);
579 return (EQ (valcontents, Qunbound) ? Qnil : Qt);
582 DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0,
583 doc: /* Return t if SYMBOL's function definition is not void. */)
584 (symbol)
585 register Lisp_Object symbol;
587 CHECK_SYMBOL (symbol);
588 return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
591 DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0,
592 doc: /* Make SYMBOL's value be void.
593 Return SYMBOL. */)
594 (symbol)
595 register Lisp_Object symbol;
597 CHECK_SYMBOL (symbol);
598 if (SYMBOL_CONSTANT_P (symbol))
599 xsignal1 (Qsetting_constant, symbol);
600 Fset (symbol, Qunbound);
601 return symbol;
604 DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0,
605 doc: /* Make SYMBOL's function definition be void.
606 Return SYMBOL. */)
607 (symbol)
608 register Lisp_Object symbol;
610 CHECK_SYMBOL (symbol);
611 if (NILP (symbol) || EQ (symbol, Qt))
612 xsignal1 (Qsetting_constant, symbol);
613 XSYMBOL (symbol)->function = Qunbound;
614 return symbol;
617 DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0,
618 doc: /* Return SYMBOL's function definition. Error if that is void. */)
619 (symbol)
620 register Lisp_Object symbol;
622 CHECK_SYMBOL (symbol);
623 if (!EQ (XSYMBOL (symbol)->function, Qunbound))
624 return XSYMBOL (symbol)->function;
625 xsignal1 (Qvoid_function, symbol);
628 DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0,
629 doc: /* Return SYMBOL's property list. */)
630 (symbol)
631 register Lisp_Object symbol;
633 CHECK_SYMBOL (symbol);
634 return XSYMBOL (symbol)->plist;
637 DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0,
638 doc: /* Return SYMBOL's name, a string. */)
639 (symbol)
640 register Lisp_Object symbol;
642 register Lisp_Object name;
644 CHECK_SYMBOL (symbol);
645 name = SYMBOL_NAME (symbol);
646 return name;
649 DEFUN ("fset", Ffset, Sfset, 2, 2, 0,
650 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION. */)
651 (symbol, definition)
652 register Lisp_Object symbol, definition;
654 register Lisp_Object function;
656 CHECK_SYMBOL (symbol);
657 if (NILP (symbol) || EQ (symbol, Qt))
658 xsignal1 (Qsetting_constant, symbol);
660 function = XSYMBOL (symbol)->function;
662 if (!NILP (Vautoload_queue) && !EQ (function, Qunbound))
663 Vautoload_queue = Fcons (Fcons (symbol, function), Vautoload_queue);
665 if (CONSP (function) && EQ (XCAR (function), Qautoload))
666 Fput (symbol, Qautoload, XCDR (function));
668 XSYMBOL (symbol)->function = definition;
669 /* Handle automatic advice activation */
670 if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
672 call2 (Qad_activate_internal, symbol, Qnil);
673 definition = XSYMBOL (symbol)->function;
675 return definition;
678 extern Lisp_Object Qfunction_documentation;
680 DEFUN ("defalias", Fdefalias, Sdefalias, 2, 3, 0,
681 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION.
682 Associates the function with the current load file, if any.
683 The optional third argument DOCSTRING specifies the documentation string
684 for SYMBOL; if it is omitted or nil, SYMBOL uses the documentation string
685 determined by DEFINITION. */)
686 (symbol, definition, docstring)
687 register Lisp_Object symbol, definition, docstring;
689 CHECK_SYMBOL (symbol);
690 if (CONSP (XSYMBOL (symbol)->function)
691 && EQ (XCAR (XSYMBOL (symbol)->function), Qautoload))
692 LOADHIST_ATTACH (Fcons (Qt, symbol));
693 definition = Ffset (symbol, definition);
694 LOADHIST_ATTACH (Fcons (Qdefun, symbol));
695 if (!NILP (docstring))
696 Fput (symbol, Qfunction_documentation, docstring);
697 return definition;
700 DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
701 doc: /* Set SYMBOL's property list to NEWPLIST, and return NEWPLIST. */)
702 (symbol, newplist)
703 register Lisp_Object symbol, newplist;
705 CHECK_SYMBOL (symbol);
706 XSYMBOL (symbol)->plist = newplist;
707 return newplist;
710 DEFUN ("subr-arity", Fsubr_arity, Ssubr_arity, 1, 1, 0,
711 doc: /* Return minimum and maximum number of args allowed for SUBR.
712 SUBR must be a built-in function.
713 The returned value is a pair (MIN . MAX). MIN is the minimum number
714 of args. MAX is the maximum number or the symbol `many', for a
715 function with `&rest' args, or `unevalled' for a special form. */)
716 (subr)
717 Lisp_Object subr;
719 short minargs, maxargs;
720 CHECK_SUBR (subr);
721 minargs = XSUBR (subr)->min_args;
722 maxargs = XSUBR (subr)->max_args;
723 if (maxargs == MANY)
724 return Fcons (make_number (minargs), Qmany);
725 else if (maxargs == UNEVALLED)
726 return Fcons (make_number (minargs), Qunevalled);
727 else
728 return Fcons (make_number (minargs), make_number (maxargs));
731 DEFUN ("subr-name", Fsubr_name, Ssubr_name, 1, 1, 0,
732 doc: /* Return name of subroutine SUBR.
733 SUBR must be a built-in function. */)
734 (subr)
735 Lisp_Object subr;
737 const char *name;
738 CHECK_SUBR (subr);
739 name = XSUBR (subr)->symbol_name;
740 return make_string (name, strlen (name));
743 DEFUN ("interactive-form", Finteractive_form, Sinteractive_form, 1, 1, 0,
744 doc: /* Return the interactive form of CMD or nil if none.
745 If CMD is not a command, the return value is nil.
746 Value, if non-nil, is a list \(interactive SPEC). */)
747 (cmd)
748 Lisp_Object cmd;
750 Lisp_Object fun = indirect_function (cmd); /* Check cycles. */
752 if (NILP (fun) || EQ (fun, Qunbound))
753 return Qnil;
755 /* Use an `interactive-form' property if present, analogous to the
756 function-documentation property. */
757 fun = cmd;
758 while (SYMBOLP (fun))
760 Lisp_Object tmp = Fget (fun, intern ("interactive-form"));
761 if (!NILP (tmp))
762 return tmp;
763 else
764 fun = Fsymbol_function (fun);
767 if (SUBRP (fun))
769 char *spec = XSUBR (fun)->intspec;
770 if (spec)
771 return list2 (Qinteractive,
772 (*spec != '(') ? build_string (spec) :
773 Fcar (Fread_from_string (build_string (spec), Qnil, Qnil)));
775 else if (COMPILEDP (fun))
777 if ((ASIZE (fun) & PSEUDOVECTOR_SIZE_MASK) > COMPILED_INTERACTIVE)
778 return list2 (Qinteractive, AREF (fun, COMPILED_INTERACTIVE));
780 else if (CONSP (fun))
782 Lisp_Object funcar = XCAR (fun);
783 if (EQ (funcar, Qlambda))
784 return Fassq (Qinteractive, Fcdr (XCDR (fun)));
785 else if (EQ (funcar, Qautoload))
787 struct gcpro gcpro1;
788 GCPRO1 (cmd);
789 do_autoload (fun, cmd);
790 UNGCPRO;
791 return Finteractive_form (cmd);
794 return Qnil;
798 /***********************************************************************
799 Getting and Setting Values of Symbols
800 ***********************************************************************/
802 /* Return the symbol holding SYMBOL's value. Signal
803 `cyclic-variable-indirection' if SYMBOL's chain of variable
804 indirections contains a loop. */
806 struct Lisp_Symbol *
807 indirect_variable (symbol)
808 struct Lisp_Symbol *symbol;
810 struct Lisp_Symbol *tortoise, *hare;
812 hare = tortoise = symbol;
814 while (hare->indirect_variable)
816 hare = XSYMBOL (hare->value);
817 if (!hare->indirect_variable)
818 break;
820 hare = XSYMBOL (hare->value);
821 tortoise = XSYMBOL (tortoise->value);
823 if (hare == tortoise)
825 Lisp_Object tem;
826 XSETSYMBOL (tem, symbol);
827 xsignal1 (Qcyclic_variable_indirection, tem);
831 return hare;
835 DEFUN ("indirect-variable", Findirect_variable, Sindirect_variable, 1, 1, 0,
836 doc: /* Return the variable at the end of OBJECT's variable chain.
837 If OBJECT is a symbol, follow all variable indirections and return the final
838 variable. If OBJECT is not a symbol, just return it.
839 Signal a cyclic-variable-indirection error if there is a loop in the
840 variable chain of symbols. */)
841 (object)
842 Lisp_Object object;
844 if (SYMBOLP (object))
845 XSETSYMBOL (object, indirect_variable (XSYMBOL (object)));
846 return object;
850 /* Given the raw contents of a symbol value cell,
851 return the Lisp value of the symbol.
852 This does not handle buffer-local variables; use
853 swap_in_symval_forwarding for that. */
855 Lisp_Object
856 do_symval_forwarding (valcontents)
857 register Lisp_Object valcontents;
859 register Lisp_Object val;
860 if (MISCP (valcontents))
861 switch (XMISCTYPE (valcontents))
863 case Lisp_Misc_Intfwd:
864 XSETINT (val, *XINTFWD (valcontents)->intvar);
865 return val;
867 case Lisp_Misc_Boolfwd:
868 return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
870 case Lisp_Misc_Objfwd:
871 return *XOBJFWD (valcontents)->objvar;
873 case Lisp_Misc_Buffer_Objfwd:
874 return PER_BUFFER_VALUE (current_buffer,
875 XBUFFER_OBJFWD (valcontents)->offset);
877 case Lisp_Misc_Kboard_Objfwd:
878 /* We used to simply use current_kboard here, but from Lisp
879 code, it's value is often unexpected. It seems nicer to
880 allow constructions like this to work as intuitively expected:
882 (with-selected-frame frame
883 (define-key local-function-map "\eOP" [f1]))
885 On the other hand, this affects the semantics of
886 last-command and real-last-command, and people may rely on
887 that. I took a quick look at the Lisp codebase, and I
888 don't think anything will break. --lorentey */
889 return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
890 + (char *)FRAME_KBOARD (SELECTED_FRAME ()));
892 return valcontents;
895 /* Store NEWVAL into SYMBOL, where VALCONTENTS is found in the value cell
896 of SYMBOL. If SYMBOL is buffer-local, VALCONTENTS should be the
897 buffer-independent contents of the value cell: forwarded just one
898 step past the buffer-localness.
900 BUF non-zero means set the value in buffer BUF instead of the
901 current buffer. This only plays a role for per-buffer variables. */
903 void
904 store_symval_forwarding (symbol, valcontents, newval, buf)
905 Lisp_Object symbol;
906 register Lisp_Object valcontents, newval;
907 struct buffer *buf;
909 switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
911 case Lisp_Misc:
912 switch (XMISCTYPE (valcontents))
914 case Lisp_Misc_Intfwd:
915 CHECK_NUMBER (newval);
916 *XINTFWD (valcontents)->intvar = XINT (newval);
917 /* This can never happen since intvar points to an EMACS_INT
918 which is at least large enough to hold a Lisp_Object.
919 if (*XINTFWD (valcontents)->intvar != XINT (newval))
920 error ("Value out of range for variable `%s'",
921 SDATA (SYMBOL_NAME (symbol))); */
922 break;
924 case Lisp_Misc_Boolfwd:
925 *XBOOLFWD (valcontents)->boolvar = !NILP (newval);
926 break;
928 case Lisp_Misc_Objfwd:
929 *XOBJFWD (valcontents)->objvar = newval;
931 /* If this variable is a default for something stored
932 in the buffer itself, such as default-fill-column,
933 find the buffers that don't have local values for it
934 and update them. */
935 if (XOBJFWD (valcontents)->objvar > (Lisp_Object *) &buffer_defaults
936 && XOBJFWD (valcontents)->objvar < (Lisp_Object *) (&buffer_defaults + 1))
938 int offset = ((char *) XOBJFWD (valcontents)->objvar
939 - (char *) &buffer_defaults);
940 int idx = PER_BUFFER_IDX (offset);
942 Lisp_Object tail;
944 if (idx <= 0)
945 break;
947 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
949 Lisp_Object buf;
950 struct buffer *b;
952 buf = Fcdr (XCAR (tail));
953 if (!BUFFERP (buf)) continue;
954 b = XBUFFER (buf);
956 if (! PER_BUFFER_VALUE_P (b, idx))
957 PER_BUFFER_VALUE (b, offset) = newval;
960 break;
962 case Lisp_Misc_Buffer_Objfwd:
964 int offset = XBUFFER_OBJFWD (valcontents)->offset;
965 Lisp_Object type = XBUFFER_OBJFWD (valcontents)->slottype;
967 if (! NILP (type) && ! NILP (newval)
968 && XTYPE (newval) != XINT (type))
969 buffer_slot_type_mismatch (newval, XINT (type));
971 if (buf == NULL)
972 buf = current_buffer;
973 PER_BUFFER_VALUE (buf, offset) = newval;
975 break;
977 case Lisp_Misc_Kboard_Objfwd:
979 char *base = (char *) FRAME_KBOARD (SELECTED_FRAME ());
980 char *p = base + XKBOARD_OBJFWD (valcontents)->offset;
981 *(Lisp_Object *) p = newval;
983 break;
985 default:
986 goto def;
988 break;
990 default:
991 def:
992 valcontents = SYMBOL_VALUE (symbol);
993 if (BUFFER_LOCAL_VALUEP (valcontents))
994 XBUFFER_LOCAL_VALUE (valcontents)->realvalue = newval;
995 else
996 SET_SYMBOL_VALUE (symbol, newval);
1000 /* Set up SYMBOL to refer to its global binding.
1001 This makes it safe to alter the status of other bindings. */
1003 void
1004 swap_in_global_binding (symbol)
1005 Lisp_Object symbol;
1007 Lisp_Object valcontents = SYMBOL_VALUE (symbol);
1008 struct Lisp_Buffer_Local_Value *blv = XBUFFER_LOCAL_VALUE (valcontents);
1009 Lisp_Object cdr = blv->cdr;
1011 /* Unload the previously loaded binding. */
1012 Fsetcdr (XCAR (cdr),
1013 do_symval_forwarding (blv->realvalue));
1015 /* Select the global binding in the symbol. */
1016 XSETCAR (cdr, cdr);
1017 store_symval_forwarding (symbol, blv->realvalue, XCDR (cdr), NULL);
1019 /* Indicate that the global binding is set up now. */
1020 blv->frame = Qnil;
1021 blv->buffer = Qnil;
1022 blv->found_for_frame = 0;
1023 blv->found_for_buffer = 0;
1026 /* Set up the buffer-local symbol SYMBOL for validity in the current buffer.
1027 VALCONTENTS is the contents of its value cell,
1028 which points to a struct Lisp_Buffer_Local_Value.
1030 Return the value forwarded one step past the buffer-local stage.
1031 This could be another forwarding pointer. */
1033 static Lisp_Object
1034 swap_in_symval_forwarding (symbol, valcontents)
1035 Lisp_Object symbol, valcontents;
1037 register Lisp_Object tem1;
1039 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1041 if (NILP (tem1)
1042 || current_buffer != XBUFFER (tem1)
1043 || (XBUFFER_LOCAL_VALUE (valcontents)->check_frame
1044 && ! EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame)))
1046 struct Lisp_Symbol *sym = XSYMBOL (symbol);
1047 if (sym->indirect_variable)
1049 sym = indirect_variable (sym);
1050 XSETSYMBOL (symbol, sym);
1053 /* Unload the previously loaded binding. */
1054 tem1 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1055 Fsetcdr (tem1,
1056 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
1057 /* Choose the new binding. */
1058 tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
1059 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
1060 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1061 if (NILP (tem1))
1063 if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
1064 tem1 = assq_no_quit (symbol, XFRAME (selected_frame)->param_alist);
1065 if (! NILP (tem1))
1066 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 1;
1067 else
1068 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
1070 else
1071 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 1;
1073 /* Load the new binding. */
1074 XSETCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr, tem1);
1075 XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, current_buffer);
1076 XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
1077 store_symval_forwarding (symbol,
1078 XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1079 Fcdr (tem1), NULL);
1081 return XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
1084 /* Find the value of a symbol, returning Qunbound if it's not bound.
1085 This is helpful for code which just wants to get a variable's value
1086 if it has one, without signaling an error.
1087 Note that it must not be possible to quit
1088 within this function. Great care is required for this. */
1090 Lisp_Object
1091 find_symbol_value (symbol)
1092 Lisp_Object symbol;
1094 register Lisp_Object valcontents;
1095 register Lisp_Object val;
1097 CHECK_SYMBOL (symbol);
1098 valcontents = SYMBOL_VALUE (symbol);
1100 if (BUFFER_LOCAL_VALUEP (valcontents))
1101 valcontents = swap_in_symval_forwarding (symbol, valcontents);
1103 return do_symval_forwarding (valcontents);
1106 DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
1107 doc: /* Return SYMBOL's value. Error if that is void. */)
1108 (symbol)
1109 Lisp_Object symbol;
1111 Lisp_Object val;
1113 val = find_symbol_value (symbol);
1114 if (!EQ (val, Qunbound))
1115 return val;
1117 xsignal1 (Qvoid_variable, symbol);
1120 DEFUN ("set", Fset, Sset, 2, 2, 0,
1121 doc: /* Set SYMBOL's value to NEWVAL, and return NEWVAL. */)
1122 (symbol, newval)
1123 register Lisp_Object symbol, newval;
1125 return set_internal (symbol, newval, current_buffer, 0);
1128 /* Return 1 if SYMBOL currently has a let-binding
1129 which was made in the buffer that is now current. */
1131 static int
1132 let_shadows_buffer_binding_p (symbol)
1133 struct Lisp_Symbol *symbol;
1135 volatile struct specbinding *p;
1137 for (p = specpdl_ptr - 1; p >= specpdl; p--)
1138 if (p->func == NULL
1139 && CONSP (p->symbol))
1141 struct Lisp_Symbol *let_bound_symbol = XSYMBOL (XCAR (p->symbol));
1142 if ((symbol == let_bound_symbol
1143 || (let_bound_symbol->indirect_variable
1144 && symbol == indirect_variable (let_bound_symbol)))
1145 && XBUFFER (XCDR (XCDR (p->symbol))) == current_buffer)
1146 break;
1149 return p >= specpdl;
1152 /* Store the value NEWVAL into SYMBOL.
1153 If buffer-locality is an issue, BUF specifies which buffer to use.
1154 (0 stands for the current buffer.)
1156 If BINDFLAG is zero, then if this symbol is supposed to become
1157 local in every buffer where it is set, then we make it local.
1158 If BINDFLAG is nonzero, we don't do that. */
1160 Lisp_Object
1161 set_internal (symbol, newval, buf, bindflag)
1162 register Lisp_Object symbol, newval;
1163 struct buffer *buf;
1164 int bindflag;
1166 int voide = EQ (newval, Qunbound);
1168 register Lisp_Object valcontents, innercontents, tem1, current_alist_element;
1170 if (buf == 0)
1171 buf = current_buffer;
1173 /* If restoring in a dead buffer, do nothing. */
1174 if (NILP (buf->name))
1175 return newval;
1177 CHECK_SYMBOL (symbol);
1178 if (SYMBOL_CONSTANT_P (symbol)
1179 && (NILP (Fkeywordp (symbol))
1180 || !EQ (newval, SYMBOL_VALUE (symbol))))
1181 xsignal1 (Qsetting_constant, symbol);
1183 innercontents = valcontents = SYMBOL_VALUE (symbol);
1185 if (BUFFER_OBJFWDP (valcontents))
1187 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1188 int idx = PER_BUFFER_IDX (offset);
1189 if (idx > 0
1190 && !bindflag
1191 && !let_shadows_buffer_binding_p (XSYMBOL (symbol)))
1192 SET_PER_BUFFER_VALUE_P (buf, idx, 1);
1194 else if (BUFFER_LOCAL_VALUEP (valcontents))
1196 /* valcontents is a struct Lisp_Buffer_Local_Value. */
1197 if (XSYMBOL (symbol)->indirect_variable)
1198 XSETSYMBOL (symbol, indirect_variable (XSYMBOL (symbol)));
1200 /* What binding is loaded right now? */
1201 current_alist_element
1202 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1204 /* If the current buffer is not the buffer whose binding is
1205 loaded, or if there may be frame-local bindings and the frame
1206 isn't the right one, or if it's a Lisp_Buffer_Local_Value and
1207 the default binding is loaded, the loaded binding may be the
1208 wrong one. */
1209 if (!BUFFERP (XBUFFER_LOCAL_VALUE (valcontents)->buffer)
1210 || buf != XBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer)
1211 || (XBUFFER_LOCAL_VALUE (valcontents)->check_frame
1212 && !EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame))
1213 /* Also unload a global binding (if the var is local_if_set). */
1214 || (EQ (XCAR (current_alist_element),
1215 current_alist_element)))
1217 /* The currently loaded binding is not necessarily valid.
1218 We need to unload it, and choose a new binding. */
1220 /* Write out `realvalue' to the old loaded binding. */
1221 Fsetcdr (current_alist_element,
1222 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
1224 /* Find the new binding. */
1225 tem1 = Fassq (symbol, buf->local_var_alist);
1226 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 1;
1227 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
1229 if (NILP (tem1))
1231 /* This buffer still sees the default value. */
1233 /* If the variable is not local_if_set,
1234 or if this is `let' rather than `set',
1235 make CURRENT-ALIST-ELEMENT point to itself,
1236 indicating that we're seeing the default value.
1237 Likewise if the variable has been let-bound
1238 in the current buffer. */
1239 if (bindflag || !XBUFFER_LOCAL_VALUE (valcontents)->local_if_set
1240 || let_shadows_buffer_binding_p (XSYMBOL (symbol)))
1242 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1244 if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
1245 tem1 = Fassq (symbol,
1246 XFRAME (selected_frame)->param_alist);
1248 if (! NILP (tem1))
1249 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 1;
1250 else
1251 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
1253 /* If it's a Lisp_Buffer_Local_Value, being set not bound,
1254 and we're not within a let that was made for this buffer,
1255 create a new buffer-local binding for the variable.
1256 That means, give this buffer a new assoc for a local value
1257 and load that binding. */
1258 else
1260 tem1 = Fcons (symbol, XCDR (current_alist_element));
1261 buf->local_var_alist
1262 = Fcons (tem1, buf->local_var_alist);
1266 /* Record which binding is now loaded. */
1267 XSETCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr, tem1);
1269 /* Set `buffer' and `frame' slots for the binding now loaded. */
1270 XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, buf);
1271 XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
1273 innercontents = XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
1275 /* Store the new value in the cons-cell. */
1276 XSETCDR (XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr), newval);
1279 /* If storing void (making the symbol void), forward only through
1280 buffer-local indicator, not through Lisp_Objfwd, etc. */
1281 if (voide)
1282 store_symval_forwarding (symbol, Qnil, newval, buf);
1283 else
1284 store_symval_forwarding (symbol, innercontents, newval, buf);
1286 return newval;
1289 /* Access or set a buffer-local symbol's default value. */
1291 /* Return the default value of SYMBOL, but don't check for voidness.
1292 Return Qunbound if it is void. */
1294 Lisp_Object
1295 default_value (symbol)
1296 Lisp_Object symbol;
1298 register Lisp_Object valcontents;
1300 CHECK_SYMBOL (symbol);
1301 valcontents = SYMBOL_VALUE (symbol);
1303 /* For a built-in buffer-local variable, get the default value
1304 rather than letting do_symval_forwarding get the current value. */
1305 if (BUFFER_OBJFWDP (valcontents))
1307 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1308 if (PER_BUFFER_IDX (offset) != 0)
1309 return PER_BUFFER_DEFAULT (offset);
1312 /* Handle user-created local variables. */
1313 if (BUFFER_LOCAL_VALUEP (valcontents))
1315 /* If var is set up for a buffer that lacks a local value for it,
1316 the current value is nominally the default value.
1317 But the `realvalue' slot may be more up to date, since
1318 ordinary setq stores just that slot. So use that. */
1319 Lisp_Object current_alist_element, alist_element_car;
1320 current_alist_element
1321 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1322 alist_element_car = XCAR (current_alist_element);
1323 if (EQ (alist_element_car, current_alist_element))
1324 return do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue);
1325 else
1326 return XCDR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1328 /* For other variables, get the current value. */
1329 return do_symval_forwarding (valcontents);
1332 DEFUN ("default-boundp", Fdefault_boundp, Sdefault_boundp, 1, 1, 0,
1333 doc: /* Return t if SYMBOL has a non-void default value.
1334 This is the value that is seen in buffers that do not have their own values
1335 for this variable. */)
1336 (symbol)
1337 Lisp_Object symbol;
1339 register Lisp_Object value;
1341 value = default_value (symbol);
1342 return (EQ (value, Qunbound) ? Qnil : Qt);
1345 DEFUN ("default-value", Fdefault_value, Sdefault_value, 1, 1, 0,
1346 doc: /* Return SYMBOL's default value.
1347 This is the value that is seen in buffers that do not have their own values
1348 for this variable. The default value is meaningful for variables with
1349 local bindings in certain buffers. */)
1350 (symbol)
1351 Lisp_Object symbol;
1353 register Lisp_Object value;
1355 value = default_value (symbol);
1356 if (!EQ (value, Qunbound))
1357 return value;
1359 xsignal1 (Qvoid_variable, symbol);
1362 DEFUN ("set-default", Fset_default, Sset_default, 2, 2, 0,
1363 doc: /* Set SYMBOL's default value to VALUE. SYMBOL and VALUE are evaluated.
1364 The default value is seen in buffers that do not have their own values
1365 for this variable. */)
1366 (symbol, value)
1367 Lisp_Object symbol, value;
1369 register Lisp_Object valcontents, current_alist_element, alist_element_buffer;
1371 CHECK_SYMBOL (symbol);
1372 valcontents = SYMBOL_VALUE (symbol);
1374 /* Handle variables like case-fold-search that have special slots
1375 in the buffer. Make them work apparently like Lisp_Buffer_Local_Value
1376 variables. */
1377 if (BUFFER_OBJFWDP (valcontents))
1379 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1380 int idx = PER_BUFFER_IDX (offset);
1382 PER_BUFFER_DEFAULT (offset) = value;
1384 /* If this variable is not always local in all buffers,
1385 set it in the buffers that don't nominally have a local value. */
1386 if (idx > 0)
1388 struct buffer *b;
1390 for (b = all_buffers; b; b = b->next)
1391 if (!PER_BUFFER_VALUE_P (b, idx))
1392 PER_BUFFER_VALUE (b, offset) = value;
1394 return value;
1397 if (!BUFFER_LOCAL_VALUEP (valcontents))
1398 return Fset (symbol, value);
1400 /* Store new value into the DEFAULT-VALUE slot. */
1401 XSETCDR (XBUFFER_LOCAL_VALUE (valcontents)->cdr, value);
1403 /* If the default binding is now loaded, set the REALVALUE slot too. */
1404 current_alist_element
1405 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1406 alist_element_buffer = Fcar (current_alist_element);
1407 if (EQ (alist_element_buffer, current_alist_element))
1408 store_symval_forwarding (symbol,
1409 XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1410 value, NULL);
1412 return value;
1415 DEFUN ("setq-default", Fsetq_default, Ssetq_default, 0, UNEVALLED, 0,
1416 doc: /* Set the default value of variable VAR to VALUE.
1417 VAR, the variable name, is literal (not evaluated);
1418 VALUE is an expression: it is evaluated and its value returned.
1419 The default value of a variable is seen in buffers
1420 that do not have their own values for the variable.
1422 More generally, you can use multiple variables and values, as in
1423 (setq-default VAR VALUE VAR VALUE...)
1424 This sets each VAR's default value to the corresponding VALUE.
1425 The VALUE for the Nth VAR can refer to the new default values
1426 of previous VARs.
1427 usage: (setq-default [VAR VALUE]...) */)
1428 (args)
1429 Lisp_Object args;
1431 register Lisp_Object args_left;
1432 register Lisp_Object val, symbol;
1433 struct gcpro gcpro1;
1435 if (NILP (args))
1436 return Qnil;
1438 args_left = args;
1439 GCPRO1 (args);
1443 val = Feval (Fcar (Fcdr (args_left)));
1444 symbol = XCAR (args_left);
1445 Fset_default (symbol, val);
1446 args_left = Fcdr (XCDR (args_left));
1448 while (!NILP (args_left));
1450 UNGCPRO;
1451 return val;
1454 /* Lisp functions for creating and removing buffer-local variables. */
1456 DEFUN ("make-variable-buffer-local", Fmake_variable_buffer_local, Smake_variable_buffer_local,
1457 1, 1, "vMake Variable Buffer Local: ",
1458 doc: /* Make VARIABLE become buffer-local whenever it is set.
1459 At any time, the value for the current buffer is in effect,
1460 unless the variable has never been set in this buffer,
1461 in which case the default value is in effect.
1462 Note that binding the variable with `let', or setting it while
1463 a `let'-style binding made in this buffer is in effect,
1464 does not make the variable buffer-local. Return VARIABLE.
1466 In most cases it is better to use `make-local-variable',
1467 which makes a variable local in just one buffer.
1469 The function `default-value' gets the default value and `set-default' sets it. */)
1470 (variable)
1471 register Lisp_Object variable;
1473 register Lisp_Object tem, valcontents, newval;
1474 struct Lisp_Symbol *sym;
1476 CHECK_SYMBOL (variable);
1477 sym = indirect_variable (XSYMBOL (variable));
1479 valcontents = sym->value;
1480 if (sym->constant || KBOARD_OBJFWDP (valcontents))
1481 error ("Symbol %s may not be buffer-local", SDATA (sym->xname));
1483 if (BUFFER_OBJFWDP (valcontents))
1484 return variable;
1485 else if (BUFFER_LOCAL_VALUEP (valcontents))
1487 if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
1488 error ("Symbol %s may not be buffer-local", SDATA (sym->xname));
1489 newval = valcontents;
1491 else
1493 if (EQ (valcontents, Qunbound))
1494 sym->value = Qnil;
1495 tem = Fcons (Qnil, Fsymbol_value (variable));
1496 XSETCAR (tem, tem);
1497 newval = allocate_misc ();
1498 XMISCTYPE (newval) = Lisp_Misc_Buffer_Local_Value;
1499 XBUFFER_LOCAL_VALUE (newval)->realvalue = sym->value;
1500 XBUFFER_LOCAL_VALUE (newval)->buffer = Fcurrent_buffer ();
1501 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1502 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1503 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1504 XBUFFER_LOCAL_VALUE (newval)->check_frame = 0;
1505 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1506 sym->value = newval;
1508 XBUFFER_LOCAL_VALUE (newval)->local_if_set = 1;
1509 return variable;
1512 DEFUN ("make-local-variable", Fmake_local_variable, Smake_local_variable,
1513 1, 1, "vMake Local Variable: ",
1514 doc: /* Make VARIABLE have a separate value in the current buffer.
1515 Other buffers will continue to share a common default value.
1516 \(The buffer-local value of VARIABLE starts out as the same value
1517 VARIABLE previously had. If VARIABLE was void, it remains void.\)
1518 Return VARIABLE.
1520 If the variable is already arranged to become local when set,
1521 this function causes a local value to exist for this buffer,
1522 just as setting the variable would do.
1524 This function returns VARIABLE, and therefore
1525 (set (make-local-variable 'VARIABLE) VALUE-EXP)
1526 works.
1528 See also `make-variable-buffer-local'.
1530 Do not use `make-local-variable' to make a hook variable buffer-local.
1531 Instead, use `add-hook' and specify t for the LOCAL argument. */)
1532 (variable)
1533 register Lisp_Object variable;
1535 register Lisp_Object tem, valcontents;
1536 struct Lisp_Symbol *sym;
1538 CHECK_SYMBOL (variable);
1539 sym = indirect_variable (XSYMBOL (variable));
1541 valcontents = sym->value;
1542 if (sym->constant || KBOARD_OBJFWDP (valcontents)
1543 || (BUFFER_LOCAL_VALUEP (valcontents)
1544 && (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)))
1545 error ("Symbol %s may not be buffer-local", SDATA (sym->xname));
1547 if ((BUFFER_LOCAL_VALUEP (valcontents)
1548 && XBUFFER_LOCAL_VALUE (valcontents)->local_if_set)
1549 || BUFFER_OBJFWDP (valcontents))
1551 tem = Fboundp (variable);
1553 /* Make sure the symbol has a local value in this particular buffer,
1554 by setting it to the same value it already has. */
1555 Fset (variable, (EQ (tem, Qt) ? Fsymbol_value (variable) : Qunbound));
1556 return variable;
1558 /* Make sure symbol is set up to hold per-buffer values. */
1559 if (!BUFFER_LOCAL_VALUEP (valcontents))
1561 Lisp_Object newval;
1562 tem = Fcons (Qnil, do_symval_forwarding (valcontents));
1563 XSETCAR (tem, tem);
1564 newval = allocate_misc ();
1565 XMISCTYPE (newval) = Lisp_Misc_Buffer_Local_Value;
1566 XBUFFER_LOCAL_VALUE (newval)->realvalue = sym->value;
1567 XBUFFER_LOCAL_VALUE (newval)->buffer = Qnil;
1568 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1569 XBUFFER_LOCAL_VALUE (newval)->local_if_set = 0;
1570 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1571 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1572 XBUFFER_LOCAL_VALUE (newval)->check_frame = 0;
1573 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1574 sym->value = newval;
1576 /* Make sure this buffer has its own value of symbol. */
1577 XSETSYMBOL (variable, sym); /* Propagate variable indirections. */
1578 tem = Fassq (variable, current_buffer->local_var_alist);
1579 if (NILP (tem))
1581 /* Swap out any local binding for some other buffer, and make
1582 sure the current value is permanently recorded, if it's the
1583 default value. */
1584 find_symbol_value (variable);
1586 current_buffer->local_var_alist
1587 = Fcons (Fcons (variable, XCDR (XBUFFER_LOCAL_VALUE (sym->value)->cdr)),
1588 current_buffer->local_var_alist);
1590 /* Make sure symbol does not think it is set up for this buffer;
1591 force it to look once again for this buffer's value. */
1593 Lisp_Object *pvalbuf;
1595 valcontents = sym->value;
1597 pvalbuf = &XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1598 if (current_buffer == XBUFFER (*pvalbuf))
1599 *pvalbuf = Qnil;
1600 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1604 /* If the symbol forwards into a C variable, then load the binding
1605 for this buffer now. If C code modifies the variable before we
1606 load the binding in, then that new value will clobber the default
1607 binding the next time we unload it. */
1608 valcontents = XBUFFER_LOCAL_VALUE (sym->value)->realvalue;
1609 if (INTFWDP (valcontents) || BOOLFWDP (valcontents) || OBJFWDP (valcontents))
1610 swap_in_symval_forwarding (variable, sym->value);
1612 return variable;
1615 DEFUN ("kill-local-variable", Fkill_local_variable, Skill_local_variable,
1616 1, 1, "vKill Local Variable: ",
1617 doc: /* Make VARIABLE no longer have a separate value in the current buffer.
1618 From now on the default value will apply in this buffer. Return VARIABLE. */)
1619 (variable)
1620 register Lisp_Object variable;
1622 register Lisp_Object tem, valcontents;
1623 struct Lisp_Symbol *sym;
1625 CHECK_SYMBOL (variable);
1626 sym = indirect_variable (XSYMBOL (variable));
1628 valcontents = sym->value;
1630 if (BUFFER_OBJFWDP (valcontents))
1632 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1633 int idx = PER_BUFFER_IDX (offset);
1635 if (idx > 0)
1637 SET_PER_BUFFER_VALUE_P (current_buffer, idx, 0);
1638 PER_BUFFER_VALUE (current_buffer, offset)
1639 = PER_BUFFER_DEFAULT (offset);
1641 return variable;
1644 if (!BUFFER_LOCAL_VALUEP (valcontents))
1645 return variable;
1647 /* Get rid of this buffer's alist element, if any. */
1648 XSETSYMBOL (variable, sym); /* Propagate variable indirection. */
1649 tem = Fassq (variable, current_buffer->local_var_alist);
1650 if (!NILP (tem))
1651 current_buffer->local_var_alist
1652 = Fdelq (tem, current_buffer->local_var_alist);
1654 /* If the symbol is set up with the current buffer's binding
1655 loaded, recompute its value. We have to do it now, or else
1656 forwarded objects won't work right. */
1658 Lisp_Object *pvalbuf, buf;
1659 valcontents = sym->value;
1660 pvalbuf = &XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1661 XSETBUFFER (buf, current_buffer);
1662 if (EQ (buf, *pvalbuf))
1664 *pvalbuf = Qnil;
1665 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1666 find_symbol_value (variable);
1670 return variable;
1673 /* Lisp functions for creating and removing buffer-local variables. */
1675 DEFUN ("make-variable-frame-local", Fmake_variable_frame_local, Smake_variable_frame_local,
1676 1, 1, "vMake Variable Frame Local: ",
1677 doc: /* Enable VARIABLE to have frame-local bindings.
1678 This does not create any frame-local bindings for VARIABLE,
1679 it just makes them possible.
1681 A frame-local binding is actually a frame parameter value.
1682 If a frame F has a value for the frame parameter named VARIABLE,
1683 that also acts as a frame-local binding for VARIABLE in F--
1684 provided this function has been called to enable VARIABLE
1685 to have frame-local bindings at all.
1687 The only way to create a frame-local binding for VARIABLE in a frame
1688 is to set the VARIABLE frame parameter of that frame. See
1689 `modify-frame-parameters' for how to set frame parameters.
1691 Buffer-local bindings take precedence over frame-local bindings. */)
1692 (variable)
1693 register Lisp_Object variable;
1695 register Lisp_Object tem, valcontents, newval;
1696 struct Lisp_Symbol *sym;
1698 CHECK_SYMBOL (variable);
1699 sym = indirect_variable (XSYMBOL (variable));
1701 valcontents = sym->value;
1702 if (sym->constant || KBOARD_OBJFWDP (valcontents)
1703 || BUFFER_OBJFWDP (valcontents))
1704 error ("Symbol %s may not be frame-local", SDATA (sym->xname));
1706 if (BUFFER_LOCAL_VALUEP (valcontents))
1708 if (!XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
1709 error ("Symbol %s may not be frame-local", SDATA (sym->xname));
1710 return variable;
1713 if (EQ (valcontents, Qunbound))
1714 sym->value = Qnil;
1715 tem = Fcons (Qnil, Fsymbol_value (variable));
1716 XSETCAR (tem, tem);
1717 newval = allocate_misc ();
1718 XMISCTYPE (newval) = Lisp_Misc_Buffer_Local_Value;
1719 XBUFFER_LOCAL_VALUE (newval)->realvalue = sym->value;
1720 XBUFFER_LOCAL_VALUE (newval)->buffer = Qnil;
1721 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1722 XBUFFER_LOCAL_VALUE (newval)->local_if_set = 0;
1723 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1724 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1725 XBUFFER_LOCAL_VALUE (newval)->check_frame = 1;
1726 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1727 sym->value = newval;
1728 return variable;
1731 DEFUN ("local-variable-p", Flocal_variable_p, Slocal_variable_p,
1732 1, 2, 0,
1733 doc: /* Non-nil if VARIABLE has a local binding in buffer BUFFER.
1734 BUFFER defaults to the current buffer. */)
1735 (variable, buffer)
1736 register Lisp_Object variable, buffer;
1738 Lisp_Object valcontents;
1739 register struct buffer *buf;
1740 struct Lisp_Symbol *sym;
1742 if (NILP (buffer))
1743 buf = current_buffer;
1744 else
1746 CHECK_BUFFER (buffer);
1747 buf = XBUFFER (buffer);
1750 CHECK_SYMBOL (variable);
1751 sym = indirect_variable (XSYMBOL (variable));
1752 XSETSYMBOL (variable, sym);
1754 valcontents = sym->value;
1755 if (BUFFER_LOCAL_VALUEP (valcontents))
1757 Lisp_Object tail, elt;
1759 for (tail = buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1761 elt = XCAR (tail);
1762 if (EQ (variable, XCAR (elt)))
1763 return Qt;
1766 if (BUFFER_OBJFWDP (valcontents))
1768 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1769 int idx = PER_BUFFER_IDX (offset);
1770 if (idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
1771 return Qt;
1773 return Qnil;
1776 DEFUN ("local-variable-if-set-p", Flocal_variable_if_set_p, Slocal_variable_if_set_p,
1777 1, 2, 0,
1778 doc: /* Non-nil if VARIABLE will be local in buffer BUFFER when set there.
1779 More precisely, this means that setting the variable \(with `set' or`setq'),
1780 while it does not have a `let'-style binding that was made in BUFFER,
1781 will produce a buffer local binding. See Info node
1782 `(elisp)Creating Buffer-Local'.
1783 BUFFER defaults to the current buffer. */)
1784 (variable, buffer)
1785 register Lisp_Object variable, buffer;
1787 Lisp_Object valcontents;
1788 register struct buffer *buf;
1789 struct Lisp_Symbol *sym;
1791 if (NILP (buffer))
1792 buf = current_buffer;
1793 else
1795 CHECK_BUFFER (buffer);
1796 buf = XBUFFER (buffer);
1799 CHECK_SYMBOL (variable);
1800 sym = indirect_variable (XSYMBOL (variable));
1801 XSETSYMBOL (variable, sym);
1803 valcontents = sym->value;
1805 if (BUFFER_OBJFWDP (valcontents))
1806 /* All these slots become local if they are set. */
1807 return Qt;
1808 else if (BUFFER_LOCAL_VALUEP (valcontents))
1810 Lisp_Object tail, elt;
1811 if (XBUFFER_LOCAL_VALUE (valcontents)->local_if_set)
1812 return Qt;
1813 for (tail = buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1815 elt = XCAR (tail);
1816 if (EQ (variable, XCAR (elt)))
1817 return Qt;
1820 return Qnil;
1823 DEFUN ("variable-binding-locus", Fvariable_binding_locus, Svariable_binding_locus,
1824 1, 1, 0,
1825 doc: /* Return a value indicating where VARIABLE's current binding comes from.
1826 If the current binding is buffer-local, the value is the current buffer.
1827 If the current binding is frame-local, the value is the selected frame.
1828 If the current binding is global (the default), the value is nil. */)
1829 (variable)
1830 register Lisp_Object variable;
1832 Lisp_Object valcontents;
1833 struct Lisp_Symbol *sym;
1835 CHECK_SYMBOL (variable);
1836 sym = indirect_variable (XSYMBOL (variable));
1838 /* Make sure the current binding is actually swapped in. */
1839 find_symbol_value (variable);
1841 valcontents = sym->value;
1843 if (BUFFER_LOCAL_VALUEP (valcontents)
1844 || BUFFER_OBJFWDP (valcontents))
1846 /* For a local variable, record both the symbol and which
1847 buffer's or frame's value we are saving. */
1848 if (!NILP (Flocal_variable_p (variable, Qnil)))
1849 return Fcurrent_buffer ();
1850 else if (BUFFER_LOCAL_VALUEP (valcontents)
1851 && XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame)
1852 return XBUFFER_LOCAL_VALUE (valcontents)->frame;
1855 return Qnil;
1858 /* This code is disabled now that we use the selected frame to return
1859 keyboard-local-values. */
1860 #if 0
1861 extern struct terminal *get_terminal P_ ((Lisp_Object display, int));
1863 DEFUN ("terminal-local-value", Fterminal_local_value, Sterminal_local_value, 2, 2, 0,
1864 doc: /* Return the terminal-local value of SYMBOL on TERMINAL.
1865 If SYMBOL is not a terminal-local variable, then return its normal
1866 value, like `symbol-value'.
1868 TERMINAL may be a terminal id, a frame, or nil (meaning the
1869 selected frame's terminal device). */)
1870 (symbol, terminal)
1871 Lisp_Object symbol;
1872 Lisp_Object terminal;
1874 Lisp_Object result;
1875 struct terminal *t = get_terminal (terminal, 1);
1876 push_kboard (t->kboard);
1877 result = Fsymbol_value (symbol);
1878 pop_kboard ();
1879 return result;
1882 DEFUN ("set-terminal-local-value", Fset_terminal_local_value, Sset_terminal_local_value, 3, 3, 0,
1883 doc: /* Set the terminal-local binding of SYMBOL on TERMINAL to VALUE.
1884 If VARIABLE is not a terminal-local variable, then set its normal
1885 binding, like `set'.
1887 TERMINAL may be a terminal id, a frame, or nil (meaning the
1888 selected frame's terminal device). */)
1889 (symbol, terminal, value)
1890 Lisp_Object symbol;
1891 Lisp_Object terminal;
1892 Lisp_Object value;
1894 Lisp_Object result;
1895 struct terminal *t = get_terminal (terminal, 1);
1896 push_kboard (d->kboard);
1897 result = Fset (symbol, value);
1898 pop_kboard ();
1899 return result;
1901 #endif
1903 /* Find the function at the end of a chain of symbol function indirections. */
1905 /* If OBJECT is a symbol, find the end of its function chain and
1906 return the value found there. If OBJECT is not a symbol, just
1907 return it. If there is a cycle in the function chain, signal a
1908 cyclic-function-indirection error.
1910 This is like Findirect_function, except that it doesn't signal an
1911 error if the chain ends up unbound. */
1912 Lisp_Object
1913 indirect_function (object)
1914 register Lisp_Object object;
1916 Lisp_Object tortoise, hare;
1918 hare = tortoise = object;
1920 for (;;)
1922 if (!SYMBOLP (hare) || EQ (hare, Qunbound))
1923 break;
1924 hare = XSYMBOL (hare)->function;
1925 if (!SYMBOLP (hare) || EQ (hare, Qunbound))
1926 break;
1927 hare = XSYMBOL (hare)->function;
1929 tortoise = XSYMBOL (tortoise)->function;
1931 if (EQ (hare, tortoise))
1932 xsignal1 (Qcyclic_function_indirection, object);
1935 return hare;
1938 DEFUN ("indirect-function", Findirect_function, Sindirect_function, 1, 2, 0,
1939 doc: /* Return the function at the end of OBJECT's function chain.
1940 If OBJECT is not a symbol, just return it. Otherwise, follow all
1941 function indirections to find the final function binding and return it.
1942 If the final symbol in the chain is unbound, signal a void-function error.
1943 Optional arg NOERROR non-nil means to return nil instead of signalling.
1944 Signal a cyclic-function-indirection error if there is a loop in the
1945 function chain of symbols. */)
1946 (object, noerror)
1947 register Lisp_Object object;
1948 Lisp_Object noerror;
1950 Lisp_Object result;
1952 /* Optimize for no indirection. */
1953 result = object;
1954 if (SYMBOLP (result) && !EQ (result, Qunbound)
1955 && (result = XSYMBOL (result)->function, SYMBOLP (result)))
1956 result = indirect_function (result);
1957 if (!EQ (result, Qunbound))
1958 return result;
1960 if (NILP (noerror))
1961 xsignal1 (Qvoid_function, object);
1963 return Qnil;
1966 /* Extract and set vector and string elements */
1968 DEFUN ("aref", Faref, Saref, 2, 2, 0,
1969 doc: /* Return the element of ARRAY at index IDX.
1970 ARRAY may be a vector, a string, a char-table, a bool-vector,
1971 or a byte-code object. IDX starts at 0. */)
1972 (array, idx)
1973 register Lisp_Object array;
1974 Lisp_Object idx;
1976 register int idxval;
1978 CHECK_NUMBER (idx);
1979 idxval = XINT (idx);
1980 if (STRINGP (array))
1982 int c, idxval_byte;
1984 if (idxval < 0 || idxval >= SCHARS (array))
1985 args_out_of_range (array, idx);
1986 if (! STRING_MULTIBYTE (array))
1987 return make_number ((unsigned char) SREF (array, idxval));
1988 idxval_byte = string_char_to_byte (array, idxval);
1990 c = STRING_CHAR (SDATA (array) + idxval_byte,
1991 SBYTES (array) - idxval_byte);
1992 return make_number (c);
1994 else if (BOOL_VECTOR_P (array))
1996 int val;
1998 if (idxval < 0 || idxval >= XBOOL_VECTOR (array)->size)
1999 args_out_of_range (array, idx);
2001 val = (unsigned char) XBOOL_VECTOR (array)->data[idxval / BOOL_VECTOR_BITS_PER_CHAR];
2002 return (val & (1 << (idxval % BOOL_VECTOR_BITS_PER_CHAR)) ? Qt : Qnil);
2004 else if (CHAR_TABLE_P (array))
2006 CHECK_CHARACTER (idx);
2007 return CHAR_TABLE_REF (array, idxval);
2009 else
2011 int size = 0;
2012 if (VECTORP (array))
2013 size = XVECTOR (array)->size;
2014 else if (COMPILEDP (array))
2015 size = XVECTOR (array)->size & PSEUDOVECTOR_SIZE_MASK;
2016 else
2017 wrong_type_argument (Qarrayp, array);
2019 if (idxval < 0 || idxval >= size)
2020 args_out_of_range (array, idx);
2021 return XVECTOR (array)->contents[idxval];
2025 DEFUN ("aset", Faset, Saset, 3, 3, 0,
2026 doc: /* Store into the element of ARRAY at index IDX the value NEWELT.
2027 Return NEWELT. ARRAY may be a vector, a string, a char-table or a
2028 bool-vector. IDX starts at 0. */)
2029 (array, idx, newelt)
2030 register Lisp_Object array;
2031 Lisp_Object idx, newelt;
2033 register int idxval;
2035 CHECK_NUMBER (idx);
2036 idxval = XINT (idx);
2037 CHECK_ARRAY (array, Qarrayp);
2038 CHECK_IMPURE (array);
2040 if (VECTORP (array))
2042 if (idxval < 0 || idxval >= XVECTOR (array)->size)
2043 args_out_of_range (array, idx);
2044 XVECTOR (array)->contents[idxval] = newelt;
2046 else if (BOOL_VECTOR_P (array))
2048 int val;
2050 if (idxval < 0 || idxval >= XBOOL_VECTOR (array)->size)
2051 args_out_of_range (array, idx);
2053 val = (unsigned char) XBOOL_VECTOR (array)->data[idxval / BOOL_VECTOR_BITS_PER_CHAR];
2055 if (! NILP (newelt))
2056 val |= 1 << (idxval % BOOL_VECTOR_BITS_PER_CHAR);
2057 else
2058 val &= ~(1 << (idxval % BOOL_VECTOR_BITS_PER_CHAR));
2059 XBOOL_VECTOR (array)->data[idxval / BOOL_VECTOR_BITS_PER_CHAR] = val;
2061 else if (CHAR_TABLE_P (array))
2063 CHECK_CHARACTER (idx);
2064 CHAR_TABLE_SET (array, idxval, newelt);
2066 else if (STRING_MULTIBYTE (array))
2068 int idxval_byte, prev_bytes, new_bytes, nbytes;
2069 unsigned char workbuf[MAX_MULTIBYTE_LENGTH], *p0 = workbuf, *p1;
2071 if (idxval < 0 || idxval >= SCHARS (array))
2072 args_out_of_range (array, idx);
2073 CHECK_CHARACTER (newelt);
2075 nbytes = SBYTES (array);
2077 idxval_byte = string_char_to_byte (array, idxval);
2078 p1 = SDATA (array) + idxval_byte;
2079 PARSE_MULTIBYTE_SEQ (p1, nbytes - idxval_byte, prev_bytes);
2080 new_bytes = CHAR_STRING (XINT (newelt), p0);
2081 if (prev_bytes != new_bytes)
2083 /* We must relocate the string data. */
2084 int nchars = SCHARS (array);
2085 unsigned char *str;
2086 USE_SAFE_ALLOCA;
2088 SAFE_ALLOCA (str, unsigned char *, nbytes);
2089 bcopy (SDATA (array), str, nbytes);
2090 allocate_string_data (XSTRING (array), nchars,
2091 nbytes + new_bytes - prev_bytes);
2092 bcopy (str, SDATA (array), idxval_byte);
2093 p1 = SDATA (array) + idxval_byte;
2094 bcopy (str + idxval_byte + prev_bytes, p1 + new_bytes,
2095 nbytes - (idxval_byte + prev_bytes));
2096 SAFE_FREE ();
2097 clear_string_char_byte_cache ();
2099 while (new_bytes--)
2100 *p1++ = *p0++;
2102 else
2104 if (idxval < 0 || idxval >= SCHARS (array))
2105 args_out_of_range (array, idx);
2106 CHECK_NUMBER (newelt);
2108 if (XINT (newelt) >= 0 && ! SINGLE_BYTE_CHAR_P (XINT (newelt)))
2110 int i;
2112 for (i = SBYTES (array) - 1; i >= 0; i--)
2113 if (SREF (array, i) >= 0x80)
2114 args_out_of_range (array, newelt);
2115 /* ARRAY is an ASCII string. Convert it to a multibyte
2116 string, and try `aset' again. */
2117 STRING_SET_MULTIBYTE (array);
2118 return Faset (array, idx, newelt);
2120 SSET (array, idxval, XINT (newelt));
2123 return newelt;
2126 /* Arithmetic functions */
2128 enum comparison { equal, notequal, less, grtr, less_or_equal, grtr_or_equal };
2130 Lisp_Object
2131 arithcompare (num1, num2, comparison)
2132 Lisp_Object num1, num2;
2133 enum comparison comparison;
2135 double f1 = 0, f2 = 0;
2136 int floatp = 0;
2138 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num1);
2139 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num2);
2141 if (FLOATP (num1) || FLOATP (num2))
2143 floatp = 1;
2144 f1 = (FLOATP (num1)) ? XFLOAT_DATA (num1) : XINT (num1);
2145 f2 = (FLOATP (num2)) ? XFLOAT_DATA (num2) : XINT (num2);
2148 switch (comparison)
2150 case equal:
2151 if (floatp ? f1 == f2 : XINT (num1) == XINT (num2))
2152 return Qt;
2153 return Qnil;
2155 case notequal:
2156 if (floatp ? f1 != f2 : XINT (num1) != XINT (num2))
2157 return Qt;
2158 return Qnil;
2160 case less:
2161 if (floatp ? f1 < f2 : XINT (num1) < XINT (num2))
2162 return Qt;
2163 return Qnil;
2165 case less_or_equal:
2166 if (floatp ? f1 <= f2 : XINT (num1) <= XINT (num2))
2167 return Qt;
2168 return Qnil;
2170 case grtr:
2171 if (floatp ? f1 > f2 : XINT (num1) > XINT (num2))
2172 return Qt;
2173 return Qnil;
2175 case grtr_or_equal:
2176 if (floatp ? f1 >= f2 : XINT (num1) >= XINT (num2))
2177 return Qt;
2178 return Qnil;
2180 default:
2181 abort ();
2185 DEFUN ("=", Feqlsign, Seqlsign, 2, 2, 0,
2186 doc: /* Return t if two args, both numbers or markers, are equal. */)
2187 (num1, num2)
2188 register Lisp_Object num1, num2;
2190 return arithcompare (num1, num2, equal);
2193 DEFUN ("<", Flss, Slss, 2, 2, 0,
2194 doc: /* Return t if first arg is less than second arg. Both must be numbers or markers. */)
2195 (num1, num2)
2196 register Lisp_Object num1, num2;
2198 return arithcompare (num1, num2, less);
2201 DEFUN (">", Fgtr, Sgtr, 2, 2, 0,
2202 doc: /* Return t if first arg is greater than second arg. Both must be numbers or markers. */)
2203 (num1, num2)
2204 register Lisp_Object num1, num2;
2206 return arithcompare (num1, num2, grtr);
2209 DEFUN ("<=", Fleq, Sleq, 2, 2, 0,
2210 doc: /* Return t if first arg is less than or equal to second arg.
2211 Both must be numbers or markers. */)
2212 (num1, num2)
2213 register Lisp_Object num1, num2;
2215 return arithcompare (num1, num2, less_or_equal);
2218 DEFUN (">=", Fgeq, Sgeq, 2, 2, 0,
2219 doc: /* Return t if first arg is greater than or equal to second arg.
2220 Both must be numbers or markers. */)
2221 (num1, num2)
2222 register Lisp_Object num1, num2;
2224 return arithcompare (num1, num2, grtr_or_equal);
2227 DEFUN ("/=", Fneq, Sneq, 2, 2, 0,
2228 doc: /* Return t if first arg is not equal to second arg. Both must be numbers or markers. */)
2229 (num1, num2)
2230 register Lisp_Object num1, num2;
2232 return arithcompare (num1, num2, notequal);
2235 DEFUN ("zerop", Fzerop, Szerop, 1, 1, 0,
2236 doc: /* Return t if NUMBER is zero. */)
2237 (number)
2238 register Lisp_Object number;
2240 CHECK_NUMBER_OR_FLOAT (number);
2242 if (FLOATP (number))
2244 if (XFLOAT_DATA (number) == 0.0)
2245 return Qt;
2246 return Qnil;
2249 if (!XINT (number))
2250 return Qt;
2251 return Qnil;
2254 /* Convert between long values and pairs of Lisp integers.
2255 Note that long_to_cons returns a single Lisp integer
2256 when the value fits in one. */
2258 Lisp_Object
2259 long_to_cons (i)
2260 unsigned long i;
2262 unsigned long top = i >> 16;
2263 unsigned int bot = i & 0xFFFF;
2264 if (top == 0)
2265 return make_number (bot);
2266 if (top == (unsigned long)-1 >> 16)
2267 return Fcons (make_number (-1), make_number (bot));
2268 return Fcons (make_number (top), make_number (bot));
2271 unsigned long
2272 cons_to_long (c)
2273 Lisp_Object c;
2275 Lisp_Object top, bot;
2276 if (INTEGERP (c))
2277 return XINT (c);
2278 top = XCAR (c);
2279 bot = XCDR (c);
2280 if (CONSP (bot))
2281 bot = XCAR (bot);
2282 return ((XINT (top) << 16) | XINT (bot));
2285 DEFUN ("number-to-string", Fnumber_to_string, Snumber_to_string, 1, 1, 0,
2286 doc: /* Return the decimal representation of NUMBER as a string.
2287 Uses a minus sign if negative.
2288 NUMBER may be an integer or a floating point number. */)
2289 (number)
2290 Lisp_Object number;
2292 char buffer[VALBITS];
2294 CHECK_NUMBER_OR_FLOAT (number);
2296 if (FLOATP (number))
2298 char pigbuf[350]; /* see comments in float_to_string */
2300 float_to_string (pigbuf, XFLOAT_DATA (number));
2301 return build_string (pigbuf);
2304 if (sizeof (int) == sizeof (EMACS_INT))
2305 sprintf (buffer, "%d", (int) XINT (number));
2306 else if (sizeof (long) == sizeof (EMACS_INT))
2307 sprintf (buffer, "%ld", (long) XINT (number));
2308 else
2309 abort ();
2310 return build_string (buffer);
2313 INLINE static int
2314 digit_to_number (character, base)
2315 int character, base;
2317 int digit;
2319 if (character >= '0' && character <= '9')
2320 digit = character - '0';
2321 else if (character >= 'a' && character <= 'z')
2322 digit = character - 'a' + 10;
2323 else if (character >= 'A' && character <= 'Z')
2324 digit = character - 'A' + 10;
2325 else
2326 return -1;
2328 if (digit >= base)
2329 return -1;
2330 else
2331 return digit;
2334 DEFUN ("string-to-number", Fstring_to_number, Sstring_to_number, 1, 2, 0,
2335 doc: /* Parse STRING as a decimal number and return the number.
2336 This parses both integers and floating point numbers.
2337 It ignores leading spaces and tabs.
2339 If BASE, interpret STRING as a number in that base. If BASE isn't
2340 present, base 10 is used. BASE must be between 2 and 16 (inclusive).
2341 If the base used is not 10, floating point is not recognized. */)
2342 (string, base)
2343 register Lisp_Object string, base;
2345 register unsigned char *p;
2346 register int b;
2347 int sign = 1;
2348 Lisp_Object val;
2350 CHECK_STRING (string);
2352 if (NILP (base))
2353 b = 10;
2354 else
2356 CHECK_NUMBER (base);
2357 b = XINT (base);
2358 if (b < 2 || b > 16)
2359 xsignal1 (Qargs_out_of_range, base);
2362 /* Skip any whitespace at the front of the number. Some versions of
2363 atoi do this anyway, so we might as well make Emacs lisp consistent. */
2364 p = SDATA (string);
2365 while (*p == ' ' || *p == '\t')
2366 p++;
2368 if (*p == '-')
2370 sign = -1;
2371 p++;
2373 else if (*p == '+')
2374 p++;
2376 if (isfloat_string (p) && b == 10)
2377 val = make_float (sign * atof (p));
2378 else
2380 double v = 0;
2382 while (1)
2384 int digit = digit_to_number (*p++, b);
2385 if (digit < 0)
2386 break;
2387 v = v * b + digit;
2390 val = make_fixnum_or_float (sign * v);
2393 return val;
2397 enum arithop
2399 Aadd,
2400 Asub,
2401 Amult,
2402 Adiv,
2403 Alogand,
2404 Alogior,
2405 Alogxor,
2406 Amax,
2407 Amin
2410 static Lisp_Object float_arith_driver P_ ((double, int, enum arithop,
2411 int, Lisp_Object *));
2412 extern Lisp_Object fmod_float ();
2414 Lisp_Object
2415 arith_driver (code, nargs, args)
2416 enum arithop code;
2417 int nargs;
2418 register Lisp_Object *args;
2420 register Lisp_Object val;
2421 register int argnum;
2422 register EMACS_INT accum = 0;
2423 register EMACS_INT next;
2425 switch (SWITCH_ENUM_CAST (code))
2427 case Alogior:
2428 case Alogxor:
2429 case Aadd:
2430 case Asub:
2431 accum = 0;
2432 break;
2433 case Amult:
2434 accum = 1;
2435 break;
2436 case Alogand:
2437 accum = -1;
2438 break;
2439 default:
2440 break;
2443 for (argnum = 0; argnum < nargs; argnum++)
2445 /* Using args[argnum] as argument to CHECK_NUMBER_... */
2446 val = args[argnum];
2447 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2449 if (FLOATP (val))
2450 return float_arith_driver ((double) accum, argnum, code,
2451 nargs, args);
2452 args[argnum] = val;
2453 next = XINT (args[argnum]);
2454 switch (SWITCH_ENUM_CAST (code))
2456 case Aadd:
2457 accum += next;
2458 break;
2459 case Asub:
2460 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2461 break;
2462 case Amult:
2463 accum *= next;
2464 break;
2465 case Adiv:
2466 if (!argnum)
2467 accum = next;
2468 else
2470 if (next == 0)
2471 xsignal0 (Qarith_error);
2472 accum /= next;
2474 break;
2475 case Alogand:
2476 accum &= next;
2477 break;
2478 case Alogior:
2479 accum |= next;
2480 break;
2481 case Alogxor:
2482 accum ^= next;
2483 break;
2484 case Amax:
2485 if (!argnum || next > accum)
2486 accum = next;
2487 break;
2488 case Amin:
2489 if (!argnum || next < accum)
2490 accum = next;
2491 break;
2495 XSETINT (val, accum);
2496 return val;
2499 #undef isnan
2500 #define isnan(x) ((x) != (x))
2502 static Lisp_Object
2503 float_arith_driver (accum, argnum, code, nargs, args)
2504 double accum;
2505 register int argnum;
2506 enum arithop code;
2507 int nargs;
2508 register Lisp_Object *args;
2510 register Lisp_Object val;
2511 double next;
2513 for (; argnum < nargs; argnum++)
2515 val = args[argnum]; /* using args[argnum] as argument to CHECK_NUMBER_... */
2516 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2518 if (FLOATP (val))
2520 next = XFLOAT_DATA (val);
2522 else
2524 args[argnum] = val; /* runs into a compiler bug. */
2525 next = XINT (args[argnum]);
2527 switch (SWITCH_ENUM_CAST (code))
2529 case Aadd:
2530 accum += next;
2531 break;
2532 case Asub:
2533 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2534 break;
2535 case Amult:
2536 accum *= next;
2537 break;
2538 case Adiv:
2539 if (!argnum)
2540 accum = next;
2541 else
2543 if (! IEEE_FLOATING_POINT && next == 0)
2544 xsignal0 (Qarith_error);
2545 accum /= next;
2547 break;
2548 case Alogand:
2549 case Alogior:
2550 case Alogxor:
2551 return wrong_type_argument (Qinteger_or_marker_p, val);
2552 case Amax:
2553 if (!argnum || isnan (next) || next > accum)
2554 accum = next;
2555 break;
2556 case Amin:
2557 if (!argnum || isnan (next) || next < accum)
2558 accum = next;
2559 break;
2563 return make_float (accum);
2567 DEFUN ("+", Fplus, Splus, 0, MANY, 0,
2568 doc: /* Return sum of any number of arguments, which are numbers or markers.
2569 usage: (+ &rest NUMBERS-OR-MARKERS) */)
2570 (nargs, args)
2571 int nargs;
2572 Lisp_Object *args;
2574 return arith_driver (Aadd, nargs, args);
2577 DEFUN ("-", Fminus, Sminus, 0, MANY, 0,
2578 doc: /* Negate number or subtract numbers or markers and return the result.
2579 With one arg, negates it. With more than one arg,
2580 subtracts all but the first from the first.
2581 usage: (- &optional NUMBER-OR-MARKER &rest MORE-NUMBERS-OR-MARKERS) */)
2582 (nargs, args)
2583 int nargs;
2584 Lisp_Object *args;
2586 return arith_driver (Asub, nargs, args);
2589 DEFUN ("*", Ftimes, Stimes, 0, MANY, 0,
2590 doc: /* Return product of any number of arguments, which are numbers or markers.
2591 usage: (* &rest NUMBERS-OR-MARKERS) */)
2592 (nargs, args)
2593 int nargs;
2594 Lisp_Object *args;
2596 return arith_driver (Amult, nargs, args);
2599 DEFUN ("/", Fquo, Squo, 2, MANY, 0,
2600 doc: /* Return first argument divided by all the remaining arguments.
2601 The arguments must be numbers or markers.
2602 usage: (/ DIVIDEND DIVISOR &rest DIVISORS) */)
2603 (nargs, args)
2604 int nargs;
2605 Lisp_Object *args;
2607 int argnum;
2608 for (argnum = 2; argnum < nargs; argnum++)
2609 if (FLOATP (args[argnum]))
2610 return float_arith_driver (0, 0, Adiv, nargs, args);
2611 return arith_driver (Adiv, nargs, args);
2614 DEFUN ("%", Frem, Srem, 2, 2, 0,
2615 doc: /* Return remainder of X divided by Y.
2616 Both must be integers or markers. */)
2617 (x, y)
2618 register Lisp_Object x, y;
2620 Lisp_Object val;
2622 CHECK_NUMBER_COERCE_MARKER (x);
2623 CHECK_NUMBER_COERCE_MARKER (y);
2625 if (XFASTINT (y) == 0)
2626 xsignal0 (Qarith_error);
2628 XSETINT (val, XINT (x) % XINT (y));
2629 return val;
2632 #ifndef HAVE_FMOD
2633 double
2634 fmod (f1, f2)
2635 double f1, f2;
2637 double r = f1;
2639 if (f2 < 0.0)
2640 f2 = -f2;
2642 /* If the magnitude of the result exceeds that of the divisor, or
2643 the sign of the result does not agree with that of the dividend,
2644 iterate with the reduced value. This does not yield a
2645 particularly accurate result, but at least it will be in the
2646 range promised by fmod. */
2648 r -= f2 * floor (r / f2);
2649 while (f2 <= (r < 0 ? -r : r) || ((r < 0) != (f1 < 0) && ! isnan (r)));
2651 return r;
2653 #endif /* ! HAVE_FMOD */
2655 DEFUN ("mod", Fmod, Smod, 2, 2, 0,
2656 doc: /* Return X modulo Y.
2657 The result falls between zero (inclusive) and Y (exclusive).
2658 Both X and Y must be numbers or markers. */)
2659 (x, y)
2660 register Lisp_Object x, y;
2662 Lisp_Object val;
2663 EMACS_INT i1, i2;
2665 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (x);
2666 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (y);
2668 if (FLOATP (x) || FLOATP (y))
2669 return fmod_float (x, y);
2671 i1 = XINT (x);
2672 i2 = XINT (y);
2674 if (i2 == 0)
2675 xsignal0 (Qarith_error);
2677 i1 %= i2;
2679 /* If the "remainder" comes out with the wrong sign, fix it. */
2680 if (i2 < 0 ? i1 > 0 : i1 < 0)
2681 i1 += i2;
2683 XSETINT (val, i1);
2684 return val;
2687 DEFUN ("max", Fmax, Smax, 1, MANY, 0,
2688 doc: /* Return largest of all the arguments (which must be numbers or markers).
2689 The value is always a number; markers are converted to numbers.
2690 usage: (max NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2691 (nargs, args)
2692 int nargs;
2693 Lisp_Object *args;
2695 return arith_driver (Amax, nargs, args);
2698 DEFUN ("min", Fmin, Smin, 1, MANY, 0,
2699 doc: /* Return smallest of all the arguments (which must be numbers or markers).
2700 The value is always a number; markers are converted to numbers.
2701 usage: (min NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2702 (nargs, args)
2703 int nargs;
2704 Lisp_Object *args;
2706 return arith_driver (Amin, nargs, args);
2709 DEFUN ("logand", Flogand, Slogand, 0, MANY, 0,
2710 doc: /* Return bitwise-and of all the arguments.
2711 Arguments may be integers, or markers converted to integers.
2712 usage: (logand &rest INTS-OR-MARKERS) */)
2713 (nargs, args)
2714 int nargs;
2715 Lisp_Object *args;
2717 return arith_driver (Alogand, nargs, args);
2720 DEFUN ("logior", Flogior, Slogior, 0, MANY, 0,
2721 doc: /* Return bitwise-or of all the arguments.
2722 Arguments may be integers, or markers converted to integers.
2723 usage: (logior &rest INTS-OR-MARKERS) */)
2724 (nargs, args)
2725 int nargs;
2726 Lisp_Object *args;
2728 return arith_driver (Alogior, nargs, args);
2731 DEFUN ("logxor", Flogxor, Slogxor, 0, MANY, 0,
2732 doc: /* Return bitwise-exclusive-or of all the arguments.
2733 Arguments may be integers, or markers converted to integers.
2734 usage: (logxor &rest INTS-OR-MARKERS) */)
2735 (nargs, args)
2736 int nargs;
2737 Lisp_Object *args;
2739 return arith_driver (Alogxor, nargs, args);
2742 DEFUN ("ash", Fash, Sash, 2, 2, 0,
2743 doc: /* Return VALUE with its bits shifted left by COUNT.
2744 If COUNT is negative, shifting is actually to the right.
2745 In this case, the sign bit is duplicated. */)
2746 (value, count)
2747 register Lisp_Object value, count;
2749 register Lisp_Object val;
2751 CHECK_NUMBER (value);
2752 CHECK_NUMBER (count);
2754 if (XINT (count) >= BITS_PER_EMACS_INT)
2755 XSETINT (val, 0);
2756 else if (XINT (count) > 0)
2757 XSETINT (val, XINT (value) << XFASTINT (count));
2758 else if (XINT (count) <= -BITS_PER_EMACS_INT)
2759 XSETINT (val, XINT (value) < 0 ? -1 : 0);
2760 else
2761 XSETINT (val, XINT (value) >> -XINT (count));
2762 return val;
2765 DEFUN ("lsh", Flsh, Slsh, 2, 2, 0,
2766 doc: /* Return VALUE with its bits shifted left by COUNT.
2767 If COUNT is negative, shifting is actually to the right.
2768 In this case, zeros are shifted in on the left. */)
2769 (value, count)
2770 register Lisp_Object value, count;
2772 register Lisp_Object val;
2774 CHECK_NUMBER (value);
2775 CHECK_NUMBER (count);
2777 if (XINT (count) >= BITS_PER_EMACS_INT)
2778 XSETINT (val, 0);
2779 else if (XINT (count) > 0)
2780 XSETINT (val, (EMACS_UINT) XUINT (value) << XFASTINT (count));
2781 else if (XINT (count) <= -BITS_PER_EMACS_INT)
2782 XSETINT (val, 0);
2783 else
2784 XSETINT (val, (EMACS_UINT) XUINT (value) >> -XINT (count));
2785 return val;
2788 DEFUN ("1+", Fadd1, Sadd1, 1, 1, 0,
2789 doc: /* Return NUMBER plus one. NUMBER may be a number or a marker.
2790 Markers are converted to integers. */)
2791 (number)
2792 register Lisp_Object number;
2794 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
2796 if (FLOATP (number))
2797 return (make_float (1.0 + XFLOAT_DATA (number)));
2799 XSETINT (number, XINT (number) + 1);
2800 return number;
2803 DEFUN ("1-", Fsub1, Ssub1, 1, 1, 0,
2804 doc: /* Return NUMBER minus one. NUMBER may be a number or a marker.
2805 Markers are converted to integers. */)
2806 (number)
2807 register Lisp_Object number;
2809 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
2811 if (FLOATP (number))
2812 return (make_float (-1.0 + XFLOAT_DATA (number)));
2814 XSETINT (number, XINT (number) - 1);
2815 return number;
2818 DEFUN ("lognot", Flognot, Slognot, 1, 1, 0,
2819 doc: /* Return the bitwise complement of NUMBER. NUMBER must be an integer. */)
2820 (number)
2821 register Lisp_Object number;
2823 CHECK_NUMBER (number);
2824 XSETINT (number, ~XINT (number));
2825 return number;
2828 DEFUN ("byteorder", Fbyteorder, Sbyteorder, 0, 0, 0,
2829 doc: /* Return the byteorder for the machine.
2830 Returns 66 (ASCII uppercase B) for big endian machines or 108 (ASCII
2831 lowercase l) for small endian machines. */)
2834 unsigned i = 0x04030201;
2835 int order = *(char *)&i == 1 ? 108 : 66;
2837 return make_number (order);
2842 void
2843 syms_of_data ()
2845 Lisp_Object error_tail, arith_tail;
2847 Qquote = intern ("quote");
2848 Qlambda = intern ("lambda");
2849 Qsubr = intern ("subr");
2850 Qerror_conditions = intern ("error-conditions");
2851 Qerror_message = intern ("error-message");
2852 Qtop_level = intern ("top-level");
2854 Qerror = intern ("error");
2855 Qquit = intern ("quit");
2856 Qwrong_type_argument = intern ("wrong-type-argument");
2857 Qargs_out_of_range = intern ("args-out-of-range");
2858 Qvoid_function = intern ("void-function");
2859 Qcyclic_function_indirection = intern ("cyclic-function-indirection");
2860 Qcyclic_variable_indirection = intern ("cyclic-variable-indirection");
2861 Qvoid_variable = intern ("void-variable");
2862 Qsetting_constant = intern ("setting-constant");
2863 Qinvalid_read_syntax = intern ("invalid-read-syntax");
2865 Qinvalid_function = intern ("invalid-function");
2866 Qwrong_number_of_arguments = intern ("wrong-number-of-arguments");
2867 Qno_catch = intern ("no-catch");
2868 Qend_of_file = intern ("end-of-file");
2869 Qarith_error = intern ("arith-error");
2870 Qbeginning_of_buffer = intern ("beginning-of-buffer");
2871 Qend_of_buffer = intern ("end-of-buffer");
2872 Qbuffer_read_only = intern ("buffer-read-only");
2873 Qtext_read_only = intern ("text-read-only");
2874 Qmark_inactive = intern ("mark-inactive");
2876 Qlistp = intern ("listp");
2877 Qconsp = intern ("consp");
2878 Qsymbolp = intern ("symbolp");
2879 Qkeywordp = intern ("keywordp");
2880 Qintegerp = intern ("integerp");
2881 Qnatnump = intern ("natnump");
2882 Qwholenump = intern ("wholenump");
2883 Qstringp = intern ("stringp");
2884 Qarrayp = intern ("arrayp");
2885 Qsequencep = intern ("sequencep");
2886 Qbufferp = intern ("bufferp");
2887 Qvectorp = intern ("vectorp");
2888 Qchar_or_string_p = intern ("char-or-string-p");
2889 Qmarkerp = intern ("markerp");
2890 Qbuffer_or_string_p = intern ("buffer-or-string-p");
2891 Qinteger_or_marker_p = intern ("integer-or-marker-p");
2892 Qboundp = intern ("boundp");
2893 Qfboundp = intern ("fboundp");
2895 Qfloatp = intern ("floatp");
2896 Qnumberp = intern ("numberp");
2897 Qnumber_or_marker_p = intern ("number-or-marker-p");
2899 Qchar_table_p = intern ("char-table-p");
2900 Qvector_or_char_table_p = intern ("vector-or-char-table-p");
2902 Qsubrp = intern ("subrp");
2903 Qunevalled = intern ("unevalled");
2904 Qmany = intern ("many");
2906 Qcdr = intern ("cdr");
2908 /* Handle automatic advice activation */
2909 Qad_advice_info = intern ("ad-advice-info");
2910 Qad_activate_internal = intern ("ad-activate-internal");
2912 error_tail = Fcons (Qerror, Qnil);
2914 /* ERROR is used as a signaler for random errors for which nothing else is right */
2916 Fput (Qerror, Qerror_conditions,
2917 error_tail);
2918 Fput (Qerror, Qerror_message,
2919 build_string ("error"));
2921 Fput (Qquit, Qerror_conditions,
2922 Fcons (Qquit, Qnil));
2923 Fput (Qquit, Qerror_message,
2924 build_string ("Quit"));
2926 Fput (Qwrong_type_argument, Qerror_conditions,
2927 Fcons (Qwrong_type_argument, error_tail));
2928 Fput (Qwrong_type_argument, Qerror_message,
2929 build_string ("Wrong type argument"));
2931 Fput (Qargs_out_of_range, Qerror_conditions,
2932 Fcons (Qargs_out_of_range, error_tail));
2933 Fput (Qargs_out_of_range, Qerror_message,
2934 build_string ("Args out of range"));
2936 Fput (Qvoid_function, Qerror_conditions,
2937 Fcons (Qvoid_function, error_tail));
2938 Fput (Qvoid_function, Qerror_message,
2939 build_string ("Symbol's function definition is void"));
2941 Fput (Qcyclic_function_indirection, Qerror_conditions,
2942 Fcons (Qcyclic_function_indirection, error_tail));
2943 Fput (Qcyclic_function_indirection, Qerror_message,
2944 build_string ("Symbol's chain of function indirections contains a loop"));
2946 Fput (Qcyclic_variable_indirection, Qerror_conditions,
2947 Fcons (Qcyclic_variable_indirection, error_tail));
2948 Fput (Qcyclic_variable_indirection, Qerror_message,
2949 build_string ("Symbol's chain of variable indirections contains a loop"));
2951 Qcircular_list = intern ("circular-list");
2952 staticpro (&Qcircular_list);
2953 Fput (Qcircular_list, Qerror_conditions,
2954 Fcons (Qcircular_list, error_tail));
2955 Fput (Qcircular_list, Qerror_message,
2956 build_string ("List contains a loop"));
2958 Fput (Qvoid_variable, Qerror_conditions,
2959 Fcons (Qvoid_variable, error_tail));
2960 Fput (Qvoid_variable, Qerror_message,
2961 build_string ("Symbol's value as variable is void"));
2963 Fput (Qsetting_constant, Qerror_conditions,
2964 Fcons (Qsetting_constant, error_tail));
2965 Fput (Qsetting_constant, Qerror_message,
2966 build_string ("Attempt to set a constant symbol"));
2968 Fput (Qinvalid_read_syntax, Qerror_conditions,
2969 Fcons (Qinvalid_read_syntax, error_tail));
2970 Fput (Qinvalid_read_syntax, Qerror_message,
2971 build_string ("Invalid read syntax"));
2973 Fput (Qinvalid_function, Qerror_conditions,
2974 Fcons (Qinvalid_function, error_tail));
2975 Fput (Qinvalid_function, Qerror_message,
2976 build_string ("Invalid function"));
2978 Fput (Qwrong_number_of_arguments, Qerror_conditions,
2979 Fcons (Qwrong_number_of_arguments, error_tail));
2980 Fput (Qwrong_number_of_arguments, Qerror_message,
2981 build_string ("Wrong number of arguments"));
2983 Fput (Qno_catch, Qerror_conditions,
2984 Fcons (Qno_catch, error_tail));
2985 Fput (Qno_catch, Qerror_message,
2986 build_string ("No catch for tag"));
2988 Fput (Qend_of_file, Qerror_conditions,
2989 Fcons (Qend_of_file, error_tail));
2990 Fput (Qend_of_file, Qerror_message,
2991 build_string ("End of file during parsing"));
2993 arith_tail = Fcons (Qarith_error, error_tail);
2994 Fput (Qarith_error, Qerror_conditions,
2995 arith_tail);
2996 Fput (Qarith_error, Qerror_message,
2997 build_string ("Arithmetic error"));
2999 Fput (Qbeginning_of_buffer, Qerror_conditions,
3000 Fcons (Qbeginning_of_buffer, error_tail));
3001 Fput (Qbeginning_of_buffer, Qerror_message,
3002 build_string ("Beginning of buffer"));
3004 Fput (Qend_of_buffer, Qerror_conditions,
3005 Fcons (Qend_of_buffer, error_tail));
3006 Fput (Qend_of_buffer, Qerror_message,
3007 build_string ("End of buffer"));
3009 Fput (Qbuffer_read_only, Qerror_conditions,
3010 Fcons (Qbuffer_read_only, error_tail));
3011 Fput (Qbuffer_read_only, Qerror_message,
3012 build_string ("Buffer is read-only"));
3014 Fput (Qtext_read_only, Qerror_conditions,
3015 Fcons (Qtext_read_only, error_tail));
3016 Fput (Qtext_read_only, Qerror_message,
3017 build_string ("Text is read-only"));
3019 Qrange_error = intern ("range-error");
3020 Qdomain_error = intern ("domain-error");
3021 Qsingularity_error = intern ("singularity-error");
3022 Qoverflow_error = intern ("overflow-error");
3023 Qunderflow_error = intern ("underflow-error");
3025 Fput (Qdomain_error, Qerror_conditions,
3026 Fcons (Qdomain_error, arith_tail));
3027 Fput (Qdomain_error, Qerror_message,
3028 build_string ("Arithmetic domain error"));
3030 Fput (Qrange_error, Qerror_conditions,
3031 Fcons (Qrange_error, arith_tail));
3032 Fput (Qrange_error, Qerror_message,
3033 build_string ("Arithmetic range error"));
3035 Fput (Qsingularity_error, Qerror_conditions,
3036 Fcons (Qsingularity_error, Fcons (Qdomain_error, arith_tail)));
3037 Fput (Qsingularity_error, Qerror_message,
3038 build_string ("Arithmetic singularity error"));
3040 Fput (Qoverflow_error, Qerror_conditions,
3041 Fcons (Qoverflow_error, Fcons (Qdomain_error, arith_tail)));
3042 Fput (Qoverflow_error, Qerror_message,
3043 build_string ("Arithmetic overflow error"));
3045 Fput (Qunderflow_error, Qerror_conditions,
3046 Fcons (Qunderflow_error, Fcons (Qdomain_error, arith_tail)));
3047 Fput (Qunderflow_error, Qerror_message,
3048 build_string ("Arithmetic underflow error"));
3050 staticpro (&Qrange_error);
3051 staticpro (&Qdomain_error);
3052 staticpro (&Qsingularity_error);
3053 staticpro (&Qoverflow_error);
3054 staticpro (&Qunderflow_error);
3056 staticpro (&Qnil);
3057 staticpro (&Qt);
3058 staticpro (&Qquote);
3059 staticpro (&Qlambda);
3060 staticpro (&Qsubr);
3061 staticpro (&Qunbound);
3062 staticpro (&Qerror_conditions);
3063 staticpro (&Qerror_message);
3064 staticpro (&Qtop_level);
3066 staticpro (&Qerror);
3067 staticpro (&Qquit);
3068 staticpro (&Qwrong_type_argument);
3069 staticpro (&Qargs_out_of_range);
3070 staticpro (&Qvoid_function);
3071 staticpro (&Qcyclic_function_indirection);
3072 staticpro (&Qcyclic_variable_indirection);
3073 staticpro (&Qvoid_variable);
3074 staticpro (&Qsetting_constant);
3075 staticpro (&Qinvalid_read_syntax);
3076 staticpro (&Qwrong_number_of_arguments);
3077 staticpro (&Qinvalid_function);
3078 staticpro (&Qno_catch);
3079 staticpro (&Qend_of_file);
3080 staticpro (&Qarith_error);
3081 staticpro (&Qbeginning_of_buffer);
3082 staticpro (&Qend_of_buffer);
3083 staticpro (&Qbuffer_read_only);
3084 staticpro (&Qtext_read_only);
3085 staticpro (&Qmark_inactive);
3087 staticpro (&Qlistp);
3088 staticpro (&Qconsp);
3089 staticpro (&Qsymbolp);
3090 staticpro (&Qkeywordp);
3091 staticpro (&Qintegerp);
3092 staticpro (&Qnatnump);
3093 staticpro (&Qwholenump);
3094 staticpro (&Qstringp);
3095 staticpro (&Qarrayp);
3096 staticpro (&Qsequencep);
3097 staticpro (&Qbufferp);
3098 staticpro (&Qvectorp);
3099 staticpro (&Qchar_or_string_p);
3100 staticpro (&Qmarkerp);
3101 staticpro (&Qbuffer_or_string_p);
3102 staticpro (&Qinteger_or_marker_p);
3103 staticpro (&Qfloatp);
3104 staticpro (&Qnumberp);
3105 staticpro (&Qnumber_or_marker_p);
3106 staticpro (&Qchar_table_p);
3107 staticpro (&Qvector_or_char_table_p);
3108 staticpro (&Qsubrp);
3109 staticpro (&Qmany);
3110 staticpro (&Qunevalled);
3112 staticpro (&Qboundp);
3113 staticpro (&Qfboundp);
3114 staticpro (&Qcdr);
3115 staticpro (&Qad_advice_info);
3116 staticpro (&Qad_activate_internal);
3118 /* Types that type-of returns. */
3119 Qinteger = intern ("integer");
3120 Qsymbol = intern ("symbol");
3121 Qstring = intern ("string");
3122 Qcons = intern ("cons");
3123 Qmarker = intern ("marker");
3124 Qoverlay = intern ("overlay");
3125 Qfloat = intern ("float");
3126 Qwindow_configuration = intern ("window-configuration");
3127 Qprocess = intern ("process");
3128 Qwindow = intern ("window");
3129 /* Qsubr = intern ("subr"); */
3130 Qcompiled_function = intern ("compiled-function");
3131 Qbuffer = intern ("buffer");
3132 Qframe = intern ("frame");
3133 Qvector = intern ("vector");
3134 Qchar_table = intern ("char-table");
3135 Qbool_vector = intern ("bool-vector");
3136 Qhash_table = intern ("hash-table");
3138 staticpro (&Qinteger);
3139 staticpro (&Qsymbol);
3140 staticpro (&Qstring);
3141 staticpro (&Qcons);
3142 staticpro (&Qmarker);
3143 staticpro (&Qoverlay);
3144 staticpro (&Qfloat);
3145 staticpro (&Qwindow_configuration);
3146 staticpro (&Qprocess);
3147 staticpro (&Qwindow);
3148 /* staticpro (&Qsubr); */
3149 staticpro (&Qcompiled_function);
3150 staticpro (&Qbuffer);
3151 staticpro (&Qframe);
3152 staticpro (&Qvector);
3153 staticpro (&Qchar_table);
3154 staticpro (&Qbool_vector);
3155 staticpro (&Qhash_table);
3157 defsubr (&Sindirect_variable);
3158 defsubr (&Sinteractive_form);
3159 defsubr (&Seq);
3160 defsubr (&Snull);
3161 defsubr (&Stype_of);
3162 defsubr (&Slistp);
3163 defsubr (&Snlistp);
3164 defsubr (&Sconsp);
3165 defsubr (&Satom);
3166 defsubr (&Sintegerp);
3167 defsubr (&Sinteger_or_marker_p);
3168 defsubr (&Snumberp);
3169 defsubr (&Snumber_or_marker_p);
3170 defsubr (&Sfloatp);
3171 defsubr (&Snatnump);
3172 defsubr (&Ssymbolp);
3173 defsubr (&Skeywordp);
3174 defsubr (&Sstringp);
3175 defsubr (&Smultibyte_string_p);
3176 defsubr (&Svectorp);
3177 defsubr (&Schar_table_p);
3178 defsubr (&Svector_or_char_table_p);
3179 defsubr (&Sbool_vector_p);
3180 defsubr (&Sarrayp);
3181 defsubr (&Ssequencep);
3182 defsubr (&Sbufferp);
3183 defsubr (&Smarkerp);
3184 defsubr (&Ssubrp);
3185 defsubr (&Sbyte_code_function_p);
3186 defsubr (&Schar_or_string_p);
3187 defsubr (&Scar);
3188 defsubr (&Scdr);
3189 defsubr (&Scar_safe);
3190 defsubr (&Scdr_safe);
3191 defsubr (&Ssetcar);
3192 defsubr (&Ssetcdr);
3193 defsubr (&Ssymbol_function);
3194 defsubr (&Sindirect_function);
3195 defsubr (&Ssymbol_plist);
3196 defsubr (&Ssymbol_name);
3197 defsubr (&Smakunbound);
3198 defsubr (&Sfmakunbound);
3199 defsubr (&Sboundp);
3200 defsubr (&Sfboundp);
3201 defsubr (&Sfset);
3202 defsubr (&Sdefalias);
3203 defsubr (&Ssetplist);
3204 defsubr (&Ssymbol_value);
3205 defsubr (&Sset);
3206 defsubr (&Sdefault_boundp);
3207 defsubr (&Sdefault_value);
3208 defsubr (&Sset_default);
3209 defsubr (&Ssetq_default);
3210 defsubr (&Smake_variable_buffer_local);
3211 defsubr (&Smake_local_variable);
3212 defsubr (&Skill_local_variable);
3213 defsubr (&Smake_variable_frame_local);
3214 defsubr (&Slocal_variable_p);
3215 defsubr (&Slocal_variable_if_set_p);
3216 defsubr (&Svariable_binding_locus);
3217 #if 0 /* XXX Remove this. --lorentey */
3218 defsubr (&Sterminal_local_value);
3219 defsubr (&Sset_terminal_local_value);
3220 #endif
3221 defsubr (&Saref);
3222 defsubr (&Saset);
3223 defsubr (&Snumber_to_string);
3224 defsubr (&Sstring_to_number);
3225 defsubr (&Seqlsign);
3226 defsubr (&Slss);
3227 defsubr (&Sgtr);
3228 defsubr (&Sleq);
3229 defsubr (&Sgeq);
3230 defsubr (&Sneq);
3231 defsubr (&Szerop);
3232 defsubr (&Splus);
3233 defsubr (&Sminus);
3234 defsubr (&Stimes);
3235 defsubr (&Squo);
3236 defsubr (&Srem);
3237 defsubr (&Smod);
3238 defsubr (&Smax);
3239 defsubr (&Smin);
3240 defsubr (&Slogand);
3241 defsubr (&Slogior);
3242 defsubr (&Slogxor);
3243 defsubr (&Slsh);
3244 defsubr (&Sash);
3245 defsubr (&Sadd1);
3246 defsubr (&Ssub1);
3247 defsubr (&Slognot);
3248 defsubr (&Sbyteorder);
3249 defsubr (&Ssubr_arity);
3250 defsubr (&Ssubr_name);
3252 XSYMBOL (Qwholenump)->function = XSYMBOL (Qnatnump)->function;
3254 DEFVAR_LISP ("most-positive-fixnum", &Vmost_positive_fixnum,
3255 doc: /* The largest value that is representable in a Lisp integer. */);
3256 Vmost_positive_fixnum = make_number (MOST_POSITIVE_FIXNUM);
3257 XSYMBOL (intern ("most-positive-fixnum"))->constant = 1;
3259 DEFVAR_LISP ("most-negative-fixnum", &Vmost_negative_fixnum,
3260 doc: /* The smallest value that is representable in a Lisp integer. */);
3261 Vmost_negative_fixnum = make_number (MOST_NEGATIVE_FIXNUM);
3262 XSYMBOL (intern ("most-negative-fixnum"))->constant = 1;
3265 SIGTYPE
3266 arith_error (signo)
3267 int signo;
3269 #if defined(USG) && !defined(POSIX_SIGNALS)
3270 /* USG systems forget handlers when they are used;
3271 must reestablish each time */
3272 signal (signo, arith_error);
3273 #endif /* USG */
3274 sigsetmask (SIGEMPTYMASK);
3276 SIGNAL_THREAD_CHECK (signo);
3277 xsignal0 (Qarith_error);
3280 void
3281 init_data ()
3283 /* Don't do this if just dumping out.
3284 We don't want to call `signal' in this case
3285 so that we don't have trouble with dumping
3286 signal-delivering routines in an inconsistent state. */
3287 #ifndef CANNOT_DUMP
3288 if (!initialized)
3289 return;
3290 #endif /* CANNOT_DUMP */
3291 signal (SIGFPE, arith_error);
3293 #ifdef uts
3294 signal (SIGEMT, arith_error);
3295 #endif /* uts */
3298 /* arch-tag: 25879798-b84d-479a-9c89-7d148e2109f7
3299 (do not change this comment) */