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