(browse-url-epiphany): Doc fix.
[emacs.git] / src / data.c
blobd18cb187f6217706c2c2723d3b7185b0e257c0ae
1 /* Primitive operations on Lisp data types for GNU Emacs Lisp interpreter.
2 Copyright (C) 1985,86,88,93,94,95,97,98,99, 2000, 2001, 2003
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 #include <config.h>
24 #include <signal.h>
25 #include <stdio.h>
26 #include "lisp.h"
27 #include "puresize.h"
28 #include "charset.h"
29 #include "buffer.h"
30 #include "keyboard.h"
31 #include "frame.h"
32 #include "syssignal.h"
34 #ifdef STDC_HEADERS
35 #include <float.h>
36 #endif
38 /* If IEEE_FLOATING_POINT isn't defined, default it from FLT_*. */
39 #ifndef IEEE_FLOATING_POINT
40 #if (FLT_RADIX == 2 && FLT_MANT_DIG == 24 \
41 && FLT_MIN_EXP == -125 && FLT_MAX_EXP == 128)
42 #define IEEE_FLOATING_POINT 1
43 #else
44 #define IEEE_FLOATING_POINT 0
45 #endif
46 #endif
48 /* Work around a problem that happens because math.h on hpux 7
49 defines two static variables--which, in Emacs, are not really static,
50 because `static' is defined as nothing. The problem is that they are
51 here, in floatfns.c, and in lread.c.
52 These macros prevent the name conflict. */
53 #if defined (HPUX) && !defined (HPUX8)
54 #define _MAXLDBL data_c_maxldbl
55 #define _NMAXLDBL data_c_nmaxldbl
56 #endif
58 #include <math.h>
60 #if !defined (atof)
61 extern double atof ();
62 #endif /* !atof */
64 Lisp_Object Qnil, Qt, Qquote, Qlambda, Qsubr, Qunbound;
65 Lisp_Object Qerror_conditions, Qerror_message, Qtop_level;
66 Lisp_Object Qerror, Qquit, Qwrong_type_argument, Qargs_out_of_range;
67 Lisp_Object Qvoid_variable, Qvoid_function, Qcyclic_function_indirection;
68 Lisp_Object Qcyclic_variable_indirection, Qcircular_list;
69 Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
70 Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
71 Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
72 Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
73 Lisp_Object Qtext_read_only;
74 Lisp_Object Qintegerp, Qnatnump, Qwholenump, Qsymbolp, Qlistp, Qconsp;
75 Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp;
76 Lisp_Object Qchar_or_string_p, Qmarkerp, Qinteger_or_marker_p, Qvectorp;
77 Lisp_Object Qbuffer_or_string_p, Qkeywordp;
78 Lisp_Object Qboundp, Qfboundp;
79 Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
81 Lisp_Object Qcdr;
82 Lisp_Object Qad_advice_info, Qad_activate_internal;
84 Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
85 Lisp_Object Qoverflow_error, Qunderflow_error;
87 Lisp_Object Qfloatp;
88 Lisp_Object Qnumberp, Qnumber_or_marker_p;
90 static Lisp_Object Qinteger, Qsymbol, Qstring, Qcons, Qmarker, Qoverlay;
91 static Lisp_Object Qfloat, Qwindow_configuration, Qwindow;
92 Lisp_Object Qprocess;
93 static Lisp_Object Qcompiled_function, Qbuffer, Qframe, Qvector;
94 static Lisp_Object Qchar_table, Qbool_vector, Qhash_table;
95 static Lisp_Object Qsubrp, Qmany, Qunevalled;
97 static Lisp_Object swap_in_symval_forwarding P_ ((Lisp_Object, Lisp_Object));
99 Lisp_Object Vmost_positive_fixnum, Vmost_negative_fixnum;
102 void
103 circular_list_error (list)
104 Lisp_Object list;
106 Fsignal (Qcircular_list, list);
110 Lisp_Object
111 wrong_type_argument (predicate, value)
112 register Lisp_Object predicate, value;
114 register Lisp_Object tem;
117 /* If VALUE is not even a valid Lisp object, abort here
118 where we can get a backtrace showing where it came from. */
119 if ((unsigned int) XGCTYPE (value) >= Lisp_Type_Limit)
120 abort ();
122 value = Fsignal (Qwrong_type_argument, Fcons (predicate, Fcons (value, Qnil)));
123 tem = call1 (predicate, value);
125 while (NILP (tem));
126 return value;
129 void
130 pure_write_error ()
132 error ("Attempt to modify read-only object");
135 void
136 args_out_of_range (a1, a2)
137 Lisp_Object a1, a2;
139 while (1)
140 Fsignal (Qargs_out_of_range, Fcons (a1, Fcons (a2, Qnil)));
143 void
144 args_out_of_range_3 (a1, a2, a3)
145 Lisp_Object a1, a2, a3;
147 while (1)
148 Fsignal (Qargs_out_of_range, Fcons (a1, Fcons (a2, Fcons (a3, Qnil))));
151 /* On some machines, XINT needs a temporary location.
152 Here it is, in case it is needed. */
154 int sign_extend_temp;
156 /* On a few machines, XINT can only be done by calling this. */
159 sign_extend_lisp_int (num)
160 EMACS_INT num;
162 if (num & (((EMACS_INT) 1) << (VALBITS - 1)))
163 return num | (((EMACS_INT) (-1)) << VALBITS);
164 else
165 return num & ((((EMACS_INT) 1) << VALBITS) - 1);
168 /* Data type predicates */
170 DEFUN ("eq", Feq, Seq, 2, 2, 0,
171 doc: /* Return t if the two args are the same Lisp object. */)
172 (obj1, obj2)
173 Lisp_Object obj1, obj2;
175 if (EQ (obj1, obj2))
176 return Qt;
177 return Qnil;
180 DEFUN ("null", Fnull, Snull, 1, 1, 0,
181 doc: /* Return t if OBJECT is nil. */)
182 (object)
183 Lisp_Object object;
185 if (NILP (object))
186 return Qt;
187 return Qnil;
190 DEFUN ("type-of", Ftype_of, Stype_of, 1, 1, 0,
191 doc: /* Return a symbol representing the type of OBJECT.
192 The symbol returned names the object's basic type;
193 for example, (type-of 1) returns `integer'. */)
194 (object)
195 Lisp_Object object;
197 switch (XGCTYPE (object))
199 case Lisp_Int:
200 return Qinteger;
202 case Lisp_Symbol:
203 return Qsymbol;
205 case Lisp_String:
206 return Qstring;
208 case Lisp_Cons:
209 return Qcons;
211 case Lisp_Misc:
212 switch (XMISCTYPE (object))
214 case Lisp_Misc_Marker:
215 return Qmarker;
216 case Lisp_Misc_Overlay:
217 return Qoverlay;
218 case Lisp_Misc_Float:
219 return Qfloat;
221 abort ();
223 case Lisp_Vectorlike:
224 if (GC_WINDOW_CONFIGURATIONP (object))
225 return Qwindow_configuration;
226 if (GC_PROCESSP (object))
227 return Qprocess;
228 if (GC_WINDOWP (object))
229 return Qwindow;
230 if (GC_SUBRP (object))
231 return Qsubr;
232 if (GC_COMPILEDP (object))
233 return Qcompiled_function;
234 if (GC_BUFFERP (object))
235 return Qbuffer;
236 if (GC_CHAR_TABLE_P (object))
237 return Qchar_table;
238 if (GC_BOOL_VECTOR_P (object))
239 return Qbool_vector;
240 if (GC_FRAMEP (object))
241 return Qframe;
242 if (GC_HASH_TABLE_P (object))
243 return Qhash_table;
244 return Qvector;
246 case Lisp_Float:
247 return Qfloat;
249 default:
250 abort ();
254 DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0,
255 doc: /* Return t if OBJECT is a cons cell. */)
256 (object)
257 Lisp_Object object;
259 if (CONSP (object))
260 return Qt;
261 return Qnil;
264 DEFUN ("atom", Fatom, Satom, 1, 1, 0,
265 doc: /* Return t if OBJECT is not a cons cell. This includes nil. */)
266 (object)
267 Lisp_Object object;
269 if (CONSP (object))
270 return Qnil;
271 return Qt;
274 DEFUN ("listp", Flistp, Slistp, 1, 1, 0,
275 doc: /* Return t if OBJECT is a list. This includes nil. */)
276 (object)
277 Lisp_Object object;
279 if (CONSP (object) || NILP (object))
280 return Qt;
281 return Qnil;
284 DEFUN ("nlistp", Fnlistp, Snlistp, 1, 1, 0,
285 doc: /* Return t if OBJECT is not a list. Lists include nil. */)
286 (object)
287 Lisp_Object object;
289 if (CONSP (object) || NILP (object))
290 return Qnil;
291 return Qt;
294 DEFUN ("symbolp", Fsymbolp, Ssymbolp, 1, 1, 0,
295 doc: /* Return t if OBJECT is a symbol. */)
296 (object)
297 Lisp_Object object;
299 if (SYMBOLP (object))
300 return Qt;
301 return Qnil;
304 /* Define this in C to avoid unnecessarily consing up the symbol
305 name. */
306 DEFUN ("keywordp", Fkeywordp, Skeywordp, 1, 1, 0,
307 doc: /* Return t if OBJECT is a keyword.
308 This means that it is a symbol with a print name beginning with `:'
309 interned in the initial obarray. */)
310 (object)
311 Lisp_Object object;
313 if (SYMBOLP (object)
314 && SREF (SYMBOL_NAME (object), 0) == ':'
315 && SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P (object))
316 return Qt;
317 return Qnil;
320 DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
321 doc: /* Return t if OBJECT is a vector. */)
322 (object)
323 Lisp_Object object;
325 if (VECTORP (object))
326 return Qt;
327 return Qnil;
330 DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
331 doc: /* Return t if OBJECT is a string. */)
332 (object)
333 Lisp_Object object;
335 if (STRINGP (object))
336 return Qt;
337 return Qnil;
340 DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p,
341 1, 1, 0,
342 doc: /* Return t if OBJECT is a multibyte string. */)
343 (object)
344 Lisp_Object object;
346 if (STRINGP (object) && STRING_MULTIBYTE (object))
347 return Qt;
348 return Qnil;
351 DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0,
352 doc: /* Return t if OBJECT is a char-table. */)
353 (object)
354 Lisp_Object object;
356 if (CHAR_TABLE_P (object))
357 return Qt;
358 return Qnil;
361 DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p,
362 Svector_or_char_table_p, 1, 1, 0,
363 doc: /* Return t if OBJECT is a char-table or vector. */)
364 (object)
365 Lisp_Object object;
367 if (VECTORP (object) || CHAR_TABLE_P (object))
368 return Qt;
369 return Qnil;
372 DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0,
373 doc: /* Return t if OBJECT is a bool-vector. */)
374 (object)
375 Lisp_Object object;
377 if (BOOL_VECTOR_P (object))
378 return Qt;
379 return Qnil;
382 DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0,
383 doc: /* Return t if OBJECT is an array (string or vector). */)
384 (object)
385 Lisp_Object object;
387 if (VECTORP (object) || STRINGP (object)
388 || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
389 return Qt;
390 return Qnil;
393 DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
394 doc: /* Return t if OBJECT is a sequence (list or array). */)
395 (object)
396 register Lisp_Object object;
398 if (CONSP (object) || NILP (object) || VECTORP (object) || STRINGP (object)
399 || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
400 return Qt;
401 return Qnil;
404 DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0,
405 doc: /* Return t if OBJECT is an editor buffer. */)
406 (object)
407 Lisp_Object object;
409 if (BUFFERP (object))
410 return Qt;
411 return Qnil;
414 DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0,
415 doc: /* Return t if OBJECT is a marker (editor pointer). */)
416 (object)
417 Lisp_Object object;
419 if (MARKERP (object))
420 return Qt;
421 return Qnil;
424 DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0,
425 doc: /* Return t if OBJECT is a built-in function. */)
426 (object)
427 Lisp_Object object;
429 if (SUBRP (object))
430 return Qt;
431 return Qnil;
434 DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
435 1, 1, 0,
436 doc: /* Return t if OBJECT is a byte-compiled function object. */)
437 (object)
438 Lisp_Object object;
440 if (COMPILEDP (object))
441 return Qt;
442 return Qnil;
445 DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0,
446 doc: /* Return t if OBJECT is a character (an integer) or a string. */)
447 (object)
448 register Lisp_Object object;
450 if (INTEGERP (object) || STRINGP (object))
451 return Qt;
452 return Qnil;
455 DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0,
456 doc: /* Return t if OBJECT is an integer. */)
457 (object)
458 Lisp_Object object;
460 if (INTEGERP (object))
461 return Qt;
462 return Qnil;
465 DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0,
466 doc: /* Return t if OBJECT is an integer or a marker (editor pointer). */)
467 (object)
468 register Lisp_Object object;
470 if (MARKERP (object) || INTEGERP (object))
471 return Qt;
472 return Qnil;
475 DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
476 doc: /* Return t if OBJECT is a nonnegative integer. */)
477 (object)
478 Lisp_Object object;
480 if (NATNUMP (object))
481 return Qt;
482 return Qnil;
485 DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
486 doc: /* Return t if OBJECT is a number (floating point or integer). */)
487 (object)
488 Lisp_Object object;
490 if (NUMBERP (object))
491 return Qt;
492 else
493 return Qnil;
496 DEFUN ("number-or-marker-p", Fnumber_or_marker_p,
497 Snumber_or_marker_p, 1, 1, 0,
498 doc: /* Return t if OBJECT is a number or a marker. */)
499 (object)
500 Lisp_Object object;
502 if (NUMBERP (object) || MARKERP (object))
503 return Qt;
504 return Qnil;
507 DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
508 doc: /* Return t if OBJECT is a floating point number. */)
509 (object)
510 Lisp_Object object;
512 if (FLOATP (object))
513 return Qt;
514 return Qnil;
518 /* Extract and set components of lists */
520 DEFUN ("car", Fcar, Scar, 1, 1, 0,
521 doc: /* Return the car of LIST. If arg is nil, return nil.
522 Error if arg is not nil and not a cons cell. See also `car-safe'. */)
523 (list)
524 register Lisp_Object list;
526 while (1)
528 if (CONSP (list))
529 return XCAR (list);
530 else if (EQ (list, Qnil))
531 return Qnil;
532 else
533 list = wrong_type_argument (Qlistp, list);
537 DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0,
538 doc: /* Return the car of OBJECT if it is a cons cell, or else nil. */)
539 (object)
540 Lisp_Object object;
542 if (CONSP (object))
543 return XCAR (object);
544 else
545 return Qnil;
548 DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
549 doc: /* Return the cdr of LIST. If arg is nil, return nil.
550 Error if arg is not nil and not a cons cell. See also `cdr-safe'. */)
551 (list)
552 register Lisp_Object list;
554 while (1)
556 if (CONSP (list))
557 return XCDR (list);
558 else if (EQ (list, Qnil))
559 return Qnil;
560 else
561 list = wrong_type_argument (Qlistp, list);
565 DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0,
566 doc: /* Return the cdr of OBJECT if it is a cons cell, or else nil. */)
567 (object)
568 Lisp_Object object;
570 if (CONSP (object))
571 return XCDR (object);
572 else
573 return Qnil;
576 DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
577 doc: /* Set the car of CELL to be NEWCAR. Returns NEWCAR. */)
578 (cell, newcar)
579 register Lisp_Object cell, newcar;
581 if (!CONSP (cell))
582 cell = wrong_type_argument (Qconsp, cell);
584 CHECK_IMPURE (cell);
585 XSETCAR (cell, newcar);
586 return newcar;
589 DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
590 doc: /* Set the cdr of CELL to be NEWCDR. Returns NEWCDR. */)
591 (cell, newcdr)
592 register Lisp_Object cell, newcdr;
594 if (!CONSP (cell))
595 cell = wrong_type_argument (Qconsp, cell);
597 CHECK_IMPURE (cell);
598 XSETCDR (cell, newcdr);
599 return newcdr;
602 /* Extract and set components of symbols */
604 DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0,
605 doc: /* Return t if SYMBOL's value is not void. */)
606 (symbol)
607 register Lisp_Object symbol;
609 Lisp_Object valcontents;
610 CHECK_SYMBOL (symbol);
612 valcontents = SYMBOL_VALUE (symbol);
614 if (BUFFER_LOCAL_VALUEP (valcontents)
615 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
616 valcontents = swap_in_symval_forwarding (symbol, valcontents);
618 return (EQ (valcontents, Qunbound) ? Qnil : Qt);
621 DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0,
622 doc: /* Return t if SYMBOL's function definition is not void. */)
623 (symbol)
624 register Lisp_Object symbol;
626 CHECK_SYMBOL (symbol);
627 return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
630 DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0,
631 doc: /* Make SYMBOL's value be void.
632 Return SYMBOL. */)
633 (symbol)
634 register Lisp_Object symbol;
636 CHECK_SYMBOL (symbol);
637 if (XSYMBOL (symbol)->constant)
638 return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
639 Fset (symbol, Qunbound);
640 return symbol;
643 DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0,
644 doc: /* Make SYMBOL's function definition be void.
645 Return SYMBOL. */)
646 (symbol)
647 register Lisp_Object symbol;
649 CHECK_SYMBOL (symbol);
650 if (NILP (symbol) || EQ (symbol, Qt))
651 return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
652 XSYMBOL (symbol)->function = Qunbound;
653 return symbol;
656 DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0,
657 doc: /* Return SYMBOL's function definition. Error if that is void. */)
658 (symbol)
659 register Lisp_Object symbol;
661 CHECK_SYMBOL (symbol);
662 if (EQ (XSYMBOL (symbol)->function, Qunbound))
663 return Fsignal (Qvoid_function, Fcons (symbol, Qnil));
664 return XSYMBOL (symbol)->function;
667 DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0,
668 doc: /* Return SYMBOL's property list. */)
669 (symbol)
670 register Lisp_Object symbol;
672 CHECK_SYMBOL (symbol);
673 return XSYMBOL (symbol)->plist;
676 DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0,
677 doc: /* Return SYMBOL's name, a string. */)
678 (symbol)
679 register Lisp_Object symbol;
681 register Lisp_Object name;
683 CHECK_SYMBOL (symbol);
684 name = SYMBOL_NAME (symbol);
685 return name;
688 DEFUN ("fset", Ffset, Sfset, 2, 2, 0,
689 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION. */)
690 (symbol, definition)
691 register Lisp_Object symbol, definition;
693 CHECK_SYMBOL (symbol);
694 if (NILP (symbol) || EQ (symbol, Qt))
695 return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
696 if (!NILP (Vautoload_queue) && !EQ (XSYMBOL (symbol)->function, Qunbound))
697 Vautoload_queue = Fcons (Fcons (symbol, XSYMBOL (symbol)->function),
698 Vautoload_queue);
699 XSYMBOL (symbol)->function = definition;
700 /* Handle automatic advice activation */
701 if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
703 call2 (Qad_activate_internal, symbol, Qnil);
704 definition = XSYMBOL (symbol)->function;
706 return definition;
709 extern Lisp_Object Qfunction_documentation;
711 DEFUN ("defalias", Fdefalias, Sdefalias, 2, 3, 0,
712 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION.
713 Associates the function with the current load file, if any.
714 The optional third argument DOCSTRING specifies the documentation string
715 for SYMBOL; if it is omitted or nil, SYMBOL uses the documentation string
716 determined by DEFINITION. */)
717 (symbol, definition, docstring)
718 register Lisp_Object symbol, definition, docstring;
720 if (CONSP (XSYMBOL (symbol)->function)
721 && EQ (XCAR (XSYMBOL (symbol)->function), Qautoload))
722 LOADHIST_ATTACH (Fcons (Qt, symbol));
723 definition = Ffset (symbol, definition);
724 LOADHIST_ATTACH (symbol);
725 if (!NILP (docstring))
726 Fput (symbol, Qfunction_documentation, docstring);
727 return definition;
730 DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
731 doc: /* Set SYMBOL's property list to NEWVAL, and return NEWVAL. */)
732 (symbol, newplist)
733 register Lisp_Object symbol, newplist;
735 CHECK_SYMBOL (symbol);
736 XSYMBOL (symbol)->plist = newplist;
737 return newplist;
740 DEFUN ("subr-arity", Fsubr_arity, Ssubr_arity, 1, 1, 0,
741 doc: /* Return minimum and maximum number of args allowed for SUBR.
742 SUBR must be a built-in function.
743 The returned value is a pair (MIN . MAX). MIN is the minimum number
744 of args. MAX is the maximum number or the symbol `many', for a
745 function with `&rest' args, or `unevalled' for a special form. */)
746 (subr)
747 Lisp_Object subr;
749 short minargs, maxargs;
750 if (!SUBRP (subr))
751 wrong_type_argument (Qsubrp, subr);
752 minargs = XSUBR (subr)->min_args;
753 maxargs = XSUBR (subr)->max_args;
754 if (maxargs == MANY)
755 return Fcons (make_number (minargs), Qmany);
756 else if (maxargs == UNEVALLED)
757 return Fcons (make_number (minargs), Qunevalled);
758 else
759 return Fcons (make_number (minargs), make_number (maxargs));
762 DEFUN ("subr-interactive-form", Fsubr_interactive_form, Ssubr_interactive_form, 1, 1, 0,
763 doc: /* Return the interactive form of SUBR or nil if none.
764 SUBR must be a built-in function. Value, if non-nil, is a list
765 \(interactive SPEC). */)
766 (subr)
767 Lisp_Object subr;
769 if (!SUBRP (subr))
770 wrong_type_argument (Qsubrp, subr);
771 if (XSUBR (subr)->prompt)
772 return list2 (Qinteractive, build_string (XSUBR (subr)->prompt));
773 return Qnil;
777 /***********************************************************************
778 Getting and Setting Values of Symbols
779 ***********************************************************************/
781 /* Return the symbol holding SYMBOL's value. Signal
782 `cyclic-variable-indirection' if SYMBOL's chain of variable
783 indirections contains a loop. */
785 Lisp_Object
786 indirect_variable (symbol)
787 Lisp_Object symbol;
789 Lisp_Object tortoise, hare;
791 hare = tortoise = symbol;
793 while (XSYMBOL (hare)->indirect_variable)
795 hare = XSYMBOL (hare)->value;
796 if (!XSYMBOL (hare)->indirect_variable)
797 break;
799 hare = XSYMBOL (hare)->value;
800 tortoise = XSYMBOL (tortoise)->value;
802 if (EQ (hare, tortoise))
803 Fsignal (Qcyclic_variable_indirection, Fcons (symbol, Qnil));
806 return hare;
810 DEFUN ("indirect-variable", Findirect_variable, Sindirect_variable, 1, 1, 0,
811 doc: /* Return the variable at the end of OBJECT's variable chain.
812 If OBJECT is a symbol, follow all variable indirections and return the final
813 variable. If OBJECT is not a symbol, just return it.
814 Signal a cyclic-variable-indirection error if there is a loop in the
815 variable chain of symbols. */)
816 (object)
817 Lisp_Object object;
819 if (SYMBOLP (object))
820 object = indirect_variable (object);
821 return object;
825 /* Given the raw contents of a symbol value cell,
826 return the Lisp value of the symbol.
827 This does not handle buffer-local variables; use
828 swap_in_symval_forwarding for that. */
830 Lisp_Object
831 do_symval_forwarding (valcontents)
832 register Lisp_Object valcontents;
834 register Lisp_Object val;
835 int offset;
836 if (MISCP (valcontents))
837 switch (XMISCTYPE (valcontents))
839 case Lisp_Misc_Intfwd:
840 XSETINT (val, *XINTFWD (valcontents)->intvar);
841 return val;
843 case Lisp_Misc_Boolfwd:
844 return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
846 case Lisp_Misc_Objfwd:
847 return *XOBJFWD (valcontents)->objvar;
849 case Lisp_Misc_Buffer_Objfwd:
850 offset = XBUFFER_OBJFWD (valcontents)->offset;
851 return PER_BUFFER_VALUE (current_buffer, offset);
853 case Lisp_Misc_Kboard_Objfwd:
854 offset = XKBOARD_OBJFWD (valcontents)->offset;
855 return *(Lisp_Object *)(offset + (char *)current_kboard);
857 return valcontents;
860 /* Store NEWVAL into SYMBOL, where VALCONTENTS is found in the value cell
861 of SYMBOL. If SYMBOL is buffer-local, VALCONTENTS should be the
862 buffer-independent contents of the value cell: forwarded just one
863 step past the buffer-localness.
865 BUF non-zero means set the value in buffer BUF instead of the
866 current buffer. This only plays a role for per-buffer variables. */
868 void
869 store_symval_forwarding (symbol, valcontents, newval, buf)
870 Lisp_Object symbol;
871 register Lisp_Object valcontents, newval;
872 struct buffer *buf;
874 switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
876 case Lisp_Misc:
877 switch (XMISCTYPE (valcontents))
879 case Lisp_Misc_Intfwd:
880 CHECK_NUMBER (newval);
881 *XINTFWD (valcontents)->intvar = XINT (newval);
882 if (*XINTFWD (valcontents)->intvar != XINT (newval))
883 error ("Value out of range for variable `%s'",
884 SDATA (SYMBOL_NAME (symbol)));
885 break;
887 case Lisp_Misc_Boolfwd:
888 *XBOOLFWD (valcontents)->boolvar = NILP (newval) ? 0 : 1;
889 break;
891 case Lisp_Misc_Objfwd:
892 *XOBJFWD (valcontents)->objvar = newval;
893 break;
895 case Lisp_Misc_Buffer_Objfwd:
897 int offset = XBUFFER_OBJFWD (valcontents)->offset;
898 Lisp_Object type;
900 type = PER_BUFFER_TYPE (offset);
901 if (! NILP (type) && ! NILP (newval)
902 && XTYPE (newval) != XINT (type))
903 buffer_slot_type_mismatch (offset);
905 if (buf == NULL)
906 buf = current_buffer;
907 PER_BUFFER_VALUE (buf, offset) = newval;
909 break;
911 case Lisp_Misc_Kboard_Objfwd:
913 char *base = (char *) current_kboard;
914 char *p = base + XKBOARD_OBJFWD (valcontents)->offset;
915 *(Lisp_Object *) p = newval;
917 break;
919 default:
920 goto def;
922 break;
924 default:
925 def:
926 valcontents = SYMBOL_VALUE (symbol);
927 if (BUFFER_LOCAL_VALUEP (valcontents)
928 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
929 XBUFFER_LOCAL_VALUE (valcontents)->realvalue = newval;
930 else
931 SET_SYMBOL_VALUE (symbol, newval);
935 /* Set up SYMBOL to refer to its global binding.
936 This makes it safe to alter the status of other bindings. */
938 void
939 swap_in_global_binding (symbol)
940 Lisp_Object symbol;
942 Lisp_Object valcontents, cdr;
944 valcontents = SYMBOL_VALUE (symbol);
945 if (!BUFFER_LOCAL_VALUEP (valcontents)
946 && !SOME_BUFFER_LOCAL_VALUEP (valcontents))
947 abort ();
948 cdr = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
950 /* Unload the previously loaded binding. */
951 Fsetcdr (XCAR (cdr),
952 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
954 /* Select the global binding in the symbol. */
955 XSETCAR (cdr, cdr);
956 store_symval_forwarding (symbol, valcontents, XCDR (cdr), NULL);
958 /* Indicate that the global binding is set up now. */
959 XBUFFER_LOCAL_VALUE (valcontents)->frame = Qnil;
960 XBUFFER_LOCAL_VALUE (valcontents)->buffer = Qnil;
961 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
962 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
965 /* Set up the buffer-local symbol SYMBOL for validity in the current buffer.
966 VALCONTENTS is the contents of its value cell,
967 which points to a struct Lisp_Buffer_Local_Value.
969 Return the value forwarded one step past the buffer-local stage.
970 This could be another forwarding pointer. */
972 static Lisp_Object
973 swap_in_symval_forwarding (symbol, valcontents)
974 Lisp_Object symbol, valcontents;
976 register Lisp_Object tem1;
978 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->buffer;
980 if (NILP (tem1)
981 || current_buffer != XBUFFER (tem1)
982 || (XBUFFER_LOCAL_VALUE (valcontents)->check_frame
983 && ! EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame)))
985 if (XSYMBOL (symbol)->indirect_variable)
986 symbol = indirect_variable (symbol);
988 /* Unload the previously loaded binding. */
989 tem1 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
990 Fsetcdr (tem1,
991 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
992 /* Choose the new binding. */
993 tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
994 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
995 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
996 if (NILP (tem1))
998 if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
999 tem1 = assq_no_quit (symbol, XFRAME (selected_frame)->param_alist);
1000 if (! NILP (tem1))
1001 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 1;
1002 else
1003 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
1005 else
1006 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 1;
1008 /* Load the new binding. */
1009 XSETCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr, tem1);
1010 XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, current_buffer);
1011 XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
1012 store_symval_forwarding (symbol,
1013 XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1014 Fcdr (tem1), NULL);
1016 return XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
1019 /* Find the value of a symbol, returning Qunbound if it's not bound.
1020 This is helpful for code which just wants to get a variable's value
1021 if it has one, without signaling an error.
1022 Note that it must not be possible to quit
1023 within this function. Great care is required for this. */
1025 Lisp_Object
1026 find_symbol_value (symbol)
1027 Lisp_Object symbol;
1029 register Lisp_Object valcontents;
1030 register Lisp_Object val;
1032 CHECK_SYMBOL (symbol);
1033 valcontents = SYMBOL_VALUE (symbol);
1035 if (BUFFER_LOCAL_VALUEP (valcontents)
1036 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1037 valcontents = swap_in_symval_forwarding (symbol, valcontents);
1039 if (MISCP (valcontents))
1041 switch (XMISCTYPE (valcontents))
1043 case Lisp_Misc_Intfwd:
1044 XSETINT (val, *XINTFWD (valcontents)->intvar);
1045 return val;
1047 case Lisp_Misc_Boolfwd:
1048 return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
1050 case Lisp_Misc_Objfwd:
1051 return *XOBJFWD (valcontents)->objvar;
1053 case Lisp_Misc_Buffer_Objfwd:
1054 return PER_BUFFER_VALUE (current_buffer,
1055 XBUFFER_OBJFWD (valcontents)->offset);
1057 case Lisp_Misc_Kboard_Objfwd:
1058 return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
1059 + (char *)current_kboard);
1063 return valcontents;
1066 DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
1067 doc: /* Return SYMBOL's value. Error if that is void. */)
1068 (symbol)
1069 Lisp_Object symbol;
1071 Lisp_Object val;
1073 val = find_symbol_value (symbol);
1074 if (EQ (val, Qunbound))
1075 return Fsignal (Qvoid_variable, Fcons (symbol, Qnil));
1076 else
1077 return val;
1080 DEFUN ("set", Fset, Sset, 2, 2, 0,
1081 doc: /* Set SYMBOL's value to NEWVAL, and return NEWVAL. */)
1082 (symbol, newval)
1083 register Lisp_Object symbol, newval;
1085 return set_internal (symbol, newval, current_buffer, 0);
1088 /* Return 1 if SYMBOL currently has a let-binding
1089 which was made in the buffer that is now current. */
1091 static int
1092 let_shadows_buffer_binding_p (symbol)
1093 Lisp_Object symbol;
1095 volatile struct specbinding *p;
1097 for (p = specpdl_ptr - 1; p >= specpdl; p--)
1098 if (p->func == NULL
1099 && CONSP (p->symbol))
1101 Lisp_Object let_bound_symbol = XCAR (p->symbol);
1102 if ((EQ (symbol, let_bound_symbol)
1103 || (XSYMBOL (let_bound_symbol)->indirect_variable
1104 && EQ (symbol, indirect_variable (let_bound_symbol))))
1105 && XBUFFER (XCDR (XCDR (p->symbol))) == current_buffer)
1106 break;
1109 return p >= specpdl;
1112 /* Store the value NEWVAL into SYMBOL.
1113 If buffer-locality is an issue, BUF specifies which buffer to use.
1114 (0 stands for the current buffer.)
1116 If BINDFLAG is zero, then if this symbol is supposed to become
1117 local in every buffer where it is set, then we make it local.
1118 If BINDFLAG is nonzero, we don't do that. */
1120 Lisp_Object
1121 set_internal (symbol, newval, buf, bindflag)
1122 register Lisp_Object symbol, newval;
1123 struct buffer *buf;
1124 int bindflag;
1126 int voide = EQ (newval, Qunbound);
1128 register Lisp_Object valcontents, innercontents, tem1, current_alist_element;
1130 if (buf == 0)
1131 buf = current_buffer;
1133 /* If restoring in a dead buffer, do nothing. */
1134 if (NILP (buf->name))
1135 return newval;
1137 CHECK_SYMBOL (symbol);
1138 if (SYMBOL_CONSTANT_P (symbol)
1139 && (NILP (Fkeywordp (symbol))
1140 || !EQ (newval, SYMBOL_VALUE (symbol))))
1141 return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
1143 innercontents = valcontents = SYMBOL_VALUE (symbol);
1145 if (BUFFER_OBJFWDP (valcontents))
1147 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1148 int idx = PER_BUFFER_IDX (offset);
1149 if (idx > 0
1150 && !bindflag
1151 && !let_shadows_buffer_binding_p (symbol))
1152 SET_PER_BUFFER_VALUE_P (buf, idx, 1);
1154 else if (BUFFER_LOCAL_VALUEP (valcontents)
1155 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1157 /* valcontents is a struct Lisp_Buffer_Local_Value. */
1158 if (XSYMBOL (symbol)->indirect_variable)
1159 symbol = indirect_variable (symbol);
1161 /* What binding is loaded right now? */
1162 current_alist_element
1163 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1165 /* If the current buffer is not the buffer whose binding is
1166 loaded, or if there may be frame-local bindings and the frame
1167 isn't the right one, or if it's a Lisp_Buffer_Local_Value and
1168 the default binding is loaded, the loaded binding may be the
1169 wrong one. */
1170 if (!BUFFERP (XBUFFER_LOCAL_VALUE (valcontents)->buffer)
1171 || buf != XBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer)
1172 || (XBUFFER_LOCAL_VALUE (valcontents)->check_frame
1173 && !EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame))
1174 || (BUFFER_LOCAL_VALUEP (valcontents)
1175 && EQ (XCAR (current_alist_element),
1176 current_alist_element)))
1178 /* The currently loaded binding is not necessarily valid.
1179 We need to unload it, and choose a new binding. */
1181 /* Write out `realvalue' to the old loaded binding. */
1182 Fsetcdr (current_alist_element,
1183 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
1185 /* Find the new binding. */
1186 tem1 = Fassq (symbol, buf->local_var_alist);
1187 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 1;
1188 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
1190 if (NILP (tem1))
1192 /* This buffer still sees the default value. */
1194 /* If the variable is a Lisp_Some_Buffer_Local_Value,
1195 or if this is `let' rather than `set',
1196 make CURRENT-ALIST-ELEMENT point to itself,
1197 indicating that we're seeing the default value.
1198 Likewise if the variable has been let-bound
1199 in the current buffer. */
1200 if (bindflag || SOME_BUFFER_LOCAL_VALUEP (valcontents)
1201 || let_shadows_buffer_binding_p (symbol))
1203 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1205 if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
1206 tem1 = Fassq (symbol,
1207 XFRAME (selected_frame)->param_alist);
1209 if (! NILP (tem1))
1210 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 1;
1211 else
1212 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
1214 /* If it's a Lisp_Buffer_Local_Value, being set not bound,
1215 and we're not within a let that was made for this buffer,
1216 create a new buffer-local binding for the variable.
1217 That means, give this buffer a new assoc for a local value
1218 and load that binding. */
1219 else
1221 tem1 = Fcons (symbol, XCDR (current_alist_element));
1222 buf->local_var_alist
1223 = Fcons (tem1, buf->local_var_alist);
1227 /* Record which binding is now loaded. */
1228 XSETCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr,
1229 tem1);
1231 /* Set `buffer' and `frame' slots for thebinding now loaded. */
1232 XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, buf);
1233 XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
1235 innercontents = XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
1238 /* If storing void (making the symbol void), forward only through
1239 buffer-local indicator, not through Lisp_Objfwd, etc. */
1240 if (voide)
1241 store_symval_forwarding (symbol, Qnil, newval, buf);
1242 else
1243 store_symval_forwarding (symbol, innercontents, newval, buf);
1245 /* If we just set a variable whose current binding is frame-local,
1246 store the new value in the frame parameter too. */
1248 if (BUFFER_LOCAL_VALUEP (valcontents)
1249 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1251 /* What binding is loaded right now? */
1252 current_alist_element
1253 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1255 /* If the current buffer is not the buffer whose binding is
1256 loaded, or if there may be frame-local bindings and the frame
1257 isn't the right one, or if it's a Lisp_Buffer_Local_Value and
1258 the default binding is loaded, the loaded binding may be the
1259 wrong one. */
1260 if (XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame)
1261 XSETCDR (current_alist_element, newval);
1264 return newval;
1267 /* Access or set a buffer-local symbol's default value. */
1269 /* Return the default value of SYMBOL, but don't check for voidness.
1270 Return Qunbound if it is void. */
1272 Lisp_Object
1273 default_value (symbol)
1274 Lisp_Object symbol;
1276 register Lisp_Object valcontents;
1278 CHECK_SYMBOL (symbol);
1279 valcontents = SYMBOL_VALUE (symbol);
1281 /* For a built-in buffer-local variable, get the default value
1282 rather than letting do_symval_forwarding get the current value. */
1283 if (BUFFER_OBJFWDP (valcontents))
1285 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1286 if (PER_BUFFER_IDX (offset) != 0)
1287 return PER_BUFFER_DEFAULT (offset);
1290 /* Handle user-created local variables. */
1291 if (BUFFER_LOCAL_VALUEP (valcontents)
1292 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1294 /* If var is set up for a buffer that lacks a local value for it,
1295 the current value is nominally the default value.
1296 But the `realvalue' slot may be more up to date, since
1297 ordinary setq stores just that slot. So use that. */
1298 Lisp_Object current_alist_element, alist_element_car;
1299 current_alist_element
1300 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1301 alist_element_car = XCAR (current_alist_element);
1302 if (EQ (alist_element_car, current_alist_element))
1303 return do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue);
1304 else
1305 return XCDR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1307 /* For other variables, get the current value. */
1308 return do_symval_forwarding (valcontents);
1311 DEFUN ("default-boundp", Fdefault_boundp, Sdefault_boundp, 1, 1, 0,
1312 doc: /* Return t if SYMBOL has a non-void default value.
1313 This is the value that is seen in buffers that do not have their own values
1314 for this variable. */)
1315 (symbol)
1316 Lisp_Object symbol;
1318 register Lisp_Object value;
1320 value = default_value (symbol);
1321 return (EQ (value, Qunbound) ? Qnil : Qt);
1324 DEFUN ("default-value", Fdefault_value, Sdefault_value, 1, 1, 0,
1325 doc: /* Return SYMBOL's default value.
1326 This is the value that is seen in buffers that do not have their own values
1327 for this variable. The default value is meaningful for variables with
1328 local bindings in certain buffers. */)
1329 (symbol)
1330 Lisp_Object symbol;
1332 register Lisp_Object value;
1334 value = default_value (symbol);
1335 if (EQ (value, Qunbound))
1336 return Fsignal (Qvoid_variable, Fcons (symbol, Qnil));
1337 return value;
1340 DEFUN ("set-default", Fset_default, Sset_default, 2, 2, 0,
1341 doc: /* Set SYMBOL's default value to VAL. SYMBOL and VAL are evaluated.
1342 The default value is seen in buffers that do not have their own values
1343 for this variable. */)
1344 (symbol, value)
1345 Lisp_Object symbol, value;
1347 register Lisp_Object valcontents, current_alist_element, alist_element_buffer;
1349 CHECK_SYMBOL (symbol);
1350 valcontents = SYMBOL_VALUE (symbol);
1352 /* Handle variables like case-fold-search that have special slots
1353 in the buffer. Make them work apparently like Lisp_Buffer_Local_Value
1354 variables. */
1355 if (BUFFER_OBJFWDP (valcontents))
1357 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1358 int idx = PER_BUFFER_IDX (offset);
1360 PER_BUFFER_DEFAULT (offset) = value;
1362 /* If this variable is not always local in all buffers,
1363 set it in the buffers that don't nominally have a local value. */
1364 if (idx > 0)
1366 struct buffer *b;
1368 for (b = all_buffers; b; b = b->next)
1369 if (!PER_BUFFER_VALUE_P (b, idx))
1370 PER_BUFFER_VALUE (b, offset) = value;
1372 return value;
1375 if (!BUFFER_LOCAL_VALUEP (valcontents)
1376 && !SOME_BUFFER_LOCAL_VALUEP (valcontents))
1377 return Fset (symbol, value);
1379 /* Store new value into the DEFAULT-VALUE slot. */
1380 XSETCDR (XBUFFER_LOCAL_VALUE (valcontents)->cdr, value);
1382 /* If the default binding is now loaded, set the REALVALUE slot too. */
1383 current_alist_element
1384 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1385 alist_element_buffer = Fcar (current_alist_element);
1386 if (EQ (alist_element_buffer, current_alist_element))
1387 store_symval_forwarding (symbol,
1388 XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1389 value, NULL);
1391 return value;
1394 DEFUN ("setq-default", Fsetq_default, Ssetq_default, 2, UNEVALLED, 0,
1395 doc: /* Set the default value of variable VAR to VALUE.
1396 VAR, the variable name, is literal (not evaluated);
1397 VALUE is an expression: it is evaluated and its value returned.
1398 The default value of a variable is seen in buffers
1399 that do not have their own values for the variable.
1401 More generally, you can use multiple variables and values, as in
1402 (setq-default SYMBOL VALUE SYMBOL VALUE...)
1403 This sets each SYMBOL's default value to the corresponding VALUE.
1404 The VALUE for the Nth SYMBOL can refer to the new default values
1405 of previous SYMs.
1406 usage: (setq-default SYMBOL VALUE [SYMBOL VALUE...]) */)
1407 (args)
1408 Lisp_Object args;
1410 register Lisp_Object args_left;
1411 register Lisp_Object val, symbol;
1412 struct gcpro gcpro1;
1414 if (NILP (args))
1415 return Qnil;
1417 args_left = args;
1418 GCPRO1 (args);
1422 val = Feval (Fcar (Fcdr (args_left)));
1423 symbol = XCAR (args_left);
1424 Fset_default (symbol, val);
1425 args_left = Fcdr (XCDR (args_left));
1427 while (!NILP (args_left));
1429 UNGCPRO;
1430 return val;
1433 /* Lisp functions for creating and removing buffer-local variables. */
1435 DEFUN ("make-variable-buffer-local", Fmake_variable_buffer_local, Smake_variable_buffer_local,
1436 1, 1, "vMake Variable Buffer Local: ",
1437 doc: /* Make VARIABLE become buffer-local whenever it is set.
1438 At any time, the value for the current buffer is in effect,
1439 unless the variable has never been set in this buffer,
1440 in which case the default value is in effect.
1441 Note that binding the variable with `let', or setting it while
1442 a `let'-style binding made in this buffer is in effect,
1443 does not make the variable buffer-local. Return VARIABLE.
1445 The function `default-value' gets the default value and `set-default' sets it. */)
1446 (variable)
1447 register Lisp_Object variable;
1449 register Lisp_Object tem, valcontents, newval;
1451 CHECK_SYMBOL (variable);
1453 valcontents = SYMBOL_VALUE (variable);
1454 if (EQ (variable, Qnil) || EQ (variable, Qt) || KBOARD_OBJFWDP (valcontents))
1455 error ("Symbol %s may not be buffer-local", SDATA (SYMBOL_NAME (variable)));
1457 if (BUFFER_LOCAL_VALUEP (valcontents) || BUFFER_OBJFWDP (valcontents))
1458 return variable;
1459 if (SOME_BUFFER_LOCAL_VALUEP (valcontents))
1461 XMISCTYPE (SYMBOL_VALUE (variable)) = Lisp_Misc_Buffer_Local_Value;
1462 return variable;
1464 if (EQ (valcontents, Qunbound))
1465 SET_SYMBOL_VALUE (variable, Qnil);
1466 tem = Fcons (Qnil, Fsymbol_value (variable));
1467 XSETCAR (tem, tem);
1468 newval = allocate_misc ();
1469 XMISCTYPE (newval) = Lisp_Misc_Buffer_Local_Value;
1470 XBUFFER_LOCAL_VALUE (newval)->realvalue = SYMBOL_VALUE (variable);
1471 XBUFFER_LOCAL_VALUE (newval)->buffer = Fcurrent_buffer ();
1472 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1473 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1474 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1475 XBUFFER_LOCAL_VALUE (newval)->check_frame = 0;
1476 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1477 SET_SYMBOL_VALUE (variable, newval);
1478 return variable;
1481 DEFUN ("make-local-variable", Fmake_local_variable, Smake_local_variable,
1482 1, 1, "vMake Local Variable: ",
1483 doc: /* Make VARIABLE have a separate value in the current buffer.
1484 Other buffers will continue to share a common default value.
1485 \(The buffer-local value of VARIABLE starts out as the same value
1486 VARIABLE previously had. If VARIABLE was void, it remains void.\)
1487 See also `make-variable-buffer-local'. Return VARIABLE.
1489 If the variable is already arranged to become local when set,
1490 this function causes a local value to exist for this buffer,
1491 just as setting the variable would do.
1493 This function returns VARIABLE, and therefore
1494 (set (make-local-variable 'VARIABLE) VALUE-EXP)
1495 works.
1497 Do not use `make-local-variable' to make a hook variable buffer-local.
1498 Instead, use `add-hook' and specify t for the LOCAL argument. */)
1499 (variable)
1500 register Lisp_Object variable;
1502 register Lisp_Object tem, valcontents;
1504 CHECK_SYMBOL (variable);
1506 valcontents = SYMBOL_VALUE (variable);
1507 if (EQ (variable, Qnil) || EQ (variable, Qt) || KBOARD_OBJFWDP (valcontents))
1508 error ("Symbol %s may not be buffer-local", SDATA (SYMBOL_NAME (variable)));
1510 if (BUFFER_LOCAL_VALUEP (valcontents) || BUFFER_OBJFWDP (valcontents))
1512 tem = Fboundp (variable);
1514 /* Make sure the symbol has a local value in this particular buffer,
1515 by setting it to the same value it already has. */
1516 Fset (variable, (EQ (tem, Qt) ? Fsymbol_value (variable) : Qunbound));
1517 return variable;
1519 /* Make sure symbol is set up to hold per-buffer values. */
1520 if (!SOME_BUFFER_LOCAL_VALUEP (valcontents))
1522 Lisp_Object newval;
1523 tem = Fcons (Qnil, do_symval_forwarding (valcontents));
1524 XSETCAR (tem, tem);
1525 newval = allocate_misc ();
1526 XMISCTYPE (newval) = Lisp_Misc_Some_Buffer_Local_Value;
1527 XBUFFER_LOCAL_VALUE (newval)->realvalue = SYMBOL_VALUE (variable);
1528 XBUFFER_LOCAL_VALUE (newval)->buffer = Qnil;
1529 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1530 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1531 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1532 XBUFFER_LOCAL_VALUE (newval)->check_frame = 0;
1533 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1534 SET_SYMBOL_VALUE (variable, newval);;
1536 /* Make sure this buffer has its own value of symbol. */
1537 tem = Fassq (variable, current_buffer->local_var_alist);
1538 if (NILP (tem))
1540 /* Swap out any local binding for some other buffer, and make
1541 sure the current value is permanently recorded, if it's the
1542 default value. */
1543 find_symbol_value (variable);
1545 current_buffer->local_var_alist
1546 = Fcons (Fcons (variable, XCDR (XBUFFER_LOCAL_VALUE (SYMBOL_VALUE (variable))->cdr)),
1547 current_buffer->local_var_alist);
1549 /* Make sure symbol does not think it is set up for this buffer;
1550 force it to look once again for this buffer's value. */
1552 Lisp_Object *pvalbuf;
1554 valcontents = SYMBOL_VALUE (variable);
1556 pvalbuf = &XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1557 if (current_buffer == XBUFFER (*pvalbuf))
1558 *pvalbuf = Qnil;
1559 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1563 /* If the symbol forwards into a C variable, then load the binding
1564 for this buffer now. If C code modifies the variable before we
1565 load the binding in, then that new value will clobber the default
1566 binding the next time we unload it. */
1567 valcontents = XBUFFER_LOCAL_VALUE (SYMBOL_VALUE (variable))->realvalue;
1568 if (INTFWDP (valcontents) || BOOLFWDP (valcontents) || OBJFWDP (valcontents))
1569 swap_in_symval_forwarding (variable, SYMBOL_VALUE (variable));
1571 return variable;
1574 DEFUN ("kill-local-variable", Fkill_local_variable, Skill_local_variable,
1575 1, 1, "vKill Local Variable: ",
1576 doc: /* Make VARIABLE no longer have a separate value in the current buffer.
1577 From now on the default value will apply in this buffer. Return VARIABLE. */)
1578 (variable)
1579 register Lisp_Object variable;
1581 register Lisp_Object tem, valcontents;
1583 CHECK_SYMBOL (variable);
1585 valcontents = SYMBOL_VALUE (variable);
1587 if (BUFFER_OBJFWDP (valcontents))
1589 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1590 int idx = PER_BUFFER_IDX (offset);
1592 if (idx > 0)
1594 SET_PER_BUFFER_VALUE_P (current_buffer, idx, 0);
1595 PER_BUFFER_VALUE (current_buffer, offset)
1596 = PER_BUFFER_DEFAULT (offset);
1598 return variable;
1601 if (!BUFFER_LOCAL_VALUEP (valcontents)
1602 && !SOME_BUFFER_LOCAL_VALUEP (valcontents))
1603 return variable;
1605 /* Get rid of this buffer's alist element, if any. */
1607 tem = Fassq (variable, current_buffer->local_var_alist);
1608 if (!NILP (tem))
1609 current_buffer->local_var_alist
1610 = Fdelq (tem, current_buffer->local_var_alist);
1612 /* If the symbol is set up with the current buffer's binding
1613 loaded, recompute its value. We have to do it now, or else
1614 forwarded objects won't work right. */
1616 Lisp_Object *pvalbuf, buf;
1617 valcontents = SYMBOL_VALUE (variable);
1618 pvalbuf = &XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1619 XSETBUFFER (buf, current_buffer);
1620 if (EQ (buf, *pvalbuf))
1622 *pvalbuf = Qnil;
1623 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1624 find_symbol_value (variable);
1628 return variable;
1631 /* Lisp functions for creating and removing buffer-local variables. */
1633 DEFUN ("make-variable-frame-local", Fmake_variable_frame_local, Smake_variable_frame_local,
1634 1, 1, "vMake Variable Frame Local: ",
1635 doc: /* Enable VARIABLE to have frame-local bindings.
1636 When a frame-local binding exists in the current frame,
1637 it is in effect whenever the current buffer has no buffer-local binding.
1638 A frame-local binding is actually a frame parameter value;
1639 thus, any given frame has a local binding for VARIABLE if it has
1640 a value for the frame parameter named VARIABLE. Return VARIABLE.
1641 See `modify-frame-parameters' for how to set frame parameters. */)
1642 (variable)
1643 register Lisp_Object variable;
1645 register Lisp_Object tem, valcontents, newval;
1647 CHECK_SYMBOL (variable);
1649 valcontents = SYMBOL_VALUE (variable);
1650 if (EQ (variable, Qnil) || EQ (variable, Qt) || KBOARD_OBJFWDP (valcontents)
1651 || BUFFER_OBJFWDP (valcontents))
1652 error ("Symbol %s may not be frame-local", SDATA (SYMBOL_NAME (variable)));
1654 if (BUFFER_LOCAL_VALUEP (valcontents)
1655 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1657 XBUFFER_LOCAL_VALUE (valcontents)->check_frame = 1;
1658 return variable;
1661 if (EQ (valcontents, Qunbound))
1662 SET_SYMBOL_VALUE (variable, Qnil);
1663 tem = Fcons (Qnil, Fsymbol_value (variable));
1664 XSETCAR (tem, tem);
1665 newval = allocate_misc ();
1666 XMISCTYPE (newval) = Lisp_Misc_Some_Buffer_Local_Value;
1667 XBUFFER_LOCAL_VALUE (newval)->realvalue = SYMBOL_VALUE (variable);
1668 XBUFFER_LOCAL_VALUE (newval)->buffer = Qnil;
1669 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1670 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1671 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1672 XBUFFER_LOCAL_VALUE (newval)->check_frame = 1;
1673 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1674 SET_SYMBOL_VALUE (variable, newval);
1675 return variable;
1678 DEFUN ("local-variable-p", Flocal_variable_p, Slocal_variable_p,
1679 1, 2, 0,
1680 doc: /* Non-nil if VARIABLE has a local binding in buffer BUFFER.
1681 BUFFER defaults to the current buffer. */)
1682 (variable, buffer)
1683 register Lisp_Object variable, buffer;
1685 Lisp_Object valcontents;
1686 register struct buffer *buf;
1688 if (NILP (buffer))
1689 buf = current_buffer;
1690 else
1692 CHECK_BUFFER (buffer);
1693 buf = XBUFFER (buffer);
1696 CHECK_SYMBOL (variable);
1698 valcontents = SYMBOL_VALUE (variable);
1699 if (BUFFER_LOCAL_VALUEP (valcontents)
1700 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1702 Lisp_Object tail, elt;
1704 variable = indirect_variable (variable);
1705 for (tail = buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1707 elt = XCAR (tail);
1708 if (EQ (variable, XCAR (elt)))
1709 return Qt;
1712 if (BUFFER_OBJFWDP (valcontents))
1714 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1715 int idx = PER_BUFFER_IDX (offset);
1716 if (idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
1717 return Qt;
1719 return Qnil;
1722 DEFUN ("local-variable-if-set-p", Flocal_variable_if_set_p, Slocal_variable_if_set_p,
1723 1, 2, 0,
1724 doc: /* Non-nil if VARIABLE will be local in buffer BUFFER if it is set there.
1725 BUFFER defaults to the current buffer. */)
1726 (variable, buffer)
1727 register Lisp_Object variable, buffer;
1729 Lisp_Object valcontents;
1730 register struct buffer *buf;
1732 if (NILP (buffer))
1733 buf = current_buffer;
1734 else
1736 CHECK_BUFFER (buffer);
1737 buf = XBUFFER (buffer);
1740 CHECK_SYMBOL (variable);
1742 valcontents = SYMBOL_VALUE (variable);
1744 /* This means that make-variable-buffer-local was done. */
1745 if (BUFFER_LOCAL_VALUEP (valcontents))
1746 return Qt;
1747 /* All these slots become local if they are set. */
1748 if (BUFFER_OBJFWDP (valcontents))
1749 return Qt;
1750 if (SOME_BUFFER_LOCAL_VALUEP (valcontents))
1752 Lisp_Object tail, elt;
1753 for (tail = buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1755 elt = XCAR (tail);
1756 if (EQ (variable, XCAR (elt)))
1757 return Qt;
1760 return Qnil;
1763 /* Find the function at the end of a chain of symbol function indirections. */
1765 /* If OBJECT is a symbol, find the end of its function chain and
1766 return the value found there. If OBJECT is not a symbol, just
1767 return it. If there is a cycle in the function chain, signal a
1768 cyclic-function-indirection error.
1770 This is like Findirect_function, except that it doesn't signal an
1771 error if the chain ends up unbound. */
1772 Lisp_Object
1773 indirect_function (object)
1774 register Lisp_Object object;
1776 Lisp_Object tortoise, hare;
1778 hare = tortoise = object;
1780 for (;;)
1782 if (!SYMBOLP (hare) || EQ (hare, Qunbound))
1783 break;
1784 hare = XSYMBOL (hare)->function;
1785 if (!SYMBOLP (hare) || EQ (hare, Qunbound))
1786 break;
1787 hare = XSYMBOL (hare)->function;
1789 tortoise = XSYMBOL (tortoise)->function;
1791 if (EQ (hare, tortoise))
1792 Fsignal (Qcyclic_function_indirection, Fcons (object, Qnil));
1795 return hare;
1798 DEFUN ("indirect-function", Findirect_function, Sindirect_function, 1, 1, 0,
1799 doc: /* Return the function at the end of OBJECT's function chain.
1800 If OBJECT is a symbol, follow all function indirections and return the final
1801 function binding.
1802 If OBJECT is not a symbol, just return it.
1803 Signal a void-function error if the final symbol is unbound.
1804 Signal a cyclic-function-indirection error if there is a loop in the
1805 function chain of symbols. */)
1806 (object)
1807 register Lisp_Object object;
1809 Lisp_Object result;
1811 result = indirect_function (object);
1813 if (EQ (result, Qunbound))
1814 return Fsignal (Qvoid_function, Fcons (object, Qnil));
1815 return result;
1818 /* Extract and set vector and string elements */
1820 DEFUN ("aref", Faref, Saref, 2, 2, 0,
1821 doc: /* Return the element of ARRAY at index IDX.
1822 ARRAY may be a vector, a string, a char-table, a bool-vector,
1823 or a byte-code object. IDX starts at 0. */)
1824 (array, idx)
1825 register Lisp_Object array;
1826 Lisp_Object idx;
1828 register int idxval;
1830 CHECK_NUMBER (idx);
1831 idxval = XINT (idx);
1832 if (STRINGP (array))
1834 int c, idxval_byte;
1836 if (idxval < 0 || idxval >= SCHARS (array))
1837 args_out_of_range (array, idx);
1838 if (! STRING_MULTIBYTE (array))
1839 return make_number ((unsigned char) SREF (array, idxval));
1840 idxval_byte = string_char_to_byte (array, idxval);
1842 c = STRING_CHAR (SDATA (array) + idxval_byte,
1843 SBYTES (array) - idxval_byte);
1844 return make_number (c);
1846 else if (BOOL_VECTOR_P (array))
1848 int val;
1850 if (idxval < 0 || idxval >= XBOOL_VECTOR (array)->size)
1851 args_out_of_range (array, idx);
1853 val = (unsigned char) XBOOL_VECTOR (array)->data[idxval / BITS_PER_CHAR];
1854 return (val & (1 << (idxval % BITS_PER_CHAR)) ? Qt : Qnil);
1856 else if (CHAR_TABLE_P (array))
1858 Lisp_Object val;
1860 val = Qnil;
1862 if (idxval < 0)
1863 args_out_of_range (array, idx);
1864 if (idxval < CHAR_TABLE_ORDINARY_SLOTS)
1866 /* For ASCII and 8-bit European characters, the element is
1867 stored in the top table. */
1868 val = XCHAR_TABLE (array)->contents[idxval];
1869 if (NILP (val))
1870 val = XCHAR_TABLE (array)->defalt;
1871 while (NILP (val)) /* Follow parents until we find some value. */
1873 array = XCHAR_TABLE (array)->parent;
1874 if (NILP (array))
1875 return Qnil;
1876 val = XCHAR_TABLE (array)->contents[idxval];
1877 if (NILP (val))
1878 val = XCHAR_TABLE (array)->defalt;
1880 return val;
1882 else
1884 int code[4], i;
1885 Lisp_Object sub_table;
1887 SPLIT_CHAR (idxval, code[0], code[1], code[2]);
1888 if (code[1] < 32) code[1] = -1;
1889 else if (code[2] < 32) code[2] = -1;
1891 /* Here, the possible range of CODE[0] (== charset ID) is
1892 128..MAX_CHARSET. Since the top level char table contains
1893 data for multibyte characters after 256th element, we must
1894 increment CODE[0] by 128 to get a correct index. */
1895 code[0] += 128;
1896 code[3] = -1; /* anchor */
1898 try_parent_char_table:
1899 sub_table = array;
1900 for (i = 0; code[i] >= 0; i++)
1902 val = XCHAR_TABLE (sub_table)->contents[code[i]];
1903 if (SUB_CHAR_TABLE_P (val))
1904 sub_table = val;
1905 else
1907 if (NILP (val))
1908 val = XCHAR_TABLE (sub_table)->defalt;
1909 if (NILP (val))
1911 array = XCHAR_TABLE (array)->parent;
1912 if (!NILP (array))
1913 goto try_parent_char_table;
1915 return val;
1918 /* Here, VAL is a sub char table. We try the default value
1919 and parent. */
1920 val = XCHAR_TABLE (val)->defalt;
1921 if (NILP (val))
1923 array = XCHAR_TABLE (array)->parent;
1924 if (!NILP (array))
1925 goto try_parent_char_table;
1927 return val;
1930 else
1932 int size = 0;
1933 if (VECTORP (array))
1934 size = XVECTOR (array)->size;
1935 else if (COMPILEDP (array))
1936 size = XVECTOR (array)->size & PSEUDOVECTOR_SIZE_MASK;
1937 else
1938 wrong_type_argument (Qarrayp, array);
1940 if (idxval < 0 || idxval >= size)
1941 args_out_of_range (array, idx);
1942 return XVECTOR (array)->contents[idxval];
1946 /* Don't use alloca for relocating string data larger than this, lest
1947 we overflow their stack. The value is the same as what used in
1948 fns.c for base64 handling. */
1949 #define MAX_ALLOCA 16*1024
1951 DEFUN ("aset", Faset, Saset, 3, 3, 0,
1952 doc: /* Store into the element of ARRAY at index IDX the value NEWELT.
1953 Return NEWELT. ARRAY may be a vector, a string, a char-table or a
1954 bool-vector. IDX starts at 0. */)
1955 (array, idx, newelt)
1956 register Lisp_Object array;
1957 Lisp_Object idx, newelt;
1959 register int idxval;
1961 CHECK_NUMBER (idx);
1962 idxval = XINT (idx);
1963 if (!VECTORP (array) && !STRINGP (array) && !BOOL_VECTOR_P (array)
1964 && ! CHAR_TABLE_P (array))
1965 array = wrong_type_argument (Qarrayp, array);
1966 CHECK_IMPURE (array);
1968 if (VECTORP (array))
1970 if (idxval < 0 || idxval >= XVECTOR (array)->size)
1971 args_out_of_range (array, idx);
1972 XVECTOR (array)->contents[idxval] = newelt;
1974 else if (BOOL_VECTOR_P (array))
1976 int val;
1978 if (idxval < 0 || idxval >= XBOOL_VECTOR (array)->size)
1979 args_out_of_range (array, idx);
1981 val = (unsigned char) XBOOL_VECTOR (array)->data[idxval / BITS_PER_CHAR];
1983 if (! NILP (newelt))
1984 val |= 1 << (idxval % BITS_PER_CHAR);
1985 else
1986 val &= ~(1 << (idxval % BITS_PER_CHAR));
1987 XBOOL_VECTOR (array)->data[idxval / BITS_PER_CHAR] = val;
1989 else if (CHAR_TABLE_P (array))
1991 if (idxval < 0)
1992 args_out_of_range (array, idx);
1993 if (idxval < CHAR_TABLE_ORDINARY_SLOTS)
1994 XCHAR_TABLE (array)->contents[idxval] = newelt;
1995 else
1997 int code[4], i;
1998 Lisp_Object val;
2000 SPLIT_CHAR (idxval, code[0], code[1], code[2]);
2001 if (code[1] < 32) code[1] = -1;
2002 else if (code[2] < 32) code[2] = -1;
2004 /* See the comment of the corresponding part in Faref. */
2005 code[0] += 128;
2006 code[3] = -1; /* anchor */
2007 for (i = 0; code[i + 1] >= 0; i++)
2009 val = XCHAR_TABLE (array)->contents[code[i]];
2010 if (SUB_CHAR_TABLE_P (val))
2011 array = val;
2012 else
2014 Lisp_Object temp;
2016 /* VAL is a leaf. Create a sub char table with the
2017 default value VAL or XCHAR_TABLE (array)->defalt
2018 and look into it. */
2020 temp = make_sub_char_table (NILP (val)
2021 ? XCHAR_TABLE (array)->defalt
2022 : val);
2023 XCHAR_TABLE (array)->contents[code[i]] = temp;
2024 array = temp;
2027 XCHAR_TABLE (array)->contents[code[i]] = newelt;
2030 else if (STRING_MULTIBYTE (array))
2032 int idxval_byte, prev_bytes, new_bytes, nbytes;
2033 unsigned char workbuf[MAX_MULTIBYTE_LENGTH], *p0 = workbuf, *p1;
2035 if (idxval < 0 || idxval >= SCHARS (array))
2036 args_out_of_range (array, idx);
2037 CHECK_NUMBER (newelt);
2039 nbytes = SBYTES (array);
2041 idxval_byte = string_char_to_byte (array, idxval);
2042 p1 = SDATA (array) + idxval_byte;
2043 PARSE_MULTIBYTE_SEQ (p1, nbytes - idxval_byte, prev_bytes);
2044 new_bytes = CHAR_STRING (XINT (newelt), p0);
2045 if (prev_bytes != new_bytes)
2047 /* We must relocate the string data. */
2048 int nchars = SCHARS (array);
2049 unsigned char *str;
2051 str = (nbytes <= MAX_ALLOCA
2052 ? (unsigned char *) alloca (nbytes)
2053 : (unsigned char *) xmalloc (nbytes));
2054 bcopy (SDATA (array), str, nbytes);
2055 allocate_string_data (XSTRING (array), nchars,
2056 nbytes + new_bytes - prev_bytes);
2057 bcopy (str, SDATA (array), idxval_byte);
2058 p1 = SDATA (array) + idxval_byte;
2059 bcopy (str + idxval_byte + prev_bytes, p1 + new_bytes,
2060 nbytes - (idxval_byte + prev_bytes));
2061 if (nbytes > MAX_ALLOCA)
2062 xfree (str);
2063 clear_string_char_byte_cache ();
2065 while (new_bytes--)
2066 *p1++ = *p0++;
2068 else
2070 if (idxval < 0 || idxval >= SCHARS (array))
2071 args_out_of_range (array, idx);
2072 CHECK_NUMBER (newelt);
2074 if (XINT (newelt) < 0 || SINGLE_BYTE_CHAR_P (XINT (newelt)))
2075 SSET (array, idxval, XINT (newelt));
2076 else
2078 /* We must relocate the string data while converting it to
2079 multibyte. */
2080 int idxval_byte, prev_bytes, new_bytes;
2081 unsigned char workbuf[MAX_MULTIBYTE_LENGTH], *p0 = workbuf, *p1;
2082 unsigned char *origstr = SDATA (array), *str;
2083 int nchars, nbytes;
2085 nchars = SCHARS (array);
2086 nbytes = idxval_byte = count_size_as_multibyte (origstr, idxval);
2087 nbytes += count_size_as_multibyte (origstr + idxval,
2088 nchars - idxval);
2089 str = (nbytes <= MAX_ALLOCA
2090 ? (unsigned char *) alloca (nbytes)
2091 : (unsigned char *) xmalloc (nbytes));
2092 copy_text (SDATA (array), str, nchars, 0, 1);
2093 PARSE_MULTIBYTE_SEQ (str + idxval_byte, nbytes - idxval_byte,
2094 prev_bytes);
2095 new_bytes = CHAR_STRING (XINT (newelt), p0);
2096 allocate_string_data (XSTRING (array), nchars,
2097 nbytes + new_bytes - prev_bytes);
2098 bcopy (str, SDATA (array), idxval_byte);
2099 p1 = SDATA (array) + idxval_byte;
2100 while (new_bytes--)
2101 *p1++ = *p0++;
2102 bcopy (str + idxval_byte + prev_bytes, p1,
2103 nbytes - (idxval_byte + prev_bytes));
2104 if (nbytes > MAX_ALLOCA)
2105 xfree (str);
2106 clear_string_char_byte_cache ();
2110 return newelt;
2113 /* Arithmetic functions */
2115 enum comparison { equal, notequal, less, grtr, less_or_equal, grtr_or_equal };
2117 Lisp_Object
2118 arithcompare (num1, num2, comparison)
2119 Lisp_Object num1, num2;
2120 enum comparison comparison;
2122 double f1 = 0, f2 = 0;
2123 int floatp = 0;
2125 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num1);
2126 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num2);
2128 if (FLOATP (num1) || FLOATP (num2))
2130 floatp = 1;
2131 f1 = (FLOATP (num1)) ? XFLOAT_DATA (num1) : XINT (num1);
2132 f2 = (FLOATP (num2)) ? XFLOAT_DATA (num2) : XINT (num2);
2135 switch (comparison)
2137 case equal:
2138 if (floatp ? f1 == f2 : XINT (num1) == XINT (num2))
2139 return Qt;
2140 return Qnil;
2142 case notequal:
2143 if (floatp ? f1 != f2 : XINT (num1) != XINT (num2))
2144 return Qt;
2145 return Qnil;
2147 case less:
2148 if (floatp ? f1 < f2 : XINT (num1) < XINT (num2))
2149 return Qt;
2150 return Qnil;
2152 case less_or_equal:
2153 if (floatp ? f1 <= f2 : XINT (num1) <= XINT (num2))
2154 return Qt;
2155 return Qnil;
2157 case grtr:
2158 if (floatp ? f1 > f2 : XINT (num1) > XINT (num2))
2159 return Qt;
2160 return Qnil;
2162 case grtr_or_equal:
2163 if (floatp ? f1 >= f2 : XINT (num1) >= XINT (num2))
2164 return Qt;
2165 return Qnil;
2167 default:
2168 abort ();
2172 DEFUN ("=", Feqlsign, Seqlsign, 2, 2, 0,
2173 doc: /* Return t if two args, both numbers or markers, are equal. */)
2174 (num1, num2)
2175 register Lisp_Object num1, num2;
2177 return arithcompare (num1, num2, equal);
2180 DEFUN ("<", Flss, Slss, 2, 2, 0,
2181 doc: /* Return t if first arg is less than second arg. Both must be numbers or markers. */)
2182 (num1, num2)
2183 register Lisp_Object num1, num2;
2185 return arithcompare (num1, num2, less);
2188 DEFUN (">", Fgtr, Sgtr, 2, 2, 0,
2189 doc: /* Return t if first arg is greater than second arg. Both must be numbers or markers. */)
2190 (num1, num2)
2191 register Lisp_Object num1, num2;
2193 return arithcompare (num1, num2, grtr);
2196 DEFUN ("<=", Fleq, Sleq, 2, 2, 0,
2197 doc: /* Return t if first arg is less than or equal to second arg.
2198 Both must be numbers or markers. */)
2199 (num1, num2)
2200 register Lisp_Object num1, num2;
2202 return arithcompare (num1, num2, less_or_equal);
2205 DEFUN (">=", Fgeq, Sgeq, 2, 2, 0,
2206 doc: /* Return t if first arg is greater than or equal to second arg.
2207 Both must be numbers or markers. */)
2208 (num1, num2)
2209 register Lisp_Object num1, num2;
2211 return arithcompare (num1, num2, grtr_or_equal);
2214 DEFUN ("/=", Fneq, Sneq, 2, 2, 0,
2215 doc: /* Return t if first arg is not equal to second arg. Both must be numbers or markers. */)
2216 (num1, num2)
2217 register Lisp_Object num1, num2;
2219 return arithcompare (num1, num2, notequal);
2222 DEFUN ("zerop", Fzerop, Szerop, 1, 1, 0,
2223 doc: /* Return t if NUMBER is zero. */)
2224 (number)
2225 register Lisp_Object number;
2227 CHECK_NUMBER_OR_FLOAT (number);
2229 if (FLOATP (number))
2231 if (XFLOAT_DATA (number) == 0.0)
2232 return Qt;
2233 return Qnil;
2236 if (!XINT (number))
2237 return Qt;
2238 return Qnil;
2241 /* Convert between long values and pairs of Lisp integers. */
2243 Lisp_Object
2244 long_to_cons (i)
2245 unsigned long i;
2247 unsigned long top = i >> 16;
2248 unsigned int bot = i & 0xFFFF;
2249 if (top == 0)
2250 return make_number (bot);
2251 if (top == (unsigned long)-1 >> 16)
2252 return Fcons (make_number (-1), make_number (bot));
2253 return Fcons (make_number (top), make_number (bot));
2256 unsigned long
2257 cons_to_long (c)
2258 Lisp_Object c;
2260 Lisp_Object top, bot;
2261 if (INTEGERP (c))
2262 return XINT (c);
2263 top = XCAR (c);
2264 bot = XCDR (c);
2265 if (CONSP (bot))
2266 bot = XCAR (bot);
2267 return ((XINT (top) << 16) | XINT (bot));
2270 DEFUN ("number-to-string", Fnumber_to_string, Snumber_to_string, 1, 1, 0,
2271 doc: /* Return the decimal representation of NUMBER as a string.
2272 Uses a minus sign if negative.
2273 NUMBER may be an integer or a floating point number. */)
2274 (number)
2275 Lisp_Object number;
2277 char buffer[VALBITS];
2279 CHECK_NUMBER_OR_FLOAT (number);
2281 if (FLOATP (number))
2283 char pigbuf[350]; /* see comments in float_to_string */
2285 float_to_string (pigbuf, XFLOAT_DATA (number));
2286 return build_string (pigbuf);
2289 if (sizeof (int) == sizeof (EMACS_INT))
2290 sprintf (buffer, "%d", XINT (number));
2291 else if (sizeof (long) == sizeof (EMACS_INT))
2292 sprintf (buffer, "%ld", (long) XINT (number));
2293 else
2294 abort ();
2295 return build_string (buffer);
2298 INLINE static int
2299 digit_to_number (character, base)
2300 int character, base;
2302 int digit;
2304 if (character >= '0' && character <= '9')
2305 digit = character - '0';
2306 else if (character >= 'a' && character <= 'z')
2307 digit = character - 'a' + 10;
2308 else if (character >= 'A' && character <= 'Z')
2309 digit = character - 'A' + 10;
2310 else
2311 return -1;
2313 if (digit >= base)
2314 return -1;
2315 else
2316 return digit;
2319 DEFUN ("string-to-number", Fstring_to_number, Sstring_to_number, 1, 2, 0,
2320 doc: /* Parse STRING as a decimal number and return the number.
2321 This parses both integers and floating point numbers.
2322 It ignores leading spaces and tabs.
2324 If BASE, interpret STRING as a number in that base. If BASE isn't
2325 present, base 10 is used. BASE must be between 2 and 16 (inclusive).
2326 If the base used is not 10, floating point is not recognized. */)
2327 (string, base)
2328 register Lisp_Object string, base;
2330 register unsigned char *p;
2331 register int b;
2332 int sign = 1;
2333 Lisp_Object val;
2335 CHECK_STRING (string);
2337 if (NILP (base))
2338 b = 10;
2339 else
2341 CHECK_NUMBER (base);
2342 b = XINT (base);
2343 if (b < 2 || b > 16)
2344 Fsignal (Qargs_out_of_range, Fcons (base, Qnil));
2347 /* Skip any whitespace at the front of the number. Some versions of
2348 atoi do this anyway, so we might as well make Emacs lisp consistent. */
2349 p = SDATA (string);
2350 while (*p == ' ' || *p == '\t')
2351 p++;
2353 if (*p == '-')
2355 sign = -1;
2356 p++;
2358 else if (*p == '+')
2359 p++;
2361 if (isfloat_string (p) && b == 10)
2362 val = make_float (sign * atof (p));
2363 else
2365 double v = 0;
2367 while (1)
2369 int digit = digit_to_number (*p++, b);
2370 if (digit < 0)
2371 break;
2372 v = v * b + digit;
2375 val = make_fixnum_or_float (sign * v);
2378 return val;
2382 enum arithop
2384 Aadd,
2385 Asub,
2386 Amult,
2387 Adiv,
2388 Alogand,
2389 Alogior,
2390 Alogxor,
2391 Amax,
2392 Amin
2395 static Lisp_Object float_arith_driver P_ ((double, int, enum arithop,
2396 int, Lisp_Object *));
2397 extern Lisp_Object fmod_float ();
2399 Lisp_Object
2400 arith_driver (code, nargs, args)
2401 enum arithop code;
2402 int nargs;
2403 register Lisp_Object *args;
2405 register Lisp_Object val;
2406 register int argnum;
2407 register EMACS_INT accum = 0;
2408 register EMACS_INT next;
2410 switch (SWITCH_ENUM_CAST (code))
2412 case Alogior:
2413 case Alogxor:
2414 case Aadd:
2415 case Asub:
2416 accum = 0;
2417 break;
2418 case Amult:
2419 accum = 1;
2420 break;
2421 case Alogand:
2422 accum = -1;
2423 break;
2424 default:
2425 break;
2428 for (argnum = 0; argnum < nargs; argnum++)
2430 /* Using args[argnum] as argument to CHECK_NUMBER_... */
2431 val = args[argnum];
2432 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2434 if (FLOATP (val))
2435 return float_arith_driver ((double) accum, argnum, code,
2436 nargs, args);
2437 args[argnum] = val;
2438 next = XINT (args[argnum]);
2439 switch (SWITCH_ENUM_CAST (code))
2441 case Aadd:
2442 accum += next;
2443 break;
2444 case Asub:
2445 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2446 break;
2447 case Amult:
2448 accum *= next;
2449 break;
2450 case Adiv:
2451 if (!argnum)
2452 accum = next;
2453 else
2455 if (next == 0)
2456 Fsignal (Qarith_error, Qnil);
2457 accum /= next;
2459 break;
2460 case Alogand:
2461 accum &= next;
2462 break;
2463 case Alogior:
2464 accum |= next;
2465 break;
2466 case Alogxor:
2467 accum ^= next;
2468 break;
2469 case Amax:
2470 if (!argnum || next > accum)
2471 accum = next;
2472 break;
2473 case Amin:
2474 if (!argnum || next < accum)
2475 accum = next;
2476 break;
2480 XSETINT (val, accum);
2481 return val;
2484 #undef isnan
2485 #define isnan(x) ((x) != (x))
2487 static Lisp_Object
2488 float_arith_driver (accum, argnum, code, nargs, args)
2489 double accum;
2490 register int argnum;
2491 enum arithop code;
2492 int nargs;
2493 register Lisp_Object *args;
2495 register Lisp_Object val;
2496 double next;
2498 for (; argnum < nargs; argnum++)
2500 val = args[argnum]; /* using args[argnum] as argument to CHECK_NUMBER_... */
2501 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2503 if (FLOATP (val))
2505 next = XFLOAT_DATA (val);
2507 else
2509 args[argnum] = val; /* runs into a compiler bug. */
2510 next = XINT (args[argnum]);
2512 switch (SWITCH_ENUM_CAST (code))
2514 case Aadd:
2515 accum += next;
2516 break;
2517 case Asub:
2518 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2519 break;
2520 case Amult:
2521 accum *= next;
2522 break;
2523 case Adiv:
2524 if (!argnum)
2525 accum = next;
2526 else
2528 if (! IEEE_FLOATING_POINT && next == 0)
2529 Fsignal (Qarith_error, Qnil);
2530 accum /= next;
2532 break;
2533 case Alogand:
2534 case Alogior:
2535 case Alogxor:
2536 return wrong_type_argument (Qinteger_or_marker_p, val);
2537 case Amax:
2538 if (!argnum || isnan (next) || next > accum)
2539 accum = next;
2540 break;
2541 case Amin:
2542 if (!argnum || isnan (next) || next < accum)
2543 accum = next;
2544 break;
2548 return make_float (accum);
2552 DEFUN ("+", Fplus, Splus, 0, MANY, 0,
2553 doc: /* Return sum of any number of arguments, which are numbers or markers.
2554 usage: (+ &rest NUMBERS-OR-MARKERS) */)
2555 (nargs, args)
2556 int nargs;
2557 Lisp_Object *args;
2559 return arith_driver (Aadd, nargs, args);
2562 DEFUN ("-", Fminus, Sminus, 0, MANY, 0,
2563 doc: /* Negate number or subtract numbers or markers and return the result.
2564 With one arg, negates it. With more than one arg,
2565 subtracts all but the first from the first.
2566 usage: (- &optional NUMBER-OR-MARKER &rest MORE-NUMBERS-OR-MARKERS) */)
2567 (nargs, args)
2568 int nargs;
2569 Lisp_Object *args;
2571 return arith_driver (Asub, nargs, args);
2574 DEFUN ("*", Ftimes, Stimes, 0, MANY, 0,
2575 doc: /* Return product of any number of arguments, which are numbers or markers.
2576 usage: (* &rest NUMBERS-OR-MARKERS) */)
2577 (nargs, args)
2578 int nargs;
2579 Lisp_Object *args;
2581 return arith_driver (Amult, nargs, args);
2584 DEFUN ("/", Fquo, Squo, 2, MANY, 0,
2585 doc: /* Return first argument divided by all the remaining arguments.
2586 The arguments must be numbers or markers.
2587 usage: (/ DIVIDEND DIVISOR &rest DIVISORS) */)
2588 (nargs, args)
2589 int nargs;
2590 Lisp_Object *args;
2592 return arith_driver (Adiv, nargs, args);
2595 DEFUN ("%", Frem, Srem, 2, 2, 0,
2596 doc: /* Return remainder of X divided by Y.
2597 Both must be integers or markers. */)
2598 (x, y)
2599 register Lisp_Object x, y;
2601 Lisp_Object val;
2603 CHECK_NUMBER_COERCE_MARKER (x);
2604 CHECK_NUMBER_COERCE_MARKER (y);
2606 if (XFASTINT (y) == 0)
2607 Fsignal (Qarith_error, Qnil);
2609 XSETINT (val, XINT (x) % XINT (y));
2610 return val;
2613 #ifndef HAVE_FMOD
2614 double
2615 fmod (f1, f2)
2616 double f1, f2;
2618 double r = f1;
2620 if (f2 < 0.0)
2621 f2 = -f2;
2623 /* If the magnitude of the result exceeds that of the divisor, or
2624 the sign of the result does not agree with that of the dividend,
2625 iterate with the reduced value. This does not yield a
2626 particularly accurate result, but at least it will be in the
2627 range promised by fmod. */
2629 r -= f2 * floor (r / f2);
2630 while (f2 <= (r < 0 ? -r : r) || ((r < 0) != (f1 < 0) && ! isnan (r)));
2632 return r;
2634 #endif /* ! HAVE_FMOD */
2636 DEFUN ("mod", Fmod, Smod, 2, 2, 0,
2637 doc: /* Return X modulo Y.
2638 The result falls between zero (inclusive) and Y (exclusive).
2639 Both X and Y must be numbers or markers. */)
2640 (x, y)
2641 register Lisp_Object x, y;
2643 Lisp_Object val;
2644 EMACS_INT i1, i2;
2646 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (x);
2647 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (y);
2649 if (FLOATP (x) || FLOATP (y))
2650 return fmod_float (x, y);
2652 i1 = XINT (x);
2653 i2 = XINT (y);
2655 if (i2 == 0)
2656 Fsignal (Qarith_error, Qnil);
2658 i1 %= i2;
2660 /* If the "remainder" comes out with the wrong sign, fix it. */
2661 if (i2 < 0 ? i1 > 0 : i1 < 0)
2662 i1 += i2;
2664 XSETINT (val, i1);
2665 return val;
2668 DEFUN ("max", Fmax, Smax, 1, MANY, 0,
2669 doc: /* Return largest of all the arguments (which must be numbers or markers).
2670 The value is always a number; markers are converted to numbers.
2671 usage: (max NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2672 (nargs, args)
2673 int nargs;
2674 Lisp_Object *args;
2676 return arith_driver (Amax, nargs, args);
2679 DEFUN ("min", Fmin, Smin, 1, MANY, 0,
2680 doc: /* Return smallest of all the arguments (which must be numbers or markers).
2681 The value is always a number; markers are converted to numbers.
2682 usage: (min NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2683 (nargs, args)
2684 int nargs;
2685 Lisp_Object *args;
2687 return arith_driver (Amin, nargs, args);
2690 DEFUN ("logand", Flogand, Slogand, 0, MANY, 0,
2691 doc: /* Return bitwise-and of all the arguments.
2692 Arguments may be integers, or markers converted to integers.
2693 usage: (logand &rest INTS-OR-MARKERS) */)
2694 (nargs, args)
2695 int nargs;
2696 Lisp_Object *args;
2698 return arith_driver (Alogand, nargs, args);
2701 DEFUN ("logior", Flogior, Slogior, 0, MANY, 0,
2702 doc: /* Return bitwise-or of all the arguments.
2703 Arguments may be integers, or markers converted to integers.
2704 usage: (logior &rest INTS-OR-MARKERS) */)
2705 (nargs, args)
2706 int nargs;
2707 Lisp_Object *args;
2709 return arith_driver (Alogior, nargs, args);
2712 DEFUN ("logxor", Flogxor, Slogxor, 0, MANY, 0,
2713 doc: /* Return bitwise-exclusive-or of all the arguments.
2714 Arguments may be integers, or markers converted to integers.
2715 usage: (logxor &rest INTS-OR-MARKERS) */)
2716 (nargs, args)
2717 int nargs;
2718 Lisp_Object *args;
2720 return arith_driver (Alogxor, nargs, args);
2723 DEFUN ("ash", Fash, Sash, 2, 2, 0,
2724 doc: /* Return VALUE with its bits shifted left by COUNT.
2725 If COUNT is negative, shifting is actually to the right.
2726 In this case, the sign bit is duplicated. */)
2727 (value, count)
2728 register Lisp_Object value, count;
2730 register Lisp_Object val;
2732 CHECK_NUMBER (value);
2733 CHECK_NUMBER (count);
2735 if (XINT (count) >= BITS_PER_EMACS_INT)
2736 XSETINT (val, 0);
2737 else if (XINT (count) > 0)
2738 XSETINT (val, XINT (value) << XFASTINT (count));
2739 else if (XINT (count) <= -BITS_PER_EMACS_INT)
2740 XSETINT (val, XINT (value) < 0 ? -1 : 0);
2741 else
2742 XSETINT (val, XINT (value) >> -XINT (count));
2743 return val;
2746 DEFUN ("lsh", Flsh, Slsh, 2, 2, 0,
2747 doc: /* Return VALUE with its bits shifted left by COUNT.
2748 If COUNT is negative, shifting is actually to the right.
2749 In this case, zeros are shifted in on the left. */)
2750 (value, count)
2751 register Lisp_Object value, count;
2753 register Lisp_Object val;
2755 CHECK_NUMBER (value);
2756 CHECK_NUMBER (count);
2758 if (XINT (count) >= BITS_PER_EMACS_INT)
2759 XSETINT (val, 0);
2760 else if (XINT (count) > 0)
2761 XSETINT (val, (EMACS_UINT) XUINT (value) << XFASTINT (count));
2762 else if (XINT (count) <= -BITS_PER_EMACS_INT)
2763 XSETINT (val, 0);
2764 else
2765 XSETINT (val, (EMACS_UINT) XUINT (value) >> -XINT (count));
2766 return val;
2769 DEFUN ("1+", Fadd1, Sadd1, 1, 1, 0,
2770 doc: /* Return NUMBER plus one. NUMBER may be a number or a marker.
2771 Markers are converted to integers. */)
2772 (number)
2773 register Lisp_Object number;
2775 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
2777 if (FLOATP (number))
2778 return (make_float (1.0 + XFLOAT_DATA (number)));
2780 XSETINT (number, XINT (number) + 1);
2781 return number;
2784 DEFUN ("1-", Fsub1, Ssub1, 1, 1, 0,
2785 doc: /* Return NUMBER minus one. NUMBER may be a number or a marker.
2786 Markers are converted to integers. */)
2787 (number)
2788 register Lisp_Object number;
2790 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
2792 if (FLOATP (number))
2793 return (make_float (-1.0 + XFLOAT_DATA (number)));
2795 XSETINT (number, XINT (number) - 1);
2796 return number;
2799 DEFUN ("lognot", Flognot, Slognot, 1, 1, 0,
2800 doc: /* Return the bitwise complement of NUMBER. NUMBER must be an integer. */)
2801 (number)
2802 register Lisp_Object number;
2804 CHECK_NUMBER (number);
2805 XSETINT (number, ~XINT (number));
2806 return number;
2809 void
2810 syms_of_data ()
2812 Lisp_Object error_tail, arith_tail;
2814 Qquote = intern ("quote");
2815 Qlambda = intern ("lambda");
2816 Qsubr = intern ("subr");
2817 Qerror_conditions = intern ("error-conditions");
2818 Qerror_message = intern ("error-message");
2819 Qtop_level = intern ("top-level");
2821 Qerror = intern ("error");
2822 Qquit = intern ("quit");
2823 Qwrong_type_argument = intern ("wrong-type-argument");
2824 Qargs_out_of_range = intern ("args-out-of-range");
2825 Qvoid_function = intern ("void-function");
2826 Qcyclic_function_indirection = intern ("cyclic-function-indirection");
2827 Qcyclic_variable_indirection = intern ("cyclic-variable-indirection");
2828 Qvoid_variable = intern ("void-variable");
2829 Qsetting_constant = intern ("setting-constant");
2830 Qinvalid_read_syntax = intern ("invalid-read-syntax");
2832 Qinvalid_function = intern ("invalid-function");
2833 Qwrong_number_of_arguments = intern ("wrong-number-of-arguments");
2834 Qno_catch = intern ("no-catch");
2835 Qend_of_file = intern ("end-of-file");
2836 Qarith_error = intern ("arith-error");
2837 Qbeginning_of_buffer = intern ("beginning-of-buffer");
2838 Qend_of_buffer = intern ("end-of-buffer");
2839 Qbuffer_read_only = intern ("buffer-read-only");
2840 Qtext_read_only = intern ("text-read-only");
2841 Qmark_inactive = intern ("mark-inactive");
2843 Qlistp = intern ("listp");
2844 Qconsp = intern ("consp");
2845 Qsymbolp = intern ("symbolp");
2846 Qkeywordp = intern ("keywordp");
2847 Qintegerp = intern ("integerp");
2848 Qnatnump = intern ("natnump");
2849 Qwholenump = intern ("wholenump");
2850 Qstringp = intern ("stringp");
2851 Qarrayp = intern ("arrayp");
2852 Qsequencep = intern ("sequencep");
2853 Qbufferp = intern ("bufferp");
2854 Qvectorp = intern ("vectorp");
2855 Qchar_or_string_p = intern ("char-or-string-p");
2856 Qmarkerp = intern ("markerp");
2857 Qbuffer_or_string_p = intern ("buffer-or-string-p");
2858 Qinteger_or_marker_p = intern ("integer-or-marker-p");
2859 Qboundp = intern ("boundp");
2860 Qfboundp = intern ("fboundp");
2862 Qfloatp = intern ("floatp");
2863 Qnumberp = intern ("numberp");
2864 Qnumber_or_marker_p = intern ("number-or-marker-p");
2866 Qchar_table_p = intern ("char-table-p");
2867 Qvector_or_char_table_p = intern ("vector-or-char-table-p");
2869 Qsubrp = intern ("subrp");
2870 Qunevalled = intern ("unevalled");
2871 Qmany = intern ("many");
2873 Qcdr = intern ("cdr");
2875 /* Handle automatic advice activation */
2876 Qad_advice_info = intern ("ad-advice-info");
2877 Qad_activate_internal = intern ("ad-activate-internal");
2879 error_tail = Fcons (Qerror, Qnil);
2881 /* ERROR is used as a signaler for random errors for which nothing else is right */
2883 Fput (Qerror, Qerror_conditions,
2884 error_tail);
2885 Fput (Qerror, Qerror_message,
2886 build_string ("error"));
2888 Fput (Qquit, Qerror_conditions,
2889 Fcons (Qquit, Qnil));
2890 Fput (Qquit, Qerror_message,
2891 build_string ("Quit"));
2893 Fput (Qwrong_type_argument, Qerror_conditions,
2894 Fcons (Qwrong_type_argument, error_tail));
2895 Fput (Qwrong_type_argument, Qerror_message,
2896 build_string ("Wrong type argument"));
2898 Fput (Qargs_out_of_range, Qerror_conditions,
2899 Fcons (Qargs_out_of_range, error_tail));
2900 Fput (Qargs_out_of_range, Qerror_message,
2901 build_string ("Args out of range"));
2903 Fput (Qvoid_function, Qerror_conditions,
2904 Fcons (Qvoid_function, error_tail));
2905 Fput (Qvoid_function, Qerror_message,
2906 build_string ("Symbol's function definition is void"));
2908 Fput (Qcyclic_function_indirection, Qerror_conditions,
2909 Fcons (Qcyclic_function_indirection, error_tail));
2910 Fput (Qcyclic_function_indirection, Qerror_message,
2911 build_string ("Symbol's chain of function indirections contains a loop"));
2913 Fput (Qcyclic_variable_indirection, Qerror_conditions,
2914 Fcons (Qcyclic_variable_indirection, error_tail));
2915 Fput (Qcyclic_variable_indirection, Qerror_message,
2916 build_string ("Symbol's chain of variable indirections contains a loop"));
2918 Qcircular_list = intern ("circular-list");
2919 staticpro (&Qcircular_list);
2920 Fput (Qcircular_list, Qerror_conditions,
2921 Fcons (Qcircular_list, error_tail));
2922 Fput (Qcircular_list, Qerror_message,
2923 build_string ("List contains a loop"));
2925 Fput (Qvoid_variable, Qerror_conditions,
2926 Fcons (Qvoid_variable, error_tail));
2927 Fput (Qvoid_variable, Qerror_message,
2928 build_string ("Symbol's value as variable is void"));
2930 Fput (Qsetting_constant, Qerror_conditions,
2931 Fcons (Qsetting_constant, error_tail));
2932 Fput (Qsetting_constant, Qerror_message,
2933 build_string ("Attempt to set a constant symbol"));
2935 Fput (Qinvalid_read_syntax, Qerror_conditions,
2936 Fcons (Qinvalid_read_syntax, error_tail));
2937 Fput (Qinvalid_read_syntax, Qerror_message,
2938 build_string ("Invalid read syntax"));
2940 Fput (Qinvalid_function, Qerror_conditions,
2941 Fcons (Qinvalid_function, error_tail));
2942 Fput (Qinvalid_function, Qerror_message,
2943 build_string ("Invalid function"));
2945 Fput (Qwrong_number_of_arguments, Qerror_conditions,
2946 Fcons (Qwrong_number_of_arguments, error_tail));
2947 Fput (Qwrong_number_of_arguments, Qerror_message,
2948 build_string ("Wrong number of arguments"));
2950 Fput (Qno_catch, Qerror_conditions,
2951 Fcons (Qno_catch, error_tail));
2952 Fput (Qno_catch, Qerror_message,
2953 build_string ("No catch for tag"));
2955 Fput (Qend_of_file, Qerror_conditions,
2956 Fcons (Qend_of_file, error_tail));
2957 Fput (Qend_of_file, Qerror_message,
2958 build_string ("End of file during parsing"));
2960 arith_tail = Fcons (Qarith_error, error_tail);
2961 Fput (Qarith_error, Qerror_conditions,
2962 arith_tail);
2963 Fput (Qarith_error, Qerror_message,
2964 build_string ("Arithmetic error"));
2966 Fput (Qbeginning_of_buffer, Qerror_conditions,
2967 Fcons (Qbeginning_of_buffer, error_tail));
2968 Fput (Qbeginning_of_buffer, Qerror_message,
2969 build_string ("Beginning of buffer"));
2971 Fput (Qend_of_buffer, Qerror_conditions,
2972 Fcons (Qend_of_buffer, error_tail));
2973 Fput (Qend_of_buffer, Qerror_message,
2974 build_string ("End of buffer"));
2976 Fput (Qbuffer_read_only, Qerror_conditions,
2977 Fcons (Qbuffer_read_only, error_tail));
2978 Fput (Qbuffer_read_only, Qerror_message,
2979 build_string ("Buffer is read-only"));
2981 Fput (Qtext_read_only, Qerror_conditions,
2982 Fcons (Qtext_read_only, error_tail));
2983 Fput (Qtext_read_only, Qerror_message,
2984 build_string ("Text is read-only"));
2986 Qrange_error = intern ("range-error");
2987 Qdomain_error = intern ("domain-error");
2988 Qsingularity_error = intern ("singularity-error");
2989 Qoverflow_error = intern ("overflow-error");
2990 Qunderflow_error = intern ("underflow-error");
2992 Fput (Qdomain_error, Qerror_conditions,
2993 Fcons (Qdomain_error, arith_tail));
2994 Fput (Qdomain_error, Qerror_message,
2995 build_string ("Arithmetic domain error"));
2997 Fput (Qrange_error, Qerror_conditions,
2998 Fcons (Qrange_error, arith_tail));
2999 Fput (Qrange_error, Qerror_message,
3000 build_string ("Arithmetic range error"));
3002 Fput (Qsingularity_error, Qerror_conditions,
3003 Fcons (Qsingularity_error, Fcons (Qdomain_error, arith_tail)));
3004 Fput (Qsingularity_error, Qerror_message,
3005 build_string ("Arithmetic singularity error"));
3007 Fput (Qoverflow_error, Qerror_conditions,
3008 Fcons (Qoverflow_error, Fcons (Qdomain_error, arith_tail)));
3009 Fput (Qoverflow_error, Qerror_message,
3010 build_string ("Arithmetic overflow error"));
3012 Fput (Qunderflow_error, Qerror_conditions,
3013 Fcons (Qunderflow_error, Fcons (Qdomain_error, arith_tail)));
3014 Fput (Qunderflow_error, Qerror_message,
3015 build_string ("Arithmetic underflow error"));
3017 staticpro (&Qrange_error);
3018 staticpro (&Qdomain_error);
3019 staticpro (&Qsingularity_error);
3020 staticpro (&Qoverflow_error);
3021 staticpro (&Qunderflow_error);
3023 staticpro (&Qnil);
3024 staticpro (&Qt);
3025 staticpro (&Qquote);
3026 staticpro (&Qlambda);
3027 staticpro (&Qsubr);
3028 staticpro (&Qunbound);
3029 staticpro (&Qerror_conditions);
3030 staticpro (&Qerror_message);
3031 staticpro (&Qtop_level);
3033 staticpro (&Qerror);
3034 staticpro (&Qquit);
3035 staticpro (&Qwrong_type_argument);
3036 staticpro (&Qargs_out_of_range);
3037 staticpro (&Qvoid_function);
3038 staticpro (&Qcyclic_function_indirection);
3039 staticpro (&Qvoid_variable);
3040 staticpro (&Qsetting_constant);
3041 staticpro (&Qinvalid_read_syntax);
3042 staticpro (&Qwrong_number_of_arguments);
3043 staticpro (&Qinvalid_function);
3044 staticpro (&Qno_catch);
3045 staticpro (&Qend_of_file);
3046 staticpro (&Qarith_error);
3047 staticpro (&Qbeginning_of_buffer);
3048 staticpro (&Qend_of_buffer);
3049 staticpro (&Qbuffer_read_only);
3050 staticpro (&Qtext_read_only);
3051 staticpro (&Qmark_inactive);
3053 staticpro (&Qlistp);
3054 staticpro (&Qconsp);
3055 staticpro (&Qsymbolp);
3056 staticpro (&Qkeywordp);
3057 staticpro (&Qintegerp);
3058 staticpro (&Qnatnump);
3059 staticpro (&Qwholenump);
3060 staticpro (&Qstringp);
3061 staticpro (&Qarrayp);
3062 staticpro (&Qsequencep);
3063 staticpro (&Qbufferp);
3064 staticpro (&Qvectorp);
3065 staticpro (&Qchar_or_string_p);
3066 staticpro (&Qmarkerp);
3067 staticpro (&Qbuffer_or_string_p);
3068 staticpro (&Qinteger_or_marker_p);
3069 staticpro (&Qfloatp);
3070 staticpro (&Qnumberp);
3071 staticpro (&Qnumber_or_marker_p);
3072 staticpro (&Qchar_table_p);
3073 staticpro (&Qvector_or_char_table_p);
3074 staticpro (&Qsubrp);
3075 staticpro (&Qmany);
3076 staticpro (&Qunevalled);
3078 staticpro (&Qboundp);
3079 staticpro (&Qfboundp);
3080 staticpro (&Qcdr);
3081 staticpro (&Qad_advice_info);
3082 staticpro (&Qad_activate_internal);
3084 /* Types that type-of returns. */
3085 Qinteger = intern ("integer");
3086 Qsymbol = intern ("symbol");
3087 Qstring = intern ("string");
3088 Qcons = intern ("cons");
3089 Qmarker = intern ("marker");
3090 Qoverlay = intern ("overlay");
3091 Qfloat = intern ("float");
3092 Qwindow_configuration = intern ("window-configuration");
3093 Qprocess = intern ("process");
3094 Qwindow = intern ("window");
3095 /* Qsubr = intern ("subr"); */
3096 Qcompiled_function = intern ("compiled-function");
3097 Qbuffer = intern ("buffer");
3098 Qframe = intern ("frame");
3099 Qvector = intern ("vector");
3100 Qchar_table = intern ("char-table");
3101 Qbool_vector = intern ("bool-vector");
3102 Qhash_table = intern ("hash-table");
3104 staticpro (&Qinteger);
3105 staticpro (&Qsymbol);
3106 staticpro (&Qstring);
3107 staticpro (&Qcons);
3108 staticpro (&Qmarker);
3109 staticpro (&Qoverlay);
3110 staticpro (&Qfloat);
3111 staticpro (&Qwindow_configuration);
3112 staticpro (&Qprocess);
3113 staticpro (&Qwindow);
3114 /* staticpro (&Qsubr); */
3115 staticpro (&Qcompiled_function);
3116 staticpro (&Qbuffer);
3117 staticpro (&Qframe);
3118 staticpro (&Qvector);
3119 staticpro (&Qchar_table);
3120 staticpro (&Qbool_vector);
3121 staticpro (&Qhash_table);
3123 defsubr (&Sindirect_variable);
3124 defsubr (&Ssubr_interactive_form);
3125 defsubr (&Seq);
3126 defsubr (&Snull);
3127 defsubr (&Stype_of);
3128 defsubr (&Slistp);
3129 defsubr (&Snlistp);
3130 defsubr (&Sconsp);
3131 defsubr (&Satom);
3132 defsubr (&Sintegerp);
3133 defsubr (&Sinteger_or_marker_p);
3134 defsubr (&Snumberp);
3135 defsubr (&Snumber_or_marker_p);
3136 defsubr (&Sfloatp);
3137 defsubr (&Snatnump);
3138 defsubr (&Ssymbolp);
3139 defsubr (&Skeywordp);
3140 defsubr (&Sstringp);
3141 defsubr (&Smultibyte_string_p);
3142 defsubr (&Svectorp);
3143 defsubr (&Schar_table_p);
3144 defsubr (&Svector_or_char_table_p);
3145 defsubr (&Sbool_vector_p);
3146 defsubr (&Sarrayp);
3147 defsubr (&Ssequencep);
3148 defsubr (&Sbufferp);
3149 defsubr (&Smarkerp);
3150 defsubr (&Ssubrp);
3151 defsubr (&Sbyte_code_function_p);
3152 defsubr (&Schar_or_string_p);
3153 defsubr (&Scar);
3154 defsubr (&Scdr);
3155 defsubr (&Scar_safe);
3156 defsubr (&Scdr_safe);
3157 defsubr (&Ssetcar);
3158 defsubr (&Ssetcdr);
3159 defsubr (&Ssymbol_function);
3160 defsubr (&Sindirect_function);
3161 defsubr (&Ssymbol_plist);
3162 defsubr (&Ssymbol_name);
3163 defsubr (&Smakunbound);
3164 defsubr (&Sfmakunbound);
3165 defsubr (&Sboundp);
3166 defsubr (&Sfboundp);
3167 defsubr (&Sfset);
3168 defsubr (&Sdefalias);
3169 defsubr (&Ssetplist);
3170 defsubr (&Ssymbol_value);
3171 defsubr (&Sset);
3172 defsubr (&Sdefault_boundp);
3173 defsubr (&Sdefault_value);
3174 defsubr (&Sset_default);
3175 defsubr (&Ssetq_default);
3176 defsubr (&Smake_variable_buffer_local);
3177 defsubr (&Smake_local_variable);
3178 defsubr (&Skill_local_variable);
3179 defsubr (&Smake_variable_frame_local);
3180 defsubr (&Slocal_variable_p);
3181 defsubr (&Slocal_variable_if_set_p);
3182 defsubr (&Saref);
3183 defsubr (&Saset);
3184 defsubr (&Snumber_to_string);
3185 defsubr (&Sstring_to_number);
3186 defsubr (&Seqlsign);
3187 defsubr (&Slss);
3188 defsubr (&Sgtr);
3189 defsubr (&Sleq);
3190 defsubr (&Sgeq);
3191 defsubr (&Sneq);
3192 defsubr (&Szerop);
3193 defsubr (&Splus);
3194 defsubr (&Sminus);
3195 defsubr (&Stimes);
3196 defsubr (&Squo);
3197 defsubr (&Srem);
3198 defsubr (&Smod);
3199 defsubr (&Smax);
3200 defsubr (&Smin);
3201 defsubr (&Slogand);
3202 defsubr (&Slogior);
3203 defsubr (&Slogxor);
3204 defsubr (&Slsh);
3205 defsubr (&Sash);
3206 defsubr (&Sadd1);
3207 defsubr (&Ssub1);
3208 defsubr (&Slognot);
3209 defsubr (&Ssubr_arity);
3211 XSYMBOL (Qwholenump)->function = XSYMBOL (Qnatnump)->function;
3213 DEFVAR_LISP ("most-positive-fixnum", &Vmost_positive_fixnum,
3214 doc: /* The largest value that is representable in a Lisp integer. */);
3215 Vmost_positive_fixnum = make_number (MOST_POSITIVE_FIXNUM);
3217 DEFVAR_LISP ("most-negative-fixnum", &Vmost_negative_fixnum,
3218 doc: /* The smallest value that is representable in a Lisp integer. */);
3219 Vmost_negative_fixnum = make_number (MOST_NEGATIVE_FIXNUM);
3222 SIGTYPE
3223 arith_error (signo)
3224 int signo;
3226 #if defined(USG) && !defined(POSIX_SIGNALS)
3227 /* USG systems forget handlers when they are used;
3228 must reestablish each time */
3229 signal (signo, arith_error);
3230 #endif /* USG */
3231 #ifdef VMS
3232 /* VMS systems are like USG. */
3233 signal (signo, arith_error);
3234 #endif /* VMS */
3235 #ifdef BSD4_1
3236 sigrelse (SIGFPE);
3237 #else /* not BSD4_1 */
3238 sigsetmask (SIGEMPTYMASK);
3239 #endif /* not BSD4_1 */
3241 Fsignal (Qarith_error, Qnil);
3244 void
3245 init_data ()
3247 /* Don't do this if just dumping out.
3248 We don't want to call `signal' in this case
3249 so that we don't have trouble with dumping
3250 signal-delivering routines in an inconsistent state. */
3251 #ifndef CANNOT_DUMP
3252 if (!initialized)
3253 return;
3254 #endif /* CANNOT_DUMP */
3255 signal (SIGFPE, arith_error);
3257 #ifdef uts
3258 signal (SIGEMT, arith_error);
3259 #endif /* uts */