| 1 | /* Fundamental definitions for GNU Emacs Lisp interpreter. |
| 2 | |
| 3 | Copyright (C) 1985-1987, 1993-1995, 1997-2013 Free Software Foundation, |
| 4 | Inc. |
| 5 | |
| 6 | This file is part of GNU Emacs. |
| 7 | |
| 8 | GNU Emacs is free software: you can redistribute it and/or modify |
| 9 | it under the terms of the GNU General Public License as published by |
| 10 | the Free Software Foundation, either version 3 of the License, or |
| 11 | (at your option) any later version. |
| 12 | |
| 13 | GNU Emacs is distributed in the hope that it will be useful, |
| 14 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 16 | GNU General Public License for more details. |
| 17 | |
| 18 | You should have received a copy of the GNU General Public License |
| 19 | along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */ |
| 20 | |
| 21 | #ifndef EMACS_LISP_H |
| 22 | #define EMACS_LISP_H |
| 23 | |
| 24 | #include <setjmp.h> |
| 25 | #include <stdalign.h> |
| 26 | #include <stdarg.h> |
| 27 | #include <stdbool.h> |
| 28 | #include <stddef.h> |
| 29 | #include <float.h> |
| 30 | #include <inttypes.h> |
| 31 | #include <limits.h> |
| 32 | |
| 33 | #include <intprops.h> |
| 34 | |
| 35 | INLINE_HEADER_BEGIN |
| 36 | #ifndef LISP_INLINE |
| 37 | # define LISP_INLINE INLINE |
| 38 | #endif |
| 39 | |
| 40 | /* The ubiquitous max and min macros. */ |
| 41 | #undef min |
| 42 | #undef max |
| 43 | #define max(a, b) ((a) > (b) ? (a) : (b)) |
| 44 | #define min(a, b) ((a) < (b) ? (a) : (b)) |
| 45 | |
| 46 | /* EMACS_INT - signed integer wide enough to hold an Emacs value |
| 47 | EMACS_INT_MAX - maximum value of EMACS_INT; can be used in #if |
| 48 | pI - printf length modifier for EMACS_INT |
| 49 | EMACS_UINT - unsigned variant of EMACS_INT */ |
| 50 | #ifndef EMACS_INT_MAX |
| 51 | # if LONG_MAX < LLONG_MAX && defined WIDE_EMACS_INT |
| 52 | typedef long long int EMACS_INT; |
| 53 | typedef unsigned long long int EMACS_UINT; |
| 54 | # define EMACS_INT_MAX LLONG_MAX |
| 55 | # define pI "ll" |
| 56 | # elif INT_MAX < LONG_MAX |
| 57 | typedef long int EMACS_INT; |
| 58 | typedef unsigned long int EMACS_UINT; |
| 59 | # define EMACS_INT_MAX LONG_MAX |
| 60 | # define pI "l" |
| 61 | # else |
| 62 | typedef int EMACS_INT; |
| 63 | typedef unsigned int EMACS_UINT; |
| 64 | # define EMACS_INT_MAX INT_MAX |
| 65 | # define pI "" |
| 66 | # endif |
| 67 | #endif |
| 68 | |
| 69 | /* Number of bits in some machine integer types. */ |
| 70 | enum |
| 71 | { |
| 72 | BITS_PER_CHAR = CHAR_BIT, |
| 73 | BITS_PER_SHORT = CHAR_BIT * sizeof (short), |
| 74 | BITS_PER_INT = CHAR_BIT * sizeof (int), |
| 75 | BITS_PER_LONG = CHAR_BIT * sizeof (long int), |
| 76 | BITS_PER_EMACS_INT = CHAR_BIT * sizeof (EMACS_INT) |
| 77 | }; |
| 78 | |
| 79 | /* printmax_t and uprintmax_t are types for printing large integers. |
| 80 | These are the widest integers that are supported for printing. |
| 81 | pMd etc. are conversions for printing them. |
| 82 | On C99 hosts, there's no problem, as even the widest integers work. |
| 83 | Fall back on EMACS_INT on pre-C99 hosts. */ |
| 84 | #ifdef PRIdMAX |
| 85 | typedef intmax_t printmax_t; |
| 86 | typedef uintmax_t uprintmax_t; |
| 87 | # define pMd PRIdMAX |
| 88 | # define pMu PRIuMAX |
| 89 | #else |
| 90 | typedef EMACS_INT printmax_t; |
| 91 | typedef EMACS_UINT uprintmax_t; |
| 92 | # define pMd pI"d" |
| 93 | # define pMu pI"u" |
| 94 | #endif |
| 95 | |
| 96 | /* Use pD to format ptrdiff_t values, which suffice for indexes into |
| 97 | buffers and strings. Emacs never allocates objects larger than |
| 98 | PTRDIFF_MAX bytes, as they cause problems with pointer subtraction. |
| 99 | In C99, pD can always be "t"; configure it here for the sake of |
| 100 | pre-C99 libraries such as glibc 2.0 and Solaris 8. */ |
| 101 | #if PTRDIFF_MAX == INT_MAX |
| 102 | # define pD "" |
| 103 | #elif PTRDIFF_MAX == LONG_MAX |
| 104 | # define pD "l" |
| 105 | #elif PTRDIFF_MAX == LLONG_MAX |
| 106 | # define pD "ll" |
| 107 | #else |
| 108 | # define pD "t" |
| 109 | #endif |
| 110 | |
| 111 | /* Extra internal type checking? */ |
| 112 | |
| 113 | /* Define an Emacs version of 'assert (COND)', since some |
| 114 | system-defined 'assert's are flaky. COND should be free of side |
| 115 | effects; it may or may not be evaluated. */ |
| 116 | #ifndef ENABLE_CHECKING |
| 117 | # define eassert(X) ((void) (0 && (X))) /* Check that X compiles. */ |
| 118 | #else /* ENABLE_CHECKING */ |
| 119 | |
| 120 | extern _Noreturn void die (const char *, const char *, int); |
| 121 | |
| 122 | /* The suppress_checking variable is initialized to 0 in alloc.c. Set |
| 123 | it to 1 using a debugger to temporarily disable aborting on |
| 124 | detected internal inconsistencies or error conditions. |
| 125 | |
| 126 | In some cases, a good compiler may be able to optimize away the |
| 127 | eassert macro altogether, e.g., if XSTRING (x) uses eassert to test |
| 128 | STRINGP (x), but a particular use of XSTRING is invoked only after |
| 129 | testing that STRINGP (x) is true, making the test redundant. */ |
| 130 | extern bool suppress_checking EXTERNALLY_VISIBLE; |
| 131 | |
| 132 | # define eassert(cond) \ |
| 133 | (suppress_checking || (cond) \ |
| 134 | ? (void) 0 \ |
| 135 | : die (# cond, __FILE__, __LINE__)) |
| 136 | #endif /* ENABLE_CHECKING */ |
| 137 | \f |
| 138 | /* Use the configure flag --enable-check-lisp-object-type to make |
| 139 | Lisp_Object use a struct type instead of the default int. The flag |
| 140 | causes CHECK_LISP_OBJECT_TYPE to be defined. */ |
| 141 | |
| 142 | /***** Select the tagging scheme. *****/ |
| 143 | /* The following option controls the tagging scheme: |
| 144 | - USE_LSB_TAG means that we can assume the least 3 bits of pointers are |
| 145 | always 0, and we can thus use them to hold tag bits, without |
| 146 | restricting our addressing space. |
| 147 | |
| 148 | If ! USE_LSB_TAG, then use the top 3 bits for tagging, thus |
| 149 | restricting our possible address range. |
| 150 | |
| 151 | USE_LSB_TAG not only requires the least 3 bits of pointers returned by |
| 152 | malloc to be 0 but also needs to be able to impose a mult-of-8 alignment |
| 153 | on the few static Lisp_Objects used: all the defsubr as well |
| 154 | as the two special buffers buffer_defaults and buffer_local_symbols. */ |
| 155 | |
| 156 | enum Lisp_Bits |
| 157 | { |
| 158 | /* Number of bits in a Lisp_Object tag. This can be used in #if, |
| 159 | and for GDB's sake also as a regular symbol. */ |
| 160 | GCTYPEBITS = |
| 161 | #define GCTYPEBITS 3 |
| 162 | GCTYPEBITS, |
| 163 | |
| 164 | /* 2**GCTYPEBITS. This must be a macro that expands to a literal |
| 165 | integer constant, for MSVC. */ |
| 166 | #define GCALIGNMENT 8 |
| 167 | |
| 168 | /* Number of bits in a Lisp_Object value, not counting the tag. */ |
| 169 | VALBITS = BITS_PER_EMACS_INT - GCTYPEBITS, |
| 170 | |
| 171 | /* Number of bits in a Lisp fixnum tag. */ |
| 172 | INTTYPEBITS = GCTYPEBITS - 1, |
| 173 | |
| 174 | /* Number of bits in a Lisp fixnum value, not counting the tag. */ |
| 175 | FIXNUM_BITS = VALBITS + 1 |
| 176 | }; |
| 177 | |
| 178 | #if GCALIGNMENT != 1 << GCTYPEBITS |
| 179 | # error "GCALIGNMENT and GCTYPEBITS are inconsistent" |
| 180 | #endif |
| 181 | |
| 182 | /* The maximum value that can be stored in a EMACS_INT, assuming all |
| 183 | bits other than the type bits contribute to a nonnegative signed value. |
| 184 | This can be used in #if, e.g., '#if VAL_MAX < UINTPTR_MAX' below. */ |
| 185 | #define VAL_MAX (EMACS_INT_MAX >> (GCTYPEBITS - 1)) |
| 186 | |
| 187 | /* Unless otherwise specified, use USE_LSB_TAG on systems where: */ |
| 188 | #ifndef USE_LSB_TAG |
| 189 | /* 1. We know malloc returns a multiple of 8. */ |
| 190 | # if (defined GNU_MALLOC || defined DOUG_LEA_MALLOC || defined __GLIBC__ \ |
| 191 | || defined DARWIN_OS || defined __sun) |
| 192 | /* 2. We can specify multiple-of-8 alignment on static variables. */ |
| 193 | # ifdef alignas |
| 194 | /* 3. Pointers-as-ints exceed VAL_MAX. |
| 195 | On hosts where pointers-as-ints do not exceed VAL_MAX, USE_LSB_TAG is: |
| 196 | a. unnecessary, because the top bits of an EMACS_INT are unused, and |
| 197 | b. slower, because it typically requires extra masking. |
| 198 | So, default USE_LSB_TAG to 1 only on hosts where it might be useful. */ |
| 199 | # if VAL_MAX < UINTPTR_MAX |
| 200 | # define USE_LSB_TAG 1 |
| 201 | # endif |
| 202 | # endif |
| 203 | # endif |
| 204 | #endif |
| 205 | #ifdef USE_LSB_TAG |
| 206 | # undef USE_LSB_TAG |
| 207 | enum enum_USE_LSB_TAG { USE_LSB_TAG = 1 }; |
| 208 | # define USE_LSB_TAG 1 |
| 209 | #else |
| 210 | enum enum_USE_LSB_TAG { USE_LSB_TAG = 0 }; |
| 211 | # define USE_LSB_TAG 0 |
| 212 | #endif |
| 213 | |
| 214 | #ifndef alignas |
| 215 | # define alignas(alignment) /* empty */ |
| 216 | # if USE_LSB_TAG |
| 217 | # error "USE_LSB_TAG requires alignas" |
| 218 | # endif |
| 219 | #endif |
| 220 | |
| 221 | |
| 222 | /* Some operations are so commonly executed that they are implemented |
| 223 | as macros, not functions, because otherwise runtime performance would |
| 224 | suffer too much when compiling with GCC without optimization. |
| 225 | There's no need to inline everything, just the operations that |
| 226 | would otherwise cause a serious performance problem. |
| 227 | |
| 228 | For each such operation OP, define a macro lisp_h_OP that contains |
| 229 | the operation's implementation. That way, OP can be implemented |
| 230 | via a macro definition like this: |
| 231 | |
| 232 | #define OP(x) lisp_h_OP (x) |
| 233 | |
| 234 | and/or via a function definition like this: |
| 235 | |
| 236 | LISP_MACRO_DEFUN (OP, Lisp_Object, (Lisp_Object x), (x)) |
| 237 | |
| 238 | which macro-expands to this: |
| 239 | |
| 240 | Lisp_Object (OP) (Lisp_Object x) { return lisp_h_OP (x); } |
| 241 | |
| 242 | without worrying about the implementations diverging, since |
| 243 | lisp_h_OP defines the actual implementation. The lisp_h_OP macros |
| 244 | are intended to be private to this include file, and should not be |
| 245 | used elsewhere. |
| 246 | |
| 247 | FIXME: Remove the lisp_h_OP macros, and define just the inline OP |
| 248 | functions, once most developers have access to GCC 4.8 or later and |
| 249 | can use "gcc -Og" to debug. Maybe in the year 2016. See |
| 250 | Bug#11935. |
| 251 | |
| 252 | Commentary for these macros can be found near their corresponding |
| 253 | functions, below. */ |
| 254 | |
| 255 | #if CHECK_LISP_OBJECT_TYPE |
| 256 | # define lisp_h_XLI(o) ((o).i) |
| 257 | # define lisp_h_XIL(i) ((Lisp_Object) { i }) |
| 258 | #else |
| 259 | # define lisp_h_XLI(o) (o) |
| 260 | # define lisp_h_XIL(i) (i) |
| 261 | #endif |
| 262 | #define lisp_h_CHECK_LIST_CONS(x, y) CHECK_TYPE (CONSP (x), Qlistp, y) |
| 263 | #define lisp_h_CHECK_NUMBER(x) CHECK_TYPE (INTEGERP (x), Qintegerp, x) |
| 264 | #define lisp_h_CHECK_SYMBOL(x) CHECK_TYPE (SYMBOLP (x), Qsymbolp, x) |
| 265 | #define lisp_h_CHECK_TYPE(ok, Qxxxp, x) \ |
| 266 | ((ok) ? (void) 0 : (void) wrong_type_argument (Qxxxp, x)) |
| 267 | #define lisp_h_CONSP(x) (XTYPE (x) == Lisp_Cons) |
| 268 | #define lisp_h_EQ(x, y) (XLI (x) == XLI (y)) |
| 269 | #define lisp_h_FLOATP(x) (XTYPE (x) == Lisp_Float) |
| 270 | #define lisp_h_INTEGERP(x) ((XTYPE (x) & ~Lisp_Int1) == 0) |
| 271 | #define lisp_h_MARKERP(x) (MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Marker) |
| 272 | #define lisp_h_MISCP(x) (XTYPE (x) == Lisp_Misc) |
| 273 | #define lisp_h_NILP(x) EQ (x, Qnil) |
| 274 | #define lisp_h_SET_SYMBOL_VAL(sym, v) \ |
| 275 | (eassert ((sym)->redirect == SYMBOL_PLAINVAL), (sym)->val.value = (v)) |
| 276 | #define lisp_h_SYMBOL_CONSTANT_P(sym) (XSYMBOL (sym)->constant) |
| 277 | #define lisp_h_SYMBOL_VAL(sym) \ |
| 278 | (eassert ((sym)->redirect == SYMBOL_PLAINVAL), (sym)->val.value) |
| 279 | #define lisp_h_SYMBOLP(x) (XTYPE (x) == Lisp_Symbol) |
| 280 | #define lisp_h_VECTORLIKEP(x) (XTYPE (x) == Lisp_Vectorlike) |
| 281 | #define lisp_h_XCAR(c) XCONS (c)->car |
| 282 | #define lisp_h_XCDR(c) XCONS (c)->u.cdr |
| 283 | #define lisp_h_XCONS(a) \ |
| 284 | (eassert (CONSP (a)), (struct Lisp_Cons *) XUNTAG (a, Lisp_Cons)) |
| 285 | #define lisp_h_XHASH(a) XUINT (a) |
| 286 | #define lisp_h_XPNTR(a) \ |
| 287 | ((void *) (intptr_t) ((XLI (a) & VALMASK) | DATA_SEG_BITS)) |
| 288 | #define lisp_h_XSYMBOL(a) \ |
| 289 | (eassert (SYMBOLP (a)), (struct Lisp_Symbol *) XUNTAG (a, Lisp_Symbol)) |
| 290 | #ifndef GC_CHECK_CONS_LIST |
| 291 | # define lisp_h_check_cons_list() ((void) 0) |
| 292 | #endif |
| 293 | #if USE_LSB_TAG |
| 294 | # define lisp_h_make_number(n) XIL ((EMACS_INT) (n) << INTTYPEBITS) |
| 295 | # define lisp_h_XFASTINT(a) XINT (a) |
| 296 | # define lisp_h_XINT(a) (XLI (a) >> INTTYPEBITS) |
| 297 | # define lisp_h_XTYPE(a) ((enum Lisp_Type) (XLI (a) & ~VALMASK)) |
| 298 | # define lisp_h_XUNTAG(a, type) ((void *) (XLI (a) - (type))) |
| 299 | #endif |
| 300 | |
| 301 | /* When compiling via gcc -O0, define the key operations as macros, as |
| 302 | Emacs is too slow otherwise. To disable this optimization, compile |
| 303 | with -DINLINING=0. */ |
| 304 | #if (defined __NO_INLINE__ \ |
| 305 | && ! defined __OPTIMIZE__ && ! defined __OPTIMIZE_SIZE__ \ |
| 306 | && ! (defined INLINING && ! INLINING)) |
| 307 | # define XLI(o) lisp_h_XLI (o) |
| 308 | # define XIL(i) lisp_h_XIL (i) |
| 309 | # define CHECK_LIST_CONS(x, y) lisp_h_CHECK_LIST_CONS (x, y) |
| 310 | # define CHECK_NUMBER(x) lisp_h_CHECK_NUMBER (x) |
| 311 | # define CHECK_SYMBOL(x) lisp_h_CHECK_SYMBOL (x) |
| 312 | # define CHECK_TYPE(ok, Qxxxp, x) lisp_h_CHECK_TYPE (ok, Qxxxp, x) |
| 313 | # define CONSP(x) lisp_h_CONSP (x) |
| 314 | # define EQ(x, y) lisp_h_EQ (x, y) |
| 315 | # define FLOATP(x) lisp_h_FLOATP (x) |
| 316 | # define INTEGERP(x) lisp_h_INTEGERP (x) |
| 317 | # define MARKERP(x) lisp_h_MARKERP (x) |
| 318 | # define MISCP(x) lisp_h_MISCP (x) |
| 319 | # define NILP(x) lisp_h_NILP (x) |
| 320 | # define SET_SYMBOL_VAL(sym, v) lisp_h_SET_SYMBOL_VAL (sym, v) |
| 321 | # define SYMBOL_CONSTANT_P(sym) lisp_h_SYMBOL_CONSTANT_P (sym) |
| 322 | # define SYMBOL_VAL(sym) lisp_h_SYMBOL_VAL (sym) |
| 323 | # define SYMBOLP(x) lisp_h_SYMBOLP (x) |
| 324 | # define VECTORLIKEP(x) lisp_h_VECTORLIKEP (x) |
| 325 | # define XCAR(c) lisp_h_XCAR (c) |
| 326 | # define XCDR(c) lisp_h_XCDR (c) |
| 327 | # define XCONS(a) lisp_h_XCONS (a) |
| 328 | # define XHASH(a) lisp_h_XHASH (a) |
| 329 | # define XPNTR(a) lisp_h_XPNTR (a) |
| 330 | # define XSYMBOL(a) lisp_h_XSYMBOL (a) |
| 331 | # ifndef GC_CHECK_CONS_LIST |
| 332 | # define check_cons_list() lisp_h_check_cons_list () |
| 333 | # endif |
| 334 | # if USE_LSB_TAG |
| 335 | # define make_number(n) lisp_h_make_number (n) |
| 336 | # define XFASTINT(a) lisp_h_XFASTINT (a) |
| 337 | # define XINT(a) lisp_h_XINT (a) |
| 338 | # define XTYPE(a) lisp_h_XTYPE (a) |
| 339 | # define XUNTAG(a, type) lisp_h_XUNTAG (a, type) |
| 340 | # endif |
| 341 | #endif |
| 342 | |
| 343 | /* Define NAME as a lisp.h inline function that returns TYPE and has |
| 344 | arguments declared as ARGDECLS and passed as ARGS. ARGDECLS and |
| 345 | ARGS should be parenthesized. Implement the function by calling |
| 346 | lisp_h_NAME ARGS. */ |
| 347 | #define LISP_MACRO_DEFUN(name, type, argdecls, args) \ |
| 348 | LISP_INLINE type (name) argdecls { return lisp_h_##name args; } |
| 349 | |
| 350 | /* like LISP_MACRO_DEFUN, except NAME returns void. */ |
| 351 | #define LISP_MACRO_DEFUN_VOID(name, argdecls, args) \ |
| 352 | LISP_INLINE void (name) argdecls { lisp_h_##name args; } |
| 353 | |
| 354 | |
| 355 | /* Define the fundamental Lisp data structures. */ |
| 356 | |
| 357 | /* This is the set of Lisp data types. If you want to define a new |
| 358 | data type, read the comments after Lisp_Fwd_Type definition |
| 359 | below. */ |
| 360 | |
| 361 | /* Lisp integers use 2 tags, to give them one extra bit, thus |
| 362 | extending their range from, e.g., -2^28..2^28-1 to -2^29..2^29-1. */ |
| 363 | #define INTMASK (EMACS_INT_MAX >> (INTTYPEBITS - 1)) |
| 364 | #define case_Lisp_Int case Lisp_Int0: case Lisp_Int1 |
| 365 | |
| 366 | /* Idea stolen from GDB. Pedantic GCC complains about enum bitfields, |
| 367 | MSVC doesn't support them, and xlc complains vociferously about them. */ |
| 368 | #if defined __STRICT_ANSI__ || defined _MSC_VER || defined __IBMC__ |
| 369 | #define ENUM_BF(TYPE) unsigned int |
| 370 | #else |
| 371 | #define ENUM_BF(TYPE) enum TYPE |
| 372 | #endif |
| 373 | |
| 374 | |
| 375 | enum Lisp_Type |
| 376 | { |
| 377 | /* Integer. XINT (obj) is the integer value. */ |
| 378 | Lisp_Int0 = 0, |
| 379 | Lisp_Int1 = USE_LSB_TAG ? 1 << INTTYPEBITS : 1, |
| 380 | |
| 381 | /* Symbol. XSYMBOL (object) points to a struct Lisp_Symbol. */ |
| 382 | Lisp_Symbol = 2, |
| 383 | |
| 384 | /* Miscellaneous. XMISC (object) points to a union Lisp_Misc, |
| 385 | whose first member indicates the subtype. */ |
| 386 | Lisp_Misc = 3, |
| 387 | |
| 388 | /* String. XSTRING (object) points to a struct Lisp_String. |
| 389 | The length of the string, and its contents, are stored therein. */ |
| 390 | Lisp_String = USE_LSB_TAG ? 1 : 1 << INTTYPEBITS, |
| 391 | |
| 392 | /* Vector of Lisp objects, or something resembling it. |
| 393 | XVECTOR (object) points to a struct Lisp_Vector, which contains |
| 394 | the size and contents. The size field also contains the type |
| 395 | information, if it's not a real vector object. */ |
| 396 | Lisp_Vectorlike = 5, |
| 397 | |
| 398 | /* Cons. XCONS (object) points to a struct Lisp_Cons. */ |
| 399 | Lisp_Cons = 6, |
| 400 | |
| 401 | Lisp_Float = 7 |
| 402 | }; |
| 403 | |
| 404 | /* This is the set of data types that share a common structure. |
| 405 | The first member of the structure is a type code from this set. |
| 406 | The enum values are arbitrary, but we'll use large numbers to make it |
| 407 | more likely that we'll spot the error if a random word in memory is |
| 408 | mistakenly interpreted as a Lisp_Misc. */ |
| 409 | enum Lisp_Misc_Type |
| 410 | { |
| 411 | Lisp_Misc_Free = 0x5eab, |
| 412 | Lisp_Misc_Marker, |
| 413 | Lisp_Misc_Overlay, |
| 414 | Lisp_Misc_Save_Value, |
| 415 | /* Currently floats are not a misc type, |
| 416 | but let's define this in case we want to change that. */ |
| 417 | Lisp_Misc_Float, |
| 418 | /* This is not a type code. It is for range checking. */ |
| 419 | Lisp_Misc_Limit |
| 420 | }; |
| 421 | |
| 422 | /* These are the types of forwarding objects used in the value slot |
| 423 | of symbols for special built-in variables whose value is stored in |
| 424 | C variables. */ |
| 425 | enum Lisp_Fwd_Type |
| 426 | { |
| 427 | Lisp_Fwd_Int, /* Fwd to a C `int' variable. */ |
| 428 | Lisp_Fwd_Bool, /* Fwd to a C boolean var. */ |
| 429 | Lisp_Fwd_Obj, /* Fwd to a C Lisp_Object variable. */ |
| 430 | Lisp_Fwd_Buffer_Obj, /* Fwd to a Lisp_Object field of buffers. */ |
| 431 | Lisp_Fwd_Kboard_Obj /* Fwd to a Lisp_Object field of kboards. */ |
| 432 | }; |
| 433 | |
| 434 | /* If you want to define a new Lisp data type, here are some |
| 435 | instructions. See the thread at |
| 436 | http://lists.gnu.org/archive/html/emacs-devel/2012-10/msg00561.html |
| 437 | for more info. |
| 438 | |
| 439 | First, there are already a couple of Lisp types that can be used if |
| 440 | your new type does not need to be exposed to Lisp programs nor |
| 441 | displayed to users. These are Lisp_Save_Value, a Lisp_Misc |
| 442 | subtype; and PVEC_OTHER, a kind of vectorlike object. The former |
| 443 | is suitable for temporarily stashing away pointers and integers in |
| 444 | a Lisp object (see the existing uses of make_save_value and |
| 445 | XSAVE_VALUE). The latter is useful for vector-like Lisp objects |
| 446 | that need to be used as part of other objects, but which are never |
| 447 | shown to users or Lisp code (search for PVEC_OTHER in xterm.c for |
| 448 | an example). |
| 449 | |
| 450 | These two types don't look pretty when printed, so they are |
| 451 | unsuitable for Lisp objects that can be exposed to users. |
| 452 | |
| 453 | To define a new data type, add one more Lisp_Misc subtype or one |
| 454 | more pseudovector subtype. Pseudovectors are more suitable for |
| 455 | objects with several slots that need to support fast random access, |
| 456 | while Lisp_Misc types are for everything else. A pseudovector object |
| 457 | provides one or more slots for Lisp objects, followed by struct |
| 458 | members that are accessible only from C. A Lisp_Misc object is a |
| 459 | wrapper for a C struct that can contain anything you like. |
| 460 | |
| 461 | Explicit freeing is discouraged for Lisp objects in general. But if |
| 462 | you really need to exploit this, use Lisp_Misc (check free_misc in |
| 463 | alloc.c to see why). There is no way to free a vectorlike object. |
| 464 | |
| 465 | To add a new pseudovector type, extend the pvec_type enumeration; |
| 466 | to add a new Lisp_Misc, extend the Lisp_Misc_Type enumeration. |
| 467 | |
| 468 | For a Lisp_Misc, you will also need to add your entry to union |
| 469 | Lisp_Misc (but make sure the first word has the same structure as |
| 470 | the others, starting with a 16-bit member of the Lisp_Misc_Type |
| 471 | enumeration and a 1-bit GC markbit) and make sure the overall size |
| 472 | of the union is not increased by your addition. |
| 473 | |
| 474 | For a new pseudovector, it's highly desirable to limit the size |
| 475 | of your data type by VBLOCK_BYTES_MAX bytes (defined in alloc.c). |
| 476 | Otherwise you will need to change sweep_vectors (also in alloc.c). |
| 477 | |
| 478 | Then you will need to add switch branches in print.c (in |
| 479 | print_object, to print your object, and possibly also in |
| 480 | print_preprocess) and to alloc.c, to mark your object (in |
| 481 | mark_object) and to free it (in gc_sweep). The latter is also the |
| 482 | right place to call any code specific to your data type that needs |
| 483 | to run when the object is recycled -- e.g., free any additional |
| 484 | resources allocated for it that are not Lisp objects. You can even |
| 485 | make a pointer to the function that frees the resources a slot in |
| 486 | your object -- this way, the same object could be used to represent |
| 487 | several disparate C structures. */ |
| 488 | |
| 489 | #ifdef CHECK_LISP_OBJECT_TYPE |
| 490 | |
| 491 | typedef struct { EMACS_INT i; } Lisp_Object; |
| 492 | |
| 493 | #define LISP_INITIALLY_ZERO {0} |
| 494 | |
| 495 | #undef CHECK_LISP_OBJECT_TYPE |
| 496 | enum CHECK_LISP_OBJECT_TYPE { CHECK_LISP_OBJECT_TYPE = 1 }; |
| 497 | #else /* CHECK_LISP_OBJECT_TYPE */ |
| 498 | |
| 499 | /* If a struct type is not wanted, define Lisp_Object as just a number. */ |
| 500 | |
| 501 | typedef EMACS_INT Lisp_Object; |
| 502 | #define LISP_INITIALLY_ZERO 0 |
| 503 | enum CHECK_LISP_OBJECT_TYPE { CHECK_LISP_OBJECT_TYPE = 0 }; |
| 504 | #endif /* CHECK_LISP_OBJECT_TYPE */ |
| 505 | |
| 506 | /* Convert a Lisp_Object to the corresponding EMACS_INT and vice versa. |
| 507 | At the machine level, these operations are no-ops. */ |
| 508 | LISP_MACRO_DEFUN (XLI, EMACS_INT, (Lisp_Object o), (o)) |
| 509 | LISP_MACRO_DEFUN (XIL, Lisp_Object, (EMACS_INT i), (i)) |
| 510 | |
| 511 | /* In the size word of a vector, this bit means the vector has been marked. */ |
| 512 | |
| 513 | static ptrdiff_t const ARRAY_MARK_FLAG |
| 514 | #define ARRAY_MARK_FLAG PTRDIFF_MIN |
| 515 | = ARRAY_MARK_FLAG; |
| 516 | |
| 517 | /* In the size word of a struct Lisp_Vector, this bit means it's really |
| 518 | some other vector-like object. */ |
| 519 | static ptrdiff_t const PSEUDOVECTOR_FLAG |
| 520 | #define PSEUDOVECTOR_FLAG (PTRDIFF_MAX - PTRDIFF_MAX / 2) |
| 521 | = PSEUDOVECTOR_FLAG; |
| 522 | |
| 523 | /* In a pseudovector, the size field actually contains a word with one |
| 524 | PSEUDOVECTOR_FLAG bit set, and one of the following values extracted |
| 525 | with PVEC_TYPE_MASK to indicate the actual type. */ |
| 526 | enum pvec_type |
| 527 | { |
| 528 | PVEC_NORMAL_VECTOR, |
| 529 | PVEC_FREE, |
| 530 | PVEC_PROCESS, |
| 531 | PVEC_FRAME, |
| 532 | PVEC_WINDOW, |
| 533 | PVEC_BOOL_VECTOR, |
| 534 | PVEC_BUFFER, |
| 535 | PVEC_HASH_TABLE, |
| 536 | PVEC_TERMINAL, |
| 537 | PVEC_WINDOW_CONFIGURATION, |
| 538 | PVEC_SUBR, |
| 539 | PVEC_OTHER, |
| 540 | /* These should be last, check internal_equal to see why. */ |
| 541 | PVEC_COMPILED, |
| 542 | PVEC_CHAR_TABLE, |
| 543 | PVEC_SUB_CHAR_TABLE, |
| 544 | PVEC_FONT /* Should be last because it's used for range checking. */ |
| 545 | }; |
| 546 | |
| 547 | /* DATA_SEG_BITS forces extra bits to be or'd in with any pointers |
| 548 | which were stored in a Lisp_Object. */ |
| 549 | #ifndef DATA_SEG_BITS |
| 550 | # define DATA_SEG_BITS 0 |
| 551 | #endif |
| 552 | enum { gdb_DATA_SEG_BITS = DATA_SEG_BITS }; |
| 553 | #undef DATA_SEG_BITS |
| 554 | |
| 555 | enum More_Lisp_Bits |
| 556 | { |
| 557 | DATA_SEG_BITS = gdb_DATA_SEG_BITS, |
| 558 | |
| 559 | /* For convenience, we also store the number of elements in these bits. |
| 560 | Note that this size is not necessarily the memory-footprint size, but |
| 561 | only the number of Lisp_Object fields (that need to be traced by GC). |
| 562 | The distinction is used, e.g., by Lisp_Process, which places extra |
| 563 | non-Lisp_Object fields at the end of the structure. */ |
| 564 | PSEUDOVECTOR_SIZE_BITS = 12, |
| 565 | PSEUDOVECTOR_SIZE_MASK = (1 << PSEUDOVECTOR_SIZE_BITS) - 1, |
| 566 | |
| 567 | /* To calculate the memory footprint of the pseudovector, it's useful |
| 568 | to store the size of non-Lisp area in word_size units here. */ |
| 569 | PSEUDOVECTOR_REST_BITS = 12, |
| 570 | PSEUDOVECTOR_REST_MASK = (((1 << PSEUDOVECTOR_REST_BITS) - 1) |
| 571 | << PSEUDOVECTOR_SIZE_BITS), |
| 572 | |
| 573 | /* Used to extract pseudovector subtype information. */ |
| 574 | PSEUDOVECTOR_AREA_BITS = PSEUDOVECTOR_SIZE_BITS + PSEUDOVECTOR_REST_BITS, |
| 575 | PVEC_TYPE_MASK = 0x3f << PSEUDOVECTOR_AREA_BITS, |
| 576 | |
| 577 | /* Number of bits to put in each character in the internal representation |
| 578 | of bool vectors. This should not vary across implementations. */ |
| 579 | BOOL_VECTOR_BITS_PER_CHAR = 8 |
| 580 | }; |
| 581 | \f |
| 582 | /* These functions extract various sorts of values from a Lisp_Object. |
| 583 | For example, if tem is a Lisp_Object whose type is Lisp_Cons, |
| 584 | XCONS (tem) is the struct Lisp_Cons * pointing to the memory for that cons. */ |
| 585 | |
| 586 | static EMACS_INT const VALMASK |
| 587 | #define VALMASK (USE_LSB_TAG ? - (1 << GCTYPEBITS) : VAL_MAX) |
| 588 | = VALMASK; |
| 589 | |
| 590 | /* Largest and smallest representable fixnum values. These are the C |
| 591 | values. They are macros for use in static initializers. */ |
| 592 | #define MOST_POSITIVE_FIXNUM (EMACS_INT_MAX >> INTTYPEBITS) |
| 593 | #define MOST_NEGATIVE_FIXNUM (-1 - MOST_POSITIVE_FIXNUM) |
| 594 | |
| 595 | /* Extract the pointer hidden within A. */ |
| 596 | LISP_MACRO_DEFUN (XPNTR, void *, (Lisp_Object a), (a)) |
| 597 | |
| 598 | #if USE_LSB_TAG |
| 599 | |
| 600 | LISP_MACRO_DEFUN (make_number, Lisp_Object, (EMACS_INT n), (n)) |
| 601 | LISP_MACRO_DEFUN (XINT, EMACS_INT, (Lisp_Object a), (a)) |
| 602 | LISP_MACRO_DEFUN (XFASTINT, EMACS_INT, (Lisp_Object a), (a)) |
| 603 | LISP_MACRO_DEFUN (XTYPE, enum Lisp_Type, (Lisp_Object a), (a)) |
| 604 | LISP_MACRO_DEFUN (XUNTAG, void *, (Lisp_Object a, int type), (a, type)) |
| 605 | |
| 606 | #else /* ! USE_LSB_TAG */ |
| 607 | |
| 608 | /* Although compiled only if ! USE_LSB_TAG, the following functions |
| 609 | also work when USE_LSB_TAG; this is to aid future maintenance when |
| 610 | the lisp_h_* macros are eventually removed. */ |
| 611 | |
| 612 | /* Make a Lisp integer representing the value of the low order |
| 613 | bits of N. */ |
| 614 | LISP_INLINE Lisp_Object |
| 615 | make_number (EMACS_INT n) |
| 616 | { |
| 617 | return XIL (USE_LSB_TAG ? n << INTTYPEBITS : n & INTMASK); |
| 618 | } |
| 619 | |
| 620 | /* Extract A's value as a signed integer. */ |
| 621 | LISP_INLINE EMACS_INT |
| 622 | XINT (Lisp_Object a) |
| 623 | { |
| 624 | EMACS_INT i = XLI (a); |
| 625 | return (USE_LSB_TAG ? i : i << INTTYPEBITS) >> INTTYPEBITS; |
| 626 | } |
| 627 | |
| 628 | /* Like XINT (A), but may be faster. A must be nonnegative. |
| 629 | If ! USE_LSB_TAG, this takes advantage of the fact that Lisp |
| 630 | integers have zero-bits in their tags. */ |
| 631 | LISP_INLINE EMACS_INT |
| 632 | XFASTINT (Lisp_Object a) |
| 633 | { |
| 634 | EMACS_INT n = USE_LSB_TAG ? XINT (a) : XLI (a); |
| 635 | eassert (0 <= n); |
| 636 | return n; |
| 637 | } |
| 638 | |
| 639 | /* Extract A's type. */ |
| 640 | LISP_INLINE enum Lisp_Type |
| 641 | XTYPE (Lisp_Object a) |
| 642 | { |
| 643 | EMACS_UINT i = XLI (a); |
| 644 | return USE_LSB_TAG ? i & ~VALMASK : i >> VALBITS; |
| 645 | } |
| 646 | |
| 647 | /* Extract A's pointer value, assuming A's type is TYPE. */ |
| 648 | LISP_INLINE void * |
| 649 | XUNTAG (Lisp_Object a, int type) |
| 650 | { |
| 651 | if (USE_LSB_TAG) |
| 652 | { |
| 653 | intptr_t i = XLI (a) - type; |
| 654 | return (void *) i; |
| 655 | } |
| 656 | return XPNTR (a); |
| 657 | } |
| 658 | |
| 659 | #endif /* ! USE_LSB_TAG */ |
| 660 | |
| 661 | /* Extract A's value as an unsigned integer. */ |
| 662 | LISP_INLINE EMACS_UINT |
| 663 | XUINT (Lisp_Object a) |
| 664 | { |
| 665 | EMACS_UINT i = XLI (a); |
| 666 | return USE_LSB_TAG ? i >> INTTYPEBITS : i & INTMASK; |
| 667 | } |
| 668 | |
| 669 | /* Return A's (Lisp-integer sized) hash. Happens to be like XUINT |
| 670 | right now, but XUINT should only be applied to objects we know are |
| 671 | integers. */ |
| 672 | LISP_MACRO_DEFUN (XHASH, EMACS_INT, (Lisp_Object a), (a)) |
| 673 | |
| 674 | /* Like make_number (N), but may be faster. N must be in nonnegative range. */ |
| 675 | LISP_INLINE Lisp_Object |
| 676 | make_natnum (EMACS_INT n) |
| 677 | { |
| 678 | eassert (0 <= n && n <= MOST_POSITIVE_FIXNUM); |
| 679 | return USE_LSB_TAG ? make_number (n) : XIL (n); |
| 680 | } |
| 681 | |
| 682 | /* Return true if X and Y are the same object. */ |
| 683 | LISP_MACRO_DEFUN (EQ, bool, (Lisp_Object x, Lisp_Object y), (x, y)) |
| 684 | |
| 685 | /* Value is non-zero if I doesn't fit into a Lisp fixnum. It is |
| 686 | written this way so that it also works if I is of unsigned |
| 687 | type or if I is a NaN. */ |
| 688 | |
| 689 | #define FIXNUM_OVERFLOW_P(i) \ |
| 690 | (! ((0 <= (i) || MOST_NEGATIVE_FIXNUM <= (i)) && (i) <= MOST_POSITIVE_FIXNUM)) |
| 691 | |
| 692 | LISP_INLINE ptrdiff_t |
| 693 | clip_to_bounds (ptrdiff_t lower, EMACS_INT num, ptrdiff_t upper) |
| 694 | { |
| 695 | return num < lower ? lower : num <= upper ? num : upper; |
| 696 | } |
| 697 | \f |
| 698 | /* Forward declarations. */ |
| 699 | |
| 700 | /* Defined in this file. */ |
| 701 | union Lisp_Fwd; |
| 702 | LISP_INLINE bool BOOL_VECTOR_P (Lisp_Object); |
| 703 | LISP_INLINE bool BUFFER_OBJFWDP (union Lisp_Fwd *); |
| 704 | LISP_INLINE bool BUFFERP (Lisp_Object); |
| 705 | LISP_INLINE bool CHAR_TABLE_P (Lisp_Object); |
| 706 | LISP_INLINE Lisp_Object CHAR_TABLE_REF_ASCII (Lisp_Object, ptrdiff_t); |
| 707 | LISP_INLINE bool (CONSP) (Lisp_Object); |
| 708 | LISP_INLINE bool (FLOATP) (Lisp_Object); |
| 709 | LISP_INLINE bool functionp (Lisp_Object); |
| 710 | LISP_INLINE bool (INTEGERP) (Lisp_Object); |
| 711 | LISP_INLINE bool (MARKERP) (Lisp_Object); |
| 712 | LISP_INLINE bool (MISCP) (Lisp_Object); |
| 713 | LISP_INLINE bool (NILP) (Lisp_Object); |
| 714 | LISP_INLINE bool OVERLAYP (Lisp_Object); |
| 715 | LISP_INLINE bool PROCESSP (Lisp_Object); |
| 716 | LISP_INLINE bool PSEUDOVECTORP (Lisp_Object, int); |
| 717 | LISP_INLINE bool SAVE_VALUEP (Lisp_Object); |
| 718 | LISP_INLINE void set_sub_char_table_contents (Lisp_Object, ptrdiff_t, |
| 719 | Lisp_Object); |
| 720 | LISP_INLINE bool STRINGP (Lisp_Object); |
| 721 | LISP_INLINE bool SUB_CHAR_TABLE_P (Lisp_Object); |
| 722 | LISP_INLINE bool SUBRP (Lisp_Object); |
| 723 | LISP_INLINE bool (SYMBOLP) (Lisp_Object); |
| 724 | LISP_INLINE bool (VECTORLIKEP) (Lisp_Object); |
| 725 | LISP_INLINE bool WINDOWP (Lisp_Object); |
| 726 | LISP_INLINE struct Lisp_Save_Value *XSAVE_VALUE (Lisp_Object); |
| 727 | |
| 728 | /* Defined in chartab.c. */ |
| 729 | extern Lisp_Object char_table_ref (Lisp_Object, int); |
| 730 | extern void char_table_set (Lisp_Object, int, Lisp_Object); |
| 731 | extern int char_table_translate (Lisp_Object, int); |
| 732 | |
| 733 | /* Defined in data.c. */ |
| 734 | extern Lisp_Object Qarrayp, Qbufferp, Qbuffer_or_string_p, Qchar_table_p; |
| 735 | extern Lisp_Object Qconsp, Qfloatp, Qintegerp, Qlambda, Qlistp, Qmarkerp, Qnil; |
| 736 | extern Lisp_Object Qnumberp, Qstringp, Qsymbolp, Qvectorp; |
| 737 | extern Lisp_Object Qvector_or_char_table_p, Qwholenump; |
| 738 | extern Lisp_Object Ffboundp (Lisp_Object); |
| 739 | extern _Noreturn Lisp_Object wrong_type_argument (Lisp_Object, Lisp_Object); |
| 740 | |
| 741 | /* Defined in emacs.c. */ |
| 742 | extern bool initialized; |
| 743 | |
| 744 | /* Defined in eval.c. */ |
| 745 | extern Lisp_Object Qautoload; |
| 746 | |
| 747 | /* Defined in floatfns.c. */ |
| 748 | extern double extract_float (Lisp_Object); |
| 749 | |
| 750 | /* Defined in process.c. */ |
| 751 | extern Lisp_Object Qprocessp; |
| 752 | |
| 753 | /* Defined in window.c. */ |
| 754 | extern Lisp_Object Qwindowp; |
| 755 | |
| 756 | /* Defined in xdisp.c. */ |
| 757 | extern Lisp_Object Qimage; |
| 758 | \f |
| 759 | |
| 760 | /* Extract a value or address from a Lisp_Object. */ |
| 761 | |
| 762 | LISP_MACRO_DEFUN (XCONS, struct Lisp_Cons *, (Lisp_Object a), (a)) |
| 763 | |
| 764 | LISP_INLINE struct Lisp_Vector * |
| 765 | XVECTOR (Lisp_Object a) |
| 766 | { |
| 767 | eassert (VECTORLIKEP (a)); |
| 768 | return XUNTAG (a, Lisp_Vectorlike); |
| 769 | } |
| 770 | |
| 771 | LISP_INLINE struct Lisp_String * |
| 772 | XSTRING (Lisp_Object a) |
| 773 | { |
| 774 | eassert (STRINGP (a)); |
| 775 | return XUNTAG (a, Lisp_String); |
| 776 | } |
| 777 | |
| 778 | LISP_MACRO_DEFUN (XSYMBOL, struct Lisp_Symbol *, (Lisp_Object a), (a)) |
| 779 | |
| 780 | LISP_INLINE struct Lisp_Float * |
| 781 | XFLOAT (Lisp_Object a) |
| 782 | { |
| 783 | eassert (FLOATP (a)); |
| 784 | return XUNTAG (a, Lisp_Float); |
| 785 | } |
| 786 | |
| 787 | /* Pseudovector types. */ |
| 788 | |
| 789 | LISP_INLINE struct Lisp_Process * |
| 790 | XPROCESS (Lisp_Object a) |
| 791 | { |
| 792 | eassert (PROCESSP (a)); |
| 793 | return XUNTAG (a, Lisp_Vectorlike); |
| 794 | } |
| 795 | |
| 796 | LISP_INLINE struct window * |
| 797 | XWINDOW (Lisp_Object a) |
| 798 | { |
| 799 | eassert (WINDOWP (a)); |
| 800 | return XUNTAG (a, Lisp_Vectorlike); |
| 801 | } |
| 802 | |
| 803 | LISP_INLINE struct terminal * |
| 804 | XTERMINAL (Lisp_Object a) |
| 805 | { |
| 806 | return XUNTAG (a, Lisp_Vectorlike); |
| 807 | } |
| 808 | |
| 809 | LISP_INLINE struct Lisp_Subr * |
| 810 | XSUBR (Lisp_Object a) |
| 811 | { |
| 812 | eassert (SUBRP (a)); |
| 813 | return XUNTAG (a, Lisp_Vectorlike); |
| 814 | } |
| 815 | |
| 816 | LISP_INLINE struct buffer * |
| 817 | XBUFFER (Lisp_Object a) |
| 818 | { |
| 819 | eassert (BUFFERP (a)); |
| 820 | return XUNTAG (a, Lisp_Vectorlike); |
| 821 | } |
| 822 | |
| 823 | LISP_INLINE struct Lisp_Char_Table * |
| 824 | XCHAR_TABLE (Lisp_Object a) |
| 825 | { |
| 826 | eassert (CHAR_TABLE_P (a)); |
| 827 | return XUNTAG (a, Lisp_Vectorlike); |
| 828 | } |
| 829 | |
| 830 | LISP_INLINE struct Lisp_Sub_Char_Table * |
| 831 | XSUB_CHAR_TABLE (Lisp_Object a) |
| 832 | { |
| 833 | eassert (SUB_CHAR_TABLE_P (a)); |
| 834 | return XUNTAG (a, Lisp_Vectorlike); |
| 835 | } |
| 836 | |
| 837 | LISP_INLINE struct Lisp_Bool_Vector * |
| 838 | XBOOL_VECTOR (Lisp_Object a) |
| 839 | { |
| 840 | eassert (BOOL_VECTOR_P (a)); |
| 841 | return XUNTAG (a, Lisp_Vectorlike); |
| 842 | } |
| 843 | |
| 844 | /* Construct a Lisp_Object from a value or address. */ |
| 845 | |
| 846 | LISP_INLINE Lisp_Object |
| 847 | make_lisp_ptr (void *ptr, enum Lisp_Type type) |
| 848 | { |
| 849 | EMACS_UINT utype = type; |
| 850 | EMACS_UINT typebits = USE_LSB_TAG ? type : utype << VALBITS; |
| 851 | Lisp_Object a = XIL (typebits | (uintptr_t) ptr); |
| 852 | eassert (XTYPE (a) == type && XUNTAG (a, type) == ptr); |
| 853 | return a; |
| 854 | } |
| 855 | |
| 856 | LISP_INLINE Lisp_Object |
| 857 | make_lisp_proc (struct Lisp_Process *p) |
| 858 | { |
| 859 | return make_lisp_ptr (p, Lisp_Vectorlike); |
| 860 | } |
| 861 | |
| 862 | #define XSETINT(a, b) ((a) = make_number (b)) |
| 863 | #define XSETFASTINT(a, b) ((a) = make_natnum (b)) |
| 864 | #define XSETCONS(a, b) ((a) = make_lisp_ptr (b, Lisp_Cons)) |
| 865 | #define XSETVECTOR(a, b) ((a) = make_lisp_ptr (b, Lisp_Vectorlike)) |
| 866 | #define XSETSTRING(a, b) ((a) = make_lisp_ptr (b, Lisp_String)) |
| 867 | #define XSETSYMBOL(a, b) ((a) = make_lisp_ptr (b, Lisp_Symbol)) |
| 868 | #define XSETFLOAT(a, b) ((a) = make_lisp_ptr (b, Lisp_Float)) |
| 869 | |
| 870 | /* Misc types. */ |
| 871 | |
| 872 | #define XSETMISC(a, b) ((a) = make_lisp_ptr (b, Lisp_Misc)) |
| 873 | #define XSETMARKER(a, b) (XSETMISC (a, b), XMISCTYPE (a) = Lisp_Misc_Marker) |
| 874 | |
| 875 | /* Pseudovector types. */ |
| 876 | |
| 877 | #define XSETPVECTYPE(v, code) \ |
| 878 | ((v)->header.size |= PSEUDOVECTOR_FLAG | ((code) << PSEUDOVECTOR_AREA_BITS)) |
| 879 | #define XSETPVECTYPESIZE(v, code, lispsize, restsize) \ |
| 880 | ((v)->header.size = (PSEUDOVECTOR_FLAG \ |
| 881 | | ((code) << PSEUDOVECTOR_AREA_BITS) \ |
| 882 | | ((restsize) << PSEUDOVECTOR_SIZE_BITS) \ |
| 883 | | (lispsize))) |
| 884 | |
| 885 | /* The cast to struct vectorlike_header * avoids aliasing issues. */ |
| 886 | #define XSETPSEUDOVECTOR(a, b, code) \ |
| 887 | XSETTYPED_PSEUDOVECTOR (a, b, \ |
| 888 | (((struct vectorlike_header *) \ |
| 889 | XUNTAG (a, Lisp_Vectorlike)) \ |
| 890 | ->size), \ |
| 891 | code) |
| 892 | #define XSETTYPED_PSEUDOVECTOR(a, b, size, code) \ |
| 893 | (XSETVECTOR (a, b), \ |
| 894 | eassert ((size & (PSEUDOVECTOR_FLAG | PVEC_TYPE_MASK)) \ |
| 895 | == (PSEUDOVECTOR_FLAG | (code << PSEUDOVECTOR_AREA_BITS)))) |
| 896 | |
| 897 | #define XSETWINDOW_CONFIGURATION(a, b) \ |
| 898 | (XSETPSEUDOVECTOR (a, b, PVEC_WINDOW_CONFIGURATION)) |
| 899 | #define XSETPROCESS(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_PROCESS)) |
| 900 | #define XSETWINDOW(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_WINDOW)) |
| 901 | #define XSETTERMINAL(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_TERMINAL)) |
| 902 | #define XSETSUBR(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_SUBR)) |
| 903 | #define XSETCOMPILED(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_COMPILED)) |
| 904 | #define XSETBUFFER(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_BUFFER)) |
| 905 | #define XSETCHAR_TABLE(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_CHAR_TABLE)) |
| 906 | #define XSETBOOL_VECTOR(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_BOOL_VECTOR)) |
| 907 | #define XSETSUB_CHAR_TABLE(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_SUB_CHAR_TABLE)) |
| 908 | |
| 909 | /* Type checking. */ |
| 910 | |
| 911 | LISP_MACRO_DEFUN_VOID (CHECK_TYPE, (int ok, Lisp_Object Qxxxp, Lisp_Object x), |
| 912 | (ok, Qxxxp, x)) |
| 913 | |
| 914 | /* Deprecated and will be removed soon. */ |
| 915 | |
| 916 | #define INTERNAL_FIELD(field) field ## _ |
| 917 | |
| 918 | /* See the macros in intervals.h. */ |
| 919 | |
| 920 | typedef struct interval *INTERVAL; |
| 921 | |
| 922 | struct Lisp_Cons |
| 923 | { |
| 924 | /* Car of this cons cell. */ |
| 925 | Lisp_Object car; |
| 926 | |
| 927 | union |
| 928 | { |
| 929 | /* Cdr of this cons cell. */ |
| 930 | Lisp_Object cdr; |
| 931 | |
| 932 | /* Used to chain conses on a free list. */ |
| 933 | struct Lisp_Cons *chain; |
| 934 | } u; |
| 935 | }; |
| 936 | |
| 937 | /* Take the car or cdr of something known to be a cons cell. */ |
| 938 | /* The _addr functions shouldn't be used outside of the minimal set |
| 939 | of code that has to know what a cons cell looks like. Other code not |
| 940 | part of the basic lisp implementation should assume that the car and cdr |
| 941 | fields are not accessible. (What if we want to switch to |
| 942 | a copying collector someday? Cached cons cell field addresses may be |
| 943 | invalidated at arbitrary points.) */ |
| 944 | LISP_INLINE Lisp_Object * |
| 945 | xcar_addr (Lisp_Object c) |
| 946 | { |
| 947 | return &XCONS (c)->car; |
| 948 | } |
| 949 | LISP_INLINE Lisp_Object * |
| 950 | xcdr_addr (Lisp_Object c) |
| 951 | { |
| 952 | return &XCONS (c)->u.cdr; |
| 953 | } |
| 954 | |
| 955 | /* Use these from normal code. */ |
| 956 | LISP_MACRO_DEFUN (XCAR, Lisp_Object, (Lisp_Object c), (c)) |
| 957 | LISP_MACRO_DEFUN (XCDR, Lisp_Object, (Lisp_Object c), (c)) |
| 958 | |
| 959 | /* Use these to set the fields of a cons cell. |
| 960 | |
| 961 | Note that both arguments may refer to the same object, so 'n' |
| 962 | should not be read after 'c' is first modified. */ |
| 963 | LISP_INLINE void |
| 964 | XSETCAR (Lisp_Object c, Lisp_Object n) |
| 965 | { |
| 966 | *xcar_addr (c) = n; |
| 967 | } |
| 968 | LISP_INLINE void |
| 969 | XSETCDR (Lisp_Object c, Lisp_Object n) |
| 970 | { |
| 971 | *xcdr_addr (c) = n; |
| 972 | } |
| 973 | |
| 974 | /* Take the car or cdr of something whose type is not known. */ |
| 975 | LISP_INLINE Lisp_Object |
| 976 | CAR (Lisp_Object c) |
| 977 | { |
| 978 | return (CONSP (c) ? XCAR (c) |
| 979 | : NILP (c) ? Qnil |
| 980 | : wrong_type_argument (Qlistp, c)); |
| 981 | } |
| 982 | LISP_INLINE Lisp_Object |
| 983 | CDR (Lisp_Object c) |
| 984 | { |
| 985 | return (CONSP (c) ? XCDR (c) |
| 986 | : NILP (c) ? Qnil |
| 987 | : wrong_type_argument (Qlistp, c)); |
| 988 | } |
| 989 | |
| 990 | /* Take the car or cdr of something whose type is not known. */ |
| 991 | LISP_INLINE Lisp_Object |
| 992 | CAR_SAFE (Lisp_Object c) |
| 993 | { |
| 994 | return CONSP (c) ? XCAR (c) : Qnil; |
| 995 | } |
| 996 | LISP_INLINE Lisp_Object |
| 997 | CDR_SAFE (Lisp_Object c) |
| 998 | { |
| 999 | return CONSP (c) ? XCDR (c) : Qnil; |
| 1000 | } |
| 1001 | |
| 1002 | /* In a string or vector, the sign bit of the `size' is the gc mark bit. */ |
| 1003 | |
| 1004 | struct Lisp_String |
| 1005 | { |
| 1006 | ptrdiff_t size; |
| 1007 | ptrdiff_t size_byte; |
| 1008 | INTERVAL intervals; /* Text properties in this string. */ |
| 1009 | unsigned char *data; |
| 1010 | }; |
| 1011 | |
| 1012 | /* True if STR is a multibyte string. */ |
| 1013 | LISP_INLINE bool |
| 1014 | STRING_MULTIBYTE (Lisp_Object str) |
| 1015 | { |
| 1016 | return 0 <= XSTRING (str)->size_byte; |
| 1017 | } |
| 1018 | |
| 1019 | /* An upper bound on the number of bytes in a Lisp string, not |
| 1020 | counting the terminating null. This a tight enough bound to |
| 1021 | prevent integer overflow errors that would otherwise occur during |
| 1022 | string size calculations. A string cannot contain more bytes than |
| 1023 | a fixnum can represent, nor can it be so long that C pointer |
| 1024 | arithmetic stops working on the string plus its terminating null. |
| 1025 | Although the actual size limit (see STRING_BYTES_MAX in alloc.c) |
| 1026 | may be a bit smaller than STRING_BYTES_BOUND, calculating it here |
| 1027 | would expose alloc.c internal details that we'd rather keep |
| 1028 | private. |
| 1029 | |
| 1030 | This is a macro for use in static initializers. The cast to |
| 1031 | ptrdiff_t ensures that the macro is signed. */ |
| 1032 | #define STRING_BYTES_BOUND \ |
| 1033 | ((ptrdiff_t) min (MOST_POSITIVE_FIXNUM, min (SIZE_MAX, PTRDIFF_MAX) - 1)) |
| 1034 | |
| 1035 | /* Mark STR as a unibyte string. */ |
| 1036 | #define STRING_SET_UNIBYTE(STR) \ |
| 1037 | do { if (EQ (STR, empty_multibyte_string)) \ |
| 1038 | (STR) = empty_unibyte_string; \ |
| 1039 | else XSTRING (STR)->size_byte = -1; } while (0) |
| 1040 | |
| 1041 | /* Mark STR as a multibyte string. Assure that STR contains only |
| 1042 | ASCII characters in advance. */ |
| 1043 | #define STRING_SET_MULTIBYTE(STR) \ |
| 1044 | do { if (EQ (STR, empty_unibyte_string)) \ |
| 1045 | (STR) = empty_multibyte_string; \ |
| 1046 | else XSTRING (STR)->size_byte = XSTRING (STR)->size; } while (0) |
| 1047 | |
| 1048 | /* Convenience functions for dealing with Lisp strings. */ |
| 1049 | |
| 1050 | LISP_INLINE unsigned char * |
| 1051 | SDATA (Lisp_Object string) |
| 1052 | { |
| 1053 | return XSTRING (string)->data; |
| 1054 | } |
| 1055 | LISP_INLINE char * |
| 1056 | SSDATA (Lisp_Object string) |
| 1057 | { |
| 1058 | /* Avoid "differ in sign" warnings. */ |
| 1059 | return (char *) SDATA (string); |
| 1060 | } |
| 1061 | LISP_INLINE unsigned char |
| 1062 | SREF (Lisp_Object string, ptrdiff_t index) |
| 1063 | { |
| 1064 | return SDATA (string)[index]; |
| 1065 | } |
| 1066 | LISP_INLINE void |
| 1067 | SSET (Lisp_Object string, ptrdiff_t index, unsigned char new) |
| 1068 | { |
| 1069 | SDATA (string)[index] = new; |
| 1070 | } |
| 1071 | LISP_INLINE ptrdiff_t |
| 1072 | SCHARS (Lisp_Object string) |
| 1073 | { |
| 1074 | return XSTRING (string)->size; |
| 1075 | } |
| 1076 | |
| 1077 | #ifdef GC_CHECK_STRING_BYTES |
| 1078 | extern ptrdiff_t string_bytes (struct Lisp_String *); |
| 1079 | #endif |
| 1080 | LISP_INLINE ptrdiff_t |
| 1081 | STRING_BYTES (struct Lisp_String *s) |
| 1082 | { |
| 1083 | #ifdef GC_CHECK_STRING_BYTES |
| 1084 | return string_bytes (s); |
| 1085 | #else |
| 1086 | return s->size_byte < 0 ? s->size : s->size_byte; |
| 1087 | #endif |
| 1088 | } |
| 1089 | |
| 1090 | LISP_INLINE ptrdiff_t |
| 1091 | SBYTES (Lisp_Object string) |
| 1092 | { |
| 1093 | return STRING_BYTES (XSTRING (string)); |
| 1094 | } |
| 1095 | LISP_INLINE void |
| 1096 | STRING_SET_CHARS (Lisp_Object string, ptrdiff_t newsize) |
| 1097 | { |
| 1098 | XSTRING (string)->size = newsize; |
| 1099 | } |
| 1100 | LISP_INLINE void |
| 1101 | STRING_COPYIN (Lisp_Object string, ptrdiff_t index, char const *new, |
| 1102 | ptrdiff_t count) |
| 1103 | { |
| 1104 | memcpy (SDATA (string) + index, new, count); |
| 1105 | } |
| 1106 | |
| 1107 | /* Header of vector-like objects. This documents the layout constraints on |
| 1108 | vectors and pseudovectors (objects of PVEC_xxx subtype). It also prevents |
| 1109 | compilers from being fooled by Emacs's type punning: XSETPSEUDOVECTOR |
| 1110 | and PSEUDOVECTORP cast their pointers to struct vectorlike_header *, |
| 1111 | because when two such pointers potentially alias, a compiler won't |
| 1112 | incorrectly reorder loads and stores to their size fields. See |
| 1113 | <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=8546>. */ |
| 1114 | struct vectorlike_header |
| 1115 | { |
| 1116 | /* The only field contains various pieces of information: |
| 1117 | - The MSB (ARRAY_MARK_FLAG) holds the gcmarkbit. |
| 1118 | - The next bit (PSEUDOVECTOR_FLAG) indicates whether this is a plain |
| 1119 | vector (0) or a pseudovector (1). |
| 1120 | - If PSEUDOVECTOR_FLAG is 0, the rest holds the size (number |
| 1121 | of slots) of the vector. |
| 1122 | - If PSEUDOVECTOR_FLAG is 1, the rest is subdivided into three fields: |
| 1123 | - a) pseudovector subtype held in PVEC_TYPE_MASK field; |
| 1124 | - b) number of Lisp_Objects slots at the beginning of the object |
| 1125 | held in PSEUDOVECTOR_SIZE_MASK field. These objects are always |
| 1126 | traced by the GC; |
| 1127 | - c) size of the rest fields held in PSEUDOVECTOR_REST_MASK and |
| 1128 | measured in word_size units. Rest fields may also include |
| 1129 | Lisp_Objects, but these objects usually needs some special treatment |
| 1130 | during GC. |
| 1131 | There are some exceptions. For PVEC_FREE, b) is always zero. For |
| 1132 | PVEC_BOOL_VECTOR and PVEC_SUBR, both b) and c) are always zero. |
| 1133 | Current layout limits the pseudovectors to 63 PVEC_xxx subtypes, |
| 1134 | 4095 Lisp_Objects in GC-ed area and 4095 word-sized other slots. */ |
| 1135 | ptrdiff_t size; |
| 1136 | }; |
| 1137 | |
| 1138 | /* Regular vector is just a header plus array of Lisp_Objects. */ |
| 1139 | |
| 1140 | struct Lisp_Vector |
| 1141 | { |
| 1142 | struct vectorlike_header header; |
| 1143 | Lisp_Object contents[FLEXIBLE_ARRAY_MEMBER]; |
| 1144 | }; |
| 1145 | |
| 1146 | /* A boolvector is a kind of vectorlike, with contents are like a string. */ |
| 1147 | |
| 1148 | struct Lisp_Bool_Vector |
| 1149 | { |
| 1150 | /* HEADER.SIZE is the vector's size field. It doesn't have the real size, |
| 1151 | just the subtype information. */ |
| 1152 | struct vectorlike_header header; |
| 1153 | /* This is the size in bits. */ |
| 1154 | EMACS_INT size; |
| 1155 | /* This contains the actual bits, packed into bytes. */ |
| 1156 | unsigned char data[FLEXIBLE_ARRAY_MEMBER]; |
| 1157 | }; |
| 1158 | |
| 1159 | /* Some handy constants for calculating sizes |
| 1160 | and offsets, mostly of vectorlike objects. */ |
| 1161 | |
| 1162 | enum |
| 1163 | { |
| 1164 | header_size = offsetof (struct Lisp_Vector, contents), |
| 1165 | bool_header_size = offsetof (struct Lisp_Bool_Vector, data), |
| 1166 | word_size = sizeof (Lisp_Object) |
| 1167 | }; |
| 1168 | |
| 1169 | /* Conveniences for dealing with Lisp arrays. */ |
| 1170 | |
| 1171 | LISP_INLINE Lisp_Object |
| 1172 | AREF (Lisp_Object array, ptrdiff_t idx) |
| 1173 | { |
| 1174 | return XVECTOR (array)->contents[idx]; |
| 1175 | } |
| 1176 | |
| 1177 | LISP_INLINE Lisp_Object * |
| 1178 | aref_addr (Lisp_Object array, ptrdiff_t idx) |
| 1179 | { |
| 1180 | return & XVECTOR (array)->contents[idx]; |
| 1181 | } |
| 1182 | |
| 1183 | LISP_INLINE ptrdiff_t |
| 1184 | ASIZE (Lisp_Object array) |
| 1185 | { |
| 1186 | return XVECTOR (array)->header.size; |
| 1187 | } |
| 1188 | |
| 1189 | LISP_INLINE void |
| 1190 | ASET (Lisp_Object array, ptrdiff_t idx, Lisp_Object val) |
| 1191 | { |
| 1192 | eassert (0 <= idx && idx < ASIZE (array)); |
| 1193 | XVECTOR (array)->contents[idx] = val; |
| 1194 | } |
| 1195 | |
| 1196 | LISP_INLINE void |
| 1197 | gc_aset (Lisp_Object array, ptrdiff_t idx, Lisp_Object val) |
| 1198 | { |
| 1199 | /* Like ASET, but also can be used in the garbage collector: |
| 1200 | sweep_weak_table calls set_hash_key etc. while the table is marked. */ |
| 1201 | eassert (0 <= idx && idx < (ASIZE (array) & ~ARRAY_MARK_FLAG)); |
| 1202 | XVECTOR (array)->contents[idx] = val; |
| 1203 | } |
| 1204 | |
| 1205 | /* If a struct is made to look like a vector, this macro returns the length |
| 1206 | of the shortest vector that would hold that struct. */ |
| 1207 | |
| 1208 | #define VECSIZE(type) \ |
| 1209 | ((sizeof (type) - header_size + word_size - 1) / word_size) |
| 1210 | |
| 1211 | /* Like VECSIZE, but used when the pseudo-vector has non-Lisp_Object fields |
| 1212 | at the end and we need to compute the number of Lisp_Object fields (the |
| 1213 | ones that the GC needs to trace). */ |
| 1214 | |
| 1215 | #define PSEUDOVECSIZE(type, nonlispfield) \ |
| 1216 | ((offsetof (type, nonlispfield) - header_size) / word_size) |
| 1217 | |
| 1218 | /* Compute A OP B, using the unsigned comparison operator OP. A and B |
| 1219 | should be integer expressions. This is not the same as |
| 1220 | mathematical comparison; for example, UNSIGNED_CMP (0, <, -1) |
| 1221 | returns 1. For efficiency, prefer plain unsigned comparison if A |
| 1222 | and B's sizes both fit (after integer promotion). */ |
| 1223 | #define UNSIGNED_CMP(a, op, b) \ |
| 1224 | (max (sizeof ((a) + 0), sizeof ((b) + 0)) <= sizeof (unsigned) \ |
| 1225 | ? ((a) + (unsigned) 0) op ((b) + (unsigned) 0) \ |
| 1226 | : ((a) + (uintmax_t) 0) op ((b) + (uintmax_t) 0)) |
| 1227 | |
| 1228 | /* Nonzero iff C is an ASCII character. */ |
| 1229 | #define ASCII_CHAR_P(c) UNSIGNED_CMP (c, <, 0x80) |
| 1230 | |
| 1231 | /* A char-table is a kind of vectorlike, with contents are like a |
| 1232 | vector but with a few other slots. For some purposes, it makes |
| 1233 | sense to handle a char-table with type struct Lisp_Vector. An |
| 1234 | element of a char table can be any Lisp objects, but if it is a sub |
| 1235 | char-table, we treat it a table that contains information of a |
| 1236 | specific range of characters. A sub char-table has the same |
| 1237 | structure as a vector. A sub char table appears only in an element |
| 1238 | of a char-table, and there's no way to access it directly from |
| 1239 | Emacs Lisp program. */ |
| 1240 | |
| 1241 | enum CHARTAB_SIZE_BITS |
| 1242 | { |
| 1243 | CHARTAB_SIZE_BITS_0 = 6, |
| 1244 | CHARTAB_SIZE_BITS_1 = 4, |
| 1245 | CHARTAB_SIZE_BITS_2 = 5, |
| 1246 | CHARTAB_SIZE_BITS_3 = 7 |
| 1247 | }; |
| 1248 | |
| 1249 | extern const int chartab_size[4]; |
| 1250 | |
| 1251 | struct Lisp_Char_Table |
| 1252 | { |
| 1253 | /* HEADER.SIZE is the vector's size field, which also holds the |
| 1254 | pseudovector type information. It holds the size, too. |
| 1255 | The size counts the defalt, parent, purpose, ascii, |
| 1256 | contents, and extras slots. */ |
| 1257 | struct vectorlike_header header; |
| 1258 | |
| 1259 | /* This holds a default value, |
| 1260 | which is used whenever the value for a specific character is nil. */ |
| 1261 | Lisp_Object defalt; |
| 1262 | |
| 1263 | /* This points to another char table, which we inherit from when the |
| 1264 | value for a specific character is nil. The `defalt' slot takes |
| 1265 | precedence over this. */ |
| 1266 | Lisp_Object parent; |
| 1267 | |
| 1268 | /* This is a symbol which says what kind of use this char-table is |
| 1269 | meant for. */ |
| 1270 | Lisp_Object purpose; |
| 1271 | |
| 1272 | /* The bottom sub char-table for characters of the range 0..127. It |
| 1273 | is nil if none of ASCII character has a specific value. */ |
| 1274 | Lisp_Object ascii; |
| 1275 | |
| 1276 | Lisp_Object contents[(1 << CHARTAB_SIZE_BITS_0)]; |
| 1277 | |
| 1278 | /* These hold additional data. It is a vector. */ |
| 1279 | Lisp_Object extras[FLEXIBLE_ARRAY_MEMBER]; |
| 1280 | }; |
| 1281 | |
| 1282 | struct Lisp_Sub_Char_Table |
| 1283 | { |
| 1284 | /* HEADER.SIZE is the vector's size field, which also holds the |
| 1285 | pseudovector type information. It holds the size, too. */ |
| 1286 | struct vectorlike_header header; |
| 1287 | |
| 1288 | /* Depth of this sub char-table. It should be 1, 2, or 3. A sub |
| 1289 | char-table of depth 1 contains 16 elements, and each element |
| 1290 | covers 4096 (128*32) characters. A sub char-table of depth 2 |
| 1291 | contains 32 elements, and each element covers 128 characters. A |
| 1292 | sub char-table of depth 3 contains 128 elements, and each element |
| 1293 | is for one character. */ |
| 1294 | Lisp_Object depth; |
| 1295 | |
| 1296 | /* Minimum character covered by the sub char-table. */ |
| 1297 | Lisp_Object min_char; |
| 1298 | |
| 1299 | /* Use set_sub_char_table_contents to set this. */ |
| 1300 | Lisp_Object contents[FLEXIBLE_ARRAY_MEMBER]; |
| 1301 | }; |
| 1302 | |
| 1303 | LISP_INLINE Lisp_Object |
| 1304 | CHAR_TABLE_REF_ASCII (Lisp_Object ct, ptrdiff_t idx) |
| 1305 | { |
| 1306 | struct Lisp_Char_Table *tbl = NULL; |
| 1307 | Lisp_Object val; |
| 1308 | do |
| 1309 | { |
| 1310 | tbl = tbl ? XCHAR_TABLE (tbl->parent) : XCHAR_TABLE (ct); |
| 1311 | val = (! SUB_CHAR_TABLE_P (tbl->ascii) ? tbl->ascii |
| 1312 | : XSUB_CHAR_TABLE (tbl->ascii)->contents[idx]); |
| 1313 | if (NILP (val)) |
| 1314 | val = tbl->defalt; |
| 1315 | } |
| 1316 | while (NILP (val) && ! NILP (tbl->parent)); |
| 1317 | |
| 1318 | return val; |
| 1319 | } |
| 1320 | |
| 1321 | /* Almost equivalent to Faref (CT, IDX) with optimization for ASCII |
| 1322 | characters. Do not check validity of CT. */ |
| 1323 | LISP_INLINE Lisp_Object |
| 1324 | CHAR_TABLE_REF (Lisp_Object ct, int idx) |
| 1325 | { |
| 1326 | return (ASCII_CHAR_P (idx) |
| 1327 | ? CHAR_TABLE_REF_ASCII (ct, idx) |
| 1328 | : char_table_ref (ct, idx)); |
| 1329 | } |
| 1330 | |
| 1331 | /* Equivalent to Faset (CT, IDX, VAL) with optimization for ASCII and |
| 1332 | 8-bit European characters. Do not check validity of CT. */ |
| 1333 | LISP_INLINE void |
| 1334 | CHAR_TABLE_SET (Lisp_Object ct, int idx, Lisp_Object val) |
| 1335 | { |
| 1336 | if (ASCII_CHAR_P (idx) && SUB_CHAR_TABLE_P (XCHAR_TABLE (ct)->ascii)) |
| 1337 | set_sub_char_table_contents (XCHAR_TABLE (ct)->ascii, idx, val); |
| 1338 | else |
| 1339 | char_table_set (ct, idx, val); |
| 1340 | } |
| 1341 | |
| 1342 | /* This structure describes a built-in function. |
| 1343 | It is generated by the DEFUN macro only. |
| 1344 | defsubr makes it into a Lisp object. */ |
| 1345 | |
| 1346 | struct Lisp_Subr |
| 1347 | { |
| 1348 | struct vectorlike_header header; |
| 1349 | union { |
| 1350 | Lisp_Object (*a0) (void); |
| 1351 | Lisp_Object (*a1) (Lisp_Object); |
| 1352 | Lisp_Object (*a2) (Lisp_Object, Lisp_Object); |
| 1353 | Lisp_Object (*a3) (Lisp_Object, Lisp_Object, Lisp_Object); |
| 1354 | Lisp_Object (*a4) (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 1355 | Lisp_Object (*a5) (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 1356 | Lisp_Object (*a6) (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 1357 | Lisp_Object (*a7) (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 1358 | Lisp_Object (*a8) (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 1359 | Lisp_Object (*aUNEVALLED) (Lisp_Object args); |
| 1360 | Lisp_Object (*aMANY) (ptrdiff_t, Lisp_Object *); |
| 1361 | } function; |
| 1362 | short min_args, max_args; |
| 1363 | const char *symbol_name; |
| 1364 | const char *intspec; |
| 1365 | const char *doc; |
| 1366 | }; |
| 1367 | |
| 1368 | /* This is the number of slots that every char table must have. This |
| 1369 | counts the ordinary slots and the top, defalt, parent, and purpose |
| 1370 | slots. */ |
| 1371 | enum CHAR_TABLE_STANDARD_SLOTS |
| 1372 | { |
| 1373 | CHAR_TABLE_STANDARD_SLOTS = PSEUDOVECSIZE (struct Lisp_Char_Table, extras) |
| 1374 | }; |
| 1375 | |
| 1376 | /* Return the number of "extra" slots in the char table CT. */ |
| 1377 | |
| 1378 | LISP_INLINE int |
| 1379 | CHAR_TABLE_EXTRA_SLOTS (struct Lisp_Char_Table *ct) |
| 1380 | { |
| 1381 | return ((ct->header.size & PSEUDOVECTOR_SIZE_MASK) |
| 1382 | - CHAR_TABLE_STANDARD_SLOTS); |
| 1383 | } |
| 1384 | |
| 1385 | \f |
| 1386 | /*********************************************************************** |
| 1387 | Symbols |
| 1388 | ***********************************************************************/ |
| 1389 | |
| 1390 | /* Interned state of a symbol. */ |
| 1391 | |
| 1392 | enum symbol_interned |
| 1393 | { |
| 1394 | SYMBOL_UNINTERNED = 0, |
| 1395 | SYMBOL_INTERNED = 1, |
| 1396 | SYMBOL_INTERNED_IN_INITIAL_OBARRAY = 2 |
| 1397 | }; |
| 1398 | |
| 1399 | enum symbol_redirect |
| 1400 | { |
| 1401 | SYMBOL_PLAINVAL = 4, |
| 1402 | SYMBOL_VARALIAS = 1, |
| 1403 | SYMBOL_LOCALIZED = 2, |
| 1404 | SYMBOL_FORWARDED = 3 |
| 1405 | }; |
| 1406 | |
| 1407 | struct Lisp_Symbol |
| 1408 | { |
| 1409 | unsigned gcmarkbit : 1; |
| 1410 | |
| 1411 | /* Indicates where the value can be found: |
| 1412 | 0 : it's a plain var, the value is in the `value' field. |
| 1413 | 1 : it's a varalias, the value is really in the `alias' symbol. |
| 1414 | 2 : it's a localized var, the value is in the `blv' object. |
| 1415 | 3 : it's a forwarding variable, the value is in `forward'. */ |
| 1416 | ENUM_BF (symbol_redirect) redirect : 3; |
| 1417 | |
| 1418 | /* Non-zero means symbol is constant, i.e. changing its value |
| 1419 | should signal an error. If the value is 3, then the var |
| 1420 | can be changed, but only by `defconst'. */ |
| 1421 | unsigned constant : 2; |
| 1422 | |
| 1423 | /* Interned state of the symbol. This is an enumerator from |
| 1424 | enum symbol_interned. */ |
| 1425 | unsigned interned : 2; |
| 1426 | |
| 1427 | /* Non-zero means that this variable has been explicitly declared |
| 1428 | special (with `defvar' etc), and shouldn't be lexically bound. */ |
| 1429 | unsigned declared_special : 1; |
| 1430 | |
| 1431 | /* The symbol's name, as a Lisp string. */ |
| 1432 | Lisp_Object name; |
| 1433 | |
| 1434 | /* Value of the symbol or Qunbound if unbound. Which alternative of the |
| 1435 | union is used depends on the `redirect' field above. */ |
| 1436 | union { |
| 1437 | Lisp_Object value; |
| 1438 | struct Lisp_Symbol *alias; |
| 1439 | struct Lisp_Buffer_Local_Value *blv; |
| 1440 | union Lisp_Fwd *fwd; |
| 1441 | } val; |
| 1442 | |
| 1443 | /* Function value of the symbol or Qnil if not fboundp. */ |
| 1444 | Lisp_Object function; |
| 1445 | |
| 1446 | /* The symbol's property list. */ |
| 1447 | Lisp_Object plist; |
| 1448 | |
| 1449 | /* Next symbol in obarray bucket, if the symbol is interned. */ |
| 1450 | struct Lisp_Symbol *next; |
| 1451 | }; |
| 1452 | |
| 1453 | /* Value is name of symbol. */ |
| 1454 | |
| 1455 | LISP_MACRO_DEFUN (SYMBOL_VAL, Lisp_Object, (struct Lisp_Symbol *sym), (sym)) |
| 1456 | |
| 1457 | LISP_INLINE struct Lisp_Symbol * |
| 1458 | SYMBOL_ALIAS (struct Lisp_Symbol *sym) |
| 1459 | { |
| 1460 | eassert (sym->redirect == SYMBOL_VARALIAS); |
| 1461 | return sym->val.alias; |
| 1462 | } |
| 1463 | LISP_INLINE struct Lisp_Buffer_Local_Value * |
| 1464 | SYMBOL_BLV (struct Lisp_Symbol *sym) |
| 1465 | { |
| 1466 | eassert (sym->redirect == SYMBOL_LOCALIZED); |
| 1467 | return sym->val.blv; |
| 1468 | } |
| 1469 | LISP_INLINE union Lisp_Fwd * |
| 1470 | SYMBOL_FWD (struct Lisp_Symbol *sym) |
| 1471 | { |
| 1472 | eassert (sym->redirect == SYMBOL_FORWARDED); |
| 1473 | return sym->val.fwd; |
| 1474 | } |
| 1475 | |
| 1476 | LISP_MACRO_DEFUN_VOID (SET_SYMBOL_VAL, |
| 1477 | (struct Lisp_Symbol *sym, Lisp_Object v), (sym, v)) |
| 1478 | |
| 1479 | LISP_INLINE void |
| 1480 | SET_SYMBOL_ALIAS (struct Lisp_Symbol *sym, struct Lisp_Symbol *v) |
| 1481 | { |
| 1482 | eassert (sym->redirect == SYMBOL_VARALIAS); |
| 1483 | sym->val.alias = v; |
| 1484 | } |
| 1485 | LISP_INLINE void |
| 1486 | SET_SYMBOL_BLV (struct Lisp_Symbol *sym, struct Lisp_Buffer_Local_Value *v) |
| 1487 | { |
| 1488 | eassert (sym->redirect == SYMBOL_LOCALIZED); |
| 1489 | sym->val.blv = v; |
| 1490 | } |
| 1491 | LISP_INLINE void |
| 1492 | SET_SYMBOL_FWD (struct Lisp_Symbol *sym, union Lisp_Fwd *v) |
| 1493 | { |
| 1494 | eassert (sym->redirect == SYMBOL_FORWARDED); |
| 1495 | sym->val.fwd = v; |
| 1496 | } |
| 1497 | |
| 1498 | LISP_INLINE Lisp_Object |
| 1499 | SYMBOL_NAME (Lisp_Object sym) |
| 1500 | { |
| 1501 | return XSYMBOL (sym)->name; |
| 1502 | } |
| 1503 | |
| 1504 | /* Value is true if SYM is an interned symbol. */ |
| 1505 | |
| 1506 | LISP_INLINE bool |
| 1507 | SYMBOL_INTERNED_P (Lisp_Object sym) |
| 1508 | { |
| 1509 | return XSYMBOL (sym)->interned != SYMBOL_UNINTERNED; |
| 1510 | } |
| 1511 | |
| 1512 | /* Value is true if SYM is interned in initial_obarray. */ |
| 1513 | |
| 1514 | LISP_INLINE bool |
| 1515 | SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P (Lisp_Object sym) |
| 1516 | { |
| 1517 | return XSYMBOL (sym)->interned == SYMBOL_INTERNED_IN_INITIAL_OBARRAY; |
| 1518 | } |
| 1519 | |
| 1520 | /* Value is non-zero if symbol is considered a constant, i.e. its |
| 1521 | value cannot be changed (there is an exception for keyword symbols, |
| 1522 | whose value can be set to the keyword symbol itself). */ |
| 1523 | |
| 1524 | LISP_MACRO_DEFUN (SYMBOL_CONSTANT_P, int, (Lisp_Object sym), (sym)) |
| 1525 | |
| 1526 | #define DEFSYM(sym, name) \ |
| 1527 | do { (sym) = intern_c_string ((name)); staticpro (&(sym)); } while (0) |
| 1528 | |
| 1529 | \f |
| 1530 | /*********************************************************************** |
| 1531 | Hash Tables |
| 1532 | ***********************************************************************/ |
| 1533 | |
| 1534 | /* The structure of a Lisp hash table. */ |
| 1535 | |
| 1536 | struct hash_table_test |
| 1537 | { |
| 1538 | /* Name of the function used to compare keys. */ |
| 1539 | Lisp_Object name; |
| 1540 | |
| 1541 | /* User-supplied hash function, or nil. */ |
| 1542 | Lisp_Object user_hash_function; |
| 1543 | |
| 1544 | /* User-supplied key comparison function, or nil. */ |
| 1545 | Lisp_Object user_cmp_function; |
| 1546 | |
| 1547 | /* C function to compare two keys. */ |
| 1548 | bool (*cmpfn) (struct hash_table_test *t, Lisp_Object, Lisp_Object); |
| 1549 | |
| 1550 | /* C function to compute hash code. */ |
| 1551 | EMACS_UINT (*hashfn) (struct hash_table_test *t, Lisp_Object); |
| 1552 | }; |
| 1553 | |
| 1554 | struct Lisp_Hash_Table |
| 1555 | { |
| 1556 | /* This is for Lisp; the hash table code does not refer to it. */ |
| 1557 | struct vectorlike_header header; |
| 1558 | |
| 1559 | /* Nil if table is non-weak. Otherwise a symbol describing the |
| 1560 | weakness of the table. */ |
| 1561 | Lisp_Object weak; |
| 1562 | |
| 1563 | /* When the table is resized, and this is an integer, compute the |
| 1564 | new size by adding this to the old size. If a float, compute the |
| 1565 | new size by multiplying the old size with this factor. */ |
| 1566 | Lisp_Object rehash_size; |
| 1567 | |
| 1568 | /* Resize hash table when number of entries/ table size is >= this |
| 1569 | ratio, a float. */ |
| 1570 | Lisp_Object rehash_threshold; |
| 1571 | |
| 1572 | /* Vector of hash codes.. If hash[I] is nil, this means that that |
| 1573 | entry I is unused. */ |
| 1574 | Lisp_Object hash; |
| 1575 | |
| 1576 | /* Vector used to chain entries. If entry I is free, next[I] is the |
| 1577 | entry number of the next free item. If entry I is non-free, |
| 1578 | next[I] is the index of the next entry in the collision chain. */ |
| 1579 | Lisp_Object next; |
| 1580 | |
| 1581 | /* Index of first free entry in free list. */ |
| 1582 | Lisp_Object next_free; |
| 1583 | |
| 1584 | /* Bucket vector. A non-nil entry is the index of the first item in |
| 1585 | a collision chain. This vector's size can be larger than the |
| 1586 | hash table size to reduce collisions. */ |
| 1587 | Lisp_Object index; |
| 1588 | |
| 1589 | /* Only the fields above are traced normally by the GC. The ones below |
| 1590 | `count' are special and are either ignored by the GC or traced in |
| 1591 | a special way (e.g. because of weakness). */ |
| 1592 | |
| 1593 | /* Number of key/value entries in the table. */ |
| 1594 | ptrdiff_t count; |
| 1595 | |
| 1596 | /* Vector of keys and values. The key of item I is found at index |
| 1597 | 2 * I, the value is found at index 2 * I + 1. |
| 1598 | This is gc_marked specially if the table is weak. */ |
| 1599 | Lisp_Object key_and_value; |
| 1600 | |
| 1601 | /* The comparison and hash functions. */ |
| 1602 | struct hash_table_test test; |
| 1603 | |
| 1604 | /* Next weak hash table if this is a weak hash table. The head |
| 1605 | of the list is in weak_hash_tables. */ |
| 1606 | struct Lisp_Hash_Table *next_weak; |
| 1607 | }; |
| 1608 | |
| 1609 | |
| 1610 | LISP_INLINE struct Lisp_Hash_Table * |
| 1611 | XHASH_TABLE (Lisp_Object a) |
| 1612 | { |
| 1613 | return XUNTAG (a, Lisp_Vectorlike); |
| 1614 | } |
| 1615 | |
| 1616 | #define XSET_HASH_TABLE(VAR, PTR) \ |
| 1617 | (XSETPSEUDOVECTOR (VAR, PTR, PVEC_HASH_TABLE)) |
| 1618 | |
| 1619 | LISP_INLINE bool |
| 1620 | HASH_TABLE_P (Lisp_Object a) |
| 1621 | { |
| 1622 | return PSEUDOVECTORP (a, PVEC_HASH_TABLE); |
| 1623 | } |
| 1624 | |
| 1625 | /* Value is the key part of entry IDX in hash table H. */ |
| 1626 | LISP_INLINE Lisp_Object |
| 1627 | HASH_KEY (struct Lisp_Hash_Table *h, ptrdiff_t idx) |
| 1628 | { |
| 1629 | return AREF (h->key_and_value, 2 * idx); |
| 1630 | } |
| 1631 | |
| 1632 | /* Value is the value part of entry IDX in hash table H. */ |
| 1633 | LISP_INLINE Lisp_Object |
| 1634 | HASH_VALUE (struct Lisp_Hash_Table *h, ptrdiff_t idx) |
| 1635 | { |
| 1636 | return AREF (h->key_and_value, 2 * idx + 1); |
| 1637 | } |
| 1638 | |
| 1639 | /* Value is the index of the next entry following the one at IDX |
| 1640 | in hash table H. */ |
| 1641 | LISP_INLINE Lisp_Object |
| 1642 | HASH_NEXT (struct Lisp_Hash_Table *h, ptrdiff_t idx) |
| 1643 | { |
| 1644 | return AREF (h->next, idx); |
| 1645 | } |
| 1646 | |
| 1647 | /* Value is the hash code computed for entry IDX in hash table H. */ |
| 1648 | LISP_INLINE Lisp_Object |
| 1649 | HASH_HASH (struct Lisp_Hash_Table *h, ptrdiff_t idx) |
| 1650 | { |
| 1651 | return AREF (h->hash, idx); |
| 1652 | } |
| 1653 | |
| 1654 | /* Value is the index of the element in hash table H that is the |
| 1655 | start of the collision list at index IDX in the index vector of H. */ |
| 1656 | LISP_INLINE Lisp_Object |
| 1657 | HASH_INDEX (struct Lisp_Hash_Table *h, ptrdiff_t idx) |
| 1658 | { |
| 1659 | return AREF (h->index, idx); |
| 1660 | } |
| 1661 | |
| 1662 | /* Value is the size of hash table H. */ |
| 1663 | LISP_INLINE ptrdiff_t |
| 1664 | HASH_TABLE_SIZE (struct Lisp_Hash_Table *h) |
| 1665 | { |
| 1666 | return ASIZE (h->next); |
| 1667 | } |
| 1668 | |
| 1669 | /* Default size for hash tables if not specified. */ |
| 1670 | |
| 1671 | enum DEFAULT_HASH_SIZE { DEFAULT_HASH_SIZE = 65 }; |
| 1672 | |
| 1673 | /* Default threshold specifying when to resize a hash table. The |
| 1674 | value gives the ratio of current entries in the hash table and the |
| 1675 | size of the hash table. */ |
| 1676 | |
| 1677 | static double const DEFAULT_REHASH_THRESHOLD = 0.8; |
| 1678 | |
| 1679 | /* Default factor by which to increase the size of a hash table. */ |
| 1680 | |
| 1681 | static double const DEFAULT_REHASH_SIZE = 1.5; |
| 1682 | |
| 1683 | /* Combine two integers X and Y for hashing. The result might not fit |
| 1684 | into a Lisp integer. */ |
| 1685 | |
| 1686 | LISP_INLINE EMACS_UINT |
| 1687 | sxhash_combine (EMACS_UINT x, EMACS_UINT y) |
| 1688 | { |
| 1689 | return (x << 4) + (x >> (BITS_PER_EMACS_INT - 4)) + y; |
| 1690 | } |
| 1691 | |
| 1692 | /* Hash X, returning a value that fits into a fixnum. */ |
| 1693 | |
| 1694 | LISP_INLINE EMACS_UINT |
| 1695 | SXHASH_REDUCE (EMACS_UINT x) |
| 1696 | { |
| 1697 | return (x ^ x >> (BITS_PER_EMACS_INT - FIXNUM_BITS)) & INTMASK; |
| 1698 | } |
| 1699 | |
| 1700 | /* These structures are used for various misc types. */ |
| 1701 | |
| 1702 | struct Lisp_Misc_Any /* Supertype of all Misc types. */ |
| 1703 | { |
| 1704 | ENUM_BF (Lisp_Misc_Type) type : 16; /* = Lisp_Misc_??? */ |
| 1705 | unsigned gcmarkbit : 1; |
| 1706 | int spacer : 15; |
| 1707 | }; |
| 1708 | |
| 1709 | struct Lisp_Marker |
| 1710 | { |
| 1711 | ENUM_BF (Lisp_Misc_Type) type : 16; /* = Lisp_Misc_Marker */ |
| 1712 | unsigned gcmarkbit : 1; |
| 1713 | int spacer : 13; |
| 1714 | /* This flag is temporarily used in the functions |
| 1715 | decode/encode_coding_object to record that the marker position |
| 1716 | must be adjusted after the conversion. */ |
| 1717 | unsigned int need_adjustment : 1; |
| 1718 | /* 1 means normal insertion at the marker's position |
| 1719 | leaves the marker after the inserted text. */ |
| 1720 | unsigned int insertion_type : 1; |
| 1721 | /* This is the buffer that the marker points into, or 0 if it points nowhere. |
| 1722 | Note: a chain of markers can contain markers pointing into different |
| 1723 | buffers (the chain is per buffer_text rather than per buffer, so it's |
| 1724 | shared between indirect buffers). */ |
| 1725 | /* This is used for (other than NULL-checking): |
| 1726 | - Fmarker_buffer |
| 1727 | - Fset_marker: check eq(oldbuf, newbuf) to avoid unchain+rechain. |
| 1728 | - unchain_marker: to find the list from which to unchain. |
| 1729 | - Fkill_buffer: to only unchain the markers of current indirect buffer. |
| 1730 | */ |
| 1731 | struct buffer *buffer; |
| 1732 | |
| 1733 | /* The remaining fields are meaningless in a marker that |
| 1734 | does not point anywhere. */ |
| 1735 | |
| 1736 | /* For markers that point somewhere, |
| 1737 | this is used to chain of all the markers in a given buffer. */ |
| 1738 | /* We could remove it and use an array in buffer_text instead. |
| 1739 | That would also allow to preserve it ordered. */ |
| 1740 | struct Lisp_Marker *next; |
| 1741 | /* This is the char position where the marker points. */ |
| 1742 | ptrdiff_t charpos; |
| 1743 | /* This is the byte position. |
| 1744 | It's mostly used as a charpos<->bytepos cache (i.e. it's not directly |
| 1745 | used to implement the functionality of markers, but rather to (ab)use |
| 1746 | markers as a cache for char<->byte mappings). */ |
| 1747 | ptrdiff_t bytepos; |
| 1748 | }; |
| 1749 | |
| 1750 | /* START and END are markers in the overlay's buffer, and |
| 1751 | PLIST is the overlay's property list. */ |
| 1752 | struct Lisp_Overlay |
| 1753 | /* An overlay's real data content is: |
| 1754 | - plist |
| 1755 | - buffer (really there are two buffer pointers, one per marker, |
| 1756 | and both points to the same buffer) |
| 1757 | - insertion type of both ends (per-marker fields) |
| 1758 | - start & start byte (of start marker) |
| 1759 | - end & end byte (of end marker) |
| 1760 | - next (singly linked list of overlays) |
| 1761 | - next fields of start and end markers (singly linked list of markers). |
| 1762 | I.e. 9words plus 2 bits, 3words of which are for external linked lists. |
| 1763 | */ |
| 1764 | { |
| 1765 | ENUM_BF (Lisp_Misc_Type) type : 16; /* = Lisp_Misc_Overlay */ |
| 1766 | unsigned gcmarkbit : 1; |
| 1767 | int spacer : 15; |
| 1768 | struct Lisp_Overlay *next; |
| 1769 | Lisp_Object start; |
| 1770 | Lisp_Object end; |
| 1771 | Lisp_Object plist; |
| 1772 | }; |
| 1773 | |
| 1774 | /* Types of data which may be saved in a Lisp_Save_Value. */ |
| 1775 | |
| 1776 | enum |
| 1777 | { |
| 1778 | SAVE_UNUSED, |
| 1779 | SAVE_INTEGER, |
| 1780 | SAVE_FUNCPOINTER, |
| 1781 | SAVE_POINTER, |
| 1782 | SAVE_OBJECT |
| 1783 | }; |
| 1784 | |
| 1785 | /* Number of bits needed to store one of the above values. */ |
| 1786 | enum { SAVE_SLOT_BITS = 3 }; |
| 1787 | |
| 1788 | /* Number of slots in a save value where save_type is nonzero. */ |
| 1789 | enum { SAVE_VALUE_SLOTS = 4 }; |
| 1790 | |
| 1791 | /* Bit-width and values for struct Lisp_Save_Value's save_type member. */ |
| 1792 | |
| 1793 | enum { SAVE_TYPE_BITS = SAVE_VALUE_SLOTS * SAVE_SLOT_BITS + 1 }; |
| 1794 | |
| 1795 | enum Lisp_Save_Type |
| 1796 | { |
| 1797 | SAVE_TYPE_INT_INT = SAVE_INTEGER + (SAVE_INTEGER << SAVE_SLOT_BITS), |
| 1798 | SAVE_TYPE_INT_INT_INT |
| 1799 | = (SAVE_INTEGER + (SAVE_TYPE_INT_INT << SAVE_SLOT_BITS)), |
| 1800 | SAVE_TYPE_OBJ_OBJ = SAVE_OBJECT + (SAVE_OBJECT << SAVE_SLOT_BITS), |
| 1801 | SAVE_TYPE_OBJ_OBJ_OBJ = SAVE_OBJECT + (SAVE_TYPE_OBJ_OBJ << SAVE_SLOT_BITS), |
| 1802 | SAVE_TYPE_OBJ_OBJ_OBJ_OBJ |
| 1803 | = SAVE_OBJECT + (SAVE_TYPE_OBJ_OBJ_OBJ << SAVE_SLOT_BITS), |
| 1804 | SAVE_TYPE_PTR_INT = SAVE_POINTER + (SAVE_INTEGER << SAVE_SLOT_BITS), |
| 1805 | SAVE_TYPE_PTR_OBJ = SAVE_POINTER + (SAVE_OBJECT << SAVE_SLOT_BITS), |
| 1806 | SAVE_TYPE_PTR_PTR = SAVE_POINTER + (SAVE_POINTER << SAVE_SLOT_BITS), |
| 1807 | SAVE_TYPE_FUNCPTR_PTR_OBJ |
| 1808 | = SAVE_FUNCPOINTER + (SAVE_TYPE_PTR_OBJ << SAVE_SLOT_BITS), |
| 1809 | |
| 1810 | /* This has an extra bit indicating it's raw memory. */ |
| 1811 | SAVE_TYPE_MEMORY = SAVE_TYPE_PTR_INT + (1 << (SAVE_TYPE_BITS - 1)) |
| 1812 | }; |
| 1813 | |
| 1814 | /* Special object used to hold a different values for later use. |
| 1815 | |
| 1816 | This is mostly used to package C integers and pointers to call |
| 1817 | record_unwind_protect when two or more values need to be saved. |
| 1818 | make_save_value lets you pack up to SAVE_VALUE_SLOTS integers, pointers, |
| 1819 | function pointers or Lisp_Objects and conveniently get them back |
| 1820 | with XSAVE_INTEGER, XSAVE_POINTER, XSAVE_FUNCPOINTER, and |
| 1821 | XSAVE_OBJECT macros: |
| 1822 | |
| 1823 | ... |
| 1824 | struct my_data *md = get_my_data (); |
| 1825 | Lisp_Object my_object = get_my_object (); |
| 1826 | record_unwind_protect |
| 1827 | (my_unwind, make_save_value (SAVE_TYPE_PTR_OBJ, md, my_object)); |
| 1828 | ... |
| 1829 | |
| 1830 | Lisp_Object my_unwind (Lisp_Object arg) |
| 1831 | { |
| 1832 | struct my_data *md = XSAVE_POINTER (arg, 0); |
| 1833 | Lisp_Object my_object = XSAVE_OBJECT (arg, 1); |
| 1834 | ... |
| 1835 | } |
| 1836 | |
| 1837 | If ENABLE_CHECKING is in effect, XSAVE_xxx macros do type checking of the |
| 1838 | saved objects and raise eassert if type of the saved object doesn't match |
| 1839 | the type which is extracted. In the example above, XSAVE_INTEGER (arg, 2) |
| 1840 | or XSAVE_OBJECT (arg, 0) are wrong because nothing was saved in slot 2 and |
| 1841 | Lisp_Object was saved in slot 1 of ARG. */ |
| 1842 | |
| 1843 | typedef void (*voidfuncptr) (void); |
| 1844 | |
| 1845 | struct Lisp_Save_Value |
| 1846 | { |
| 1847 | ENUM_BF (Lisp_Misc_Type) type : 16; /* = Lisp_Misc_Save_Value */ |
| 1848 | unsigned gcmarkbit : 1; |
| 1849 | int spacer : 32 - (16 + 1 + SAVE_TYPE_BITS); |
| 1850 | |
| 1851 | /* DATA[N] may hold up to SAVE_VALUE_SLOTS entries. The type of |
| 1852 | V's Ith entry is given by save_type (V, I). E.g., if save_type |
| 1853 | (V, 3) == SAVE_INTEGER, V->data[3].integer is in use. |
| 1854 | |
| 1855 | If SAVE_TYPE == SAVE_TYPE_MEMORY, DATA[0].pointer is the address of |
| 1856 | a memory area containing DATA[1].integer potential Lisp_Objects. */ |
| 1857 | ENUM_BF (Lisp_Save_Type) save_type : SAVE_TYPE_BITS; |
| 1858 | union { |
| 1859 | void *pointer; |
| 1860 | voidfuncptr funcpointer; |
| 1861 | ptrdiff_t integer; |
| 1862 | Lisp_Object object; |
| 1863 | } data[SAVE_VALUE_SLOTS]; |
| 1864 | }; |
| 1865 | |
| 1866 | /* Return the type of V's Nth saved value. */ |
| 1867 | LISP_INLINE int |
| 1868 | save_type (struct Lisp_Save_Value *v, int n) |
| 1869 | { |
| 1870 | eassert (0 <= n && n < SAVE_VALUE_SLOTS); |
| 1871 | return (v->save_type >> (SAVE_SLOT_BITS * n) & ((1 << SAVE_SLOT_BITS) - 1)); |
| 1872 | } |
| 1873 | |
| 1874 | /* Get and set the Nth saved pointer. */ |
| 1875 | |
| 1876 | LISP_INLINE void * |
| 1877 | XSAVE_POINTER (Lisp_Object obj, int n) |
| 1878 | { |
| 1879 | eassert (save_type (XSAVE_VALUE (obj), n) == SAVE_POINTER); |
| 1880 | return XSAVE_VALUE (obj)->data[n].pointer; |
| 1881 | } |
| 1882 | LISP_INLINE void |
| 1883 | set_save_pointer (Lisp_Object obj, int n, void *val) |
| 1884 | { |
| 1885 | eassert (save_type (XSAVE_VALUE (obj), n) == SAVE_POINTER); |
| 1886 | XSAVE_VALUE (obj)->data[n].pointer = val; |
| 1887 | } |
| 1888 | LISP_INLINE voidfuncptr |
| 1889 | XSAVE_FUNCPOINTER (Lisp_Object obj, int n) |
| 1890 | { |
| 1891 | eassert (save_type (XSAVE_VALUE (obj), n) == SAVE_FUNCPOINTER); |
| 1892 | return XSAVE_VALUE (obj)->data[n].funcpointer; |
| 1893 | } |
| 1894 | |
| 1895 | /* Likewise for the saved integer. */ |
| 1896 | |
| 1897 | LISP_INLINE ptrdiff_t |
| 1898 | XSAVE_INTEGER (Lisp_Object obj, int n) |
| 1899 | { |
| 1900 | eassert (save_type (XSAVE_VALUE (obj), n) == SAVE_INTEGER); |
| 1901 | return XSAVE_VALUE (obj)->data[n].integer; |
| 1902 | } |
| 1903 | LISP_INLINE void |
| 1904 | set_save_integer (Lisp_Object obj, int n, ptrdiff_t val) |
| 1905 | { |
| 1906 | eassert (save_type (XSAVE_VALUE (obj), n) == SAVE_INTEGER); |
| 1907 | XSAVE_VALUE (obj)->data[n].integer = val; |
| 1908 | } |
| 1909 | |
| 1910 | /* Extract Nth saved object. */ |
| 1911 | |
| 1912 | LISP_INLINE Lisp_Object |
| 1913 | XSAVE_OBJECT (Lisp_Object obj, int n) |
| 1914 | { |
| 1915 | eassert (save_type (XSAVE_VALUE (obj), n) == SAVE_OBJECT); |
| 1916 | return XSAVE_VALUE (obj)->data[n].object; |
| 1917 | } |
| 1918 | |
| 1919 | /* A miscellaneous object, when it's on the free list. */ |
| 1920 | struct Lisp_Free |
| 1921 | { |
| 1922 | ENUM_BF (Lisp_Misc_Type) type : 16; /* = Lisp_Misc_Free */ |
| 1923 | unsigned gcmarkbit : 1; |
| 1924 | int spacer : 15; |
| 1925 | union Lisp_Misc *chain; |
| 1926 | }; |
| 1927 | |
| 1928 | /* To get the type field of a union Lisp_Misc, use XMISCTYPE. |
| 1929 | It uses one of these struct subtypes to get the type field. */ |
| 1930 | |
| 1931 | union Lisp_Misc |
| 1932 | { |
| 1933 | struct Lisp_Misc_Any u_any; /* Supertype of all Misc types. */ |
| 1934 | struct Lisp_Free u_free; |
| 1935 | struct Lisp_Marker u_marker; |
| 1936 | struct Lisp_Overlay u_overlay; |
| 1937 | struct Lisp_Save_Value u_save_value; |
| 1938 | }; |
| 1939 | |
| 1940 | LISP_INLINE union Lisp_Misc * |
| 1941 | XMISC (Lisp_Object a) |
| 1942 | { |
| 1943 | return XUNTAG (a, Lisp_Misc); |
| 1944 | } |
| 1945 | |
| 1946 | LISP_INLINE struct Lisp_Misc_Any * |
| 1947 | XMISCANY (Lisp_Object a) |
| 1948 | { |
| 1949 | eassert (MISCP (a)); |
| 1950 | return & XMISC (a)->u_any; |
| 1951 | } |
| 1952 | |
| 1953 | LISP_INLINE enum Lisp_Misc_Type |
| 1954 | XMISCTYPE (Lisp_Object a) |
| 1955 | { |
| 1956 | return XMISCANY (a)->type; |
| 1957 | } |
| 1958 | |
| 1959 | LISP_INLINE struct Lisp_Marker * |
| 1960 | XMARKER (Lisp_Object a) |
| 1961 | { |
| 1962 | eassert (MARKERP (a)); |
| 1963 | return & XMISC (a)->u_marker; |
| 1964 | } |
| 1965 | |
| 1966 | LISP_INLINE struct Lisp_Overlay * |
| 1967 | XOVERLAY (Lisp_Object a) |
| 1968 | { |
| 1969 | eassert (OVERLAYP (a)); |
| 1970 | return & XMISC (a)->u_overlay; |
| 1971 | } |
| 1972 | |
| 1973 | LISP_INLINE struct Lisp_Save_Value * |
| 1974 | XSAVE_VALUE (Lisp_Object a) |
| 1975 | { |
| 1976 | eassert (SAVE_VALUEP (a)); |
| 1977 | return & XMISC (a)->u_save_value; |
| 1978 | } |
| 1979 | \f |
| 1980 | /* Forwarding pointer to an int variable. |
| 1981 | This is allowed only in the value cell of a symbol, |
| 1982 | and it means that the symbol's value really lives in the |
| 1983 | specified int variable. */ |
| 1984 | struct Lisp_Intfwd |
| 1985 | { |
| 1986 | enum Lisp_Fwd_Type type; /* = Lisp_Fwd_Int */ |
| 1987 | EMACS_INT *intvar; |
| 1988 | }; |
| 1989 | |
| 1990 | /* Boolean forwarding pointer to an int variable. |
| 1991 | This is like Lisp_Intfwd except that the ostensible |
| 1992 | "value" of the symbol is t if the int variable is nonzero, |
| 1993 | nil if it is zero. */ |
| 1994 | struct Lisp_Boolfwd |
| 1995 | { |
| 1996 | enum Lisp_Fwd_Type type; /* = Lisp_Fwd_Bool */ |
| 1997 | bool *boolvar; |
| 1998 | }; |
| 1999 | |
| 2000 | /* Forwarding pointer to a Lisp_Object variable. |
| 2001 | This is allowed only in the value cell of a symbol, |
| 2002 | and it means that the symbol's value really lives in the |
| 2003 | specified variable. */ |
| 2004 | struct Lisp_Objfwd |
| 2005 | { |
| 2006 | enum Lisp_Fwd_Type type; /* = Lisp_Fwd_Obj */ |
| 2007 | Lisp_Object *objvar; |
| 2008 | }; |
| 2009 | |
| 2010 | /* Like Lisp_Objfwd except that value lives in a slot in the |
| 2011 | current buffer. Value is byte index of slot within buffer. */ |
| 2012 | struct Lisp_Buffer_Objfwd |
| 2013 | { |
| 2014 | enum Lisp_Fwd_Type type; /* = Lisp_Fwd_Buffer_Obj */ |
| 2015 | int offset; |
| 2016 | /* One of Qnil, Qintegerp, Qsymbolp, Qstringp, Qfloatp or Qnumberp. */ |
| 2017 | Lisp_Object predicate; |
| 2018 | }; |
| 2019 | |
| 2020 | /* struct Lisp_Buffer_Local_Value is used in a symbol value cell when |
| 2021 | the symbol has buffer-local or frame-local bindings. (Exception: |
| 2022 | some buffer-local variables are built-in, with their values stored |
| 2023 | in the buffer structure itself. They are handled differently, |
| 2024 | using struct Lisp_Buffer_Objfwd.) |
| 2025 | |
| 2026 | The `realvalue' slot holds the variable's current value, or a |
| 2027 | forwarding pointer to where that value is kept. This value is the |
| 2028 | one that corresponds to the loaded binding. To read or set the |
| 2029 | variable, you must first make sure the right binding is loaded; |
| 2030 | then you can access the value in (or through) `realvalue'. |
| 2031 | |
| 2032 | `buffer' and `frame' are the buffer and frame for which the loaded |
| 2033 | binding was found. If those have changed, to make sure the right |
| 2034 | binding is loaded it is necessary to find which binding goes with |
| 2035 | the current buffer and selected frame, then load it. To load it, |
| 2036 | first unload the previous binding, then copy the value of the new |
| 2037 | binding into `realvalue' (or through it). Also update |
| 2038 | LOADED-BINDING to point to the newly loaded binding. |
| 2039 | |
| 2040 | `local_if_set' indicates that merely setting the variable creates a |
| 2041 | local binding for the current buffer. Otherwise the latter, setting |
| 2042 | the variable does not do that; only make-local-variable does that. */ |
| 2043 | |
| 2044 | struct Lisp_Buffer_Local_Value |
| 2045 | { |
| 2046 | /* 1 means that merely setting the variable creates a local |
| 2047 | binding for the current buffer. */ |
| 2048 | unsigned int local_if_set : 1; |
| 2049 | /* 1 means this variable can have frame-local bindings, otherwise, it is |
| 2050 | can have buffer-local bindings. The two cannot be combined. */ |
| 2051 | unsigned int frame_local : 1; |
| 2052 | /* 1 means that the binding now loaded was found. |
| 2053 | Presumably equivalent to (defcell!=valcell). */ |
| 2054 | unsigned int found : 1; |
| 2055 | /* If non-NULL, a forwarding to the C var where it should also be set. */ |
| 2056 | union Lisp_Fwd *fwd; /* Should never be (Buffer|Kboard)_Objfwd. */ |
| 2057 | /* The buffer or frame for which the loaded binding was found. */ |
| 2058 | Lisp_Object where; |
| 2059 | /* A cons cell that holds the default value. It has the form |
| 2060 | (SYMBOL . DEFAULT-VALUE). */ |
| 2061 | Lisp_Object defcell; |
| 2062 | /* The cons cell from `where's parameter alist. |
| 2063 | It always has the form (SYMBOL . VALUE) |
| 2064 | Note that if `forward' is non-nil, VALUE may be out of date. |
| 2065 | Also if the currently loaded binding is the default binding, then |
| 2066 | this is `eq'ual to defcell. */ |
| 2067 | Lisp_Object valcell; |
| 2068 | }; |
| 2069 | |
| 2070 | /* Like Lisp_Objfwd except that value lives in a slot in the |
| 2071 | current kboard. */ |
| 2072 | struct Lisp_Kboard_Objfwd |
| 2073 | { |
| 2074 | enum Lisp_Fwd_Type type; /* = Lisp_Fwd_Kboard_Obj */ |
| 2075 | int offset; |
| 2076 | }; |
| 2077 | |
| 2078 | union Lisp_Fwd |
| 2079 | { |
| 2080 | struct Lisp_Intfwd u_intfwd; |
| 2081 | struct Lisp_Boolfwd u_boolfwd; |
| 2082 | struct Lisp_Objfwd u_objfwd; |
| 2083 | struct Lisp_Buffer_Objfwd u_buffer_objfwd; |
| 2084 | struct Lisp_Kboard_Objfwd u_kboard_objfwd; |
| 2085 | }; |
| 2086 | |
| 2087 | LISP_INLINE enum Lisp_Fwd_Type |
| 2088 | XFWDTYPE (union Lisp_Fwd *a) |
| 2089 | { |
| 2090 | return a->u_intfwd.type; |
| 2091 | } |
| 2092 | |
| 2093 | LISP_INLINE struct Lisp_Buffer_Objfwd * |
| 2094 | XBUFFER_OBJFWD (union Lisp_Fwd *a) |
| 2095 | { |
| 2096 | eassert (BUFFER_OBJFWDP (a)); |
| 2097 | return &a->u_buffer_objfwd; |
| 2098 | } |
| 2099 | \f |
| 2100 | /* Lisp floating point type. */ |
| 2101 | struct Lisp_Float |
| 2102 | { |
| 2103 | union |
| 2104 | { |
| 2105 | double data; |
| 2106 | struct Lisp_Float *chain; |
| 2107 | } u; |
| 2108 | }; |
| 2109 | |
| 2110 | LISP_INLINE double |
| 2111 | XFLOAT_DATA (Lisp_Object f) |
| 2112 | { |
| 2113 | return XFLOAT (f)->u.data; |
| 2114 | } |
| 2115 | |
| 2116 | /* Most hosts nowadays use IEEE floating point, so they use IEC 60559 |
| 2117 | representations, have infinities and NaNs, and do not trap on |
| 2118 | exceptions. Define IEEE_FLOATING_POINT if this host is one of the |
| 2119 | typical ones. The C11 macro __STDC_IEC_559__ is close to what is |
| 2120 | wanted here, but is not quite right because Emacs does not require |
| 2121 | all the features of C11 Annex F (and does not require C11 at all, |
| 2122 | for that matter). */ |
| 2123 | enum |
| 2124 | { |
| 2125 | IEEE_FLOATING_POINT |
| 2126 | = (FLT_RADIX == 2 && FLT_MANT_DIG == 24 |
| 2127 | && FLT_MIN_EXP == -125 && FLT_MAX_EXP == 128) |
| 2128 | }; |
| 2129 | |
| 2130 | /* A character, declared with the following typedef, is a member |
| 2131 | of some character set associated with the current buffer. */ |
| 2132 | #ifndef _UCHAR_T /* Protect against something in ctab.h on AIX. */ |
| 2133 | #define _UCHAR_T |
| 2134 | typedef unsigned char UCHAR; |
| 2135 | #endif |
| 2136 | |
| 2137 | /* Meanings of slots in a Lisp_Compiled: */ |
| 2138 | |
| 2139 | enum Lisp_Compiled |
| 2140 | { |
| 2141 | COMPILED_ARGLIST = 0, |
| 2142 | COMPILED_BYTECODE = 1, |
| 2143 | COMPILED_CONSTANTS = 2, |
| 2144 | COMPILED_STACK_DEPTH = 3, |
| 2145 | COMPILED_DOC_STRING = 4, |
| 2146 | COMPILED_INTERACTIVE = 5 |
| 2147 | }; |
| 2148 | |
| 2149 | /* Flag bits in a character. These also get used in termhooks.h. |
| 2150 | Richard Stallman <rms@gnu.ai.mit.edu> thinks that MULE |
| 2151 | (MUlti-Lingual Emacs) might need 22 bits for the character value |
| 2152 | itself, so we probably shouldn't use any bits lower than 0x0400000. */ |
| 2153 | enum char_bits |
| 2154 | { |
| 2155 | CHAR_ALT = 0x0400000, |
| 2156 | CHAR_SUPER = 0x0800000, |
| 2157 | CHAR_HYPER = 0x1000000, |
| 2158 | CHAR_SHIFT = 0x2000000, |
| 2159 | CHAR_CTL = 0x4000000, |
| 2160 | CHAR_META = 0x8000000, |
| 2161 | |
| 2162 | CHAR_MODIFIER_MASK = |
| 2163 | CHAR_ALT | CHAR_SUPER | CHAR_HYPER | CHAR_SHIFT | CHAR_CTL | CHAR_META, |
| 2164 | |
| 2165 | /* Actually, the current Emacs uses 22 bits for the character value |
| 2166 | itself. */ |
| 2167 | CHARACTERBITS = 22 |
| 2168 | }; |
| 2169 | \f |
| 2170 | /* Structure to hold mouse highlight data. This is here because other |
| 2171 | header files need it for defining struct x_output etc. */ |
| 2172 | typedef struct { |
| 2173 | /* These variables describe the range of text currently shown in its |
| 2174 | mouse-face, together with the window they apply to. As long as |
| 2175 | the mouse stays within this range, we need not redraw anything on |
| 2176 | its account. Rows and columns are glyph matrix positions in |
| 2177 | MOUSE_FACE_WINDOW. */ |
| 2178 | int mouse_face_beg_row, mouse_face_beg_col; |
| 2179 | int mouse_face_beg_x, mouse_face_beg_y; |
| 2180 | int mouse_face_end_row, mouse_face_end_col; |
| 2181 | int mouse_face_end_x, mouse_face_end_y; |
| 2182 | Lisp_Object mouse_face_window; |
| 2183 | int mouse_face_face_id; |
| 2184 | Lisp_Object mouse_face_overlay; |
| 2185 | |
| 2186 | /* FRAME and X, Y position of mouse when last checked for |
| 2187 | highlighting. X and Y can be negative or out of range for the frame. */ |
| 2188 | struct frame *mouse_face_mouse_frame; |
| 2189 | int mouse_face_mouse_x, mouse_face_mouse_y; |
| 2190 | |
| 2191 | /* Nonzero if part of the text currently shown in |
| 2192 | its mouse-face is beyond the window end. */ |
| 2193 | unsigned mouse_face_past_end : 1; |
| 2194 | |
| 2195 | /* Nonzero means defer mouse-motion highlighting. */ |
| 2196 | unsigned mouse_face_defer : 1; |
| 2197 | |
| 2198 | /* Nonzero means that the mouse highlight should not be shown. */ |
| 2199 | unsigned mouse_face_hidden : 1; |
| 2200 | } Mouse_HLInfo; |
| 2201 | \f |
| 2202 | /* Data type checking. */ |
| 2203 | |
| 2204 | LISP_MACRO_DEFUN (NILP, bool, (Lisp_Object x), (x)) |
| 2205 | |
| 2206 | LISP_INLINE bool |
| 2207 | NUMBERP (Lisp_Object x) |
| 2208 | { |
| 2209 | return INTEGERP (x) || FLOATP (x); |
| 2210 | } |
| 2211 | LISP_INLINE bool |
| 2212 | NATNUMP (Lisp_Object x) |
| 2213 | { |
| 2214 | return INTEGERP (x) && 0 <= XINT (x); |
| 2215 | } |
| 2216 | |
| 2217 | LISP_INLINE bool |
| 2218 | RANGED_INTEGERP (intmax_t lo, Lisp_Object x, intmax_t hi) |
| 2219 | { |
| 2220 | return INTEGERP (x) && lo <= XINT (x) && XINT (x) <= hi; |
| 2221 | } |
| 2222 | |
| 2223 | #define TYPE_RANGED_INTEGERP(type, x) \ |
| 2224 | (INTEGERP (x) \ |
| 2225 | && (TYPE_SIGNED (type) ? TYPE_MINIMUM (type) <= XINT (x) : 0 <= XINT (x)) \ |
| 2226 | && XINT (x) <= TYPE_MAXIMUM (type)) |
| 2227 | |
| 2228 | LISP_MACRO_DEFUN (CONSP, bool, (Lisp_Object x), (x)) |
| 2229 | LISP_MACRO_DEFUN (FLOATP, bool, (Lisp_Object x), (x)) |
| 2230 | LISP_MACRO_DEFUN (MISCP, bool, (Lisp_Object x), (x)) |
| 2231 | LISP_MACRO_DEFUN (SYMBOLP, bool, (Lisp_Object x), (x)) |
| 2232 | LISP_MACRO_DEFUN (INTEGERP, bool, (Lisp_Object x), (x)) |
| 2233 | LISP_MACRO_DEFUN (VECTORLIKEP, bool, (Lisp_Object x), (x)) |
| 2234 | LISP_MACRO_DEFUN (MARKERP, bool, (Lisp_Object x), (x)) |
| 2235 | |
| 2236 | LISP_INLINE bool |
| 2237 | STRINGP (Lisp_Object x) |
| 2238 | { |
| 2239 | return XTYPE (x) == Lisp_String; |
| 2240 | } |
| 2241 | LISP_INLINE bool |
| 2242 | VECTORP (Lisp_Object x) |
| 2243 | { |
| 2244 | return VECTORLIKEP (x) && ! (ASIZE (x) & PSEUDOVECTOR_FLAG); |
| 2245 | } |
| 2246 | LISP_INLINE bool |
| 2247 | OVERLAYP (Lisp_Object x) |
| 2248 | { |
| 2249 | return MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Overlay; |
| 2250 | } |
| 2251 | LISP_INLINE bool |
| 2252 | SAVE_VALUEP (Lisp_Object x) |
| 2253 | { |
| 2254 | return MISCP (x) && XMISCTYPE (x) == Lisp_Misc_Save_Value; |
| 2255 | } |
| 2256 | |
| 2257 | LISP_INLINE bool |
| 2258 | AUTOLOADP (Lisp_Object x) |
| 2259 | { |
| 2260 | return CONSP (x) && EQ (Qautoload, XCAR (x)); |
| 2261 | } |
| 2262 | |
| 2263 | LISP_INLINE bool |
| 2264 | BUFFER_OBJFWDP (union Lisp_Fwd *a) |
| 2265 | { |
| 2266 | return XFWDTYPE (a) == Lisp_Fwd_Buffer_Obj; |
| 2267 | } |
| 2268 | |
| 2269 | LISP_INLINE bool |
| 2270 | PSEUDOVECTOR_TYPEP (struct vectorlike_header *a, int code) |
| 2271 | { |
| 2272 | return ((a->size & (PSEUDOVECTOR_FLAG | PVEC_TYPE_MASK)) |
| 2273 | == (PSEUDOVECTOR_FLAG | (code << PSEUDOVECTOR_AREA_BITS))); |
| 2274 | } |
| 2275 | |
| 2276 | /* True if A is a pseudovector whose code is CODE. */ |
| 2277 | LISP_INLINE bool |
| 2278 | PSEUDOVECTORP (Lisp_Object a, int code) |
| 2279 | { |
| 2280 | if (! VECTORLIKEP (a)) |
| 2281 | return 0; |
| 2282 | else |
| 2283 | { |
| 2284 | /* Converting to struct vectorlike_header * avoids aliasing issues. */ |
| 2285 | struct vectorlike_header *h = XUNTAG (a, Lisp_Vectorlike); |
| 2286 | return PSEUDOVECTOR_TYPEP (h, code); |
| 2287 | } |
| 2288 | } |
| 2289 | |
| 2290 | |
| 2291 | /* Test for specific pseudovector types. */ |
| 2292 | |
| 2293 | LISP_INLINE bool |
| 2294 | WINDOW_CONFIGURATIONP (Lisp_Object a) |
| 2295 | { |
| 2296 | return PSEUDOVECTORP (a, PVEC_WINDOW_CONFIGURATION); |
| 2297 | } |
| 2298 | |
| 2299 | LISP_INLINE bool |
| 2300 | PROCESSP (Lisp_Object a) |
| 2301 | { |
| 2302 | return PSEUDOVECTORP (a, PVEC_PROCESS); |
| 2303 | } |
| 2304 | |
| 2305 | LISP_INLINE bool |
| 2306 | WINDOWP (Lisp_Object a) |
| 2307 | { |
| 2308 | return PSEUDOVECTORP (a, PVEC_WINDOW); |
| 2309 | } |
| 2310 | |
| 2311 | LISP_INLINE bool |
| 2312 | TERMINALP (Lisp_Object a) |
| 2313 | { |
| 2314 | return PSEUDOVECTORP (a, PVEC_TERMINAL); |
| 2315 | } |
| 2316 | |
| 2317 | LISP_INLINE bool |
| 2318 | SUBRP (Lisp_Object a) |
| 2319 | { |
| 2320 | return PSEUDOVECTORP (a, PVEC_SUBR); |
| 2321 | } |
| 2322 | |
| 2323 | LISP_INLINE bool |
| 2324 | COMPILEDP (Lisp_Object a) |
| 2325 | { |
| 2326 | return PSEUDOVECTORP (a, PVEC_COMPILED); |
| 2327 | } |
| 2328 | |
| 2329 | LISP_INLINE bool |
| 2330 | BUFFERP (Lisp_Object a) |
| 2331 | { |
| 2332 | return PSEUDOVECTORP (a, PVEC_BUFFER); |
| 2333 | } |
| 2334 | |
| 2335 | LISP_INLINE bool |
| 2336 | CHAR_TABLE_P (Lisp_Object a) |
| 2337 | { |
| 2338 | return PSEUDOVECTORP (a, PVEC_CHAR_TABLE); |
| 2339 | } |
| 2340 | |
| 2341 | LISP_INLINE bool |
| 2342 | SUB_CHAR_TABLE_P (Lisp_Object a) |
| 2343 | { |
| 2344 | return PSEUDOVECTORP (a, PVEC_SUB_CHAR_TABLE); |
| 2345 | } |
| 2346 | |
| 2347 | LISP_INLINE bool |
| 2348 | BOOL_VECTOR_P (Lisp_Object a) |
| 2349 | { |
| 2350 | return PSEUDOVECTORP (a, PVEC_BOOL_VECTOR); |
| 2351 | } |
| 2352 | |
| 2353 | LISP_INLINE bool |
| 2354 | FRAMEP (Lisp_Object a) |
| 2355 | { |
| 2356 | return PSEUDOVECTORP (a, PVEC_FRAME); |
| 2357 | } |
| 2358 | |
| 2359 | /* Test for image (image . spec) */ |
| 2360 | LISP_INLINE bool |
| 2361 | IMAGEP (Lisp_Object x) |
| 2362 | { |
| 2363 | return CONSP (x) && EQ (XCAR (x), Qimage); |
| 2364 | } |
| 2365 | |
| 2366 | /* Array types. */ |
| 2367 | LISP_INLINE bool |
| 2368 | ARRAYP (Lisp_Object x) |
| 2369 | { |
| 2370 | return VECTORP (x) || STRINGP (x) || CHAR_TABLE_P (x) || BOOL_VECTOR_P (x); |
| 2371 | } |
| 2372 | \f |
| 2373 | LISP_INLINE void |
| 2374 | CHECK_LIST (Lisp_Object x) |
| 2375 | { |
| 2376 | CHECK_TYPE (CONSP (x) || NILP (x), Qlistp, x); |
| 2377 | } |
| 2378 | |
| 2379 | LISP_MACRO_DEFUN_VOID (CHECK_LIST_CONS, (Lisp_Object x, Lisp_Object y), (x, y)) |
| 2380 | LISP_MACRO_DEFUN_VOID (CHECK_SYMBOL, (Lisp_Object x), (x)) |
| 2381 | LISP_MACRO_DEFUN_VOID (CHECK_NUMBER, (Lisp_Object x), (x)) |
| 2382 | |
| 2383 | LISP_INLINE void |
| 2384 | CHECK_STRING (Lisp_Object x) |
| 2385 | { |
| 2386 | CHECK_TYPE (STRINGP (x), Qstringp, x); |
| 2387 | } |
| 2388 | LISP_INLINE void |
| 2389 | CHECK_STRING_CAR (Lisp_Object x) |
| 2390 | { |
| 2391 | CHECK_TYPE (STRINGP (XCAR (x)), Qstringp, XCAR (x)); |
| 2392 | } |
| 2393 | LISP_INLINE void |
| 2394 | CHECK_CONS (Lisp_Object x) |
| 2395 | { |
| 2396 | CHECK_TYPE (CONSP (x), Qconsp, x); |
| 2397 | } |
| 2398 | LISP_INLINE void |
| 2399 | CHECK_VECTOR (Lisp_Object x) |
| 2400 | { |
| 2401 | CHECK_TYPE (VECTORP (x), Qvectorp, x); |
| 2402 | } |
| 2403 | LISP_INLINE void |
| 2404 | CHECK_VECTOR_OR_STRING (Lisp_Object x) |
| 2405 | { |
| 2406 | CHECK_TYPE (VECTORP (x) || STRINGP (x), Qarrayp, x); |
| 2407 | } |
| 2408 | LISP_INLINE void |
| 2409 | CHECK_ARRAY (Lisp_Object x, Lisp_Object Qxxxp) |
| 2410 | { |
| 2411 | CHECK_TYPE (ARRAYP (x), Qxxxp, x); |
| 2412 | } |
| 2413 | LISP_INLINE void |
| 2414 | CHECK_BUFFER (Lisp_Object x) |
| 2415 | { |
| 2416 | CHECK_TYPE (BUFFERP (x), Qbufferp, x); |
| 2417 | } |
| 2418 | LISP_INLINE void |
| 2419 | CHECK_WINDOW (Lisp_Object x) |
| 2420 | { |
| 2421 | CHECK_TYPE (WINDOWP (x), Qwindowp, x); |
| 2422 | } |
| 2423 | LISP_INLINE void |
| 2424 | CHECK_PROCESS (Lisp_Object x) |
| 2425 | { |
| 2426 | CHECK_TYPE (PROCESSP (x), Qprocessp, x); |
| 2427 | } |
| 2428 | LISP_INLINE void |
| 2429 | CHECK_NATNUM (Lisp_Object x) |
| 2430 | { |
| 2431 | CHECK_TYPE (NATNUMP (x), Qwholenump, x); |
| 2432 | } |
| 2433 | |
| 2434 | #define CHECK_RANGED_INTEGER(x, lo, hi) \ |
| 2435 | do { \ |
| 2436 | CHECK_NUMBER (x); \ |
| 2437 | if (! ((lo) <= XINT (x) && XINT (x) <= (hi))) \ |
| 2438 | args_out_of_range_3 \ |
| 2439 | (x, \ |
| 2440 | make_number ((lo) < 0 && (lo) < MOST_NEGATIVE_FIXNUM \ |
| 2441 | ? MOST_NEGATIVE_FIXNUM \ |
| 2442 | : (lo)), \ |
| 2443 | make_number (min (hi, MOST_POSITIVE_FIXNUM))); \ |
| 2444 | } while (0) |
| 2445 | #define CHECK_TYPE_RANGED_INTEGER(type, x) \ |
| 2446 | do { \ |
| 2447 | if (TYPE_SIGNED (type)) \ |
| 2448 | CHECK_RANGED_INTEGER (x, TYPE_MINIMUM (type), TYPE_MAXIMUM (type)); \ |
| 2449 | else \ |
| 2450 | CHECK_RANGED_INTEGER (x, 0, TYPE_MAXIMUM (type)); \ |
| 2451 | } while (0) |
| 2452 | |
| 2453 | #define CHECK_NUMBER_COERCE_MARKER(x) \ |
| 2454 | do { if (MARKERP ((x))) XSETFASTINT (x, marker_position (x)); \ |
| 2455 | else CHECK_TYPE (INTEGERP (x), Qinteger_or_marker_p, x); } while (0) |
| 2456 | |
| 2457 | LISP_INLINE double |
| 2458 | XFLOATINT (Lisp_Object n) |
| 2459 | { |
| 2460 | return extract_float (n); |
| 2461 | } |
| 2462 | |
| 2463 | LISP_INLINE void |
| 2464 | CHECK_NUMBER_OR_FLOAT (Lisp_Object x) |
| 2465 | { |
| 2466 | CHECK_TYPE (FLOATP (x) || INTEGERP (x), Qnumberp, x); |
| 2467 | } |
| 2468 | |
| 2469 | #define CHECK_NUMBER_OR_FLOAT_COERCE_MARKER(x) \ |
| 2470 | do { if (MARKERP (x)) XSETFASTINT (x, marker_position (x)); \ |
| 2471 | else CHECK_TYPE (INTEGERP (x) || FLOATP (x), Qnumber_or_marker_p, x); } while (0) |
| 2472 | |
| 2473 | /* Since we can't assign directly to the CAR or CDR fields of a cons |
| 2474 | cell, use these when checking that those fields contain numbers. */ |
| 2475 | LISP_INLINE void |
| 2476 | CHECK_NUMBER_CAR (Lisp_Object x) |
| 2477 | { |
| 2478 | Lisp_Object tmp = XCAR (x); |
| 2479 | CHECK_NUMBER (tmp); |
| 2480 | XSETCAR (x, tmp); |
| 2481 | } |
| 2482 | |
| 2483 | LISP_INLINE void |
| 2484 | CHECK_NUMBER_CDR (Lisp_Object x) |
| 2485 | { |
| 2486 | Lisp_Object tmp = XCDR (x); |
| 2487 | CHECK_NUMBER (tmp); |
| 2488 | XSETCDR (x, tmp); |
| 2489 | } |
| 2490 | \f |
| 2491 | /* Define a built-in function for calling from Lisp. |
| 2492 | `lname' should be the name to give the function in Lisp, |
| 2493 | as a null-terminated C string. |
| 2494 | `fnname' should be the name of the function in C. |
| 2495 | By convention, it starts with F. |
| 2496 | `sname' should be the name for the C constant structure |
| 2497 | that records information on this function for internal use. |
| 2498 | By convention, it should be the same as `fnname' but with S instead of F. |
| 2499 | It's too bad that C macros can't compute this from `fnname'. |
| 2500 | `minargs' should be a number, the minimum number of arguments allowed. |
| 2501 | `maxargs' should be a number, the maximum number of arguments allowed, |
| 2502 | or else MANY or UNEVALLED. |
| 2503 | MANY means pass a vector of evaluated arguments, |
| 2504 | in the form of an integer number-of-arguments |
| 2505 | followed by the address of a vector of Lisp_Objects |
| 2506 | which contains the argument values. |
| 2507 | UNEVALLED means pass the list of unevaluated arguments |
| 2508 | `intspec' says how interactive arguments are to be fetched. |
| 2509 | If the string starts with a `(', `intspec' is evaluated and the resulting |
| 2510 | list is the list of arguments. |
| 2511 | If it's a string that doesn't start with `(', the value should follow |
| 2512 | the one of the doc string for `interactive'. |
| 2513 | A null string means call interactively with no arguments. |
| 2514 | `doc' is documentation for the user. */ |
| 2515 | |
| 2516 | /* This version of DEFUN declares a function prototype with the right |
| 2517 | arguments, so we can catch errors with maxargs at compile-time. */ |
| 2518 | #ifdef _MSC_VER |
| 2519 | #define DEFUN(lname, fnname, sname, minargs, maxargs, intspec, doc) \ |
| 2520 | Lisp_Object fnname DEFUN_ARGS_ ## maxargs ; \ |
| 2521 | static struct Lisp_Subr alignas (GCALIGNMENT) sname = \ |
| 2522 | { { (PVEC_SUBR << PSEUDOVECTOR_AREA_BITS) \ |
| 2523 | | (sizeof (struct Lisp_Subr) / sizeof (EMACS_INT)) }, \ |
| 2524 | { (Lisp_Object (__cdecl *)(void))fnname }, \ |
| 2525 | minargs, maxargs, lname, intspec, 0}; \ |
| 2526 | Lisp_Object fnname |
| 2527 | #else /* not _MSC_VER */ |
| 2528 | # if __STDC_VERSION__ < 199901 |
| 2529 | # define DEFUN_FUNCTION_INIT(fnname, maxargs) (Lisp_Object (*) (void)) fnname |
| 2530 | # else |
| 2531 | # define DEFUN_FUNCTION_INIT(fnname, maxargs) .a ## maxargs = fnname |
| 2532 | # endif |
| 2533 | #define DEFUN(lname, fnname, sname, minargs, maxargs, intspec, doc) \ |
| 2534 | Lisp_Object fnname DEFUN_ARGS_ ## maxargs ; \ |
| 2535 | static struct Lisp_Subr alignas (GCALIGNMENT) sname = \ |
| 2536 | { { PVEC_SUBR << PSEUDOVECTOR_AREA_BITS }, \ |
| 2537 | { DEFUN_FUNCTION_INIT (fnname, maxargs) }, \ |
| 2538 | minargs, maxargs, lname, intspec, 0}; \ |
| 2539 | Lisp_Object fnname |
| 2540 | #endif |
| 2541 | |
| 2542 | /* Note that the weird token-substitution semantics of ANSI C makes |
| 2543 | this work for MANY and UNEVALLED. */ |
| 2544 | #define DEFUN_ARGS_MANY (ptrdiff_t, Lisp_Object *) |
| 2545 | #define DEFUN_ARGS_UNEVALLED (Lisp_Object) |
| 2546 | #define DEFUN_ARGS_0 (void) |
| 2547 | #define DEFUN_ARGS_1 (Lisp_Object) |
| 2548 | #define DEFUN_ARGS_2 (Lisp_Object, Lisp_Object) |
| 2549 | #define DEFUN_ARGS_3 (Lisp_Object, Lisp_Object, Lisp_Object) |
| 2550 | #define DEFUN_ARGS_4 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object) |
| 2551 | #define DEFUN_ARGS_5 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \ |
| 2552 | Lisp_Object) |
| 2553 | #define DEFUN_ARGS_6 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \ |
| 2554 | Lisp_Object, Lisp_Object) |
| 2555 | #define DEFUN_ARGS_7 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \ |
| 2556 | Lisp_Object, Lisp_Object, Lisp_Object) |
| 2557 | #define DEFUN_ARGS_8 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, \ |
| 2558 | Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object) |
| 2559 | |
| 2560 | /* True if OBJ is a Lisp function. */ |
| 2561 | LISP_INLINE bool |
| 2562 | FUNCTIONP (Lisp_Object obj) |
| 2563 | { |
| 2564 | return functionp (obj); |
| 2565 | } |
| 2566 | |
| 2567 | /* defsubr (Sname); |
| 2568 | is how we define the symbol for function `name' at start-up time. */ |
| 2569 | extern void defsubr (struct Lisp_Subr *); |
| 2570 | |
| 2571 | enum maxargs |
| 2572 | { |
| 2573 | MANY = -2, |
| 2574 | UNEVALLED = -1 |
| 2575 | }; |
| 2576 | |
| 2577 | extern void defvar_lisp (struct Lisp_Objfwd *, const char *, Lisp_Object *); |
| 2578 | extern void defvar_lisp_nopro (struct Lisp_Objfwd *, const char *, Lisp_Object *); |
| 2579 | extern void defvar_bool (struct Lisp_Boolfwd *, const char *, bool *); |
| 2580 | extern void defvar_int (struct Lisp_Intfwd *, const char *, EMACS_INT *); |
| 2581 | extern void defvar_kboard (struct Lisp_Kboard_Objfwd *, const char *, int); |
| 2582 | |
| 2583 | /* Macros we use to define forwarded Lisp variables. |
| 2584 | These are used in the syms_of_FILENAME functions. |
| 2585 | |
| 2586 | An ordinary (not in buffer_defaults, per-buffer, or per-keyboard) |
| 2587 | lisp variable is actually a field in `struct emacs_globals'. The |
| 2588 | field's name begins with "f_", which is a convention enforced by |
| 2589 | these macros. Each such global has a corresponding #define in |
| 2590 | globals.h; the plain name should be used in the code. |
| 2591 | |
| 2592 | E.g., the global "cons_cells_consed" is declared as "int |
| 2593 | f_cons_cells_consed" in globals.h, but there is a define: |
| 2594 | |
| 2595 | #define cons_cells_consed globals.f_cons_cells_consed |
| 2596 | |
| 2597 | All C code uses the `cons_cells_consed' name. This is all done |
| 2598 | this way to support indirection for multi-threaded Emacs. */ |
| 2599 | |
| 2600 | #define DEFVAR_LISP(lname, vname, doc) \ |
| 2601 | do { \ |
| 2602 | static struct Lisp_Objfwd o_fwd; \ |
| 2603 | defvar_lisp (&o_fwd, lname, &globals.f_ ## vname); \ |
| 2604 | } while (0) |
| 2605 | #define DEFVAR_LISP_NOPRO(lname, vname, doc) \ |
| 2606 | do { \ |
| 2607 | static struct Lisp_Objfwd o_fwd; \ |
| 2608 | defvar_lisp_nopro (&o_fwd, lname, &globals.f_ ## vname); \ |
| 2609 | } while (0) |
| 2610 | #define DEFVAR_BOOL(lname, vname, doc) \ |
| 2611 | do { \ |
| 2612 | static struct Lisp_Boolfwd b_fwd; \ |
| 2613 | defvar_bool (&b_fwd, lname, &globals.f_ ## vname); \ |
| 2614 | } while (0) |
| 2615 | #define DEFVAR_INT(lname, vname, doc) \ |
| 2616 | do { \ |
| 2617 | static struct Lisp_Intfwd i_fwd; \ |
| 2618 | defvar_int (&i_fwd, lname, &globals.f_ ## vname); \ |
| 2619 | } while (0) |
| 2620 | |
| 2621 | #define DEFVAR_BUFFER_DEFAULTS(lname, vname, doc) \ |
| 2622 | do { \ |
| 2623 | static struct Lisp_Objfwd o_fwd; \ |
| 2624 | defvar_lisp_nopro (&o_fwd, lname, &BVAR (&buffer_defaults, vname)); \ |
| 2625 | } while (0) |
| 2626 | |
| 2627 | #define DEFVAR_KBOARD(lname, vname, doc) \ |
| 2628 | do { \ |
| 2629 | static struct Lisp_Kboard_Objfwd ko_fwd; \ |
| 2630 | defvar_kboard (&ko_fwd, lname, offsetof (KBOARD, vname ## _)); \ |
| 2631 | } while (0) |
| 2632 | \f |
| 2633 | /* Save and restore the instruction and environment pointers, |
| 2634 | without affecting the signal mask. */ |
| 2635 | |
| 2636 | #ifdef HAVE__SETJMP |
| 2637 | typedef jmp_buf sys_jmp_buf; |
| 2638 | # define sys_setjmp(j) _setjmp (j) |
| 2639 | # define sys_longjmp(j, v) _longjmp (j, v) |
| 2640 | #elif defined HAVE_SIGSETJMP |
| 2641 | typedef sigjmp_buf sys_jmp_buf; |
| 2642 | # define sys_setjmp(j) sigsetjmp (j, 0) |
| 2643 | # define sys_longjmp(j, v) siglongjmp (j, v) |
| 2644 | #else |
| 2645 | /* A platform that uses neither _longjmp nor siglongjmp; assume |
| 2646 | longjmp does not affect the sigmask. */ |
| 2647 | typedef jmp_buf sys_jmp_buf; |
| 2648 | # define sys_setjmp(j) setjmp (j) |
| 2649 | # define sys_longjmp(j, v) longjmp (j, v) |
| 2650 | #endif |
| 2651 | |
| 2652 | \f |
| 2653 | /* Elisp uses several stacks: |
| 2654 | - the C stack. |
| 2655 | - the bytecode stack: used internally by the bytecode interpreter. |
| 2656 | Allocated from the C stack. |
| 2657 | - The specpdl stack: keeps track of active unwind-protect and |
| 2658 | dynamic-let-bindings. Allocated from the `specpdl' array, a manually |
| 2659 | managed stack. |
| 2660 | - The catch stack: keeps track of active catch tags. |
| 2661 | Allocated on the C stack. This is where the setmp data is kept. |
| 2662 | - The handler stack: keeps track of active condition-case handlers. |
| 2663 | Allocated on the C stack. Every entry there also uses an entry in |
| 2664 | the catch stack. */ |
| 2665 | |
| 2666 | /* Structure for recording Lisp call stack for backtrace purposes. */ |
| 2667 | |
| 2668 | /* The special binding stack holds the outer values of variables while |
| 2669 | they are bound by a function application or a let form, stores the |
| 2670 | code to be executed for unwind-protect forms. |
| 2671 | |
| 2672 | If func is non-zero, undoing this binding applies func to old_value; |
| 2673 | This implements record_unwind_protect. |
| 2674 | |
| 2675 | Otherwise, the element is a variable binding. |
| 2676 | |
| 2677 | If the symbol field is a symbol, it is an ordinary variable binding. |
| 2678 | |
| 2679 | Otherwise, it should be a structure (SYMBOL WHERE . CURRENT-BUFFER), |
| 2680 | which means having bound a local value while CURRENT-BUFFER was active. |
| 2681 | If WHERE is nil this means we saw the default value when binding SYMBOL. |
| 2682 | WHERE being a buffer or frame means we saw a buffer-local or frame-local |
| 2683 | value. Other values of WHERE mean an internal error. |
| 2684 | |
| 2685 | NOTE: The specbinding union is defined here, because SPECPDL_INDEX is |
| 2686 | used all over the place, needs to be fast, and needs to know the size of |
| 2687 | union specbinding. But only eval.c should access it. */ |
| 2688 | |
| 2689 | enum specbind_tag { |
| 2690 | SPECPDL_UNWIND, /* An unwind_protect function on Lisp_Object. */ |
| 2691 | SPECPDL_UNWIND_PTR, /* Likewise, on void *. */ |
| 2692 | SPECPDL_UNWIND_INT, /* Likewise, on int. */ |
| 2693 | SPECPDL_UNWIND_VOID, /* Likewise, with no arg. */ |
| 2694 | SPECPDL_BACKTRACE, /* An element of the backtrace. */ |
| 2695 | SPECPDL_LET, /* A plain and simple dynamic let-binding. */ |
| 2696 | /* Tags greater than SPECPDL_LET must be "subkinds" of LET. */ |
| 2697 | SPECPDL_LET_LOCAL, /* A buffer-local let-binding. */ |
| 2698 | SPECPDL_LET_DEFAULT /* A global binding for a localized var. */ |
| 2699 | }; |
| 2700 | |
| 2701 | union specbinding |
| 2702 | { |
| 2703 | ENUM_BF (specbind_tag) kind : CHAR_BIT; |
| 2704 | struct { |
| 2705 | ENUM_BF (specbind_tag) kind : CHAR_BIT; |
| 2706 | void (*func) (Lisp_Object); |
| 2707 | Lisp_Object arg; |
| 2708 | } unwind; |
| 2709 | struct { |
| 2710 | ENUM_BF (specbind_tag) kind : CHAR_BIT; |
| 2711 | void (*func) (void *); |
| 2712 | void *arg; |
| 2713 | } unwind_ptr; |
| 2714 | struct { |
| 2715 | ENUM_BF (specbind_tag) kind : CHAR_BIT; |
| 2716 | void (*func) (int); |
| 2717 | int arg; |
| 2718 | } unwind_int; |
| 2719 | struct { |
| 2720 | ENUM_BF (specbind_tag) kind : CHAR_BIT; |
| 2721 | void (*func) (void); |
| 2722 | } unwind_void; |
| 2723 | struct { |
| 2724 | ENUM_BF (specbind_tag) kind : CHAR_BIT; |
| 2725 | /* `where' is not used in the case of SPECPDL_LET. */ |
| 2726 | Lisp_Object symbol, old_value, where; |
| 2727 | } let; |
| 2728 | struct { |
| 2729 | ENUM_BF (specbind_tag) kind : CHAR_BIT; |
| 2730 | bool debug_on_exit : 1; |
| 2731 | Lisp_Object function; |
| 2732 | Lisp_Object *args; |
| 2733 | ptrdiff_t nargs; |
| 2734 | } bt; |
| 2735 | }; |
| 2736 | |
| 2737 | extern union specbinding *specpdl; |
| 2738 | extern union specbinding *specpdl_ptr; |
| 2739 | extern ptrdiff_t specpdl_size; |
| 2740 | |
| 2741 | LISP_INLINE ptrdiff_t |
| 2742 | SPECPDL_INDEX (void) |
| 2743 | { |
| 2744 | return specpdl_ptr - specpdl; |
| 2745 | } |
| 2746 | |
| 2747 | LISP_INLINE void |
| 2748 | set_unwind_protect_ptr (ptrdiff_t count, void *arg) |
| 2749 | { |
| 2750 | specpdl[count].unwind_ptr.arg = arg; |
| 2751 | } |
| 2752 | |
| 2753 | LISP_INLINE void |
| 2754 | set_unwind_protect_int (ptrdiff_t count, int arg) |
| 2755 | { |
| 2756 | specpdl[count].unwind_int.arg = arg; |
| 2757 | } |
| 2758 | |
| 2759 | /* Everything needed to describe an active condition case. |
| 2760 | |
| 2761 | Members are volatile if their values need to survive _longjmp when |
| 2762 | a 'struct handler' is a local variable. */ |
| 2763 | struct handler |
| 2764 | { |
| 2765 | /* The handler clauses and variable from the condition-case form. */ |
| 2766 | /* For a handler set up in Lisp code, this is always a list. |
| 2767 | For an internal handler set up by internal_condition_case*, |
| 2768 | this can instead be the symbol t or `error'. |
| 2769 | t: handle all conditions. |
| 2770 | error: handle all conditions, and errors can run the debugger |
| 2771 | or display a backtrace. */ |
| 2772 | Lisp_Object handler; |
| 2773 | |
| 2774 | Lisp_Object volatile var; |
| 2775 | |
| 2776 | /* Fsignal stores here the condition-case clause that applies, |
| 2777 | and Fcondition_case thus knows which clause to run. */ |
| 2778 | Lisp_Object volatile chosen_clause; |
| 2779 | |
| 2780 | /* Used to effect the longjump out to the handler. */ |
| 2781 | struct catchtag *tag; |
| 2782 | |
| 2783 | /* The next enclosing handler. */ |
| 2784 | struct handler *next; |
| 2785 | }; |
| 2786 | |
| 2787 | /* This structure helps implement the `catch' and `throw' control |
| 2788 | structure. A struct catchtag contains all the information needed |
| 2789 | to restore the state of the interpreter after a non-local jump. |
| 2790 | |
| 2791 | Handlers for error conditions (represented by `struct handler' |
| 2792 | structures) just point to a catch tag to do the cleanup required |
| 2793 | for their jumps. |
| 2794 | |
| 2795 | catchtag structures are chained together in the C calling stack; |
| 2796 | the `next' member points to the next outer catchtag. |
| 2797 | |
| 2798 | A call like (throw TAG VAL) searches for a catchtag whose `tag' |
| 2799 | member is TAG, and then unbinds to it. The `val' member is used to |
| 2800 | hold VAL while the stack is unwound; `val' is returned as the value |
| 2801 | of the catch form. |
| 2802 | |
| 2803 | All the other members are concerned with restoring the interpreter |
| 2804 | state. |
| 2805 | |
| 2806 | Members are volatile if their values need to survive _longjmp when |
| 2807 | a 'struct catchtag' is a local variable. */ |
| 2808 | struct catchtag |
| 2809 | { |
| 2810 | Lisp_Object tag; |
| 2811 | Lisp_Object volatile val; |
| 2812 | struct catchtag *volatile next; |
| 2813 | #if 1 /* GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS, but they're defined later. */ |
| 2814 | struct gcpro *gcpro; |
| 2815 | #endif |
| 2816 | sys_jmp_buf jmp; |
| 2817 | struct handler *handlerlist; |
| 2818 | EMACS_INT lisp_eval_depth; |
| 2819 | ptrdiff_t volatile pdlcount; |
| 2820 | int poll_suppress_count; |
| 2821 | int interrupt_input_blocked; |
| 2822 | struct byte_stack *byte_stack; |
| 2823 | }; |
| 2824 | |
| 2825 | extern Lisp_Object memory_signal_data; |
| 2826 | |
| 2827 | /* An address near the bottom of the stack. |
| 2828 | Tells GC how to save a copy of the stack. */ |
| 2829 | extern char *stack_bottom; |
| 2830 | |
| 2831 | /* Check quit-flag and quit if it is non-nil. |
| 2832 | Typing C-g does not directly cause a quit; it only sets Vquit_flag. |
| 2833 | So the program needs to do QUIT at times when it is safe to quit. |
| 2834 | Every loop that might run for a long time or might not exit |
| 2835 | ought to do QUIT at least once, at a safe place. |
| 2836 | Unless that is impossible, of course. |
| 2837 | But it is very desirable to avoid creating loops where QUIT is impossible. |
| 2838 | |
| 2839 | Exception: if you set immediate_quit to nonzero, |
| 2840 | then the handler that responds to the C-g does the quit itself. |
| 2841 | This is a good thing to do around a loop that has no side effects |
| 2842 | and (in particular) cannot call arbitrary Lisp code. |
| 2843 | |
| 2844 | If quit-flag is set to `kill-emacs' the SIGINT handler has received |
| 2845 | a request to exit Emacs when it is safe to do. */ |
| 2846 | |
| 2847 | extern void process_pending_signals (void); |
| 2848 | extern bool volatile pending_signals; |
| 2849 | |
| 2850 | extern void process_quit_flag (void); |
| 2851 | #define QUIT \ |
| 2852 | do { \ |
| 2853 | if (!NILP (Vquit_flag) && NILP (Vinhibit_quit)) \ |
| 2854 | process_quit_flag (); \ |
| 2855 | else if (pending_signals) \ |
| 2856 | process_pending_signals (); \ |
| 2857 | } while (0) |
| 2858 | |
| 2859 | |
| 2860 | /* Nonzero if ought to quit now. */ |
| 2861 | |
| 2862 | #define QUITP (!NILP (Vquit_flag) && NILP (Vinhibit_quit)) |
| 2863 | \f |
| 2864 | extern Lisp_Object Vascii_downcase_table; |
| 2865 | extern Lisp_Object Vascii_canon_table; |
| 2866 | \f |
| 2867 | /* Structure for recording stack slots that need marking. */ |
| 2868 | |
| 2869 | /* This is a chain of structures, each of which points at a Lisp_Object |
| 2870 | variable whose value should be marked in garbage collection. |
| 2871 | Normally every link of the chain is an automatic variable of a function, |
| 2872 | and its `val' points to some argument or local variable of the function. |
| 2873 | On exit to the function, the chain is set back to the value it had on entry. |
| 2874 | This way, no link remains in the chain when the stack frame containing the |
| 2875 | link disappears. |
| 2876 | |
| 2877 | Every function that can call Feval must protect in this fashion all |
| 2878 | Lisp_Object variables whose contents will be used again. */ |
| 2879 | |
| 2880 | extern struct gcpro *gcprolist; |
| 2881 | |
| 2882 | struct gcpro |
| 2883 | { |
| 2884 | struct gcpro *next; |
| 2885 | |
| 2886 | /* Address of first protected variable. */ |
| 2887 | volatile Lisp_Object *var; |
| 2888 | |
| 2889 | /* Number of consecutive protected variables. */ |
| 2890 | ptrdiff_t nvars; |
| 2891 | |
| 2892 | #ifdef DEBUG_GCPRO |
| 2893 | int level; |
| 2894 | #endif |
| 2895 | }; |
| 2896 | |
| 2897 | /* Values of GC_MARK_STACK during compilation: |
| 2898 | |
| 2899 | 0 Use GCPRO as before |
| 2900 | 1 Do the real thing, make GCPROs and UNGCPRO no-ops. |
| 2901 | 2 Mark the stack, and check that everything GCPRO'd is |
| 2902 | marked. |
| 2903 | 3 Mark using GCPRO's, mark stack last, and count how many |
| 2904 | dead objects are kept alive. |
| 2905 | |
| 2906 | Formerly, method 0 was used. Currently, method 1 is used unless |
| 2907 | otherwise specified by hand when building, e.g., |
| 2908 | "make CPPFLAGS='-DGC_MARK_STACK=GC_USE_GCPROS_AS_BEFORE'". |
| 2909 | Methods 2 and 3 are present mainly to debug the transition from 0 to 1. */ |
| 2910 | |
| 2911 | #define GC_USE_GCPROS_AS_BEFORE 0 |
| 2912 | #define GC_MAKE_GCPROS_NOOPS 1 |
| 2913 | #define GC_MARK_STACK_CHECK_GCPROS 2 |
| 2914 | #define GC_USE_GCPROS_CHECK_ZOMBIES 3 |
| 2915 | |
| 2916 | #ifndef GC_MARK_STACK |
| 2917 | #define GC_MARK_STACK GC_MAKE_GCPROS_NOOPS |
| 2918 | #endif |
| 2919 | |
| 2920 | /* Whether we do the stack marking manually. */ |
| 2921 | #define BYTE_MARK_STACK !(GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS \ |
| 2922 | || GC_MARK_STACK == GC_MARK_STACK_CHECK_GCPROS) |
| 2923 | |
| 2924 | |
| 2925 | #if GC_MARK_STACK == GC_MAKE_GCPROS_NOOPS |
| 2926 | |
| 2927 | /* Do something silly with gcproN vars just so gcc shuts up. */ |
| 2928 | /* You get warnings from MIPSPro... */ |
| 2929 | |
| 2930 | #define GCPRO1(varname) ((void) gcpro1) |
| 2931 | #define GCPRO2(varname1, varname2) ((void) gcpro2, (void) gcpro1) |
| 2932 | #define GCPRO3(varname1, varname2, varname3) \ |
| 2933 | ((void) gcpro3, (void) gcpro2, (void) gcpro1) |
| 2934 | #define GCPRO4(varname1, varname2, varname3, varname4) \ |
| 2935 | ((void) gcpro4, (void) gcpro3, (void) gcpro2, (void) gcpro1) |
| 2936 | #define GCPRO5(varname1, varname2, varname3, varname4, varname5) \ |
| 2937 | ((void) gcpro5, (void) gcpro4, (void) gcpro3, (void) gcpro2, (void) gcpro1) |
| 2938 | #define GCPRO6(varname1, varname2, varname3, varname4, varname5, varname6) \ |
| 2939 | ((void) gcpro6, (void) gcpro5, (void) gcpro4, (void) gcpro3, (void) gcpro2, \ |
| 2940 | (void) gcpro1) |
| 2941 | #define UNGCPRO ((void) 0) |
| 2942 | |
| 2943 | #else /* GC_MARK_STACK != GC_MAKE_GCPROS_NOOPS */ |
| 2944 | |
| 2945 | #ifndef DEBUG_GCPRO |
| 2946 | |
| 2947 | #define GCPRO1(varname) \ |
| 2948 | {gcpro1.next = gcprolist; gcpro1.var = &varname; gcpro1.nvars = 1; \ |
| 2949 | gcprolist = &gcpro1; } |
| 2950 | |
| 2951 | #define GCPRO2(varname1, varname2) \ |
| 2952 | {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ |
| 2953 | gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ |
| 2954 | gcprolist = &gcpro2; } |
| 2955 | |
| 2956 | #define GCPRO3(varname1, varname2, varname3) \ |
| 2957 | {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ |
| 2958 | gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ |
| 2959 | gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \ |
| 2960 | gcprolist = &gcpro3; } |
| 2961 | |
| 2962 | #define GCPRO4(varname1, varname2, varname3, varname4) \ |
| 2963 | {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ |
| 2964 | gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ |
| 2965 | gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \ |
| 2966 | gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \ |
| 2967 | gcprolist = &gcpro4; } |
| 2968 | |
| 2969 | #define GCPRO5(varname1, varname2, varname3, varname4, varname5) \ |
| 2970 | {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ |
| 2971 | gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ |
| 2972 | gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \ |
| 2973 | gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \ |
| 2974 | gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \ |
| 2975 | gcprolist = &gcpro5; } |
| 2976 | |
| 2977 | #define GCPRO6(varname1, varname2, varname3, varname4, varname5, varname6) \ |
| 2978 | {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ |
| 2979 | gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ |
| 2980 | gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \ |
| 2981 | gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \ |
| 2982 | gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \ |
| 2983 | gcpro6.next = &gcpro5; gcpro6.var = &varname6; gcpro6.nvars = 1; \ |
| 2984 | gcprolist = &gcpro6; } |
| 2985 | |
| 2986 | #define UNGCPRO (gcprolist = gcpro1.next) |
| 2987 | |
| 2988 | #else |
| 2989 | |
| 2990 | extern int gcpro_level; |
| 2991 | |
| 2992 | #define GCPRO1(varname) \ |
| 2993 | {gcpro1.next = gcprolist; gcpro1.var = &varname; gcpro1.nvars = 1; \ |
| 2994 | gcpro1.level = gcpro_level++; \ |
| 2995 | gcprolist = &gcpro1; } |
| 2996 | |
| 2997 | #define GCPRO2(varname1, varname2) \ |
| 2998 | {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ |
| 2999 | gcpro1.level = gcpro_level; \ |
| 3000 | gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ |
| 3001 | gcpro2.level = gcpro_level++; \ |
| 3002 | gcprolist = &gcpro2; } |
| 3003 | |
| 3004 | #define GCPRO3(varname1, varname2, varname3) \ |
| 3005 | {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ |
| 3006 | gcpro1.level = gcpro_level; \ |
| 3007 | gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ |
| 3008 | gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \ |
| 3009 | gcpro3.level = gcpro_level++; \ |
| 3010 | gcprolist = &gcpro3; } |
| 3011 | |
| 3012 | #define GCPRO4(varname1, varname2, varname3, varname4) \ |
| 3013 | {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ |
| 3014 | gcpro1.level = gcpro_level; \ |
| 3015 | gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ |
| 3016 | gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \ |
| 3017 | gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \ |
| 3018 | gcpro4.level = gcpro_level++; \ |
| 3019 | gcprolist = &gcpro4; } |
| 3020 | |
| 3021 | #define GCPRO5(varname1, varname2, varname3, varname4, varname5) \ |
| 3022 | {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ |
| 3023 | gcpro1.level = gcpro_level; \ |
| 3024 | gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ |
| 3025 | gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \ |
| 3026 | gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \ |
| 3027 | gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \ |
| 3028 | gcpro5.level = gcpro_level++; \ |
| 3029 | gcprolist = &gcpro5; } |
| 3030 | |
| 3031 | #define GCPRO6(varname1, varname2, varname3, varname4, varname5, varname6) \ |
| 3032 | {gcpro1.next = gcprolist; gcpro1.var = &varname1; gcpro1.nvars = 1; \ |
| 3033 | gcpro1.level = gcpro_level; \ |
| 3034 | gcpro2.next = &gcpro1; gcpro2.var = &varname2; gcpro2.nvars = 1; \ |
| 3035 | gcpro3.next = &gcpro2; gcpro3.var = &varname3; gcpro3.nvars = 1; \ |
| 3036 | gcpro4.next = &gcpro3; gcpro4.var = &varname4; gcpro4.nvars = 1; \ |
| 3037 | gcpro5.next = &gcpro4; gcpro5.var = &varname5; gcpro5.nvars = 1; \ |
| 3038 | gcpro6.next = &gcpro5; gcpro6.var = &varname6; gcpro6.nvars = 1; \ |
| 3039 | gcpro6.level = gcpro_level++; \ |
| 3040 | gcprolist = &gcpro6; } |
| 3041 | |
| 3042 | #define UNGCPRO \ |
| 3043 | ((--gcpro_level != gcpro1.level) \ |
| 3044 | ? (emacs_abort (), 0) \ |
| 3045 | : ((gcprolist = gcpro1.next), 0)) |
| 3046 | |
| 3047 | #endif /* DEBUG_GCPRO */ |
| 3048 | #endif /* GC_MARK_STACK != GC_MAKE_GCPROS_NOOPS */ |
| 3049 | |
| 3050 | |
| 3051 | /* Evaluate expr, UNGCPRO, and then return the value of expr. */ |
| 3052 | #define RETURN_UNGCPRO(expr) \ |
| 3053 | do \ |
| 3054 | { \ |
| 3055 | Lisp_Object ret_ungc_val; \ |
| 3056 | ret_ungc_val = (expr); \ |
| 3057 | UNGCPRO; \ |
| 3058 | return ret_ungc_val; \ |
| 3059 | } \ |
| 3060 | while (0) |
| 3061 | |
| 3062 | /* Call staticpro (&var) to protect static variable `var'. */ |
| 3063 | |
| 3064 | void staticpro (Lisp_Object *); |
| 3065 | \f |
| 3066 | /* Declare a Lisp-callable function. The MAXARGS parameter has the same |
| 3067 | meaning as in the DEFUN macro, and is used to construct a prototype. */ |
| 3068 | /* We can use the same trick as in the DEFUN macro to generate the |
| 3069 | appropriate prototype. */ |
| 3070 | #define EXFUN(fnname, maxargs) \ |
| 3071 | extern Lisp_Object fnname DEFUN_ARGS_ ## maxargs |
| 3072 | |
| 3073 | #include "globals.h" |
| 3074 | |
| 3075 | /* Forward declarations for prototypes. */ |
| 3076 | struct window; |
| 3077 | struct frame; |
| 3078 | |
| 3079 | /* Copy COUNT Lisp_Objects from ARGS to contents of V starting from OFFSET. */ |
| 3080 | |
| 3081 | LISP_INLINE void |
| 3082 | vcopy (Lisp_Object v, ptrdiff_t offset, Lisp_Object *args, ptrdiff_t count) |
| 3083 | { |
| 3084 | eassert (0 <= offset && 0 <= count && offset + count <= ASIZE (v)); |
| 3085 | memcpy (XVECTOR (v)->contents + offset, args, count * sizeof *args); |
| 3086 | } |
| 3087 | |
| 3088 | /* Functions to modify hash tables. */ |
| 3089 | |
| 3090 | LISP_INLINE void |
| 3091 | set_hash_key_slot (struct Lisp_Hash_Table *h, ptrdiff_t idx, Lisp_Object val) |
| 3092 | { |
| 3093 | gc_aset (h->key_and_value, 2 * idx, val); |
| 3094 | } |
| 3095 | |
| 3096 | LISP_INLINE void |
| 3097 | set_hash_value_slot (struct Lisp_Hash_Table *h, ptrdiff_t idx, Lisp_Object val) |
| 3098 | { |
| 3099 | gc_aset (h->key_and_value, 2 * idx + 1, val); |
| 3100 | } |
| 3101 | |
| 3102 | /* Use these functions to set Lisp_Object |
| 3103 | or pointer slots of struct Lisp_Symbol. */ |
| 3104 | |
| 3105 | LISP_INLINE void |
| 3106 | set_symbol_function (Lisp_Object sym, Lisp_Object function) |
| 3107 | { |
| 3108 | XSYMBOL (sym)->function = function; |
| 3109 | } |
| 3110 | |
| 3111 | LISP_INLINE void |
| 3112 | set_symbol_plist (Lisp_Object sym, Lisp_Object plist) |
| 3113 | { |
| 3114 | XSYMBOL (sym)->plist = plist; |
| 3115 | } |
| 3116 | |
| 3117 | LISP_INLINE void |
| 3118 | set_symbol_next (Lisp_Object sym, struct Lisp_Symbol *next) |
| 3119 | { |
| 3120 | XSYMBOL (sym)->next = next; |
| 3121 | } |
| 3122 | |
| 3123 | /* Buffer-local (also frame-local) variable access functions. */ |
| 3124 | |
| 3125 | LISP_INLINE int |
| 3126 | blv_found (struct Lisp_Buffer_Local_Value *blv) |
| 3127 | { |
| 3128 | eassert (blv->found == !EQ (blv->defcell, blv->valcell)); |
| 3129 | return blv->found; |
| 3130 | } |
| 3131 | |
| 3132 | /* Set overlay's property list. */ |
| 3133 | |
| 3134 | LISP_INLINE void |
| 3135 | set_overlay_plist (Lisp_Object overlay, Lisp_Object plist) |
| 3136 | { |
| 3137 | XOVERLAY (overlay)->plist = plist; |
| 3138 | } |
| 3139 | |
| 3140 | /* Get text properties of S. */ |
| 3141 | |
| 3142 | LISP_INLINE INTERVAL |
| 3143 | string_intervals (Lisp_Object s) |
| 3144 | { |
| 3145 | return XSTRING (s)->intervals; |
| 3146 | } |
| 3147 | |
| 3148 | /* Set text properties of S to I. */ |
| 3149 | |
| 3150 | LISP_INLINE void |
| 3151 | set_string_intervals (Lisp_Object s, INTERVAL i) |
| 3152 | { |
| 3153 | XSTRING (s)->intervals = i; |
| 3154 | } |
| 3155 | |
| 3156 | /* Set a Lisp slot in TABLE to VAL. Most code should use this instead |
| 3157 | of setting slots directly. */ |
| 3158 | |
| 3159 | LISP_INLINE void |
| 3160 | set_char_table_defalt (Lisp_Object table, Lisp_Object val) |
| 3161 | { |
| 3162 | XCHAR_TABLE (table)->defalt = val; |
| 3163 | } |
| 3164 | LISP_INLINE void |
| 3165 | set_char_table_purpose (Lisp_Object table, Lisp_Object val) |
| 3166 | { |
| 3167 | XCHAR_TABLE (table)->purpose = val; |
| 3168 | } |
| 3169 | |
| 3170 | /* Set different slots in (sub)character tables. */ |
| 3171 | |
| 3172 | LISP_INLINE void |
| 3173 | set_char_table_extras (Lisp_Object table, ptrdiff_t idx, Lisp_Object val) |
| 3174 | { |
| 3175 | eassert (0 <= idx && idx < CHAR_TABLE_EXTRA_SLOTS (XCHAR_TABLE (table))); |
| 3176 | XCHAR_TABLE (table)->extras[idx] = val; |
| 3177 | } |
| 3178 | |
| 3179 | LISP_INLINE void |
| 3180 | set_char_table_contents (Lisp_Object table, ptrdiff_t idx, Lisp_Object val) |
| 3181 | { |
| 3182 | eassert (0 <= idx && idx < (1 << CHARTAB_SIZE_BITS_0)); |
| 3183 | XCHAR_TABLE (table)->contents[idx] = val; |
| 3184 | } |
| 3185 | |
| 3186 | LISP_INLINE void |
| 3187 | set_sub_char_table_contents (Lisp_Object table, ptrdiff_t idx, Lisp_Object val) |
| 3188 | { |
| 3189 | XSUB_CHAR_TABLE (table)->contents[idx] = val; |
| 3190 | } |
| 3191 | |
| 3192 | /* Defined in data.c. */ |
| 3193 | extern Lisp_Object Qnil, Qt, Qquote, Qlambda, Qunbound; |
| 3194 | extern Lisp_Object Qerror_conditions, Qerror_message, Qtop_level; |
| 3195 | extern Lisp_Object Qerror, Qquit, Qargs_out_of_range; |
| 3196 | extern Lisp_Object Qvoid_variable, Qvoid_function; |
| 3197 | extern Lisp_Object Qinvalid_read_syntax; |
| 3198 | extern Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch; |
| 3199 | extern Lisp_Object Quser_error, Qend_of_file, Qarith_error, Qmark_inactive; |
| 3200 | extern Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only; |
| 3201 | extern Lisp_Object Qtext_read_only; |
| 3202 | extern Lisp_Object Qinteractive_form; |
| 3203 | extern Lisp_Object Qcircular_list; |
| 3204 | extern Lisp_Object Qintegerp, Qwholenump, Qsymbolp, Qlistp, Qconsp; |
| 3205 | extern Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp; |
| 3206 | extern Lisp_Object Qchar_or_string_p, Qmarkerp, Qinteger_or_marker_p, Qvectorp; |
| 3207 | extern Lisp_Object Qbuffer_or_string_p; |
| 3208 | extern Lisp_Object Qfboundp; |
| 3209 | extern Lisp_Object Qchar_table_p, Qvector_or_char_table_p; |
| 3210 | |
| 3211 | extern Lisp_Object Qcdr; |
| 3212 | |
| 3213 | extern Lisp_Object Qrange_error, Qoverflow_error; |
| 3214 | |
| 3215 | extern Lisp_Object Qfloatp; |
| 3216 | extern Lisp_Object Qnumberp, Qnumber_or_marker_p; |
| 3217 | |
| 3218 | extern Lisp_Object Qbuffer, Qinteger, Qsymbol; |
| 3219 | |
| 3220 | extern Lisp_Object Qfont_spec, Qfont_entity, Qfont_object; |
| 3221 | |
| 3222 | EXFUN (Fbyteorder, 0) ATTRIBUTE_CONST; |
| 3223 | |
| 3224 | /* Defined in data.c. */ |
| 3225 | extern Lisp_Object indirect_function (Lisp_Object); |
| 3226 | extern Lisp_Object find_symbol_value (Lisp_Object); |
| 3227 | |
| 3228 | /* Convert the integer I to an Emacs representation, either the integer |
| 3229 | itself, or a cons of two or three integers, or if all else fails a float. |
| 3230 | I should not have side effects. */ |
| 3231 | #define INTEGER_TO_CONS(i) \ |
| 3232 | (! FIXNUM_OVERFLOW_P (i) \ |
| 3233 | ? make_number (i) \ |
| 3234 | : ! ((FIXNUM_OVERFLOW_P (INTMAX_MIN >> 16) \ |
| 3235 | || FIXNUM_OVERFLOW_P (UINTMAX_MAX >> 16)) \ |
| 3236 | && FIXNUM_OVERFLOW_P ((i) >> 16)) \ |
| 3237 | ? Fcons (make_number ((i) >> 16), make_number ((i) & 0xffff)) \ |
| 3238 | : ! ((FIXNUM_OVERFLOW_P (INTMAX_MIN >> 16 >> 24) \ |
| 3239 | || FIXNUM_OVERFLOW_P (UINTMAX_MAX >> 16 >> 24)) \ |
| 3240 | && FIXNUM_OVERFLOW_P ((i) >> 16 >> 24)) \ |
| 3241 | ? Fcons (make_number ((i) >> 16 >> 24), \ |
| 3242 | Fcons (make_number ((i) >> 16 & 0xffffff), \ |
| 3243 | make_number ((i) & 0xffff))) \ |
| 3244 | : make_float (i)) |
| 3245 | |
| 3246 | /* Convert the Emacs representation CONS back to an integer of type |
| 3247 | TYPE, storing the result the variable VAR. Signal an error if CONS |
| 3248 | is not a valid representation or is out of range for TYPE. */ |
| 3249 | #define CONS_TO_INTEGER(cons, type, var) \ |
| 3250 | (TYPE_SIGNED (type) \ |
| 3251 | ? ((var) = cons_to_signed (cons, TYPE_MINIMUM (type), TYPE_MAXIMUM (type))) \ |
| 3252 | : ((var) = cons_to_unsigned (cons, TYPE_MAXIMUM (type)))) |
| 3253 | extern intmax_t cons_to_signed (Lisp_Object, intmax_t, intmax_t); |
| 3254 | extern uintmax_t cons_to_unsigned (Lisp_Object, uintmax_t); |
| 3255 | |
| 3256 | extern struct Lisp_Symbol *indirect_variable (struct Lisp_Symbol *); |
| 3257 | extern _Noreturn void args_out_of_range (Lisp_Object, Lisp_Object); |
| 3258 | extern _Noreturn void args_out_of_range_3 (Lisp_Object, Lisp_Object, |
| 3259 | Lisp_Object); |
| 3260 | extern _Noreturn Lisp_Object wrong_type_argument (Lisp_Object, Lisp_Object); |
| 3261 | extern Lisp_Object do_symval_forwarding (union Lisp_Fwd *); |
| 3262 | extern void set_internal (Lisp_Object, Lisp_Object, Lisp_Object, bool); |
| 3263 | extern void syms_of_data (void); |
| 3264 | extern void swap_in_global_binding (struct Lisp_Symbol *); |
| 3265 | |
| 3266 | /* Defined in cmds.c */ |
| 3267 | extern void syms_of_cmds (void); |
| 3268 | extern void keys_of_cmds (void); |
| 3269 | |
| 3270 | /* Defined in coding.c. */ |
| 3271 | extern Lisp_Object Qcharset; |
| 3272 | extern Lisp_Object detect_coding_system (const unsigned char *, ptrdiff_t, |
| 3273 | ptrdiff_t, bool, bool, Lisp_Object); |
| 3274 | extern void init_coding (void); |
| 3275 | extern void init_coding_once (void); |
| 3276 | extern void syms_of_coding (void); |
| 3277 | |
| 3278 | /* Defined in character.c. */ |
| 3279 | EXFUN (Fmax_char, 0) ATTRIBUTE_CONST; |
| 3280 | extern ptrdiff_t chars_in_text (const unsigned char *, ptrdiff_t); |
| 3281 | extern ptrdiff_t multibyte_chars_in_text (const unsigned char *, ptrdiff_t); |
| 3282 | extern int multibyte_char_to_unibyte (int) ATTRIBUTE_CONST; |
| 3283 | extern int multibyte_char_to_unibyte_safe (int) ATTRIBUTE_CONST; |
| 3284 | extern void syms_of_character (void); |
| 3285 | |
| 3286 | /* Defined in charset.c. */ |
| 3287 | extern void init_charset (void); |
| 3288 | extern void init_charset_once (void); |
| 3289 | extern void syms_of_charset (void); |
| 3290 | /* Structure forward declarations. */ |
| 3291 | struct charset; |
| 3292 | |
| 3293 | /* Defined in composite.c. */ |
| 3294 | extern void syms_of_composite (void); |
| 3295 | |
| 3296 | /* Defined in syntax.c. */ |
| 3297 | extern void init_syntax_once (void); |
| 3298 | extern void syms_of_syntax (void); |
| 3299 | |
| 3300 | /* Defined in fns.c. */ |
| 3301 | extern Lisp_Object QCrehash_size, QCrehash_threshold; |
| 3302 | enum { NEXT_ALMOST_PRIME_LIMIT = 11 }; |
| 3303 | EXFUN (Fidentity, 1) ATTRIBUTE_CONST; |
| 3304 | extern EMACS_INT next_almost_prime (EMACS_INT) ATTRIBUTE_CONST; |
| 3305 | extern Lisp_Object larger_vector (Lisp_Object, ptrdiff_t, ptrdiff_t); |
| 3306 | extern void sweep_weak_hash_tables (void); |
| 3307 | extern Lisp_Object Qcursor_in_echo_area; |
| 3308 | extern Lisp_Object Qstring_lessp; |
| 3309 | extern Lisp_Object QCsize, QCtest, QCweakness, Qequal, Qeq; |
| 3310 | EMACS_UINT hash_string (char const *, ptrdiff_t); |
| 3311 | EMACS_UINT sxhash (Lisp_Object, int); |
| 3312 | Lisp_Object make_hash_table (struct hash_table_test, Lisp_Object, Lisp_Object, |
| 3313 | Lisp_Object, Lisp_Object); |
| 3314 | ptrdiff_t hash_lookup (struct Lisp_Hash_Table *, Lisp_Object, EMACS_UINT *); |
| 3315 | ptrdiff_t hash_put (struct Lisp_Hash_Table *, Lisp_Object, Lisp_Object, |
| 3316 | EMACS_UINT); |
| 3317 | extern struct hash_table_test hashtest_eql, hashtest_equal; |
| 3318 | |
| 3319 | extern Lisp_Object substring_both (Lisp_Object, ptrdiff_t, ptrdiff_t, |
| 3320 | ptrdiff_t, ptrdiff_t); |
| 3321 | extern Lisp_Object do_yes_or_no_p (Lisp_Object); |
| 3322 | extern Lisp_Object concat2 (Lisp_Object, Lisp_Object); |
| 3323 | extern Lisp_Object concat3 (Lisp_Object, Lisp_Object, Lisp_Object); |
| 3324 | extern Lisp_Object nconc2 (Lisp_Object, Lisp_Object); |
| 3325 | extern Lisp_Object assq_no_quit (Lisp_Object, Lisp_Object); |
| 3326 | extern Lisp_Object assoc_no_quit (Lisp_Object, Lisp_Object); |
| 3327 | extern void clear_string_char_byte_cache (void); |
| 3328 | extern ptrdiff_t string_char_to_byte (Lisp_Object, ptrdiff_t); |
| 3329 | extern ptrdiff_t string_byte_to_char (Lisp_Object, ptrdiff_t); |
| 3330 | extern Lisp_Object string_to_multibyte (Lisp_Object); |
| 3331 | extern Lisp_Object string_make_unibyte (Lisp_Object); |
| 3332 | extern void syms_of_fns (void); |
| 3333 | |
| 3334 | /* Defined in floatfns.c. */ |
| 3335 | extern double extract_float (Lisp_Object); |
| 3336 | extern void syms_of_floatfns (void); |
| 3337 | extern Lisp_Object fmod_float (Lisp_Object x, Lisp_Object y); |
| 3338 | |
| 3339 | /* Defined in fringe.c. */ |
| 3340 | extern void syms_of_fringe (void); |
| 3341 | extern void init_fringe (void); |
| 3342 | #ifdef HAVE_WINDOW_SYSTEM |
| 3343 | extern void mark_fringe_data (void); |
| 3344 | extern void init_fringe_once (void); |
| 3345 | #endif /* HAVE_WINDOW_SYSTEM */ |
| 3346 | |
| 3347 | /* Defined in image.c. */ |
| 3348 | extern Lisp_Object QCascent, QCmargin, QCrelief; |
| 3349 | extern Lisp_Object QCconversion; |
| 3350 | extern int x_bitmap_mask (struct frame *, ptrdiff_t); |
| 3351 | extern void reset_image_types (void); |
| 3352 | extern void syms_of_image (void); |
| 3353 | |
| 3354 | /* Defined in insdel.c. */ |
| 3355 | extern Lisp_Object Qinhibit_modification_hooks; |
| 3356 | extern void move_gap_both (ptrdiff_t, ptrdiff_t); |
| 3357 | extern _Noreturn void buffer_overflow (void); |
| 3358 | extern void make_gap (ptrdiff_t); |
| 3359 | extern void make_gap_1 (struct buffer *, ptrdiff_t); |
| 3360 | extern ptrdiff_t copy_text (const unsigned char *, unsigned char *, |
| 3361 | ptrdiff_t, bool, bool); |
| 3362 | extern int count_combining_before (const unsigned char *, |
| 3363 | ptrdiff_t, ptrdiff_t, ptrdiff_t); |
| 3364 | extern int count_combining_after (const unsigned char *, |
| 3365 | ptrdiff_t, ptrdiff_t, ptrdiff_t); |
| 3366 | extern void insert (const char *, ptrdiff_t); |
| 3367 | extern void insert_and_inherit (const char *, ptrdiff_t); |
| 3368 | extern void insert_1_both (const char *, ptrdiff_t, ptrdiff_t, |
| 3369 | bool, bool, bool); |
| 3370 | extern void insert_from_gap (ptrdiff_t, ptrdiff_t, bool text_at_gap_tail); |
| 3371 | extern void insert_from_string (Lisp_Object, ptrdiff_t, ptrdiff_t, |
| 3372 | ptrdiff_t, ptrdiff_t, bool); |
| 3373 | extern void insert_from_buffer (struct buffer *, ptrdiff_t, ptrdiff_t, bool); |
| 3374 | extern void insert_char (int); |
| 3375 | extern void insert_string (const char *); |
| 3376 | extern void insert_before_markers (const char *, ptrdiff_t); |
| 3377 | extern void insert_before_markers_and_inherit (const char *, ptrdiff_t); |
| 3378 | extern void insert_from_string_before_markers (Lisp_Object, ptrdiff_t, |
| 3379 | ptrdiff_t, ptrdiff_t, |
| 3380 | ptrdiff_t, bool); |
| 3381 | extern void del_range (ptrdiff_t, ptrdiff_t); |
| 3382 | extern Lisp_Object del_range_1 (ptrdiff_t, ptrdiff_t, bool, bool); |
| 3383 | extern void del_range_byte (ptrdiff_t, ptrdiff_t, bool); |
| 3384 | extern void del_range_both (ptrdiff_t, ptrdiff_t, ptrdiff_t, ptrdiff_t, bool); |
| 3385 | extern Lisp_Object del_range_2 (ptrdiff_t, ptrdiff_t, |
| 3386 | ptrdiff_t, ptrdiff_t, bool); |
| 3387 | extern void modify_region_1 (ptrdiff_t, ptrdiff_t, bool); |
| 3388 | extern void prepare_to_modify_buffer (ptrdiff_t, ptrdiff_t, ptrdiff_t *); |
| 3389 | extern void signal_after_change (ptrdiff_t, ptrdiff_t, ptrdiff_t); |
| 3390 | extern void adjust_after_insert (ptrdiff_t, ptrdiff_t, ptrdiff_t, |
| 3391 | ptrdiff_t, ptrdiff_t); |
| 3392 | extern void adjust_markers_for_delete (ptrdiff_t, ptrdiff_t, |
| 3393 | ptrdiff_t, ptrdiff_t); |
| 3394 | extern void replace_range (ptrdiff_t, ptrdiff_t, Lisp_Object, bool, bool, bool); |
| 3395 | extern void replace_range_2 (ptrdiff_t, ptrdiff_t, ptrdiff_t, ptrdiff_t, |
| 3396 | const char *, ptrdiff_t, ptrdiff_t, bool); |
| 3397 | extern void syms_of_insdel (void); |
| 3398 | |
| 3399 | /* Defined in dispnew.c. */ |
| 3400 | #if (defined PROFILING \ |
| 3401 | && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__)) |
| 3402 | _Noreturn void __executable_start (void); |
| 3403 | #endif |
| 3404 | extern Lisp_Object selected_frame; |
| 3405 | extern Lisp_Object Vwindow_system; |
| 3406 | extern Lisp_Object sit_for (Lisp_Object, bool, int); |
| 3407 | extern void init_display (void); |
| 3408 | extern void syms_of_display (void); |
| 3409 | |
| 3410 | /* Defined in xdisp.c. */ |
| 3411 | extern Lisp_Object Qinhibit_point_motion_hooks; |
| 3412 | extern Lisp_Object Qinhibit_redisplay, Qdisplay; |
| 3413 | extern Lisp_Object Qmenu_bar_update_hook; |
| 3414 | extern Lisp_Object Qwindow_scroll_functions; |
| 3415 | extern Lisp_Object Qoverriding_local_map, Qoverriding_terminal_local_map; |
| 3416 | extern Lisp_Object Qimage, Qtext, Qboth, Qboth_horiz, Qtext_image_horiz; |
| 3417 | extern Lisp_Object Qspace, Qcenter, QCalign_to; |
| 3418 | extern Lisp_Object Qbar, Qhbar, Qbox, Qhollow; |
| 3419 | extern Lisp_Object Qleft_margin, Qright_margin; |
| 3420 | extern Lisp_Object Qglyphless_char; |
| 3421 | extern Lisp_Object QCdata, QCfile; |
| 3422 | extern Lisp_Object QCmap; |
| 3423 | extern Lisp_Object Qrisky_local_variable; |
| 3424 | extern struct frame *last_glyphless_glyph_frame; |
| 3425 | extern int last_glyphless_glyph_face_id; |
| 3426 | extern int last_glyphless_glyph_merged_face_id; |
| 3427 | extern int noninteractive_need_newline; |
| 3428 | extern Lisp_Object echo_area_buffer[2]; |
| 3429 | extern void add_to_log (const char *, Lisp_Object, Lisp_Object); |
| 3430 | extern void check_message_stack (void); |
| 3431 | extern void setup_echo_area_for_printing (int); |
| 3432 | extern bool push_message (void); |
| 3433 | extern void pop_message_unwind (void); |
| 3434 | extern Lisp_Object restore_message_unwind (Lisp_Object); |
| 3435 | extern void restore_message (void); |
| 3436 | extern Lisp_Object current_message (void); |
| 3437 | extern void clear_message (int, int); |
| 3438 | extern void message (const char *, ...) ATTRIBUTE_FORMAT_PRINTF (1, 2); |
| 3439 | extern void message1 (const char *); |
| 3440 | extern void message1_nolog (const char *); |
| 3441 | extern void message3 (Lisp_Object); |
| 3442 | extern void message3_nolog (Lisp_Object); |
| 3443 | extern void message_dolog (const char *, ptrdiff_t, bool, bool); |
| 3444 | extern void message_with_string (const char *, Lisp_Object, int); |
| 3445 | extern void message_log_maybe_newline (void); |
| 3446 | extern void update_echo_area (void); |
| 3447 | extern void truncate_echo_area (ptrdiff_t); |
| 3448 | extern void redisplay (void); |
| 3449 | extern void redisplay_preserve_echo_area (int); |
| 3450 | extern void prepare_menu_bars (void); |
| 3451 | |
| 3452 | void set_frame_cursor_types (struct frame *, Lisp_Object); |
| 3453 | extern void syms_of_xdisp (void); |
| 3454 | extern void init_xdisp (void); |
| 3455 | extern Lisp_Object safe_eval (Lisp_Object); |
| 3456 | extern int pos_visible_p (struct window *, ptrdiff_t, int *, |
| 3457 | int *, int *, int *, int *, int *); |
| 3458 | |
| 3459 | /* Defined in xsettings.c. */ |
| 3460 | extern void syms_of_xsettings (void); |
| 3461 | |
| 3462 | /* Defined in vm-limit.c. */ |
| 3463 | extern void memory_warnings (void *, void (*warnfun) (const char *)); |
| 3464 | |
| 3465 | /* Defined in alloc.c. */ |
| 3466 | extern void check_pure_size (void); |
| 3467 | extern void free_misc (Lisp_Object); |
| 3468 | extern void allocate_string_data (struct Lisp_String *, EMACS_INT, EMACS_INT); |
| 3469 | extern void malloc_warning (const char *); |
| 3470 | extern _Noreturn void memory_full (size_t); |
| 3471 | extern _Noreturn void buffer_memory_full (ptrdiff_t); |
| 3472 | extern bool survives_gc_p (Lisp_Object); |
| 3473 | extern void mark_object (Lisp_Object); |
| 3474 | #if defined REL_ALLOC && !defined SYSTEM_MALLOC |
| 3475 | extern void refill_memory_reserve (void); |
| 3476 | #endif |
| 3477 | extern const char *pending_malloc_warning; |
| 3478 | extern Lisp_Object zero_vector; |
| 3479 | extern Lisp_Object *stack_base; |
| 3480 | extern EMACS_INT consing_since_gc; |
| 3481 | extern EMACS_INT gc_relative_threshold; |
| 3482 | extern EMACS_INT memory_full_cons_threshold; |
| 3483 | extern Lisp_Object list1 (Lisp_Object); |
| 3484 | extern Lisp_Object list2 (Lisp_Object, Lisp_Object); |
| 3485 | extern Lisp_Object list3 (Lisp_Object, Lisp_Object, Lisp_Object); |
| 3486 | extern Lisp_Object list4 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 3487 | extern Lisp_Object list5 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, |
| 3488 | Lisp_Object); |
| 3489 | enum constype {CONSTYPE_HEAP, CONSTYPE_PURE}; |
| 3490 | extern Lisp_Object listn (enum constype, ptrdiff_t, Lisp_Object, ...); |
| 3491 | |
| 3492 | /* Build a frequently used 2/3/4-integer lists. */ |
| 3493 | |
| 3494 | LISP_INLINE Lisp_Object |
| 3495 | list2i (EMACS_INT x, EMACS_INT y) |
| 3496 | { |
| 3497 | return list2 (make_number (x), make_number (y)); |
| 3498 | } |
| 3499 | |
| 3500 | LISP_INLINE Lisp_Object |
| 3501 | list3i (EMACS_INT x, EMACS_INT y, EMACS_INT w) |
| 3502 | { |
| 3503 | return list3 (make_number (x), make_number (y), make_number (w)); |
| 3504 | } |
| 3505 | |
| 3506 | LISP_INLINE Lisp_Object |
| 3507 | list4i (EMACS_INT x, EMACS_INT y, EMACS_INT w, EMACS_INT h) |
| 3508 | { |
| 3509 | return list4 (make_number (x), make_number (y), |
| 3510 | make_number (w), make_number (h)); |
| 3511 | } |
| 3512 | |
| 3513 | extern _Noreturn void string_overflow (void); |
| 3514 | extern Lisp_Object make_string (const char *, ptrdiff_t); |
| 3515 | extern Lisp_Object make_formatted_string (char *, const char *, ...) |
| 3516 | ATTRIBUTE_FORMAT_PRINTF (2, 3); |
| 3517 | extern Lisp_Object make_unibyte_string (const char *, ptrdiff_t); |
| 3518 | |
| 3519 | /* Make unibyte string from C string when the length isn't known. */ |
| 3520 | |
| 3521 | LISP_INLINE Lisp_Object |
| 3522 | build_unibyte_string (const char *str) |
| 3523 | { |
| 3524 | return make_unibyte_string (str, strlen (str)); |
| 3525 | } |
| 3526 | |
| 3527 | extern Lisp_Object make_multibyte_string (const char *, ptrdiff_t, ptrdiff_t); |
| 3528 | extern Lisp_Object make_event_array (int, Lisp_Object *); |
| 3529 | extern Lisp_Object make_uninit_string (EMACS_INT); |
| 3530 | extern Lisp_Object make_uninit_multibyte_string (EMACS_INT, EMACS_INT); |
| 3531 | extern Lisp_Object make_string_from_bytes (const char *, ptrdiff_t, ptrdiff_t); |
| 3532 | extern Lisp_Object make_specified_string (const char *, |
| 3533 | ptrdiff_t, ptrdiff_t, bool); |
| 3534 | extern Lisp_Object make_pure_string (const char *, ptrdiff_t, ptrdiff_t, bool); |
| 3535 | extern Lisp_Object make_pure_c_string (const char *, ptrdiff_t); |
| 3536 | |
| 3537 | /* Make a string allocated in pure space, use STR as string data. */ |
| 3538 | |
| 3539 | LISP_INLINE Lisp_Object |
| 3540 | build_pure_c_string (const char *str) |
| 3541 | { |
| 3542 | return make_pure_c_string (str, strlen (str)); |
| 3543 | } |
| 3544 | |
| 3545 | /* Make a string from the data at STR, treating it as multibyte if the |
| 3546 | data warrants. */ |
| 3547 | |
| 3548 | LISP_INLINE Lisp_Object |
| 3549 | build_string (const char *str) |
| 3550 | { |
| 3551 | return make_string (str, strlen (str)); |
| 3552 | } |
| 3553 | |
| 3554 | extern Lisp_Object pure_cons (Lisp_Object, Lisp_Object); |
| 3555 | extern void make_byte_code (struct Lisp_Vector *); |
| 3556 | extern Lisp_Object Qautomatic_gc; |
| 3557 | extern Lisp_Object Qchar_table_extra_slots; |
| 3558 | extern struct Lisp_Vector *allocate_vector (EMACS_INT); |
| 3559 | |
| 3560 | /* Make an uninitialized vector for SIZE objects. NOTE: you must |
| 3561 | be sure that GC cannot happen until the vector is completely |
| 3562 | initialized. E.g. the following code is likely to crash: |
| 3563 | |
| 3564 | v = make_uninit_vector (3); |
| 3565 | ASET (v, 0, obj0); |
| 3566 | ASET (v, 1, Ffunction_can_gc ()); |
| 3567 | ASET (v, 2, obj1); */ |
| 3568 | |
| 3569 | LISP_INLINE Lisp_Object |
| 3570 | make_uninit_vector (ptrdiff_t size) |
| 3571 | { |
| 3572 | Lisp_Object v; |
| 3573 | struct Lisp_Vector *p; |
| 3574 | |
| 3575 | p = allocate_vector (size); |
| 3576 | XSETVECTOR (v, p); |
| 3577 | return v; |
| 3578 | } |
| 3579 | |
| 3580 | extern struct Lisp_Vector *allocate_pseudovector (int, int, enum pvec_type); |
| 3581 | #define ALLOCATE_PSEUDOVECTOR(typ,field,tag) \ |
| 3582 | ((typ*) \ |
| 3583 | allocate_pseudovector \ |
| 3584 | (VECSIZE (typ), PSEUDOVECSIZE (typ, field), tag)) |
| 3585 | extern struct Lisp_Hash_Table *allocate_hash_table (void); |
| 3586 | extern struct window *allocate_window (void); |
| 3587 | extern struct frame *allocate_frame (void); |
| 3588 | extern struct Lisp_Process *allocate_process (void); |
| 3589 | extern struct terminal *allocate_terminal (void); |
| 3590 | extern bool gc_in_progress; |
| 3591 | extern bool abort_on_gc; |
| 3592 | extern Lisp_Object make_float (double); |
| 3593 | extern void display_malloc_warning (void); |
| 3594 | extern ptrdiff_t inhibit_garbage_collection (void); |
| 3595 | extern Lisp_Object make_save_value (enum Lisp_Save_Type, ...); |
| 3596 | extern Lisp_Object make_save_pointer (void *); |
| 3597 | extern void free_save_value (Lisp_Object); |
| 3598 | extern Lisp_Object build_overlay (Lisp_Object, Lisp_Object, Lisp_Object); |
| 3599 | extern void free_marker (Lisp_Object); |
| 3600 | extern void free_cons (struct Lisp_Cons *); |
| 3601 | extern void init_alloc_once (void); |
| 3602 | extern void init_alloc (void); |
| 3603 | extern void syms_of_alloc (void); |
| 3604 | extern struct buffer * allocate_buffer (void); |
| 3605 | extern int valid_lisp_object_p (Lisp_Object); |
| 3606 | #ifdef GC_CHECK_CONS_LIST |
| 3607 | extern void check_cons_list (void); |
| 3608 | #else |
| 3609 | LISP_INLINE void (check_cons_list) (void) { lisp_h_check_cons_list (); } |
| 3610 | #endif |
| 3611 | |
| 3612 | #ifdef REL_ALLOC |
| 3613 | /* Defined in ralloc.c. */ |
| 3614 | extern void *r_alloc (void **, size_t); |
| 3615 | extern void r_alloc_free (void **); |
| 3616 | extern void *r_re_alloc (void **, size_t); |
| 3617 | extern void r_alloc_reset_variable (void **, void **); |
| 3618 | extern void r_alloc_inhibit_buffer_relocation (int); |
| 3619 | #endif |
| 3620 | |
| 3621 | /* Defined in chartab.c. */ |
| 3622 | extern Lisp_Object copy_char_table (Lisp_Object); |
| 3623 | extern Lisp_Object char_table_ref (Lisp_Object, int); |
| 3624 | extern Lisp_Object char_table_ref_and_range (Lisp_Object, int, |
| 3625 | int *, int *); |
| 3626 | extern void char_table_set (Lisp_Object, int, Lisp_Object); |
| 3627 | extern void char_table_set_range (Lisp_Object, int, int, Lisp_Object); |
| 3628 | extern int char_table_translate (Lisp_Object, int); |
| 3629 | extern void map_char_table (void (*) (Lisp_Object, Lisp_Object, |
| 3630 | Lisp_Object), |
| 3631 | Lisp_Object, Lisp_Object, Lisp_Object); |
| 3632 | extern void map_char_table_for_charset (void (*c_function) (Lisp_Object, Lisp_Object), |
| 3633 | Lisp_Object, Lisp_Object, |
| 3634 | Lisp_Object, struct charset *, |
| 3635 | unsigned, unsigned); |
| 3636 | extern Lisp_Object uniprop_table (Lisp_Object); |
| 3637 | extern void syms_of_chartab (void); |
| 3638 | |
| 3639 | /* Defined in print.c. */ |
| 3640 | extern Lisp_Object Vprin1_to_string_buffer; |
| 3641 | extern void debug_print (Lisp_Object) EXTERNALLY_VISIBLE; |
| 3642 | extern Lisp_Object Qstandard_output; |
| 3643 | extern Lisp_Object Qexternal_debugging_output; |
| 3644 | extern void temp_output_buffer_setup (const char *); |
| 3645 | extern int print_level; |
| 3646 | extern Lisp_Object Qprint_escape_newlines; |
| 3647 | extern void write_string (const char *, int); |
| 3648 | extern void print_error_message (Lisp_Object, Lisp_Object, const char *, |
| 3649 | Lisp_Object); |
| 3650 | extern Lisp_Object internal_with_output_to_temp_buffer |
| 3651 | (const char *, Lisp_Object (*) (Lisp_Object), Lisp_Object); |
| 3652 | enum FLOAT_TO_STRING_BUFSIZE { FLOAT_TO_STRING_BUFSIZE = 350 }; |
| 3653 | extern int float_to_string (char *, double); |
| 3654 | extern void init_print_once (void); |
| 3655 | extern void syms_of_print (void); |
| 3656 | |
| 3657 | /* Defined in doprnt.c. */ |
| 3658 | extern ptrdiff_t doprnt (char *, ptrdiff_t, const char *, const char *, |
| 3659 | va_list); |
| 3660 | extern ptrdiff_t esprintf (char *, char const *, ...) |
| 3661 | ATTRIBUTE_FORMAT_PRINTF (2, 3); |
| 3662 | extern ptrdiff_t exprintf (char **, ptrdiff_t *, char const *, ptrdiff_t, |
| 3663 | char const *, ...) |
| 3664 | ATTRIBUTE_FORMAT_PRINTF (5, 6); |
| 3665 | extern ptrdiff_t evxprintf (char **, ptrdiff_t *, char const *, ptrdiff_t, |
| 3666 | char const *, va_list) |
| 3667 | ATTRIBUTE_FORMAT_PRINTF (5, 0); |
| 3668 | |
| 3669 | /* Defined in lread.c. */ |
| 3670 | extern Lisp_Object Qvariable_documentation, Qstandard_input; |
| 3671 | extern Lisp_Object Qbackquote, Qcomma, Qcomma_at, Qcomma_dot, Qfunction; |
| 3672 | extern Lisp_Object Qlexical_binding; |
| 3673 | extern Lisp_Object check_obarray (Lisp_Object); |
| 3674 | extern Lisp_Object intern_1 (const char *, ptrdiff_t); |
| 3675 | extern Lisp_Object intern_c_string_1 (const char *, ptrdiff_t); |
| 3676 | extern Lisp_Object oblookup (Lisp_Object, const char *, ptrdiff_t, ptrdiff_t); |
| 3677 | LISP_INLINE void |
| 3678 | LOADHIST_ATTACH (Lisp_Object x) |
| 3679 | { |
| 3680 | if (initialized) |
| 3681 | Vcurrent_load_list = Fcons (x, Vcurrent_load_list); |
| 3682 | } |
| 3683 | extern int openp (Lisp_Object, Lisp_Object, Lisp_Object, |
| 3684 | Lisp_Object *, Lisp_Object); |
| 3685 | extern Lisp_Object string_to_number (char const *, int, bool); |
| 3686 | extern void map_obarray (Lisp_Object, void (*) (Lisp_Object, Lisp_Object), |
| 3687 | Lisp_Object); |
| 3688 | extern void dir_warning (const char *, Lisp_Object); |
| 3689 | extern void init_obarray (void); |
| 3690 | extern void init_lread (void); |
| 3691 | extern void syms_of_lread (void); |
| 3692 | |
| 3693 | LISP_INLINE Lisp_Object |
| 3694 | intern (const char *str) |
| 3695 | { |
| 3696 | return intern_1 (str, strlen (str)); |
| 3697 | } |
| 3698 | |
| 3699 | LISP_INLINE Lisp_Object |
| 3700 | intern_c_string (const char *str) |
| 3701 | { |
| 3702 | return intern_c_string_1 (str, strlen (str)); |
| 3703 | } |
| 3704 | |
| 3705 | /* Defined in eval.c. */ |
| 3706 | extern Lisp_Object Qautoload, Qexit, Qinteractive, Qcommandp, Qmacro; |
| 3707 | extern Lisp_Object Qinhibit_quit, Qinternal_interpreter_environment, Qclosure; |
| 3708 | extern Lisp_Object Qand_rest; |
| 3709 | extern Lisp_Object Vautoload_queue; |
| 3710 | extern Lisp_Object Vsignaling_function; |
| 3711 | extern Lisp_Object inhibit_lisp_code; |
| 3712 | #if BYTE_MARK_STACK |
| 3713 | extern struct catchtag *catchlist; |
| 3714 | extern struct handler *handlerlist; |
| 3715 | #endif |
| 3716 | /* To run a normal hook, use the appropriate function from the list below. |
| 3717 | The calling convention: |
| 3718 | |
| 3719 | if (!NILP (Vrun_hooks)) |
| 3720 | call1 (Vrun_hooks, Qmy_funny_hook); |
| 3721 | |
| 3722 | should no longer be used. */ |
| 3723 | extern Lisp_Object Vrun_hooks; |
| 3724 | extern void run_hook_with_args_2 (Lisp_Object, Lisp_Object, Lisp_Object); |
| 3725 | extern Lisp_Object run_hook_with_args (ptrdiff_t nargs, Lisp_Object *args, |
| 3726 | Lisp_Object (*funcall) |
| 3727 | (ptrdiff_t nargs, Lisp_Object *args)); |
| 3728 | extern _Noreturn void xsignal (Lisp_Object, Lisp_Object); |
| 3729 | extern _Noreturn void xsignal0 (Lisp_Object); |
| 3730 | extern _Noreturn void xsignal1 (Lisp_Object, Lisp_Object); |
| 3731 | extern _Noreturn void xsignal2 (Lisp_Object, Lisp_Object, Lisp_Object); |
| 3732 | extern _Noreturn void xsignal3 (Lisp_Object, Lisp_Object, Lisp_Object, |
| 3733 | Lisp_Object); |
| 3734 | extern _Noreturn void signal_error (const char *, Lisp_Object); |
| 3735 | extern Lisp_Object eval_sub (Lisp_Object form); |
| 3736 | extern Lisp_Object apply1 (Lisp_Object, Lisp_Object); |
| 3737 | extern Lisp_Object call0 (Lisp_Object); |
| 3738 | extern Lisp_Object call1 (Lisp_Object, Lisp_Object); |
| 3739 | extern Lisp_Object call2 (Lisp_Object, Lisp_Object, Lisp_Object); |
| 3740 | extern Lisp_Object call3 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 3741 | extern Lisp_Object call4 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 3742 | extern Lisp_Object call5 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 3743 | extern Lisp_Object call6 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 3744 | extern Lisp_Object call7 (Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object); |
| 3745 | extern Lisp_Object internal_catch (Lisp_Object, Lisp_Object (*) (Lisp_Object), Lisp_Object); |
| 3746 | extern Lisp_Object internal_lisp_condition_case (Lisp_Object, Lisp_Object, Lisp_Object); |
| 3747 | extern Lisp_Object internal_condition_case (Lisp_Object (*) (void), Lisp_Object, Lisp_Object (*) (Lisp_Object)); |
| 3748 | extern Lisp_Object internal_condition_case_1 (Lisp_Object (*) (Lisp_Object), Lisp_Object, Lisp_Object, Lisp_Object (*) (Lisp_Object)); |
| 3749 | extern Lisp_Object internal_condition_case_2 (Lisp_Object (*) (Lisp_Object, Lisp_Object), Lisp_Object, Lisp_Object, Lisp_Object, Lisp_Object (*) (Lisp_Object)); |
| 3750 | extern Lisp_Object internal_condition_case_n |
| 3751 | (Lisp_Object (*) (ptrdiff_t, Lisp_Object *), ptrdiff_t, Lisp_Object *, |
| 3752 | Lisp_Object, Lisp_Object (*) (Lisp_Object, ptrdiff_t, Lisp_Object *)); |
| 3753 | extern void specbind (Lisp_Object, Lisp_Object); |
| 3754 | extern void record_unwind_protect (void (*) (Lisp_Object), Lisp_Object); |
| 3755 | extern void record_unwind_protect_int (void (*) (int), int); |
| 3756 | extern void record_unwind_protect_ptr (void (*) (void *), void *); |
| 3757 | extern void record_unwind_protect_void (void (*) (void)); |
| 3758 | extern Lisp_Object unbind_to (ptrdiff_t, Lisp_Object); |
| 3759 | extern _Noreturn void error (const char *, ...) ATTRIBUTE_FORMAT_PRINTF (1, 2); |
| 3760 | extern _Noreturn void verror (const char *, va_list) |
| 3761 | ATTRIBUTE_FORMAT_PRINTF (1, 0); |
| 3762 | extern void un_autoload (Lisp_Object); |
| 3763 | extern Lisp_Object call_debugger (Lisp_Object arg); |
| 3764 | extern void init_eval_once (void); |
| 3765 | extern Lisp_Object safe_call (ptrdiff_t, Lisp_Object, ...); |
| 3766 | extern Lisp_Object safe_call1 (Lisp_Object, Lisp_Object); |
| 3767 | extern Lisp_Object safe_call2 (Lisp_Object, Lisp_Object, Lisp_Object); |
| 3768 | extern void init_eval (void); |
| 3769 | extern void syms_of_eval (void); |
| 3770 | extern void unwind_body (Lisp_Object); |
| 3771 | extern void record_in_backtrace (Lisp_Object function, |
| 3772 | Lisp_Object *args, ptrdiff_t nargs); |
| 3773 | extern void mark_specpdl (void); |
| 3774 | extern void get_backtrace (Lisp_Object array); |
| 3775 | Lisp_Object backtrace_top_function (void); |
| 3776 | extern bool let_shadows_buffer_binding_p (struct Lisp_Symbol *symbol); |
| 3777 | extern bool let_shadows_global_binding_p (Lisp_Object symbol); |
| 3778 | |
| 3779 | |
| 3780 | /* Defined in editfns.c. */ |
| 3781 | extern Lisp_Object Qfield; |
| 3782 | extern void insert1 (Lisp_Object); |
| 3783 | extern Lisp_Object format2 (const char *, Lisp_Object, Lisp_Object); |
| 3784 | extern Lisp_Object save_excursion_save (void); |
| 3785 | extern Lisp_Object save_restriction_save (void); |
| 3786 | extern void save_excursion_restore (Lisp_Object); |
| 3787 | extern void save_restriction_restore (Lisp_Object); |
| 3788 | extern _Noreturn void time_overflow (void); |
| 3789 | extern Lisp_Object make_buffer_string (ptrdiff_t, ptrdiff_t, bool); |
| 3790 | extern Lisp_Object make_buffer_string_both (ptrdiff_t, ptrdiff_t, ptrdiff_t, |
| 3791 | ptrdiff_t, bool); |
| 3792 | extern void init_editfns (void); |
| 3793 | extern void syms_of_editfns (void); |
| 3794 | extern void set_time_zone_rule (const char *); |
| 3795 | |
| 3796 | /* Defined in buffer.c. */ |
| 3797 | extern bool mouse_face_overlay_overlaps (Lisp_Object); |
| 3798 | extern _Noreturn void nsberror (Lisp_Object); |
| 3799 | extern void adjust_overlays_for_insert (ptrdiff_t, ptrdiff_t); |
| 3800 | extern void adjust_overlays_for_delete (ptrdiff_t, ptrdiff_t); |
| 3801 | extern void fix_start_end_in_overlays (ptrdiff_t, ptrdiff_t); |
| 3802 | extern void report_overlay_modification (Lisp_Object, Lisp_Object, bool, |
| 3803 | Lisp_Object, Lisp_Object, Lisp_Object); |
| 3804 | extern bool overlay_touches_p (ptrdiff_t); |
| 3805 | extern Lisp_Object Vbuffer_alist; |
| 3806 | extern Lisp_Object other_buffer_safely (Lisp_Object); |
| 3807 | extern Lisp_Object Qpriority, Qwindow, Qbefore_string, Qafter_string; |
| 3808 | extern Lisp_Object get_truename_buffer (Lisp_Object); |
| 3809 | extern void init_buffer_once (void); |
| 3810 | extern void init_buffer (void); |
| 3811 | extern void syms_of_buffer (void); |
| 3812 | extern void keys_of_buffer (void); |
| 3813 | |
| 3814 | /* Defined in marker.c. */ |
| 3815 | |
| 3816 | extern ptrdiff_t marker_position (Lisp_Object); |
| 3817 | extern ptrdiff_t marker_byte_position (Lisp_Object); |
| 3818 | extern void clear_charpos_cache (struct buffer *); |
| 3819 | extern ptrdiff_t buf_charpos_to_bytepos (struct buffer *, ptrdiff_t); |
| 3820 | extern ptrdiff_t buf_bytepos_to_charpos (struct buffer *, ptrdiff_t); |
| 3821 | extern void unchain_marker (struct Lisp_Marker *marker); |
| 3822 | extern Lisp_Object set_marker_restricted (Lisp_Object, Lisp_Object, Lisp_Object); |
| 3823 | extern Lisp_Object set_marker_both (Lisp_Object, Lisp_Object, ptrdiff_t, ptrdiff_t); |
| 3824 | extern Lisp_Object set_marker_restricted_both (Lisp_Object, Lisp_Object, |
| 3825 | ptrdiff_t, ptrdiff_t); |
| 3826 | extern Lisp_Object build_marker (struct buffer *, ptrdiff_t, ptrdiff_t); |
| 3827 | extern void syms_of_marker (void); |
| 3828 | |
| 3829 | /* Defined in fileio.c. */ |
| 3830 | |
| 3831 | extern Lisp_Object Qfile_error; |
| 3832 | extern Lisp_Object Qfile_notify_error; |
| 3833 | extern Lisp_Object Qfile_exists_p; |
| 3834 | extern Lisp_Object Qfile_directory_p; |
| 3835 | extern Lisp_Object Qinsert_file_contents; |
| 3836 | extern Lisp_Object Qfile_name_history; |
| 3837 | extern Lisp_Object expand_and_dir_to_file (Lisp_Object, Lisp_Object); |
| 3838 | EXFUN (Fread_file_name, 6); /* Not a normal DEFUN. */ |
| 3839 | extern void close_file_unwind (int); |
| 3840 | extern void restore_point_unwind (Lisp_Object); |
| 3841 | extern _Noreturn void report_file_errno (const char *, Lisp_Object, int); |
| 3842 | extern _Noreturn void report_file_error (const char *, Lisp_Object); |
| 3843 | extern bool internal_delete_file (Lisp_Object); |
| 3844 | extern Lisp_Object emacs_readlinkat (int, const char *); |
| 3845 | extern bool file_directory_p (const char *); |
| 3846 | extern bool file_accessible_directory_p (const char *); |
| 3847 | extern void init_fileio (void); |
| 3848 | extern void syms_of_fileio (void); |
| 3849 | extern Lisp_Object make_temp_name (Lisp_Object, bool); |
| 3850 | extern Lisp_Object Qdelete_file; |
| 3851 | extern bool check_existing (const char *); |
| 3852 | |
| 3853 | /* Defined in search.c. */ |
| 3854 | extern void shrink_regexp_cache (void); |
| 3855 | extern void restore_search_regs (void); |
| 3856 | extern void record_unwind_save_match_data (void); |
| 3857 | struct re_registers; |
| 3858 | extern struct re_pattern_buffer *compile_pattern (Lisp_Object, |
| 3859 | struct re_registers *, |
| 3860 | Lisp_Object, bool, bool); |
| 3861 | extern ptrdiff_t fast_string_match (Lisp_Object, Lisp_Object); |
| 3862 | extern ptrdiff_t fast_c_string_match_ignore_case (Lisp_Object, const char *, |
| 3863 | ptrdiff_t); |
| 3864 | extern ptrdiff_t fast_string_match_ignore_case (Lisp_Object, Lisp_Object); |
| 3865 | extern ptrdiff_t fast_looking_at (Lisp_Object, ptrdiff_t, ptrdiff_t, |
| 3866 | ptrdiff_t, ptrdiff_t, Lisp_Object); |
| 3867 | extern ptrdiff_t find_newline (ptrdiff_t, ptrdiff_t, ptrdiff_t, ptrdiff_t, |
| 3868 | ptrdiff_t, ptrdiff_t *, ptrdiff_t *, bool); |
| 3869 | extern EMACS_INT scan_newline (ptrdiff_t, ptrdiff_t, ptrdiff_t, ptrdiff_t, |
| 3870 | EMACS_INT, bool); |
| 3871 | extern ptrdiff_t find_newline_no_quit (ptrdiff_t, ptrdiff_t, |
| 3872 | ptrdiff_t, ptrdiff_t *); |
| 3873 | extern ptrdiff_t find_before_next_newline (ptrdiff_t, ptrdiff_t, |
| 3874 | ptrdiff_t, ptrdiff_t *); |
| 3875 | extern void syms_of_search (void); |
| 3876 | extern void clear_regexp_cache (void); |
| 3877 | |
| 3878 | /* Defined in minibuf.c. */ |
| 3879 | |
| 3880 | extern Lisp_Object Qcompletion_ignore_case; |
| 3881 | extern Lisp_Object Vminibuffer_list; |
| 3882 | extern Lisp_Object last_minibuf_string; |
| 3883 | extern Lisp_Object get_minibuffer (EMACS_INT); |
| 3884 | extern void init_minibuf_once (void); |
| 3885 | extern void syms_of_minibuf (void); |
| 3886 | |
| 3887 | /* Defined in callint.c. */ |
| 3888 | |
| 3889 | extern Lisp_Object Qminus, Qplus; |
| 3890 | extern Lisp_Object Qwhen; |
| 3891 | extern Lisp_Object Qmouse_leave_buffer_hook; |
| 3892 | extern void syms_of_callint (void); |
| 3893 | |
| 3894 | /* Defined in casefiddle.c. */ |
| 3895 | |
| 3896 | extern Lisp_Object Qidentity; |
| 3897 | extern void syms_of_casefiddle (void); |
| 3898 | extern void keys_of_casefiddle (void); |
| 3899 | |
| 3900 | /* Defined in casetab.c. */ |
| 3901 | |
| 3902 | extern void init_casetab_once (void); |
| 3903 | extern void syms_of_casetab (void); |
| 3904 | |
| 3905 | /* Defined in keyboard.c. */ |
| 3906 | |
| 3907 | extern Lisp_Object echo_message_buffer; |
| 3908 | extern struct kboard *echo_kboard; |
| 3909 | extern void cancel_echoing (void); |
| 3910 | extern Lisp_Object Qdisabled, QCfilter; |
| 3911 | extern Lisp_Object Qup, Qdown, Qbottom; |
| 3912 | extern Lisp_Object Qtop; |
| 3913 | extern Lisp_Object last_undo_boundary; |
| 3914 | extern bool input_pending; |
| 3915 | extern Lisp_Object menu_bar_items (Lisp_Object); |
| 3916 | extern Lisp_Object tool_bar_items (Lisp_Object, int *); |
| 3917 | extern void discard_mouse_events (void); |
| 3918 | #ifdef USABLE_SIGIO |
| 3919 | void handle_input_available_signal (int); |
| 3920 | #endif |
| 3921 | extern Lisp_Object pending_funcalls; |
| 3922 | extern bool detect_input_pending (void); |
| 3923 | extern bool detect_input_pending_ignore_squeezables (void); |
| 3924 | extern bool detect_input_pending_run_timers (bool); |
| 3925 | extern void safe_run_hooks (Lisp_Object); |
| 3926 | extern void cmd_error_internal (Lisp_Object, const char *); |
| 3927 | extern Lisp_Object command_loop_1 (void); |
| 3928 | extern Lisp_Object recursive_edit_1 (void); |
| 3929 | extern void record_auto_save (void); |
| 3930 | extern void force_auto_save_soon (void); |
| 3931 | extern void init_keyboard (void); |
| 3932 | extern void syms_of_keyboard (void); |
| 3933 | extern void keys_of_keyboard (void); |
| 3934 | |
| 3935 | /* Defined in indent.c. */ |
| 3936 | extern ptrdiff_t current_column (void); |
| 3937 | extern void invalidate_current_column (void); |
| 3938 | extern bool indented_beyond_p (ptrdiff_t, ptrdiff_t, EMACS_INT); |
| 3939 | extern void syms_of_indent (void); |
| 3940 | |
| 3941 | /* Defined in frame.c. */ |
| 3942 | extern Lisp_Object Qonly, Qnone; |
| 3943 | extern Lisp_Object Qvisible; |
| 3944 | extern void store_frame_param (struct frame *, Lisp_Object, Lisp_Object); |
| 3945 | extern void store_in_alist (Lisp_Object *, Lisp_Object, Lisp_Object); |
| 3946 | extern Lisp_Object do_switch_frame (Lisp_Object, int, int, Lisp_Object); |
| 3947 | #if HAVE_NS || defined WINDOWSNT |
| 3948 | extern Lisp_Object get_frame_param (struct frame *, Lisp_Object); |
| 3949 | #endif |
| 3950 | extern void frames_discard_buffer (Lisp_Object); |
| 3951 | extern void syms_of_frame (void); |
| 3952 | |
| 3953 | /* Defined in emacs.c. */ |
| 3954 | extern char **initial_argv; |
| 3955 | extern int initial_argc; |
| 3956 | #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS) |
| 3957 | extern bool display_arg; |
| 3958 | #endif |
| 3959 | extern Lisp_Object decode_env_path (const char *, const char *); |
| 3960 | extern Lisp_Object empty_unibyte_string, empty_multibyte_string; |
| 3961 | extern Lisp_Object Qfile_name_handler_alist; |
| 3962 | extern _Noreturn void terminate_due_to_signal (int, int); |
| 3963 | extern Lisp_Object Qkill_emacs; |
| 3964 | #ifdef WINDOWSNT |
| 3965 | extern Lisp_Object Vlibrary_cache; |
| 3966 | #endif |
| 3967 | #if HAVE_SETLOCALE |
| 3968 | void fixup_locale (void); |
| 3969 | void synchronize_system_messages_locale (void); |
| 3970 | void synchronize_system_time_locale (void); |
| 3971 | #else |
| 3972 | LISP_INLINE void fixup_locale (void) {} |
| 3973 | LISP_INLINE void synchronize_system_messages_locale (void) {} |
| 3974 | LISP_INLINE void synchronize_system_time_locale (void) {} |
| 3975 | #endif |
| 3976 | extern void shut_down_emacs (int, Lisp_Object); |
| 3977 | |
| 3978 | /* True means don't do interactive redisplay and don't change tty modes. */ |
| 3979 | extern bool noninteractive; |
| 3980 | |
| 3981 | /* True means remove site-lisp directories from load-path. */ |
| 3982 | extern bool no_site_lisp; |
| 3983 | |
| 3984 | /* Pipe used to send exit notification to the daemon parent at |
| 3985 | startup. */ |
| 3986 | extern int daemon_pipe[2]; |
| 3987 | #define IS_DAEMON (daemon_pipe[1] != 0) |
| 3988 | |
| 3989 | /* True if handling a fatal error already. */ |
| 3990 | extern bool fatal_error_in_progress; |
| 3991 | |
| 3992 | /* True means don't do use window-system-specific display code. */ |
| 3993 | extern bool inhibit_window_system; |
| 3994 | /* True means that a filter or a sentinel is running. */ |
| 3995 | extern bool running_asynch_code; |
| 3996 | |
| 3997 | /* Defined in process.c. */ |
| 3998 | extern Lisp_Object QCtype, Qlocal; |
| 3999 | extern Lisp_Object Qprocessp; |
| 4000 | extern void kill_buffer_processes (Lisp_Object); |
| 4001 | extern bool wait_reading_process_output (intmax_t, int, int, bool, |
| 4002 | Lisp_Object, |
| 4003 | struct Lisp_Process *, |
| 4004 | int); |
| 4005 | /* Max value for the first argument of wait_reading_process_output. */ |
| 4006 | #if __GNUC__ == 3 || (__GNUC__ == 4 && __GNUC_MINOR__ <= 5) |
| 4007 | /* Work around a bug in GCC 3.4.2, known to be fixed in GCC 4.6.3. |
| 4008 | The bug merely causes a bogus warning, but the warning is annoying. */ |
| 4009 | # define WAIT_READING_MAX min (TYPE_MAXIMUM (time_t), INTMAX_MAX) |
| 4010 | #else |
| 4011 | # define WAIT_READING_MAX INTMAX_MAX |
| 4012 | #endif |
| 4013 | extern void add_keyboard_wait_descriptor (int); |
| 4014 | extern void delete_keyboard_wait_descriptor (int); |
| 4015 | #ifdef HAVE_GPM |
| 4016 | extern void add_gpm_wait_descriptor (int); |
| 4017 | extern void delete_gpm_wait_descriptor (int); |
| 4018 | #endif |
| 4019 | extern void init_process_emacs (void); |
| 4020 | extern void syms_of_process (void); |
| 4021 | extern void setup_process_coding_systems (Lisp_Object); |
| 4022 | |
| 4023 | /* Defined in callproc.c. */ |
| 4024 | #ifndef DOS_NT |
| 4025 | _Noreturn |
| 4026 | #endif |
| 4027 | extern int child_setup (int, int, int, char **, bool, Lisp_Object); |
| 4028 | extern void init_callproc_1 (void); |
| 4029 | extern void init_callproc (void); |
| 4030 | extern void set_initial_environment (void); |
| 4031 | extern void syms_of_callproc (void); |
| 4032 | |
| 4033 | /* Defined in doc.c. */ |
| 4034 | extern Lisp_Object Qfunction_documentation; |
| 4035 | extern Lisp_Object read_doc_string (Lisp_Object); |
| 4036 | extern Lisp_Object get_doc_string (Lisp_Object, bool, bool); |
| 4037 | extern void syms_of_doc (void); |
| 4038 | extern int read_bytecode_char (bool); |
| 4039 | |
| 4040 | /* Defined in bytecode.c. */ |
| 4041 | extern void syms_of_bytecode (void); |
| 4042 | extern struct byte_stack *byte_stack_list; |
| 4043 | #if BYTE_MARK_STACK |
| 4044 | extern void mark_byte_stack (void); |
| 4045 | #endif |
| 4046 | extern void unmark_byte_stack (void); |
| 4047 | extern Lisp_Object exec_byte_code (Lisp_Object, Lisp_Object, Lisp_Object, |
| 4048 | Lisp_Object, ptrdiff_t, Lisp_Object *); |
| 4049 | |
| 4050 | /* Defined in macros.c. */ |
| 4051 | extern void init_macros (void); |
| 4052 | extern void syms_of_macros (void); |
| 4053 | |
| 4054 | /* Defined in undo.c. */ |
| 4055 | extern Lisp_Object Qapply; |
| 4056 | extern Lisp_Object Qinhibit_read_only; |
| 4057 | extern void truncate_undo_list (struct buffer *); |
| 4058 | extern void record_marker_adjustment (Lisp_Object, ptrdiff_t); |
| 4059 | extern void record_insert (ptrdiff_t, ptrdiff_t); |
| 4060 | extern void record_delete (ptrdiff_t, Lisp_Object); |
| 4061 | extern void record_first_change (void); |
| 4062 | extern void record_change (ptrdiff_t, ptrdiff_t); |
| 4063 | extern void record_property_change (ptrdiff_t, ptrdiff_t, |
| 4064 | Lisp_Object, Lisp_Object, |
| 4065 | Lisp_Object); |
| 4066 | extern void syms_of_undo (void); |
| 4067 | /* Defined in textprop.c. */ |
| 4068 | extern Lisp_Object Qfont, Qmouse_face; |
| 4069 | extern Lisp_Object Qinsert_in_front_hooks, Qinsert_behind_hooks; |
| 4070 | extern Lisp_Object Qfront_sticky, Qrear_nonsticky; |
| 4071 | extern Lisp_Object Qminibuffer_prompt; |
| 4072 | |
| 4073 | extern void report_interval_modification (Lisp_Object, Lisp_Object); |
| 4074 | |
| 4075 | /* Defined in menu.c. */ |
| 4076 | extern void syms_of_menu (void); |
| 4077 | |
| 4078 | /* Defined in xmenu.c. */ |
| 4079 | extern void syms_of_xmenu (void); |
| 4080 | |
| 4081 | /* Defined in termchar.h. */ |
| 4082 | struct tty_display_info; |
| 4083 | |
| 4084 | /* Defined in termhooks.h. */ |
| 4085 | struct terminal; |
| 4086 | |
| 4087 | /* Defined in sysdep.c. */ |
| 4088 | #ifndef HAVE_GET_CURRENT_DIR_NAME |
| 4089 | extern char *get_current_dir_name (void); |
| 4090 | #endif |
| 4091 | extern void stuff_char (char c); |
| 4092 | extern void init_foreground_group (void); |
| 4093 | extern void init_sigio (int); |
| 4094 | extern void sys_subshell (void); |
| 4095 | extern void sys_suspend (void); |
| 4096 | extern void discard_tty_input (void); |
| 4097 | extern void block_tty_out_signal (void); |
| 4098 | extern void unblock_tty_out_signal (void); |
| 4099 | extern void init_sys_modes (struct tty_display_info *); |
| 4100 | extern void reset_sys_modes (struct tty_display_info *); |
| 4101 | extern void init_all_sys_modes (void); |
| 4102 | extern void reset_all_sys_modes (void); |
| 4103 | extern void flush_pending_output (int) ATTRIBUTE_CONST; |
| 4104 | extern void child_setup_tty (int); |
| 4105 | extern void setup_pty (int); |
| 4106 | extern int set_window_size (int, int, int); |
| 4107 | extern EMACS_INT get_random (void); |
| 4108 | extern void seed_random (void *, ptrdiff_t); |
| 4109 | extern void init_random (void); |
| 4110 | extern void emacs_backtrace (int); |
| 4111 | extern _Noreturn void emacs_abort (void) NO_INLINE; |
| 4112 | extern int emacs_open (const char *, int, int); |
| 4113 | extern int emacs_pipe (int[2]); |
| 4114 | extern int emacs_close (int); |
| 4115 | extern ptrdiff_t emacs_read (int, char *, ptrdiff_t); |
| 4116 | extern ptrdiff_t emacs_write (int, const char *, ptrdiff_t); |
| 4117 | extern ptrdiff_t emacs_write_sig (int, char const *, ptrdiff_t); |
| 4118 | extern void emacs_perror (char const *); |
| 4119 | |
| 4120 | extern void unlock_all_files (void); |
| 4121 | extern void lock_file (Lisp_Object); |
| 4122 | extern void unlock_file (Lisp_Object); |
| 4123 | extern void unlock_buffer (struct buffer *); |
| 4124 | extern void syms_of_filelock (void); |
| 4125 | |
| 4126 | /* Defined in sound.c. */ |
| 4127 | extern void syms_of_sound (void); |
| 4128 | |
| 4129 | /* Defined in category.c. */ |
| 4130 | extern void init_category_once (void); |
| 4131 | extern Lisp_Object char_category_set (int); |
| 4132 | extern void syms_of_category (void); |
| 4133 | |
| 4134 | /* Defined in ccl.c. */ |
| 4135 | extern void syms_of_ccl (void); |
| 4136 | |
| 4137 | /* Defined in dired.c. */ |
| 4138 | extern void syms_of_dired (void); |
| 4139 | extern Lisp_Object directory_files_internal (Lisp_Object, Lisp_Object, |
| 4140 | Lisp_Object, Lisp_Object, |
| 4141 | bool, Lisp_Object); |
| 4142 | |
| 4143 | /* Defined in term.c. */ |
| 4144 | extern int *char_ins_del_vector; |
| 4145 | extern void syms_of_term (void); |
| 4146 | extern _Noreturn void fatal (const char *msgid, ...) |
| 4147 | ATTRIBUTE_FORMAT_PRINTF (1, 2); |
| 4148 | |
| 4149 | /* Defined in terminal.c. */ |
| 4150 | extern void syms_of_terminal (void); |
| 4151 | |
| 4152 | /* Defined in font.c. */ |
| 4153 | extern void syms_of_font (void); |
| 4154 | extern void init_font (void); |
| 4155 | |
| 4156 | #ifdef HAVE_WINDOW_SYSTEM |
| 4157 | /* Defined in fontset.c. */ |
| 4158 | extern void syms_of_fontset (void); |
| 4159 | |
| 4160 | /* Defined in xfns.c, w32fns.c, or macfns.c. */ |
| 4161 | extern Lisp_Object Qfont_param; |
| 4162 | #endif |
| 4163 | |
| 4164 | /* Defined in gfilenotify.c */ |
| 4165 | #ifdef HAVE_GFILENOTIFY |
| 4166 | extern void globals_of_gfilenotify (void); |
| 4167 | extern void syms_of_gfilenotify (void); |
| 4168 | #endif |
| 4169 | |
| 4170 | /* Defined in inotify.c */ |
| 4171 | #ifdef HAVE_INOTIFY |
| 4172 | extern void syms_of_inotify (void); |
| 4173 | #endif |
| 4174 | |
| 4175 | #ifdef HAVE_W32NOTIFY |
| 4176 | /* Defined on w32notify.c. */ |
| 4177 | extern void syms_of_w32notify (void); |
| 4178 | #endif |
| 4179 | |
| 4180 | /* Defined in xfaces.c. */ |
| 4181 | extern Lisp_Object Qdefault, Qtool_bar, Qfringe; |
| 4182 | extern Lisp_Object Qheader_line, Qscroll_bar, Qcursor; |
| 4183 | extern Lisp_Object Qmode_line_inactive; |
| 4184 | extern Lisp_Object Qface; |
| 4185 | extern Lisp_Object Qnormal; |
| 4186 | extern Lisp_Object QCfamily, QCweight, QCslant; |
| 4187 | extern Lisp_Object QCheight, QCname, QCwidth, QCforeground, QCbackground; |
| 4188 | extern Lisp_Object Qextra_light, Qlight, Qsemi_light, Qsemi_bold; |
| 4189 | extern Lisp_Object Qbold, Qextra_bold, Qultra_bold; |
| 4190 | extern Lisp_Object Qoblique, Qitalic; |
| 4191 | extern Lisp_Object Vface_alternative_font_family_alist; |
| 4192 | extern Lisp_Object Vface_alternative_font_registry_alist; |
| 4193 | extern void syms_of_xfaces (void); |
| 4194 | |
| 4195 | #ifdef HAVE_X_WINDOWS |
| 4196 | /* Defined in xfns.c. */ |
| 4197 | extern void syms_of_xfns (void); |
| 4198 | |
| 4199 | /* Defined in xsmfns.c. */ |
| 4200 | extern void syms_of_xsmfns (void); |
| 4201 | |
| 4202 | /* Defined in xselect.c. */ |
| 4203 | extern void syms_of_xselect (void); |
| 4204 | |
| 4205 | /* Defined in xterm.c. */ |
| 4206 | extern void syms_of_xterm (void); |
| 4207 | #endif /* HAVE_X_WINDOWS */ |
| 4208 | |
| 4209 | #ifdef HAVE_WINDOW_SYSTEM |
| 4210 | /* Defined in xterm.c, nsterm.m, w32term.c. */ |
| 4211 | extern char *x_get_keysym_name (int); |
| 4212 | #endif /* HAVE_WINDOW_SYSTEM */ |
| 4213 | |
| 4214 | #ifdef HAVE_LIBXML2 |
| 4215 | /* Defined in xml.c. */ |
| 4216 | extern void syms_of_xml (void); |
| 4217 | extern void xml_cleanup_parser (void); |
| 4218 | #endif |
| 4219 | |
| 4220 | #ifdef HAVE_DBUS |
| 4221 | /* Defined in dbusbind.c. */ |
| 4222 | void syms_of_dbusbind (void); |
| 4223 | #endif |
| 4224 | |
| 4225 | |
| 4226 | /* Defined in profiler.c. */ |
| 4227 | extern bool profiler_memory_running; |
| 4228 | extern void malloc_probe (size_t); |
| 4229 | extern void syms_of_profiler (void); |
| 4230 | |
| 4231 | |
| 4232 | #ifdef DOS_NT |
| 4233 | /* Defined in msdos.c, w32.c. */ |
| 4234 | extern char *emacs_root_dir (void); |
| 4235 | #endif /* DOS_NT */ |
| 4236 | \f |
| 4237 | /* True means Emacs has already been initialized. |
| 4238 | Used during startup to detect startup of dumped Emacs. */ |
| 4239 | extern bool initialized; |
| 4240 | |
| 4241 | /* True means ^G can quit instantly. */ |
| 4242 | extern bool immediate_quit; |
| 4243 | |
| 4244 | extern void *xmalloc (size_t); |
| 4245 | extern void *xzalloc (size_t); |
| 4246 | extern void *xrealloc (void *, size_t); |
| 4247 | extern void xfree (void *); |
| 4248 | extern void *xnmalloc (ptrdiff_t, ptrdiff_t); |
| 4249 | extern void *xnrealloc (void *, ptrdiff_t, ptrdiff_t); |
| 4250 | extern void *xpalloc (void *, ptrdiff_t *, ptrdiff_t, ptrdiff_t, ptrdiff_t); |
| 4251 | |
| 4252 | extern char *xstrdup (const char *); |
| 4253 | extern void xputenv (const char *); |
| 4254 | |
| 4255 | extern char *egetenv (const char *); |
| 4256 | |
| 4257 | /* Set up the name of the machine we're running on. */ |
| 4258 | extern void init_system_name (void); |
| 4259 | |
| 4260 | /* Return the absolute value of X. X should be a signed integer |
| 4261 | expression without side effects, and X's absolute value should not |
| 4262 | exceed the maximum for its promoted type. This is called 'eabs' |
| 4263 | because 'abs' is reserved by the C standard. */ |
| 4264 | #define eabs(x) ((x) < 0 ? -(x) : (x)) |
| 4265 | |
| 4266 | /* Return a fixnum or float, depending on whether VAL fits in a Lisp |
| 4267 | fixnum. */ |
| 4268 | |
| 4269 | #define make_fixnum_or_float(val) \ |
| 4270 | (FIXNUM_OVERFLOW_P (val) ? make_float (val) : make_number (val)) |
| 4271 | |
| 4272 | /* SAFE_ALLOCA normally allocates memory on the stack, but if size is |
| 4273 | larger than MAX_ALLOCA, use xmalloc to avoid overflowing the stack. */ |
| 4274 | |
| 4275 | enum MAX_ALLOCA { MAX_ALLOCA = 16 * 1024 }; |
| 4276 | |
| 4277 | extern void *record_xmalloc (size_t); |
| 4278 | |
| 4279 | #define USE_SAFE_ALLOCA \ |
| 4280 | ptrdiff_t sa_count = SPECPDL_INDEX (); bool sa_must_free = 0 |
| 4281 | |
| 4282 | /* SAFE_ALLOCA allocates a simple buffer. */ |
| 4283 | |
| 4284 | #define SAFE_ALLOCA(size) ((size) < MAX_ALLOCA \ |
| 4285 | ? alloca (size) \ |
| 4286 | : (sa_must_free = 1, record_xmalloc (size))) |
| 4287 | |
| 4288 | /* SAFE_NALLOCA sets BUF to a newly allocated array of MULTIPLIER * |
| 4289 | NITEMS items, each of the same type as *BUF. MULTIPLIER must |
| 4290 | positive. The code is tuned for MULTIPLIER being a constant. */ |
| 4291 | |
| 4292 | #define SAFE_NALLOCA(buf, multiplier, nitems) \ |
| 4293 | do { \ |
| 4294 | if ((nitems) <= MAX_ALLOCA / sizeof *(buf) / (multiplier)) \ |
| 4295 | (buf) = alloca (sizeof *(buf) * (multiplier) * (nitems)); \ |
| 4296 | else \ |
| 4297 | { \ |
| 4298 | (buf) = xnmalloc (nitems, sizeof *(buf) * (multiplier)); \ |
| 4299 | sa_must_free = 1; \ |
| 4300 | record_unwind_protect_ptr (xfree, buf); \ |
| 4301 | } \ |
| 4302 | } while (0) |
| 4303 | |
| 4304 | /* SAFE_FREE frees xmalloced memory and enables GC as needed. */ |
| 4305 | |
| 4306 | #define SAFE_FREE() \ |
| 4307 | do { \ |
| 4308 | if (sa_must_free) { \ |
| 4309 | sa_must_free = 0; \ |
| 4310 | unbind_to (sa_count, Qnil); \ |
| 4311 | } \ |
| 4312 | } while (0) |
| 4313 | |
| 4314 | |
| 4315 | /* SAFE_ALLOCA_LISP allocates an array of Lisp_Objects. */ |
| 4316 | |
| 4317 | #define SAFE_ALLOCA_LISP(buf, nelt) \ |
| 4318 | do { \ |
| 4319 | if ((nelt) < MAX_ALLOCA / word_size) \ |
| 4320 | buf = alloca ((nelt) * word_size); \ |
| 4321 | else if ((nelt) < min (PTRDIFF_MAX, SIZE_MAX) / word_size) \ |
| 4322 | { \ |
| 4323 | Lisp_Object arg_; \ |
| 4324 | buf = xmalloc ((nelt) * word_size); \ |
| 4325 | arg_ = make_save_value (SAVE_TYPE_MEMORY, buf, nelt); \ |
| 4326 | sa_must_free = 1; \ |
| 4327 | record_unwind_protect (free_save_value, arg_); \ |
| 4328 | } \ |
| 4329 | else \ |
| 4330 | memory_full (SIZE_MAX); \ |
| 4331 | } while (0) |
| 4332 | |
| 4333 | |
| 4334 | /* Check whether it's time for GC, and run it if so. */ |
| 4335 | |
| 4336 | LISP_INLINE void |
| 4337 | maybe_gc (void) |
| 4338 | { |
| 4339 | if ((consing_since_gc > gc_cons_threshold |
| 4340 | && consing_since_gc > gc_relative_threshold) |
| 4341 | || (!NILP (Vmemory_full) |
| 4342 | && consing_since_gc > memory_full_cons_threshold)) |
| 4343 | Fgarbage_collect (); |
| 4344 | } |
| 4345 | |
| 4346 | LISP_INLINE bool |
| 4347 | functionp (Lisp_Object object) |
| 4348 | { |
| 4349 | if (SYMBOLP (object) && !NILP (Ffboundp (object))) |
| 4350 | { |
| 4351 | object = Findirect_function (object, Qt); |
| 4352 | |
| 4353 | if (CONSP (object) && EQ (XCAR (object), Qautoload)) |
| 4354 | { |
| 4355 | /* Autoloaded symbols are functions, except if they load |
| 4356 | macros or keymaps. */ |
| 4357 | int i; |
| 4358 | for (i = 0; i < 4 && CONSP (object); i++) |
| 4359 | object = XCDR (object); |
| 4360 | |
| 4361 | return ! (CONSP (object) && !NILP (XCAR (object))); |
| 4362 | } |
| 4363 | } |
| 4364 | |
| 4365 | if (SUBRP (object)) |
| 4366 | return XSUBR (object)->max_args != UNEVALLED; |
| 4367 | else if (COMPILEDP (object)) |
| 4368 | return 1; |
| 4369 | else if (CONSP (object)) |
| 4370 | { |
| 4371 | Lisp_Object car = XCAR (object); |
| 4372 | return EQ (car, Qlambda) || EQ (car, Qclosure); |
| 4373 | } |
| 4374 | else |
| 4375 | return 0; |
| 4376 | } |
| 4377 | |
| 4378 | INLINE_HEADER_END |
| 4379 | |
| 4380 | #endif /* EMACS_LISP_H */ |