/* Primitive operations on Lisp data types for GNU Emacs Lisp interpreter. Copyright (C) 1985-1986, 1988, 1993-1995, 1997-2020 Free Software Foundation, Inc. This file is part of GNU Emacs. GNU Emacs is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. GNU Emacs is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Emacs. If not, see . */ #include #include #include #include #include #include #include #include "lisp.h" #include "bignum.h" #include "puresize.h" #include "character.h" #include "buffer.h" #include "keyboard.h" #include "process.h" #include "frame.h" #include "keymap.h" static void swap_in_symval_forwarding (struct Lisp_Symbol *, struct Lisp_Buffer_Local_Value *); static bool BOOLFWDP (lispfwd a) { return XFWDTYPE (a) == Lisp_Fwd_Bool; } static bool INTFWDP (lispfwd a) { return XFWDTYPE (a) == Lisp_Fwd_Int; } static bool KBOARD_OBJFWDP (lispfwd a) { return XFWDTYPE (a) == Lisp_Fwd_Kboard_Obj; } static bool OBJFWDP (lispfwd a) { return XFWDTYPE (a) == Lisp_Fwd_Obj; } static struct Lisp_Boolfwd const * XBOOLFWD (lispfwd a) { eassert (BOOLFWDP (a)); return a.fwdptr; } static struct Lisp_Kboard_Objfwd const * XKBOARD_OBJFWD (lispfwd a) { eassert (KBOARD_OBJFWDP (a)); return a.fwdptr; } static struct Lisp_Intfwd const * XFIXNUMFWD (lispfwd a) { eassert (INTFWDP (a)); return a.fwdptr; } static struct Lisp_Objfwd const * XOBJFWD (lispfwd a) { eassert (OBJFWDP (a)); return a.fwdptr; } static void CHECK_SUBR (Lisp_Object x) { CHECK_TYPE (SUBRP (x), Qsubrp, x); } static void set_blv_found (struct Lisp_Buffer_Local_Value *blv, int found) { eassert (found == !EQ (blv->defcell, blv->valcell)); blv->found = found; } static Lisp_Object blv_value (struct Lisp_Buffer_Local_Value *blv) { return XCDR (blv->valcell); } static void set_blv_value (struct Lisp_Buffer_Local_Value *blv, Lisp_Object val) { XSETCDR (blv->valcell, val); } static void set_blv_where (struct Lisp_Buffer_Local_Value *blv, Lisp_Object val) { blv->where = val; } static void set_blv_defcell (struct Lisp_Buffer_Local_Value *blv, Lisp_Object val) { blv->defcell = val; } static void set_blv_valcell (struct Lisp_Buffer_Local_Value *blv, Lisp_Object val) { blv->valcell = val; } static AVOID wrong_length_argument (Lisp_Object a1, Lisp_Object a2, Lisp_Object a3) { Lisp_Object size1 = make_fixnum (bool_vector_size (a1)); Lisp_Object size2 = make_fixnum (bool_vector_size (a2)); if (NILP (a3)) xsignal2 (Qwrong_length_argument, size1, size2); else xsignal3 (Qwrong_length_argument, size1, size2, make_fixnum (bool_vector_size (a3))); } AVOID wrong_type_argument (Lisp_Object predicate, Lisp_Object value) { eassert (!TAGGEDP (value, Lisp_Type_Unused0)); xsignal2 (Qwrong_type_argument, predicate, value); } void pure_write_error (Lisp_Object obj) { xsignal2 (Qerror, build_string ("Attempt to modify read-only object"), obj); } void args_out_of_range (Lisp_Object a1, Lisp_Object a2) { xsignal2 (Qargs_out_of_range, a1, a2); } void args_out_of_range_3 (Lisp_Object a1, Lisp_Object a2, Lisp_Object a3) { xsignal3 (Qargs_out_of_range, a1, a2, a3); } void circular_list (Lisp_Object list) { xsignal1 (Qcircular_list, list); } /* Data type predicates. */ DEFUN ("eq", Feq, Seq, 2, 2, 0, doc: /* Return t if the two args are the same Lisp object. */ attributes: const) (Lisp_Object obj1, Lisp_Object obj2) { if (EQ (obj1, obj2)) return Qt; return Qnil; } DEFUN ("null", Fnull, Snull, 1, 1, 0, doc: /* Return t if OBJECT is nil, and return nil otherwise. */ attributes: const) (Lisp_Object object) { if (NILP (object)) return Qt; return Qnil; } DEFUN ("type-of", Ftype_of, Stype_of, 1, 1, 0, doc: /* Return a symbol representing the type of OBJECT. The symbol returned names the object's basic type; for example, (type-of 1) returns `integer'. */) (Lisp_Object object) { switch (XTYPE (object)) { case_Lisp_Int: return Qinteger; case Lisp_Symbol: return Qsymbol; case Lisp_String: return Qstring; case Lisp_Cons: return Qcons; case Lisp_Vectorlike: switch (PSEUDOVECTOR_TYPE (XVECTOR (object))) { case PVEC_NORMAL_VECTOR: return Qvector; case PVEC_BIGNUM: return Qinteger; case PVEC_MARKER: return Qmarker; case PVEC_OVERLAY: return Qoverlay; case PVEC_FINALIZER: return Qfinalizer; case PVEC_USER_PTR: return Quser_ptr; case PVEC_WINDOW_CONFIGURATION: return Qwindow_configuration; case PVEC_PROCESS: return Qprocess; case PVEC_WINDOW: return Qwindow; case PVEC_SUBR: return Qsubr; case PVEC_COMPILED: return Qcompiled_function; case PVEC_BUFFER: return Qbuffer; case PVEC_CHAR_TABLE: return Qchar_table; case PVEC_BOOL_VECTOR: return Qbool_vector; case PVEC_FRAME: return Qframe; case PVEC_HASH_TABLE: return Qhash_table; case PVEC_FONT: if (FONT_SPEC_P (object)) return Qfont_spec; if (FONT_ENTITY_P (object)) return Qfont_entity; if (FONT_OBJECT_P (object)) return Qfont_object; else emacs_abort (); /* return Qfont? */ case PVEC_THREAD: return Qthread; case PVEC_MUTEX: return Qmutex; case PVEC_CONDVAR: return Qcondition_variable; case PVEC_TERMINAL: return Qterminal; case PVEC_RECORD: { Lisp_Object t = AREF (object, 0); if (RECORDP (t) && 1 < PVSIZE (t)) /* Return the type name field of the class! */ return AREF (t, 1); else return t; } case PVEC_MODULE_FUNCTION: return Qmodule_function; case PVEC_XWIDGET: return Qxwidget; case PVEC_XWIDGET_VIEW: return Qxwidget_view; /* "Impossible" cases. */ case PVEC_MISC_PTR: case PVEC_OTHER: case PVEC_SUB_CHAR_TABLE: case PVEC_FREE: ; } emacs_abort (); case Lisp_Float: return Qfloat; default: emacs_abort (); } } DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0, doc: /* Return t if OBJECT is a cons cell. */ attributes: const) (Lisp_Object object) { if (CONSP (object)) return Qt; return Qnil; } DEFUN ("atom", Fatom, Satom, 1, 1, 0, doc: /* Return t if OBJECT is not a cons cell. This includes nil. */ attributes: const) (Lisp_Object object) { if (CONSP (object)) return Qnil; return Qt; } DEFUN ("listp", Flistp, Slistp, 1, 1, 0, doc: /* Return t if OBJECT is a list, that is, a cons cell or nil. Otherwise, return nil. */ attributes: const) (Lisp_Object object) { if (CONSP (object) || NILP (object)) return Qt; return Qnil; } DEFUN ("nlistp", Fnlistp, Snlistp, 1, 1, 0, doc: /* Return t if OBJECT is not a list. Lists include nil. */ attributes: const) (Lisp_Object object) { if (CONSP (object) || NILP (object)) return Qnil; return Qt; } DEFUN ("symbolp", Fsymbolp, Ssymbolp, 1, 1, 0, doc: /* Return t if OBJECT is a symbol. */ attributes: const) (Lisp_Object object) { if (SYMBOLP (object)) return Qt; return Qnil; } DEFUN ("keywordp", Fkeywordp, Skeywordp, 1, 1, 0, doc: /* Return t if OBJECT is a keyword. This means that it is a symbol with a print name beginning with `:' interned in the initial obarray. */) (Lisp_Object object) { if (SYMBOLP (object) && SREF (SYMBOL_NAME (object), 0) == ':' && SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P (object)) return Qt; return Qnil; } DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0, doc: /* Return t if OBJECT is a vector. */) (Lisp_Object object) { if (VECTORP (object)) return Qt; return Qnil; } DEFUN ("recordp", Frecordp, Srecordp, 1, 1, 0, doc: /* Return t if OBJECT is a record. */) (Lisp_Object object) { if (RECORDP (object)) return Qt; return Qnil; } DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0, doc: /* Return t if OBJECT is a string. */ attributes: const) (Lisp_Object object) { if (STRINGP (object)) return Qt; return Qnil; } DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p, 1, 1, 0, doc: /* Return t if OBJECT is a multibyte string. Return nil if OBJECT is either a unibyte string, or not a string. */) (Lisp_Object object) { if (STRINGP (object) && STRING_MULTIBYTE (object)) return Qt; return Qnil; } DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0, doc: /* Return t if OBJECT is a char-table. */) (Lisp_Object object) { if (CHAR_TABLE_P (object)) return Qt; return Qnil; } DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p, Svector_or_char_table_p, 1, 1, 0, doc: /* Return t if OBJECT is a char-table or vector. */) (Lisp_Object object) { if (VECTORP (object) || CHAR_TABLE_P (object)) return Qt; return Qnil; } DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0, doc: /* Return t if OBJECT is a bool-vector. */) (Lisp_Object object) { if (BOOL_VECTOR_P (object)) return Qt; return Qnil; } DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0, doc: /* Return t if OBJECT is an array (string or vector). */) (Lisp_Object object) { if (ARRAYP (object)) return Qt; return Qnil; } DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0, doc: /* Return t if OBJECT is a sequence (list or array). */) (register Lisp_Object object) { if (CONSP (object) || NILP (object) || ARRAYP (object)) return Qt; return Qnil; } DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0, doc: /* Return t if OBJECT is an editor buffer. */) (Lisp_Object object) { if (BUFFERP (object)) return Qt; return Qnil; } DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0, doc: /* Return t if OBJECT is a marker (editor pointer). */) (Lisp_Object object) { if (MARKERP (object)) return Qt; return Qnil; } #ifdef HAVE_MODULES DEFUN ("user-ptrp", Fuser_ptrp, Suser_ptrp, 1, 1, 0, doc: /* Return t if OBJECT is a module user pointer. */) (Lisp_Object object) { if (USER_PTRP (object)) return Qt; return Qnil; } #endif DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0, doc: /* Return t if OBJECT is a built-in function. */) (Lisp_Object object) { if (SUBRP (object)) return Qt; return Qnil; } DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p, 1, 1, 0, doc: /* Return t if OBJECT is a byte-compiled function object. */) (Lisp_Object object) { if (COMPILEDP (object)) return Qt; return Qnil; } DEFUN ("module-function-p", Fmodule_function_p, Smodule_function_p, 1, 1, NULL, doc: /* Return t if OBJECT is a function loaded from a dynamic module. */ attributes: const) (Lisp_Object object) { return MODULE_FUNCTIONP (object) ? Qt : Qnil; } DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0, doc: /* Return t if OBJECT is a character or a string. */ attributes: const) (register Lisp_Object object) { if (CHARACTERP (object) || STRINGP (object)) return Qt; return Qnil; } DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0, doc: /* Return t if OBJECT is an integer. */ attributes: const) (Lisp_Object object) { if (INTEGERP (object)) return Qt; return Qnil; } DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0, doc: /* Return t if OBJECT is an integer or a marker (editor pointer). */) (register Lisp_Object object) { if (MARKERP (object) || INTEGERP (object)) return Qt; return Qnil; } DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0, doc: /* Return t if OBJECT is a nonnegative integer. */ attributes: const) (Lisp_Object object) { return ((FIXNUMP (object) ? 0 <= XFIXNUM (object) : BIGNUMP (object) && 0 <= mpz_sgn (*xbignum_val (object))) ? Qt : Qnil); } DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0, doc: /* Return t if OBJECT is a number (floating point or integer). */ attributes: const) (Lisp_Object object) { if (NUMBERP (object)) return Qt; else return Qnil; } DEFUN ("number-or-marker-p", Fnumber_or_marker_p, Snumber_or_marker_p, 1, 1, 0, doc: /* Return t if OBJECT is a number or a marker. */) (Lisp_Object object) { if (NUMBERP (object) || MARKERP (object)) return Qt; return Qnil; } DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0, doc: /* Return t if OBJECT is a floating point number. */ attributes: const) (Lisp_Object object) { if (FLOATP (object)) return Qt; return Qnil; } DEFUN ("threadp", Fthreadp, Sthreadp, 1, 1, 0, doc: /* Return t if OBJECT is a thread. */) (Lisp_Object object) { if (THREADP (object)) return Qt; return Qnil; } DEFUN ("mutexp", Fmutexp, Smutexp, 1, 1, 0, doc: /* Return t if OBJECT is a mutex. */) (Lisp_Object object) { if (MUTEXP (object)) return Qt; return Qnil; } DEFUN ("condition-variable-p", Fcondition_variable_p, Scondition_variable_p, 1, 1, 0, doc: /* Return t if OBJECT is a condition variable. */) (Lisp_Object object) { if (CONDVARP (object)) return Qt; return Qnil; } /* Extract and set components of lists. */ DEFUN ("car", Fcar, Scar, 1, 1, 0, doc: /* Return the car of LIST. If arg is nil, return nil. Error if arg is not nil and not a cons cell. See also `car-safe'. See Info node `(elisp)Cons Cells' for a discussion of related basic Lisp concepts such as car, cdr, cons cell and list. */) (register Lisp_Object list) { return CAR (list); } DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0, doc: /* Return the car of OBJECT if it is a cons cell, or else nil. */) (Lisp_Object object) { return CAR_SAFE (object); } DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0, doc: /* Return the cdr of LIST. If arg is nil, return nil. Error if arg is not nil and not a cons cell. See also `cdr-safe'. See Info node `(elisp)Cons Cells' for a discussion of related basic Lisp concepts such as cdr, car, cons cell and list. */) (register Lisp_Object list) { return CDR (list); } DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0, doc: /* Return the cdr of OBJECT if it is a cons cell, or else nil. */) (Lisp_Object object) { return CDR_SAFE (object); } DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0, doc: /* Set the car of CELL to be NEWCAR. Returns NEWCAR. */) (register Lisp_Object cell, Lisp_Object newcar) { CHECK_CONS (cell); CHECK_IMPURE (cell, XCONS (cell)); XSETCAR (cell, newcar); return newcar; } DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0, doc: /* Set the cdr of CELL to be NEWCDR. Returns NEWCDR. */) (register Lisp_Object cell, Lisp_Object newcdr) { CHECK_CONS (cell); CHECK_IMPURE (cell, XCONS (cell)); XSETCDR (cell, newcdr); return newcdr; } /* Extract and set components of symbols. */ DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0, doc: /* Return t if SYMBOL's value is not void. Note that if `lexical-binding' is in effect, this refers to the global value outside of any lexical scope. */) (register Lisp_Object symbol) { Lisp_Object valcontents; struct Lisp_Symbol *sym; CHECK_SYMBOL (symbol); sym = XSYMBOL (symbol); start: switch (sym->u.s.redirect) { case SYMBOL_PLAINVAL: valcontents = SYMBOL_VAL (sym); break; case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_LOCALIZED: { struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym); if (blv->fwd.fwdptr) /* In set_internal, we un-forward vars when their value is set to Qunbound. */ return Qt; else { swap_in_symval_forwarding (sym, blv); valcontents = blv_value (blv); } break; } case SYMBOL_FORWARDED: /* In set_internal, we un-forward vars when their value is set to Qunbound. */ return Qt; default: emacs_abort (); } return (EQ (valcontents, Qunbound) ? Qnil : Qt); } /* It has been previously suggested to make this function an alias for symbol-function, but upon discussion at Bug#23957, there is a risk breaking backward compatibility, as some users of fboundp may expect `t' in particular, rather than any true value. */ DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0, doc: /* Return t if SYMBOL's function definition is not void. */) (Lisp_Object symbol) { CHECK_SYMBOL (symbol); return NILP (XSYMBOL (symbol)->u.s.function) ? Qnil : Qt; } DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0, doc: /* Make SYMBOL's value be void. Return SYMBOL. */) (register Lisp_Object symbol) { CHECK_SYMBOL (symbol); if (SYMBOL_CONSTANT_P (symbol)) xsignal1 (Qsetting_constant, symbol); Fset (symbol, Qunbound); return symbol; } DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0, doc: /* Make SYMBOL's function definition be nil. Return SYMBOL. */) (register Lisp_Object symbol) { CHECK_SYMBOL (symbol); if (NILP (symbol) || EQ (symbol, Qt)) xsignal1 (Qsetting_constant, symbol); set_symbol_function (symbol, Qnil); return symbol; } DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0, doc: /* Return SYMBOL's function definition, or nil if that is void. */) (Lisp_Object symbol) { CHECK_SYMBOL (symbol); return XSYMBOL (symbol)->u.s.function; } DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0, doc: /* Return SYMBOL's property list. */) (Lisp_Object symbol) { CHECK_SYMBOL (symbol); return XSYMBOL (symbol)->u.s.plist; } DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0, doc: /* Return SYMBOL's name, a string. */) (register Lisp_Object symbol) { register Lisp_Object name; CHECK_SYMBOL (symbol); name = SYMBOL_NAME (symbol); return name; } DEFUN ("fset", Ffset, Sfset, 2, 2, 0, doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION. */) (register Lisp_Object symbol, Lisp_Object definition) { register Lisp_Object function; CHECK_SYMBOL (symbol); /* Perhaps not quite the right error signal, but seems good enough. */ if (NILP (symbol) && !NILP (definition)) /* There are so many other ways to shoot oneself in the foot, I don't think this one little sanity check is worth its cost, but anyway. */ xsignal1 (Qsetting_constant, symbol); function = XSYMBOL (symbol)->u.s.function; if (!NILP (Vautoload_queue) && !NILP (function)) Vautoload_queue = Fcons (Fcons (symbol, function), Vautoload_queue); if (AUTOLOADP (function)) Fput (symbol, Qautoload, XCDR (function)); eassert (valid_lisp_object_p (definition)); set_symbol_function (symbol, definition); return definition; } DEFUN ("defalias", Fdefalias, Sdefalias, 2, 3, 0, doc: /* Set SYMBOL's function definition to DEFINITION. Associates the function with the current load file, if any. The optional third argument DOCSTRING specifies the documentation string for SYMBOL; if it is omitted or nil, SYMBOL uses the documentation string determined by DEFINITION. Internally, this normally uses `fset', but if SYMBOL has a `defalias-fset-function' property, the associated value is used instead. The return value is undefined. */) (register Lisp_Object symbol, Lisp_Object definition, Lisp_Object docstring) { CHECK_SYMBOL (symbol); if (!NILP (Vpurify_flag) /* If `definition' is a keymap, immutable (and copying) is wrong. */ && !KEYMAPP (definition)) definition = Fpurecopy (definition); { bool autoload = AUTOLOADP (definition); if (!will_dump_p () || !autoload) { /* Only add autoload entries after dumping, because the ones before are not useful and else we get loads of them from the loaddefs.el. */ if (AUTOLOADP (XSYMBOL (symbol)->u.s.function)) /* Remember that the function was already an autoload. */ LOADHIST_ATTACH (Fcons (Qt, symbol)); LOADHIST_ATTACH (Fcons (autoload ? Qautoload : Qdefun, symbol)); } } { /* Handle automatic advice activation. */ Lisp_Object hook = Fget (symbol, Qdefalias_fset_function); if (!NILP (hook)) call2 (hook, symbol, definition); else Ffset (symbol, definition); } if (!NILP (docstring)) Fput (symbol, Qfunction_documentation, docstring); /* We used to return `definition', but now that `defun' and `defmacro' expand to a call to `defalias', we return `symbol' for backward compatibility (bug#11686). */ return symbol; } DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0, doc: /* Set SYMBOL's property list to NEWPLIST, and return NEWPLIST. */) (register Lisp_Object symbol, Lisp_Object newplist) { CHECK_SYMBOL (symbol); set_symbol_plist (symbol, newplist); return newplist; } DEFUN ("subr-arity", Fsubr_arity, Ssubr_arity, 1, 1, 0, doc: /* Return minimum and maximum number of args allowed for SUBR. SUBR must be a built-in function. The returned value is a pair (MIN . MAX). MIN is the minimum number of args. MAX is the maximum number or the symbol `many', for a function with `&rest' args, or `unevalled' for a special form. */) (Lisp_Object subr) { short minargs, maxargs; CHECK_SUBR (subr); minargs = XSUBR (subr)->min_args; maxargs = XSUBR (subr)->max_args; return Fcons (make_fixnum (minargs), maxargs == MANY ? Qmany : maxargs == UNEVALLED ? Qunevalled : make_fixnum (maxargs)); } DEFUN ("subr-name", Fsubr_name, Ssubr_name, 1, 1, 0, doc: /* Return name of subroutine SUBR. SUBR must be a built-in function. */) (Lisp_Object subr) { const char *name; CHECK_SUBR (subr); name = XSUBR (subr)->symbol_name; return build_string (name); } DEFUN ("interactive-form", Finteractive_form, Sinteractive_form, 1, 1, 0, doc: /* Return the interactive form of CMD or nil if none. If CMD is not a command, the return value is nil. Value, if non-nil, is a list (interactive SPEC). */) (Lisp_Object cmd) { Lisp_Object fun = indirect_function (cmd); /* Check cycles. */ if (NILP (fun)) return Qnil; /* Use an `interactive-form' property if present, analogous to the function-documentation property. */ fun = cmd; while (SYMBOLP (fun)) { Lisp_Object tmp = Fget (fun, Qinteractive_form); if (!NILP (tmp)) return tmp; else fun = Fsymbol_function (fun); } if (SUBRP (fun)) { const char *spec = XSUBR (fun)->intspec; if (spec) return list2 (Qinteractive, (*spec != '(') ? build_string (spec) : Fcar (Fread_from_string (build_string (spec), Qnil, Qnil))); } else if (COMPILEDP (fun)) { if (PVSIZE (fun) > COMPILED_INTERACTIVE) return list2 (Qinteractive, AREF (fun, COMPILED_INTERACTIVE)); } else if (AUTOLOADP (fun)) return Finteractive_form (Fautoload_do_load (fun, cmd, Qnil)); else if (CONSP (fun)) { Lisp_Object funcar = XCAR (fun); if (EQ (funcar, Qclosure)) return Fassq (Qinteractive, Fcdr (Fcdr (XCDR (fun)))); else if (EQ (funcar, Qlambda)) return Fassq (Qinteractive, Fcdr (XCDR (fun))); } return Qnil; } /*********************************************************************** Getting and Setting Values of Symbols ***********************************************************************/ /* Return the symbol holding SYMBOL's value. Signal `cyclic-variable-indirection' if SYMBOL's chain of variable indirections contains a loop. */ struct Lisp_Symbol * indirect_variable (struct Lisp_Symbol *symbol) { struct Lisp_Symbol *tortoise, *hare; hare = tortoise = symbol; while (hare->u.s.redirect == SYMBOL_VARALIAS) { hare = SYMBOL_ALIAS (hare); if (hare->u.s.redirect != SYMBOL_VARALIAS) break; hare = SYMBOL_ALIAS (hare); tortoise = SYMBOL_ALIAS (tortoise); if (hare == tortoise) { Lisp_Object tem; XSETSYMBOL (tem, symbol); xsignal1 (Qcyclic_variable_indirection, tem); } } return hare; } DEFUN ("indirect-variable", Findirect_variable, Sindirect_variable, 1, 1, 0, doc: /* Return the variable at the end of OBJECT's variable chain. If OBJECT is a symbol, follow its variable indirections (if any), and return the variable at the end of the chain of aliases. See Info node `(elisp)Variable Aliases'. If OBJECT is not a symbol, just return it. If there is a loop in the chain of aliases, signal a `cyclic-variable-indirection' error. */) (Lisp_Object object) { if (SYMBOLP (object)) { struct Lisp_Symbol *sym = indirect_variable (XSYMBOL (object)); XSETSYMBOL (object, sym); } return object; } /* Given the raw contents of a symbol value cell, return the Lisp value of the symbol. This does not handle buffer-local variables; use swap_in_symval_forwarding for that. */ Lisp_Object do_symval_forwarding (lispfwd valcontents) { switch (XFWDTYPE (valcontents)) { case Lisp_Fwd_Int: return make_int (*XFIXNUMFWD (valcontents)->intvar); case Lisp_Fwd_Bool: return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil); case Lisp_Fwd_Obj: return *XOBJFWD (valcontents)->objvar; case Lisp_Fwd_Buffer_Obj: return per_buffer_value (current_buffer, XBUFFER_OBJFWD (valcontents)->offset); case Lisp_Fwd_Kboard_Obj: /* We used to simply use current_kboard here, but from Lisp code, its value is often unexpected. It seems nicer to allow constructions like this to work as intuitively expected: (with-selected-frame frame (define-key local-function-map "\eOP" [f1])) On the other hand, this affects the semantics of last-command and real-last-command, and people may rely on that. I took a quick look at the Lisp codebase, and I don't think anything will break. --lorentey */ return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset + (char *)FRAME_KBOARD (SELECTED_FRAME ())); default: emacs_abort (); } } /* Used to signal a user-friendly error when symbol WRONG is not a member of CHOICE, which should be a list of symbols. */ void wrong_choice (Lisp_Object choice, Lisp_Object wrong) { ptrdiff_t i = 0, len = list_length (choice); Lisp_Object obj, *args; AUTO_STRING (one_of, "One of "); AUTO_STRING (comma, ", "); AUTO_STRING (or, " or "); AUTO_STRING (should_be_specified, " should be specified"); USE_SAFE_ALLOCA; SAFE_ALLOCA_LISP (args, len * 2 + 1); args[i++] = one_of; for (obj = choice; !NILP (obj); obj = XCDR (obj)) { args[i++] = SYMBOL_NAME (XCAR (obj)); args[i++] = (NILP (XCDR (obj)) ? should_be_specified : NILP (XCDR (XCDR (obj))) ? or : comma); } obj = Fconcat (i, args); /* No need to call SAFE_FREE, since signaling does that for us. */ (void) sa_count; xsignal2 (Qerror, obj, wrong); } /* Used to signal a user-friendly error if WRONG is not a number or integer/floating-point number outsize of inclusive MIN..MAX range. */ static void wrong_range (Lisp_Object min, Lisp_Object max, Lisp_Object wrong) { AUTO_STRING (value_should_be_from, "Value should be from "); AUTO_STRING (to, " to "); xsignal2 (Qerror, CALLN (Fconcat, value_should_be_from, Fnumber_to_string (min), to, Fnumber_to_string (max)), wrong); } /* Store NEWVAL into SYMBOL, where VALCONTENTS is found in the value cell of SYMBOL. If SYMBOL is buffer-local, VALCONTENTS should be the buffer-independent contents of the value cell: forwarded just one step past the buffer-localness. BUF non-zero means set the value in buffer BUF instead of the current buffer. This only plays a role for per-buffer variables. */ static void store_symval_forwarding (lispfwd valcontents, Lisp_Object newval, struct buffer *buf) { switch (XFWDTYPE (valcontents)) { case Lisp_Fwd_Int: { intmax_t i; CHECK_INTEGER (newval); if (! integer_to_intmax (newval, &i)) xsignal1 (Qoverflow_error, newval); *XFIXNUMFWD (valcontents)->intvar = i; } break; case Lisp_Fwd_Bool: *XBOOLFWD (valcontents)->boolvar = !NILP (newval); break; case Lisp_Fwd_Obj: *XOBJFWD (valcontents)->objvar = newval; /* If this variable is a default for something stored in the buffer itself, such as default-fill-column, find the buffers that don't have local values for it and update them. */ if (XOBJFWD (valcontents)->objvar > (Lisp_Object *) &buffer_defaults && XOBJFWD (valcontents)->objvar < (Lisp_Object *) (&buffer_defaults + 1)) { int offset = ((char *) XOBJFWD (valcontents)->objvar - (char *) &buffer_defaults); int idx = PER_BUFFER_IDX (offset); Lisp_Object tail, buf; if (idx <= 0) break; FOR_EACH_LIVE_BUFFER (tail, buf) { struct buffer *b = XBUFFER (buf); if (! PER_BUFFER_VALUE_P (b, idx)) set_per_buffer_value (b, offset, newval); } } break; case Lisp_Fwd_Buffer_Obj: { int offset = XBUFFER_OBJFWD (valcontents)->offset; Lisp_Object predicate = XBUFFER_OBJFWD (valcontents)->predicate; if (!NILP (newval) && !NILP (predicate)) { eassert (SYMBOLP (predicate)); Lisp_Object choiceprop = Fget (predicate, Qchoice); if (!NILP (choiceprop)) { if (NILP (Fmemq (newval, choiceprop))) wrong_choice (choiceprop, newval); } else { Lisp_Object rangeprop = Fget (predicate, Qrange); if (CONSP (rangeprop)) { Lisp_Object min = XCAR (rangeprop), max = XCDR (rangeprop); if (! NUMBERP (newval) || NILP (CALLN (Fleq, min, newval, max))) wrong_range (min, max, newval); } else if (FUNCTIONP (predicate)) { if (NILP (call1 (predicate, newval))) wrong_type_argument (predicate, newval); } } } if (buf == NULL) buf = current_buffer; set_per_buffer_value (buf, offset, newval); } break; case Lisp_Fwd_Kboard_Obj: { char *base = (char *) FRAME_KBOARD (SELECTED_FRAME ()); char *p = base + XKBOARD_OBJFWD (valcontents)->offset; *(Lisp_Object *) p = newval; } break; default: emacs_abort (); /* goto def; */ } } /* Set up SYMBOL to refer to its global binding. This makes it safe to alter the status of other bindings. BEWARE: this may be called during the mark phase of GC, where we assume that Lisp_Object slots of BLV are marked after this function has changed them. */ void swap_in_global_binding (struct Lisp_Symbol *symbol) { struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (symbol); /* Unload the previously loaded binding. */ if (blv->fwd.fwdptr) set_blv_value (blv, do_symval_forwarding (blv->fwd)); /* Select the global binding in the symbol. */ set_blv_valcell (blv, blv->defcell); if (blv->fwd.fwdptr) store_symval_forwarding (blv->fwd, XCDR (blv->defcell), NULL); /* Indicate that the global binding is set up now. */ set_blv_where (blv, Qnil); set_blv_found (blv, false); } /* Set up the buffer-local symbol SYMBOL for validity in the current buffer. VALCONTENTS is the contents of its value cell, which points to a struct Lisp_Buffer_Local_Value. Return the value forwarded one step past the buffer-local stage. This could be another forwarding pointer. */ static void swap_in_symval_forwarding (struct Lisp_Symbol *symbol, struct Lisp_Buffer_Local_Value *blv) { register Lisp_Object tem1; eassert (blv == SYMBOL_BLV (symbol)); tem1 = blv->where; if (NILP (tem1) || current_buffer != XBUFFER (tem1)) { /* Unload the previously loaded binding. */ tem1 = blv->valcell; if (blv->fwd.fwdptr) set_blv_value (blv, do_symval_forwarding (blv->fwd)); /* Choose the new binding. */ { Lisp_Object var; XSETSYMBOL (var, symbol); tem1 = assq_no_quit (var, BVAR (current_buffer, local_var_alist)); set_blv_where (blv, Fcurrent_buffer ()); } if (!(blv->found = !NILP (tem1))) tem1 = blv->defcell; /* Load the new binding. */ set_blv_valcell (blv, tem1); if (blv->fwd.fwdptr) store_symval_forwarding (blv->fwd, blv_value (blv), NULL); } } /* Find the value of a symbol, returning Qunbound if it's not bound. This is helpful for code which just wants to get a variable's value if it has one, without signaling an error. Note that it must not be possible to quit within this function. Great care is required for this. */ Lisp_Object find_symbol_value (Lisp_Object symbol) { struct Lisp_Symbol *sym; CHECK_SYMBOL (symbol); sym = XSYMBOL (symbol); start: switch (sym->u.s.redirect) { case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_PLAINVAL: return SYMBOL_VAL (sym); case SYMBOL_LOCALIZED: { struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym); swap_in_symval_forwarding (sym, blv); return (blv->fwd.fwdptr ? do_symval_forwarding (blv->fwd) : blv_value (blv)); } case SYMBOL_FORWARDED: return do_symval_forwarding (SYMBOL_FWD (sym)); default: emacs_abort (); } } DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0, doc: /* Return SYMBOL's value. Error if that is void. Note that if `lexical-binding' is in effect, this returns the global value outside of any lexical scope. */) (Lisp_Object symbol) { Lisp_Object val; val = find_symbol_value (symbol); if (!EQ (val, Qunbound)) return val; xsignal1 (Qvoid_variable, symbol); } DEFUN ("set", Fset, Sset, 2, 2, 0, doc: /* Set SYMBOL's value to NEWVAL, and return NEWVAL. */) (register Lisp_Object symbol, Lisp_Object newval) { set_internal (symbol, newval, Qnil, SET_INTERNAL_SET); return newval; } /* Store the value NEWVAL into SYMBOL. If buffer-locality is an issue, WHERE specifies which context to use. (nil stands for the current buffer/frame). If BINDFLAG is SET_INTERNAL_SET, then if this symbol is supposed to become local in every buffer where it is set, then we make it local. If BINDFLAG is SET_INTERNAL_BIND or SET_INTERNAL_UNBIND, we don't do that. */ void set_internal (Lisp_Object symbol, Lisp_Object newval, Lisp_Object where, enum Set_Internal_Bind bindflag) { bool voide = EQ (newval, Qunbound); /* If restoring in a dead buffer, do nothing. */ /* if (BUFFERP (where) && NILP (XBUFFER (where)->name)) return; */ CHECK_SYMBOL (symbol); struct Lisp_Symbol *sym = XSYMBOL (symbol); switch (sym->u.s.trapped_write) { case SYMBOL_NOWRITE: if (NILP (Fkeywordp (symbol)) || !EQ (newval, Fsymbol_value (symbol))) xsignal1 (Qsetting_constant, symbol); else /* Allow setting keywords to their own value. */ return; case SYMBOL_TRAPPED_WRITE: /* Setting due to thread-switching doesn't count. */ if (bindflag != SET_INTERNAL_THREAD_SWITCH) notify_variable_watchers (symbol, voide? Qnil : newval, (bindflag == SET_INTERNAL_BIND? Qlet : bindflag == SET_INTERNAL_UNBIND? Qunlet : voide? Qmakunbound : Qset), where); break; case SYMBOL_UNTRAPPED_WRITE: break; default: emacs_abort (); } start: switch (sym->u.s.redirect) { case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_PLAINVAL: SET_SYMBOL_VAL (sym , newval); return; case SYMBOL_LOCALIZED: { struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym); if (NILP (where)) XSETBUFFER (where, current_buffer); /* If the current buffer is not the buffer whose binding is loaded, or if it's a Lisp_Buffer_Local_Value and the default binding is loaded, the loaded binding may be the wrong one. */ if (!EQ (blv->where, where) /* Also unload a global binding (if the var is local_if_set). */ || (EQ (blv->valcell, blv->defcell))) { /* The currently loaded binding is not necessarily valid. We need to unload it, and choose a new binding. */ /* Write out `realvalue' to the old loaded binding. */ if (blv->fwd.fwdptr) set_blv_value (blv, do_symval_forwarding (blv->fwd)); /* Find the new binding. */ XSETSYMBOL (symbol, sym); /* May have changed via aliasing. */ Lisp_Object tem1 = assq_no_quit (symbol, BVAR (XBUFFER (where), local_var_alist)); set_blv_where (blv, where); blv->found = true; if (NILP (tem1)) { /* This buffer still sees the default value. */ /* If the variable is a Lisp_Some_Buffer_Local_Value, or if this is `let' rather than `set', make CURRENT-ALIST-ELEMENT point to itself, indicating that we're seeing the default value. Likewise if the variable has been let-bound in the current buffer. */ if (bindflag || !blv->local_if_set || let_shadows_buffer_binding_p (sym)) { blv->found = false; tem1 = blv->defcell; } /* If it's a local_if_set, being set not bound, and we're not within a let that was made for this buffer, create a new buffer-local binding for the variable. That means, give this buffer a new assoc for a local value and load that binding. */ else { tem1 = Fcons (symbol, XCDR (blv->defcell)); bset_local_var_alist (XBUFFER (where), Fcons (tem1, BVAR (XBUFFER (where), local_var_alist))); } } /* Record which binding is now loaded. */ set_blv_valcell (blv, tem1); } /* Store the new value in the cons cell. */ set_blv_value (blv, newval); if (blv->fwd.fwdptr) { if (voide) /* If storing void (making the symbol void), forward only through buffer-local indicator, not through Lisp_Objfwd, etc. */ blv->fwd.fwdptr = NULL; else store_symval_forwarding (blv->fwd, newval, BUFFERP (where) ? XBUFFER (where) : current_buffer); } break; } case SYMBOL_FORWARDED: { struct buffer *buf = BUFFERP (where) ? XBUFFER (where) : current_buffer; lispfwd innercontents = SYMBOL_FWD (sym); if (BUFFER_OBJFWDP (innercontents)) { int offset = XBUFFER_OBJFWD (innercontents)->offset; int idx = PER_BUFFER_IDX (offset); if (idx > 0 && bindflag == SET_INTERNAL_SET && !let_shadows_buffer_binding_p (sym)) SET_PER_BUFFER_VALUE_P (buf, idx, 1); } if (voide) { /* If storing void (making the symbol void), forward only through buffer-local indicator, not through Lisp_Objfwd, etc. */ sym->u.s.redirect = SYMBOL_PLAINVAL; SET_SYMBOL_VAL (sym, newval); } else store_symval_forwarding (/* sym, */ innercontents, newval, buf); break; } default: emacs_abort (); } return; } static void set_symbol_trapped_write (Lisp_Object symbol, enum symbol_trapped_write trap) { struct Lisp_Symbol *sym = XSYMBOL (symbol); if (sym->u.s.trapped_write == SYMBOL_NOWRITE) xsignal1 (Qtrapping_constant, symbol); sym->u.s.trapped_write = trap; } static void restore_symbol_trapped_write (Lisp_Object symbol) { set_symbol_trapped_write (symbol, SYMBOL_TRAPPED_WRITE); } static void harmonize_variable_watchers (Lisp_Object alias, Lisp_Object base_variable) { if (!EQ (base_variable, alias) && EQ (base_variable, Findirect_variable (alias))) set_symbol_trapped_write (alias, XSYMBOL (base_variable)->u.s.trapped_write); } DEFUN ("add-variable-watcher", Fadd_variable_watcher, Sadd_variable_watcher, 2, 2, 0, doc: /* Cause WATCH-FUNCTION to be called when SYMBOL is about to be set. It will be called with 4 arguments: (SYMBOL NEWVAL OPERATION WHERE). SYMBOL is the variable being changed. NEWVAL is the value it will be changed to. (The variable still has the old value when WATCH-FUNCTION is called.) OPERATION is a symbol representing the kind of change, one of: `set', `let', `unlet', `makunbound', and `defvaralias'. WHERE is a buffer if the buffer-local value of the variable is being changed, nil otherwise. All writes to aliases of SYMBOL will call WATCH-FUNCTION too. */) (Lisp_Object symbol, Lisp_Object watch_function) { symbol = Findirect_variable (symbol); set_symbol_trapped_write (symbol, SYMBOL_TRAPPED_WRITE); map_obarray (Vobarray, harmonize_variable_watchers, symbol); Lisp_Object watchers = Fget (symbol, Qwatchers); Lisp_Object member = Fmember (watch_function, watchers); if (NILP (member)) Fput (symbol, Qwatchers, Fcons (watch_function, watchers)); return Qnil; } DEFUN ("remove-variable-watcher", Fremove_variable_watcher, Sremove_variable_watcher, 2, 2, 0, doc: /* Undo the effect of `add-variable-watcher'. Remove WATCH-FUNCTION from the list of functions to be called when SYMBOL (or its aliases) are set. */) (Lisp_Object symbol, Lisp_Object watch_function) { symbol = Findirect_variable (symbol); Lisp_Object watchers = Fget (symbol, Qwatchers); watchers = Fdelete (watch_function, watchers); if (NILP (watchers)) { set_symbol_trapped_write (symbol, SYMBOL_UNTRAPPED_WRITE); map_obarray (Vobarray, harmonize_variable_watchers, symbol); } Fput (symbol, Qwatchers, watchers); return Qnil; } DEFUN ("get-variable-watchers", Fget_variable_watchers, Sget_variable_watchers, 1, 1, 0, doc: /* Return a list of SYMBOL's active watchers. */) (Lisp_Object symbol) { return (SYMBOL_TRAPPED_WRITE_P (symbol) == SYMBOL_TRAPPED_WRITE) ? Fget (Findirect_variable (symbol), Qwatchers) : Qnil; } void notify_variable_watchers (Lisp_Object symbol, Lisp_Object newval, Lisp_Object operation, Lisp_Object where) { symbol = Findirect_variable (symbol); ptrdiff_t count = SPECPDL_INDEX (); record_unwind_protect (restore_symbol_trapped_write, symbol); /* Avoid recursion. */ set_symbol_trapped_write (symbol, SYMBOL_UNTRAPPED_WRITE); if (NILP (where) && !EQ (operation, Qset_default) && !EQ (operation, Qmakunbound) && !NILP (Flocal_variable_if_set_p (symbol, Fcurrent_buffer ()))) { XSETBUFFER (where, current_buffer); } if (EQ (operation, Qset_default)) operation = Qset; for (Lisp_Object watchers = Fget (symbol, Qwatchers); CONSP (watchers); watchers = XCDR (watchers)) { Lisp_Object watcher = XCAR (watchers); /* Call subr directly to avoid gc. */ if (SUBRP (watcher)) { Lisp_Object args[] = { symbol, newval, operation, where }; funcall_subr (XSUBR (watcher), ARRAYELTS (args), args); } else CALLN (Ffuncall, watcher, symbol, newval, operation, where); } unbind_to (count, Qnil); } /* Access or set a buffer-local symbol's default value. */ /* Return the default value of SYMBOL, but don't check for voidness. Return Qunbound if it is void. */ Lisp_Object default_value (Lisp_Object symbol) { struct Lisp_Symbol *sym; CHECK_SYMBOL (symbol); sym = XSYMBOL (symbol); start: switch (sym->u.s.redirect) { case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_PLAINVAL: return SYMBOL_VAL (sym); case SYMBOL_LOCALIZED: { /* If var is set up for a buffer that lacks a local value for it, the current value is nominally the default value. But the `realvalue' slot may be more up to date, since ordinary setq stores just that slot. So use that. */ struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym); if (blv->fwd.fwdptr && EQ (blv->valcell, blv->defcell)) return do_symval_forwarding (blv->fwd); else return XCDR (blv->defcell); } case SYMBOL_FORWARDED: { lispfwd valcontents = SYMBOL_FWD (sym); /* For a built-in buffer-local variable, get the default value rather than letting do_symval_forwarding get the current value. */ if (BUFFER_OBJFWDP (valcontents)) { int offset = XBUFFER_OBJFWD (valcontents)->offset; if (PER_BUFFER_IDX (offset) != 0) return per_buffer_default (offset); } /* For other variables, get the current value. */ return do_symval_forwarding (valcontents); } default: emacs_abort (); } } DEFUN ("default-boundp", Fdefault_boundp, Sdefault_boundp, 1, 1, 0, doc: /* Return t if SYMBOL has a non-void default value. This is the value that is seen in buffers that do not have their own values for this variable. */) (Lisp_Object symbol) { register Lisp_Object value; value = default_value (symbol); return (EQ (value, Qunbound) ? Qnil : Qt); } DEFUN ("default-value", Fdefault_value, Sdefault_value, 1, 1, 0, doc: /* Return SYMBOL's default value. This is the value that is seen in buffers that do not have their own values for this variable. The default value is meaningful for variables with local bindings in certain buffers. */) (Lisp_Object symbol) { Lisp_Object value = default_value (symbol); if (!EQ (value, Qunbound)) return value; xsignal1 (Qvoid_variable, symbol); } void set_default_internal (Lisp_Object symbol, Lisp_Object value, enum Set_Internal_Bind bindflag) { CHECK_SYMBOL (symbol); struct Lisp_Symbol *sym = XSYMBOL (symbol); switch (sym->u.s.trapped_write) { case SYMBOL_NOWRITE: if (NILP (Fkeywordp (symbol)) || !EQ (value, Fsymbol_value (symbol))) xsignal1 (Qsetting_constant, symbol); else /* Allow setting keywords to their own value. */ return; case SYMBOL_TRAPPED_WRITE: /* Don't notify here if we're going to call Fset anyway. */ if (sym->u.s.redirect != SYMBOL_PLAINVAL /* Setting due to thread switching doesn't count. */ && bindflag != SET_INTERNAL_THREAD_SWITCH) notify_variable_watchers (symbol, value, Qset_default, Qnil); break; case SYMBOL_UNTRAPPED_WRITE: break; default: emacs_abort (); } start: switch (sym->u.s.redirect) { case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_PLAINVAL: set_internal (symbol, value, Qnil, bindflag); return; case SYMBOL_LOCALIZED: { struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym); /* Store new value into the DEFAULT-VALUE slot. */ XSETCDR (blv->defcell, value); /* If the default binding is now loaded, set the REALVALUE slot too. */ if (blv->fwd.fwdptr && EQ (blv->defcell, blv->valcell)) store_symval_forwarding (blv->fwd, value, NULL); return; } case SYMBOL_FORWARDED: { lispfwd valcontents = SYMBOL_FWD (sym); /* Handle variables like case-fold-search that have special slots in the buffer. Make them work apparently like Lisp_Buffer_Local_Value variables. */ if (BUFFER_OBJFWDP (valcontents)) { int offset = XBUFFER_OBJFWD (valcontents)->offset; int idx = PER_BUFFER_IDX (offset); set_per_buffer_default (offset, value); /* If this variable is not always local in all buffers, set it in the buffers that don't nominally have a local value. */ if (idx > 0) { Lisp_Object buf, tail; /* Do this only in live buffers, so that if there are a lot of buffers which are dead, that doesn't slow down let-binding of variables that are automatically local when set, like case-fold-search. This is for Lisp programs that let-bind such variables in their inner loops. */ FOR_EACH_LIVE_BUFFER (tail, buf) { struct buffer *b = XBUFFER (buf); if (!PER_BUFFER_VALUE_P (b, idx)) set_per_buffer_value (b, offset, value); } } } else set_internal (symbol, value, Qnil, bindflag); return; } default: emacs_abort (); } } DEFUN ("set-default", Fset_default, Sset_default, 2, 2, 0, doc: /* Set SYMBOL's default value to VALUE. SYMBOL and VALUE are evaluated. The default value is seen in buffers that do not have their own values for this variable. */) (Lisp_Object symbol, Lisp_Object value) { set_default_internal (symbol, value, SET_INTERNAL_SET); return value; } /* Lisp functions for creating and removing buffer-local variables. */ union Lisp_Val_Fwd { Lisp_Object value; lispfwd fwd; }; static struct Lisp_Buffer_Local_Value * make_blv (struct Lisp_Symbol *sym, bool forwarded, union Lisp_Val_Fwd valcontents) { struct Lisp_Buffer_Local_Value *blv = xmalloc (sizeof *blv); Lisp_Object symbol; Lisp_Object tem; XSETSYMBOL (symbol, sym); tem = Fcons (symbol, (forwarded ? do_symval_forwarding (valcontents.fwd) : valcontents.value)); /* Buffer_Local_Values cannot have as realval a buffer-local or keyboard-local forwarding. */ eassert (!(forwarded && BUFFER_OBJFWDP (valcontents.fwd))); eassert (!(forwarded && KBOARD_OBJFWDP (valcontents.fwd))); if (forwarded) blv->fwd = valcontents.fwd; else blv->fwd.fwdptr = NULL; set_blv_where (blv, Qnil); blv->local_if_set = 0; set_blv_defcell (blv, tem); set_blv_valcell (blv, tem); set_blv_found (blv, false); return blv; } DEFUN ("make-variable-buffer-local", Fmake_variable_buffer_local, Smake_variable_buffer_local, 1, 1, "vMake Variable Buffer Local: ", doc: /* Make VARIABLE become buffer-local whenever it is set. At any time, the value for the current buffer is in effect, unless the variable has never been set in this buffer, in which case the default value is in effect. Note that binding the variable with `let', or setting it while a `let'-style binding made in this buffer is in effect, does not make the variable buffer-local. Return VARIABLE. This globally affects all uses of this variable, so it belongs together with the variable declaration, rather than with its uses (if you just want to make a variable local to the current buffer for one particular use, use `make-local-variable'). Buffer-local bindings are normally cleared while setting up a new major mode, unless they have a `permanent-local' property. The function `default-value' gets the default value and `set-default' sets it. */) (register Lisp_Object variable) { struct Lisp_Symbol *sym; struct Lisp_Buffer_Local_Value *blv = NULL; union Lisp_Val_Fwd valcontents UNINIT; bool forwarded UNINIT; CHECK_SYMBOL (variable); sym = XSYMBOL (variable); start: switch (sym->u.s.redirect) { case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_PLAINVAL: forwarded = 0; valcontents.value = SYMBOL_VAL (sym); if (EQ (valcontents.value, Qunbound)) valcontents.value = Qnil; break; case SYMBOL_LOCALIZED: blv = SYMBOL_BLV (sym); break; case SYMBOL_FORWARDED: forwarded = 1; valcontents.fwd = SYMBOL_FWD (sym); if (KBOARD_OBJFWDP (valcontents.fwd)) error ("Symbol %s may not be buffer-local", SDATA (SYMBOL_NAME (variable))); else if (BUFFER_OBJFWDP (valcontents.fwd)) return variable; break; default: emacs_abort (); } if (SYMBOL_CONSTANT_P (variable)) xsignal1 (Qsetting_constant, variable); if (!blv) { blv = make_blv (sym, forwarded, valcontents); sym->u.s.redirect = SYMBOL_LOCALIZED; SET_SYMBOL_BLV (sym, blv); } blv->local_if_set = 1; return variable; } DEFUN ("make-local-variable", Fmake_local_variable, Smake_local_variable, 1, 1, "vMake Local Variable: ", doc: /* Make VARIABLE have a separate value in the current buffer. Other buffers will continue to share a common default value. \(The buffer-local value of VARIABLE starts out as the same value VARIABLE previously had. If VARIABLE was void, it remains void.) Return VARIABLE. If the variable is already arranged to become local when set, this function causes a local value to exist for this buffer, just as setting the variable would do. This function returns VARIABLE, and therefore (set (make-local-variable \\='VARIABLE) VALUE-EXP) works. See also `make-variable-buffer-local'. Do not use `make-local-variable' to make a hook variable buffer-local. Instead, use `add-hook' and specify t for the LOCAL argument. */) (Lisp_Object variable) { Lisp_Object tem; bool forwarded UNINIT; union Lisp_Val_Fwd valcontents UNINIT; struct Lisp_Symbol *sym; struct Lisp_Buffer_Local_Value *blv = NULL; CHECK_SYMBOL (variable); sym = XSYMBOL (variable); start: switch (sym->u.s.redirect) { case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_PLAINVAL: forwarded = 0; valcontents.value = SYMBOL_VAL (sym); break; case SYMBOL_LOCALIZED: blv = SYMBOL_BLV (sym); break; case SYMBOL_FORWARDED: forwarded = 1; valcontents.fwd = SYMBOL_FWD (sym); if (KBOARD_OBJFWDP (valcontents.fwd)) error ("Symbol %s may not be buffer-local", SDATA (SYMBOL_NAME (variable))); break; default: emacs_abort (); } if (sym->u.s.trapped_write == SYMBOL_NOWRITE) xsignal1 (Qsetting_constant, variable); if (blv ? blv->local_if_set : (forwarded && BUFFER_OBJFWDP (valcontents.fwd))) { tem = Fboundp (variable); /* Make sure the symbol has a local value in this particular buffer, by setting it to the same value it already has. */ Fset (variable, (EQ (tem, Qt) ? Fsymbol_value (variable) : Qunbound)); return variable; } if (!blv) { blv = make_blv (sym, forwarded, valcontents); sym->u.s.redirect = SYMBOL_LOCALIZED; SET_SYMBOL_BLV (sym, blv); } /* Make sure this buffer has its own value of symbol. */ XSETSYMBOL (variable, sym); /* Update in case of aliasing. */ tem = Fassq (variable, BVAR (current_buffer, local_var_alist)); if (NILP (tem)) { if (let_shadows_buffer_binding_p (sym)) { AUTO_STRING (format, "Making %s buffer-local while locally let-bound!"); CALLN (Fmessage, format, SYMBOL_NAME (variable)); } if (BUFFERP (blv->where) && current_buffer == XBUFFER (blv->where)) /* Make sure the current value is permanently recorded, if it's the default value. */ swap_in_global_binding (sym); bset_local_var_alist (current_buffer, Fcons (Fcons (variable, XCDR (blv->defcell)), BVAR (current_buffer, local_var_alist))); /* If the symbol forwards into a C variable, then load the binding for this buffer now, to preserve the invariant that forwarded variables must always hold the value corresponding to the current buffer (they are swapped eagerly). Otherwise, if C code modifies the variable before we load the binding in, then that new value would clobber the default binding the next time we unload it. See bug#34318. */ if (blv->fwd.fwdptr) swap_in_symval_forwarding (sym, blv); } return variable; } DEFUN ("kill-local-variable", Fkill_local_variable, Skill_local_variable, 1, 1, "vKill Local Variable: ", doc: /* Make VARIABLE no longer have a separate value in the current buffer. From now on the default value will apply in this buffer. Return VARIABLE. */) (register Lisp_Object variable) { register Lisp_Object tem; struct Lisp_Buffer_Local_Value *blv; struct Lisp_Symbol *sym; CHECK_SYMBOL (variable); sym = XSYMBOL (variable); start: switch (sym->u.s.redirect) { case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_PLAINVAL: return variable; case SYMBOL_FORWARDED: { lispfwd valcontents = SYMBOL_FWD (sym); if (BUFFER_OBJFWDP (valcontents)) { int offset = XBUFFER_OBJFWD (valcontents)->offset; int idx = PER_BUFFER_IDX (offset); if (idx > 0) { SET_PER_BUFFER_VALUE_P (current_buffer, idx, 0); set_per_buffer_value (current_buffer, offset, per_buffer_default (offset)); } } return variable; } case SYMBOL_LOCALIZED: blv = SYMBOL_BLV (sym); break; default: emacs_abort (); } if (sym->u.s.trapped_write == SYMBOL_TRAPPED_WRITE) notify_variable_watchers (variable, Qnil, Qmakunbound, Fcurrent_buffer ()); /* Get rid of this buffer's alist element, if any. */ XSETSYMBOL (variable, sym); /* Propagate variable indirection. */ tem = Fassq (variable, BVAR (current_buffer, local_var_alist)); if (!NILP (tem)) bset_local_var_alist (current_buffer, Fdelq (tem, BVAR (current_buffer, local_var_alist))); /* If the symbol is set up with the current buffer's binding loaded, recompute its value. We have to do it now, or else forwarded objects won't work right. */ { Lisp_Object buf; XSETBUFFER (buf, current_buffer); if (EQ (buf, blv->where)) swap_in_global_binding (sym); } return variable; } /* Lisp functions for creating and removing buffer-local variables. */ DEFUN ("local-variable-p", Flocal_variable_p, Slocal_variable_p, 1, 2, 0, doc: /* Non-nil if VARIABLE has a local binding in buffer BUFFER. BUFFER defaults to the current buffer. */) (Lisp_Object variable, Lisp_Object buffer) { struct buffer *buf = decode_buffer (buffer); struct Lisp_Symbol *sym; CHECK_SYMBOL (variable); sym = XSYMBOL (variable); start: switch (sym->u.s.redirect) { case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_PLAINVAL: return Qnil; case SYMBOL_LOCALIZED: { Lisp_Object tail, elt, tmp; struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym); XSETBUFFER (tmp, buf); XSETSYMBOL (variable, sym); /* Update in case of aliasing. */ if (EQ (blv->where, tmp)) /* The binding is already loaded. */ return blv_found (blv) ? Qt : Qnil; else for (tail = BVAR (buf, local_var_alist); CONSP (tail); tail = XCDR (tail)) { elt = XCAR (tail); if (EQ (variable, XCAR (elt))) return Qt; } return Qnil; } case SYMBOL_FORWARDED: { lispfwd valcontents = SYMBOL_FWD (sym); if (BUFFER_OBJFWDP (valcontents)) { int offset = XBUFFER_OBJFWD (valcontents)->offset; int idx = PER_BUFFER_IDX (offset); if (idx == -1 || PER_BUFFER_VALUE_P (buf, idx)) return Qt; } return Qnil; } default: emacs_abort (); } } DEFUN ("local-variable-if-set-p", Flocal_variable_if_set_p, Slocal_variable_if_set_p, 1, 2, 0, doc: /* Non-nil if VARIABLE is local in buffer BUFFER when set there. BUFFER defaults to the current buffer. More precisely, return non-nil if either VARIABLE already has a local value in BUFFER, or if VARIABLE is automatically buffer-local (see `make-variable-buffer-local'). */) (register Lisp_Object variable, Lisp_Object buffer) { struct Lisp_Symbol *sym; CHECK_SYMBOL (variable); sym = XSYMBOL (variable); start: switch (sym->u.s.redirect) { case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_PLAINVAL: return Qnil; case SYMBOL_LOCALIZED: { struct Lisp_Buffer_Local_Value *blv = SYMBOL_BLV (sym); if (blv->local_if_set) return Qt; XSETSYMBOL (variable, sym); /* Update in case of aliasing. */ return Flocal_variable_p (variable, buffer); } case SYMBOL_FORWARDED: /* All BUFFER_OBJFWD slots become local if they are set. */ return (BUFFER_OBJFWDP (SYMBOL_FWD (sym)) ? Qt : Qnil); default: emacs_abort (); } } DEFUN ("variable-binding-locus", Fvariable_binding_locus, Svariable_binding_locus, 1, 1, 0, doc: /* Return a value indicating where VARIABLE's current binding comes from. If the current binding is buffer-local, the value is the current buffer. If the current binding is global (the default), the value is nil. */) (register Lisp_Object variable) { struct Lisp_Symbol *sym; CHECK_SYMBOL (variable); sym = XSYMBOL (variable); /* Make sure the current binding is actually swapped in. */ find_symbol_value (variable); start: switch (sym->u.s.redirect) { case SYMBOL_VARALIAS: sym = indirect_variable (sym); goto start; case SYMBOL_PLAINVAL: return Qnil; case SYMBOL_FORWARDED: { lispfwd valcontents = SYMBOL_FWD (sym); if (KBOARD_OBJFWDP (valcontents)) return Fframe_terminal (selected_frame); else if (!BUFFER_OBJFWDP (valcontents)) return Qnil; } FALLTHROUGH; case SYMBOL_LOCALIZED: /* For a local variable, record both the symbol and which buffer's or frame's value we are saving. */ if (!NILP (Flocal_variable_p (variable, Qnil))) return Fcurrent_buffer (); else if (sym->u.s.redirect == SYMBOL_LOCALIZED && blv_found (SYMBOL_BLV (sym))) return SYMBOL_BLV (sym)->where; else return Qnil; default: emacs_abort (); } } /* Find the function at the end of a chain of symbol function indirections. */ /* If OBJECT is a symbol, find the end of its function chain and return the value found there. If OBJECT is not a symbol, just return it. If there is a cycle in the function chain, signal a cyclic-function-indirection error. This is like Findirect_function, except that it doesn't signal an error if the chain ends up unbound. */ Lisp_Object indirect_function (register Lisp_Object object) { Lisp_Object tortoise, hare; hare = tortoise = object; for (;;) { if (!SYMBOLP (hare) || NILP (hare)) break; hare = XSYMBOL (hare)->u.s.function; if (!SYMBOLP (hare) || NILP (hare)) break; hare = XSYMBOL (hare)->u.s.function; tortoise = XSYMBOL (tortoise)->u.s.function; if (EQ (hare, tortoise)) xsignal1 (Qcyclic_function_indirection, object); } return hare; } DEFUN ("indirect-function", Findirect_function, Sindirect_function, 1, 2, 0, doc: /* Return the function at the end of OBJECT's function chain. If OBJECT is not a symbol, just return it. Otherwise, follow all function indirections to find the final function binding and return it. Signal a cyclic-function-indirection error if there is a loop in the function chain of symbols. */) (register Lisp_Object object, Lisp_Object noerror) { Lisp_Object result; /* Optimize for no indirection. */ result = object; if (SYMBOLP (result) && !NILP (result) && (result = XSYMBOL (result)->u.s.function, SYMBOLP (result))) result = indirect_function (result); if (!NILP (result)) return result; return Qnil; } /* Extract and set vector and string elements. */ DEFUN ("aref", Faref, Saref, 2, 2, 0, doc: /* Return the element of ARRAY at index IDX. ARRAY may be a vector, a string, a char-table, a bool-vector, a record, or a byte-code object. IDX starts at 0. */) (register Lisp_Object array, Lisp_Object idx) { register EMACS_INT idxval; CHECK_FIXNUM (idx); idxval = XFIXNUM (idx); if (STRINGP (array)) { int c; ptrdiff_t idxval_byte; if (idxval < 0 || idxval >= SCHARS (array)) args_out_of_range (array, idx); if (! STRING_MULTIBYTE (array)) return make_fixnum ((unsigned char) SREF (array, idxval)); idxval_byte = string_char_to_byte (array, idxval); c = STRING_CHAR (SDATA (array) + idxval_byte); return make_fixnum (c); } else if (BOOL_VECTOR_P (array)) { if (idxval < 0 || idxval >= bool_vector_size (array)) args_out_of_range (array, idx); return bool_vector_ref (array, idxval); } else if (CHAR_TABLE_P (array)) { CHECK_CHARACTER (idx); return CHAR_TABLE_REF (array, idxval); } else { ptrdiff_t size = 0; if (VECTORP (array)) size = ASIZE (array); else if (COMPILEDP (array) || RECORDP (array)) size = PVSIZE (array); else wrong_type_argument (Qarrayp, array); if (idxval < 0 || idxval >= size) args_out_of_range (array, idx); return AREF (array, idxval); } } DEFUN ("aset", Faset, Saset, 3, 3, 0, doc: /* Store into the element of ARRAY at index IDX the value NEWELT. Return NEWELT. ARRAY may be a vector, a string, a char-table or a bool-vector. IDX starts at 0. */) (register Lisp_Object array, Lisp_Object idx, Lisp_Object newelt) { register EMACS_INT idxval; CHECK_FIXNUM (idx); idxval = XFIXNUM (idx); if (! RECORDP (array)) CHECK_ARRAY (array, Qarrayp); if (VECTORP (array)) { CHECK_IMPURE (array, XVECTOR (array)); if (idxval < 0 || idxval >= ASIZE (array)) args_out_of_range (array, idx); ASET (array, idxval, newelt); } else if (BOOL_VECTOR_P (array)) { if (idxval < 0 || idxval >= bool_vector_size (array)) args_out_of_range (array, idx); bool_vector_set (array, idxval, !NILP (newelt)); } else if (CHAR_TABLE_P (array)) { CHECK_CHARACTER (idx); CHAR_TABLE_SET (array, idxval, newelt); } else if (RECORDP (array)) { if (idxval < 0 || idxval >= PVSIZE (array)) args_out_of_range (array, idx); ASET (array, idxval, newelt); } else /* STRINGP */ { CHECK_IMPURE (array, XSTRING (array)); if (idxval < 0 || idxval >= SCHARS (array)) args_out_of_range (array, idx); CHECK_CHARACTER (newelt); int c = XFIXNAT (newelt); ptrdiff_t idxval_byte; int prev_bytes; unsigned char workbuf[MAX_MULTIBYTE_LENGTH], *p0 = workbuf, *p1; if (STRING_MULTIBYTE (array)) { idxval_byte = string_char_to_byte (array, idxval); p1 = SDATA (array) + idxval_byte; prev_bytes = BYTES_BY_CHAR_HEAD (*p1); } else if (SINGLE_BYTE_CHAR_P (c)) { SSET (array, idxval, c); return newelt; } else { for (ptrdiff_t i = SBYTES (array) - 1; i >= 0; i--) if (!ASCII_CHAR_P (SREF (array, i))) args_out_of_range (array, newelt); /* ARRAY is an ASCII string. Convert it to a multibyte string. */ STRING_SET_MULTIBYTE (array); idxval_byte = idxval; p1 = SDATA (array) + idxval_byte; prev_bytes = 1; } int new_bytes = CHAR_STRING (c, p0); if (prev_bytes != new_bytes) p1 = resize_string_data (array, idxval_byte, prev_bytes, new_bytes); do *p1++ = *p0++; while (--new_bytes != 0); } return newelt; } /* Arithmetic functions */ static Lisp_Object check_integer_coerce_marker (Lisp_Object x) { if (MARKERP (x)) return make_fixnum (marker_position (x)); CHECK_TYPE (INTEGERP (x), Qinteger_or_marker_p, x); return x; } static Lisp_Object check_number_coerce_marker (Lisp_Object x) { if (MARKERP (x)) return make_fixnum (marker_position (x)); CHECK_TYPE (NUMBERP (x), Qnumber_or_marker_p, x); return x; } Lisp_Object arithcompare (Lisp_Object num1, Lisp_Object num2, enum Arith_Comparison comparison) { EMACS_INT i1 = 0, i2 = 0; bool lt, eq = true, gt; bool test; num1 = check_number_coerce_marker (num1); num2 = check_number_coerce_marker (num2); /* If the comparison is mostly done by comparing two doubles, set LT, EQ, and GT to the <, ==, > results of that comparison, respectively, taking care to avoid problems if either is a NaN, and trying to avoid problems on platforms where variables (in violation of the C standard) can contain excess precision. Regardless, set I1 and I2 to integers that break ties if the two-double comparison is either not done or reports equality. */ if (FLOATP (num1)) { double f1 = XFLOAT_DATA (num1); if (FLOATP (num2)) { double f2 = XFLOAT_DATA (num2); lt = f1 < f2; eq = f1 == f2; gt = f1 > f2; } else if (FIXNUMP (num2)) { /* Compare a float NUM1 to an integer NUM2 by converting the integer I2 (i.e., NUM2) to the double F2 (a conversion that can round on some platforms, if I2 is large enough), and then converting F2 back to the integer I1 (a conversion that is always exact), so that I1 exactly equals ((double) NUM2). If floating-point comparison reports a tie, NUM1 = F1 = F2 = I1 (exactly) so I1 - I2 = NUM1 - NUM2 (exactly), so comparing I1 to I2 will break the tie correctly. */ double f2 = XFIXNUM (num2); lt = f1 < f2; eq = f1 == f2; gt = f1 > f2; i1 = f2; i2 = XFIXNUM (num2); } else if (isnan (f1)) lt = eq = gt = false; else i2 = mpz_cmp_d (*xbignum_val (num2), f1); } else if (FIXNUMP (num1)) { if (FLOATP (num2)) { /* Compare an integer NUM1 to a float NUM2. This is the converse of comparing float to integer (see above). */ double f1 = XFIXNUM (num1), f2 = XFLOAT_DATA (num2); lt = f1 < f2; eq = f1 == f2; gt = f1 > f2; i1 = XFIXNUM (num1); i2 = f1; } else if (FIXNUMP (num2)) { i1 = XFIXNUM (num1); i2 = XFIXNUM (num2); } else i2 = mpz_sgn (*xbignum_val (num2)); } else if (FLOATP (num2)) { double f2 = XFLOAT_DATA (num2); if (isnan (f2)) lt = eq = gt = false; else i1 = mpz_cmp_d (*xbignum_val (num1), f2); } else if (FIXNUMP (num2)) i1 = mpz_sgn (*xbignum_val (num1)); else i1 = mpz_cmp (*xbignum_val (num1), *xbignum_val (num2)); if (eq) { /* The two-double comparison either reported equality, or was not done. Break the tie by comparing the integers. */ lt = i1 < i2; eq = i1 == i2; gt = i1 > i2; } switch (comparison) { case ARITH_EQUAL: test = eq; break; case ARITH_NOTEQUAL: test = !eq; break; case ARITH_LESS: test = lt; break; case ARITH_LESS_OR_EQUAL: test = lt | eq; break; case ARITH_GRTR: test = gt; break; case ARITH_GRTR_OR_EQUAL: test = gt | eq; break; default: eassume (false); } return test ? Qt : Qnil; } static Lisp_Object arithcompare_driver (ptrdiff_t nargs, Lisp_Object *args, enum Arith_Comparison comparison) { for (ptrdiff_t i = 1; i < nargs; i++) if (NILP (arithcompare (args[i - 1], args[i], comparison))) return Qnil; return Qt; } DEFUN ("=", Feqlsign, Seqlsign, 1, MANY, 0, doc: /* Return t if args, all numbers or markers, are equal. usage: (= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { return arithcompare_driver (nargs, args, ARITH_EQUAL); } DEFUN ("<", Flss, Slss, 1, MANY, 0, doc: /* Return t if each arg (a number or marker), is less than the next arg. usage: (< NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { return arithcompare_driver (nargs, args, ARITH_LESS); } DEFUN (">", Fgtr, Sgtr, 1, MANY, 0, doc: /* Return t if each arg (a number or marker) is greater than the next arg. usage: (> NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { return arithcompare_driver (nargs, args, ARITH_GRTR); } DEFUN ("<=", Fleq, Sleq, 1, MANY, 0, doc: /* Return t if each arg (a number or marker) is less than or equal to the next. usage: (<= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { return arithcompare_driver (nargs, args, ARITH_LESS_OR_EQUAL); } DEFUN (">=", Fgeq, Sgeq, 1, MANY, 0, doc: /* Return t if each arg (a number or marker) is greater than or equal to the next. usage: (>= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { return arithcompare_driver (nargs, args, ARITH_GRTR_OR_EQUAL); } DEFUN ("/=", Fneq, Sneq, 2, 2, 0, doc: /* Return t if first arg is not equal to second arg. Both must be numbers or markers. */) (register Lisp_Object num1, Lisp_Object num2) { return arithcompare (num1, num2, ARITH_NOTEQUAL); } /* Convert the cons-of-integers, integer, or float value C to an unsigned value with maximum value MAX, where MAX is one less than a power of 2. Signal an error if C does not have a valid format or is out of range. Although Emacs represents large integers with bignums instead of cons-of-integers or floats, for now this function still accepts the obsolete forms in case some old Lisp code still generates them. */ uintmax_t cons_to_unsigned (Lisp_Object c, uintmax_t max) { bool valid = false; uintmax_t val UNINIT; if (FLOATP (c)) { double d = XFLOAT_DATA (c); if (d >= 0 && d < 1.0 + max) { val = d; valid = val == d; } } else { Lisp_Object hi = CONSP (c) ? XCAR (c) : c; valid = INTEGERP (hi) && integer_to_uintmax (hi, &val); if (valid && CONSP (c)) { uintmax_t top = val; Lisp_Object rest = XCDR (c); if (top <= UINTMAX_MAX >> 24 >> 16 && CONSP (rest) && FIXNATP (XCAR (rest)) && XFIXNAT (XCAR (rest)) < 1 << 24 && FIXNATP (XCDR (rest)) && XFIXNAT (XCDR (rest)) < 1 << 16) { uintmax_t mid = XFIXNAT (XCAR (rest)); val = top << 24 << 16 | mid << 16 | XFIXNAT (XCDR (rest)); } else { valid = top <= UINTMAX_MAX >> 16; if (valid) { if (CONSP (rest)) rest = XCAR (rest); valid = FIXNATP (rest) && XFIXNAT (rest) < 1 << 16; if (valid) val = top << 16 | XFIXNAT (rest); } } } } if (! (valid && val <= max)) error ("Not an in-range integer, integral float, or cons of integers"); return val; } /* Convert the cons-of-integers, integer, or float value C to a signed value with extrema MIN and MAX. MAX should be one less than a power of 2, and MIN should be zero or the negative of a power of 2. Signal an error if C does not have a valid format or is out of range. Although Emacs represents large integers with bignums instead of cons-of-integers or floats, for now this function still accepts the obsolete forms in case some old Lisp code still generates them. */ intmax_t cons_to_signed (Lisp_Object c, intmax_t min, intmax_t max) { bool valid = false; intmax_t val UNINIT; if (FLOATP (c)) { double d = XFLOAT_DATA (c); if (d >= min && d < 1.0 + max) { val = d; valid = val == d; } } else { Lisp_Object hi = CONSP (c) ? XCAR (c) : c; valid = INTEGERP (hi) && integer_to_intmax (hi, &val); if (valid && CONSP (c)) { intmax_t top = val; Lisp_Object rest = XCDR (c); if (top >= INTMAX_MIN >> 24 >> 16 && top <= INTMAX_MAX >> 24 >> 16 && CONSP (rest) && FIXNATP (XCAR (rest)) && XFIXNAT (XCAR (rest)) < 1 << 24 && FIXNATP (XCDR (rest)) && XFIXNAT (XCDR (rest)) < 1 << 16) { intmax_t mid = XFIXNAT (XCAR (rest)); val = top << 24 << 16 | mid << 16 | XFIXNAT (XCDR (rest)); } else { valid = INTMAX_MIN >> 16 <= top && top <= INTMAX_MAX >> 16; if (valid) { if (CONSP (rest)) rest = XCAR (rest); valid = FIXNATP (rest) && XFIXNAT (rest) < 1 << 16; if (valid) val = top << 16 | XFIXNAT (rest); } } } } if (! (valid && min <= val && val <= max)) error ("Not an in-range integer, integral float, or cons of integers"); return val; } DEFUN ("number-to-string", Fnumber_to_string, Snumber_to_string, 1, 1, 0, doc: /* Return the decimal representation of NUMBER as a string. Uses a minus sign if negative. NUMBER may be an integer or a floating point number. */) (Lisp_Object number) { char buffer[max (FLOAT_TO_STRING_BUFSIZE, INT_BUFSIZE_BOUND (EMACS_INT))]; int len; CHECK_NUMBER (number); if (BIGNUMP (number)) return bignum_to_string (number, 10); if (FLOATP (number)) len = float_to_string (buffer, XFLOAT_DATA (number)); else len = sprintf (buffer, "%"pI"d", XFIXNUM (number)); return make_unibyte_string (buffer, len); } DEFUN ("string-to-number", Fstring_to_number, Sstring_to_number, 1, 2, 0, doc: /* Parse STRING as a decimal number and return the number. Ignore leading spaces and tabs, and all trailing chars. Return 0 if STRING cannot be parsed as an integer or floating point number. If BASE, interpret STRING as a number in that base. If BASE isn't present, base 10 is used. BASE must be between 2 and 16 (inclusive). If the base used is not 10, STRING is always parsed as an integer. */) (register Lisp_Object string, Lisp_Object base) { int b; CHECK_STRING (string); if (NILP (base)) b = 10; else { CHECK_FIXNUM (base); if (! (XFIXNUM (base) >= 2 && XFIXNUM (base) <= 16)) xsignal1 (Qargs_out_of_range, base); b = XFIXNUM (base); } char *p = SSDATA (string); while (*p == ' ' || *p == '\t') p++; Lisp_Object val = string_to_number (p, b, 0); return NILP (val) ? make_fixnum (0) : val; } enum arithop { Aadd, Asub, Amult, Adiv, Alogand, Alogior, Alogxor }; static bool floating_point_op (enum arithop code) { return code <= Adiv; } /* Return the result of applying the floating-point operation CODE to the NARGS arguments starting at ARGS. If ARGNUM is positive, ARGNUM of the arguments were already consumed, yielding ACCUM. 0 <= ARGNUM < NARGS, 2 <= NARGS, and NEXT is the value of ARGS[ARGSNUM], converted to double. */ static Lisp_Object floatop_arith_driver (enum arithop code, ptrdiff_t nargs, Lisp_Object *args, ptrdiff_t argnum, double accum, double next) { if (argnum == 0) { accum = next; goto next_arg; } while (true) { switch (code) { case Aadd : accum += next; break; case Asub : accum -= next; break; case Amult: accum *= next; break; case Adiv: if (! IEEE_FLOATING_POINT && next == 0) xsignal0 (Qarith_error); accum /= next; break; default: eassume (false); } next_arg: argnum++; if (argnum == nargs) return make_float (accum); next = XFLOATINT (check_number_coerce_marker (args[argnum])); } } /* Like floatop_arith_driver, except CODE might not be a floating-point operation, and NEXT is a Lisp float rather than a C double. */ static Lisp_Object float_arith_driver (enum arithop code, ptrdiff_t nargs, Lisp_Object *args, ptrdiff_t argnum, double accum, Lisp_Object next) { if (! floating_point_op (code)) wrong_type_argument (Qinteger_or_marker_p, next); return floatop_arith_driver (code, nargs, args, argnum, accum, XFLOAT_DATA (next)); } /* Return the result of applying the arithmetic operation CODE to the NARGS arguments starting at ARGS. If ARGNUM is positive, ARGNUM of the arguments were already consumed, yielding IACCUM. 0 <= ARGNUM < NARGS, 2 <= NARGS, and VAL is the value of ARGS[ARGSNUM], converted to integer. */ static Lisp_Object bignum_arith_driver (enum arithop code, ptrdiff_t nargs, Lisp_Object *args, ptrdiff_t argnum, intmax_t iaccum, Lisp_Object val) { mpz_t const *accum; if (argnum == 0) { accum = bignum_integer (&mpz[0], val); goto next_arg; } mpz_set_intmax (mpz[0], iaccum); accum = &mpz[0]; while (true) { mpz_t const *next = bignum_integer (&mpz[1], val); switch (code) { case Aadd : mpz_add (mpz[0], *accum, *next); break; case Asub : mpz_sub (mpz[0], *accum, *next); break; case Amult : emacs_mpz_mul (mpz[0], *accum, *next); break; case Alogand: mpz_and (mpz[0], *accum, *next); break; case Alogior: mpz_ior (mpz[0], *accum, *next); break; case Alogxor: mpz_xor (mpz[0], *accum, *next); break; case Adiv: if (mpz_sgn (*next) == 0) xsignal0 (Qarith_error); mpz_tdiv_q (mpz[0], *accum, *next); break; default: eassume (false); } accum = &mpz[0]; next_arg: argnum++; if (argnum == nargs) return make_integer_mpz (); val = check_number_coerce_marker (args[argnum]); if (FLOATP (val)) return float_arith_driver (code, nargs, args, argnum, mpz_get_d_rounded (*accum), val); } } /* Return the result of applying the arithmetic operation CODE to the NARGS arguments starting at ARGS, with the first argument being the number VAL. 2 <= NARGS. Check that the remaining arguments are numbers or markers. */ static Lisp_Object arith_driver (enum arithop code, ptrdiff_t nargs, Lisp_Object *args, Lisp_Object val) { eassume (2 <= nargs); ptrdiff_t argnum = 0; /* Set ACCUM to VAL's value if it is a fixnum, otherwise to some ignored value to avoid using an uninitialized variable later. */ intmax_t accum = XFIXNUM_RAW (val); if (FIXNUMP (val)) while (true) { argnum++; if (argnum == nargs) return make_int (accum); val = check_number_coerce_marker (args[argnum]); /* Set NEXT to the next value if it fits, else exit the loop. */ intmax_t next; if (! (INTEGERP (val) && integer_to_intmax (val, &next))) break; /* Set ACCUM to the next operation's result if it fits, else exit the loop. */ bool overflow; intmax_t a; switch (code) { case Aadd : overflow = INT_ADD_WRAPV (accum, next, &a); break; case Amult: overflow = INT_MULTIPLY_WRAPV (accum, next, &a); break; case Asub : overflow = INT_SUBTRACT_WRAPV (accum, next, &a); break; case Adiv: if (next == 0) xsignal0 (Qarith_error); /* This cannot overflow, as integer overflow can occur only if the dividend is INTMAX_MIN, but INTMAX_MIN < MOST_NEGATIVE_FIXNUM <= accum. */ accum /= next; continue; case Alogand: accum &= next; continue; case Alogior: accum |= next; continue; case Alogxor: accum ^= next; continue; default: eassume (false); } if (overflow) break; accum = a; } return (FLOATP (val) ? float_arith_driver (code, nargs, args, argnum, accum, val) : bignum_arith_driver (code, nargs, args, argnum, accum, val)); } DEFUN ("+", Fplus, Splus, 0, MANY, 0, doc: /* Return sum of any number of arguments, which are numbers or markers. usage: (+ &rest NUMBERS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { if (nargs == 0) return make_fixnum (0); Lisp_Object a = check_number_coerce_marker (args[0]); return nargs == 1 ? a : arith_driver (Aadd, nargs, args, a); } DEFUN ("-", Fminus, Sminus, 0, MANY, 0, doc: /* Negate number or subtract numbers or markers and return the result. With one arg, negates it. With more than one arg, subtracts all but the first from the first. usage: (- &optional NUMBER-OR-MARKER &rest MORE-NUMBERS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { if (nargs == 0) return make_fixnum (0); Lisp_Object a = check_number_coerce_marker (args[0]); if (nargs == 1) { if (FIXNUMP (a)) return make_int (-XFIXNUM (a)); if (FLOATP (a)) return make_float (-XFLOAT_DATA (a)); mpz_neg (mpz[0], *xbignum_val (a)); return make_integer_mpz (); } return arith_driver (Asub, nargs, args, a); } DEFUN ("*", Ftimes, Stimes, 0, MANY, 0, doc: /* Return product of any number of arguments, which are numbers or markers. usage: (* &rest NUMBERS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { if (nargs == 0) return make_fixnum (1); Lisp_Object a = check_number_coerce_marker (args[0]); return nargs == 1 ? a : arith_driver (Amult, nargs, args, a); } DEFUN ("/", Fquo, Squo, 1, MANY, 0, doc: /* Divide number by divisors and return the result. With two or more arguments, return first argument divided by the rest. With one argument, return 1 divided by the argument. The arguments must be numbers or markers. usage: (/ NUMBER &rest DIVISORS) */) (ptrdiff_t nargs, Lisp_Object *args) { Lisp_Object a = check_number_coerce_marker (args[0]); if (nargs == 1) { if (FIXNUMP (a)) { if (XFIXNUM (a) == 0) xsignal0 (Qarith_error); return make_fixnum (1 / XFIXNUM (a)); } if (FLOATP (a)) { if (! IEEE_FLOATING_POINT && XFLOAT_DATA (a) == 0) xsignal0 (Qarith_error); return make_float (1 / XFLOAT_DATA (a)); } /* Dividing 1 by any bignum yields 0. */ return make_fixnum (0); } /* Do all computation in floating-point if any arg is a float. */ for (ptrdiff_t argnum = 2; argnum < nargs; argnum++) if (FLOATP (args[argnum])) return floatop_arith_driver (Adiv, nargs, args, 0, 0, XFLOATINT (a)); return arith_driver (Adiv, nargs, args, a); } /* Return NUM % DEN (or NUM mod DEN, if MODULO). NUM and DEN must be integers. */ static Lisp_Object integer_remainder (Lisp_Object num, Lisp_Object den, bool modulo) { if (FIXNUMP (den)) { EMACS_INT d = XFIXNUM (den); if (d == 0) xsignal0 (Qarith_error); EMACS_INT r; bool have_r = false; if (FIXNUMP (num)) { r = XFIXNUM (num) % d; have_r = true; } else if (eabs (d) <= ULONG_MAX) { mpz_t const *n = xbignum_val (num); bool neg_n = mpz_sgn (*n) < 0; r = mpz_tdiv_ui (*n, eabs (d)); if (neg_n) r = -r; have_r = true; } if (have_r) { /* If MODULO and the remainder has the wrong sign, fix it. */ if (modulo && (d < 0 ? r > 0 : r < 0)) r += d; return make_fixnum (r); } } mpz_t const *d = bignum_integer (&mpz[1], den); mpz_t *r = &mpz[0]; mpz_tdiv_r (*r, *bignum_integer (&mpz[0], num), *d); if (modulo) { /* If the remainder has the wrong sign, fix it. */ int sgn_r = mpz_sgn (*r); if (mpz_sgn (*d) < 0 ? sgn_r > 0 : sgn_r < 0) mpz_add (*r, *r, *d); } return make_integer_mpz (); } DEFUN ("%", Frem, Srem, 2, 2, 0, doc: /* Return remainder of X divided by Y. Both must be integers or markers. */) (Lisp_Object x, Lisp_Object y) { x = check_integer_coerce_marker (x); y = check_integer_coerce_marker (y); return integer_remainder (x, y, false); } DEFUN ("mod", Fmod, Smod, 2, 2, 0, doc: /* Return X modulo Y. The result falls between zero (inclusive) and Y (exclusive). Both X and Y must be numbers or markers. */) (Lisp_Object x, Lisp_Object y) { x = check_number_coerce_marker (x); y = check_number_coerce_marker (y); if (FLOATP (x) || FLOATP (y)) return fmod_float (x, y); return integer_remainder (x, y, true); } static Lisp_Object minmax_driver (ptrdiff_t nargs, Lisp_Object *args, enum Arith_Comparison comparison) { Lisp_Object accum = check_number_coerce_marker (args[0]); for (ptrdiff_t argnum = 1; argnum < nargs; argnum++) { Lisp_Object val = check_number_coerce_marker (args[argnum]); if (!NILP (arithcompare (val, accum, comparison))) accum = val; else if (FLOATP (val) && isnan (XFLOAT_DATA (val))) return val; } return accum; } DEFUN ("max", Fmax, Smax, 1, MANY, 0, doc: /* Return largest of all the arguments (which must be numbers or markers). The value is always a number; markers are converted to numbers. usage: (max NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { return minmax_driver (nargs, args, ARITH_GRTR); } DEFUN ("min", Fmin, Smin, 1, MANY, 0, doc: /* Return smallest of all the arguments (which must be numbers or markers). The value is always a number; markers are converted to numbers. usage: (min NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { return minmax_driver (nargs, args, ARITH_LESS); } DEFUN ("logand", Flogand, Slogand, 0, MANY, 0, doc: /* Return bitwise-and of all the arguments. Arguments may be integers, or markers converted to integers. usage: (logand &rest INTS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { if (nargs == 0) return make_fixnum (-1); Lisp_Object a = check_integer_coerce_marker (args[0]); return nargs == 1 ? a : arith_driver (Alogand, nargs, args, a); } DEFUN ("logior", Flogior, Slogior, 0, MANY, 0, doc: /* Return bitwise-or of all the arguments. Arguments may be integers, or markers converted to integers. usage: (logior &rest INTS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { if (nargs == 0) return make_fixnum (0); Lisp_Object a = check_integer_coerce_marker (args[0]); return nargs == 1 ? a : arith_driver (Alogior, nargs, args, a); } DEFUN ("logxor", Flogxor, Slogxor, 0, MANY, 0, doc: /* Return bitwise-exclusive-or of all the arguments. Arguments may be integers, or markers converted to integers. usage: (logxor &rest INTS-OR-MARKERS) */) (ptrdiff_t nargs, Lisp_Object *args) { if (nargs == 0) return make_fixnum (0); Lisp_Object a = check_integer_coerce_marker (args[0]); return nargs == 1 ? a : arith_driver (Alogxor, nargs, args, a); } DEFUN ("logcount", Flogcount, Slogcount, 1, 1, 0, doc: /* Return population count of VALUE. This is the number of one bits in the two's complement representation of VALUE. If VALUE is negative, return the number of zero bits in the representation. */) (Lisp_Object value) { CHECK_INTEGER (value); if (BIGNUMP (value)) { mpz_t const *nonneg = xbignum_val (value); if (mpz_sgn (*nonneg) < 0) { mpz_com (mpz[0], *nonneg); nonneg = &mpz[0]; } return make_fixnum (mpz_popcount (*nonneg)); } eassume (FIXNUMP (value)); EMACS_INT v = XFIXNUM (value) < 0 ? -1 - XFIXNUM (value) : XFIXNUM (value); return make_fixnum (EMACS_UINT_WIDTH <= UINT_WIDTH ? count_one_bits (v) : EMACS_UINT_WIDTH <= ULONG_WIDTH ? count_one_bits_l (v) : count_one_bits_ll (v)); } DEFUN ("ash", Fash, Sash, 2, 2, 0, doc: /* Return VALUE with its bits shifted left by COUNT. If COUNT is negative, shifting is actually to the right. In this case, the sign bit is duplicated. */) (Lisp_Object value, Lisp_Object count) { CHECK_INTEGER (value); CHECK_INTEGER (count); if (! FIXNUMP (count)) { if (EQ (value, make_fixnum (0))) return value; if (mpz_sgn (*xbignum_val (count)) < 0) { EMACS_INT v = (FIXNUMP (value) ? XFIXNUM (value) : mpz_sgn (*xbignum_val (value))); return make_fixnum (v < 0 ? -1 : 0); } overflow_error (); } if (XFIXNUM (count) <= 0) { if (XFIXNUM (count) == 0) return value; if ((EMACS_INT) -1 >> 1 == -1 && FIXNUMP (value)) { EMACS_INT shift = -XFIXNUM (count); EMACS_INT result = (shift < EMACS_INT_WIDTH ? XFIXNUM (value) >> shift : XFIXNUM (value) < 0 ? -1 : 0); return make_fixnum (result); } } mpz_t const *zval = bignum_integer (&mpz[0], value); if (XFIXNUM (count) < 0) { if (TYPE_MAXIMUM (mp_bitcnt_t) < - XFIXNUM (count)) return make_fixnum (mpz_sgn (*zval) < 0 ? -1 : 0); mpz_fdiv_q_2exp (mpz[0], *zval, - XFIXNUM (count)); } else emacs_mpz_mul_2exp (mpz[0], *zval, XFIXNUM (count)); return make_integer_mpz (); } /* Return X ** Y as an integer. X and Y must be integers, and Y must be nonnegative. */ Lisp_Object expt_integer (Lisp_Object x, Lisp_Object y) { /* Special cases for -1 <= x <= 1, which never overflow. */ if (EQ (x, make_fixnum (1))) return x; if (EQ (x, make_fixnum (0))) return EQ (x, y) ? make_fixnum (1) : x; if (EQ (x, make_fixnum (-1))) return ((FIXNUMP (y) ? XFIXNUM (y) & 1 : mpz_odd_p (*xbignum_val (y))) ? x : make_fixnum (1)); unsigned long exp; if (FIXNUMP (y)) { if (ULONG_MAX < XFIXNUM (y)) overflow_error (); exp = XFIXNUM (y); } else { if (ULONG_MAX <= MOST_POSITIVE_FIXNUM || !mpz_fits_ulong_p (*xbignum_val (y))) overflow_error (); exp = mpz_get_ui (*xbignum_val (y)); } emacs_mpz_pow_ui (mpz[0], *bignum_integer (&mpz[0], x), exp); return make_integer_mpz (); } DEFUN ("1+", Fadd1, Sadd1, 1, 1, 0, doc: /* Return NUMBER plus one. NUMBER may be a number or a marker. Markers are converted to integers. */) (Lisp_Object number) { number = check_number_coerce_marker (number); if (FIXNUMP (number)) return make_int (XFIXNUM (number) + 1); if (FLOATP (number)) return (make_float (1.0 + XFLOAT_DATA (number))); mpz_add_ui (mpz[0], *xbignum_val (number), 1); return make_integer_mpz (); } DEFUN ("1-", Fsub1, Ssub1, 1, 1, 0, doc: /* Return NUMBER minus one. NUMBER may be a number or a marker. Markers are converted to integers. */) (Lisp_Object number) { number = check_number_coerce_marker (number); if (FIXNUMP (number)) return make_int (XFIXNUM (number) - 1); if (FLOATP (number)) return (make_float (-1.0 + XFLOAT_DATA (number))); mpz_sub_ui (mpz[0], *xbignum_val (number), 1); return make_integer_mpz (); } DEFUN ("lognot", Flognot, Slognot, 1, 1, 0, doc: /* Return the bitwise complement of NUMBER. NUMBER must be an integer. */) (register Lisp_Object number) { CHECK_INTEGER (number); if (FIXNUMP (number)) return make_fixnum (~XFIXNUM (number)); mpz_com (mpz[0], *xbignum_val (number)); return make_integer_mpz (); } DEFUN ("byteorder", Fbyteorder, Sbyteorder, 0, 0, 0, doc: /* Return the byteorder for the machine. Returns 66 (ASCII uppercase B) for big endian machines or 108 (ASCII lowercase l) for small endian machines. */ attributes: const) (void) { unsigned i = 0x04030201; int order = *(char *)&i == 1 ? 108 : 66; return make_fixnum (order); } /* Because we round up the bool vector allocate size to word_size units, we can safely read past the "end" of the vector in the operations below. These extra bits are always zero. */ static bits_word bool_vector_spare_mask (EMACS_INT nr_bits) { return (((bits_word) 1) << (nr_bits % BITS_PER_BITS_WORD)) - 1; } /* Shift VAL right by the width of an unsigned long long. ULLONG_WIDTH must be less than BITS_PER_BITS_WORD. */ static bits_word shift_right_ull (bits_word w) { /* Pacify bogus GCC warning about shift count exceeding type width. */ int shift = ULLONG_WIDTH - BITS_PER_BITS_WORD < 0 ? ULLONG_WIDTH : 0; return w >> shift; } /* Return the number of 1 bits in W. */ static int count_one_bits_word (bits_word w) { if (BITS_WORD_MAX <= UINT_MAX) return count_one_bits (w); else if (BITS_WORD_MAX <= ULONG_MAX) return count_one_bits_l (w); else { int i = 0, count = 0; while (count += count_one_bits_ll (w), (i += ULLONG_WIDTH) < BITS_PER_BITS_WORD) w = shift_right_ull (w); return count; } } enum bool_vector_op { bool_vector_exclusive_or, bool_vector_union, bool_vector_intersection, bool_vector_set_difference, bool_vector_subsetp }; static Lisp_Object bool_vector_binop_driver (Lisp_Object a, Lisp_Object b, Lisp_Object dest, enum bool_vector_op op) { EMACS_INT nr_bits; bits_word *adata, *bdata, *destdata; ptrdiff_t i = 0; ptrdiff_t nr_words; CHECK_BOOL_VECTOR (a); CHECK_BOOL_VECTOR (b); nr_bits = bool_vector_size (a); if (bool_vector_size (b) != nr_bits) wrong_length_argument (a, b, dest); nr_words = bool_vector_words (nr_bits); adata = bool_vector_data (a); bdata = bool_vector_data (b); if (NILP (dest)) { dest = make_uninit_bool_vector (nr_bits); destdata = bool_vector_data (dest); } else { CHECK_BOOL_VECTOR (dest); destdata = bool_vector_data (dest); if (bool_vector_size (dest) != nr_bits) wrong_length_argument (a, b, dest); switch (op) { case bool_vector_exclusive_or: for (; i < nr_words; i++) if (destdata[i] != (adata[i] ^ bdata[i])) goto set_dest; break; case bool_vector_subsetp: for (; i < nr_words; i++) if (adata[i] &~ bdata[i]) return Qnil; return Qt; case bool_vector_union: for (; i < nr_words; i++) if (destdata[i] != (adata[i] | bdata[i])) goto set_dest; break; case bool_vector_intersection: for (; i < nr_words; i++) if (destdata[i] != (adata[i] & bdata[i])) goto set_dest; break; case bool_vector_set_difference: for (; i < nr_words; i++) if (destdata[i] != (adata[i] &~ bdata[i])) goto set_dest; break; } return Qnil; } set_dest: switch (op) { case bool_vector_exclusive_or: for (; i < nr_words; i++) destdata[i] = adata[i] ^ bdata[i]; break; case bool_vector_union: for (; i < nr_words; i++) destdata[i] = adata[i] | bdata[i]; break; case bool_vector_intersection: for (; i < nr_words; i++) destdata[i] = adata[i] & bdata[i]; break; case bool_vector_set_difference: for (; i < nr_words; i++) destdata[i] = adata[i] &~ bdata[i]; break; default: eassume (0); } return dest; } /* PRECONDITION must be true. Return VALUE. This odd construction works around a bogus GCC diagnostic "shift count >= width of type". */ static int pre_value (bool precondition, int value) { eassume (precondition); return precondition ? value : 0; } /* Compute the number of trailing zero bits in val. If val is zero, return the number of bits in val. */ static int count_trailing_zero_bits (bits_word val) { if (BITS_WORD_MAX == UINT_MAX) return count_trailing_zeros (val); if (BITS_WORD_MAX == ULONG_MAX) return count_trailing_zeros_l (val); if (BITS_WORD_MAX == ULLONG_MAX) return count_trailing_zeros_ll (val); /* The rest of this code is for the unlikely platform where bits_word differs in width from unsigned int, unsigned long, and unsigned long long. */ val |= ~ BITS_WORD_MAX; if (BITS_WORD_MAX <= UINT_MAX) return count_trailing_zeros (val); if (BITS_WORD_MAX <= ULONG_MAX) return count_trailing_zeros_l (val); else { int count; for (count = 0; count < BITS_PER_BITS_WORD - ULLONG_WIDTH; count += ULLONG_WIDTH) { if (val & ULLONG_MAX) return count + count_trailing_zeros_ll (val); val = shift_right_ull (val); } if (BITS_PER_BITS_WORD % ULLONG_WIDTH != 0 && BITS_WORD_MAX == (bits_word) -1) val |= (bits_word) 1 << pre_value (ULONG_MAX < BITS_WORD_MAX, BITS_PER_BITS_WORD % ULLONG_WIDTH); return count + count_trailing_zeros_ll (val); } } static bits_word bits_word_to_host_endian (bits_word val) { #ifndef WORDS_BIGENDIAN return val; #else if (BITS_WORD_MAX >> 31 == 1) return bswap_32 (val); if (BITS_WORD_MAX >> 31 >> 31 >> 1 == 1) return bswap_64 (val); { int i; bits_word r = 0; for (i = 0; i < sizeof val; i++) { r = ((r << 1 << (CHAR_BIT - 1)) | (val & ((1u << 1 << (CHAR_BIT - 1)) - 1))); val = val >> 1 >> (CHAR_BIT - 1); } return r; } #endif } DEFUN ("bool-vector-exclusive-or", Fbool_vector_exclusive_or, Sbool_vector_exclusive_or, 2, 3, 0, doc: /* Return A ^ B, bitwise exclusive or. If optional third argument C is given, store result into C. A, B, and C must be bool vectors of the same length. Return the destination vector if it changed or nil otherwise. */) (Lisp_Object a, Lisp_Object b, Lisp_Object c) { return bool_vector_binop_driver (a, b, c, bool_vector_exclusive_or); } DEFUN ("bool-vector-union", Fbool_vector_union, Sbool_vector_union, 2, 3, 0, doc: /* Return A | B, bitwise or. If optional third argument C is given, store result into C. A, B, and C must be bool vectors of the same length. Return the destination vector if it changed or nil otherwise. */) (Lisp_Object a, Lisp_Object b, Lisp_Object c) { return bool_vector_binop_driver (a, b, c, bool_vector_union); } DEFUN ("bool-vector-intersection", Fbool_vector_intersection, Sbool_vector_intersection, 2, 3, 0, doc: /* Return A & B, bitwise and. If optional third argument C is given, store result into C. A, B, and C must be bool vectors of the same length. Return the destination vector if it changed or nil otherwise. */) (Lisp_Object a, Lisp_Object b, Lisp_Object c) { return bool_vector_binop_driver (a, b, c, bool_vector_intersection); } DEFUN ("bool-vector-set-difference", Fbool_vector_set_difference, Sbool_vector_set_difference, 2, 3, 0, doc: /* Return A &~ B, set difference. If optional third argument C is given, store result into C. A, B, and C must be bool vectors of the same length. Return the destination vector if it changed or nil otherwise. */) (Lisp_Object a, Lisp_Object b, Lisp_Object c) { return bool_vector_binop_driver (a, b, c, bool_vector_set_difference); } DEFUN ("bool-vector-subsetp", Fbool_vector_subsetp, Sbool_vector_subsetp, 2, 2, 0, doc: /* Return t if every t value in A is also t in B, nil otherwise. A and B must be bool vectors of the same length. */) (Lisp_Object a, Lisp_Object b) { return bool_vector_binop_driver (a, b, b, bool_vector_subsetp); } DEFUN ("bool-vector-not", Fbool_vector_not, Sbool_vector_not, 1, 2, 0, doc: /* Compute ~A, set complement. If optional second argument B is given, store result into B. A and B must be bool vectors of the same length. Return the destination vector. */) (Lisp_Object a, Lisp_Object b) { EMACS_INT nr_bits; bits_word *bdata, *adata; ptrdiff_t i; CHECK_BOOL_VECTOR (a); nr_bits = bool_vector_size (a); if (NILP (b)) b = make_uninit_bool_vector (nr_bits); else { CHECK_BOOL_VECTOR (b); if (bool_vector_size (b) != nr_bits) wrong_length_argument (a, b, Qnil); } bdata = bool_vector_data (b); adata = bool_vector_data (a); for (i = 0; i < nr_bits / BITS_PER_BITS_WORD; i++) bdata[i] = BITS_WORD_MAX & ~adata[i]; if (nr_bits % BITS_PER_BITS_WORD) { bits_word mword = bits_word_to_host_endian (adata[i]); mword = ~mword; mword &= bool_vector_spare_mask (nr_bits); bdata[i] = bits_word_to_host_endian (mword); } return b; } DEFUN ("bool-vector-count-population", Fbool_vector_count_population, Sbool_vector_count_population, 1, 1, 0, doc: /* Count how many elements in A are t. A is a bool vector. To count A's nil elements, subtract the return value from A's length. */) (Lisp_Object a) { EMACS_INT count; EMACS_INT nr_bits; bits_word *adata; ptrdiff_t i, nwords; CHECK_BOOL_VECTOR (a); nr_bits = bool_vector_size (a); nwords = bool_vector_words (nr_bits); count = 0; adata = bool_vector_data (a); for (i = 0; i < nwords; i++) count += count_one_bits_word (adata[i]); return make_fixnum (count); } DEFUN ("bool-vector-count-consecutive", Fbool_vector_count_consecutive, Sbool_vector_count_consecutive, 3, 3, 0, doc: /* Count how many consecutive elements in A equal B starting at I. A is a bool vector, B is t or nil, and I is an index into A. */) (Lisp_Object a, Lisp_Object b, Lisp_Object i) { EMACS_INT count; EMACS_INT nr_bits; int offset; bits_word *adata; bits_word twiddle; bits_word mword; /* Machine word. */ ptrdiff_t pos, pos0; ptrdiff_t nr_words; CHECK_BOOL_VECTOR (a); CHECK_FIXNAT (i); nr_bits = bool_vector_size (a); if (XFIXNAT (i) > nr_bits) /* Allow one past the end for convenience */ args_out_of_range (a, i); adata = bool_vector_data (a); nr_words = bool_vector_words (nr_bits); pos = XFIXNAT (i) / BITS_PER_BITS_WORD; offset = XFIXNAT (i) % BITS_PER_BITS_WORD; count = 0; /* By XORing with twiddle, we transform the problem of "count consecutive equal values" into "count the zero bits". The latter operation usually has hardware support. */ twiddle = NILP (b) ? 0 : BITS_WORD_MAX; /* Scan the remainder of the mword at the current offset. */ if (pos < nr_words && offset != 0) { mword = bits_word_to_host_endian (adata[pos]); mword ^= twiddle; mword >>= offset; /* Do not count the pad bits. */ mword |= (bits_word) 1 << (BITS_PER_BITS_WORD - offset); count = count_trailing_zero_bits (mword); pos++; if (count + offset < BITS_PER_BITS_WORD) return make_fixnum (count); } /* Scan whole words until we either reach the end of the vector or find an mword that doesn't completely match. twiddle is endian-independent. */ pos0 = pos; while (pos < nr_words && adata[pos] == twiddle) pos++; count += (pos - pos0) * BITS_PER_BITS_WORD; if (pos < nr_words) { /* If we stopped because of a mismatch, see how many bits match in the current mword. */ mword = bits_word_to_host_endian (adata[pos]); mword ^= twiddle; count += count_trailing_zero_bits (mword); } else if (nr_bits % BITS_PER_BITS_WORD != 0) { /* If we hit the end, we might have overshot our count. Reduce the total by the number of spare bits at the end of the vector. */ count -= BITS_PER_BITS_WORD - nr_bits % BITS_PER_BITS_WORD; } return make_fixnum (count); } void syms_of_data (void) { Lisp_Object error_tail, arith_tail; DEFSYM (Qquote, "quote"); DEFSYM (Qlambda, "lambda"); DEFSYM (Qerror_conditions, "error-conditions"); DEFSYM (Qerror_message, "error-message"); DEFSYM (Qtop_level, "top-level"); DEFSYM (Qerror, "error"); DEFSYM (Quser_error, "user-error"); DEFSYM (Qquit, "quit"); DEFSYM (Qwrong_length_argument, "wrong-length-argument"); DEFSYM (Qwrong_type_argument, "wrong-type-argument"); DEFSYM (Qargs_out_of_range, "args-out-of-range"); DEFSYM (Qvoid_function, "void-function"); DEFSYM (Qcyclic_function_indirection, "cyclic-function-indirection"); DEFSYM (Qcyclic_variable_indirection, "cyclic-variable-indirection"); DEFSYM (Qvoid_variable, "void-variable"); DEFSYM (Qsetting_constant, "setting-constant"); DEFSYM (Qtrapping_constant, "trapping-constant"); DEFSYM (Qinvalid_read_syntax, "invalid-read-syntax"); DEFSYM (Qinvalid_function, "invalid-function"); DEFSYM (Qwrong_number_of_arguments, "wrong-number-of-arguments"); DEFSYM (Qno_catch, "no-catch"); DEFSYM (Qend_of_file, "end-of-file"); DEFSYM (Qarith_error, "arith-error"); DEFSYM (Qbeginning_of_buffer, "beginning-of-buffer"); DEFSYM (Qend_of_buffer, "end-of-buffer"); DEFSYM (Qbuffer_read_only, "buffer-read-only"); DEFSYM (Qtext_read_only, "text-read-only"); DEFSYM (Qmark_inactive, "mark-inactive"); DEFSYM (Qlistp, "listp"); DEFSYM (Qconsp, "consp"); DEFSYM (Qsymbolp, "symbolp"); DEFSYM (Qfixnump, "fixnump"); DEFSYM (Qintegerp, "integerp"); DEFSYM (Qnatnump, "natnump"); DEFSYM (Qwholenump, "wholenump"); DEFSYM (Qstringp, "stringp"); DEFSYM (Qarrayp, "arrayp"); DEFSYM (Qsequencep, "sequencep"); DEFSYM (Qbufferp, "bufferp"); DEFSYM (Qvectorp, "vectorp"); DEFSYM (Qrecordp, "recordp"); DEFSYM (Qbool_vector_p, "bool-vector-p"); DEFSYM (Qchar_or_string_p, "char-or-string-p"); DEFSYM (Qmarkerp, "markerp"); DEFSYM (Quser_ptrp, "user-ptrp"); DEFSYM (Qbuffer_or_string_p, "buffer-or-string-p"); DEFSYM (Qinteger_or_marker_p, "integer-or-marker-p"); DEFSYM (Qfboundp, "fboundp"); DEFSYM (Qfloatp, "floatp"); DEFSYM (Qnumberp, "numberp"); DEFSYM (Qnumber_or_marker_p, "number-or-marker-p"); DEFSYM (Qchar_table_p, "char-table-p"); DEFSYM (Qvector_or_char_table_p, "vector-or-char-table-p"); DEFSYM (Qsubrp, "subrp"); DEFSYM (Qunevalled, "unevalled"); DEFSYM (Qmany, "many"); DEFSYM (Qcdr, "cdr"); error_tail = pure_cons (Qerror, Qnil); /* ERROR is used as a signaler for random errors for which nothing else is right. */ Fput (Qerror, Qerror_conditions, error_tail); Fput (Qerror, Qerror_message, build_pure_c_string ("error")); #define PUT_ERROR(sym, tail, msg) \ Fput (sym, Qerror_conditions, pure_cons (sym, tail)); \ Fput (sym, Qerror_message, build_pure_c_string (msg)) PUT_ERROR (Qquit, Qnil, "Quit"); PUT_ERROR (Quser_error, error_tail, ""); PUT_ERROR (Qwrong_length_argument, error_tail, "Wrong length argument"); PUT_ERROR (Qwrong_type_argument, error_tail, "Wrong type argument"); PUT_ERROR (Qargs_out_of_range, error_tail, "Args out of range"); PUT_ERROR (Qvoid_function, error_tail, "Symbol's function definition is void"); PUT_ERROR (Qcyclic_function_indirection, error_tail, "Symbol's chain of function indirections contains a loop"); PUT_ERROR (Qcyclic_variable_indirection, error_tail, "Symbol's chain of variable indirections contains a loop"); DEFSYM (Qcircular_list, "circular-list"); PUT_ERROR (Qcircular_list, error_tail, "List contains a loop"); PUT_ERROR (Qvoid_variable, error_tail, "Symbol's value as variable is void"); PUT_ERROR (Qsetting_constant, error_tail, "Attempt to set a constant symbol"); PUT_ERROR (Qtrapping_constant, error_tail, "Attempt to trap writes to a constant symbol"); PUT_ERROR (Qinvalid_read_syntax, error_tail, "Invalid read syntax"); PUT_ERROR (Qinvalid_function, error_tail, "Invalid function"); PUT_ERROR (Qwrong_number_of_arguments, error_tail, "Wrong number of arguments"); PUT_ERROR (Qno_catch, error_tail, "No catch for tag"); PUT_ERROR (Qend_of_file, error_tail, "End of file during parsing"); arith_tail = pure_cons (Qarith_error, error_tail); Fput (Qarith_error, Qerror_conditions, arith_tail); Fput (Qarith_error, Qerror_message, build_pure_c_string ("Arithmetic error")); PUT_ERROR (Qbeginning_of_buffer, error_tail, "Beginning of buffer"); PUT_ERROR (Qend_of_buffer, error_tail, "End of buffer"); PUT_ERROR (Qbuffer_read_only, error_tail, "Buffer is read-only"); PUT_ERROR (Qtext_read_only, pure_cons (Qbuffer_read_only, error_tail), "Text is read-only"); DEFSYM (Qrange_error, "range-error"); DEFSYM (Qdomain_error, "domain-error"); DEFSYM (Qsingularity_error, "singularity-error"); DEFSYM (Qoverflow_error, "overflow-error"); DEFSYM (Qunderflow_error, "underflow-error"); PUT_ERROR (Qdomain_error, arith_tail, "Arithmetic domain error"); PUT_ERROR (Qrange_error, arith_tail, "Arithmetic range error"); PUT_ERROR (Qsingularity_error, Fcons (Qdomain_error, arith_tail), "Arithmetic singularity error"); PUT_ERROR (Qoverflow_error, Fcons (Qrange_error, arith_tail), "Arithmetic overflow error"); PUT_ERROR (Qunderflow_error, Fcons (Qrange_error, arith_tail), "Arithmetic underflow error"); /* Types that type-of returns. */ DEFSYM (Qinteger, "integer"); DEFSYM (Qsymbol, "symbol"); DEFSYM (Qstring, "string"); DEFSYM (Qcons, "cons"); DEFSYM (Qmarker, "marker"); DEFSYM (Qoverlay, "overlay"); DEFSYM (Qfinalizer, "finalizer"); DEFSYM (Qmodule_function, "module-function"); DEFSYM (Quser_ptr, "user-ptr"); DEFSYM (Qfloat, "float"); DEFSYM (Qwindow_configuration, "window-configuration"); DEFSYM (Qprocess, "process"); DEFSYM (Qwindow, "window"); DEFSYM (Qsubr, "subr"); DEFSYM (Qcompiled_function, "compiled-function"); DEFSYM (Qbuffer, "buffer"); DEFSYM (Qframe, "frame"); DEFSYM (Qvector, "vector"); DEFSYM (Qrecord, "record"); DEFSYM (Qchar_table, "char-table"); DEFSYM (Qbool_vector, "bool-vector"); DEFSYM (Qhash_table, "hash-table"); DEFSYM (Qthread, "thread"); DEFSYM (Qmutex, "mutex"); DEFSYM (Qcondition_variable, "condition-variable"); DEFSYM (Qfont_spec, "font-spec"); DEFSYM (Qfont_entity, "font-entity"); DEFSYM (Qfont_object, "font-object"); DEFSYM (Qterminal, "terminal"); DEFSYM (Qxwidget, "xwidget"); DEFSYM (Qxwidget_view, "xwidget-view"); DEFSYM (Qdefun, "defun"); DEFSYM (Qinteractive_form, "interactive-form"); DEFSYM (Qdefalias_fset_function, "defalias-fset-function"); defsubr (&Sindirect_variable); defsubr (&Sinteractive_form); defsubr (&Seq); defsubr (&Snull); defsubr (&Stype_of); defsubr (&Slistp); defsubr (&Snlistp); defsubr (&Sconsp); defsubr (&Satom); defsubr (&Sintegerp); defsubr (&Sinteger_or_marker_p); defsubr (&Snumberp); defsubr (&Snumber_or_marker_p); defsubr (&Sfloatp); defsubr (&Snatnump); defsubr (&Ssymbolp); defsubr (&Skeywordp); defsubr (&Sstringp); defsubr (&Smultibyte_string_p); defsubr (&Svectorp); defsubr (&Srecordp); defsubr (&Schar_table_p); defsubr (&Svector_or_char_table_p); defsubr (&Sbool_vector_p); defsubr (&Sarrayp); defsubr (&Ssequencep); defsubr (&Sbufferp); defsubr (&Smarkerp); defsubr (&Ssubrp); defsubr (&Sbyte_code_function_p); defsubr (&Smodule_function_p); defsubr (&Schar_or_string_p); defsubr (&Sthreadp); defsubr (&Smutexp); defsubr (&Scondition_variable_p); defsubr (&Scar); defsubr (&Scdr); defsubr (&Scar_safe); defsubr (&Scdr_safe); defsubr (&Ssetcar); defsubr (&Ssetcdr); defsubr (&Ssymbol_function); defsubr (&Sindirect_function); defsubr (&Ssymbol_plist); defsubr (&Ssymbol_name); defsubr (&Smakunbound); defsubr (&Sfmakunbound); defsubr (&Sboundp); defsubr (&Sfboundp); defsubr (&Sfset); defsubr (&Sdefalias); defsubr (&Ssetplist); defsubr (&Ssymbol_value); defsubr (&Sset); defsubr (&Sdefault_boundp); defsubr (&Sdefault_value); defsubr (&Sset_default); defsubr (&Smake_variable_buffer_local); defsubr (&Smake_local_variable); defsubr (&Skill_local_variable); defsubr (&Slocal_variable_p); defsubr (&Slocal_variable_if_set_p); defsubr (&Svariable_binding_locus); defsubr (&Saref); defsubr (&Saset); defsubr (&Snumber_to_string); defsubr (&Sstring_to_number); defsubr (&Seqlsign); defsubr (&Slss); defsubr (&Sgtr); defsubr (&Sleq); defsubr (&Sgeq); defsubr (&Sneq); defsubr (&Splus); defsubr (&Sminus); defsubr (&Stimes); defsubr (&Squo); defsubr (&Srem); defsubr (&Smod); defsubr (&Smax); defsubr (&Smin); defsubr (&Slogand); defsubr (&Slogior); defsubr (&Slogxor); defsubr (&Slogcount); defsubr (&Sash); defsubr (&Sadd1); defsubr (&Ssub1); defsubr (&Slognot); defsubr (&Sbyteorder); defsubr (&Ssubr_arity); defsubr (&Ssubr_name); #ifdef HAVE_MODULES defsubr (&Suser_ptrp); #endif defsubr (&Sbool_vector_exclusive_or); defsubr (&Sbool_vector_union); defsubr (&Sbool_vector_intersection); defsubr (&Sbool_vector_set_difference); defsubr (&Sbool_vector_not); defsubr (&Sbool_vector_subsetp); defsubr (&Sbool_vector_count_consecutive); defsubr (&Sbool_vector_count_population); set_symbol_function (Qwholenump, XSYMBOL (Qnatnump)->u.s.function); DEFVAR_LISP ("most-positive-fixnum", Vmost_positive_fixnum, doc: /* The greatest integer that is represented efficiently. This variable cannot be set; trying to do so will signal an error. */); Vmost_positive_fixnum = make_fixnum (MOST_POSITIVE_FIXNUM); make_symbol_constant (intern_c_string ("most-positive-fixnum")); DEFVAR_LISP ("most-negative-fixnum", Vmost_negative_fixnum, doc: /* The least integer that is represented efficiently. This variable cannot be set; trying to do so will signal an error. */); Vmost_negative_fixnum = make_fixnum (MOST_NEGATIVE_FIXNUM); make_symbol_constant (intern_c_string ("most-negative-fixnum")); DEFSYM (Qwatchers, "watchers"); DEFSYM (Qmakunbound, "makunbound"); DEFSYM (Qunlet, "unlet"); DEFSYM (Qset, "set"); DEFSYM (Qset_default, "set-default"); defsubr (&Sadd_variable_watcher); defsubr (&Sremove_variable_watcher); defsubr (&Sget_variable_watchers); }