]>
Commit | Line | Data |
---|---|---|
7f2935c7 | 1 | /* Definitions for CPP library. |
2398fb2a RB |
2 | Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000 |
3 | Free Software Foundation, Inc. | |
7f2935c7 PB |
4 | Written by Per Bothner, 1994-95. |
5 | ||
6 | This program is free software; you can redistribute it and/or modify it | |
7 | under the terms of the GNU General Public License as published by the | |
8 | Free Software Foundation; either version 2, or (at your option) any | |
9 | later version. | |
10 | ||
11 | This program is distributed in the hope that it will be useful, | |
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 | GNU General Public License for more details. | |
15 | ||
16 | You should have received a copy of the GNU General Public License | |
17 | along with this program; if not, write to the Free Software | |
940d9d63 | 18 | Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
7f2935c7 PB |
19 | |
20 | In other words, you are welcome to use, share and improve this program. | |
21 | You are forbidden to forbid anyone else to use, share and improve | |
22 | what you give them. Help stamp out software-hoarding! */ | |
990c642c JL |
23 | #ifndef __GCC_CPPLIB__ |
24 | #define __GCC_CPPLIB__ | |
7f2935c7 PB |
25 | |
26 | #include <sys/types.h> | |
7f2935c7 PB |
27 | |
28 | #ifdef __cplusplus | |
29 | extern "C" { | |
30 | #endif | |
31 | ||
8b97c5f8 ZW |
32 | /* For complex reasons, cpp_reader is also typedefed in c-pragma.h. */ |
33 | #ifndef _C_PRAGMA_H | |
7f2935c7 | 34 | typedef struct cpp_reader cpp_reader; |
8b97c5f8 | 35 | #endif |
7f2935c7 PB |
36 | typedef struct cpp_buffer cpp_buffer; |
37 | typedef struct cpp_options cpp_options; | |
1368ee70 | 38 | typedef struct cpp_token cpp_token; |
bfb9dc7f | 39 | typedef struct cpp_string cpp_string; |
f8f769ea | 40 | typedef struct cpp_hashnode cpp_hashnode; |
93c80368 NB |
41 | typedef struct cpp_pool cpp_pool; |
42 | typedef struct cpp_macro cpp_macro; | |
43 | typedef struct cpp_lexer_pos cpp_lexer_pos; | |
44 | typedef struct cpp_lookahead cpp_lookahead; | |
45 | ||
46 | struct directive; /* These are deliberately incomplete. */ | |
47 | struct answer; | |
48 | struct cpp_macro; | |
49 | struct macro_args; | |
50 | struct cpp_chunk; | |
51 | struct file_name_map_list; | |
52 | struct htab; | |
c5a04734 ZW |
53 | |
54 | /* The first two groups, apart from '=', can appear in preprocessor | |
55 | expressions. This allows a lookup table to be implemented in | |
56 | _cpp_parse_expr. | |
57 | ||
58 | The first group, to CPP_LAST_EQ, can be immediately followed by an | |
59 | '='. The lexer needs operators ending in '=', like ">>=", to be in | |
60 | the same order as their counterparts without the '=', like ">>". */ | |
61 | ||
62 | /* Positions in the table. */ | |
6fee6033 | 63 | #define CPP_LAST_EQ CPP_MAX |
c5a04734 | 64 | #define CPP_FIRST_DIGRAPH CPP_HASH |
9ec7291f | 65 | #define CPP_LAST_PUNCTUATOR CPP_DOT_STAR |
1368ee70 | 66 | |
1368ee70 | 67 | #define TTYPE_TABLE \ |
96be6998 ZW |
68 | OP(CPP_EQ = 0, "=") \ |
69 | OP(CPP_NOT, "!") \ | |
70 | OP(CPP_GREATER, ">") /* compare */ \ | |
71 | OP(CPP_LESS, "<") \ | |
72 | OP(CPP_PLUS, "+") /* math */ \ | |
73 | OP(CPP_MINUS, "-") \ | |
74 | OP(CPP_MULT, "*") \ | |
75 | OP(CPP_DIV, "/") \ | |
76 | OP(CPP_MOD, "%") \ | |
77 | OP(CPP_AND, "&") /* bit ops */ \ | |
78 | OP(CPP_OR, "|") \ | |
79 | OP(CPP_XOR, "^") \ | |
80 | OP(CPP_RSHIFT, ">>") \ | |
81 | OP(CPP_LSHIFT, "<<") \ | |
92936ecf ZW |
82 | OP(CPP_MIN, "<?") /* extension */ \ |
83 | OP(CPP_MAX, ">?") \ | |
c5a04734 | 84 | \ |
96be6998 ZW |
85 | OP(CPP_COMPL, "~") \ |
86 | OP(CPP_AND_AND, "&&") /* logical */ \ | |
87 | OP(CPP_OR_OR, "||") \ | |
88 | OP(CPP_QUERY, "?") \ | |
89 | OP(CPP_COLON, ":") \ | |
90 | OP(CPP_COMMA, ",") /* grouping */ \ | |
91 | OP(CPP_OPEN_PAREN, "(") \ | |
92 | OP(CPP_CLOSE_PAREN, ")") \ | |
93 | OP(CPP_EQ_EQ, "==") /* compare */ \ | |
94 | OP(CPP_NOT_EQ, "!=") \ | |
95 | OP(CPP_GREATER_EQ, ">=") \ | |
96 | OP(CPP_LESS_EQ, "<=") \ | |
1368ee70 | 97 | \ |
96be6998 ZW |
98 | OP(CPP_PLUS_EQ, "+=") /* math */ \ |
99 | OP(CPP_MINUS_EQ, "-=") \ | |
100 | OP(CPP_MULT_EQ, "*=") \ | |
101 | OP(CPP_DIV_EQ, "/=") \ | |
102 | OP(CPP_MOD_EQ, "%=") \ | |
103 | OP(CPP_AND_EQ, "&=") /* bit ops */ \ | |
104 | OP(CPP_OR_EQ, "|=") \ | |
105 | OP(CPP_XOR_EQ, "^=") \ | |
106 | OP(CPP_RSHIFT_EQ, ">>=") \ | |
107 | OP(CPP_LSHIFT_EQ, "<<=") \ | |
92936ecf ZW |
108 | OP(CPP_MIN_EQ, "<?=") /* extension */ \ |
109 | OP(CPP_MAX_EQ, ">?=") \ | |
c5a04734 | 110 | /* Digraphs together, beginning with CPP_FIRST_DIGRAPH. */ \ |
96be6998 ZW |
111 | OP(CPP_HASH, "#") /* digraphs */ \ |
112 | OP(CPP_PASTE, "##") \ | |
113 | OP(CPP_OPEN_SQUARE, "[") \ | |
114 | OP(CPP_CLOSE_SQUARE, "]") \ | |
115 | OP(CPP_OPEN_BRACE, "{") \ | |
116 | OP(CPP_CLOSE_BRACE, "}") \ | |
117 | /* The remainder of the punctuation. Order is not significant. */ \ | |
118 | OP(CPP_SEMICOLON, ";") /* structure */ \ | |
119 | OP(CPP_ELLIPSIS, "...") \ | |
96be6998 ZW |
120 | OP(CPP_PLUS_PLUS, "++") /* increment */ \ |
121 | OP(CPP_MINUS_MINUS, "--") \ | |
122 | OP(CPP_DEREF, "->") /* accessors */ \ | |
123 | OP(CPP_DOT, ".") \ | |
124 | OP(CPP_SCOPE, "::") \ | |
125 | OP(CPP_DEREF_STAR, "->*") \ | |
126 | OP(CPP_DOT_STAR, ".*") \ | |
1368ee70 | 127 | \ |
96be6998 ZW |
128 | TK(CPP_NAME, SPELL_IDENT) /* word */ \ |
129 | TK(CPP_INT, SPELL_STRING) /* 23 */ \ | |
130 | TK(CPP_FLOAT, SPELL_STRING) /* 3.14159 */ \ | |
131 | TK(CPP_NUMBER, SPELL_STRING) /* 34_be+ta */ \ | |
1368ee70 | 132 | \ |
96be6998 ZW |
133 | TK(CPP_CHAR, SPELL_STRING) /* 'char' */ \ |
134 | TK(CPP_WCHAR, SPELL_STRING) /* L'char' */ \ | |
135 | TK(CPP_OTHER, SPELL_CHAR) /* stray punctuation */ \ | |
136 | \ | |
137 | TK(CPP_STRING, SPELL_STRING) /* "string" */ \ | |
138 | TK(CPP_WSTRING, SPELL_STRING) /* L"string" */ \ | |
ba89d661 | 139 | TK(CPP_OSTRING, SPELL_STRING) /* @"string" - Objective C */ \ |
96be6998 ZW |
140 | TK(CPP_HEADER_NAME, SPELL_STRING) /* <stdio.h> in #include */ \ |
141 | \ | |
142 | TK(CPP_COMMENT, SPELL_STRING) /* Only if output comments. */ \ | |
143 | TK(CPP_MACRO_ARG, SPELL_NONE) /* Macro argument. */ \ | |
93c80368 | 144 | OP(CPP_EOF, "EOL") /* End of line or file. */ |
1368ee70 | 145 | |
96be6998 ZW |
146 | #define OP(e, s) e, |
147 | #define TK(e, s) e, | |
3a2b2c7a | 148 | enum cpp_ttype |
c45da1ca | 149 | { |
1368ee70 ZW |
150 | TTYPE_TABLE |
151 | N_TTYPES | |
152 | }; | |
96be6998 ZW |
153 | #undef OP |
154 | #undef TK | |
1368ee70 | 155 | |
dd07b884 NB |
156 | /* C language kind, used when calling cpp_reader_init. */ |
157 | enum c_lang {CLK_GNUC89 = 0, CLK_GNUC99, CLK_STDC89, CLK_STDC94, CLK_STDC99, | |
158 | CLK_GNUCXX, CLK_CXX98, CLK_OBJC, CLK_OBJCXX, CLK_ASM}; | |
159 | ||
93c80368 NB |
160 | /* Multiple-include optimisation. */ |
161 | enum mi_state {MI_FAILED = 0, MI_OUTSIDE}; | |
162 | enum mi_ind {MI_IND_NONE = 0, MI_IND_NOT}; | |
163 | ||
bfb9dc7f ZW |
164 | /* Payload of a NUMBER, FLOAT, STRING, or COMMENT token. */ |
165 | struct cpp_string | |
1368ee70 ZW |
166 | { |
167 | unsigned int len; | |
f617b8e2 | 168 | const unsigned char *text; |
1368ee70 ZW |
169 | }; |
170 | ||
c5a04734 | 171 | /* Flags for the cpp_token structure. */ |
041c3194 | 172 | #define PREV_WHITE (1 << 0) /* If whitespace before this token. */ |
93c80368 NB |
173 | #define DIGRAPH (1 << 1) /* If it was a digraph. */ |
174 | #define STRINGIFY_ARG (1 << 2) /* If macro argument to be stringified. */ | |
175 | #define PASTE_LEFT (1 << 3) /* If on LHS of a ## operator. */ | |
dd07b884 | 176 | #define NAMED_OP (1 << 4) /* C++ named operators. */ |
93c80368 | 177 | #define NO_EXPAND (1 << 5) /* Do not macro-expand this token. */ |
9e62c811 | 178 | |
1920de47 | 179 | /* A preprocessing token. This has been carefully packed and should |
93c80368 | 180 | occupy 12 bytes on 32-bit hosts and 16 bytes on 64-bit hosts. */ |
1368ee70 ZW |
181 | struct cpp_token |
182 | { | |
041c3194 ZW |
183 | ENUM_BITFIELD(cpp_ttype) type : CHAR_BIT; /* token type */ |
184 | unsigned char flags; /* flags - see above */ | |
185 | ||
1368ee70 ZW |
186 | union |
187 | { | |
6c53ebff NB |
188 | struct cpp_hashnode *node; /* An identifier. */ |
189 | struct cpp_string str; /* A string, or number. */ | |
190 | unsigned int arg_no; /* Argument no. for a CPP_MACRO_ARG. */ | |
191 | unsigned char c; /* Character represented by CPP_OTHER. */ | |
1368ee70 | 192 | } val; |
7f2935c7 PB |
193 | }; |
194 | ||
93c80368 NB |
195 | /* The position of a token in the current file. */ |
196 | struct cpp_lexer_pos | |
197 | { | |
198 | unsigned int line; | |
199 | unsigned int output_line; | |
200 | unsigned short col; | |
201 | }; | |
1368ee70 | 202 | |
93c80368 NB |
203 | typedef struct cpp_token_with_pos cpp_token_with_pos; |
204 | struct cpp_token_with_pos | |
1368ee70 | 205 | { |
93c80368 NB |
206 | cpp_token token; |
207 | cpp_lexer_pos pos; | |
208 | }; | |
1368ee70 | 209 | |
93c80368 NB |
210 | /* Token lookahead. */ |
211 | struct cpp_lookahead | |
212 | { | |
213 | struct cpp_lookahead *next; | |
214 | cpp_token_with_pos *tokens; | |
215 | cpp_lexer_pos pos; | |
216 | unsigned int cur, count, cap; | |
217 | }; | |
1368ee70 | 218 | |
93c80368 NB |
219 | /* Memory pools. */ |
220 | struct cpp_pool | |
221 | { | |
222 | struct cpp_chunk *cur, *locked; | |
223 | unsigned char *pos; /* Current position. */ | |
224 | unsigned int align; | |
225 | unsigned int locks; | |
226 | }; | |
041c3194 | 227 | |
93c80368 NB |
228 | typedef struct toklist toklist; |
229 | struct toklist | |
230 | { | |
231 | cpp_token *first; | |
232 | cpp_token *limit; | |
233 | }; | |
1368ee70 | 234 | |
93c80368 NB |
235 | typedef struct cpp_context cpp_context; |
236 | struct cpp_context | |
237 | { | |
238 | /* Doubly-linked list. */ | |
239 | cpp_context *next, *prev; | |
041c3194 | 240 | |
93c80368 NB |
241 | /* Contexts other than the base context are contiguous tokens. |
242 | e.g. macro expansions, expanded argument tokens. */ | |
243 | struct toklist list; | |
15dad1d9 | 244 | |
93c80368 NB |
245 | /* For a macro context, these are the macro and its arguments. */ |
246 | cpp_macro *macro; | |
1368ee70 | 247 | }; |
7f2935c7 | 248 | |
0d9f234d NB |
249 | /* A standalone character. We may want to make it unsigned for the |
250 | same reason we use unsigned char - to avoid signedness issues. */ | |
251 | typedef int cppchar_t; | |
252 | ||
7f2935c7 PB |
253 | /* Maximum nesting of cpp_buffers. We use a static limit, partly for |
254 | efficiency, and partly to limit runaway recursion. */ | |
255 | #define CPP_STACK_MAX 200 | |
af453bb0 | 256 | |
ae79697b ZW |
257 | /* Values for opts.dump_macros. |
258 | dump_only means inhibit output of the preprocessed text | |
259 | and instead output the definitions of all user-defined | |
86702e31 | 260 | macros in a form suitable for use as input to cpp. |
ae79697b ZW |
261 | dump_names means pass #define and the macro name through to output. |
262 | dump_definitions means pass the whole definition (plus #define) through | |
263 | */ | |
264 | enum { dump_none = 0, dump_only, dump_names, dump_definitions }; | |
7f2935c7 | 265 | |
ae79697b ZW |
266 | /* This structure is nested inside struct cpp_reader, and |
267 | carries all the options visible to the command line. */ | |
268 | struct cpp_options | |
c50bca08 | 269 | { |
ae79697b ZW |
270 | /* Name of input and output files. */ |
271 | const char *in_fname; | |
272 | const char *out_fname; | |
194d7493 | 273 | |
6ab3e7dd NB |
274 | /* Characters between tab stops. */ |
275 | unsigned int tabstop; | |
276 | ||
ae79697b ZW |
277 | /* Pending options - -D, -U, -A, -I, -ixxx. */ |
278 | struct cpp_pending *pending; | |
7f2935c7 | 279 | |
ae79697b ZW |
280 | /* File name which deps are being written to. This is 0 if deps are |
281 | being written to stdout. */ | |
282 | const char *deps_file; | |
0b22d65c | 283 | |
ae79697b ZW |
284 | /* Target-name to write with the dependency information. */ |
285 | char *deps_target; | |
7f2935c7 | 286 | |
ae79697b ZW |
287 | /* Search paths for include files. */ |
288 | struct file_name_list *quote_include; /* First dir to search for "file" */ | |
289 | struct file_name_list *bracket_include;/* First dir to search for <file> */ | |
7f2935c7 | 290 | |
ae79697b ZW |
291 | /* Map between header names and file names, used only on DOS where |
292 | file names are limited in length. */ | |
7e2eb697 PB |
293 | struct file_name_map_list *map_list; |
294 | ||
ae79697b ZW |
295 | /* Directory prefix that should replace `/usr/lib/gcc-lib/TARGET/VERSION' |
296 | in the standard include file directories. */ | |
297 | const char *include_prefix; | |
298 | unsigned int include_prefix_len; | |
299 | ||
6db83155 ZW |
300 | /* -fleading_underscore sets this to "_". */ |
301 | const char *user_label_prefix; | |
302 | ||
bdb05a7b NB |
303 | /* The language we're preprocessing. */ |
304 | enum c_lang lang; | |
305 | ||
7f2935c7 | 306 | /* Non-0 means -v, so print the full set of include dirs. */ |
ae79697b | 307 | unsigned char verbose; |
7f2935c7 PB |
308 | |
309 | /* Nonzero means use extra default include directories for C++. */ | |
ae79697b | 310 | unsigned char cplusplus; |
7f2935c7 PB |
311 | |
312 | /* Nonzero means handle cplusplus style comments */ | |
ae79697b | 313 | unsigned char cplusplus_comments; |
7f2935c7 PB |
314 | |
315 | /* Nonzero means handle #import, for objective C. */ | |
ae79697b | 316 | unsigned char objc; |
7f2935c7 | 317 | |
564ad5f4 | 318 | /* Nonzero means don't copy comments into the output file. */ |
ae79697b | 319 | unsigned char discard_comments; |
7f2935c7 | 320 | |
041c3194 | 321 | /* Nonzero means process the ISO trigraph sequences. */ |
ae79697b | 322 | unsigned char trigraphs; |
7f2935c7 | 323 | |
9b55f29a NB |
324 | /* Nonzero means process the ISO digraph sequences. */ |
325 | unsigned char digraphs; | |
326 | ||
bdb05a7b NB |
327 | /* Nonzero means to allow hexadecimal floats and LL suffixes. */ |
328 | unsigned char extended_numbers; | |
329 | ||
ae79697b ZW |
330 | /* Nonzero means print the names of included files rather than the |
331 | preprocessed output. 1 means just the #include "...", 2 means | |
332 | #include <...> as well. */ | |
333 | unsigned char print_deps; | |
7f2935c7 | 334 | |
ae79697b ZW |
335 | /* Nonzero if missing .h files in -M output are assumed to be |
336 | generated files and not errors. */ | |
337 | unsigned char print_deps_missing_files; | |
7f2935c7 PB |
338 | |
339 | /* If true, fopen (deps_file, "a") else fopen (deps_file, "w"). */ | |
ae79697b | 340 | unsigned char print_deps_append; |
7f2935c7 PB |
341 | |
342 | /* Nonzero means print names of header files (-H). */ | |
ae79697b | 343 | unsigned char print_include_names; |
7f2935c7 | 344 | |
ae79697b ZW |
345 | /* Nonzero means cpp_pedwarn causes a hard error. */ |
346 | unsigned char pedantic_errors; | |
7f2935c7 | 347 | |
c1212d2f | 348 | /* Nonzero means don't print warning messages. */ |
ae79697b | 349 | unsigned char inhibit_warnings; |
7f2935c7 | 350 | |
317639a8 BC |
351 | /* Nonzero means don't suppress warnings from system headers. */ |
352 | unsigned char warn_system_headers; | |
353 | ||
ae79697b ZW |
354 | /* Nonzero means don't print error messages. Has no option to |
355 | select it, but can be set by a user of cpplib (e.g. fix-header). */ | |
356 | unsigned char inhibit_errors; | |
c1212d2f | 357 | |
7f2935c7 | 358 | /* Nonzero means warn if slash-star appears in a comment. */ |
ae79697b | 359 | unsigned char warn_comments; |
7f2935c7 PB |
360 | |
361 | /* Nonzero means warn if there are any trigraphs. */ | |
ae79697b | 362 | unsigned char warn_trigraphs; |
7f2935c7 PB |
363 | |
364 | /* Nonzero means warn if #import is used. */ | |
ae79697b | 365 | unsigned char warn_import; |
7f2935c7 | 366 | |
f9a0e96c ZW |
367 | /* Nonzero means warn about various incompatibilities with |
368 | traditional C. */ | |
07aa0b04 | 369 | unsigned char warn_traditional; |
7f2935c7 PB |
370 | |
371 | /* Nonzero means turn warnings into errors. */ | |
ae79697b | 372 | unsigned char warnings_are_errors; |
7f2935c7 | 373 | |
ae79697b ZW |
374 | /* Nonzero causes output not to be done, but directives such as |
375 | #define that have side effects are still obeyed. */ | |
376 | unsigned char no_output; | |
7f2935c7 | 377 | |
31031edd JL |
378 | /* Nonzero means we should look for header.gcc files that remap file |
379 | names. */ | |
ae79697b | 380 | unsigned char remap; |
31031edd | 381 | |
7f2935c7 | 382 | /* Nonzero means don't output line number information. */ |
ae79697b | 383 | unsigned char no_line_commands; |
7f2935c7 | 384 | |
ae79697b ZW |
385 | /* Nonzero means -I- has been seen, so don't look for #include "foo" |
386 | the source-file directory. */ | |
387 | unsigned char ignore_srcdir; | |
7f2935c7 | 388 | |
ae79697b ZW |
389 | /* Zero means dollar signs are punctuation. */ |
390 | unsigned char dollars_in_ident; | |
7f2935c7 | 391 | |
6ac34fdc | 392 | /* Nonzero means warn if undefined identifiers are evaluated in an #if. */ |
ae79697b | 393 | unsigned char warn_undef; |
6ac34fdc | 394 | |
31948547 | 395 | /* Nonzero for the 1999 C Standard, including corrigenda and amendments. */ |
ae79697b | 396 | unsigned char c99; |
31948547 | 397 | |
7f2935c7 | 398 | /* Nonzero means give all the error messages the ANSI standard requires. */ |
ae79697b | 399 | unsigned char pedantic; |
7f2935c7 | 400 | |
3773a46b JM |
401 | /* Nonzero means we're looking at already preprocessed code, so don't |
402 | bother trying to do macro expansion and whatnot. */ | |
ae79697b | 403 | unsigned char preprocessed; |
3773a46b | 404 | |
ae79697b ZW |
405 | /* Nonzero disables all the standard directories for headers. */ |
406 | unsigned char no_standard_includes; | |
7f2935c7 | 407 | |
ae79697b ZW |
408 | /* Nonzero disables the C++-specific standard directories for headers. */ |
409 | unsigned char no_standard_cplusplus_includes; | |
7f2935c7 | 410 | |
ae79697b ZW |
411 | /* Nonzero means dump macros in some fashion - see above. */ |
412 | unsigned char dump_macros; | |
7f2935c7 | 413 | |
ae79697b ZW |
414 | /* Nonzero means pass all #define and #undef directives which we |
415 | actually process through to the output stream. This feature is | |
416 | used primarily to allow cc1 to record the #defines and #undefs | |
417 | for the sake of debuggers which understand about preprocessor | |
418 | macros, but it may also be useful with -E to figure out how | |
419 | symbols are defined, and where they are defined. */ | |
420 | unsigned char debug_output; | |
7f2935c7 | 421 | |
ae79697b ZW |
422 | /* Nonzero means pass #include lines through to the output. */ |
423 | unsigned char dump_includes; | |
7f2935c7 | 424 | |
ae79697b ZW |
425 | /* Print column number in error messages. */ |
426 | unsigned char show_column; | |
be768055 JJ |
427 | |
428 | /* Treat C++ alternate operator names special. */ | |
429 | unsigned char operator_names; | |
ae79697b | 430 | }; |
7f2935c7 | 431 | |
0d9f234d NB |
432 | struct lexer_state |
433 | { | |
434 | /* Nonzero if first token on line is CPP_HASH. */ | |
435 | unsigned char in_directive; | |
436 | ||
0d9f234d NB |
437 | /* Nonzero if in a directive that takes angle-bracketed headers. */ |
438 | unsigned char angled_headers; | |
439 | ||
440 | /* Nonzero to save comments. Turned off if discard_comments, and in | |
441 | all directives apart from #define. */ | |
442 | unsigned char save_comments; | |
443 | ||
4c2b647d NB |
444 | /* If nonzero the next token is at the beginning of the line. */ |
445 | unsigned char next_bol; | |
0d9f234d | 446 | |
cbcff6df NB |
447 | /* Nonzero if we're mid-comment. */ |
448 | unsigned char lexing_comment; | |
449 | ||
93c80368 NB |
450 | /* Nonzero if lexing __VA_ARGS__ is valid. */ |
451 | unsigned char va_args_ok; | |
452 | ||
453 | /* Nonzero if lexing poisoned identifiers is valid. */ | |
454 | unsigned char poisoned_ok; | |
455 | ||
456 | /* Nonzero to prevent macro expansion. */ | |
457 | unsigned char prevent_expansion; | |
458 | ||
459 | /* Nonzero when parsing arguments to a function-like macro. */ | |
460 | unsigned char parsing_args; | |
642ce434 NB |
461 | |
462 | /* Nonzero when in a # NUMBER directive. */ | |
463 | unsigned char line_extension; | |
0d9f234d | 464 | }; |
0d9f234d | 465 | |
93c80368 NB |
466 | /* Special nodes - identifiers with predefined significance. */ |
467 | struct spec_nodes | |
468 | { | |
469 | cpp_hashnode *n_L; /* L"str" */ | |
470 | cpp_hashnode *n_defined; /* defined operator */ | |
a5c3cccd | 471 | cpp_hashnode *n__Pragma; /* _Pragma operator */ |
93c80368 NB |
472 | cpp_hashnode *n__STRICT_ANSI__; /* STDC_0_IN_SYSTEM_HEADERS */ |
473 | cpp_hashnode *n__CHAR_UNSIGNED__; /* plain char is unsigned */ | |
474 | cpp_hashnode *n__VA_ARGS__; /* C99 vararg macros */ | |
475 | }; | |
476 | ||
27e2564a NB |
477 | /* This structure is passed to the call back when changing file. */ |
478 | enum cpp_fc_reason {FC_ENTER = 0, FC_LEAVE, FC_RENAME}; | |
479 | ||
480 | struct cpp_file_loc | |
481 | { | |
482 | const char *filename; | |
483 | unsigned int lineno; | |
484 | }; | |
485 | ||
486 | typedef struct cpp_file_change cpp_file_change; | |
487 | struct cpp_file_change | |
488 | { | |
489 | struct cpp_file_loc from; /* Line of #include or #line. */ | |
490 | struct cpp_file_loc to; /* Line after #include or #line, or start. */ | |
491 | enum cpp_fc_reason reason; /* Reason for change. */ | |
492 | unsigned char sysp; /* Nonzero if system header. */ | |
493 | unsigned char externc; /* Nonzero if wrapper needed. */ | |
494 | }; | |
495 | ||
dd07b884 | 496 | /* A cpp_reader encapsulates the "state" of a pre-processor run. |
ae79697b | 497 | Applying cpp_get_token repeatedly yields a stream of pre-processor |
93c80368 | 498 | tokens. Usually, there is only one cpp_reader object active. */ |
31031edd | 499 | |
ae79697b ZW |
500 | struct cpp_reader |
501 | { | |
9e62c811 | 502 | /* Top of buffer stack. */ |
ae79697b | 503 | cpp_buffer *buffer; |
7f2935c7 | 504 | |
0d9f234d NB |
505 | /* Lexer state. */ |
506 | struct lexer_state state; | |
507 | ||
8d9e9a08 | 508 | /* The position of the last lexed token and last lexed directive. */ |
93c80368 | 509 | cpp_lexer_pos lexer_pos; |
93c80368 NB |
510 | cpp_lexer_pos directive_pos; |
511 | ||
512 | /* Memory pools. */ | |
513 | cpp_pool ident_pool; /* For all identifiers, and permanent | |
514 | numbers and strings. */ | |
93c80368 NB |
515 | cpp_pool macro_pool; /* For macro definitions. Permanent. */ |
516 | cpp_pool argument_pool; /* For macro arguments. Temporary. */ | |
93c80368 NB |
517 | |
518 | /* Context stack. */ | |
519 | struct cpp_context base_context; | |
520 | struct cpp_context *context; | |
521 | ||
522 | /* If in_directive, the directive if known. */ | |
523 | const struct directive *directive; | |
524 | ||
525 | /* Multiple inlcude optimisation. */ | |
526 | enum mi_state mi_state; | |
527 | enum mi_ind mi_if_not_defined; | |
528 | unsigned int mi_lexed; | |
529 | const cpp_hashnode *mi_cmacro; | |
530 | const cpp_hashnode *mi_ind_cmacro; | |
531 | ||
532 | /* Token lookahead. */ | |
533 | struct cpp_lookahead *la_read; /* Read from this lookahead. */ | |
534 | struct cpp_lookahead *la_write; /* Write to this lookahead. */ | |
535 | struct cpp_lookahead *la_unused; /* Free store. */ | |
fe6c2db9 | 536 | struct cpp_lookahead *la_saved; /* Backup when entering directive. */ |
93c80368 NB |
537 | |
538 | /* Error counter for exit code. */ | |
3a2b2c7a | 539 | unsigned int errors; |
ae79697b | 540 | |
0d9f234d NB |
541 | /* Line and column where a newline was first seen in a string |
542 | constant (multi-line strings). */ | |
93c80368 NB |
543 | cpp_lexer_pos mlstring_pos; |
544 | ||
545 | /* Buffer to hold macro definition string. */ | |
546 | unsigned char *macro_buffer; | |
547 | unsigned int macro_buffer_len; | |
ae79697b ZW |
548 | |
549 | /* Current depth in #include directives that use <...>. */ | |
3a2b2c7a | 550 | unsigned int system_include_depth; |
ae79697b | 551 | |
93c80368 | 552 | /* Current depth of buffer stack. */ |
3a2b2c7a | 553 | unsigned int buffer_stack_depth; |
ae79697b | 554 | |
fb753f88 JJ |
555 | /* Current depth in #include directives. */ |
556 | unsigned int include_depth; | |
557 | ||
93c80368 | 558 | /* Hash table of macros and assertions. See cpphash.c. */ |
ae79697b ZW |
559 | struct htab *hashtab; |
560 | ||
93c80368 | 561 | /* Tree of other included files. See cppfiles.c. */ |
c31a6508 | 562 | struct splay_tree_s *all_include_files; |
ae79697b | 563 | |
93c80368 NB |
564 | /* Chain of `actual directory' file_name_list entries, for "" |
565 | inclusion. */ | |
ae79697b ZW |
566 | struct file_name_list *actual_dirs; |
567 | ||
568 | /* Current maximum length of directory names in the search path | |
569 | for include files. (Altered as we get more of them.) */ | |
570 | unsigned int max_include_len; | |
571 | ||
041c3194 | 572 | /* Date and time tokens. Calculated together if either is requested. */ |
93c80368 NB |
573 | cpp_token date; |
574 | cpp_token time; | |
041c3194 | 575 | |
ae79697b ZW |
576 | /* Buffer of -M output. */ |
577 | struct deps *deps; | |
578 | ||
c71f835b ZW |
579 | /* Obstack holding all macro hash nodes. This never shrinks. |
580 | See cpphash.c */ | |
581 | struct obstack *hash_ob; | |
582 | ||
583 | /* Obstack holding buffer and conditional structures. This is a | |
584 | real stack. See cpplib.c */ | |
585 | struct obstack *buffer_ob; | |
586 | ||
58fea6af ZW |
587 | /* Pragma table - dynamic, because a library user can add to the |
588 | list of recognized pragmas. */ | |
589 | struct pragma_entry *pragmas; | |
590 | ||
591 | /* Call backs. */ | |
592 | struct { | |
eb1f4d9d | 593 | void (*file_change) PARAMS ((cpp_reader *, const cpp_file_change *)); |
58fea6af | 594 | void (*include) PARAMS ((cpp_reader *, const unsigned char *, |
93c80368 | 595 | const cpp_token *)); |
58fea6af ZW |
596 | void (*define) PARAMS ((cpp_reader *, cpp_hashnode *)); |
597 | void (*undef) PARAMS ((cpp_reader *, cpp_hashnode *)); | |
598 | void (*poison) PARAMS ((cpp_reader *)); | |
93c80368 | 599 | void (*ident) PARAMS ((cpp_reader *, const cpp_string *)); |
58fea6af ZW |
600 | void (*def_pragma) PARAMS ((cpp_reader *)); |
601 | } cb; | |
602 | ||
ae79697b ZW |
603 | /* User visible options. */ |
604 | struct cpp_options opts; | |
605 | ||
93c80368 NB |
606 | /* Special nodes - identifiers with predefined significance to the |
607 | preprocessor. */ | |
608 | struct spec_nodes spec_nodes; | |
609 | ||
ae79697b ZW |
610 | /* We're printed a warning recommending against using #import. */ |
611 | unsigned char import_warning; | |
612 | ||
ae79697b ZW |
613 | /* True after cpp_start_read completes. Used to inhibit some |
614 | warnings while parsing the command line. */ | |
615 | unsigned char done_initializing; | |
ea4a453b ZW |
616 | |
617 | /* True if we are skipping a failed conditional group. */ | |
618 | unsigned char skipping; | |
f2d5f0cc ZW |
619 | }; |
620 | ||
ae79697b ZW |
621 | #define CPP_FATAL_LIMIT 1000 |
622 | /* True if we have seen a "fatal" error. */ | |
623 | #define CPP_FATAL_ERRORS(READER) ((READER)->errors >= CPP_FATAL_LIMIT) | |
624 | ||
ae79697b ZW |
625 | #define CPP_OPTION(PFILE, OPTION) ((PFILE)->opts.OPTION) |
626 | #define CPP_BUFFER(PFILE) ((PFILE)->buffer) | |
3a2b2c7a | 627 | #define CPP_BUF_LINE(BUF) ((BUF)->lineno) |
0d9f234d | 628 | #define CPP_BUF_COLUMN(BUF, CUR) ((CUR) - (BUF)->line_base + (BUF)->col_adjust) |
6ab3e7dd | 629 | #define CPP_BUF_COL(BUF) CPP_BUF_COLUMN(BUF, (BUF)->cur) |
ae79697b | 630 | |
7f2935c7 | 631 | /* Name under which this program was invoked. */ |
bcc5cac9 | 632 | extern const char *progname; |
7f2935c7 | 633 | |
ad2a084d NB |
634 | /* Where does this buffer come from? A faked include, a source file, |
635 | a builtin macro, a command-line option, or a _Pragma operator. */ | |
636 | enum cpp_buffer_type {BUF_FAKE, BUF_FILE, BUF_BUILTIN, | |
637 | BUF_CL_OPTION, BUF_PRAGMA}; | |
0bda4760 | 638 | |
93c80368 NB |
639 | /* The structure of a node in the hash table. The hash table has |
640 | entries for all identifiers: either macros defined by #define | |
641 | commands (type NT_MACRO), assertions created with #assert | |
642 | (NT_ASSERTION), or neither of the above (NT_VOID). Builtin macros | |
643 | like __LINE__ are flagged NODE_BUILTIN. Poisioned identifiers are | |
644 | flagged NODE_POISONED. NODE_OPERATOR (C++ only) indicates an | |
645 | identifier that behaves like an operator such as "xor". | |
646 | NODE_DIAGNOSTIC is for speed in lex_token: it indicates a | |
647 | diagnostic may be required for this node. Currently this only | |
648 | applies to __VA_ARGS__ and poisoned identifiers. */ | |
649 | ||
650 | /* Hash node flags. */ | |
651 | #define NODE_OPERATOR (1 << 0) /* C++ named operator. */ | |
652 | #define NODE_POISONED (1 << 1) /* Poisoned identifier. */ | |
653 | #define NODE_BUILTIN (1 << 2) /* Builtin macro. */ | |
654 | #define NODE_DIAGNOSTIC (1 << 3) /* Possible diagnostic when lexed. */ | |
655 | ||
656 | /* Different flavors of hash node. */ | |
f8f769ea ZW |
657 | enum node_type |
658 | { | |
93c80368 NB |
659 | NT_VOID = 0, /* No definition yet. */ |
660 | NT_MACRO, /* A macro of some form. */ | |
661 | NT_ASSERTION /* Predicate for #assert. */ | |
662 | }; | |
663 | ||
664 | /* Different flavors of builtin macro. */ | |
665 | enum builtin_type | |
666 | { | |
667 | BT_SPECLINE = 0, /* `__LINE__' */ | |
668 | BT_DATE, /* `__DATE__' */ | |
669 | BT_FILE, /* `__FILE__' */ | |
670 | BT_BASE_FILE, /* `__BASE_FILE__' */ | |
671 | BT_INCLUDE_LEVEL, /* `__INCLUDE_LEVEL__' */ | |
672 | BT_TIME, /* `__TIME__' */ | |
673 | BT_STDC /* `__STDC__' */ | |
f8f769ea ZW |
674 | }; |
675 | ||
676 | /* There is a slot in the hashnode for use by front ends when integrated | |
677 | with cpplib. It holds a tree (see tree.h) but we mustn't drag that | |
678 | header into every user of cpplib.h. cpplib does not do anything with | |
679 | this slot except clear it when a new node is created. */ | |
680 | union tree_node; | |
681 | ||
682 | struct cpp_hashnode | |
683 | { | |
dd07b884 NB |
684 | const unsigned char *name; /* Null-terminated name. */ |
685 | unsigned int hash; /* Cached hash value. */ | |
686 | unsigned short length; /* Length of name excluding null. */ | |
687 | unsigned short arg_index; /* Macro argument index. */ | |
688 | unsigned char directive_index; /* Index into directive table. */ | |
689 | ENUM_BITFIELD(node_type) type : 8; /* Node type. */ | |
690 | unsigned char flags; /* Node flags. */ | |
f8f769ea | 691 | |
041c3194 ZW |
692 | union |
693 | { | |
dd07b884 NB |
694 | cpp_macro *macro; /* If a macro. */ |
695 | struct answer *answers; /* Answers to an assertion. */ | |
696 | enum cpp_ttype operator; /* Code for a named operator. */ | |
697 | enum builtin_type builtin; /* Code for a builtin macro. */ | |
f8f769ea ZW |
698 | } value; |
699 | ||
dd07b884 | 700 | union tree_node *fe_value; /* Front end value. */ |
f8f769ea ZW |
701 | }; |
702 | ||
cf44ea52 | 703 | extern cpp_reader *cpp_create_reader PARAMS ((enum c_lang)); |
93c80368 | 704 | extern unsigned int cpp_token_len PARAMS ((const cpp_token *)); |
dd07b884 NB |
705 | extern unsigned char *cpp_token_as_text PARAMS ((cpp_reader *, |
706 | const cpp_token *)); | |
93c80368 NB |
707 | extern unsigned char *cpp_spell_token PARAMS ((cpp_reader *, const cpp_token *, |
708 | unsigned char *)); | |
88ae23e7 | 709 | extern int cpp_handle_options PARAMS ((cpp_reader *, int, char **)); |
2c0accc9 | 710 | extern int cpp_handle_option PARAMS ((cpp_reader *, int, char **)); |
58fea6af ZW |
711 | extern void cpp_register_pragma PARAMS ((cpp_reader *, |
712 | const char *, const char *, | |
713 | void (*) PARAMS ((cpp_reader *)))); | |
714 | extern void cpp_register_pragma_space PARAMS ((cpp_reader *, const char *)); | |
715 | ||
93c80368 NB |
716 | extern int cpp_start_read PARAMS ((cpp_reader *, const char *)); |
717 | extern void cpp_finish PARAMS ((cpp_reader *)); | |
f2d5f0cc | 718 | extern void cpp_cleanup PARAMS ((cpp_reader *)); |
93c80368 NB |
719 | extern int cpp_avoid_paste PARAMS ((cpp_reader *, const cpp_token *, |
720 | const cpp_token *)); | |
721 | extern enum cpp_ttype cpp_can_paste PARAMS ((cpp_reader *, const cpp_token *, | |
722 | const cpp_token *, int *)); | |
723 | extern void cpp_get_token PARAMS ((cpp_reader *, cpp_token *)); | |
724 | extern const cpp_lexer_pos *cpp_get_line PARAMS ((cpp_reader *)); | |
725 | extern const unsigned char *cpp_macro_definition PARAMS ((cpp_reader *, | |
726 | const cpp_hashnode *)); | |
041c3194 | 727 | |
7ceb3598 NB |
728 | extern void cpp_define PARAMS ((cpp_reader *, const char *)); |
729 | extern void cpp_assert PARAMS ((cpp_reader *, const char *)); | |
730 | extern void cpp_undef PARAMS ((cpp_reader *, const char *)); | |
731 | extern void cpp_unassert PARAMS ((cpp_reader *, const char *)); | |
7f2935c7 | 732 | |
711b8824 | 733 | extern cpp_buffer *cpp_push_buffer PARAMS ((cpp_reader *, |
0bda4760 NB |
734 | const unsigned char *, size_t, |
735 | enum cpp_buffer_type, | |
736 | const char *)); | |
711b8824 ZW |
737 | extern cpp_buffer *cpp_pop_buffer PARAMS ((cpp_reader *)); |
738 | extern int cpp_defined PARAMS ((cpp_reader *, const unsigned char *, int)); | |
c5a04734 | 739 | |
c1212d2f ZW |
740 | /* N.B. The error-message-printer prototypes have not been nicely |
741 | formatted because exgettext needs to see 'msgid' on the same line | |
742 | as the name of the function in order to work properly. Only the | |
743 | string argument gets a name in an effort to keep the lines from | |
744 | getting ridiculously oversized. */ | |
745 | ||
746 | extern void cpp_ice PARAMS ((cpp_reader *, const char *msgid, ...)) | |
487a6e06 | 747 | ATTRIBUTE_PRINTF_2; |
c1212d2f | 748 | extern void cpp_fatal PARAMS ((cpp_reader *, const char *msgid, ...)) |
487a6e06 | 749 | ATTRIBUTE_PRINTF_2; |
c1212d2f | 750 | extern void cpp_error PARAMS ((cpp_reader *, const char *msgid, ...)) |
487a6e06 | 751 | ATTRIBUTE_PRINTF_2; |
c1212d2f ZW |
752 | extern void cpp_warning PARAMS ((cpp_reader *, const char *msgid, ...)) |
753 | ATTRIBUTE_PRINTF_2; | |
754 | extern void cpp_pedwarn PARAMS ((cpp_reader *, const char *msgid, ...)) | |
755 | ATTRIBUTE_PRINTF_2; | |
756 | extern void cpp_notice PARAMS ((cpp_reader *, const char *msgid, ...)) | |
757 | ATTRIBUTE_PRINTF_2; | |
758 | extern void cpp_error_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...)) | |
554fbeef | 759 | ATTRIBUTE_PRINTF_4; |
c1212d2f | 760 | extern void cpp_warning_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...)) |
487a6e06 | 761 | ATTRIBUTE_PRINTF_4; |
c1212d2f | 762 | extern void cpp_pedwarn_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...)) |
487a6e06 | 763 | ATTRIBUTE_PRINTF_4; |
c1212d2f ZW |
764 | extern void cpp_pedwarn_with_file_and_line PARAMS ((cpp_reader *, const char *, int, int, const char *msgid, ...)) |
765 | ATTRIBUTE_PRINTF_5; | |
711b8824 ZW |
766 | extern void cpp_error_from_errno PARAMS ((cpp_reader *, const char *)); |
767 | extern void cpp_notice_from_errno PARAMS ((cpp_reader *, const char *)); | |
f2d5f0cc ZW |
768 | |
769 | /* In cpplex.c */ | |
bfb9dc7f ZW |
770 | extern int cpp_ideq PARAMS ((const cpp_token *, |
771 | const char *)); | |
93c80368 NB |
772 | extern void cpp_output_line PARAMS ((cpp_reader *, FILE *)); |
773 | extern void cpp_output_token PARAMS ((const cpp_token *, FILE *)); | |
774 | extern const char *cpp_type2name PARAMS ((enum cpp_ttype)); | |
1368ee70 | 775 | |
f2d5f0cc | 776 | /* In cpphash.c */ |
93c80368 NB |
777 | extern cpp_hashnode *cpp_lookup PARAMS ((cpp_reader *, |
778 | const unsigned char *, size_t)); | |
779 | extern void cpp_forall_identifiers PARAMS ((cpp_reader *, | |
780 | int (*) PARAMS ((cpp_reader *, | |
926c5678 GK |
781 | cpp_hashnode *, |
782 | void *)), | |
783 | void *)); | |
784 | ||
58fea6af | 785 | /* In cppmacro.c */ |
8dc4676d | 786 | extern void cpp_scan_buffer_nooutput PARAMS ((cpp_reader *, int)); |
93c80368 NB |
787 | extern void cpp_start_lookahead PARAMS ((cpp_reader *)); |
788 | extern void cpp_stop_lookahead PARAMS ((cpp_reader *, int)); | |
6de1e2a9 | 789 | |
add7091b | 790 | /* In cppfiles.c */ |
711b8824 | 791 | extern int cpp_included PARAMS ((cpp_reader *, const char *)); |
614c7d37 | 792 | extern void cpp_make_system_header PARAMS ((cpp_reader *, int, int)); |
b0699dad | 793 | |
93c80368 NB |
794 | /* These are inline functions instead of macros so we can get type |
795 | checking. */ | |
796 | typedef unsigned char U_CHAR; | |
797 | #define U (const U_CHAR *) /* Intended use: U"string" */ | |
798 | ||
799 | static inline int ustrcmp PARAMS ((const U_CHAR *, const U_CHAR *)); | |
800 | static inline int ustrncmp PARAMS ((const U_CHAR *, const U_CHAR *, | |
801 | size_t)); | |
802 | static inline size_t ustrlen PARAMS ((const U_CHAR *)); | |
803 | static inline U_CHAR *uxstrdup PARAMS ((const U_CHAR *)); | |
804 | static inline U_CHAR *ustrchr PARAMS ((const U_CHAR *, int)); | |
805 | static inline int ufputs PARAMS ((const U_CHAR *, FILE *)); | |
806 | ||
807 | static inline int | |
808 | ustrcmp (s1, s2) | |
809 | const U_CHAR *s1, *s2; | |
810 | { | |
811 | return strcmp ((const char *)s1, (const char *)s2); | |
812 | } | |
813 | ||
814 | static inline int | |
815 | ustrncmp (s1, s2, n) | |
816 | const U_CHAR *s1, *s2; | |
817 | size_t n; | |
818 | { | |
819 | return strncmp ((const char *)s1, (const char *)s2, n); | |
820 | } | |
821 | ||
822 | static inline size_t | |
823 | ustrlen (s1) | |
824 | const U_CHAR *s1; | |
825 | { | |
826 | return strlen ((const char *)s1); | |
827 | } | |
828 | ||
829 | static inline U_CHAR * | |
830 | uxstrdup (s1) | |
831 | const U_CHAR *s1; | |
832 | { | |
833 | return (U_CHAR *) xstrdup ((const char *)s1); | |
834 | } | |
835 | ||
836 | static inline U_CHAR * | |
837 | ustrchr (s1, c) | |
838 | const U_CHAR *s1; | |
839 | int c; | |
840 | { | |
841 | return (U_CHAR *) strchr ((const char *)s1, c); | |
842 | } | |
843 | ||
844 | static inline int | |
845 | ufputs (s, f) | |
846 | const U_CHAR *s; | |
847 | FILE *f; | |
848 | { | |
849 | return fputs ((const char *)s, f); | |
850 | } | |
851 | ||
7f2935c7 PB |
852 | #ifdef __cplusplus |
853 | } | |
854 | #endif | |
990c642c | 855 | #endif /* __GCC_CPPLIB__ */ |