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