(calendar-read-mayan-haab-date, calendar-read-mayan-tzolkin-date): Use
[emacs.git] / src / data.c
blobbff2baaed272eb37bb3a9d1b624c68851bd788d1
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;
75 Lisp_Object Qintegerp, Qnatnump, Qwholenump, Qsymbolp, Qlistp, Qconsp;
76 Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp;
77 Lisp_Object Qchar_or_string_p, Qmarkerp, Qinteger_or_marker_p, Qvectorp;
78 Lisp_Object Qbuffer_or_string_p, Qkeywordp;
79 Lisp_Object Qboundp, Qfboundp;
80 Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
82 Lisp_Object Qcdr;
83 Lisp_Object Qad_advice_info, Qad_activate_internal;
85 Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
86 Lisp_Object Qoverflow_error, Qunderflow_error;
88 Lisp_Object Qfloatp;
89 Lisp_Object Qnumberp, Qnumber_or_marker_p;
91 Lisp_Object Qinteger;
92 static Lisp_Object Qsymbol, Qstring, Qcons, Qmarker, Qoverlay;
93 static Lisp_Object Qfloat, Qwindow_configuration, Qwindow;
94 Lisp_Object Qprocess;
95 static Lisp_Object Qcompiled_function, Qbuffer, Qframe, Qvector;
96 static Lisp_Object Qchar_table, Qbool_vector, Qhash_table;
97 static Lisp_Object Qsubrp, Qmany, Qunevalled;
99 static Lisp_Object swap_in_symval_forwarding P_ ((Lisp_Object, Lisp_Object));
101 Lisp_Object Vmost_positive_fixnum, Vmost_negative_fixnum;
104 void
105 circular_list_error (list)
106 Lisp_Object list;
108 Fsignal (Qcircular_list, list);
112 Lisp_Object
113 wrong_type_argument (predicate, value)
114 register Lisp_Object predicate, value;
116 register Lisp_Object tem;
119 /* If VALUE is not even a valid Lisp object, abort here
120 where we can get a backtrace showing where it came from. */
121 if ((unsigned int) XGCTYPE (value) >= Lisp_Type_Limit)
122 abort ();
124 value = Fsignal (Qwrong_type_argument, Fcons (predicate, Fcons (value, Qnil)));
125 tem = call1 (predicate, value);
127 while (NILP (tem));
128 return value;
131 void
132 pure_write_error ()
134 error ("Attempt to modify read-only object");
137 void
138 args_out_of_range (a1, a2)
139 Lisp_Object a1, a2;
141 while (1)
142 Fsignal (Qargs_out_of_range, Fcons (a1, Fcons (a2, Qnil)));
145 void
146 args_out_of_range_3 (a1, a2, a3)
147 Lisp_Object a1, a2, a3;
149 while (1)
150 Fsignal (Qargs_out_of_range, Fcons (a1, Fcons (a2, Fcons (a3, Qnil))));
153 /* On some machines, XINT needs a temporary location.
154 Here it is, in case it is needed. */
156 int sign_extend_temp;
158 /* On a few machines, XINT can only be done by calling this. */
161 sign_extend_lisp_int (num)
162 EMACS_INT num;
164 if (num & (((EMACS_INT) 1) << (VALBITS - 1)))
165 return num | (((EMACS_INT) (-1)) << VALBITS);
166 else
167 return num & ((((EMACS_INT) 1) << VALBITS) - 1);
170 /* Data type predicates */
172 DEFUN ("eq", Feq, Seq, 2, 2, 0,
173 doc: /* Return t if the two args are the same Lisp object. */)
174 (obj1, obj2)
175 Lisp_Object obj1, obj2;
177 if (EQ (obj1, obj2))
178 return Qt;
179 return Qnil;
182 DEFUN ("null", Fnull, Snull, 1, 1, 0,
183 doc: /* Return t if OBJECT is nil. */)
184 (object)
185 Lisp_Object object;
187 if (NILP (object))
188 return Qt;
189 return Qnil;
192 DEFUN ("type-of", Ftype_of, Stype_of, 1, 1, 0,
193 doc: /* Return a symbol representing the type of OBJECT.
194 The symbol returned names the object's basic type;
195 for example, (type-of 1) returns `integer'. */)
196 (object)
197 Lisp_Object object;
199 switch (XGCTYPE (object))
201 case Lisp_Int:
202 return Qinteger;
204 case Lisp_Symbol:
205 return Qsymbol;
207 case Lisp_String:
208 return Qstring;
210 case Lisp_Cons:
211 return Qcons;
213 case Lisp_Misc:
214 switch (XMISCTYPE (object))
216 case Lisp_Misc_Marker:
217 return Qmarker;
218 case Lisp_Misc_Overlay:
219 return Qoverlay;
220 case Lisp_Misc_Float:
221 return Qfloat;
223 abort ();
225 case Lisp_Vectorlike:
226 if (GC_WINDOW_CONFIGURATIONP (object))
227 return Qwindow_configuration;
228 if (GC_PROCESSP (object))
229 return Qprocess;
230 if (GC_WINDOWP (object))
231 return Qwindow;
232 if (GC_SUBRP (object))
233 return Qsubr;
234 if (GC_COMPILEDP (object))
235 return Qcompiled_function;
236 if (GC_BUFFERP (object))
237 return Qbuffer;
238 if (GC_CHAR_TABLE_P (object))
239 return Qchar_table;
240 if (GC_BOOL_VECTOR_P (object))
241 return Qbool_vector;
242 if (GC_FRAMEP (object))
243 return Qframe;
244 if (GC_HASH_TABLE_P (object))
245 return Qhash_table;
246 return Qvector;
248 case Lisp_Float:
249 return Qfloat;
251 default:
252 abort ();
256 DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0,
257 doc: /* Return t if OBJECT is a cons cell. */)
258 (object)
259 Lisp_Object object;
261 if (CONSP (object))
262 return Qt;
263 return Qnil;
266 DEFUN ("atom", Fatom, Satom, 1, 1, 0,
267 doc: /* Return t if OBJECT is not a cons cell. This includes nil. */)
268 (object)
269 Lisp_Object object;
271 if (CONSP (object))
272 return Qnil;
273 return Qt;
276 DEFUN ("listp", Flistp, Slistp, 1, 1, 0,
277 doc: /* Return t if OBJECT is a list. This includes nil. */)
278 (object)
279 Lisp_Object object;
281 if (CONSP (object) || NILP (object))
282 return Qt;
283 return Qnil;
286 DEFUN ("nlistp", Fnlistp, Snlistp, 1, 1, 0,
287 doc: /* Return t if OBJECT is not a list. Lists include nil. */)
288 (object)
289 Lisp_Object object;
291 if (CONSP (object) || NILP (object))
292 return Qnil;
293 return Qt;
296 DEFUN ("symbolp", Fsymbolp, Ssymbolp, 1, 1, 0,
297 doc: /* Return t if OBJECT is a symbol. */)
298 (object)
299 Lisp_Object object;
301 if (SYMBOLP (object))
302 return Qt;
303 return Qnil;
306 /* Define this in C to avoid unnecessarily consing up the symbol
307 name. */
308 DEFUN ("keywordp", Fkeywordp, Skeywordp, 1, 1, 0,
309 doc: /* Return t if OBJECT is a keyword.
310 This means that it is a symbol with a print name beginning with `:'
311 interned in the initial obarray. */)
312 (object)
313 Lisp_Object object;
315 if (SYMBOLP (object)
316 && SREF (SYMBOL_NAME (object), 0) == ':'
317 && SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P (object))
318 return Qt;
319 return Qnil;
322 DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
323 doc: /* Return t if OBJECT is a vector. */)
324 (object)
325 Lisp_Object object;
327 if (VECTORP (object))
328 return Qt;
329 return Qnil;
332 DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
333 doc: /* Return t if OBJECT is a string. */)
334 (object)
335 Lisp_Object object;
337 if (STRINGP (object))
338 return Qt;
339 return Qnil;
342 DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p,
343 1, 1, 0,
344 doc: /* Return t if OBJECT is a multibyte string. */)
345 (object)
346 Lisp_Object object;
348 if (STRINGP (object) && STRING_MULTIBYTE (object))
349 return Qt;
350 return Qnil;
353 DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0,
354 doc: /* Return t if OBJECT is a char-table. */)
355 (object)
356 Lisp_Object object;
358 if (CHAR_TABLE_P (object))
359 return Qt;
360 return Qnil;
363 DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p,
364 Svector_or_char_table_p, 1, 1, 0,
365 doc: /* Return t if OBJECT is a char-table or vector. */)
366 (object)
367 Lisp_Object object;
369 if (VECTORP (object) || CHAR_TABLE_P (object))
370 return Qt;
371 return Qnil;
374 DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0,
375 doc: /* Return t if OBJECT is a bool-vector. */)
376 (object)
377 Lisp_Object object;
379 if (BOOL_VECTOR_P (object))
380 return Qt;
381 return Qnil;
384 DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0,
385 doc: /* Return t if OBJECT is an array (string or vector). */)
386 (object)
387 Lisp_Object object;
389 if (VECTORP (object) || STRINGP (object)
390 || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
391 return Qt;
392 return Qnil;
395 DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
396 doc: /* Return t if OBJECT is a sequence (list or array). */)
397 (object)
398 register Lisp_Object object;
400 if (CONSP (object) || NILP (object) || VECTORP (object) || STRINGP (object)
401 || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
402 return Qt;
403 return Qnil;
406 DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0,
407 doc: /* Return t if OBJECT is an editor buffer. */)
408 (object)
409 Lisp_Object object;
411 if (BUFFERP (object))
412 return Qt;
413 return Qnil;
416 DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0,
417 doc: /* Return t if OBJECT is a marker (editor pointer). */)
418 (object)
419 Lisp_Object object;
421 if (MARKERP (object))
422 return Qt;
423 return Qnil;
426 DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0,
427 doc: /* Return t if OBJECT is a built-in function. */)
428 (object)
429 Lisp_Object object;
431 if (SUBRP (object))
432 return Qt;
433 return Qnil;
436 DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
437 1, 1, 0,
438 doc: /* Return t if OBJECT is a byte-compiled function object. */)
439 (object)
440 Lisp_Object object;
442 if (COMPILEDP (object))
443 return Qt;
444 return Qnil;
447 DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0,
448 doc: /* Return t if OBJECT is a character (an integer) or a string. */)
449 (object)
450 register Lisp_Object object;
452 if (INTEGERP (object) || STRINGP (object))
453 return Qt;
454 return Qnil;
457 DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0,
458 doc: /* Return t if OBJECT is an integer. */)
459 (object)
460 Lisp_Object object;
462 if (INTEGERP (object))
463 return Qt;
464 return Qnil;
467 DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0,
468 doc: /* Return t if OBJECT is an integer or a marker (editor pointer). */)
469 (object)
470 register Lisp_Object object;
472 if (MARKERP (object) || INTEGERP (object))
473 return Qt;
474 return Qnil;
477 DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
478 doc: /* Return t if OBJECT is a nonnegative integer. */)
479 (object)
480 Lisp_Object object;
482 if (NATNUMP (object))
483 return Qt;
484 return Qnil;
487 DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
488 doc: /* Return t if OBJECT is a number (floating point or integer). */)
489 (object)
490 Lisp_Object object;
492 if (NUMBERP (object))
493 return Qt;
494 else
495 return Qnil;
498 DEFUN ("number-or-marker-p", Fnumber_or_marker_p,
499 Snumber_or_marker_p, 1, 1, 0,
500 doc: /* Return t if OBJECT is a number or a marker. */)
501 (object)
502 Lisp_Object object;
504 if (NUMBERP (object) || MARKERP (object))
505 return Qt;
506 return Qnil;
509 DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
510 doc: /* Return t if OBJECT is a floating point number. */)
511 (object)
512 Lisp_Object object;
514 if (FLOATP (object))
515 return Qt;
516 return Qnil;
520 /* Extract and set components of lists */
522 DEFUN ("car", Fcar, Scar, 1, 1, 0,
523 doc: /* Return the car of LIST. If arg is nil, return nil.
524 Error if arg is not nil and not a cons cell. See also `car-safe'. */)
525 (list)
526 register Lisp_Object list;
528 while (1)
530 if (CONSP (list))
531 return XCAR (list);
532 else if (EQ (list, Qnil))
533 return Qnil;
534 else
535 list = wrong_type_argument (Qlistp, list);
539 DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0,
540 doc: /* Return the car of OBJECT if it is a cons cell, or else nil. */)
541 (object)
542 Lisp_Object object;
544 if (CONSP (object))
545 return XCAR (object);
546 else
547 return Qnil;
550 DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
551 doc: /* Return the cdr of LIST. If arg is nil, return nil.
552 Error if arg is not nil and not a cons cell. See also `cdr-safe'. */)
553 (list)
554 register Lisp_Object list;
556 while (1)
558 if (CONSP (list))
559 return XCDR (list);
560 else if (EQ (list, Qnil))
561 return Qnil;
562 else
563 list = wrong_type_argument (Qlistp, list);
567 DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0,
568 doc: /* Return the cdr of OBJECT if it is a cons cell, or else nil. */)
569 (object)
570 Lisp_Object object;
572 if (CONSP (object))
573 return XCDR (object);
574 else
575 return Qnil;
578 DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
579 doc: /* Set the car of CELL to be NEWCAR. Returns NEWCAR. */)
580 (cell, newcar)
581 register Lisp_Object cell, newcar;
583 if (!CONSP (cell))
584 cell = wrong_type_argument (Qconsp, cell);
586 CHECK_IMPURE (cell);
587 XSETCAR (cell, newcar);
588 return newcar;
591 DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
592 doc: /* Set the cdr of CELL to be NEWCDR. Returns NEWCDR. */)
593 (cell, newcdr)
594 register Lisp_Object cell, newcdr;
596 if (!CONSP (cell))
597 cell = wrong_type_argument (Qconsp, cell);
599 CHECK_IMPURE (cell);
600 XSETCDR (cell, newcdr);
601 return newcdr;
604 /* Extract and set components of symbols */
606 DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0,
607 doc: /* Return t if SYMBOL's value is not void. */)
608 (symbol)
609 register Lisp_Object symbol;
611 Lisp_Object valcontents;
612 CHECK_SYMBOL (symbol);
614 valcontents = SYMBOL_VALUE (symbol);
616 if (BUFFER_LOCAL_VALUEP (valcontents)
617 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
618 valcontents = swap_in_symval_forwarding (symbol, valcontents);
620 return (EQ (valcontents, Qunbound) ? Qnil : Qt);
623 DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0,
624 doc: /* Return t if SYMBOL's function definition is not void. */)
625 (symbol)
626 register Lisp_Object symbol;
628 CHECK_SYMBOL (symbol);
629 return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
632 DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0,
633 doc: /* Make SYMBOL's value be void.
634 Return SYMBOL. */)
635 (symbol)
636 register Lisp_Object symbol;
638 CHECK_SYMBOL (symbol);
639 if (XSYMBOL (symbol)->constant)
640 return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
641 Fset (symbol, Qunbound);
642 return symbol;
645 DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0,
646 doc: /* Make SYMBOL's function definition be void.
647 Return SYMBOL. */)
648 (symbol)
649 register Lisp_Object symbol;
651 CHECK_SYMBOL (symbol);
652 if (NILP (symbol) || EQ (symbol, Qt))
653 return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
654 XSYMBOL (symbol)->function = Qunbound;
655 return symbol;
658 DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0,
659 doc: /* Return SYMBOL's function definition. Error if that is void. */)
660 (symbol)
661 register Lisp_Object symbol;
663 CHECK_SYMBOL (symbol);
664 if (EQ (XSYMBOL (symbol)->function, Qunbound))
665 return Fsignal (Qvoid_function, Fcons (symbol, Qnil));
666 return XSYMBOL (symbol)->function;
669 DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0,
670 doc: /* Return SYMBOL's property list. */)
671 (symbol)
672 register Lisp_Object symbol;
674 CHECK_SYMBOL (symbol);
675 return XSYMBOL (symbol)->plist;
678 DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0,
679 doc: /* Return SYMBOL's name, a string. */)
680 (symbol)
681 register Lisp_Object symbol;
683 register Lisp_Object name;
685 CHECK_SYMBOL (symbol);
686 name = SYMBOL_NAME (symbol);
687 return name;
690 DEFUN ("fset", Ffset, Sfset, 2, 2, 0,
691 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION. */)
692 (symbol, definition)
693 register Lisp_Object symbol, definition;
695 CHECK_SYMBOL (symbol);
696 if (NILP (symbol) || EQ (symbol, Qt))
697 return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
698 if (!NILP (Vautoload_queue) && !EQ (XSYMBOL (symbol)->function, Qunbound))
699 Vautoload_queue = Fcons (Fcons (symbol, XSYMBOL (symbol)->function),
700 Vautoload_queue);
701 XSYMBOL (symbol)->function = definition;
702 /* Handle automatic advice activation */
703 if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
705 call2 (Qad_activate_internal, symbol, Qnil);
706 definition = XSYMBOL (symbol)->function;
708 return definition;
711 extern Lisp_Object Qfunction_documentation;
713 DEFUN ("defalias", Fdefalias, Sdefalias, 2, 3, 0,
714 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION.
715 Associates the function with the current load file, if any.
716 The optional third argument DOCSTRING specifies the documentation string
717 for SYMBOL; if it is omitted or nil, SYMBOL uses the documentation string
718 determined by DEFINITION. */)
719 (symbol, definition, docstring)
720 register Lisp_Object symbol, definition, docstring;
722 if (CONSP (XSYMBOL (symbol)->function)
723 && EQ (XCAR (XSYMBOL (symbol)->function), Qautoload))
724 LOADHIST_ATTACH (Fcons (Qt, symbol));
725 definition = Ffset (symbol, definition);
726 LOADHIST_ATTACH (symbol);
727 if (!NILP (docstring))
728 Fput (symbol, Qfunction_documentation, docstring);
729 return definition;
732 DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
733 doc: /* Set SYMBOL's property list to NEWPLIST, and return NEWPLIST. */)
734 (symbol, newplist)
735 register Lisp_Object symbol, newplist;
737 CHECK_SYMBOL (symbol);
738 XSYMBOL (symbol)->plist = newplist;
739 return newplist;
742 DEFUN ("subr-arity", Fsubr_arity, Ssubr_arity, 1, 1, 0,
743 doc: /* Return minimum and maximum number of args allowed for SUBR.
744 SUBR must be a built-in function.
745 The returned value is a pair (MIN . MAX). MIN is the minimum number
746 of args. MAX is the maximum number or the symbol `many', for a
747 function with `&rest' args, or `unevalled' for a special form. */)
748 (subr)
749 Lisp_Object subr;
751 short minargs, maxargs;
752 if (!SUBRP (subr))
753 wrong_type_argument (Qsubrp, subr);
754 minargs = XSUBR (subr)->min_args;
755 maxargs = XSUBR (subr)->max_args;
756 if (maxargs == MANY)
757 return Fcons (make_number (minargs), Qmany);
758 else if (maxargs == UNEVALLED)
759 return Fcons (make_number (minargs), Qunevalled);
760 else
761 return Fcons (make_number (minargs), make_number (maxargs));
764 DEFUN ("subr-interactive-form", Fsubr_interactive_form, Ssubr_interactive_form, 1, 1, 0,
765 doc: /* Return the interactive form of SUBR or nil if none.
766 SUBR must be a built-in function. Value, if non-nil, is a list
767 \(interactive SPEC). */)
768 (subr)
769 Lisp_Object subr;
771 if (!SUBRP (subr))
772 wrong_type_argument (Qsubrp, subr);
773 if (XSUBR (subr)->prompt)
774 return list2 (Qinteractive, build_string (XSUBR (subr)->prompt));
775 return Qnil;
779 /***********************************************************************
780 Getting and Setting Values of Symbols
781 ***********************************************************************/
783 /* Return the symbol holding SYMBOL's value. Signal
784 `cyclic-variable-indirection' if SYMBOL's chain of variable
785 indirections contains a loop. */
787 Lisp_Object
788 indirect_variable (symbol)
789 Lisp_Object symbol;
791 Lisp_Object tortoise, hare;
793 hare = tortoise = symbol;
795 while (XSYMBOL (hare)->indirect_variable)
797 hare = XSYMBOL (hare)->value;
798 if (!XSYMBOL (hare)->indirect_variable)
799 break;
801 hare = XSYMBOL (hare)->value;
802 tortoise = XSYMBOL (tortoise)->value;
804 if (EQ (hare, tortoise))
805 Fsignal (Qcyclic_variable_indirection, Fcons (symbol, Qnil));
808 return hare;
812 DEFUN ("indirect-variable", Findirect_variable, Sindirect_variable, 1, 1, 0,
813 doc: /* Return the variable at the end of OBJECT's variable chain.
814 If OBJECT is a symbol, follow all variable indirections and return the final
815 variable. If OBJECT is not a symbol, just return it.
816 Signal a cyclic-variable-indirection error if there is a loop in the
817 variable chain of symbols. */)
818 (object)
819 Lisp_Object object;
821 if (SYMBOLP (object))
822 object = indirect_variable (object);
823 return object;
827 /* Given the raw contents of a symbol value cell,
828 return the Lisp value of the symbol.
829 This does not handle buffer-local variables; use
830 swap_in_symval_forwarding for that. */
832 Lisp_Object
833 do_symval_forwarding (valcontents)
834 register Lisp_Object valcontents;
836 register Lisp_Object val;
837 int offset;
838 if (MISCP (valcontents))
839 switch (XMISCTYPE (valcontents))
841 case Lisp_Misc_Intfwd:
842 XSETINT (val, *XINTFWD (valcontents)->intvar);
843 return val;
845 case Lisp_Misc_Boolfwd:
846 return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
848 case Lisp_Misc_Objfwd:
849 return *XOBJFWD (valcontents)->objvar;
851 case Lisp_Misc_Buffer_Objfwd:
852 offset = XBUFFER_OBJFWD (valcontents)->offset;
853 return PER_BUFFER_VALUE (current_buffer, offset);
855 case Lisp_Misc_Kboard_Objfwd:
856 offset = XKBOARD_OBJFWD (valcontents)->offset;
857 return *(Lisp_Object *)(offset + (char *)current_kboard);
859 return valcontents;
862 /* Store NEWVAL into SYMBOL, where VALCONTENTS is found in the value cell
863 of SYMBOL. If SYMBOL is buffer-local, VALCONTENTS should be the
864 buffer-independent contents of the value cell: forwarded just one
865 step past the buffer-localness.
867 BUF non-zero means set the value in buffer BUF instead of the
868 current buffer. This only plays a role for per-buffer variables. */
870 void
871 store_symval_forwarding (symbol, valcontents, newval, buf)
872 Lisp_Object symbol;
873 register Lisp_Object valcontents, newval;
874 struct buffer *buf;
876 int offset;
878 switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
880 case Lisp_Misc:
881 switch (XMISCTYPE (valcontents))
883 case Lisp_Misc_Intfwd:
884 CHECK_NUMBER (newval);
885 *XINTFWD (valcontents)->intvar = XINT (newval);
886 if (*XINTFWD (valcontents)->intvar != XINT (newval))
887 error ("Value out of range for variable `%s'",
888 SDATA (SYMBOL_NAME (symbol)));
889 break;
891 case Lisp_Misc_Boolfwd:
892 *XBOOLFWD (valcontents)->boolvar = NILP (newval) ? 0 : 1;
893 break;
895 case Lisp_Misc_Objfwd:
896 *XOBJFWD (valcontents)->objvar = newval;
898 /* If this variable is a default for something stored
899 in the buffer itself, such as default-fill-column,
900 find the buffers that don't have local values for it
901 and update them. */
902 if (XOBJFWD (valcontents)->objvar > (Lisp_Object *) &buffer_defaults
903 && XOBJFWD (valcontents)->objvar < (Lisp_Object *) (&buffer_defaults + 1))
905 int offset = ((char *) XOBJFWD (valcontents)->objvar
906 - (char *) &buffer_defaults);
907 int idx = PER_BUFFER_IDX (offset);
909 Lisp_Object tail, buf;
911 if (idx <= 0)
912 break;
914 for (tail = Vbuffer_alist; CONSP (tail); tail = XCDR (tail))
916 Lisp_Object buf;
917 struct buffer *b;
919 buf = Fcdr (XCAR (tail));
920 if (!BUFFERP (buf)) continue;
921 b = XBUFFER (buf);
923 if (! PER_BUFFER_VALUE_P (b, idx))
924 PER_BUFFER_VALUE (b, offset) = newval;
927 break;
929 case Lisp_Misc_Buffer_Objfwd:
931 int offset = XBUFFER_OBJFWD (valcontents)->offset;
932 Lisp_Object type;
934 type = PER_BUFFER_TYPE (offset);
935 if (! NILP (type) && ! NILP (newval)
936 && XTYPE (newval) != XINT (type))
937 buffer_slot_type_mismatch (offset);
939 if (buf == NULL)
940 buf = current_buffer;
941 PER_BUFFER_VALUE (buf, offset) = newval;
943 break;
945 case Lisp_Misc_Kboard_Objfwd:
947 char *base = (char *) current_kboard;
948 char *p = base + XKBOARD_OBJFWD (valcontents)->offset;
949 *(Lisp_Object *) p = newval;
951 break;
953 default:
954 goto def;
956 break;
958 default:
959 def:
960 valcontents = SYMBOL_VALUE (symbol);
961 if (BUFFER_LOCAL_VALUEP (valcontents)
962 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
963 XBUFFER_LOCAL_VALUE (valcontents)->realvalue = newval;
964 else
965 SET_SYMBOL_VALUE (symbol, newval);
969 /* Set up SYMBOL to refer to its global binding.
970 This makes it safe to alter the status of other bindings. */
972 void
973 swap_in_global_binding (symbol)
974 Lisp_Object symbol;
976 Lisp_Object valcontents, cdr;
978 valcontents = SYMBOL_VALUE (symbol);
979 if (!BUFFER_LOCAL_VALUEP (valcontents)
980 && !SOME_BUFFER_LOCAL_VALUEP (valcontents))
981 abort ();
982 cdr = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
984 /* Unload the previously loaded binding. */
985 Fsetcdr (XCAR (cdr),
986 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
988 /* Select the global binding in the symbol. */
989 XSETCAR (cdr, cdr);
990 store_symval_forwarding (symbol, valcontents, XCDR (cdr), NULL);
992 /* Indicate that the global binding is set up now. */
993 XBUFFER_LOCAL_VALUE (valcontents)->frame = Qnil;
994 XBUFFER_LOCAL_VALUE (valcontents)->buffer = Qnil;
995 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
996 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
999 /* Set up the buffer-local symbol SYMBOL for validity in the current buffer.
1000 VALCONTENTS is the contents of its value cell,
1001 which points to a struct Lisp_Buffer_Local_Value.
1003 Return the value forwarded one step past the buffer-local stage.
1004 This could be another forwarding pointer. */
1006 static Lisp_Object
1007 swap_in_symval_forwarding (symbol, valcontents)
1008 Lisp_Object symbol, valcontents;
1010 register Lisp_Object tem1;
1012 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1014 if (NILP (tem1)
1015 || current_buffer != XBUFFER (tem1)
1016 || (XBUFFER_LOCAL_VALUE (valcontents)->check_frame
1017 && ! EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame)))
1019 if (XSYMBOL (symbol)->indirect_variable)
1020 symbol = indirect_variable (symbol);
1022 /* Unload the previously loaded binding. */
1023 tem1 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1024 Fsetcdr (tem1,
1025 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
1026 /* Choose the new binding. */
1027 tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
1028 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
1029 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1030 if (NILP (tem1))
1032 if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
1033 tem1 = assq_no_quit (symbol, XFRAME (selected_frame)->param_alist);
1034 if (! NILP (tem1))
1035 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 1;
1036 else
1037 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
1039 else
1040 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 1;
1042 /* Load the new binding. */
1043 XSETCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr, tem1);
1044 XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, current_buffer);
1045 XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
1046 store_symval_forwarding (symbol,
1047 XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1048 Fcdr (tem1), NULL);
1050 return XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
1053 /* Find the value of a symbol, returning Qunbound if it's not bound.
1054 This is helpful for code which just wants to get a variable's value
1055 if it has one, without signaling an error.
1056 Note that it must not be possible to quit
1057 within this function. Great care is required for this. */
1059 Lisp_Object
1060 find_symbol_value (symbol)
1061 Lisp_Object symbol;
1063 register Lisp_Object valcontents;
1064 register Lisp_Object val;
1066 CHECK_SYMBOL (symbol);
1067 valcontents = SYMBOL_VALUE (symbol);
1069 if (BUFFER_LOCAL_VALUEP (valcontents)
1070 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1071 valcontents = swap_in_symval_forwarding (symbol, valcontents);
1073 if (MISCP (valcontents))
1075 switch (XMISCTYPE (valcontents))
1077 case Lisp_Misc_Intfwd:
1078 XSETINT (val, *XINTFWD (valcontents)->intvar);
1079 return val;
1081 case Lisp_Misc_Boolfwd:
1082 return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
1084 case Lisp_Misc_Objfwd:
1085 return *XOBJFWD (valcontents)->objvar;
1087 case Lisp_Misc_Buffer_Objfwd:
1088 return PER_BUFFER_VALUE (current_buffer,
1089 XBUFFER_OBJFWD (valcontents)->offset);
1091 case Lisp_Misc_Kboard_Objfwd:
1092 return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
1093 + (char *)current_kboard);
1097 return valcontents;
1100 DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
1101 doc: /* Return SYMBOL's value. Error if that is void. */)
1102 (symbol)
1103 Lisp_Object symbol;
1105 Lisp_Object val;
1107 val = find_symbol_value (symbol);
1108 if (EQ (val, Qunbound))
1109 return Fsignal (Qvoid_variable, Fcons (symbol, Qnil));
1110 else
1111 return val;
1114 DEFUN ("set", Fset, Sset, 2, 2, 0,
1115 doc: /* Set SYMBOL's value to NEWVAL, and return NEWVAL. */)
1116 (symbol, newval)
1117 register Lisp_Object symbol, newval;
1119 return set_internal (symbol, newval, current_buffer, 0);
1122 /* Return 1 if SYMBOL currently has a let-binding
1123 which was made in the buffer that is now current. */
1125 static int
1126 let_shadows_buffer_binding_p (symbol)
1127 Lisp_Object symbol;
1129 volatile struct specbinding *p;
1131 for (p = specpdl_ptr - 1; p >= specpdl; p--)
1132 if (p->func == NULL
1133 && CONSP (p->symbol))
1135 Lisp_Object let_bound_symbol = XCAR (p->symbol);
1136 if ((EQ (symbol, let_bound_symbol)
1137 || (XSYMBOL (let_bound_symbol)->indirect_variable
1138 && EQ (symbol, indirect_variable (let_bound_symbol))))
1139 && XBUFFER (XCDR (XCDR (p->symbol))) == current_buffer)
1140 break;
1143 return p >= specpdl;
1146 /* Store the value NEWVAL into SYMBOL.
1147 If buffer-locality is an issue, BUF specifies which buffer to use.
1148 (0 stands for the current buffer.)
1150 If BINDFLAG is zero, then if this symbol is supposed to become
1151 local in every buffer where it is set, then we make it local.
1152 If BINDFLAG is nonzero, we don't do that. */
1154 Lisp_Object
1155 set_internal (symbol, newval, buf, bindflag)
1156 register Lisp_Object symbol, newval;
1157 struct buffer *buf;
1158 int bindflag;
1160 int voide = EQ (newval, Qunbound);
1162 register Lisp_Object valcontents, innercontents, tem1, current_alist_element;
1164 if (buf == 0)
1165 buf = current_buffer;
1167 /* If restoring in a dead buffer, do nothing. */
1168 if (NILP (buf->name))
1169 return newval;
1171 CHECK_SYMBOL (symbol);
1172 if (SYMBOL_CONSTANT_P (symbol)
1173 && (NILP (Fkeywordp (symbol))
1174 || !EQ (newval, SYMBOL_VALUE (symbol))))
1175 return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
1177 innercontents = valcontents = SYMBOL_VALUE (symbol);
1179 if (BUFFER_OBJFWDP (valcontents))
1181 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1182 int idx = PER_BUFFER_IDX (offset);
1183 if (idx > 0
1184 && !bindflag
1185 && !let_shadows_buffer_binding_p (symbol))
1186 SET_PER_BUFFER_VALUE_P (buf, idx, 1);
1188 else if (BUFFER_LOCAL_VALUEP (valcontents)
1189 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1191 /* valcontents is a struct Lisp_Buffer_Local_Value. */
1192 if (XSYMBOL (symbol)->indirect_variable)
1193 symbol = indirect_variable (symbol);
1195 /* What binding is loaded right now? */
1196 current_alist_element
1197 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1199 /* If the current buffer is not the buffer whose binding is
1200 loaded, or if there may be frame-local bindings and the frame
1201 isn't the right one, or if it's a Lisp_Buffer_Local_Value and
1202 the default binding is loaded, the loaded binding may be the
1203 wrong one. */
1204 if (!BUFFERP (XBUFFER_LOCAL_VALUE (valcontents)->buffer)
1205 || buf != XBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer)
1206 || (XBUFFER_LOCAL_VALUE (valcontents)->check_frame
1207 && !EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame))
1208 || (BUFFER_LOCAL_VALUEP (valcontents)
1209 && EQ (XCAR (current_alist_element),
1210 current_alist_element)))
1212 /* The currently loaded binding is not necessarily valid.
1213 We need to unload it, and choose a new binding. */
1215 /* Write out `realvalue' to the old loaded binding. */
1216 Fsetcdr (current_alist_element,
1217 do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
1219 /* Find the new binding. */
1220 tem1 = Fassq (symbol, buf->local_var_alist);
1221 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 1;
1222 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
1224 if (NILP (tem1))
1226 /* This buffer still sees the default value. */
1228 /* If the variable is a Lisp_Some_Buffer_Local_Value,
1229 or if this is `let' rather than `set',
1230 make CURRENT-ALIST-ELEMENT point to itself,
1231 indicating that we're seeing the default value.
1232 Likewise if the variable has been let-bound
1233 in the current buffer. */
1234 if (bindflag || SOME_BUFFER_LOCAL_VALUEP (valcontents)
1235 || let_shadows_buffer_binding_p (symbol))
1237 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1239 if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
1240 tem1 = Fassq (symbol,
1241 XFRAME (selected_frame)->param_alist);
1243 if (! NILP (tem1))
1244 XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 1;
1245 else
1246 tem1 = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
1248 /* If it's a Lisp_Buffer_Local_Value, being set not bound,
1249 and we're not within a let that was made for this buffer,
1250 create a new buffer-local binding for the variable.
1251 That means, give this buffer a new assoc for a local value
1252 and load that binding. */
1253 else
1255 tem1 = Fcons (symbol, XCDR (current_alist_element));
1256 buf->local_var_alist
1257 = Fcons (tem1, buf->local_var_alist);
1261 /* Record which binding is now loaded. */
1262 XSETCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr,
1263 tem1);
1265 /* Set `buffer' and `frame' slots for thebinding now loaded. */
1266 XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, buf);
1267 XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
1269 innercontents = XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
1272 /* If storing void (making the symbol void), forward only through
1273 buffer-local indicator, not through Lisp_Objfwd, etc. */
1274 if (voide)
1275 store_symval_forwarding (symbol, Qnil, newval, buf);
1276 else
1277 store_symval_forwarding (symbol, innercontents, newval, buf);
1279 /* If we just set a variable whose current binding is frame-local,
1280 store the new value in the frame parameter too. */
1282 if (BUFFER_LOCAL_VALUEP (valcontents)
1283 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1285 /* What binding is loaded right now? */
1286 current_alist_element
1287 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1289 /* If the current buffer is not the buffer whose binding is
1290 loaded, or if there may be frame-local bindings and the frame
1291 isn't the right one, or if it's a Lisp_Buffer_Local_Value and
1292 the default binding is loaded, the loaded binding may be the
1293 wrong one. */
1294 if (XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame)
1295 XSETCDR (current_alist_element, newval);
1298 return newval;
1301 /* Access or set a buffer-local symbol's default value. */
1303 /* Return the default value of SYMBOL, but don't check for voidness.
1304 Return Qunbound if it is void. */
1306 Lisp_Object
1307 default_value (symbol)
1308 Lisp_Object symbol;
1310 register Lisp_Object valcontents;
1312 CHECK_SYMBOL (symbol);
1313 valcontents = SYMBOL_VALUE (symbol);
1315 /* For a built-in buffer-local variable, get the default value
1316 rather than letting do_symval_forwarding get the current value. */
1317 if (BUFFER_OBJFWDP (valcontents))
1319 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1320 if (PER_BUFFER_IDX (offset) != 0)
1321 return PER_BUFFER_DEFAULT (offset);
1324 /* Handle user-created local variables. */
1325 if (BUFFER_LOCAL_VALUEP (valcontents)
1326 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1328 /* If var is set up for a buffer that lacks a local value for it,
1329 the current value is nominally the default value.
1330 But the `realvalue' slot may be more up to date, since
1331 ordinary setq stores just that slot. So use that. */
1332 Lisp_Object current_alist_element, alist_element_car;
1333 current_alist_element
1334 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1335 alist_element_car = XCAR (current_alist_element);
1336 if (EQ (alist_element_car, current_alist_element))
1337 return do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue);
1338 else
1339 return XCDR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1341 /* For other variables, get the current value. */
1342 return do_symval_forwarding (valcontents);
1345 DEFUN ("default-boundp", Fdefault_boundp, Sdefault_boundp, 1, 1, 0,
1346 doc: /* Return t if SYMBOL has a non-void default value.
1347 This is the value that is seen in buffers that do not have their own values
1348 for this variable. */)
1349 (symbol)
1350 Lisp_Object symbol;
1352 register Lisp_Object value;
1354 value = default_value (symbol);
1355 return (EQ (value, Qunbound) ? Qnil : Qt);
1358 DEFUN ("default-value", Fdefault_value, Sdefault_value, 1, 1, 0,
1359 doc: /* Return SYMBOL's default value.
1360 This is the value that is seen in buffers that do not have their own values
1361 for this variable. The default value is meaningful for variables with
1362 local bindings in certain buffers. */)
1363 (symbol)
1364 Lisp_Object symbol;
1366 register Lisp_Object value;
1368 value = default_value (symbol);
1369 if (EQ (value, Qunbound))
1370 return Fsignal (Qvoid_variable, Fcons (symbol, Qnil));
1371 return value;
1374 DEFUN ("set-default", Fset_default, Sset_default, 2, 2, 0,
1375 doc: /* Set SYMBOL's default value to VAL. SYMBOL and VAL are evaluated.
1376 The default value is seen in buffers that do not have their own values
1377 for this variable. */)
1378 (symbol, value)
1379 Lisp_Object symbol, value;
1381 register Lisp_Object valcontents, current_alist_element, alist_element_buffer;
1383 CHECK_SYMBOL (symbol);
1384 valcontents = SYMBOL_VALUE (symbol);
1386 /* Handle variables like case-fold-search that have special slots
1387 in the buffer. Make them work apparently like Lisp_Buffer_Local_Value
1388 variables. */
1389 if (BUFFER_OBJFWDP (valcontents))
1391 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1392 int idx = PER_BUFFER_IDX (offset);
1394 PER_BUFFER_DEFAULT (offset) = value;
1396 /* If this variable is not always local in all buffers,
1397 set it in the buffers that don't nominally have a local value. */
1398 if (idx > 0)
1400 struct buffer *b;
1402 for (b = all_buffers; b; b = b->next)
1403 if (!PER_BUFFER_VALUE_P (b, idx))
1404 PER_BUFFER_VALUE (b, offset) = value;
1406 return value;
1409 if (!BUFFER_LOCAL_VALUEP (valcontents)
1410 && !SOME_BUFFER_LOCAL_VALUEP (valcontents))
1411 return Fset (symbol, value);
1413 /* Store new value into the DEFAULT-VALUE slot. */
1414 XSETCDR (XBUFFER_LOCAL_VALUE (valcontents)->cdr, value);
1416 /* If the default binding is now loaded, set the REALVALUE slot too. */
1417 current_alist_element
1418 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
1419 alist_element_buffer = Fcar (current_alist_element);
1420 if (EQ (alist_element_buffer, current_alist_element))
1421 store_symval_forwarding (symbol,
1422 XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
1423 value, NULL);
1425 return value;
1428 DEFUN ("setq-default", Fsetq_default, Ssetq_default, 2, UNEVALLED, 0,
1429 doc: /* Set the default value of variable VAR to VALUE.
1430 VAR, the variable name, is literal (not evaluated);
1431 VALUE is an expression: it is evaluated and its value returned.
1432 The default value of a variable is seen in buffers
1433 that do not have their own values for the variable.
1435 More generally, you can use multiple variables and values, as in
1436 (setq-default SYMBOL VALUE SYMBOL VALUE...)
1437 This sets each SYMBOL's default value to the corresponding VALUE.
1438 The VALUE for the Nth SYMBOL can refer to the new default values
1439 of previous SYMs.
1440 usage: (setq-default SYMBOL VALUE [SYMBOL VALUE...]) */)
1441 (args)
1442 Lisp_Object args;
1444 register Lisp_Object args_left;
1445 register Lisp_Object val, symbol;
1446 struct gcpro gcpro1;
1448 if (NILP (args))
1449 return Qnil;
1451 args_left = args;
1452 GCPRO1 (args);
1456 val = Feval (Fcar (Fcdr (args_left)));
1457 symbol = XCAR (args_left);
1458 Fset_default (symbol, val);
1459 args_left = Fcdr (XCDR (args_left));
1461 while (!NILP (args_left));
1463 UNGCPRO;
1464 return val;
1467 /* Lisp functions for creating and removing buffer-local variables. */
1469 DEFUN ("make-variable-buffer-local", Fmake_variable_buffer_local, Smake_variable_buffer_local,
1470 1, 1, "vMake Variable Buffer Local: ",
1471 doc: /* Make VARIABLE become buffer-local whenever it is set.
1472 At any time, the value for the current buffer is in effect,
1473 unless the variable has never been set in this buffer,
1474 in which case the default value is in effect.
1475 Note that binding the variable with `let', or setting it while
1476 a `let'-style binding made in this buffer is in effect,
1477 does not make the variable buffer-local. Return VARIABLE.
1479 The function `default-value' gets the default value and `set-default' sets it. */)
1480 (variable)
1481 register Lisp_Object variable;
1483 register Lisp_Object tem, valcontents, newval;
1485 CHECK_SYMBOL (variable);
1486 variable = indirect_variable (variable);
1488 valcontents = SYMBOL_VALUE (variable);
1489 if (EQ (variable, Qnil) || EQ (variable, Qt) || KBOARD_OBJFWDP (valcontents))
1490 error ("Symbol %s may not be buffer-local", SDATA (SYMBOL_NAME (variable)));
1492 if (BUFFER_LOCAL_VALUEP (valcontents) || BUFFER_OBJFWDP (valcontents))
1493 return variable;
1494 if (SOME_BUFFER_LOCAL_VALUEP (valcontents))
1496 XMISCTYPE (SYMBOL_VALUE (variable)) = Lisp_Misc_Buffer_Local_Value;
1497 return variable;
1499 if (EQ (valcontents, Qunbound))
1500 SET_SYMBOL_VALUE (variable, Qnil);
1501 tem = Fcons (Qnil, Fsymbol_value (variable));
1502 XSETCAR (tem, tem);
1503 newval = allocate_misc ();
1504 XMISCTYPE (newval) = Lisp_Misc_Buffer_Local_Value;
1505 XBUFFER_LOCAL_VALUE (newval)->realvalue = SYMBOL_VALUE (variable);
1506 XBUFFER_LOCAL_VALUE (newval)->buffer = Fcurrent_buffer ();
1507 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1508 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1509 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1510 XBUFFER_LOCAL_VALUE (newval)->check_frame = 0;
1511 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1512 SET_SYMBOL_VALUE (variable, newval);
1513 return variable;
1516 DEFUN ("make-local-variable", Fmake_local_variable, Smake_local_variable,
1517 1, 1, "vMake Local Variable: ",
1518 doc: /* Make VARIABLE have a separate value in the current buffer.
1519 Other buffers will continue to share a common default value.
1520 \(The buffer-local value of VARIABLE starts out as the same value
1521 VARIABLE previously had. If VARIABLE was void, it remains void.\)
1522 See also `make-variable-buffer-local'. Return VARIABLE.
1524 If the variable is already arranged to become local when set,
1525 this function causes a local value to exist for this buffer,
1526 just as setting the variable would do.
1528 This function returns VARIABLE, and therefore
1529 (set (make-local-variable 'VARIABLE) VALUE-EXP)
1530 works.
1532 Do not use `make-local-variable' to make a hook variable buffer-local.
1533 Instead, use `add-hook' and specify t for the LOCAL argument. */)
1534 (variable)
1535 register Lisp_Object variable;
1537 register Lisp_Object tem, valcontents;
1539 CHECK_SYMBOL (variable);
1540 variable = indirect_variable (variable);
1542 valcontents = SYMBOL_VALUE (variable);
1543 if (EQ (variable, Qnil) || EQ (variable, Qt) || KBOARD_OBJFWDP (valcontents))
1544 error ("Symbol %s may not be buffer-local", SDATA (SYMBOL_NAME (variable)));
1546 if (BUFFER_LOCAL_VALUEP (valcontents) || BUFFER_OBJFWDP (valcontents))
1548 tem = Fboundp (variable);
1550 /* Make sure the symbol has a local value in this particular buffer,
1551 by setting it to the same value it already has. */
1552 Fset (variable, (EQ (tem, Qt) ? Fsymbol_value (variable) : Qunbound));
1553 return variable;
1555 /* Make sure symbol is set up to hold per-buffer values. */
1556 if (!SOME_BUFFER_LOCAL_VALUEP (valcontents))
1558 Lisp_Object newval;
1559 tem = Fcons (Qnil, do_symval_forwarding (valcontents));
1560 XSETCAR (tem, tem);
1561 newval = allocate_misc ();
1562 XMISCTYPE (newval) = Lisp_Misc_Some_Buffer_Local_Value;
1563 XBUFFER_LOCAL_VALUE (newval)->realvalue = SYMBOL_VALUE (variable);
1564 XBUFFER_LOCAL_VALUE (newval)->buffer = Qnil;
1565 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1566 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1567 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1568 XBUFFER_LOCAL_VALUE (newval)->check_frame = 0;
1569 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1570 SET_SYMBOL_VALUE (variable, newval);;
1572 /* Make sure this buffer has its own value of symbol. */
1573 tem = Fassq (variable, current_buffer->local_var_alist);
1574 if (NILP (tem))
1576 /* Swap out any local binding for some other buffer, and make
1577 sure the current value is permanently recorded, if it's the
1578 default value. */
1579 find_symbol_value (variable);
1581 current_buffer->local_var_alist
1582 = Fcons (Fcons (variable, XCDR (XBUFFER_LOCAL_VALUE (SYMBOL_VALUE (variable))->cdr)),
1583 current_buffer->local_var_alist);
1585 /* Make sure symbol does not think it is set up for this buffer;
1586 force it to look once again for this buffer's value. */
1588 Lisp_Object *pvalbuf;
1590 valcontents = SYMBOL_VALUE (variable);
1592 pvalbuf = &XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1593 if (current_buffer == XBUFFER (*pvalbuf))
1594 *pvalbuf = Qnil;
1595 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1599 /* If the symbol forwards into a C variable, then load the binding
1600 for this buffer now. If C code modifies the variable before we
1601 load the binding in, then that new value will clobber the default
1602 binding the next time we unload it. */
1603 valcontents = XBUFFER_LOCAL_VALUE (SYMBOL_VALUE (variable))->realvalue;
1604 if (INTFWDP (valcontents) || BOOLFWDP (valcontents) || OBJFWDP (valcontents))
1605 swap_in_symval_forwarding (variable, SYMBOL_VALUE (variable));
1607 return variable;
1610 DEFUN ("kill-local-variable", Fkill_local_variable, Skill_local_variable,
1611 1, 1, "vKill Local Variable: ",
1612 doc: /* Make VARIABLE no longer have a separate value in the current buffer.
1613 From now on the default value will apply in this buffer. Return VARIABLE. */)
1614 (variable)
1615 register Lisp_Object variable;
1617 register Lisp_Object tem, valcontents;
1619 CHECK_SYMBOL (variable);
1620 variable = indirect_variable (variable);
1622 valcontents = SYMBOL_VALUE (variable);
1624 if (BUFFER_OBJFWDP (valcontents))
1626 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1627 int idx = PER_BUFFER_IDX (offset);
1629 if (idx > 0)
1631 SET_PER_BUFFER_VALUE_P (current_buffer, idx, 0);
1632 PER_BUFFER_VALUE (current_buffer, offset)
1633 = PER_BUFFER_DEFAULT (offset);
1635 return variable;
1638 if (!BUFFER_LOCAL_VALUEP (valcontents)
1639 && !SOME_BUFFER_LOCAL_VALUEP (valcontents))
1640 return variable;
1642 /* Get rid of this buffer's alist element, if any. */
1644 tem = Fassq (variable, current_buffer->local_var_alist);
1645 if (!NILP (tem))
1646 current_buffer->local_var_alist
1647 = Fdelq (tem, current_buffer->local_var_alist);
1649 /* If the symbol is set up with the current buffer's binding
1650 loaded, recompute its value. We have to do it now, or else
1651 forwarded objects won't work right. */
1653 Lisp_Object *pvalbuf, buf;
1654 valcontents = SYMBOL_VALUE (variable);
1655 pvalbuf = &XBUFFER_LOCAL_VALUE (valcontents)->buffer;
1656 XSETBUFFER (buf, current_buffer);
1657 if (EQ (buf, *pvalbuf))
1659 *pvalbuf = Qnil;
1660 XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
1661 find_symbol_value (variable);
1665 return variable;
1668 /* Lisp functions for creating and removing buffer-local variables. */
1670 DEFUN ("make-variable-frame-local", Fmake_variable_frame_local, Smake_variable_frame_local,
1671 1, 1, "vMake Variable Frame Local: ",
1672 doc: /* Enable VARIABLE to have frame-local bindings.
1673 When a frame-local binding exists in the current frame,
1674 it is in effect whenever the current buffer has no buffer-local binding.
1675 A frame-local binding is actually a frame parameter value;
1676 thus, any given frame has a local binding for VARIABLE if it has
1677 a value for the frame parameter named VARIABLE. Return VARIABLE.
1678 See `modify-frame-parameters' for how to set frame parameters. */)
1679 (variable)
1680 register Lisp_Object variable;
1682 register Lisp_Object tem, valcontents, newval;
1684 CHECK_SYMBOL (variable);
1685 variable = indirect_variable (variable);
1687 valcontents = SYMBOL_VALUE (variable);
1688 if (EQ (variable, Qnil) || EQ (variable, Qt) || KBOARD_OBJFWDP (valcontents)
1689 || BUFFER_OBJFWDP (valcontents))
1690 error ("Symbol %s may not be frame-local", SDATA (SYMBOL_NAME (variable)));
1692 if (BUFFER_LOCAL_VALUEP (valcontents)
1693 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1695 XBUFFER_LOCAL_VALUE (valcontents)->check_frame = 1;
1696 return variable;
1699 if (EQ (valcontents, Qunbound))
1700 SET_SYMBOL_VALUE (variable, Qnil);
1701 tem = Fcons (Qnil, Fsymbol_value (variable));
1702 XSETCAR (tem, tem);
1703 newval = allocate_misc ();
1704 XMISCTYPE (newval) = Lisp_Misc_Some_Buffer_Local_Value;
1705 XBUFFER_LOCAL_VALUE (newval)->realvalue = SYMBOL_VALUE (variable);
1706 XBUFFER_LOCAL_VALUE (newval)->buffer = Qnil;
1707 XBUFFER_LOCAL_VALUE (newval)->frame = Qnil;
1708 XBUFFER_LOCAL_VALUE (newval)->found_for_buffer = 0;
1709 XBUFFER_LOCAL_VALUE (newval)->found_for_frame = 0;
1710 XBUFFER_LOCAL_VALUE (newval)->check_frame = 1;
1711 XBUFFER_LOCAL_VALUE (newval)->cdr = tem;
1712 SET_SYMBOL_VALUE (variable, newval);
1713 return variable;
1716 DEFUN ("local-variable-p", Flocal_variable_p, Slocal_variable_p,
1717 1, 2, 0,
1718 doc: /* Non-nil if VARIABLE has a local binding in buffer BUFFER.
1719 BUFFER defaults to the current buffer. */)
1720 (variable, buffer)
1721 register Lisp_Object variable, buffer;
1723 Lisp_Object valcontents;
1724 register struct buffer *buf;
1726 if (NILP (buffer))
1727 buf = current_buffer;
1728 else
1730 CHECK_BUFFER (buffer);
1731 buf = XBUFFER (buffer);
1734 CHECK_SYMBOL (variable);
1735 variable = indirect_variable (variable);
1737 valcontents = SYMBOL_VALUE (variable);
1738 if (BUFFER_LOCAL_VALUEP (valcontents)
1739 || SOME_BUFFER_LOCAL_VALUEP (valcontents))
1741 Lisp_Object tail, elt;
1743 for (tail = buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1745 elt = XCAR (tail);
1746 if (EQ (variable, XCAR (elt)))
1747 return Qt;
1750 if (BUFFER_OBJFWDP (valcontents))
1752 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1753 int idx = PER_BUFFER_IDX (offset);
1754 if (idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
1755 return Qt;
1757 return Qnil;
1760 DEFUN ("local-variable-if-set-p", Flocal_variable_if_set_p, Slocal_variable_if_set_p,
1761 1, 2, 0,
1762 doc: /* Non-nil if VARIABLE will be local in buffer BUFFER if it is set there.
1763 BUFFER defaults to the current buffer. */)
1764 (variable, buffer)
1765 register Lisp_Object variable, buffer;
1767 Lisp_Object valcontents;
1768 register struct buffer *buf;
1770 if (NILP (buffer))
1771 buf = current_buffer;
1772 else
1774 CHECK_BUFFER (buffer);
1775 buf = XBUFFER (buffer);
1778 CHECK_SYMBOL (variable);
1779 variable = indirect_variable (variable);
1781 valcontents = SYMBOL_VALUE (variable);
1783 /* This means that make-variable-buffer-local was done. */
1784 if (BUFFER_LOCAL_VALUEP (valcontents))
1785 return Qt;
1786 /* All these slots become local if they are set. */
1787 if (BUFFER_OBJFWDP (valcontents))
1788 return Qt;
1789 if (SOME_BUFFER_LOCAL_VALUEP (valcontents))
1791 Lisp_Object tail, elt;
1792 for (tail = buf->local_var_alist; CONSP (tail); tail = XCDR (tail))
1794 elt = XCAR (tail);
1795 if (EQ (variable, XCAR (elt)))
1796 return Qt;
1799 return Qnil;
1802 DEFUN ("variable-binding-locus", Fvariable_binding_locus, Svariable_binding_locus,
1803 1, 1, 0,
1804 doc: /* Return a value indicating where VARIABLE's current binding comes from.
1805 If the current binding is buffer-local, the value is the current buffer.
1806 If the current binding is frame-local, the value is the selected frame.
1807 If the current binding is global (the default), the value is nil. */)
1808 (variable)
1809 register Lisp_Object variable;
1811 Lisp_Object valcontents;
1813 CHECK_SYMBOL (variable);
1814 variable = indirect_variable (variable);
1816 /* Make sure the current binding is actually swapped in. */
1817 find_symbol_value (variable);
1819 valcontents = XSYMBOL (variable)->value;
1821 if (BUFFER_LOCAL_VALUEP (valcontents)
1822 || SOME_BUFFER_LOCAL_VALUEP (valcontents)
1823 || BUFFER_OBJFWDP (valcontents))
1825 /* For a local variable, record both the symbol and which
1826 buffer's or frame's value we are saving. */
1827 if (!NILP (Flocal_variable_p (variable, Qnil)))
1828 return Fcurrent_buffer ();
1829 else if (!BUFFER_OBJFWDP (valcontents)
1830 && XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame)
1831 return XBUFFER_LOCAL_VALUE (valcontents)->frame;
1834 return Qnil;
1837 /* Find the function at the end of a chain of symbol function indirections. */
1839 /* If OBJECT is a symbol, find the end of its function chain and
1840 return the value found there. If OBJECT is not a symbol, just
1841 return it. If there is a cycle in the function chain, signal a
1842 cyclic-function-indirection error.
1844 This is like Findirect_function, except that it doesn't signal an
1845 error if the chain ends up unbound. */
1846 Lisp_Object
1847 indirect_function (object)
1848 register Lisp_Object object;
1850 Lisp_Object tortoise, hare;
1852 hare = tortoise = object;
1854 for (;;)
1856 if (!SYMBOLP (hare) || EQ (hare, Qunbound))
1857 break;
1858 hare = XSYMBOL (hare)->function;
1859 if (!SYMBOLP (hare) || EQ (hare, Qunbound))
1860 break;
1861 hare = XSYMBOL (hare)->function;
1863 tortoise = XSYMBOL (tortoise)->function;
1865 if (EQ (hare, tortoise))
1866 Fsignal (Qcyclic_function_indirection, Fcons (object, Qnil));
1869 return hare;
1872 DEFUN ("indirect-function", Findirect_function, Sindirect_function, 1, 1, 0,
1873 doc: /* Return the function at the end of OBJECT's function chain.
1874 If OBJECT is a symbol, follow all function indirections and return the final
1875 function binding.
1876 If OBJECT is not a symbol, just return it.
1877 Signal a void-function error if the final symbol is unbound.
1878 Signal a cyclic-function-indirection error if there is a loop in the
1879 function chain of symbols. */)
1880 (object)
1881 register Lisp_Object object;
1883 Lisp_Object result;
1885 result = indirect_function (object);
1887 if (EQ (result, Qunbound))
1888 return Fsignal (Qvoid_function, Fcons (object, Qnil));
1889 return result;
1892 /* Extract and set vector and string elements */
1894 DEFUN ("aref", Faref, Saref, 2, 2, 0,
1895 doc: /* Return the element of ARRAY at index IDX.
1896 ARRAY may be a vector, a string, a char-table, a bool-vector,
1897 or a byte-code object. IDX starts at 0. */)
1898 (array, idx)
1899 register Lisp_Object array;
1900 Lisp_Object idx;
1902 register int idxval;
1904 CHECK_NUMBER (idx);
1905 idxval = XINT (idx);
1906 if (STRINGP (array))
1908 int c, idxval_byte;
1910 if (idxval < 0 || idxval >= SCHARS (array))
1911 args_out_of_range (array, idx);
1912 if (! STRING_MULTIBYTE (array))
1913 return make_number ((unsigned char) SREF (array, idxval));
1914 idxval_byte = string_char_to_byte (array, idxval);
1916 c = STRING_CHAR (SDATA (array) + idxval_byte,
1917 SBYTES (array) - idxval_byte);
1918 return make_number (c);
1920 else if (BOOL_VECTOR_P (array))
1922 int val;
1924 if (idxval < 0 || idxval >= XBOOL_VECTOR (array)->size)
1925 args_out_of_range (array, idx);
1927 val = (unsigned char) XBOOL_VECTOR (array)->data[idxval / BITS_PER_CHAR];
1928 return (val & (1 << (idxval % BITS_PER_CHAR)) ? Qt : Qnil);
1930 else if (CHAR_TABLE_P (array))
1932 Lisp_Object val;
1934 val = Qnil;
1936 if (idxval < 0)
1937 args_out_of_range (array, idx);
1938 if (idxval < CHAR_TABLE_ORDINARY_SLOTS)
1940 /* For ASCII and 8-bit European characters, the element is
1941 stored in the top table. */
1942 val = XCHAR_TABLE (array)->contents[idxval];
1943 if (NILP (val))
1944 val = XCHAR_TABLE (array)->defalt;
1945 while (NILP (val)) /* Follow parents until we find some value. */
1947 array = XCHAR_TABLE (array)->parent;
1948 if (NILP (array))
1949 return Qnil;
1950 val = XCHAR_TABLE (array)->contents[idxval];
1951 if (NILP (val))
1952 val = XCHAR_TABLE (array)->defalt;
1954 return val;
1956 else
1958 int code[4], i;
1959 Lisp_Object sub_table;
1961 SPLIT_CHAR (idxval, code[0], code[1], code[2]);
1962 if (code[1] < 32) code[1] = -1;
1963 else if (code[2] < 32) code[2] = -1;
1965 /* Here, the possible range of CODE[0] (== charset ID) is
1966 128..MAX_CHARSET. Since the top level char table contains
1967 data for multibyte characters after 256th element, we must
1968 increment CODE[0] by 128 to get a correct index. */
1969 code[0] += 128;
1970 code[3] = -1; /* anchor */
1972 try_parent_char_table:
1973 sub_table = array;
1974 for (i = 0; code[i] >= 0; i++)
1976 val = XCHAR_TABLE (sub_table)->contents[code[i]];
1977 if (SUB_CHAR_TABLE_P (val))
1978 sub_table = val;
1979 else
1981 if (NILP (val))
1982 val = XCHAR_TABLE (sub_table)->defalt;
1983 if (NILP (val))
1985 array = XCHAR_TABLE (array)->parent;
1986 if (!NILP (array))
1987 goto try_parent_char_table;
1989 return val;
1992 /* Here, VAL is a sub char table. We try the default value
1993 and parent. */
1994 val = XCHAR_TABLE (val)->defalt;
1995 if (NILP (val))
1997 array = XCHAR_TABLE (array)->parent;
1998 if (!NILP (array))
1999 goto try_parent_char_table;
2001 return val;
2004 else
2006 int size = 0;
2007 if (VECTORP (array))
2008 size = XVECTOR (array)->size;
2009 else if (COMPILEDP (array))
2010 size = XVECTOR (array)->size & PSEUDOVECTOR_SIZE_MASK;
2011 else
2012 wrong_type_argument (Qarrayp, array);
2014 if (idxval < 0 || idxval >= size)
2015 args_out_of_range (array, idx);
2016 return XVECTOR (array)->contents[idxval];
2020 /* Don't use alloca for relocating string data larger than this, lest
2021 we overflow their stack. The value is the same as what used in
2022 fns.c for base64 handling. */
2023 #define MAX_ALLOCA 16*1024
2025 DEFUN ("aset", Faset, Saset, 3, 3, 0,
2026 doc: /* Store into the element of ARRAY at index IDX the value NEWELT.
2027 Return NEWELT. ARRAY may be a vector, a string, a char-table or a
2028 bool-vector. IDX starts at 0. */)
2029 (array, idx, newelt)
2030 register Lisp_Object array;
2031 Lisp_Object idx, newelt;
2033 register int idxval;
2035 CHECK_NUMBER (idx);
2036 idxval = XINT (idx);
2037 if (!VECTORP (array) && !STRINGP (array) && !BOOL_VECTOR_P (array)
2038 && ! CHAR_TABLE_P (array))
2039 array = wrong_type_argument (Qarrayp, array);
2040 CHECK_IMPURE (array);
2042 if (VECTORP (array))
2044 if (idxval < 0 || idxval >= XVECTOR (array)->size)
2045 args_out_of_range (array, idx);
2046 XVECTOR (array)->contents[idxval] = newelt;
2048 else if (BOOL_VECTOR_P (array))
2050 int val;
2052 if (idxval < 0 || idxval >= XBOOL_VECTOR (array)->size)
2053 args_out_of_range (array, idx);
2055 val = (unsigned char) XBOOL_VECTOR (array)->data[idxval / BITS_PER_CHAR];
2057 if (! NILP (newelt))
2058 val |= 1 << (idxval % BITS_PER_CHAR);
2059 else
2060 val &= ~(1 << (idxval % BITS_PER_CHAR));
2061 XBOOL_VECTOR (array)->data[idxval / BITS_PER_CHAR] = val;
2063 else if (CHAR_TABLE_P (array))
2065 if (idxval < 0)
2066 args_out_of_range (array, idx);
2067 if (idxval < CHAR_TABLE_ORDINARY_SLOTS)
2068 XCHAR_TABLE (array)->contents[idxval] = newelt;
2069 else
2071 int code[4], i;
2072 Lisp_Object val;
2074 SPLIT_CHAR (idxval, code[0], code[1], code[2]);
2075 if (code[1] < 32) code[1] = -1;
2076 else if (code[2] < 32) code[2] = -1;
2078 /* See the comment of the corresponding part in Faref. */
2079 code[0] += 128;
2080 code[3] = -1; /* anchor */
2081 for (i = 0; code[i + 1] >= 0; i++)
2083 val = XCHAR_TABLE (array)->contents[code[i]];
2084 if (SUB_CHAR_TABLE_P (val))
2085 array = val;
2086 else
2088 Lisp_Object temp;
2090 /* VAL is a leaf. Create a sub char table with the
2091 default value VAL or XCHAR_TABLE (array)->defalt
2092 and look into it. */
2094 temp = make_sub_char_table (NILP (val)
2095 ? XCHAR_TABLE (array)->defalt
2096 : val);
2097 XCHAR_TABLE (array)->contents[code[i]] = temp;
2098 array = temp;
2101 XCHAR_TABLE (array)->contents[code[i]] = newelt;
2104 else if (STRING_MULTIBYTE (array))
2106 int idxval_byte, prev_bytes, new_bytes, nbytes;
2107 unsigned char workbuf[MAX_MULTIBYTE_LENGTH], *p0 = workbuf, *p1;
2109 if (idxval < 0 || idxval >= SCHARS (array))
2110 args_out_of_range (array, idx);
2111 CHECK_NUMBER (newelt);
2113 nbytes = SBYTES (array);
2115 idxval_byte = string_char_to_byte (array, idxval);
2116 p1 = SDATA (array) + idxval_byte;
2117 PARSE_MULTIBYTE_SEQ (p1, nbytes - idxval_byte, prev_bytes);
2118 new_bytes = CHAR_STRING (XINT (newelt), p0);
2119 if (prev_bytes != new_bytes)
2121 /* We must relocate the string data. */
2122 int nchars = SCHARS (array);
2123 unsigned char *str;
2125 str = (nbytes <= MAX_ALLOCA
2126 ? (unsigned char *) alloca (nbytes)
2127 : (unsigned char *) xmalloc (nbytes));
2128 bcopy (SDATA (array), str, nbytes);
2129 allocate_string_data (XSTRING (array), nchars,
2130 nbytes + new_bytes - prev_bytes);
2131 bcopy (str, SDATA (array), idxval_byte);
2132 p1 = SDATA (array) + idxval_byte;
2133 bcopy (str + idxval_byte + prev_bytes, p1 + new_bytes,
2134 nbytes - (idxval_byte + prev_bytes));
2135 if (nbytes > MAX_ALLOCA)
2136 xfree (str);
2137 clear_string_char_byte_cache ();
2139 while (new_bytes--)
2140 *p1++ = *p0++;
2142 else
2144 if (idxval < 0 || idxval >= SCHARS (array))
2145 args_out_of_range (array, idx);
2146 CHECK_NUMBER (newelt);
2148 if (XINT (newelt) < 0 || SINGLE_BYTE_CHAR_P (XINT (newelt)))
2149 SSET (array, idxval, XINT (newelt));
2150 else
2152 /* We must relocate the string data while converting it to
2153 multibyte. */
2154 int idxval_byte, prev_bytes, new_bytes;
2155 unsigned char workbuf[MAX_MULTIBYTE_LENGTH], *p0 = workbuf, *p1;
2156 unsigned char *origstr = SDATA (array), *str;
2157 int nchars, nbytes;
2159 nchars = SCHARS (array);
2160 nbytes = idxval_byte = count_size_as_multibyte (origstr, idxval);
2161 nbytes += count_size_as_multibyte (origstr + idxval,
2162 nchars - idxval);
2163 str = (nbytes <= MAX_ALLOCA
2164 ? (unsigned char *) alloca (nbytes)
2165 : (unsigned char *) xmalloc (nbytes));
2166 copy_text (SDATA (array), str, nchars, 0, 1);
2167 PARSE_MULTIBYTE_SEQ (str + idxval_byte, nbytes - idxval_byte,
2168 prev_bytes);
2169 new_bytes = CHAR_STRING (XINT (newelt), p0);
2170 allocate_string_data (XSTRING (array), nchars,
2171 nbytes + new_bytes - prev_bytes);
2172 bcopy (str, SDATA (array), idxval_byte);
2173 p1 = SDATA (array) + idxval_byte;
2174 while (new_bytes--)
2175 *p1++ = *p0++;
2176 bcopy (str + idxval_byte + prev_bytes, p1,
2177 nbytes - (idxval_byte + prev_bytes));
2178 if (nbytes > MAX_ALLOCA)
2179 xfree (str);
2180 clear_string_char_byte_cache ();
2184 return newelt;
2187 /* Arithmetic functions */
2189 enum comparison { equal, notequal, less, grtr, less_or_equal, grtr_or_equal };
2191 Lisp_Object
2192 arithcompare (num1, num2, comparison)
2193 Lisp_Object num1, num2;
2194 enum comparison comparison;
2196 double f1 = 0, f2 = 0;
2197 int floatp = 0;
2199 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num1);
2200 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num2);
2202 if (FLOATP (num1) || FLOATP (num2))
2204 floatp = 1;
2205 f1 = (FLOATP (num1)) ? XFLOAT_DATA (num1) : XINT (num1);
2206 f2 = (FLOATP (num2)) ? XFLOAT_DATA (num2) : XINT (num2);
2209 switch (comparison)
2211 case equal:
2212 if (floatp ? f1 == f2 : XINT (num1) == XINT (num2))
2213 return Qt;
2214 return Qnil;
2216 case notequal:
2217 if (floatp ? f1 != f2 : XINT (num1) != XINT (num2))
2218 return Qt;
2219 return Qnil;
2221 case less:
2222 if (floatp ? f1 < f2 : XINT (num1) < XINT (num2))
2223 return Qt;
2224 return Qnil;
2226 case less_or_equal:
2227 if (floatp ? f1 <= f2 : XINT (num1) <= XINT (num2))
2228 return Qt;
2229 return Qnil;
2231 case grtr:
2232 if (floatp ? f1 > f2 : XINT (num1) > XINT (num2))
2233 return Qt;
2234 return Qnil;
2236 case grtr_or_equal:
2237 if (floatp ? f1 >= f2 : XINT (num1) >= XINT (num2))
2238 return Qt;
2239 return Qnil;
2241 default:
2242 abort ();
2246 DEFUN ("=", Feqlsign, Seqlsign, 2, 2, 0,
2247 doc: /* Return t if two args, both numbers or markers, are equal. */)
2248 (num1, num2)
2249 register Lisp_Object num1, num2;
2251 return arithcompare (num1, num2, equal);
2254 DEFUN ("<", Flss, Slss, 2, 2, 0,
2255 doc: /* Return t if first arg is less than second arg. Both must be numbers or markers. */)
2256 (num1, num2)
2257 register Lisp_Object num1, num2;
2259 return arithcompare (num1, num2, less);
2262 DEFUN (">", Fgtr, Sgtr, 2, 2, 0,
2263 doc: /* Return t if first arg is greater than second arg. Both must be numbers or markers. */)
2264 (num1, num2)
2265 register Lisp_Object num1, num2;
2267 return arithcompare (num1, num2, grtr);
2270 DEFUN ("<=", Fleq, Sleq, 2, 2, 0,
2271 doc: /* Return t if first arg is less than or equal to second arg.
2272 Both must be numbers or markers. */)
2273 (num1, num2)
2274 register Lisp_Object num1, num2;
2276 return arithcompare (num1, num2, less_or_equal);
2279 DEFUN (">=", Fgeq, Sgeq, 2, 2, 0,
2280 doc: /* Return t if first arg is greater than or equal to second arg.
2281 Both must be numbers or markers. */)
2282 (num1, num2)
2283 register Lisp_Object num1, num2;
2285 return arithcompare (num1, num2, grtr_or_equal);
2288 DEFUN ("/=", Fneq, Sneq, 2, 2, 0,
2289 doc: /* Return t if first arg is not equal to second arg. Both must be numbers or markers. */)
2290 (num1, num2)
2291 register Lisp_Object num1, num2;
2293 return arithcompare (num1, num2, notequal);
2296 DEFUN ("zerop", Fzerop, Szerop, 1, 1, 0,
2297 doc: /* Return t if NUMBER is zero. */)
2298 (number)
2299 register Lisp_Object number;
2301 CHECK_NUMBER_OR_FLOAT (number);
2303 if (FLOATP (number))
2305 if (XFLOAT_DATA (number) == 0.0)
2306 return Qt;
2307 return Qnil;
2310 if (!XINT (number))
2311 return Qt;
2312 return Qnil;
2315 /* Convert between long values and pairs of Lisp integers. */
2317 Lisp_Object
2318 long_to_cons (i)
2319 unsigned long i;
2321 unsigned long top = i >> 16;
2322 unsigned int bot = i & 0xFFFF;
2323 if (top == 0)
2324 return make_number (bot);
2325 if (top == (unsigned long)-1 >> 16)
2326 return Fcons (make_number (-1), make_number (bot));
2327 return Fcons (make_number (top), make_number (bot));
2330 unsigned long
2331 cons_to_long (c)
2332 Lisp_Object c;
2334 Lisp_Object top, bot;
2335 if (INTEGERP (c))
2336 return XINT (c);
2337 top = XCAR (c);
2338 bot = XCDR (c);
2339 if (CONSP (bot))
2340 bot = XCAR (bot);
2341 return ((XINT (top) << 16) | XINT (bot));
2344 DEFUN ("number-to-string", Fnumber_to_string, Snumber_to_string, 1, 1, 0,
2345 doc: /* Return the decimal representation of NUMBER as a string.
2346 Uses a minus sign if negative.
2347 NUMBER may be an integer or a floating point number. */)
2348 (number)
2349 Lisp_Object number;
2351 char buffer[VALBITS];
2353 CHECK_NUMBER_OR_FLOAT (number);
2355 if (FLOATP (number))
2357 char pigbuf[350]; /* see comments in float_to_string */
2359 float_to_string (pigbuf, XFLOAT_DATA (number));
2360 return build_string (pigbuf);
2363 if (sizeof (int) == sizeof (EMACS_INT))
2364 sprintf (buffer, "%d", XINT (number));
2365 else if (sizeof (long) == sizeof (EMACS_INT))
2366 sprintf (buffer, "%ld", (long) XINT (number));
2367 else
2368 abort ();
2369 return build_string (buffer);
2372 INLINE static int
2373 digit_to_number (character, base)
2374 int character, base;
2376 int digit;
2378 if (character >= '0' && character <= '9')
2379 digit = character - '0';
2380 else if (character >= 'a' && character <= 'z')
2381 digit = character - 'a' + 10;
2382 else if (character >= 'A' && character <= 'Z')
2383 digit = character - 'A' + 10;
2384 else
2385 return -1;
2387 if (digit >= base)
2388 return -1;
2389 else
2390 return digit;
2393 DEFUN ("string-to-number", Fstring_to_number, Sstring_to_number, 1, 2, 0,
2394 doc: /* Parse STRING as a decimal number and return the number.
2395 This parses both integers and floating point numbers.
2396 It ignores leading spaces and tabs.
2398 If BASE, interpret STRING as a number in that base. If BASE isn't
2399 present, base 10 is used. BASE must be between 2 and 16 (inclusive).
2400 If the base used is not 10, floating point is not recognized. */)
2401 (string, base)
2402 register Lisp_Object string, base;
2404 register unsigned char *p;
2405 register int b;
2406 int sign = 1;
2407 Lisp_Object val;
2409 CHECK_STRING (string);
2411 if (NILP (base))
2412 b = 10;
2413 else
2415 CHECK_NUMBER (base);
2416 b = XINT (base);
2417 if (b < 2 || b > 16)
2418 Fsignal (Qargs_out_of_range, Fcons (base, Qnil));
2421 /* Skip any whitespace at the front of the number. Some versions of
2422 atoi do this anyway, so we might as well make Emacs lisp consistent. */
2423 p = SDATA (string);
2424 while (*p == ' ' || *p == '\t')
2425 p++;
2427 if (*p == '-')
2429 sign = -1;
2430 p++;
2432 else if (*p == '+')
2433 p++;
2435 if (isfloat_string (p) && b == 10)
2436 val = make_float (sign * atof (p));
2437 else
2439 double v = 0;
2441 while (1)
2443 int digit = digit_to_number (*p++, b);
2444 if (digit < 0)
2445 break;
2446 v = v * b + digit;
2449 val = make_fixnum_or_float (sign * v);
2452 return val;
2456 enum arithop
2458 Aadd,
2459 Asub,
2460 Amult,
2461 Adiv,
2462 Alogand,
2463 Alogior,
2464 Alogxor,
2465 Amax,
2466 Amin
2469 static Lisp_Object float_arith_driver P_ ((double, int, enum arithop,
2470 int, Lisp_Object *));
2471 extern Lisp_Object fmod_float ();
2473 Lisp_Object
2474 arith_driver (code, nargs, args)
2475 enum arithop code;
2476 int nargs;
2477 register Lisp_Object *args;
2479 register Lisp_Object val;
2480 register int argnum;
2481 register EMACS_INT accum = 0;
2482 register EMACS_INT next;
2484 switch (SWITCH_ENUM_CAST (code))
2486 case Alogior:
2487 case Alogxor:
2488 case Aadd:
2489 case Asub:
2490 accum = 0;
2491 break;
2492 case Amult:
2493 accum = 1;
2494 break;
2495 case Alogand:
2496 accum = -1;
2497 break;
2498 default:
2499 break;
2502 for (argnum = 0; argnum < nargs; argnum++)
2504 /* Using args[argnum] as argument to CHECK_NUMBER_... */
2505 val = args[argnum];
2506 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2508 if (FLOATP (val))
2509 return float_arith_driver ((double) accum, argnum, code,
2510 nargs, args);
2511 args[argnum] = val;
2512 next = XINT (args[argnum]);
2513 switch (SWITCH_ENUM_CAST (code))
2515 case Aadd:
2516 accum += next;
2517 break;
2518 case Asub:
2519 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2520 break;
2521 case Amult:
2522 accum *= next;
2523 break;
2524 case Adiv:
2525 if (!argnum)
2526 accum = next;
2527 else
2529 if (next == 0)
2530 Fsignal (Qarith_error, Qnil);
2531 accum /= next;
2533 break;
2534 case Alogand:
2535 accum &= next;
2536 break;
2537 case Alogior:
2538 accum |= next;
2539 break;
2540 case Alogxor:
2541 accum ^= next;
2542 break;
2543 case Amax:
2544 if (!argnum || next > accum)
2545 accum = next;
2546 break;
2547 case Amin:
2548 if (!argnum || next < accum)
2549 accum = next;
2550 break;
2554 XSETINT (val, accum);
2555 return val;
2558 #undef isnan
2559 #define isnan(x) ((x) != (x))
2561 static Lisp_Object
2562 float_arith_driver (accum, argnum, code, nargs, args)
2563 double accum;
2564 register int argnum;
2565 enum arithop code;
2566 int nargs;
2567 register Lisp_Object *args;
2569 register Lisp_Object val;
2570 double next;
2572 for (; argnum < nargs; argnum++)
2574 val = args[argnum]; /* using args[argnum] as argument to CHECK_NUMBER_... */
2575 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2577 if (FLOATP (val))
2579 next = XFLOAT_DATA (val);
2581 else
2583 args[argnum] = val; /* runs into a compiler bug. */
2584 next = XINT (args[argnum]);
2586 switch (SWITCH_ENUM_CAST (code))
2588 case Aadd:
2589 accum += next;
2590 break;
2591 case Asub:
2592 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2593 break;
2594 case Amult:
2595 accum *= next;
2596 break;
2597 case Adiv:
2598 if (!argnum)
2599 accum = next;
2600 else
2602 if (! IEEE_FLOATING_POINT && next == 0)
2603 Fsignal (Qarith_error, Qnil);
2604 accum /= next;
2606 break;
2607 case Alogand:
2608 case Alogior:
2609 case Alogxor:
2610 return wrong_type_argument (Qinteger_or_marker_p, val);
2611 case Amax:
2612 if (!argnum || isnan (next) || next > accum)
2613 accum = next;
2614 break;
2615 case Amin:
2616 if (!argnum || isnan (next) || next < accum)
2617 accum = next;
2618 break;
2622 return make_float (accum);
2626 DEFUN ("+", Fplus, Splus, 0, MANY, 0,
2627 doc: /* Return sum of any number of arguments, which are numbers or markers.
2628 usage: (+ &rest NUMBERS-OR-MARKERS) */)
2629 (nargs, args)
2630 int nargs;
2631 Lisp_Object *args;
2633 return arith_driver (Aadd, nargs, args);
2636 DEFUN ("-", Fminus, Sminus, 0, MANY, 0,
2637 doc: /* Negate number or subtract numbers or markers and return the result.
2638 With one arg, negates it. With more than one arg,
2639 subtracts all but the first from the first.
2640 usage: (- &optional NUMBER-OR-MARKER &rest MORE-NUMBERS-OR-MARKERS) */)
2641 (nargs, args)
2642 int nargs;
2643 Lisp_Object *args;
2645 return arith_driver (Asub, nargs, args);
2648 DEFUN ("*", Ftimes, Stimes, 0, MANY, 0,
2649 doc: /* Return product of any number of arguments, which are numbers or markers.
2650 usage: (* &rest NUMBERS-OR-MARKERS) */)
2651 (nargs, args)
2652 int nargs;
2653 Lisp_Object *args;
2655 return arith_driver (Amult, nargs, args);
2658 DEFUN ("/", Fquo, Squo, 2, MANY, 0,
2659 doc: /* Return first argument divided by all the remaining arguments.
2660 The arguments must be numbers or markers.
2661 usage: (/ DIVIDEND DIVISOR &rest DIVISORS) */)
2662 (nargs, args)
2663 int nargs;
2664 Lisp_Object *args;
2666 return arith_driver (Adiv, nargs, args);
2669 DEFUN ("%", Frem, Srem, 2, 2, 0,
2670 doc: /* Return remainder of X divided by Y.
2671 Both must be integers or markers. */)
2672 (x, y)
2673 register Lisp_Object x, y;
2675 Lisp_Object val;
2677 CHECK_NUMBER_COERCE_MARKER (x);
2678 CHECK_NUMBER_COERCE_MARKER (y);
2680 if (XFASTINT (y) == 0)
2681 Fsignal (Qarith_error, Qnil);
2683 XSETINT (val, XINT (x) % XINT (y));
2684 return val;
2687 #ifndef HAVE_FMOD
2688 double
2689 fmod (f1, f2)
2690 double f1, f2;
2692 double r = f1;
2694 if (f2 < 0.0)
2695 f2 = -f2;
2697 /* If the magnitude of the result exceeds that of the divisor, or
2698 the sign of the result does not agree with that of the dividend,
2699 iterate with the reduced value. This does not yield a
2700 particularly accurate result, but at least it will be in the
2701 range promised by fmod. */
2703 r -= f2 * floor (r / f2);
2704 while (f2 <= (r < 0 ? -r : r) || ((r < 0) != (f1 < 0) && ! isnan (r)));
2706 return r;
2708 #endif /* ! HAVE_FMOD */
2710 DEFUN ("mod", Fmod, Smod, 2, 2, 0,
2711 doc: /* Return X modulo Y.
2712 The result falls between zero (inclusive) and Y (exclusive).
2713 Both X and Y must be numbers or markers. */)
2714 (x, y)
2715 register Lisp_Object x, y;
2717 Lisp_Object val;
2718 EMACS_INT i1, i2;
2720 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (x);
2721 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (y);
2723 if (FLOATP (x) || FLOATP (y))
2724 return fmod_float (x, y);
2726 i1 = XINT (x);
2727 i2 = XINT (y);
2729 if (i2 == 0)
2730 Fsignal (Qarith_error, Qnil);
2732 i1 %= i2;
2734 /* If the "remainder" comes out with the wrong sign, fix it. */
2735 if (i2 < 0 ? i1 > 0 : i1 < 0)
2736 i1 += i2;
2738 XSETINT (val, i1);
2739 return val;
2742 DEFUN ("max", Fmax, Smax, 1, MANY, 0,
2743 doc: /* Return largest of all the arguments (which must be numbers or markers).
2744 The value is always a number; markers are converted to numbers.
2745 usage: (max NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2746 (nargs, args)
2747 int nargs;
2748 Lisp_Object *args;
2750 return arith_driver (Amax, nargs, args);
2753 DEFUN ("min", Fmin, Smin, 1, MANY, 0,
2754 doc: /* Return smallest of all the arguments (which must be numbers or markers).
2755 The value is always a number; markers are converted to numbers.
2756 usage: (min NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2757 (nargs, args)
2758 int nargs;
2759 Lisp_Object *args;
2761 return arith_driver (Amin, nargs, args);
2764 DEFUN ("logand", Flogand, Slogand, 0, MANY, 0,
2765 doc: /* Return bitwise-and of all the arguments.
2766 Arguments may be integers, or markers converted to integers.
2767 usage: (logand &rest INTS-OR-MARKERS) */)
2768 (nargs, args)
2769 int nargs;
2770 Lisp_Object *args;
2772 return arith_driver (Alogand, nargs, args);
2775 DEFUN ("logior", Flogior, Slogior, 0, MANY, 0,
2776 doc: /* Return bitwise-or of all the arguments.
2777 Arguments may be integers, or markers converted to integers.
2778 usage: (logior &rest INTS-OR-MARKERS) */)
2779 (nargs, args)
2780 int nargs;
2781 Lisp_Object *args;
2783 return arith_driver (Alogior, nargs, args);
2786 DEFUN ("logxor", Flogxor, Slogxor, 0, MANY, 0,
2787 doc: /* Return bitwise-exclusive-or of all the arguments.
2788 Arguments may be integers, or markers converted to integers.
2789 usage: (logxor &rest INTS-OR-MARKERS) */)
2790 (nargs, args)
2791 int nargs;
2792 Lisp_Object *args;
2794 return arith_driver (Alogxor, nargs, args);
2797 DEFUN ("ash", Fash, Sash, 2, 2, 0,
2798 doc: /* Return VALUE with its bits shifted left by COUNT.
2799 If COUNT is negative, shifting is actually to the right.
2800 In this case, the sign bit is duplicated. */)
2801 (value, count)
2802 register Lisp_Object value, count;
2804 register Lisp_Object val;
2806 CHECK_NUMBER (value);
2807 CHECK_NUMBER (count);
2809 if (XINT (count) >= BITS_PER_EMACS_INT)
2810 XSETINT (val, 0);
2811 else if (XINT (count) > 0)
2812 XSETINT (val, XINT (value) << XFASTINT (count));
2813 else if (XINT (count) <= -BITS_PER_EMACS_INT)
2814 XSETINT (val, XINT (value) < 0 ? -1 : 0);
2815 else
2816 XSETINT (val, XINT (value) >> -XINT (count));
2817 return val;
2820 DEFUN ("lsh", Flsh, Slsh, 2, 2, 0,
2821 doc: /* Return VALUE with its bits shifted left by COUNT.
2822 If COUNT is negative, shifting is actually to the right.
2823 In this case, zeros are shifted in on the left. */)
2824 (value, count)
2825 register Lisp_Object value, count;
2827 register Lisp_Object val;
2829 CHECK_NUMBER (value);
2830 CHECK_NUMBER (count);
2832 if (XINT (count) >= BITS_PER_EMACS_INT)
2833 XSETINT (val, 0);
2834 else if (XINT (count) > 0)
2835 XSETINT (val, (EMACS_UINT) XUINT (value) << XFASTINT (count));
2836 else if (XINT (count) <= -BITS_PER_EMACS_INT)
2837 XSETINT (val, 0);
2838 else
2839 XSETINT (val, (EMACS_UINT) XUINT (value) >> -XINT (count));
2840 return val;
2843 DEFUN ("1+", Fadd1, Sadd1, 1, 1, 0,
2844 doc: /* Return NUMBER plus one. NUMBER may be a number or a marker.
2845 Markers are converted to integers. */)
2846 (number)
2847 register Lisp_Object number;
2849 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
2851 if (FLOATP (number))
2852 return (make_float (1.0 + XFLOAT_DATA (number)));
2854 XSETINT (number, XINT (number) + 1);
2855 return number;
2858 DEFUN ("1-", Fsub1, Ssub1, 1, 1, 0,
2859 doc: /* Return NUMBER minus one. NUMBER may be a number or a marker.
2860 Markers are converted to integers. */)
2861 (number)
2862 register Lisp_Object number;
2864 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
2866 if (FLOATP (number))
2867 return (make_float (-1.0 + XFLOAT_DATA (number)));
2869 XSETINT (number, XINT (number) - 1);
2870 return number;
2873 DEFUN ("lognot", Flognot, Slognot, 1, 1, 0,
2874 doc: /* Return the bitwise complement of NUMBER. NUMBER must be an integer. */)
2875 (number)
2876 register Lisp_Object number;
2878 CHECK_NUMBER (number);
2879 XSETINT (number, ~XINT (number));
2880 return number;
2883 DEFUN ("byteorder", Fbyteorder, Sbyteorder, 0, 0, 0,
2884 doc: /* Return the byteorder for the machine.
2885 Returns 66 (ASCII uppercase B) for big endian machines or 108 (ASCII
2886 lowercase l) for small endian machines. */)
2889 unsigned i = 0x04030201;
2890 int order = *(char *)&i == 4 ? 66 : 108;
2892 return make_number (order);
2897 void
2898 syms_of_data ()
2900 Lisp_Object error_tail, arith_tail;
2902 Qquote = intern ("quote");
2903 Qlambda = intern ("lambda");
2904 Qsubr = intern ("subr");
2905 Qerror_conditions = intern ("error-conditions");
2906 Qerror_message = intern ("error-message");
2907 Qtop_level = intern ("top-level");
2909 Qerror = intern ("error");
2910 Qquit = intern ("quit");
2911 Qwrong_type_argument = intern ("wrong-type-argument");
2912 Qargs_out_of_range = intern ("args-out-of-range");
2913 Qvoid_function = intern ("void-function");
2914 Qcyclic_function_indirection = intern ("cyclic-function-indirection");
2915 Qcyclic_variable_indirection = intern ("cyclic-variable-indirection");
2916 Qvoid_variable = intern ("void-variable");
2917 Qsetting_constant = intern ("setting-constant");
2918 Qinvalid_read_syntax = intern ("invalid-read-syntax");
2920 Qinvalid_function = intern ("invalid-function");
2921 Qwrong_number_of_arguments = intern ("wrong-number-of-arguments");
2922 Qno_catch = intern ("no-catch");
2923 Qend_of_file = intern ("end-of-file");
2924 Qarith_error = intern ("arith-error");
2925 Qbeginning_of_buffer = intern ("beginning-of-buffer");
2926 Qend_of_buffer = intern ("end-of-buffer");
2927 Qbuffer_read_only = intern ("buffer-read-only");
2928 Qtext_read_only = intern ("text-read-only");
2929 Qmark_inactive = intern ("mark-inactive");
2931 Qlistp = intern ("listp");
2932 Qconsp = intern ("consp");
2933 Qsymbolp = intern ("symbolp");
2934 Qkeywordp = intern ("keywordp");
2935 Qintegerp = intern ("integerp");
2936 Qnatnump = intern ("natnump");
2937 Qwholenump = intern ("wholenump");
2938 Qstringp = intern ("stringp");
2939 Qarrayp = intern ("arrayp");
2940 Qsequencep = intern ("sequencep");
2941 Qbufferp = intern ("bufferp");
2942 Qvectorp = intern ("vectorp");
2943 Qchar_or_string_p = intern ("char-or-string-p");
2944 Qmarkerp = intern ("markerp");
2945 Qbuffer_or_string_p = intern ("buffer-or-string-p");
2946 Qinteger_or_marker_p = intern ("integer-or-marker-p");
2947 Qboundp = intern ("boundp");
2948 Qfboundp = intern ("fboundp");
2950 Qfloatp = intern ("floatp");
2951 Qnumberp = intern ("numberp");
2952 Qnumber_or_marker_p = intern ("number-or-marker-p");
2954 Qchar_table_p = intern ("char-table-p");
2955 Qvector_or_char_table_p = intern ("vector-or-char-table-p");
2957 Qsubrp = intern ("subrp");
2958 Qunevalled = intern ("unevalled");
2959 Qmany = intern ("many");
2961 Qcdr = intern ("cdr");
2963 /* Handle automatic advice activation */
2964 Qad_advice_info = intern ("ad-advice-info");
2965 Qad_activate_internal = intern ("ad-activate-internal");
2967 error_tail = Fcons (Qerror, Qnil);
2969 /* ERROR is used as a signaler for random errors for which nothing else is right */
2971 Fput (Qerror, Qerror_conditions,
2972 error_tail);
2973 Fput (Qerror, Qerror_message,
2974 build_string ("error"));
2976 Fput (Qquit, Qerror_conditions,
2977 Fcons (Qquit, Qnil));
2978 Fput (Qquit, Qerror_message,
2979 build_string ("Quit"));
2981 Fput (Qwrong_type_argument, Qerror_conditions,
2982 Fcons (Qwrong_type_argument, error_tail));
2983 Fput (Qwrong_type_argument, Qerror_message,
2984 build_string ("Wrong type argument"));
2986 Fput (Qargs_out_of_range, Qerror_conditions,
2987 Fcons (Qargs_out_of_range, error_tail));
2988 Fput (Qargs_out_of_range, Qerror_message,
2989 build_string ("Args out of range"));
2991 Fput (Qvoid_function, Qerror_conditions,
2992 Fcons (Qvoid_function, error_tail));
2993 Fput (Qvoid_function, Qerror_message,
2994 build_string ("Symbol's function definition is void"));
2996 Fput (Qcyclic_function_indirection, Qerror_conditions,
2997 Fcons (Qcyclic_function_indirection, error_tail));
2998 Fput (Qcyclic_function_indirection, Qerror_message,
2999 build_string ("Symbol's chain of function indirections contains a loop"));
3001 Fput (Qcyclic_variable_indirection, Qerror_conditions,
3002 Fcons (Qcyclic_variable_indirection, error_tail));
3003 Fput (Qcyclic_variable_indirection, Qerror_message,
3004 build_string ("Symbol's chain of variable indirections contains a loop"));
3006 Qcircular_list = intern ("circular-list");
3007 staticpro (&Qcircular_list);
3008 Fput (Qcircular_list, Qerror_conditions,
3009 Fcons (Qcircular_list, error_tail));
3010 Fput (Qcircular_list, Qerror_message,
3011 build_string ("List contains a loop"));
3013 Fput (Qvoid_variable, Qerror_conditions,
3014 Fcons (Qvoid_variable, error_tail));
3015 Fput (Qvoid_variable, Qerror_message,
3016 build_string ("Symbol's value as variable is void"));
3018 Fput (Qsetting_constant, Qerror_conditions,
3019 Fcons (Qsetting_constant, error_tail));
3020 Fput (Qsetting_constant, Qerror_message,
3021 build_string ("Attempt to set a constant symbol"));
3023 Fput (Qinvalid_read_syntax, Qerror_conditions,
3024 Fcons (Qinvalid_read_syntax, error_tail));
3025 Fput (Qinvalid_read_syntax, Qerror_message,
3026 build_string ("Invalid read syntax"));
3028 Fput (Qinvalid_function, Qerror_conditions,
3029 Fcons (Qinvalid_function, error_tail));
3030 Fput (Qinvalid_function, Qerror_message,
3031 build_string ("Invalid function"));
3033 Fput (Qwrong_number_of_arguments, Qerror_conditions,
3034 Fcons (Qwrong_number_of_arguments, error_tail));
3035 Fput (Qwrong_number_of_arguments, Qerror_message,
3036 build_string ("Wrong number of arguments"));
3038 Fput (Qno_catch, Qerror_conditions,
3039 Fcons (Qno_catch, error_tail));
3040 Fput (Qno_catch, Qerror_message,
3041 build_string ("No catch for tag"));
3043 Fput (Qend_of_file, Qerror_conditions,
3044 Fcons (Qend_of_file, error_tail));
3045 Fput (Qend_of_file, Qerror_message,
3046 build_string ("End of file during parsing"));
3048 arith_tail = Fcons (Qarith_error, error_tail);
3049 Fput (Qarith_error, Qerror_conditions,
3050 arith_tail);
3051 Fput (Qarith_error, Qerror_message,
3052 build_string ("Arithmetic error"));
3054 Fput (Qbeginning_of_buffer, Qerror_conditions,
3055 Fcons (Qbeginning_of_buffer, error_tail));
3056 Fput (Qbeginning_of_buffer, Qerror_message,
3057 build_string ("Beginning of buffer"));
3059 Fput (Qend_of_buffer, Qerror_conditions,
3060 Fcons (Qend_of_buffer, error_tail));
3061 Fput (Qend_of_buffer, Qerror_message,
3062 build_string ("End of buffer"));
3064 Fput (Qbuffer_read_only, Qerror_conditions,
3065 Fcons (Qbuffer_read_only, error_tail));
3066 Fput (Qbuffer_read_only, Qerror_message,
3067 build_string ("Buffer is read-only"));
3069 Fput (Qtext_read_only, Qerror_conditions,
3070 Fcons (Qtext_read_only, error_tail));
3071 Fput (Qtext_read_only, Qerror_message,
3072 build_string ("Text is read-only"));
3074 Qrange_error = intern ("range-error");
3075 Qdomain_error = intern ("domain-error");
3076 Qsingularity_error = intern ("singularity-error");
3077 Qoverflow_error = intern ("overflow-error");
3078 Qunderflow_error = intern ("underflow-error");
3080 Fput (Qdomain_error, Qerror_conditions,
3081 Fcons (Qdomain_error, arith_tail));
3082 Fput (Qdomain_error, Qerror_message,
3083 build_string ("Arithmetic domain error"));
3085 Fput (Qrange_error, Qerror_conditions,
3086 Fcons (Qrange_error, arith_tail));
3087 Fput (Qrange_error, Qerror_message,
3088 build_string ("Arithmetic range error"));
3090 Fput (Qsingularity_error, Qerror_conditions,
3091 Fcons (Qsingularity_error, Fcons (Qdomain_error, arith_tail)));
3092 Fput (Qsingularity_error, Qerror_message,
3093 build_string ("Arithmetic singularity error"));
3095 Fput (Qoverflow_error, Qerror_conditions,
3096 Fcons (Qoverflow_error, Fcons (Qdomain_error, arith_tail)));
3097 Fput (Qoverflow_error, Qerror_message,
3098 build_string ("Arithmetic overflow error"));
3100 Fput (Qunderflow_error, Qerror_conditions,
3101 Fcons (Qunderflow_error, Fcons (Qdomain_error, arith_tail)));
3102 Fput (Qunderflow_error, Qerror_message,
3103 build_string ("Arithmetic underflow error"));
3105 staticpro (&Qrange_error);
3106 staticpro (&Qdomain_error);
3107 staticpro (&Qsingularity_error);
3108 staticpro (&Qoverflow_error);
3109 staticpro (&Qunderflow_error);
3111 staticpro (&Qnil);
3112 staticpro (&Qt);
3113 staticpro (&Qquote);
3114 staticpro (&Qlambda);
3115 staticpro (&Qsubr);
3116 staticpro (&Qunbound);
3117 staticpro (&Qerror_conditions);
3118 staticpro (&Qerror_message);
3119 staticpro (&Qtop_level);
3121 staticpro (&Qerror);
3122 staticpro (&Qquit);
3123 staticpro (&Qwrong_type_argument);
3124 staticpro (&Qargs_out_of_range);
3125 staticpro (&Qvoid_function);
3126 staticpro (&Qcyclic_function_indirection);
3127 staticpro (&Qvoid_variable);
3128 staticpro (&Qsetting_constant);
3129 staticpro (&Qinvalid_read_syntax);
3130 staticpro (&Qwrong_number_of_arguments);
3131 staticpro (&Qinvalid_function);
3132 staticpro (&Qno_catch);
3133 staticpro (&Qend_of_file);
3134 staticpro (&Qarith_error);
3135 staticpro (&Qbeginning_of_buffer);
3136 staticpro (&Qend_of_buffer);
3137 staticpro (&Qbuffer_read_only);
3138 staticpro (&Qtext_read_only);
3139 staticpro (&Qmark_inactive);
3141 staticpro (&Qlistp);
3142 staticpro (&Qconsp);
3143 staticpro (&Qsymbolp);
3144 staticpro (&Qkeywordp);
3145 staticpro (&Qintegerp);
3146 staticpro (&Qnatnump);
3147 staticpro (&Qwholenump);
3148 staticpro (&Qstringp);
3149 staticpro (&Qarrayp);
3150 staticpro (&Qsequencep);
3151 staticpro (&Qbufferp);
3152 staticpro (&Qvectorp);
3153 staticpro (&Qchar_or_string_p);
3154 staticpro (&Qmarkerp);
3155 staticpro (&Qbuffer_or_string_p);
3156 staticpro (&Qinteger_or_marker_p);
3157 staticpro (&Qfloatp);
3158 staticpro (&Qnumberp);
3159 staticpro (&Qnumber_or_marker_p);
3160 staticpro (&Qchar_table_p);
3161 staticpro (&Qvector_or_char_table_p);
3162 staticpro (&Qsubrp);
3163 staticpro (&Qmany);
3164 staticpro (&Qunevalled);
3166 staticpro (&Qboundp);
3167 staticpro (&Qfboundp);
3168 staticpro (&Qcdr);
3169 staticpro (&Qad_advice_info);
3170 staticpro (&Qad_activate_internal);
3172 /* Types that type-of returns. */
3173 Qinteger = intern ("integer");
3174 Qsymbol = intern ("symbol");
3175 Qstring = intern ("string");
3176 Qcons = intern ("cons");
3177 Qmarker = intern ("marker");
3178 Qoverlay = intern ("overlay");
3179 Qfloat = intern ("float");
3180 Qwindow_configuration = intern ("window-configuration");
3181 Qprocess = intern ("process");
3182 Qwindow = intern ("window");
3183 /* Qsubr = intern ("subr"); */
3184 Qcompiled_function = intern ("compiled-function");
3185 Qbuffer = intern ("buffer");
3186 Qframe = intern ("frame");
3187 Qvector = intern ("vector");
3188 Qchar_table = intern ("char-table");
3189 Qbool_vector = intern ("bool-vector");
3190 Qhash_table = intern ("hash-table");
3192 staticpro (&Qinteger);
3193 staticpro (&Qsymbol);
3194 staticpro (&Qstring);
3195 staticpro (&Qcons);
3196 staticpro (&Qmarker);
3197 staticpro (&Qoverlay);
3198 staticpro (&Qfloat);
3199 staticpro (&Qwindow_configuration);
3200 staticpro (&Qprocess);
3201 staticpro (&Qwindow);
3202 /* staticpro (&Qsubr); */
3203 staticpro (&Qcompiled_function);
3204 staticpro (&Qbuffer);
3205 staticpro (&Qframe);
3206 staticpro (&Qvector);
3207 staticpro (&Qchar_table);
3208 staticpro (&Qbool_vector);
3209 staticpro (&Qhash_table);
3211 defsubr (&Sindirect_variable);
3212 defsubr (&Ssubr_interactive_form);
3213 defsubr (&Seq);
3214 defsubr (&Snull);
3215 defsubr (&Stype_of);
3216 defsubr (&Slistp);
3217 defsubr (&Snlistp);
3218 defsubr (&Sconsp);
3219 defsubr (&Satom);
3220 defsubr (&Sintegerp);
3221 defsubr (&Sinteger_or_marker_p);
3222 defsubr (&Snumberp);
3223 defsubr (&Snumber_or_marker_p);
3224 defsubr (&Sfloatp);
3225 defsubr (&Snatnump);
3226 defsubr (&Ssymbolp);
3227 defsubr (&Skeywordp);
3228 defsubr (&Sstringp);
3229 defsubr (&Smultibyte_string_p);
3230 defsubr (&Svectorp);
3231 defsubr (&Schar_table_p);
3232 defsubr (&Svector_or_char_table_p);
3233 defsubr (&Sbool_vector_p);
3234 defsubr (&Sarrayp);
3235 defsubr (&Ssequencep);
3236 defsubr (&Sbufferp);
3237 defsubr (&Smarkerp);
3238 defsubr (&Ssubrp);
3239 defsubr (&Sbyte_code_function_p);
3240 defsubr (&Schar_or_string_p);
3241 defsubr (&Scar);
3242 defsubr (&Scdr);
3243 defsubr (&Scar_safe);
3244 defsubr (&Scdr_safe);
3245 defsubr (&Ssetcar);
3246 defsubr (&Ssetcdr);
3247 defsubr (&Ssymbol_function);
3248 defsubr (&Sindirect_function);
3249 defsubr (&Ssymbol_plist);
3250 defsubr (&Ssymbol_name);
3251 defsubr (&Smakunbound);
3252 defsubr (&Sfmakunbound);
3253 defsubr (&Sboundp);
3254 defsubr (&Sfboundp);
3255 defsubr (&Sfset);
3256 defsubr (&Sdefalias);
3257 defsubr (&Ssetplist);
3258 defsubr (&Ssymbol_value);
3259 defsubr (&Sset);
3260 defsubr (&Sdefault_boundp);
3261 defsubr (&Sdefault_value);
3262 defsubr (&Sset_default);
3263 defsubr (&Ssetq_default);
3264 defsubr (&Smake_variable_buffer_local);
3265 defsubr (&Smake_local_variable);
3266 defsubr (&Skill_local_variable);
3267 defsubr (&Smake_variable_frame_local);
3268 defsubr (&Slocal_variable_p);
3269 defsubr (&Slocal_variable_if_set_p);
3270 defsubr (&Svariable_binding_locus);
3271 defsubr (&Saref);
3272 defsubr (&Saset);
3273 defsubr (&Snumber_to_string);
3274 defsubr (&Sstring_to_number);
3275 defsubr (&Seqlsign);
3276 defsubr (&Slss);
3277 defsubr (&Sgtr);
3278 defsubr (&Sleq);
3279 defsubr (&Sgeq);
3280 defsubr (&Sneq);
3281 defsubr (&Szerop);
3282 defsubr (&Splus);
3283 defsubr (&Sminus);
3284 defsubr (&Stimes);
3285 defsubr (&Squo);
3286 defsubr (&Srem);
3287 defsubr (&Smod);
3288 defsubr (&Smax);
3289 defsubr (&Smin);
3290 defsubr (&Slogand);
3291 defsubr (&Slogior);
3292 defsubr (&Slogxor);
3293 defsubr (&Slsh);
3294 defsubr (&Sash);
3295 defsubr (&Sadd1);
3296 defsubr (&Ssub1);
3297 defsubr (&Slognot);
3298 defsubr (&Sbyteorder);
3299 defsubr (&Ssubr_arity);
3301 XSYMBOL (Qwholenump)->function = XSYMBOL (Qnatnump)->function;
3303 DEFVAR_LISP ("most-positive-fixnum", &Vmost_positive_fixnum,
3304 doc: /* The largest value that is representable in a Lisp integer. */);
3305 Vmost_positive_fixnum = make_number (MOST_POSITIVE_FIXNUM);
3307 DEFVAR_LISP ("most-negative-fixnum", &Vmost_negative_fixnum,
3308 doc: /* The smallest value that is representable in a Lisp integer. */);
3309 Vmost_negative_fixnum = make_number (MOST_NEGATIVE_FIXNUM);
3312 SIGTYPE
3313 arith_error (signo)
3314 int signo;
3316 #if defined(USG) && !defined(POSIX_SIGNALS)
3317 /* USG systems forget handlers when they are used;
3318 must reestablish each time */
3319 signal (signo, arith_error);
3320 #endif /* USG */
3321 #ifdef VMS
3322 /* VMS systems are like USG. */
3323 signal (signo, arith_error);
3324 #endif /* VMS */
3325 #ifdef BSD4_1
3326 sigrelse (SIGFPE);
3327 #else /* not BSD4_1 */
3328 sigsetmask (SIGEMPTYMASK);
3329 #endif /* not BSD4_1 */
3331 Fsignal (Qarith_error, Qnil);
3334 void
3335 init_data ()
3337 /* Don't do this if just dumping out.
3338 We don't want to call `signal' in this case
3339 so that we don't have trouble with dumping
3340 signal-delivering routines in an inconsistent state. */
3341 #ifndef CANNOT_DUMP
3342 if (!initialized)
3343 return;
3344 #endif /* CANNOT_DUMP */
3345 signal (SIGFPE, arith_error);
3347 #ifdef uts
3348 signal (SIGEMT, arith_error);
3349 #endif /* uts */
3352 /* arch-tag: 25879798-b84d-479a-9c89-7d148e2109f7
3353 (do not change this comment) */