Adapt shadowfile.el for Tramp (Bug#4526, Bug#4846)
[emacs.git] / src / data.c
blob4bee194e296d3b46c59bf48e4939c9052f6c4c6c
1 /* Primitive operations on Lisp data types for GNU Emacs Lisp interpreter.
2 Copyright (C) 1985-1986, 1988, 1993-1995, 1997-2018 Free Software
3 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 3 of the License, or (at
10 your option) 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. If not, see <https://www.gnu.org/licenses/>. */
21 #include <config.h>
23 #include <math.h>
24 #include <stdio.h>
26 #include <byteswap.h>
27 #include <count-one-bits.h>
28 #include <count-trailing-zeros.h>
29 #include <intprops.h>
31 #include "lisp.h"
32 #include "puresize.h"
33 #include "character.h"
34 #include "buffer.h"
35 #include "keyboard.h"
36 #include "process.h"
37 #include "frame.h"
38 #include "keymap.h"
40 static void swap_in_symval_forwarding (struct Lisp_Symbol *,
41 struct Lisp_Buffer_Local_Value *);
43 static bool
44 BOOLFWDP (union Lisp_Fwd *a)
46 return XFWDTYPE (a) == Lisp_Fwd_Bool;
48 static bool
49 INTFWDP (union Lisp_Fwd *a)
51 return XFWDTYPE (a) == Lisp_Fwd_Int;
53 static bool
54 KBOARD_OBJFWDP (union Lisp_Fwd *a)
56 return XFWDTYPE (a) == Lisp_Fwd_Kboard_Obj;
58 static bool
59 OBJFWDP (union Lisp_Fwd *a)
61 return XFWDTYPE (a) == Lisp_Fwd_Obj;
64 static struct Lisp_Boolfwd *
65 XBOOLFWD (union Lisp_Fwd *a)
67 eassert (BOOLFWDP (a));
68 return &a->u_boolfwd;
70 static struct Lisp_Kboard_Objfwd *
71 XKBOARD_OBJFWD (union Lisp_Fwd *a)
73 eassert (KBOARD_OBJFWDP (a));
74 return &a->u_kboard_objfwd;
76 static struct Lisp_Intfwd *
77 XINTFWD (union Lisp_Fwd *a)
79 eassert (INTFWDP (a));
80 return &a->u_intfwd;
82 static struct Lisp_Objfwd *
83 XOBJFWD (union Lisp_Fwd *a)
85 eassert (OBJFWDP (a));
86 return &a->u_objfwd;
89 static void
90 CHECK_SUBR (Lisp_Object x)
92 CHECK_TYPE (SUBRP (x), Qsubrp, x);
95 static void
96 set_blv_found (struct Lisp_Buffer_Local_Value *blv, int found)
98 eassert (found == !EQ (blv->defcell, blv->valcell));
99 blv->found = found;
102 static Lisp_Object
103 blv_value (struct Lisp_Buffer_Local_Value *blv)
105 return XCDR (blv->valcell);
108 static void
109 set_blv_value (struct Lisp_Buffer_Local_Value *blv, Lisp_Object val)
111 XSETCDR (blv->valcell, val);
114 static void
115 set_blv_where (struct Lisp_Buffer_Local_Value *blv, Lisp_Object val)
117 blv->where = val;
120 static void
121 set_blv_defcell (struct Lisp_Buffer_Local_Value *blv, Lisp_Object val)
123 blv->defcell = val;
126 static void
127 set_blv_valcell (struct Lisp_Buffer_Local_Value *blv, Lisp_Object val)
129 blv->valcell = val;
132 static _Noreturn void
133 wrong_length_argument (Lisp_Object a1, Lisp_Object a2, Lisp_Object a3)
135 Lisp_Object size1 = make_number (bool_vector_size (a1));
136 Lisp_Object size2 = make_number (bool_vector_size (a2));
137 if (NILP (a3))
138 xsignal2 (Qwrong_length_argument, size1, size2);
139 else
140 xsignal3 (Qwrong_length_argument, size1, size2,
141 make_number (bool_vector_size (a3)));
144 _Noreturn void
145 wrong_type_argument (register Lisp_Object predicate, register Lisp_Object value)
147 /* If VALUE is not even a valid Lisp object, we'd want to abort here
148 where we can get a backtrace showing where it came from. We used
149 to try and do that by checking the tagbits, but nowadays all
150 tagbits are potentially valid. */
151 /* if ((unsigned int) XTYPE (value) >= Lisp_Type_Limit)
152 * emacs_abort (); */
154 xsignal2 (Qwrong_type_argument, predicate, value);
157 void
158 pure_write_error (Lisp_Object obj)
160 xsignal2 (Qerror, build_string ("Attempt to modify read-only object"), obj);
163 void
164 args_out_of_range (Lisp_Object a1, Lisp_Object a2)
166 xsignal2 (Qargs_out_of_range, a1, a2);
169 void
170 args_out_of_range_3 (Lisp_Object a1, Lisp_Object a2, Lisp_Object a3)
172 xsignal3 (Qargs_out_of_range, a1, a2, a3);
175 void
176 circular_list (Lisp_Object list)
178 xsignal1 (Qcircular_list, list);
182 /* Data type predicates. */
184 DEFUN ("eq", Feq, Seq, 2, 2, 0,
185 doc: /* Return t if the two args are the same Lisp object. */
186 attributes: const)
187 (Lisp_Object obj1, Lisp_Object obj2)
189 if (EQ (obj1, obj2))
190 return Qt;
191 return Qnil;
194 DEFUN ("null", Fnull, Snull, 1, 1, 0,
195 doc: /* Return t if OBJECT is nil, and return nil otherwise. */
196 attributes: const)
197 (Lisp_Object object)
199 if (NILP (object))
200 return Qt;
201 return Qnil;
204 DEFUN ("type-of", Ftype_of, Stype_of, 1, 1, 0,
205 doc: /* Return a symbol representing the type of OBJECT.
206 The symbol returned names the object's basic type;
207 for example, (type-of 1) returns `integer'. */)
208 (Lisp_Object object)
210 switch (XTYPE (object))
212 case_Lisp_Int:
213 return Qinteger;
215 case Lisp_Symbol:
216 return Qsymbol;
218 case Lisp_String:
219 return Qstring;
221 case Lisp_Cons:
222 return Qcons;
224 case Lisp_Misc:
225 switch (XMISCTYPE (object))
227 case Lisp_Misc_Marker:
228 return Qmarker;
229 case Lisp_Misc_Overlay:
230 return Qoverlay;
231 case Lisp_Misc_Finalizer:
232 return Qfinalizer;
233 #ifdef HAVE_MODULES
234 case Lisp_Misc_User_Ptr:
235 return Quser_ptr;
236 #endif
237 default:
238 emacs_abort ();
241 case Lisp_Vectorlike:
242 switch (PSEUDOVECTOR_TYPE (XVECTOR (object)))
244 case PVEC_NORMAL_VECTOR: return Qvector;
245 case PVEC_WINDOW_CONFIGURATION: return Qwindow_configuration;
246 case PVEC_PROCESS: return Qprocess;
247 case PVEC_WINDOW: return Qwindow;
248 case PVEC_SUBR: return Qsubr;
249 case PVEC_COMPILED: return Qcompiled_function;
250 case PVEC_BUFFER: return Qbuffer;
251 case PVEC_CHAR_TABLE: return Qchar_table;
252 case PVEC_BOOL_VECTOR: return Qbool_vector;
253 case PVEC_FRAME: return Qframe;
254 case PVEC_HASH_TABLE: return Qhash_table;
255 case PVEC_FONT:
256 if (FONT_SPEC_P (object))
257 return Qfont_spec;
258 if (FONT_ENTITY_P (object))
259 return Qfont_entity;
260 if (FONT_OBJECT_P (object))
261 return Qfont_object;
262 else
263 emacs_abort (); /* return Qfont? */
264 case PVEC_THREAD: return Qthread;
265 case PVEC_MUTEX: return Qmutex;
266 case PVEC_CONDVAR: return Qcondition_variable;
267 case PVEC_TERMINAL: return Qterminal;
268 case PVEC_RECORD:
270 Lisp_Object t = AREF (object, 0);
271 if (RECORDP (t) && 1 < PVSIZE (t))
272 /* Return the type name field of the class! */
273 return AREF (t, 1);
274 else
275 return t;
277 case PVEC_MODULE_FUNCTION:
278 return Qmodule_function;
279 /* "Impossible" cases. */
280 case PVEC_XWIDGET:
281 case PVEC_OTHER:
282 case PVEC_XWIDGET_VIEW:
283 case PVEC_SUB_CHAR_TABLE:
284 case PVEC_FREE: ;
286 emacs_abort ();
288 case Lisp_Float:
289 return Qfloat;
291 default:
292 emacs_abort ();
296 DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0,
297 doc: /* Return t if OBJECT is a cons cell. */
298 attributes: const)
299 (Lisp_Object object)
301 if (CONSP (object))
302 return Qt;
303 return Qnil;
306 DEFUN ("atom", Fatom, Satom, 1, 1, 0,
307 doc: /* Return t if OBJECT is not a cons cell. This includes nil. */
308 attributes: const)
309 (Lisp_Object object)
311 if (CONSP (object))
312 return Qnil;
313 return Qt;
316 DEFUN ("listp", Flistp, Slistp, 1, 1, 0,
317 doc: /* Return t if OBJECT is a list, that is, a cons cell or nil.
318 Otherwise, return nil. */
319 attributes: const)
320 (Lisp_Object object)
322 if (CONSP (object) || NILP (object))
323 return Qt;
324 return Qnil;
327 DEFUN ("nlistp", Fnlistp, Snlistp, 1, 1, 0,
328 doc: /* Return t if OBJECT is not a list. Lists include nil. */
329 attributes: const)
330 (Lisp_Object object)
332 if (CONSP (object) || NILP (object))
333 return Qnil;
334 return Qt;
337 DEFUN ("symbolp", Fsymbolp, Ssymbolp, 1, 1, 0,
338 doc: /* Return t if OBJECT is a symbol. */
339 attributes: const)
340 (Lisp_Object object)
342 if (SYMBOLP (object))
343 return Qt;
344 return Qnil;
347 /* Define this in C to avoid unnecessarily consing up the symbol
348 name. */
349 DEFUN ("keywordp", Fkeywordp, Skeywordp, 1, 1, 0,
350 doc: /* Return t if OBJECT is a keyword.
351 This means that it is a symbol with a print name beginning with `:'
352 interned in the initial obarray. */)
353 (Lisp_Object object)
355 if (SYMBOLP (object)
356 && SREF (SYMBOL_NAME (object), 0) == ':'
357 && SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P (object))
358 return Qt;
359 return Qnil;
362 DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
363 doc: /* Return t if OBJECT is a vector. */)
364 (Lisp_Object object)
366 if (VECTORP (object))
367 return Qt;
368 return Qnil;
371 DEFUN ("recordp", Frecordp, Srecordp, 1, 1, 0,
372 doc: /* Return t if OBJECT is a record. */)
373 (Lisp_Object object)
375 if (RECORDP (object))
376 return Qt;
377 return Qnil;
380 DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
381 doc: /* Return t if OBJECT is a string. */
382 attributes: const)
383 (Lisp_Object object)
385 if (STRINGP (object))
386 return Qt;
387 return Qnil;
390 DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p,
391 1, 1, 0,
392 doc: /* Return t if OBJECT is a multibyte string.
393 Return nil if OBJECT is either a unibyte string, or not a string. */)
394 (Lisp_Object object)
396 if (STRINGP (object) && STRING_MULTIBYTE (object))
397 return Qt;
398 return Qnil;
401 DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0,
402 doc: /* Return t if OBJECT is a char-table. */)
403 (Lisp_Object object)
405 if (CHAR_TABLE_P (object))
406 return Qt;
407 return Qnil;
410 DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p,
411 Svector_or_char_table_p, 1, 1, 0,
412 doc: /* Return t if OBJECT is a char-table or vector. */)
413 (Lisp_Object object)
415 if (VECTORP (object) || CHAR_TABLE_P (object))
416 return Qt;
417 return Qnil;
420 DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0,
421 doc: /* Return t if OBJECT is a bool-vector. */)
422 (Lisp_Object object)
424 if (BOOL_VECTOR_P (object))
425 return Qt;
426 return Qnil;
429 DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0,
430 doc: /* Return t if OBJECT is an array (string or vector). */)
431 (Lisp_Object object)
433 if (ARRAYP (object))
434 return Qt;
435 return Qnil;
438 DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
439 doc: /* Return t if OBJECT is a sequence (list or array). */)
440 (register Lisp_Object object)
442 if (CONSP (object) || NILP (object) || ARRAYP (object))
443 return Qt;
444 return Qnil;
447 DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0,
448 doc: /* Return t if OBJECT is an editor buffer. */)
449 (Lisp_Object object)
451 if (BUFFERP (object))
452 return Qt;
453 return Qnil;
456 DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0,
457 doc: /* Return t if OBJECT is a marker (editor pointer). */)
458 (Lisp_Object object)
460 if (MARKERP (object))
461 return Qt;
462 return Qnil;
465 #ifdef HAVE_MODULES
466 DEFUN ("user-ptrp", Fuser_ptrp, Suser_ptrp, 1, 1, 0,
467 doc: /* Return t if OBJECT is a module user pointer. */)
468 (Lisp_Object object)
470 if (USER_PTRP (object))
471 return Qt;
472 return Qnil;
474 #endif
476 DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0,
477 doc: /* Return t if OBJECT is a built-in function. */)
478 (Lisp_Object object)
480 if (SUBRP (object))
481 return Qt;
482 return Qnil;
485 DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
486 1, 1, 0,
487 doc: /* Return t if OBJECT is a byte-compiled function object. */)
488 (Lisp_Object object)
490 if (COMPILEDP (object))
491 return Qt;
492 return Qnil;
495 DEFUN ("module-function-p", Fmodule_function_p, Smodule_function_p, 1, 1, NULL,
496 doc: /* Return t if OBJECT is a function loaded from a dynamic module. */
497 attributes: const)
498 (Lisp_Object object)
500 return MODULE_FUNCTIONP (object) ? Qt : Qnil;
503 DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0,
504 doc: /* Return t if OBJECT is a character or a string. */
505 attributes: const)
506 (register Lisp_Object object)
508 if (CHARACTERP (object) || STRINGP (object))
509 return Qt;
510 return Qnil;
513 DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0,
514 doc: /* Return t if OBJECT is an integer. */
515 attributes: const)
516 (Lisp_Object object)
518 if (INTEGERP (object))
519 return Qt;
520 return Qnil;
523 DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0,
524 doc: /* Return t if OBJECT is an integer or a marker (editor pointer). */)
525 (register Lisp_Object object)
527 if (MARKERP (object) || INTEGERP (object))
528 return Qt;
529 return Qnil;
532 DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
533 doc: /* Return t if OBJECT is a nonnegative integer. */
534 attributes: const)
535 (Lisp_Object object)
537 if (NATNUMP (object))
538 return Qt;
539 return Qnil;
542 DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
543 doc: /* Return t if OBJECT is a number (floating point or integer). */
544 attributes: const)
545 (Lisp_Object object)
547 if (NUMBERP (object))
548 return Qt;
549 else
550 return Qnil;
553 DEFUN ("number-or-marker-p", Fnumber_or_marker_p,
554 Snumber_or_marker_p, 1, 1, 0,
555 doc: /* Return t if OBJECT is a number or a marker. */)
556 (Lisp_Object object)
558 if (NUMBERP (object) || MARKERP (object))
559 return Qt;
560 return Qnil;
563 DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
564 doc: /* Return t if OBJECT is a floating point number. */
565 attributes: const)
566 (Lisp_Object object)
568 if (FLOATP (object))
569 return Qt;
570 return Qnil;
573 DEFUN ("threadp", Fthreadp, Sthreadp, 1, 1, 0,
574 doc: /* Return t if OBJECT is a thread. */)
575 (Lisp_Object object)
577 if (THREADP (object))
578 return Qt;
579 return Qnil;
582 DEFUN ("mutexp", Fmutexp, Smutexp, 1, 1, 0,
583 doc: /* Return t if OBJECT is a mutex. */)
584 (Lisp_Object object)
586 if (MUTEXP (object))
587 return Qt;
588 return Qnil;
591 DEFUN ("condition-variable-p", Fcondition_variable_p, Scondition_variable_p,
592 1, 1, 0,
593 doc: /* Return t if OBJECT is a condition variable. */)
594 (Lisp_Object object)
596 if (CONDVARP (object))
597 return Qt;
598 return Qnil;
601 /* Extract and set components of lists. */
603 DEFUN ("car", Fcar, Scar, 1, 1, 0,
604 doc: /* Return the car of LIST. If arg is nil, return nil.
605 Error if arg is not nil and not a cons cell. See also `car-safe'.
607 See Info node `(elisp)Cons Cells' for a discussion of related basic
608 Lisp concepts such as car, cdr, cons cell and list. */)
609 (register Lisp_Object list)
611 return CAR (list);
614 DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0,
615 doc: /* Return the car of OBJECT if it is a cons cell, or else nil. */)
616 (Lisp_Object object)
618 return CAR_SAFE (object);
621 DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
622 doc: /* Return the cdr of LIST. If arg is nil, return nil.
623 Error if arg is not nil and not a cons cell. See also `cdr-safe'.
625 See Info node `(elisp)Cons Cells' for a discussion of related basic
626 Lisp concepts such as cdr, car, cons cell and list. */)
627 (register Lisp_Object list)
629 return CDR (list);
632 DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0,
633 doc: /* Return the cdr of OBJECT if it is a cons cell, or else nil. */)
634 (Lisp_Object object)
636 return CDR_SAFE (object);
639 DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
640 doc: /* Set the car of CELL to be NEWCAR. Returns NEWCAR. */)
641 (register Lisp_Object cell, Lisp_Object newcar)
643 CHECK_CONS (cell);
644 CHECK_IMPURE (cell, XCONS (cell));
645 XSETCAR (cell, newcar);
646 return newcar;
649 DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
650 doc: /* Set the cdr of CELL to be NEWCDR. Returns NEWCDR. */)
651 (register Lisp_Object cell, Lisp_Object newcdr)
653 CHECK_CONS (cell);
654 CHECK_IMPURE (cell, XCONS (cell));
655 XSETCDR (cell, newcdr);
656 return newcdr;
659 /* Extract and set components of symbols. */
661 DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0,
662 doc: /* Return t if SYMBOL's value is not void.
663 Note that if `lexical-binding' is in effect, this refers to the
664 global value outside of any lexical scope. */)
665 (register Lisp_Object symbol)
667 Lisp_Object valcontents;
668 struct Lisp_Symbol *sym;
669 CHECK_SYMBOL (symbol);
670 sym = XSYMBOL (symbol);
672 start:
673 switch (sym->u.s.redirect)
675 case SYMBOL_PLAINVAL: valcontents = SYMBOL_VAL (sym); break;
676 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
677 case SYMBOL_LOCALIZED:
679 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
680 if (blv->fwd)
681 /* In set_internal, we un-forward vars when their value is
682 set to Qunbound. */
683 return Qt;
684 else
686 swap_in_symval_forwarding (sym, blv);
687 valcontents = blv_value (blv);
689 break;
691 case SYMBOL_FORWARDED:
692 /* In set_internal, we un-forward vars when their value is
693 set to Qunbound. */
694 return Qt;
695 default: emacs_abort ();
698 return (EQ (valcontents, Qunbound) ? Qnil : Qt);
701 /* It has been previously suggested to make this function an alias for
702 symbol-function, but upon discussion at Bug#23957, there is a risk
703 breaking backward compatibility, as some users of fboundp may
704 expect `t' in particular, rather than any true value. */
705 DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0,
706 doc: /* Return t if SYMBOL's function definition is not void. */)
707 (Lisp_Object symbol)
709 CHECK_SYMBOL (symbol);
710 return NILP (XSYMBOL (symbol)->u.s.function) ? Qnil : Qt;
713 DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0,
714 doc: /* Make SYMBOL's value be void.
715 Return SYMBOL. */)
716 (register Lisp_Object symbol)
718 CHECK_SYMBOL (symbol);
719 if (SYMBOL_CONSTANT_P (symbol))
720 xsignal1 (Qsetting_constant, symbol);
721 Fset (symbol, Qunbound);
722 return symbol;
725 DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0,
726 doc: /* Make SYMBOL's function definition be nil.
727 Return SYMBOL. */)
728 (register Lisp_Object symbol)
730 CHECK_SYMBOL (symbol);
731 if (NILP (symbol) || EQ (symbol, Qt))
732 xsignal1 (Qsetting_constant, symbol);
733 set_symbol_function (symbol, Qnil);
734 return symbol;
737 DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0,
738 doc: /* Return SYMBOL's function definition, or nil if that is void. */)
739 (Lisp_Object symbol)
741 CHECK_SYMBOL (symbol);
742 return XSYMBOL (symbol)->u.s.function;
745 DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0,
746 doc: /* Return SYMBOL's property list. */)
747 (Lisp_Object symbol)
749 CHECK_SYMBOL (symbol);
750 return XSYMBOL (symbol)->u.s.plist;
753 DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0,
754 doc: /* Return SYMBOL's name, a string. */)
755 (register Lisp_Object symbol)
757 register Lisp_Object name;
759 CHECK_SYMBOL (symbol);
760 name = SYMBOL_NAME (symbol);
761 return name;
764 DEFUN ("fset", Ffset, Sfset, 2, 2, 0,
765 doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION. */)
766 (register Lisp_Object symbol, Lisp_Object definition)
768 register Lisp_Object function;
769 CHECK_SYMBOL (symbol);
770 /* Perhaps not quite the right error signal, but seems good enough. */
771 if (NILP (symbol))
772 xsignal1 (Qsetting_constant, symbol);
774 function = XSYMBOL (symbol)->u.s.function;
776 if (!NILP (Vautoload_queue) && !NILP (function))
777 Vautoload_queue = Fcons (Fcons (symbol, function), Vautoload_queue);
779 if (AUTOLOADP (function))
780 Fput (symbol, Qautoload, XCDR (function));
782 /* Convert to eassert or remove after GC bug is found. In the
783 meantime, check unconditionally, at a slight perf hit. */
784 if (! valid_lisp_object_p (definition))
785 emacs_abort ();
787 set_symbol_function (symbol, definition);
789 return definition;
792 DEFUN ("defalias", Fdefalias, Sdefalias, 2, 3, 0,
793 doc: /* Set SYMBOL's function definition to DEFINITION.
794 Associates the function with the current load file, if any.
795 The optional third argument DOCSTRING specifies the documentation string
796 for SYMBOL; if it is omitted or nil, SYMBOL uses the documentation string
797 determined by DEFINITION.
799 Internally, this normally uses `fset', but if SYMBOL has a
800 `defalias-fset-function' property, the associated value is used instead.
802 The return value is undefined. */)
803 (register Lisp_Object symbol, Lisp_Object definition, Lisp_Object docstring)
805 CHECK_SYMBOL (symbol);
806 if (!NILP (Vpurify_flag)
807 /* If `definition' is a keymap, immutable (and copying) is wrong. */
808 && !KEYMAPP (definition))
809 definition = Fpurecopy (definition);
812 bool autoload = AUTOLOADP (definition);
813 if (NILP (Vpurify_flag) || !autoload)
814 { /* Only add autoload entries after dumping, because the ones before are
815 not useful and else we get loads of them from the loaddefs.el. */
817 if (AUTOLOADP (XSYMBOL (symbol)->u.s.function))
818 /* Remember that the function was already an autoload. */
819 LOADHIST_ATTACH (Fcons (Qt, symbol));
820 LOADHIST_ATTACH (Fcons (autoload ? Qautoload : Qdefun, symbol));
824 { /* Handle automatic advice activation. */
825 Lisp_Object hook = Fget (symbol, Qdefalias_fset_function);
826 if (!NILP (hook))
827 call2 (hook, symbol, definition);
828 else
829 Ffset (symbol, definition);
832 if (!NILP (docstring))
833 Fput (symbol, Qfunction_documentation, docstring);
834 /* We used to return `definition', but now that `defun' and `defmacro' expand
835 to a call to `defalias', we return `symbol' for backward compatibility
836 (bug#11686). */
837 return symbol;
840 DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
841 doc: /* Set SYMBOL's property list to NEWPLIST, and return NEWPLIST. */)
842 (register Lisp_Object symbol, Lisp_Object newplist)
844 CHECK_SYMBOL (symbol);
845 set_symbol_plist (symbol, newplist);
846 return newplist;
849 DEFUN ("subr-arity", Fsubr_arity, Ssubr_arity, 1, 1, 0,
850 doc: /* Return minimum and maximum number of args allowed for SUBR.
851 SUBR must be a built-in function.
852 The returned value is a pair (MIN . MAX). MIN is the minimum number
853 of args. MAX is the maximum number or the symbol `many', for a
854 function with `&rest' args, or `unevalled' for a special form. */)
855 (Lisp_Object subr)
857 short minargs, maxargs;
858 CHECK_SUBR (subr);
859 minargs = XSUBR (subr)->min_args;
860 maxargs = XSUBR (subr)->max_args;
861 return Fcons (make_number (minargs),
862 maxargs == MANY ? Qmany
863 : maxargs == UNEVALLED ? Qunevalled
864 : make_number (maxargs));
867 DEFUN ("subr-name", Fsubr_name, Ssubr_name, 1, 1, 0,
868 doc: /* Return name of subroutine SUBR.
869 SUBR must be a built-in function. */)
870 (Lisp_Object subr)
872 const char *name;
873 CHECK_SUBR (subr);
874 name = XSUBR (subr)->symbol_name;
875 return build_string (name);
878 DEFUN ("interactive-form", Finteractive_form, Sinteractive_form, 1, 1, 0,
879 doc: /* Return the interactive form of CMD or nil if none.
880 If CMD is not a command, the return value is nil.
881 Value, if non-nil, is a list (interactive SPEC). */)
882 (Lisp_Object cmd)
884 Lisp_Object fun = indirect_function (cmd); /* Check cycles. */
886 if (NILP (fun))
887 return Qnil;
889 /* Use an `interactive-form' property if present, analogous to the
890 function-documentation property. */
891 fun = cmd;
892 while (SYMBOLP (fun))
894 Lisp_Object tmp = Fget (fun, Qinteractive_form);
895 if (!NILP (tmp))
896 return tmp;
897 else
898 fun = Fsymbol_function (fun);
901 if (SUBRP (fun))
903 const char *spec = XSUBR (fun)->intspec;
904 if (spec)
905 return list2 (Qinteractive,
906 (*spec != '(') ? build_string (spec) :
907 Fcar (Fread_from_string (build_string (spec), Qnil, Qnil)));
909 else if (COMPILEDP (fun))
911 if (PVSIZE (fun) > COMPILED_INTERACTIVE)
912 return list2 (Qinteractive, AREF (fun, COMPILED_INTERACTIVE));
914 else if (AUTOLOADP (fun))
915 return Finteractive_form (Fautoload_do_load (fun, cmd, Qnil));
916 else if (CONSP (fun))
918 Lisp_Object funcar = XCAR (fun);
919 if (EQ (funcar, Qclosure))
920 return Fassq (Qinteractive, Fcdr (Fcdr (XCDR (fun))));
921 else if (EQ (funcar, Qlambda))
922 return Fassq (Qinteractive, Fcdr (XCDR (fun)));
924 return Qnil;
928 /***********************************************************************
929 Getting and Setting Values of Symbols
930 ***********************************************************************/
932 /* Return the symbol holding SYMBOL's value. Signal
933 `cyclic-variable-indirection' if SYMBOL's chain of variable
934 indirections contains a loop. */
936 struct Lisp_Symbol *
937 indirect_variable (struct Lisp_Symbol *symbol)
939 struct Lisp_Symbol *tortoise, *hare;
941 hare = tortoise = symbol;
943 while (hare->u.s.redirect == SYMBOL_VARALIAS)
945 hare = SYMBOL_ALIAS (hare);
946 if (hare->u.s.redirect != SYMBOL_VARALIAS)
947 break;
949 hare = SYMBOL_ALIAS (hare);
950 tortoise = SYMBOL_ALIAS (tortoise);
952 if (hare == tortoise)
954 Lisp_Object tem;
955 XSETSYMBOL (tem, symbol);
956 xsignal1 (Qcyclic_variable_indirection, tem);
960 return hare;
964 DEFUN ("indirect-variable", Findirect_variable, Sindirect_variable, 1, 1, 0,
965 doc: /* Return the variable at the end of OBJECT's variable chain.
966 If OBJECT is a symbol, follow its variable indirections (if any), and
967 return the variable at the end of the chain of aliases. See Info node
968 `(elisp)Variable Aliases'.
970 If OBJECT is not a symbol, just return it. If there is a loop in the
971 chain of aliases, signal a `cyclic-variable-indirection' error. */)
972 (Lisp_Object object)
974 if (SYMBOLP (object))
976 struct Lisp_Symbol *sym = indirect_variable (XSYMBOL (object));
977 XSETSYMBOL (object, sym);
979 return object;
983 /* Given the raw contents of a symbol value cell,
984 return the Lisp value of the symbol.
985 This does not handle buffer-local variables; use
986 swap_in_symval_forwarding for that. */
988 Lisp_Object
989 do_symval_forwarding (register union Lisp_Fwd *valcontents)
991 register Lisp_Object val;
992 switch (XFWDTYPE (valcontents))
994 case Lisp_Fwd_Int:
995 XSETINT (val, *XINTFWD (valcontents)->intvar);
996 return val;
998 case Lisp_Fwd_Bool:
999 return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
1001 case Lisp_Fwd_Obj:
1002 return *XOBJFWD (valcontents)->objvar;
1004 case Lisp_Fwd_Buffer_Obj:
1005 return per_buffer_value (current_buffer,
1006 XBUFFER_OBJFWD (valcontents)->offset);
1008 case Lisp_Fwd_Kboard_Obj:
1009 /* We used to simply use current_kboard here, but from Lisp
1010 code, its value is often unexpected. It seems nicer to
1011 allow constructions like this to work as intuitively expected:
1013 (with-selected-frame frame
1014 (define-key local-function-map "\eOP" [f1]))
1016 On the other hand, this affects the semantics of
1017 last-command and real-last-command, and people may rely on
1018 that. I took a quick look at the Lisp codebase, and I
1019 don't think anything will break. --lorentey */
1020 return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
1021 + (char *)FRAME_KBOARD (SELECTED_FRAME ()));
1022 default: emacs_abort ();
1026 /* Used to signal a user-friendly error when symbol WRONG is
1027 not a member of CHOICE, which should be a list of symbols. */
1029 void
1030 wrong_choice (Lisp_Object choice, Lisp_Object wrong)
1032 ptrdiff_t i = 0, len = XINT (Flength (choice));
1033 Lisp_Object obj, *args;
1034 AUTO_STRING (one_of, "One of ");
1035 AUTO_STRING (comma, ", ");
1036 AUTO_STRING (or, " or ");
1037 AUTO_STRING (should_be_specified, " should be specified");
1039 USE_SAFE_ALLOCA;
1040 SAFE_ALLOCA_LISP (args, len * 2 + 1);
1042 args[i++] = one_of;
1044 for (obj = choice; !NILP (obj); obj = XCDR (obj))
1046 args[i++] = SYMBOL_NAME (XCAR (obj));
1047 args[i++] = (NILP (XCDR (obj)) ? should_be_specified
1048 : NILP (XCDR (XCDR (obj))) ? or : comma);
1051 obj = Fconcat (i, args);
1052 SAFE_FREE ();
1053 xsignal2 (Qerror, obj, wrong);
1056 /* Used to signal a user-friendly error if WRONG is not a number or
1057 integer/floating-point number outsize of inclusive MIN..MAX range. */
1059 static void
1060 wrong_range (Lisp_Object min, Lisp_Object max, Lisp_Object wrong)
1062 AUTO_STRING (value_should_be_from, "Value should be from ");
1063 AUTO_STRING (to, " to ");
1064 xsignal2 (Qerror,
1065 CALLN (Fconcat, value_should_be_from, Fnumber_to_string (min),
1066 to, Fnumber_to_string (max)),
1067 wrong);
1070 /* Store NEWVAL into SYMBOL, where VALCONTENTS is found in the value cell
1071 of SYMBOL. If SYMBOL is buffer-local, VALCONTENTS should be the
1072 buffer-independent contents of the value cell: forwarded just one
1073 step past the buffer-localness.
1075 BUF non-zero means set the value in buffer BUF instead of the
1076 current buffer. This only plays a role for per-buffer variables. */
1078 static void
1079 store_symval_forwarding (union Lisp_Fwd *valcontents, register Lisp_Object newval, struct buffer *buf)
1081 switch (XFWDTYPE (valcontents))
1083 case Lisp_Fwd_Int:
1084 CHECK_NUMBER (newval);
1085 *XINTFWD (valcontents)->intvar = XINT (newval);
1086 break;
1088 case Lisp_Fwd_Bool:
1089 *XBOOLFWD (valcontents)->boolvar = !NILP (newval);
1090 break;
1092 case Lisp_Fwd_Obj:
1093 *XOBJFWD (valcontents)->objvar = newval;
1095 /* If this variable is a default for something stored
1096 in the buffer itself, such as default-fill-column,
1097 find the buffers that don't have local values for it
1098 and update them. */
1099 if (XOBJFWD (valcontents)->objvar > (Lisp_Object *) &buffer_defaults
1100 && XOBJFWD (valcontents)->objvar < (Lisp_Object *) (&buffer_defaults + 1))
1102 int offset = ((char *) XOBJFWD (valcontents)->objvar
1103 - (char *) &buffer_defaults);
1104 int idx = PER_BUFFER_IDX (offset);
1106 Lisp_Object tail, buf;
1108 if (idx <= 0)
1109 break;
1111 FOR_EACH_LIVE_BUFFER (tail, buf)
1113 struct buffer *b = XBUFFER (buf);
1115 if (! PER_BUFFER_VALUE_P (b, idx))
1116 set_per_buffer_value (b, offset, newval);
1119 break;
1121 case Lisp_Fwd_Buffer_Obj:
1123 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1124 Lisp_Object predicate = XBUFFER_OBJFWD (valcontents)->predicate;
1126 if (!NILP (newval))
1128 if (SYMBOLP (predicate))
1130 Lisp_Object prop;
1132 if ((prop = Fget (predicate, Qchoice), !NILP (prop)))
1134 if (NILP (Fmemq (newval, prop)))
1135 wrong_choice (prop, newval);
1137 else if ((prop = Fget (predicate, Qrange), !NILP (prop)))
1139 Lisp_Object min = XCAR (prop), max = XCDR (prop);
1140 if (! NUMBERP (newval)
1141 || NILP (CALLN (Fleq, min, newval, max)))
1142 wrong_range (min, max, newval);
1144 else if (FUNCTIONP (predicate))
1146 if (NILP (call1 (predicate, newval)))
1147 wrong_type_argument (predicate, newval);
1151 if (buf == NULL)
1152 buf = current_buffer;
1153 set_per_buffer_value (buf, offset, newval);
1155 break;
1157 case Lisp_Fwd_Kboard_Obj:
1159 char *base = (char *) FRAME_KBOARD (SELECTED_FRAME ());
1160 char *p = base + XKBOARD_OBJFWD (valcontents)->offset;
1161 *(Lisp_Object *) p = newval;
1163 break;
1165 default:
1166 emacs_abort (); /* goto def; */
1170 /* Set up SYMBOL to refer to its global binding. This makes it safe
1171 to alter the status of other bindings. BEWARE: this may be called
1172 during the mark phase of GC, where we assume that Lisp_Object slots
1173 of BLV are marked after this function has changed them. */
1175 void
1176 swap_in_global_binding (struct Lisp_Symbol *symbol)
1178 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (symbol);
1180 /* Unload the previously loaded binding. */
1181 if (blv->fwd)
1182 set_blv_value (blv, do_symval_forwarding (blv->fwd));
1184 /* Select the global binding in the symbol. */
1185 set_blv_valcell (blv, blv->defcell);
1186 if (blv->fwd)
1187 store_symval_forwarding (blv->fwd, XCDR (blv->defcell), NULL);
1189 /* Indicate that the global binding is set up now. */
1190 set_blv_where (blv, Qnil);
1191 set_blv_found (blv, false);
1194 /* Set up the buffer-local symbol SYMBOL for validity in the current buffer.
1195 VALCONTENTS is the contents of its value cell,
1196 which points to a struct Lisp_Buffer_Local_Value.
1198 Return the value forwarded one step past the buffer-local stage.
1199 This could be another forwarding pointer. */
1201 static void
1202 swap_in_symval_forwarding (struct Lisp_Symbol *symbol, struct Lisp_Buffer_Local_Value *blv)
1204 register Lisp_Object tem1;
1206 eassert (blv == SYMBOL_BLV (symbol));
1208 tem1 = blv->where;
1210 if (NILP (tem1)
1211 || current_buffer != XBUFFER (tem1))
1214 /* Unload the previously loaded binding. */
1215 tem1 = blv->valcell;
1216 if (blv->fwd)
1217 set_blv_value (blv, do_symval_forwarding (blv->fwd));
1218 /* Choose the new binding. */
1220 Lisp_Object var;
1221 XSETSYMBOL (var, symbol);
1222 tem1 = assq_no_quit (var, BVAR (current_buffer, local_var_alist));
1223 set_blv_where (blv, Fcurrent_buffer ());
1225 if (!(blv->found = !NILP (tem1)))
1226 tem1 = blv->defcell;
1228 /* Load the new binding. */
1229 set_blv_valcell (blv, tem1);
1230 if (blv->fwd)
1231 store_symval_forwarding (blv->fwd, blv_value (blv), NULL);
1235 /* Find the value of a symbol, returning Qunbound if it's not bound.
1236 This is helpful for code which just wants to get a variable's value
1237 if it has one, without signaling an error.
1238 Note that it must not be possible to quit
1239 within this function. Great care is required for this. */
1241 Lisp_Object
1242 find_symbol_value (Lisp_Object symbol)
1244 struct Lisp_Symbol *sym;
1246 CHECK_SYMBOL (symbol);
1247 sym = XSYMBOL (symbol);
1249 start:
1250 switch (sym->u.s.redirect)
1252 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1253 case SYMBOL_PLAINVAL: return SYMBOL_VAL (sym);
1254 case SYMBOL_LOCALIZED:
1256 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1257 swap_in_symval_forwarding (sym, blv);
1258 return blv->fwd ? do_symval_forwarding (blv->fwd) : blv_value (blv);
1260 case SYMBOL_FORWARDED:
1261 return do_symval_forwarding (SYMBOL_FWD (sym));
1262 default: emacs_abort ();
1266 DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
1267 doc: /* Return SYMBOL's value. Error if that is void.
1268 Note that if `lexical-binding' is in effect, this returns the
1269 global value outside of any lexical scope. */)
1270 (Lisp_Object symbol)
1272 Lisp_Object val;
1274 val = find_symbol_value (symbol);
1275 if (!EQ (val, Qunbound))
1276 return val;
1278 xsignal1 (Qvoid_variable, symbol);
1281 DEFUN ("set", Fset, Sset, 2, 2, 0,
1282 doc: /* Set SYMBOL's value to NEWVAL, and return NEWVAL. */)
1283 (register Lisp_Object symbol, Lisp_Object newval)
1285 set_internal (symbol, newval, Qnil, SET_INTERNAL_SET);
1286 return newval;
1289 /* Store the value NEWVAL into SYMBOL.
1290 If buffer-locality is an issue, WHERE specifies which context to use.
1291 (nil stands for the current buffer/frame).
1293 If BINDFLAG is SET_INTERNAL_SET, then if this symbol is supposed to
1294 become local in every buffer where it is set, then we make it
1295 local. If BINDFLAG is SET_INTERNAL_BIND or SET_INTERNAL_UNBIND, we
1296 don't do that. */
1298 void
1299 set_internal (Lisp_Object symbol, Lisp_Object newval, Lisp_Object where,
1300 enum Set_Internal_Bind bindflag)
1302 bool voide = EQ (newval, Qunbound);
1303 struct Lisp_Symbol *sym;
1304 Lisp_Object tem1;
1306 /* If restoring in a dead buffer, do nothing. */
1307 /* if (BUFFERP (where) && NILP (XBUFFER (where)->name))
1308 return; */
1310 CHECK_SYMBOL (symbol);
1311 sym = XSYMBOL (symbol);
1312 switch (sym->u.s.trapped_write)
1314 case SYMBOL_NOWRITE:
1315 if (NILP (Fkeywordp (symbol))
1316 || !EQ (newval, Fsymbol_value (symbol)))
1317 xsignal1 (Qsetting_constant, symbol);
1318 else
1319 /* Allow setting keywords to their own value. */
1320 return;
1322 case SYMBOL_TRAPPED_WRITE:
1323 /* Setting due to thread-switching doesn't count. */
1324 if (bindflag != SET_INTERNAL_THREAD_SWITCH)
1325 notify_variable_watchers (symbol, voide? Qnil : newval,
1326 (bindflag == SET_INTERNAL_BIND? Qlet :
1327 bindflag == SET_INTERNAL_UNBIND? Qunlet :
1328 voide? Qmakunbound : Qset),
1329 where);
1330 /* FALLTHROUGH! */
1331 case SYMBOL_UNTRAPPED_WRITE:
1332 break;
1334 default: emacs_abort ();
1337 start:
1338 switch (sym->u.s.redirect)
1340 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1341 case SYMBOL_PLAINVAL: SET_SYMBOL_VAL (sym , newval); return;
1342 case SYMBOL_LOCALIZED:
1344 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1345 if (NILP (where))
1346 XSETBUFFER (where, current_buffer);
1348 /* If the current buffer is not the buffer whose binding is
1349 loaded, or if it's a Lisp_Buffer_Local_Value and
1350 the default binding is loaded, the loaded binding may be the
1351 wrong one. */
1352 if (!EQ (blv->where, where)
1353 /* Also unload a global binding (if the var is local_if_set). */
1354 || (EQ (blv->valcell, blv->defcell)))
1356 /* The currently loaded binding is not necessarily valid.
1357 We need to unload it, and choose a new binding. */
1359 /* Write out `realvalue' to the old loaded binding. */
1360 if (blv->fwd)
1361 set_blv_value (blv, do_symval_forwarding (blv->fwd));
1363 /* Find the new binding. */
1364 XSETSYMBOL (symbol, sym); /* May have changed via aliasing. */
1365 tem1 = assq_no_quit (symbol,
1366 BVAR (XBUFFER (where), local_var_alist));
1367 set_blv_where (blv, where);
1368 blv->found = true;
1370 if (NILP (tem1))
1372 /* This buffer still sees the default value. */
1374 /* If the variable is a Lisp_Some_Buffer_Local_Value,
1375 or if this is `let' rather than `set',
1376 make CURRENT-ALIST-ELEMENT point to itself,
1377 indicating that we're seeing the default value.
1378 Likewise if the variable has been let-bound
1379 in the current buffer. */
1380 if (bindflag || !blv->local_if_set
1381 || let_shadows_buffer_binding_p (sym))
1383 blv->found = false;
1384 tem1 = blv->defcell;
1386 /* If it's a local_if_set, being set not bound,
1387 and we're not within a let that was made for this buffer,
1388 create a new buffer-local binding for the variable.
1389 That means, give this buffer a new assoc for a local value
1390 and load that binding. */
1391 else
1393 tem1 = Fcons (symbol, XCDR (blv->defcell));
1394 bset_local_var_alist
1395 (XBUFFER (where),
1396 Fcons (tem1, BVAR (XBUFFER (where), local_var_alist)));
1400 /* Record which binding is now loaded. */
1401 set_blv_valcell (blv, tem1);
1404 /* Store the new value in the cons cell. */
1405 set_blv_value (blv, newval);
1407 if (blv->fwd)
1409 if (voide)
1410 /* If storing void (making the symbol void), forward only through
1411 buffer-local indicator, not through Lisp_Objfwd, etc. */
1412 blv->fwd = NULL;
1413 else
1414 store_symval_forwarding (blv->fwd, newval,
1415 BUFFERP (where)
1416 ? XBUFFER (where) : current_buffer);
1418 break;
1420 case SYMBOL_FORWARDED:
1422 struct buffer *buf
1423 = BUFFERP (where) ? XBUFFER (where) : current_buffer;
1424 union Lisp_Fwd *innercontents = SYMBOL_FWD (sym);
1425 if (BUFFER_OBJFWDP (innercontents))
1427 int offset = XBUFFER_OBJFWD (innercontents)->offset;
1428 int idx = PER_BUFFER_IDX (offset);
1429 if (idx > 0
1430 && bindflag == SET_INTERNAL_SET
1431 && !let_shadows_buffer_binding_p (sym))
1432 SET_PER_BUFFER_VALUE_P (buf, idx, 1);
1435 if (voide)
1436 { /* If storing void (making the symbol void), forward only through
1437 buffer-local indicator, not through Lisp_Objfwd, etc. */
1438 sym->u.s.redirect = SYMBOL_PLAINVAL;
1439 SET_SYMBOL_VAL (sym, newval);
1441 else
1442 store_symval_forwarding (/* sym, */ innercontents, newval, buf);
1443 break;
1445 default: emacs_abort ();
1447 return;
1450 static void
1451 set_symbol_trapped_write (Lisp_Object symbol, enum symbol_trapped_write trap)
1453 struct Lisp_Symbol *sym = XSYMBOL (symbol);
1454 if (sym->u.s.trapped_write == SYMBOL_NOWRITE)
1455 xsignal1 (Qtrapping_constant, symbol);
1456 sym->u.s.trapped_write = trap;
1459 static void
1460 restore_symbol_trapped_write (Lisp_Object symbol)
1462 set_symbol_trapped_write (symbol, SYMBOL_TRAPPED_WRITE);
1465 static void
1466 harmonize_variable_watchers (Lisp_Object alias, Lisp_Object base_variable)
1468 if (!EQ (base_variable, alias)
1469 && EQ (base_variable, Findirect_variable (alias)))
1470 set_symbol_trapped_write
1471 (alias, XSYMBOL (base_variable)->u.s.trapped_write);
1474 DEFUN ("add-variable-watcher", Fadd_variable_watcher, Sadd_variable_watcher,
1475 2, 2, 0,
1476 doc: /* Cause WATCH-FUNCTION to be called when SYMBOL is set.
1478 It will be called with 4 arguments: (SYMBOL NEWVAL OPERATION WHERE).
1479 SYMBOL is the variable being changed.
1480 NEWVAL is the value it will be changed to.
1481 OPERATION is a symbol representing the kind of change, one of: `set',
1482 `let', `unlet', `makunbound', and `defvaralias'.
1483 WHERE is a buffer if the buffer-local value of the variable is being
1484 changed, nil otherwise.
1486 All writes to aliases of SYMBOL will call WATCH-FUNCTION too. */)
1487 (Lisp_Object symbol, Lisp_Object watch_function)
1489 symbol = Findirect_variable (symbol);
1490 set_symbol_trapped_write (symbol, SYMBOL_TRAPPED_WRITE);
1491 map_obarray (Vobarray, harmonize_variable_watchers, symbol);
1493 Lisp_Object watchers = Fget (symbol, Qwatchers);
1494 Lisp_Object member = Fmember (watch_function, watchers);
1495 if (NILP (member))
1496 Fput (symbol, Qwatchers, Fcons (watch_function, watchers));
1497 return Qnil;
1500 DEFUN ("remove-variable-watcher", Fremove_variable_watcher, Sremove_variable_watcher,
1501 2, 2, 0,
1502 doc: /* Undo the effect of `add-variable-watcher'.
1503 Remove WATCH-FUNCTION from the list of functions to be called when
1504 SYMBOL (or its aliases) are set. */)
1505 (Lisp_Object symbol, Lisp_Object watch_function)
1507 symbol = Findirect_variable (symbol);
1508 Lisp_Object watchers = Fget (symbol, Qwatchers);
1509 watchers = Fdelete (watch_function, watchers);
1510 if (NILP (watchers))
1512 set_symbol_trapped_write (symbol, SYMBOL_UNTRAPPED_WRITE);
1513 map_obarray (Vobarray, harmonize_variable_watchers, symbol);
1515 Fput (symbol, Qwatchers, watchers);
1516 return Qnil;
1519 DEFUN ("get-variable-watchers", Fget_variable_watchers, Sget_variable_watchers,
1520 1, 1, 0,
1521 doc: /* Return a list of SYMBOL's active watchers. */)
1522 (Lisp_Object symbol)
1524 return (SYMBOL_TRAPPED_WRITE_P (symbol) == SYMBOL_TRAPPED_WRITE)
1525 ? Fget (Findirect_variable (symbol), Qwatchers)
1526 : Qnil;
1529 void
1530 notify_variable_watchers (Lisp_Object symbol,
1531 Lisp_Object newval,
1532 Lisp_Object operation,
1533 Lisp_Object where)
1535 symbol = Findirect_variable (symbol);
1537 ptrdiff_t count = SPECPDL_INDEX ();
1538 record_unwind_protect (restore_symbol_trapped_write, symbol);
1539 /* Avoid recursion. */
1540 set_symbol_trapped_write (symbol, SYMBOL_UNTRAPPED_WRITE);
1542 if (NILP (where)
1543 && !EQ (operation, Qset_default) && !EQ (operation, Qmakunbound)
1544 && !NILP (Flocal_variable_if_set_p (symbol, Fcurrent_buffer ())))
1546 XSETBUFFER (where, current_buffer);
1549 if (EQ (operation, Qset_default))
1550 operation = Qset;
1552 for (Lisp_Object watchers = Fget (symbol, Qwatchers);
1553 CONSP (watchers);
1554 watchers = XCDR (watchers))
1556 Lisp_Object watcher = XCAR (watchers);
1557 /* Call subr directly to avoid gc. */
1558 if (SUBRP (watcher))
1560 Lisp_Object args[] = { symbol, newval, operation, where };
1561 funcall_subr (XSUBR (watcher), ARRAYELTS (args), args);
1563 else
1564 CALLN (Ffuncall, watcher, symbol, newval, operation, where);
1567 unbind_to (count, Qnil);
1571 /* Access or set a buffer-local symbol's default value. */
1573 /* Return the default value of SYMBOL, but don't check for voidness.
1574 Return Qunbound if it is void. */
1576 static Lisp_Object
1577 default_value (Lisp_Object symbol)
1579 struct Lisp_Symbol *sym;
1581 CHECK_SYMBOL (symbol);
1582 sym = XSYMBOL (symbol);
1584 start:
1585 switch (sym->u.s.redirect)
1587 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1588 case SYMBOL_PLAINVAL: return SYMBOL_VAL (sym);
1589 case SYMBOL_LOCALIZED:
1591 /* If var is set up for a buffer that lacks a local value for it,
1592 the current value is nominally the default value.
1593 But the `realvalue' slot may be more up to date, since
1594 ordinary setq stores just that slot. So use that. */
1595 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1596 if (blv->fwd && EQ (blv->valcell, blv->defcell))
1597 return do_symval_forwarding (blv->fwd);
1598 else
1599 return XCDR (blv->defcell);
1601 case SYMBOL_FORWARDED:
1603 union Lisp_Fwd *valcontents = SYMBOL_FWD (sym);
1605 /* For a built-in buffer-local variable, get the default value
1606 rather than letting do_symval_forwarding get the current value. */
1607 if (BUFFER_OBJFWDP (valcontents))
1609 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1610 if (PER_BUFFER_IDX (offset) != 0)
1611 return per_buffer_default (offset);
1614 /* For other variables, get the current value. */
1615 return do_symval_forwarding (valcontents);
1617 default: emacs_abort ();
1621 DEFUN ("default-boundp", Fdefault_boundp, Sdefault_boundp, 1, 1, 0,
1622 doc: /* Return t if SYMBOL has a non-void default value.
1623 This is the value that is seen in buffers that do not have their own values
1624 for this variable. */)
1625 (Lisp_Object symbol)
1627 register Lisp_Object value;
1629 value = default_value (symbol);
1630 return (EQ (value, Qunbound) ? Qnil : Qt);
1633 DEFUN ("default-value", Fdefault_value, Sdefault_value, 1, 1, 0,
1634 doc: /* Return SYMBOL's default value.
1635 This is the value that is seen in buffers that do not have their own values
1636 for this variable. The default value is meaningful for variables with
1637 local bindings in certain buffers. */)
1638 (Lisp_Object symbol)
1640 Lisp_Object value = default_value (symbol);
1641 if (!EQ (value, Qunbound))
1642 return value;
1644 xsignal1 (Qvoid_variable, symbol);
1647 void
1648 set_default_internal (Lisp_Object symbol, Lisp_Object value,
1649 enum Set_Internal_Bind bindflag)
1651 struct Lisp_Symbol *sym;
1653 CHECK_SYMBOL (symbol);
1654 sym = XSYMBOL (symbol);
1655 switch (sym->u.s.trapped_write)
1657 case SYMBOL_NOWRITE:
1658 if (NILP (Fkeywordp (symbol))
1659 || !EQ (value, Fsymbol_value (symbol)))
1660 xsignal1 (Qsetting_constant, symbol);
1661 else
1662 /* Allow setting keywords to their own value. */
1663 return;
1665 case SYMBOL_TRAPPED_WRITE:
1666 /* Don't notify here if we're going to call Fset anyway. */
1667 if (sym->u.s.redirect != SYMBOL_PLAINVAL
1668 /* Setting due to thread switching doesn't count. */
1669 && bindflag != SET_INTERNAL_THREAD_SWITCH)
1670 notify_variable_watchers (symbol, value, Qset_default, Qnil);
1671 /* FALLTHROUGH! */
1672 case SYMBOL_UNTRAPPED_WRITE:
1673 break;
1675 default: emacs_abort ();
1678 start:
1679 switch (sym->u.s.redirect)
1681 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1682 case SYMBOL_PLAINVAL: set_internal (symbol, value, Qnil, bindflag); return;
1683 case SYMBOL_LOCALIZED:
1685 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
1687 /* Store new value into the DEFAULT-VALUE slot. */
1688 XSETCDR (blv->defcell, value);
1690 /* If the default binding is now loaded, set the REALVALUE slot too. */
1691 if (blv->fwd && EQ (blv->defcell, blv->valcell))
1692 store_symval_forwarding (blv->fwd, value, NULL);
1693 return;
1695 case SYMBOL_FORWARDED:
1697 union Lisp_Fwd *valcontents = SYMBOL_FWD (sym);
1699 /* Handle variables like case-fold-search that have special slots
1700 in the buffer.
1701 Make them work apparently like Lisp_Buffer_Local_Value variables. */
1702 if (BUFFER_OBJFWDP (valcontents))
1704 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1705 int idx = PER_BUFFER_IDX (offset);
1707 set_per_buffer_default (offset, value);
1709 /* If this variable is not always local in all buffers,
1710 set it in the buffers that don't nominally have a local value. */
1711 if (idx > 0)
1713 struct buffer *b;
1715 FOR_EACH_BUFFER (b)
1716 if (!PER_BUFFER_VALUE_P (b, idx))
1717 set_per_buffer_value (b, offset, value);
1720 else
1721 set_internal (symbol, value, Qnil, bindflag);
1722 return;
1724 default: emacs_abort ();
1728 DEFUN ("set-default", Fset_default, Sset_default, 2, 2, 0,
1729 doc: /* Set SYMBOL's default value to VALUE. SYMBOL and VALUE are evaluated.
1730 The default value is seen in buffers that do not have their own values
1731 for this variable. */)
1732 (Lisp_Object symbol, Lisp_Object value)
1734 set_default_internal (symbol, value, SET_INTERNAL_SET);
1735 return value;
1738 DEFUN ("setq-default", Fsetq_default, Ssetq_default, 0, UNEVALLED, 0,
1739 doc: /* Set the default value of variable VAR to VALUE.
1740 VAR, the variable name, is literal (not evaluated);
1741 VALUE is an expression: it is evaluated and its value returned.
1742 The default value of a variable is seen in buffers
1743 that do not have their own values for the variable.
1745 More generally, you can use multiple variables and values, as in
1746 (setq-default VAR VALUE VAR VALUE...)
1747 This sets each VAR's default value to the corresponding VALUE.
1748 The VALUE for the Nth VAR can refer to the new default values
1749 of previous VARs.
1750 usage: (setq-default [VAR VALUE]...) */)
1751 (Lisp_Object args)
1753 Lisp_Object args_left, symbol, val;
1755 args_left = val = args;
1757 while (CONSP (args_left))
1759 val = eval_sub (Fcar (XCDR (args_left)));
1760 symbol = XCAR (args_left);
1761 Fset_default (symbol, val);
1762 args_left = Fcdr (XCDR (args_left));
1765 return val;
1768 /* Lisp functions for creating and removing buffer-local variables. */
1770 union Lisp_Val_Fwd
1772 Lisp_Object value;
1773 union Lisp_Fwd *fwd;
1776 static struct Lisp_Buffer_Local_Value *
1777 make_blv (struct Lisp_Symbol *sym, bool forwarded,
1778 union Lisp_Val_Fwd valcontents)
1780 struct Lisp_Buffer_Local_Value *blv = xmalloc (sizeof *blv);
1781 Lisp_Object symbol;
1782 Lisp_Object tem;
1784 XSETSYMBOL (symbol, sym);
1785 tem = Fcons (symbol, (forwarded
1786 ? do_symval_forwarding (valcontents.fwd)
1787 : valcontents.value));
1789 /* Buffer_Local_Values cannot have as realval a buffer-local
1790 or keyboard-local forwarding. */
1791 eassert (!(forwarded && BUFFER_OBJFWDP (valcontents.fwd)));
1792 eassert (!(forwarded && KBOARD_OBJFWDP (valcontents.fwd)));
1793 blv->fwd = forwarded ? valcontents.fwd : NULL;
1794 set_blv_where (blv, Qnil);
1795 blv->local_if_set = 0;
1796 set_blv_defcell (blv, tem);
1797 set_blv_valcell (blv, tem);
1798 set_blv_found (blv, false);
1799 return blv;
1802 DEFUN ("make-variable-buffer-local", Fmake_variable_buffer_local,
1803 Smake_variable_buffer_local, 1, 1, "vMake Variable Buffer Local: ",
1804 doc: /* Make VARIABLE become buffer-local whenever it is set.
1805 At any time, the value for the current buffer is in effect,
1806 unless the variable has never been set in this buffer,
1807 in which case the default value is in effect.
1808 Note that binding the variable with `let', or setting it while
1809 a `let'-style binding made in this buffer is in effect,
1810 does not make the variable buffer-local. Return VARIABLE.
1812 This globally affects all uses of this variable, so it belongs together with
1813 the variable declaration, rather than with its uses (if you just want to make
1814 a variable local to the current buffer for one particular use, use
1815 `make-local-variable'). Buffer-local bindings are normally cleared
1816 while setting up a new major mode, unless they have a `permanent-local'
1817 property.
1819 The function `default-value' gets the default value and `set-default' sets it. */)
1820 (register Lisp_Object variable)
1822 struct Lisp_Symbol *sym;
1823 struct Lisp_Buffer_Local_Value *blv = NULL;
1824 union Lisp_Val_Fwd valcontents;
1825 bool forwarded UNINIT;
1827 CHECK_SYMBOL (variable);
1828 sym = XSYMBOL (variable);
1830 start:
1831 switch (sym->u.s.redirect)
1833 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1834 case SYMBOL_PLAINVAL:
1835 forwarded = 0; valcontents.value = SYMBOL_VAL (sym);
1836 if (EQ (valcontents.value, Qunbound))
1837 valcontents.value = Qnil;
1838 break;
1839 case SYMBOL_LOCALIZED:
1840 blv = SYMBOL_BLV (sym);
1841 break;
1842 case SYMBOL_FORWARDED:
1843 forwarded = 1; valcontents.fwd = SYMBOL_FWD (sym);
1844 if (KBOARD_OBJFWDP (valcontents.fwd))
1845 error ("Symbol %s may not be buffer-local",
1846 SDATA (SYMBOL_NAME (variable)));
1847 else if (BUFFER_OBJFWDP (valcontents.fwd))
1848 return variable;
1849 break;
1850 default: emacs_abort ();
1853 if (SYMBOL_CONSTANT_P (variable))
1854 error ("Symbol %s may not be buffer-local", SDATA (SYMBOL_NAME (variable)));
1856 if (!blv)
1858 blv = make_blv (sym, forwarded, valcontents);
1859 sym->u.s.redirect = SYMBOL_LOCALIZED;
1860 SET_SYMBOL_BLV (sym, blv);
1863 blv->local_if_set = 1;
1864 return variable;
1867 DEFUN ("make-local-variable", Fmake_local_variable, Smake_local_variable,
1868 1, 1, "vMake Local Variable: ",
1869 doc: /* Make VARIABLE have a separate value in the current buffer.
1870 Other buffers will continue to share a common default value.
1871 \(The buffer-local value of VARIABLE starts out as the same value
1872 VARIABLE previously had. If VARIABLE was void, it remains void.)
1873 Return VARIABLE.
1875 If the variable is already arranged to become local when set,
1876 this function causes a local value to exist for this buffer,
1877 just as setting the variable would do.
1879 This function returns VARIABLE, and therefore
1880 (set (make-local-variable \\='VARIABLE) VALUE-EXP)
1881 works.
1883 See also `make-variable-buffer-local'.
1885 Do not use `make-local-variable' to make a hook variable buffer-local.
1886 Instead, use `add-hook' and specify t for the LOCAL argument. */)
1887 (Lisp_Object variable)
1889 Lisp_Object tem;
1890 bool forwarded UNINIT;
1891 union Lisp_Val_Fwd valcontents;
1892 struct Lisp_Symbol *sym;
1893 struct Lisp_Buffer_Local_Value *blv = NULL;
1895 CHECK_SYMBOL (variable);
1896 sym = XSYMBOL (variable);
1898 start:
1899 switch (sym->u.s.redirect)
1901 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1902 case SYMBOL_PLAINVAL:
1903 forwarded = 0; valcontents.value = SYMBOL_VAL (sym); break;
1904 case SYMBOL_LOCALIZED:
1905 blv = SYMBOL_BLV (sym);
1906 break;
1907 case SYMBOL_FORWARDED:
1908 forwarded = 1; valcontents.fwd = SYMBOL_FWD (sym);
1909 if (KBOARD_OBJFWDP (valcontents.fwd))
1910 error ("Symbol %s may not be buffer-local",
1911 SDATA (SYMBOL_NAME (variable)));
1912 break;
1913 default: emacs_abort ();
1916 if (sym->u.s.trapped_write == SYMBOL_NOWRITE)
1917 error ("Symbol %s may not be buffer-local",
1918 SDATA (SYMBOL_NAME (variable)));
1920 if (blv ? blv->local_if_set
1921 : (forwarded && BUFFER_OBJFWDP (valcontents.fwd)))
1923 tem = Fboundp (variable);
1924 /* Make sure the symbol has a local value in this particular buffer,
1925 by setting it to the same value it already has. */
1926 Fset (variable, (EQ (tem, Qt) ? Fsymbol_value (variable) : Qunbound));
1927 return variable;
1929 if (!blv)
1931 blv = make_blv (sym, forwarded, valcontents);
1932 sym->u.s.redirect = SYMBOL_LOCALIZED;
1933 SET_SYMBOL_BLV (sym, blv);
1936 /* Make sure this buffer has its own value of symbol. */
1937 XSETSYMBOL (variable, sym); /* Update in case of aliasing. */
1938 tem = Fassq (variable, BVAR (current_buffer, local_var_alist));
1939 if (NILP (tem))
1941 if (let_shadows_buffer_binding_p (sym))
1943 AUTO_STRING (format,
1944 "Making %s buffer-local while locally let-bound!");
1945 CALLN (Fmessage, format, SYMBOL_NAME (variable));
1948 if (BUFFERP (blv->where) && current_buffer == XBUFFER (blv->where))
1949 /* Make sure the current value is permanently recorded, if it's the
1950 default value. */
1951 swap_in_global_binding (sym);
1953 bset_local_var_alist
1954 (current_buffer,
1955 Fcons (Fcons (variable, XCDR (blv->defcell)),
1956 BVAR (current_buffer, local_var_alist)));
1959 return variable;
1962 DEFUN ("kill-local-variable", Fkill_local_variable, Skill_local_variable,
1963 1, 1, "vKill Local Variable: ",
1964 doc: /* Make VARIABLE no longer have a separate value in the current buffer.
1965 From now on the default value will apply in this buffer. Return VARIABLE. */)
1966 (register Lisp_Object variable)
1968 register Lisp_Object tem;
1969 struct Lisp_Buffer_Local_Value *blv;
1970 struct Lisp_Symbol *sym;
1972 CHECK_SYMBOL (variable);
1973 sym = XSYMBOL (variable);
1975 start:
1976 switch (sym->u.s.redirect)
1978 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
1979 case SYMBOL_PLAINVAL: return variable;
1980 case SYMBOL_FORWARDED:
1982 union Lisp_Fwd *valcontents = SYMBOL_FWD (sym);
1983 if (BUFFER_OBJFWDP (valcontents))
1985 int offset = XBUFFER_OBJFWD (valcontents)->offset;
1986 int idx = PER_BUFFER_IDX (offset);
1988 if (idx > 0)
1990 SET_PER_BUFFER_VALUE_P (current_buffer, idx, 0);
1991 set_per_buffer_value (current_buffer, offset,
1992 per_buffer_default (offset));
1995 return variable;
1997 case SYMBOL_LOCALIZED:
1998 blv = SYMBOL_BLV (sym);
1999 break;
2000 default: emacs_abort ();
2003 if (sym->u.s.trapped_write == SYMBOL_TRAPPED_WRITE)
2004 notify_variable_watchers (variable, Qnil, Qmakunbound, Fcurrent_buffer ());
2006 /* Get rid of this buffer's alist element, if any. */
2007 XSETSYMBOL (variable, sym); /* Propagate variable indirection. */
2008 tem = Fassq (variable, BVAR (current_buffer, local_var_alist));
2009 if (!NILP (tem))
2010 bset_local_var_alist
2011 (current_buffer,
2012 Fdelq (tem, BVAR (current_buffer, local_var_alist)));
2014 /* If the symbol is set up with the current buffer's binding
2015 loaded, recompute its value. We have to do it now, or else
2016 forwarded objects won't work right. */
2018 Lisp_Object buf; XSETBUFFER (buf, current_buffer);
2019 if (EQ (buf, blv->where))
2020 swap_in_global_binding (sym);
2023 return variable;
2026 /* Lisp functions for creating and removing buffer-local variables. */
2028 DEFUN ("local-variable-p", Flocal_variable_p, Slocal_variable_p,
2029 1, 2, 0,
2030 doc: /* Non-nil if VARIABLE has a local binding in buffer BUFFER.
2031 BUFFER defaults to the current buffer. */)
2032 (Lisp_Object variable, Lisp_Object buffer)
2034 struct buffer *buf = decode_buffer (buffer);
2035 struct Lisp_Symbol *sym;
2037 CHECK_SYMBOL (variable);
2038 sym = XSYMBOL (variable);
2040 start:
2041 switch (sym->u.s.redirect)
2043 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
2044 case SYMBOL_PLAINVAL: return Qnil;
2045 case SYMBOL_LOCALIZED:
2047 Lisp_Object tail, elt, tmp;
2048 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
2049 XSETBUFFER (tmp, buf);
2050 XSETSYMBOL (variable, sym); /* Update in case of aliasing. */
2052 if (EQ (blv->where, tmp)) /* The binding is already loaded. */
2053 return blv_found (blv) ? Qt : Qnil;
2054 else
2055 for (tail = BVAR (buf, local_var_alist); CONSP (tail); tail = XCDR (tail))
2057 elt = XCAR (tail);
2058 if (EQ (variable, XCAR (elt)))
2059 return Qt;
2061 return Qnil;
2063 case SYMBOL_FORWARDED:
2065 union Lisp_Fwd *valcontents = SYMBOL_FWD (sym);
2066 if (BUFFER_OBJFWDP (valcontents))
2068 int offset = XBUFFER_OBJFWD (valcontents)->offset;
2069 int idx = PER_BUFFER_IDX (offset);
2070 if (idx == -1 || PER_BUFFER_VALUE_P (buf, idx))
2071 return Qt;
2073 return Qnil;
2075 default: emacs_abort ();
2079 DEFUN ("local-variable-if-set-p", Flocal_variable_if_set_p, Slocal_variable_if_set_p,
2080 1, 2, 0,
2081 doc: /* Non-nil if VARIABLE is local in buffer BUFFER when set there.
2082 BUFFER defaults to the current buffer.
2084 More precisely, return non-nil if either VARIABLE already has a local
2085 value in BUFFER, or if VARIABLE is automatically buffer-local (see
2086 `make-variable-buffer-local'). */)
2087 (register Lisp_Object variable, Lisp_Object buffer)
2089 struct Lisp_Symbol *sym;
2091 CHECK_SYMBOL (variable);
2092 sym = XSYMBOL (variable);
2094 start:
2095 switch (sym->u.s.redirect)
2097 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
2098 case SYMBOL_PLAINVAL: return Qnil;
2099 case SYMBOL_LOCALIZED:
2101 struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym);
2102 if (blv->local_if_set)
2103 return Qt;
2104 XSETSYMBOL (variable, sym); /* Update in case of aliasing. */
2105 return Flocal_variable_p (variable, buffer);
2107 case SYMBOL_FORWARDED:
2108 /* All BUFFER_OBJFWD slots become local if they are set. */
2109 return (BUFFER_OBJFWDP (SYMBOL_FWD (sym)) ? Qt : Qnil);
2110 default: emacs_abort ();
2114 DEFUN ("variable-binding-locus", Fvariable_binding_locus, Svariable_binding_locus,
2115 1, 1, 0,
2116 doc: /* Return a value indicating where VARIABLE's current binding comes from.
2117 If the current binding is buffer-local, the value is the current buffer.
2118 If the current binding is global (the default), the value is nil. */)
2119 (register Lisp_Object variable)
2121 struct Lisp_Symbol *sym;
2123 CHECK_SYMBOL (variable);
2124 sym = XSYMBOL (variable);
2126 /* Make sure the current binding is actually swapped in. */
2127 find_symbol_value (variable);
2129 start:
2130 switch (sym->u.s.redirect)
2132 case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start;
2133 case SYMBOL_PLAINVAL: return Qnil;
2134 case SYMBOL_FORWARDED:
2136 union Lisp_Fwd *valcontents = SYMBOL_FWD (sym);
2137 if (KBOARD_OBJFWDP (valcontents))
2138 return Fframe_terminal (selected_frame);
2139 else if (!BUFFER_OBJFWDP (valcontents))
2140 return Qnil;
2142 FALLTHROUGH;
2143 case SYMBOL_LOCALIZED:
2144 /* For a local variable, record both the symbol and which
2145 buffer's or frame's value we are saving. */
2146 if (!NILP (Flocal_variable_p (variable, Qnil)))
2147 return Fcurrent_buffer ();
2148 else if (sym->u.s.redirect == SYMBOL_LOCALIZED
2149 && blv_found (SYMBOL_BLV (sym)))
2150 return SYMBOL_BLV (sym)->where;
2151 else
2152 return Qnil;
2153 default: emacs_abort ();
2157 /* This code is disabled now that we use the selected frame to return
2158 keyboard-local-values. */
2159 #if 0
2160 extern struct terminal *get_terminal (Lisp_Object display, int);
2162 DEFUN ("terminal-local-value", Fterminal_local_value,
2163 Sterminal_local_value, 2, 2, 0,
2164 doc: /* Return the terminal-local value of SYMBOL on TERMINAL.
2165 If SYMBOL is not a terminal-local variable, then return its normal
2166 value, like `symbol-value'.
2168 TERMINAL may be a terminal object, a frame, or nil (meaning the
2169 selected frame's terminal device). */)
2170 (Lisp_Object symbol, Lisp_Object terminal)
2172 Lisp_Object result;
2173 struct terminal *t = get_terminal (terminal, 1);
2174 push_kboard (t->kboard);
2175 result = Fsymbol_value (symbol);
2176 pop_kboard ();
2177 return result;
2180 DEFUN ("set-terminal-local-value", Fset_terminal_local_value,
2181 Sset_terminal_local_value, 3, 3, 0,
2182 doc: /* Set the terminal-local binding of SYMBOL on TERMINAL to VALUE.
2183 If VARIABLE is not a terminal-local variable, then set its normal
2184 binding, like `set'.
2186 TERMINAL may be a terminal object, a frame, or nil (meaning the
2187 selected frame's terminal device). */)
2188 (Lisp_Object symbol, Lisp_Object terminal, Lisp_Object value)
2190 Lisp_Object result;
2191 struct terminal *t = get_terminal (terminal, 1);
2192 push_kboard (d->kboard);
2193 result = Fset (symbol, value);
2194 pop_kboard ();
2195 return result;
2197 #endif
2199 /* Find the function at the end of a chain of symbol function indirections. */
2201 /* If OBJECT is a symbol, find the end of its function chain and
2202 return the value found there. If OBJECT is not a symbol, just
2203 return it. If there is a cycle in the function chain, signal a
2204 cyclic-function-indirection error.
2206 This is like Findirect_function, except that it doesn't signal an
2207 error if the chain ends up unbound. */
2208 Lisp_Object
2209 indirect_function (register Lisp_Object object)
2211 Lisp_Object tortoise, hare;
2213 hare = tortoise = object;
2215 for (;;)
2217 if (!SYMBOLP (hare) || NILP (hare))
2218 break;
2219 hare = XSYMBOL (hare)->u.s.function;
2220 if (!SYMBOLP (hare) || NILP (hare))
2221 break;
2222 hare = XSYMBOL (hare)->u.s.function;
2224 tortoise = XSYMBOL (tortoise)->u.s.function;
2226 if (EQ (hare, tortoise))
2227 xsignal1 (Qcyclic_function_indirection, object);
2230 return hare;
2233 DEFUN ("indirect-function", Findirect_function, Sindirect_function, 1, 2, 0,
2234 doc: /* Return the function at the end of OBJECT's function chain.
2235 If OBJECT is not a symbol, just return it. Otherwise, follow all
2236 function indirections to find the final function binding and return it.
2237 Signal a cyclic-function-indirection error if there is a loop in the
2238 function chain of symbols. */)
2239 (register Lisp_Object object, Lisp_Object noerror)
2241 Lisp_Object result;
2243 /* Optimize for no indirection. */
2244 result = object;
2245 if (SYMBOLP (result) && !NILP (result)
2246 && (result = XSYMBOL (result)->u.s.function, SYMBOLP (result)))
2247 result = indirect_function (result);
2248 if (!NILP (result))
2249 return result;
2251 return Qnil;
2254 /* Extract and set vector and string elements. */
2256 DEFUN ("aref", Faref, Saref, 2, 2, 0,
2257 doc: /* Return the element of ARRAY at index IDX.
2258 ARRAY may be a vector, a string, a char-table, a bool-vector, a record,
2259 or a byte-code object. IDX starts at 0. */)
2260 (register Lisp_Object array, Lisp_Object idx)
2262 register EMACS_INT idxval;
2264 CHECK_NUMBER (idx);
2265 idxval = XINT (idx);
2266 if (STRINGP (array))
2268 int c;
2269 ptrdiff_t idxval_byte;
2271 if (idxval < 0 || idxval >= SCHARS (array))
2272 args_out_of_range (array, idx);
2273 if (! STRING_MULTIBYTE (array))
2274 return make_number ((unsigned char) SREF (array, idxval));
2275 idxval_byte = string_char_to_byte (array, idxval);
2277 c = STRING_CHAR (SDATA (array) + idxval_byte);
2278 return make_number (c);
2280 else if (BOOL_VECTOR_P (array))
2282 if (idxval < 0 || idxval >= bool_vector_size (array))
2283 args_out_of_range (array, idx);
2284 return bool_vector_ref (array, idxval);
2286 else if (CHAR_TABLE_P (array))
2288 CHECK_CHARACTER (idx);
2289 return CHAR_TABLE_REF (array, idxval);
2291 else
2293 ptrdiff_t size = 0;
2294 if (VECTORP (array))
2295 size = ASIZE (array);
2296 else if (COMPILEDP (array) || RECORDP (array))
2297 size = PVSIZE (array);
2298 else
2299 wrong_type_argument (Qarrayp, array);
2301 if (idxval < 0 || idxval >= size)
2302 args_out_of_range (array, idx);
2303 return AREF (array, idxval);
2307 DEFUN ("aset", Faset, Saset, 3, 3, 0,
2308 doc: /* Store into the element of ARRAY at index IDX the value NEWELT.
2309 Return NEWELT. ARRAY may be a vector, a string, a char-table or a
2310 bool-vector. IDX starts at 0. */)
2311 (register Lisp_Object array, Lisp_Object idx, Lisp_Object newelt)
2313 register EMACS_INT idxval;
2315 CHECK_NUMBER (idx);
2316 idxval = XINT (idx);
2317 if (! RECORDP (array))
2318 CHECK_ARRAY (array, Qarrayp);
2320 if (VECTORP (array))
2322 CHECK_IMPURE (array, XVECTOR (array));
2323 if (idxval < 0 || idxval >= ASIZE (array))
2324 args_out_of_range (array, idx);
2325 ASET (array, idxval, newelt);
2327 else if (BOOL_VECTOR_P (array))
2329 if (idxval < 0 || idxval >= bool_vector_size (array))
2330 args_out_of_range (array, idx);
2331 bool_vector_set (array, idxval, !NILP (newelt));
2333 else if (CHAR_TABLE_P (array))
2335 CHECK_CHARACTER (idx);
2336 CHAR_TABLE_SET (array, idxval, newelt);
2338 else if (RECORDP (array))
2340 if (idxval < 0 || idxval >= PVSIZE (array))
2341 args_out_of_range (array, idx);
2342 ASET (array, idxval, newelt);
2344 else /* STRINGP */
2346 int c;
2348 CHECK_IMPURE (array, XSTRING (array));
2349 if (idxval < 0 || idxval >= SCHARS (array))
2350 args_out_of_range (array, idx);
2351 CHECK_CHARACTER (newelt);
2352 c = XFASTINT (newelt);
2354 if (STRING_MULTIBYTE (array))
2356 ptrdiff_t idxval_byte, nbytes;
2357 int prev_bytes, new_bytes;
2358 unsigned char workbuf[MAX_MULTIBYTE_LENGTH], *p0 = workbuf, *p1;
2360 nbytes = SBYTES (array);
2361 idxval_byte = string_char_to_byte (array, idxval);
2362 p1 = SDATA (array) + idxval_byte;
2363 prev_bytes = BYTES_BY_CHAR_HEAD (*p1);
2364 new_bytes = CHAR_STRING (c, p0);
2365 if (prev_bytes != new_bytes)
2367 /* We must relocate the string data. */
2368 ptrdiff_t nchars = SCHARS (array);
2369 USE_SAFE_ALLOCA;
2370 unsigned char *str = SAFE_ALLOCA (nbytes);
2372 memcpy (str, SDATA (array), nbytes);
2373 allocate_string_data (XSTRING (array), nchars,
2374 nbytes + new_bytes - prev_bytes);
2375 memcpy (SDATA (array), str, idxval_byte);
2376 p1 = SDATA (array) + idxval_byte;
2377 memcpy (p1 + new_bytes, str + idxval_byte + prev_bytes,
2378 nbytes - (idxval_byte + prev_bytes));
2379 SAFE_FREE ();
2380 clear_string_char_byte_cache ();
2382 while (new_bytes--)
2383 *p1++ = *p0++;
2385 else
2387 if (! SINGLE_BYTE_CHAR_P (c))
2389 ptrdiff_t i;
2391 for (i = SBYTES (array) - 1; i >= 0; i--)
2392 if (SREF (array, i) >= 0x80)
2393 args_out_of_range (array, newelt);
2394 /* ARRAY is an ASCII string. Convert it to a multibyte
2395 string, and try `aset' again. */
2396 STRING_SET_MULTIBYTE (array);
2397 return Faset (array, idx, newelt);
2399 SSET (array, idxval, c);
2403 return newelt;
2406 /* Arithmetic functions */
2408 Lisp_Object
2409 arithcompare (Lisp_Object num1, Lisp_Object num2,
2410 enum Arith_Comparison comparison)
2412 double f1, f2;
2413 EMACS_INT i1, i2;
2414 bool fneq;
2415 bool test;
2417 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num1);
2418 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (num2);
2420 /* If either arg is floating point, set F1 and F2 to the 'double'
2421 approximations of the two arguments, and set FNEQ if floating-point
2422 comparison reports that F1 is not equal to F2, possibly because F1
2423 or F2 is a NaN. Regardless, set I1 and I2 to integers that break
2424 ties if the floating-point comparison is either not done or reports
2425 equality. */
2427 if (FLOATP (num1))
2429 f1 = XFLOAT_DATA (num1);
2430 if (FLOATP (num2))
2432 i1 = i2 = 0;
2433 f2 = XFLOAT_DATA (num2);
2435 else
2437 /* Compare a float NUM1 to an integer NUM2 by converting the
2438 integer I2 (i.e., NUM2) to the double F2 (a conversion that
2439 can round on some platforms, if I2 is large enough), and then
2440 converting F2 back to the integer I1 (a conversion that is
2441 always exact), so that I1 exactly equals ((double) NUM2). If
2442 floating-point comparison reports a tie, NUM1 = F1 = F2 = I1
2443 (exactly) so I1 - I2 = NUM1 - NUM2 (exactly), so comparing I1
2444 to I2 will break the tie correctly. */
2445 i1 = f2 = i2 = XINT (num2);
2447 fneq = f1 != f2;
2449 else
2451 i1 = XINT (num1);
2452 if (FLOATP (num2))
2454 /* Compare an integer NUM1 to a float NUM2. This is the
2455 converse of comparing float to integer (see above). */
2456 i2 = f1 = i1;
2457 f2 = XFLOAT_DATA (num2);
2458 fneq = f1 != f2;
2460 else
2462 i2 = XINT (num2);
2463 fneq = false;
2467 switch (comparison)
2469 case ARITH_EQUAL:
2470 test = !fneq && i1 == i2;
2471 break;
2473 case ARITH_NOTEQUAL:
2474 test = fneq || i1 != i2;
2475 break;
2477 case ARITH_LESS:
2478 test = fneq ? f1 < f2 : i1 < i2;
2479 break;
2481 case ARITH_LESS_OR_EQUAL:
2482 test = fneq ? f1 <= f2 : i1 <= i2;
2483 break;
2485 case ARITH_GRTR:
2486 test = fneq ? f1 > f2 : i1 > i2;
2487 break;
2489 case ARITH_GRTR_OR_EQUAL:
2490 test = fneq ? f1 >= f2 : i1 >= i2;
2491 break;
2493 default:
2494 eassume (false);
2497 return test ? Qt : Qnil;
2500 static Lisp_Object
2501 arithcompare_driver (ptrdiff_t nargs, Lisp_Object *args,
2502 enum Arith_Comparison comparison)
2504 for (ptrdiff_t i = 1; i < nargs; i++)
2505 if (NILP (arithcompare (args[i - 1], args[i], comparison)))
2506 return Qnil;
2507 return Qt;
2510 DEFUN ("=", Feqlsign, Seqlsign, 1, MANY, 0,
2511 doc: /* Return t if args, all numbers or markers, are equal.
2512 usage: (= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2513 (ptrdiff_t nargs, Lisp_Object *args)
2515 return arithcompare_driver (nargs, args, ARITH_EQUAL);
2518 DEFUN ("<", Flss, Slss, 1, MANY, 0,
2519 doc: /* Return t if each arg (a number or marker), is less than the next arg.
2520 usage: (< NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2521 (ptrdiff_t nargs, Lisp_Object *args)
2523 return arithcompare_driver (nargs, args, ARITH_LESS);
2526 DEFUN (">", Fgtr, Sgtr, 1, MANY, 0,
2527 doc: /* Return t if each arg (a number or marker) is greater than the next arg.
2528 usage: (> NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2529 (ptrdiff_t nargs, Lisp_Object *args)
2531 return arithcompare_driver (nargs, args, ARITH_GRTR);
2534 DEFUN ("<=", Fleq, Sleq, 1, MANY, 0,
2535 doc: /* Return t if each arg (a number or marker) is less than or equal to the next.
2536 usage: (<= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2537 (ptrdiff_t nargs, Lisp_Object *args)
2539 return arithcompare_driver (nargs, args, ARITH_LESS_OR_EQUAL);
2542 DEFUN (">=", Fgeq, Sgeq, 1, MANY, 0,
2543 doc: /* Return t if each arg (a number or marker) is greater than or equal to the next.
2544 usage: (>= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
2545 (ptrdiff_t nargs, Lisp_Object *args)
2547 return arithcompare_driver (nargs, args, ARITH_GRTR_OR_EQUAL);
2550 DEFUN ("/=", Fneq, Sneq, 2, 2, 0,
2551 doc: /* Return t if first arg is not equal to second arg. Both must be numbers or markers. */)
2552 (register Lisp_Object num1, Lisp_Object num2)
2554 return arithcompare (num1, num2, ARITH_NOTEQUAL);
2557 /* Convert the integer I to a cons-of-integers, where I is not in
2558 fixnum range. */
2560 #define INTBIG_TO_LISP(i, extremum) \
2561 (eassert (FIXNUM_OVERFLOW_P (i)), \
2562 (! (FIXNUM_OVERFLOW_P ((extremum) >> 16) \
2563 && FIXNUM_OVERFLOW_P ((i) >> 16)) \
2564 ? Fcons (make_number ((i) >> 16), make_number ((i) & 0xffff)) \
2565 : ! (FIXNUM_OVERFLOW_P ((extremum) >> 16 >> 24) \
2566 && FIXNUM_OVERFLOW_P ((i) >> 16 >> 24)) \
2567 ? Fcons (make_number ((i) >> 16 >> 24), \
2568 Fcons (make_number ((i) >> 16 & 0xffffff), \
2569 make_number ((i) & 0xffff))) \
2570 : make_float (i)))
2572 Lisp_Object
2573 intbig_to_lisp (intmax_t i)
2575 return INTBIG_TO_LISP (i, INTMAX_MIN);
2578 Lisp_Object
2579 uintbig_to_lisp (uintmax_t i)
2581 return INTBIG_TO_LISP (i, UINTMAX_MAX);
2584 /* Convert the cons-of-integers, integer, or float value C to an
2585 unsigned value with maximum value MAX, where MAX is one less than a
2586 power of 2. Signal an error if C does not have a valid format or
2587 is out of range. */
2588 uintmax_t
2589 cons_to_unsigned (Lisp_Object c, uintmax_t max)
2591 bool valid = false;
2592 uintmax_t val UNINIT;
2593 if (INTEGERP (c))
2595 valid = XINT (c) >= 0;
2596 val = XINT (c);
2598 else if (FLOATP (c))
2600 double d = XFLOAT_DATA (c);
2601 if (d >= 0 && d < 1.0 + max)
2603 val = d;
2604 valid = val == d;
2607 else if (CONSP (c) && NATNUMP (XCAR (c)))
2609 uintmax_t top = XFASTINT (XCAR (c));
2610 Lisp_Object rest = XCDR (c);
2611 if (top <= UINTMAX_MAX >> 24 >> 16
2612 && CONSP (rest)
2613 && NATNUMP (XCAR (rest)) && XFASTINT (XCAR (rest)) < 1 << 24
2614 && NATNUMP (XCDR (rest)) && XFASTINT (XCDR (rest)) < 1 << 16)
2616 uintmax_t mid = XFASTINT (XCAR (rest));
2617 val = top << 24 << 16 | mid << 16 | XFASTINT (XCDR (rest));
2618 valid = true;
2620 else if (top <= UINTMAX_MAX >> 16)
2622 if (CONSP (rest))
2623 rest = XCAR (rest);
2624 if (NATNUMP (rest) && XFASTINT (rest) < 1 << 16)
2626 val = top << 16 | XFASTINT (rest);
2627 valid = true;
2632 if (! (valid && val <= max))
2633 error ("Not an in-range integer, integral float, or cons of integers");
2634 return val;
2637 /* Convert the cons-of-integers, integer, or float value C to a signed
2638 value with extrema MIN and MAX. MAX should be one less than a
2639 power of 2, and MIN should be zero or the negative of a power of 2.
2640 Signal an error if C does not have a valid format or is out of
2641 range. */
2642 intmax_t
2643 cons_to_signed (Lisp_Object c, intmax_t min, intmax_t max)
2645 bool valid = false;
2646 intmax_t val UNINIT;
2647 if (INTEGERP (c))
2649 val = XINT (c);
2650 valid = true;
2652 else if (FLOATP (c))
2654 double d = XFLOAT_DATA (c);
2655 if (d >= min && d < 1.0 + max)
2657 val = d;
2658 valid = val == d;
2661 else if (CONSP (c) && INTEGERP (XCAR (c)))
2663 intmax_t top = XINT (XCAR (c));
2664 Lisp_Object rest = XCDR (c);
2665 if (top >= INTMAX_MIN >> 24 >> 16 && top <= INTMAX_MAX >> 24 >> 16
2666 && CONSP (rest)
2667 && NATNUMP (XCAR (rest)) && XFASTINT (XCAR (rest)) < 1 << 24
2668 && NATNUMP (XCDR (rest)) && XFASTINT (XCDR (rest)) < 1 << 16)
2670 intmax_t mid = XFASTINT (XCAR (rest));
2671 val = top << 24 << 16 | mid << 16 | XFASTINT (XCDR (rest));
2672 valid = true;
2674 else if (top >= INTMAX_MIN >> 16 && top <= INTMAX_MAX >> 16)
2676 if (CONSP (rest))
2677 rest = XCAR (rest);
2678 if (NATNUMP (rest) && XFASTINT (rest) < 1 << 16)
2680 val = top << 16 | XFASTINT (rest);
2681 valid = true;
2686 if (! (valid && min <= val && val <= max))
2687 error ("Not an in-range integer, integral float, or cons of integers");
2688 return val;
2691 DEFUN ("number-to-string", Fnumber_to_string, Snumber_to_string, 1, 1, 0,
2692 doc: /* Return the decimal representation of NUMBER as a string.
2693 Uses a minus sign if negative.
2694 NUMBER may be an integer or a floating point number. */)
2695 (Lisp_Object number)
2697 char buffer[max (FLOAT_TO_STRING_BUFSIZE, INT_BUFSIZE_BOUND (EMACS_INT))];
2698 int len;
2700 CHECK_NUMBER_OR_FLOAT (number);
2702 if (FLOATP (number))
2703 len = float_to_string (buffer, XFLOAT_DATA (number));
2704 else
2705 len = sprintf (buffer, "%"pI"d", XINT (number));
2707 return make_unibyte_string (buffer, len);
2710 DEFUN ("string-to-number", Fstring_to_number, Sstring_to_number, 1, 2, 0,
2711 doc: /* Parse STRING as a decimal number and return the number.
2712 Ignore leading spaces and tabs, and all trailing chars. Return 0 if
2713 STRING cannot be parsed as an integer or floating point number.
2715 If BASE, interpret STRING as a number in that base. If BASE isn't
2716 present, base 10 is used. BASE must be between 2 and 16 (inclusive).
2717 If the base used is not 10, STRING is always parsed as an integer. */)
2718 (register Lisp_Object string, Lisp_Object base)
2720 register char *p;
2721 register int b;
2722 Lisp_Object val;
2724 CHECK_STRING (string);
2726 if (NILP (base))
2727 b = 10;
2728 else
2730 CHECK_NUMBER (base);
2731 if (! (XINT (base) >= 2 && XINT (base) <= 16))
2732 xsignal1 (Qargs_out_of_range, base);
2733 b = XINT (base);
2736 p = SSDATA (string);
2737 while (*p == ' ' || *p == '\t')
2738 p++;
2740 val = string_to_number (p, b, 1);
2741 return NILP (val) ? make_number (0) : val;
2744 enum arithop
2746 Aadd,
2747 Asub,
2748 Amult,
2749 Adiv,
2750 Alogand,
2751 Alogior,
2752 Alogxor
2755 static Lisp_Object float_arith_driver (double, ptrdiff_t, enum arithop,
2756 ptrdiff_t, Lisp_Object *);
2757 static Lisp_Object
2758 arith_driver (enum arithop code, ptrdiff_t nargs, Lisp_Object *args)
2760 Lisp_Object val;
2761 ptrdiff_t argnum, ok_args;
2762 EMACS_INT accum = 0;
2763 EMACS_INT next, ok_accum;
2764 bool overflow = 0;
2766 switch (code)
2768 case Alogior:
2769 case Alogxor:
2770 case Aadd:
2771 case Asub:
2772 accum = 0;
2773 break;
2774 case Amult:
2775 case Adiv:
2776 accum = 1;
2777 break;
2778 case Alogand:
2779 accum = -1;
2780 break;
2781 default:
2782 break;
2785 for (argnum = 0; argnum < nargs; argnum++)
2787 if (! overflow)
2789 ok_args = argnum;
2790 ok_accum = accum;
2793 /* Using args[argnum] as argument to CHECK_NUMBER_... */
2794 val = args[argnum];
2795 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2797 if (FLOATP (val))
2798 return float_arith_driver (ok_accum, ok_args, code,
2799 nargs, args);
2800 args[argnum] = val;
2801 next = XINT (args[argnum]);
2802 switch (code)
2804 case Aadd:
2805 overflow |= INT_ADD_WRAPV (accum, next, &accum);
2806 break;
2807 case Asub:
2808 if (! argnum)
2809 accum = nargs == 1 ? - next : next;
2810 else
2811 overflow |= INT_SUBTRACT_WRAPV (accum, next, &accum);
2812 break;
2813 case Amult:
2814 overflow |= INT_MULTIPLY_WRAPV (accum, next, &accum);
2815 break;
2816 case Adiv:
2817 if (! (argnum || nargs == 1))
2818 accum = next;
2819 else
2821 if (next == 0)
2822 xsignal0 (Qarith_error);
2823 if (INT_DIVIDE_OVERFLOW (accum, next))
2824 overflow = true;
2825 else
2826 accum /= next;
2828 break;
2829 case Alogand:
2830 accum &= next;
2831 break;
2832 case Alogior:
2833 accum |= next;
2834 break;
2835 case Alogxor:
2836 accum ^= next;
2837 break;
2841 XSETINT (val, accum);
2842 return val;
2845 #ifndef isnan
2846 # define isnan(x) ((x) != (x))
2847 #endif
2849 static Lisp_Object
2850 float_arith_driver (double accum, ptrdiff_t argnum, enum arithop code,
2851 ptrdiff_t nargs, Lisp_Object *args)
2853 register Lisp_Object val;
2854 double next;
2856 for (; argnum < nargs; argnum++)
2858 val = args[argnum]; /* using args[argnum] as argument to CHECK_NUMBER_... */
2859 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
2861 if (FLOATP (val))
2863 next = XFLOAT_DATA (val);
2865 else
2867 args[argnum] = val; /* runs into a compiler bug. */
2868 next = XINT (args[argnum]);
2870 switch (code)
2872 case Aadd:
2873 accum += next;
2874 break;
2875 case Asub:
2876 accum = argnum ? accum - next : nargs == 1 ? - next : next;
2877 break;
2878 case Amult:
2879 accum *= next;
2880 break;
2881 case Adiv:
2882 if (! (argnum || nargs == 1))
2883 accum = next;
2884 else
2886 if (! IEEE_FLOATING_POINT && next == 0)
2887 xsignal0 (Qarith_error);
2888 accum /= next;
2890 break;
2891 case Alogand:
2892 case Alogior:
2893 case Alogxor:
2894 wrong_type_argument (Qinteger_or_marker_p, val);
2898 return make_float (accum);
2902 DEFUN ("+", Fplus, Splus, 0, MANY, 0,
2903 doc: /* Return sum of any number of arguments, which are numbers or markers.
2904 usage: (+ &rest NUMBERS-OR-MARKERS) */)
2905 (ptrdiff_t nargs, Lisp_Object *args)
2907 return arith_driver (Aadd, nargs, args);
2910 DEFUN ("-", Fminus, Sminus, 0, MANY, 0,
2911 doc: /* Negate number or subtract numbers or markers and return the result.
2912 With one arg, negates it. With more than one arg,
2913 subtracts all but the first from the first.
2914 usage: (- &optional NUMBER-OR-MARKER &rest MORE-NUMBERS-OR-MARKERS) */)
2915 (ptrdiff_t nargs, Lisp_Object *args)
2917 return arith_driver (Asub, nargs, args);
2920 DEFUN ("*", Ftimes, Stimes, 0, MANY, 0,
2921 doc: /* Return product of any number of arguments, which are numbers or markers.
2922 usage: (* &rest NUMBERS-OR-MARKERS) */)
2923 (ptrdiff_t nargs, Lisp_Object *args)
2925 return arith_driver (Amult, nargs, args);
2928 DEFUN ("/", Fquo, Squo, 1, MANY, 0,
2929 doc: /* Divide number by divisors and return the result.
2930 With two or more arguments, return first argument divided by the rest.
2931 With one argument, return 1 divided by the argument.
2932 The arguments must be numbers or markers.
2933 usage: (/ NUMBER &rest DIVISORS) */)
2934 (ptrdiff_t nargs, Lisp_Object *args)
2936 ptrdiff_t argnum;
2937 for (argnum = 2; argnum < nargs; argnum++)
2938 if (FLOATP (args[argnum]))
2939 return float_arith_driver (0, 0, Adiv, nargs, args);
2940 return arith_driver (Adiv, nargs, args);
2943 DEFUN ("%", Frem, Srem, 2, 2, 0,
2944 doc: /* Return remainder of X divided by Y.
2945 Both must be integers or markers. */)
2946 (register Lisp_Object x, Lisp_Object y)
2948 Lisp_Object val;
2950 CHECK_NUMBER_COERCE_MARKER (x);
2951 CHECK_NUMBER_COERCE_MARKER (y);
2953 if (XINT (y) == 0)
2954 xsignal0 (Qarith_error);
2956 XSETINT (val, XINT (x) % XINT (y));
2957 return val;
2960 DEFUN ("mod", Fmod, Smod, 2, 2, 0,
2961 doc: /* Return X modulo Y.
2962 The result falls between zero (inclusive) and Y (exclusive).
2963 Both X and Y must be numbers or markers. */)
2964 (register Lisp_Object x, Lisp_Object y)
2966 Lisp_Object val;
2967 EMACS_INT i1, i2;
2969 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (x);
2970 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (y);
2972 if (FLOATP (x) || FLOATP (y))
2973 return fmod_float (x, y);
2975 i1 = XINT (x);
2976 i2 = XINT (y);
2978 if (i2 == 0)
2979 xsignal0 (Qarith_error);
2981 i1 %= i2;
2983 /* If the "remainder" comes out with the wrong sign, fix it. */
2984 if (i2 < 0 ? i1 > 0 : i1 < 0)
2985 i1 += i2;
2987 XSETINT (val, i1);
2988 return val;
2991 static Lisp_Object
2992 minmax_driver (ptrdiff_t nargs, Lisp_Object *args,
2993 enum Arith_Comparison comparison)
2995 Lisp_Object accum = args[0];
2996 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (accum);
2997 for (ptrdiff_t argnum = 1; argnum < nargs; argnum++)
2999 Lisp_Object val = args[argnum];
3000 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (val);
3001 if (!NILP (arithcompare (val, accum, comparison)))
3002 accum = val;
3003 else if (FLOATP (val) && isnan (XFLOAT_DATA (val)))
3004 return val;
3006 return accum;
3009 DEFUN ("max", Fmax, Smax, 1, MANY, 0,
3010 doc: /* Return largest of all the arguments (which must be numbers or markers).
3011 The value is always a number; markers are converted to numbers.
3012 usage: (max NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
3013 (ptrdiff_t nargs, Lisp_Object *args)
3015 return minmax_driver (nargs, args, ARITH_GRTR);
3018 DEFUN ("min", Fmin, Smin, 1, MANY, 0,
3019 doc: /* Return smallest of all the arguments (which must be numbers or markers).
3020 The value is always a number; markers are converted to numbers.
3021 usage: (min NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */)
3022 (ptrdiff_t nargs, Lisp_Object *args)
3024 return minmax_driver (nargs, args, ARITH_LESS);
3027 DEFUN ("logand", Flogand, Slogand, 0, MANY, 0,
3028 doc: /* Return bitwise-and of all the arguments.
3029 Arguments may be integers, or markers converted to integers.
3030 usage: (logand &rest INTS-OR-MARKERS) */)
3031 (ptrdiff_t nargs, Lisp_Object *args)
3033 return arith_driver (Alogand, nargs, args);
3036 DEFUN ("logior", Flogior, Slogior, 0, MANY, 0,
3037 doc: /* Return bitwise-or of all the arguments.
3038 Arguments may be integers, or markers converted to integers.
3039 usage: (logior &rest INTS-OR-MARKERS) */)
3040 (ptrdiff_t nargs, Lisp_Object *args)
3042 return arith_driver (Alogior, nargs, args);
3045 DEFUN ("logxor", Flogxor, Slogxor, 0, MANY, 0,
3046 doc: /* Return bitwise-exclusive-or of all the arguments.
3047 Arguments may be integers, or markers converted to integers.
3048 usage: (logxor &rest INTS-OR-MARKERS) */)
3049 (ptrdiff_t nargs, Lisp_Object *args)
3051 return arith_driver (Alogxor, nargs, args);
3054 static Lisp_Object
3055 ash_lsh_impl (Lisp_Object value, Lisp_Object count, bool lsh)
3057 /* This code assumes that signed right shifts are arithmetic. */
3058 verify ((EMACS_INT) -1 >> 1 == -1);
3060 Lisp_Object val;
3062 CHECK_NUMBER (value);
3063 CHECK_NUMBER (count);
3065 if (XINT (count) >= EMACS_INT_WIDTH)
3066 XSETINT (val, 0);
3067 else if (XINT (count) > 0)
3068 XSETINT (val, XUINT (value) << XINT (count));
3069 else if (XINT (count) <= -EMACS_INT_WIDTH)
3070 XSETINT (val, lsh ? 0 : XINT (value) < 0 ? -1 : 0);
3071 else
3072 XSETINT (val, (lsh ? XUINT (value) >> -XINT (count)
3073 : XINT (value) >> -XINT (count)));
3074 return val;
3077 DEFUN ("ash", Fash, Sash, 2, 2, 0,
3078 doc: /* Return VALUE with its bits shifted left by COUNT.
3079 If COUNT is negative, shifting is actually to the right.
3080 In this case, the sign bit is duplicated. */)
3081 (register Lisp_Object value, Lisp_Object count)
3083 return ash_lsh_impl (value, count, false);
3086 DEFUN ("lsh", Flsh, Slsh, 2, 2, 0,
3087 doc: /* Return VALUE with its bits shifted left by COUNT.
3088 If COUNT is negative, shifting is actually to the right.
3089 In this case, zeros are shifted in on the left. */)
3090 (register Lisp_Object value, Lisp_Object count)
3092 return ash_lsh_impl (value, count, true);
3095 DEFUN ("1+", Fadd1, Sadd1, 1, 1, 0,
3096 doc: /* Return NUMBER plus one. NUMBER may be a number or a marker.
3097 Markers are converted to integers. */)
3098 (register Lisp_Object number)
3100 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
3102 if (FLOATP (number))
3103 return (make_float (1.0 + XFLOAT_DATA (number)));
3105 XSETINT (number, XINT (number) + 1);
3106 return number;
3109 DEFUN ("1-", Fsub1, Ssub1, 1, 1, 0,
3110 doc: /* Return NUMBER minus one. NUMBER may be a number or a marker.
3111 Markers are converted to integers. */)
3112 (register Lisp_Object number)
3114 CHECK_NUMBER_OR_FLOAT_COERCE_MARKER (number);
3116 if (FLOATP (number))
3117 return (make_float (-1.0 + XFLOAT_DATA (number)));
3119 XSETINT (number, XINT (number) - 1);
3120 return number;
3123 DEFUN ("lognot", Flognot, Slognot, 1, 1, 0,
3124 doc: /* Return the bitwise complement of NUMBER. NUMBER must be an integer. */)
3125 (register Lisp_Object number)
3127 CHECK_NUMBER (number);
3128 XSETINT (number, ~XINT (number));
3129 return number;
3132 DEFUN ("byteorder", Fbyteorder, Sbyteorder, 0, 0, 0,
3133 doc: /* Return the byteorder for the machine.
3134 Returns 66 (ASCII uppercase B) for big endian machines or 108 (ASCII
3135 lowercase l) for small endian machines. */
3136 attributes: const)
3137 (void)
3139 unsigned i = 0x04030201;
3140 int order = *(char *)&i == 1 ? 108 : 66;
3142 return make_number (order);
3145 /* Because we round up the bool vector allocate size to word_size
3146 units, we can safely read past the "end" of the vector in the
3147 operations below. These extra bits are always zero. */
3149 static bits_word
3150 bool_vector_spare_mask (EMACS_INT nr_bits)
3152 return (((bits_word) 1) << (nr_bits % BITS_PER_BITS_WORD)) - 1;
3155 /* Info about unsigned long long, falling back on unsigned long
3156 if unsigned long long is not available. */
3158 #if HAVE_UNSIGNED_LONG_LONG_INT && defined ULLONG_WIDTH
3159 enum { ULL_WIDTH = ULLONG_WIDTH };
3160 # define ULL_MAX ULLONG_MAX
3161 #else
3162 enum { ULL_WIDTH = ULONG_WIDTH };
3163 # define ULL_MAX ULONG_MAX
3164 # define count_one_bits_ll count_one_bits_l
3165 # define count_trailing_zeros_ll count_trailing_zeros_l
3166 #endif
3168 /* Shift VAL right by the width of an unsigned long long.
3169 ULL_WIDTH must be less than BITS_PER_BITS_WORD. */
3171 static bits_word
3172 shift_right_ull (bits_word w)
3174 /* Pacify bogus GCC warning about shift count exceeding type width. */
3175 int shift = ULL_WIDTH - BITS_PER_BITS_WORD < 0 ? ULL_WIDTH : 0;
3176 return w >> shift;
3179 /* Return the number of 1 bits in W. */
3181 static int
3182 count_one_bits_word (bits_word w)
3184 if (BITS_WORD_MAX <= UINT_MAX)
3185 return count_one_bits (w);
3186 else if (BITS_WORD_MAX <= ULONG_MAX)
3187 return count_one_bits_l (w);
3188 else
3190 int i = 0, count = 0;
3191 while (count += count_one_bits_ll (w),
3192 (i += ULL_WIDTH) < BITS_PER_BITS_WORD)
3193 w = shift_right_ull (w);
3194 return count;
3198 enum bool_vector_op { bool_vector_exclusive_or,
3199 bool_vector_union,
3200 bool_vector_intersection,
3201 bool_vector_set_difference,
3202 bool_vector_subsetp };
3204 static Lisp_Object
3205 bool_vector_binop_driver (Lisp_Object a,
3206 Lisp_Object b,
3207 Lisp_Object dest,
3208 enum bool_vector_op op)
3210 EMACS_INT nr_bits;
3211 bits_word *adata, *bdata, *destdata;
3212 ptrdiff_t i = 0;
3213 ptrdiff_t nr_words;
3215 CHECK_BOOL_VECTOR (a);
3216 CHECK_BOOL_VECTOR (b);
3218 nr_bits = bool_vector_size (a);
3219 if (bool_vector_size (b) != nr_bits)
3220 wrong_length_argument (a, b, dest);
3222 nr_words = bool_vector_words (nr_bits);
3223 adata = bool_vector_data (a);
3224 bdata = bool_vector_data (b);
3226 if (NILP (dest))
3228 dest = make_uninit_bool_vector (nr_bits);
3229 destdata = bool_vector_data (dest);
3231 else
3233 CHECK_BOOL_VECTOR (dest);
3234 destdata = bool_vector_data (dest);
3235 if (bool_vector_size (dest) != nr_bits)
3236 wrong_length_argument (a, b, dest);
3238 switch (op)
3240 case bool_vector_exclusive_or:
3241 for (; i < nr_words; i++)
3242 if (destdata[i] != (adata[i] ^ bdata[i]))
3243 goto set_dest;
3244 break;
3246 case bool_vector_subsetp:
3247 for (; i < nr_words; i++)
3248 if (adata[i] &~ bdata[i])
3249 return Qnil;
3250 return Qt;
3252 case bool_vector_union:
3253 for (; i < nr_words; i++)
3254 if (destdata[i] != (adata[i] | bdata[i]))
3255 goto set_dest;
3256 break;
3258 case bool_vector_intersection:
3259 for (; i < nr_words; i++)
3260 if (destdata[i] != (adata[i] & bdata[i]))
3261 goto set_dest;
3262 break;
3264 case bool_vector_set_difference:
3265 for (; i < nr_words; i++)
3266 if (destdata[i] != (adata[i] &~ bdata[i]))
3267 goto set_dest;
3268 break;
3271 return Qnil;
3274 set_dest:
3275 switch (op)
3277 case bool_vector_exclusive_or:
3278 for (; i < nr_words; i++)
3279 destdata[i] = adata[i] ^ bdata[i];
3280 break;
3282 case bool_vector_union:
3283 for (; i < nr_words; i++)
3284 destdata[i] = adata[i] | bdata[i];
3285 break;
3287 case bool_vector_intersection:
3288 for (; i < nr_words; i++)
3289 destdata[i] = adata[i] & bdata[i];
3290 break;
3292 case bool_vector_set_difference:
3293 for (; i < nr_words; i++)
3294 destdata[i] = adata[i] &~ bdata[i];
3295 break;
3297 default:
3298 eassume (0);
3301 return dest;
3304 /* PRECONDITION must be true. Return VALUE. This odd construction
3305 works around a bogus GCC diagnostic "shift count >= width of type". */
3307 static int
3308 pre_value (bool precondition, int value)
3310 eassume (precondition);
3311 return precondition ? value : 0;
3314 /* Compute the number of trailing zero bits in val. If val is zero,
3315 return the number of bits in val. */
3316 static int
3317 count_trailing_zero_bits (bits_word val)
3319 if (BITS_WORD_MAX == UINT_MAX)
3320 return count_trailing_zeros (val);
3321 if (BITS_WORD_MAX == ULONG_MAX)
3322 return count_trailing_zeros_l (val);
3323 if (BITS_WORD_MAX == ULL_MAX)
3324 return count_trailing_zeros_ll (val);
3326 /* The rest of this code is for the unlikely platform where bits_word differs
3327 in width from unsigned int, unsigned long, and unsigned long long. */
3328 val |= ~ BITS_WORD_MAX;
3329 if (BITS_WORD_MAX <= UINT_MAX)
3330 return count_trailing_zeros (val);
3331 if (BITS_WORD_MAX <= ULONG_MAX)
3332 return count_trailing_zeros_l (val);
3333 else
3335 int count;
3336 for (count = 0;
3337 count < BITS_PER_BITS_WORD - ULL_WIDTH;
3338 count += ULL_WIDTH)
3340 if (val & ULL_MAX)
3341 return count + count_trailing_zeros_ll (val);
3342 val = shift_right_ull (val);
3345 if (BITS_PER_BITS_WORD % ULL_WIDTH != 0
3346 && BITS_WORD_MAX == (bits_word) -1)
3347 val |= (bits_word) 1 << pre_value (ULONG_MAX < BITS_WORD_MAX,
3348 BITS_PER_BITS_WORD % ULL_WIDTH);
3349 return count + count_trailing_zeros_ll (val);
3353 static bits_word
3354 bits_word_to_host_endian (bits_word val)
3356 #ifndef WORDS_BIGENDIAN
3357 return val;
3358 #else
3359 if (BITS_WORD_MAX >> 31 == 1)
3360 return bswap_32 (val);
3361 # if HAVE_UNSIGNED_LONG_LONG
3362 if (BITS_WORD_MAX >> 31 >> 31 >> 1 == 1)
3363 return bswap_64 (val);
3364 # endif
3366 int i;
3367 bits_word r = 0;
3368 for (i = 0; i < sizeof val; i++)
3370 r = ((r << 1 << (CHAR_BIT - 1))
3371 | (val & ((1u << 1 << (CHAR_BIT - 1)) - 1)));
3372 val = val >> 1 >> (CHAR_BIT - 1);
3374 return r;
3376 #endif
3379 DEFUN ("bool-vector-exclusive-or", Fbool_vector_exclusive_or,
3380 Sbool_vector_exclusive_or, 2, 3, 0,
3381 doc: /* Return A ^ B, bitwise exclusive or.
3382 If optional third argument C is given, store result into C.
3383 A, B, and C must be bool vectors of the same length.
3384 Return the destination vector if it changed or nil otherwise. */)
3385 (Lisp_Object a, Lisp_Object b, Lisp_Object c)
3387 return bool_vector_binop_driver (a, b, c, bool_vector_exclusive_or);
3390 DEFUN ("bool-vector-union", Fbool_vector_union,
3391 Sbool_vector_union, 2, 3, 0,
3392 doc: /* Return A | B, bitwise or.
3393 If optional third argument C is given, store result into C.
3394 A, B, and C must be bool vectors of the same length.
3395 Return the destination vector if it changed or nil otherwise. */)
3396 (Lisp_Object a, Lisp_Object b, Lisp_Object c)
3398 return bool_vector_binop_driver (a, b, c, bool_vector_union);
3401 DEFUN ("bool-vector-intersection", Fbool_vector_intersection,
3402 Sbool_vector_intersection, 2, 3, 0,
3403 doc: /* Return A & B, bitwise and.
3404 If optional third argument C is given, store result into C.
3405 A, B, and C must be bool vectors of the same length.
3406 Return the destination vector if it changed or nil otherwise. */)
3407 (Lisp_Object a, Lisp_Object b, Lisp_Object c)
3409 return bool_vector_binop_driver (a, b, c, bool_vector_intersection);
3412 DEFUN ("bool-vector-set-difference", Fbool_vector_set_difference,
3413 Sbool_vector_set_difference, 2, 3, 0,
3414 doc: /* Return A &~ B, set difference.
3415 If optional third argument C is given, store result into C.
3416 A, B, and C must be bool vectors of the same length.
3417 Return the destination vector if it changed or nil otherwise. */)
3418 (Lisp_Object a, Lisp_Object b, Lisp_Object c)
3420 return bool_vector_binop_driver (a, b, c, bool_vector_set_difference);
3423 DEFUN ("bool-vector-subsetp", Fbool_vector_subsetp,
3424 Sbool_vector_subsetp, 2, 2, 0,
3425 doc: /* Return t if every t value in A is also t in B, nil otherwise.
3426 A and B must be bool vectors of the same length. */)
3427 (Lisp_Object a, Lisp_Object b)
3429 return bool_vector_binop_driver (a, b, b, bool_vector_subsetp);
3432 DEFUN ("bool-vector-not", Fbool_vector_not,
3433 Sbool_vector_not, 1, 2, 0,
3434 doc: /* Compute ~A, set complement.
3435 If optional second argument B is given, store result into B.
3436 A and B must be bool vectors of the same length.
3437 Return the destination vector. */)
3438 (Lisp_Object a, Lisp_Object b)
3440 EMACS_INT nr_bits;
3441 bits_word *bdata, *adata;
3442 ptrdiff_t i;
3444 CHECK_BOOL_VECTOR (a);
3445 nr_bits = bool_vector_size (a);
3447 if (NILP (b))
3448 b = make_uninit_bool_vector (nr_bits);
3449 else
3451 CHECK_BOOL_VECTOR (b);
3452 if (bool_vector_size (b) != nr_bits)
3453 wrong_length_argument (a, b, Qnil);
3456 bdata = bool_vector_data (b);
3457 adata = bool_vector_data (a);
3459 for (i = 0; i < nr_bits / BITS_PER_BITS_WORD; i++)
3460 bdata[i] = BITS_WORD_MAX & ~adata[i];
3462 if (nr_bits % BITS_PER_BITS_WORD)
3464 bits_word mword = bits_word_to_host_endian (adata[i]);
3465 mword = ~mword;
3466 mword &= bool_vector_spare_mask (nr_bits);
3467 bdata[i] = bits_word_to_host_endian (mword);
3470 return b;
3473 DEFUN ("bool-vector-count-population", Fbool_vector_count_population,
3474 Sbool_vector_count_population, 1, 1, 0,
3475 doc: /* Count how many elements in A are t.
3476 A is a bool vector. To count A's nil elements, subtract the return
3477 value from A's length. */)
3478 (Lisp_Object a)
3480 EMACS_INT count;
3481 EMACS_INT nr_bits;
3482 bits_word *adata;
3483 ptrdiff_t i, nwords;
3485 CHECK_BOOL_VECTOR (a);
3487 nr_bits = bool_vector_size (a);
3488 nwords = bool_vector_words (nr_bits);
3489 count = 0;
3490 adata = bool_vector_data (a);
3492 for (i = 0; i < nwords; i++)
3493 count += count_one_bits_word (adata[i]);
3495 return make_number (count);
3498 DEFUN ("bool-vector-count-consecutive", Fbool_vector_count_consecutive,
3499 Sbool_vector_count_consecutive, 3, 3, 0,
3500 doc: /* Count how many consecutive elements in A equal B starting at I.
3501 A is a bool vector, B is t or nil, and I is an index into A. */)
3502 (Lisp_Object a, Lisp_Object b, Lisp_Object i)
3504 EMACS_INT count;
3505 EMACS_INT nr_bits;
3506 int offset;
3507 bits_word *adata;
3508 bits_word twiddle;
3509 bits_word mword; /* Machine word. */
3510 ptrdiff_t pos, pos0;
3511 ptrdiff_t nr_words;
3513 CHECK_BOOL_VECTOR (a);
3514 CHECK_NATNUM (i);
3516 nr_bits = bool_vector_size (a);
3517 if (XFASTINT (i) > nr_bits) /* Allow one past the end for convenience */
3518 args_out_of_range (a, i);
3520 adata = bool_vector_data (a);
3521 nr_words = bool_vector_words (nr_bits);
3522 pos = XFASTINT (i) / BITS_PER_BITS_WORD;
3523 offset = XFASTINT (i) % BITS_PER_BITS_WORD;
3524 count = 0;
3526 /* By XORing with twiddle, we transform the problem of "count
3527 consecutive equal values" into "count the zero bits". The latter
3528 operation usually has hardware support. */
3529 twiddle = NILP (b) ? 0 : BITS_WORD_MAX;
3531 /* Scan the remainder of the mword at the current offset. */
3532 if (pos < nr_words && offset != 0)
3534 mword = bits_word_to_host_endian (adata[pos]);
3535 mword ^= twiddle;
3536 mword >>= offset;
3538 /* Do not count the pad bits. */
3539 mword |= (bits_word) 1 << (BITS_PER_BITS_WORD - offset);
3541 count = count_trailing_zero_bits (mword);
3542 pos++;
3543 if (count + offset < BITS_PER_BITS_WORD)
3544 return make_number (count);
3547 /* Scan whole words until we either reach the end of the vector or
3548 find an mword that doesn't completely match. twiddle is
3549 endian-independent. */
3550 pos0 = pos;
3551 while (pos < nr_words && adata[pos] == twiddle)
3552 pos++;
3553 count += (pos - pos0) * BITS_PER_BITS_WORD;
3555 if (pos < nr_words)
3557 /* If we stopped because of a mismatch, see how many bits match
3558 in the current mword. */
3559 mword = bits_word_to_host_endian (adata[pos]);
3560 mword ^= twiddle;
3561 count += count_trailing_zero_bits (mword);
3563 else if (nr_bits % BITS_PER_BITS_WORD != 0)
3565 /* If we hit the end, we might have overshot our count. Reduce
3566 the total by the number of spare bits at the end of the
3567 vector. */
3568 count -= BITS_PER_BITS_WORD - nr_bits % BITS_PER_BITS_WORD;
3571 return make_number (count);
3575 void
3576 syms_of_data (void)
3578 Lisp_Object error_tail, arith_tail;
3580 DEFSYM (Qquote, "quote");
3581 DEFSYM (Qlambda, "lambda");
3582 DEFSYM (Qerror_conditions, "error-conditions");
3583 DEFSYM (Qerror_message, "error-message");
3584 DEFSYM (Qtop_level, "top-level");
3586 DEFSYM (Qerror, "error");
3587 DEFSYM (Quser_error, "user-error");
3588 DEFSYM (Qquit, "quit");
3589 DEFSYM (Qwrong_length_argument, "wrong-length-argument");
3590 DEFSYM (Qwrong_type_argument, "wrong-type-argument");
3591 DEFSYM (Qargs_out_of_range, "args-out-of-range");
3592 DEFSYM (Qvoid_function, "void-function");
3593 DEFSYM (Qcyclic_function_indirection, "cyclic-function-indirection");
3594 DEFSYM (Qcyclic_variable_indirection, "cyclic-variable-indirection");
3595 DEFSYM (Qvoid_variable, "void-variable");
3596 DEFSYM (Qsetting_constant, "setting-constant");
3597 DEFSYM (Qtrapping_constant, "trapping-constant");
3598 DEFSYM (Qinvalid_read_syntax, "invalid-read-syntax");
3600 DEFSYM (Qinvalid_function, "invalid-function");
3601 DEFSYM (Qwrong_number_of_arguments, "wrong-number-of-arguments");
3602 DEFSYM (Qno_catch, "no-catch");
3603 DEFSYM (Qend_of_file, "end-of-file");
3604 DEFSYM (Qarith_error, "arith-error");
3605 DEFSYM (Qbeginning_of_buffer, "beginning-of-buffer");
3606 DEFSYM (Qend_of_buffer, "end-of-buffer");
3607 DEFSYM (Qbuffer_read_only, "buffer-read-only");
3608 DEFSYM (Qtext_read_only, "text-read-only");
3609 DEFSYM (Qmark_inactive, "mark-inactive");
3611 DEFSYM (Qlistp, "listp");
3612 DEFSYM (Qconsp, "consp");
3613 DEFSYM (Qsymbolp, "symbolp");
3614 DEFSYM (Qintegerp, "integerp");
3615 DEFSYM (Qnatnump, "natnump");
3616 DEFSYM (Qwholenump, "wholenump");
3617 DEFSYM (Qstringp, "stringp");
3618 DEFSYM (Qarrayp, "arrayp");
3619 DEFSYM (Qsequencep, "sequencep");
3620 DEFSYM (Qbufferp, "bufferp");
3621 DEFSYM (Qvectorp, "vectorp");
3622 DEFSYM (Qrecordp, "recordp");
3623 DEFSYM (Qbool_vector_p, "bool-vector-p");
3624 DEFSYM (Qchar_or_string_p, "char-or-string-p");
3625 DEFSYM (Qmarkerp, "markerp");
3626 #ifdef HAVE_MODULES
3627 DEFSYM (Quser_ptrp, "user-ptrp");
3628 #endif
3629 DEFSYM (Qbuffer_or_string_p, "buffer-or-string-p");
3630 DEFSYM (Qinteger_or_marker_p, "integer-or-marker-p");
3631 DEFSYM (Qfboundp, "fboundp");
3633 DEFSYM (Qfloatp, "floatp");
3634 DEFSYM (Qnumberp, "numberp");
3635 DEFSYM (Qnumber_or_marker_p, "number-or-marker-p");
3637 DEFSYM (Qchar_table_p, "char-table-p");
3638 DEFSYM (Qvector_or_char_table_p, "vector-or-char-table-p");
3640 DEFSYM (Qsubrp, "subrp");
3641 DEFSYM (Qunevalled, "unevalled");
3642 DEFSYM (Qmany, "many");
3644 DEFSYM (Qcdr, "cdr");
3646 error_tail = pure_cons (Qerror, Qnil);
3648 /* ERROR is used as a signaler for random errors for which nothing else is
3649 right. */
3651 Fput (Qerror, Qerror_conditions,
3652 error_tail);
3653 Fput (Qerror, Qerror_message,
3654 build_pure_c_string ("error"));
3656 #define PUT_ERROR(sym, tail, msg) \
3657 Fput (sym, Qerror_conditions, pure_cons (sym, tail)); \
3658 Fput (sym, Qerror_message, build_pure_c_string (msg))
3660 PUT_ERROR (Qquit, Qnil, "Quit");
3662 PUT_ERROR (Quser_error, error_tail, "");
3663 PUT_ERROR (Qwrong_length_argument, error_tail, "Wrong length argument");
3664 PUT_ERROR (Qwrong_type_argument, error_tail, "Wrong type argument");
3665 PUT_ERROR (Qargs_out_of_range, error_tail, "Args out of range");
3666 PUT_ERROR (Qvoid_function, error_tail,
3667 "Symbol's function definition is void");
3668 PUT_ERROR (Qcyclic_function_indirection, error_tail,
3669 "Symbol's chain of function indirections contains a loop");
3670 PUT_ERROR (Qcyclic_variable_indirection, error_tail,
3671 "Symbol's chain of variable indirections contains a loop");
3672 DEFSYM (Qcircular_list, "circular-list");
3673 PUT_ERROR (Qcircular_list, error_tail, "List contains a loop");
3674 PUT_ERROR (Qvoid_variable, error_tail, "Symbol's value as variable is void");
3675 PUT_ERROR (Qsetting_constant, error_tail,
3676 "Attempt to set a constant symbol");
3677 PUT_ERROR (Qtrapping_constant, error_tail,
3678 "Attempt to trap writes to a constant symbol");
3679 PUT_ERROR (Qinvalid_read_syntax, error_tail, "Invalid read syntax");
3680 PUT_ERROR (Qinvalid_function, error_tail, "Invalid function");
3681 PUT_ERROR (Qwrong_number_of_arguments, error_tail,
3682 "Wrong number of arguments");
3683 PUT_ERROR (Qno_catch, error_tail, "No catch for tag");
3684 PUT_ERROR (Qend_of_file, error_tail, "End of file during parsing");
3686 arith_tail = pure_cons (Qarith_error, error_tail);
3687 Fput (Qarith_error, Qerror_conditions, arith_tail);
3688 Fput (Qarith_error, Qerror_message, build_pure_c_string ("Arithmetic error"));
3690 PUT_ERROR (Qbeginning_of_buffer, error_tail, "Beginning of buffer");
3691 PUT_ERROR (Qend_of_buffer, error_tail, "End of buffer");
3692 PUT_ERROR (Qbuffer_read_only, error_tail, "Buffer is read-only");
3693 PUT_ERROR (Qtext_read_only, pure_cons (Qbuffer_read_only, error_tail),
3694 "Text is read-only");
3696 DEFSYM (Qrange_error, "range-error");
3697 DEFSYM (Qdomain_error, "domain-error");
3698 DEFSYM (Qsingularity_error, "singularity-error");
3699 DEFSYM (Qoverflow_error, "overflow-error");
3700 DEFSYM (Qunderflow_error, "underflow-error");
3702 PUT_ERROR (Qdomain_error, arith_tail, "Arithmetic domain error");
3704 PUT_ERROR (Qrange_error, arith_tail, "Arithmetic range error");
3706 PUT_ERROR (Qsingularity_error, Fcons (Qdomain_error, arith_tail),
3707 "Arithmetic singularity error");
3709 PUT_ERROR (Qoverflow_error, Fcons (Qdomain_error, arith_tail),
3710 "Arithmetic overflow error");
3711 PUT_ERROR (Qunderflow_error, Fcons (Qdomain_error, arith_tail),
3712 "Arithmetic underflow error");
3714 /* Types that type-of returns. */
3715 DEFSYM (Qinteger, "integer");
3716 DEFSYM (Qsymbol, "symbol");
3717 DEFSYM (Qstring, "string");
3718 DEFSYM (Qcons, "cons");
3719 DEFSYM (Qmarker, "marker");
3720 DEFSYM (Qoverlay, "overlay");
3721 DEFSYM (Qfinalizer, "finalizer");
3722 #ifdef HAVE_MODULES
3723 DEFSYM (Qmodule_function, "module-function");
3724 DEFSYM (Quser_ptr, "user-ptr");
3725 #endif
3726 DEFSYM (Qfloat, "float");
3727 DEFSYM (Qwindow_configuration, "window-configuration");
3728 DEFSYM (Qprocess, "process");
3729 DEFSYM (Qwindow, "window");
3730 DEFSYM (Qsubr, "subr");
3731 DEFSYM (Qcompiled_function, "compiled-function");
3732 DEFSYM (Qbuffer, "buffer");
3733 DEFSYM (Qframe, "frame");
3734 DEFSYM (Qvector, "vector");
3735 DEFSYM (Qrecord, "record");
3736 DEFSYM (Qchar_table, "char-table");
3737 DEFSYM (Qbool_vector, "bool-vector");
3738 DEFSYM (Qhash_table, "hash-table");
3739 DEFSYM (Qthread, "thread");
3740 DEFSYM (Qmutex, "mutex");
3741 DEFSYM (Qcondition_variable, "condition-variable");
3742 DEFSYM (Qfont_spec, "font-spec");
3743 DEFSYM (Qfont_entity, "font-entity");
3744 DEFSYM (Qfont_object, "font-object");
3745 DEFSYM (Qterminal, "terminal");
3747 DEFSYM (Qdefun, "defun");
3749 DEFSYM (Qinteractive_form, "interactive-form");
3750 DEFSYM (Qdefalias_fset_function, "defalias-fset-function");
3752 defsubr (&Sindirect_variable);
3753 defsubr (&Sinteractive_form);
3754 defsubr (&Seq);
3755 defsubr (&Snull);
3756 defsubr (&Stype_of);
3757 defsubr (&Slistp);
3758 defsubr (&Snlistp);
3759 defsubr (&Sconsp);
3760 defsubr (&Satom);
3761 defsubr (&Sintegerp);
3762 defsubr (&Sinteger_or_marker_p);
3763 defsubr (&Snumberp);
3764 defsubr (&Snumber_or_marker_p);
3765 defsubr (&Sfloatp);
3766 defsubr (&Snatnump);
3767 defsubr (&Ssymbolp);
3768 defsubr (&Skeywordp);
3769 defsubr (&Sstringp);
3770 defsubr (&Smultibyte_string_p);
3771 defsubr (&Svectorp);
3772 defsubr (&Srecordp);
3773 defsubr (&Schar_table_p);
3774 defsubr (&Svector_or_char_table_p);
3775 defsubr (&Sbool_vector_p);
3776 defsubr (&Sarrayp);
3777 defsubr (&Ssequencep);
3778 defsubr (&Sbufferp);
3779 defsubr (&Smarkerp);
3780 defsubr (&Ssubrp);
3781 defsubr (&Sbyte_code_function_p);
3782 defsubr (&Smodule_function_p);
3783 defsubr (&Schar_or_string_p);
3784 defsubr (&Sthreadp);
3785 defsubr (&Smutexp);
3786 defsubr (&Scondition_variable_p);
3787 defsubr (&Scar);
3788 defsubr (&Scdr);
3789 defsubr (&Scar_safe);
3790 defsubr (&Scdr_safe);
3791 defsubr (&Ssetcar);
3792 defsubr (&Ssetcdr);
3793 defsubr (&Ssymbol_function);
3794 defsubr (&Sindirect_function);
3795 defsubr (&Ssymbol_plist);
3796 defsubr (&Ssymbol_name);
3797 defsubr (&Smakunbound);
3798 defsubr (&Sfmakunbound);
3799 defsubr (&Sboundp);
3800 defsubr (&Sfboundp);
3801 defsubr (&Sfset);
3802 defsubr (&Sdefalias);
3803 defsubr (&Ssetplist);
3804 defsubr (&Ssymbol_value);
3805 defsubr (&Sset);
3806 defsubr (&Sdefault_boundp);
3807 defsubr (&Sdefault_value);
3808 defsubr (&Sset_default);
3809 defsubr (&Ssetq_default);
3810 defsubr (&Smake_variable_buffer_local);
3811 defsubr (&Smake_local_variable);
3812 defsubr (&Skill_local_variable);
3813 defsubr (&Slocal_variable_p);
3814 defsubr (&Slocal_variable_if_set_p);
3815 defsubr (&Svariable_binding_locus);
3816 #if 0 /* XXX Remove this. --lorentey */
3817 defsubr (&Sterminal_local_value);
3818 defsubr (&Sset_terminal_local_value);
3819 #endif
3820 defsubr (&Saref);
3821 defsubr (&Saset);
3822 defsubr (&Snumber_to_string);
3823 defsubr (&Sstring_to_number);
3824 defsubr (&Seqlsign);
3825 defsubr (&Slss);
3826 defsubr (&Sgtr);
3827 defsubr (&Sleq);
3828 defsubr (&Sgeq);
3829 defsubr (&Sneq);
3830 defsubr (&Splus);
3831 defsubr (&Sminus);
3832 defsubr (&Stimes);
3833 defsubr (&Squo);
3834 defsubr (&Srem);
3835 defsubr (&Smod);
3836 defsubr (&Smax);
3837 defsubr (&Smin);
3838 defsubr (&Slogand);
3839 defsubr (&Slogior);
3840 defsubr (&Slogxor);
3841 defsubr (&Slsh);
3842 defsubr (&Sash);
3843 defsubr (&Sadd1);
3844 defsubr (&Ssub1);
3845 defsubr (&Slognot);
3846 defsubr (&Sbyteorder);
3847 defsubr (&Ssubr_arity);
3848 defsubr (&Ssubr_name);
3849 #ifdef HAVE_MODULES
3850 defsubr (&Suser_ptrp);
3851 #endif
3853 defsubr (&Sbool_vector_exclusive_or);
3854 defsubr (&Sbool_vector_union);
3855 defsubr (&Sbool_vector_intersection);
3856 defsubr (&Sbool_vector_set_difference);
3857 defsubr (&Sbool_vector_not);
3858 defsubr (&Sbool_vector_subsetp);
3859 defsubr (&Sbool_vector_count_consecutive);
3860 defsubr (&Sbool_vector_count_population);
3862 set_symbol_function (Qwholenump, XSYMBOL (Qnatnump)->u.s.function);
3864 DEFVAR_LISP ("most-positive-fixnum", Vmost_positive_fixnum,
3865 doc: /* The largest value that is representable in a Lisp integer.
3866 This variable cannot be set; trying to do so will signal an error. */);
3867 Vmost_positive_fixnum = make_number (MOST_POSITIVE_FIXNUM);
3868 make_symbol_constant (intern_c_string ("most-positive-fixnum"));
3870 DEFVAR_LISP ("most-negative-fixnum", Vmost_negative_fixnum,
3871 doc: /* The smallest value that is representable in a Lisp integer.
3872 This variable cannot be set; trying to do so will signal an error. */);
3873 Vmost_negative_fixnum = make_number (MOST_NEGATIVE_FIXNUM);
3874 make_symbol_constant (intern_c_string ("most-negative-fixnum"));
3876 DEFSYM (Qwatchers, "watchers");
3877 DEFSYM (Qmakunbound, "makunbound");
3878 DEFSYM (Qunlet, "unlet");
3879 DEFSYM (Qset, "set");
3880 DEFSYM (Qset_default, "set-default");
3881 defsubr (&Sadd_variable_watcher);
3882 defsubr (&Sremove_variable_watcher);
3883 defsubr (&Sget_variable_watchers);