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