]>
Commit | Line | Data |
---|---|---|
7f2935c7 | 1 | /* Definitions for CPP library. |
03b9ab42 | 2 | Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001 |
2398fb2a | 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; |
608477bd | 40 | typedef struct c_common_identifier cpp_hashnode; |
93c80368 NB |
41 | typedef struct cpp_macro cpp_macro; |
42 | typedef struct cpp_lexer_pos cpp_lexer_pos; | |
43 | typedef struct cpp_lookahead cpp_lookahead; | |
7e96d768 | 44 | typedef struct cpp_callbacks cpp_callbacks; |
93c80368 | 45 | |
93c80368 | 46 | struct answer; |
93c80368 | 47 | struct file_name_map_list; |
c5a04734 ZW |
48 | |
49 | /* The first two groups, apart from '=', can appear in preprocessor | |
50 | expressions. This allows a lookup table to be implemented in | |
51 | _cpp_parse_expr. | |
52 | ||
53 | The first group, to CPP_LAST_EQ, can be immediately followed by an | |
54 | '='. The lexer needs operators ending in '=', like ">>=", to be in | |
55 | the same order as their counterparts without the '=', like ">>". */ | |
56 | ||
57 | /* Positions in the table. */ | |
6fee6033 | 58 | #define CPP_LAST_EQ CPP_MAX |
c5a04734 | 59 | #define CPP_FIRST_DIGRAPH CPP_HASH |
9ec7291f | 60 | #define CPP_LAST_PUNCTUATOR CPP_DOT_STAR |
1368ee70 | 61 | |
1368ee70 | 62 | #define TTYPE_TABLE \ |
96be6998 ZW |
63 | OP(CPP_EQ = 0, "=") \ |
64 | OP(CPP_NOT, "!") \ | |
65 | OP(CPP_GREATER, ">") /* compare */ \ | |
66 | OP(CPP_LESS, "<") \ | |
67 | OP(CPP_PLUS, "+") /* math */ \ | |
68 | OP(CPP_MINUS, "-") \ | |
69 | OP(CPP_MULT, "*") \ | |
70 | OP(CPP_DIV, "/") \ | |
71 | OP(CPP_MOD, "%") \ | |
72 | OP(CPP_AND, "&") /* bit ops */ \ | |
73 | OP(CPP_OR, "|") \ | |
74 | OP(CPP_XOR, "^") \ | |
75 | OP(CPP_RSHIFT, ">>") \ | |
76 | OP(CPP_LSHIFT, "<<") \ | |
92936ecf ZW |
77 | OP(CPP_MIN, "<?") /* extension */ \ |
78 | OP(CPP_MAX, ">?") \ | |
c5a04734 | 79 | \ |
96be6998 ZW |
80 | OP(CPP_COMPL, "~") \ |
81 | OP(CPP_AND_AND, "&&") /* logical */ \ | |
82 | OP(CPP_OR_OR, "||") \ | |
83 | OP(CPP_QUERY, "?") \ | |
84 | OP(CPP_COLON, ":") \ | |
85 | OP(CPP_COMMA, ",") /* grouping */ \ | |
86 | OP(CPP_OPEN_PAREN, "(") \ | |
87 | OP(CPP_CLOSE_PAREN, ")") \ | |
88 | OP(CPP_EQ_EQ, "==") /* compare */ \ | |
89 | OP(CPP_NOT_EQ, "!=") \ | |
90 | OP(CPP_GREATER_EQ, ">=") \ | |
91 | OP(CPP_LESS_EQ, "<=") \ | |
1368ee70 | 92 | \ |
96be6998 ZW |
93 | OP(CPP_PLUS_EQ, "+=") /* math */ \ |
94 | OP(CPP_MINUS_EQ, "-=") \ | |
95 | OP(CPP_MULT_EQ, "*=") \ | |
96 | OP(CPP_DIV_EQ, "/=") \ | |
97 | OP(CPP_MOD_EQ, "%=") \ | |
98 | OP(CPP_AND_EQ, "&=") /* bit ops */ \ | |
99 | OP(CPP_OR_EQ, "|=") \ | |
100 | OP(CPP_XOR_EQ, "^=") \ | |
101 | OP(CPP_RSHIFT_EQ, ">>=") \ | |
102 | OP(CPP_LSHIFT_EQ, "<<=") \ | |
92936ecf ZW |
103 | OP(CPP_MIN_EQ, "<?=") /* extension */ \ |
104 | OP(CPP_MAX_EQ, ">?=") \ | |
c5a04734 | 105 | /* Digraphs together, beginning with CPP_FIRST_DIGRAPH. */ \ |
96be6998 ZW |
106 | OP(CPP_HASH, "#") /* digraphs */ \ |
107 | OP(CPP_PASTE, "##") \ | |
108 | OP(CPP_OPEN_SQUARE, "[") \ | |
109 | OP(CPP_CLOSE_SQUARE, "]") \ | |
110 | OP(CPP_OPEN_BRACE, "{") \ | |
111 | OP(CPP_CLOSE_BRACE, "}") \ | |
112 | /* The remainder of the punctuation. Order is not significant. */ \ | |
113 | OP(CPP_SEMICOLON, ";") /* structure */ \ | |
114 | OP(CPP_ELLIPSIS, "...") \ | |
96be6998 ZW |
115 | OP(CPP_PLUS_PLUS, "++") /* increment */ \ |
116 | OP(CPP_MINUS_MINUS, "--") \ | |
117 | OP(CPP_DEREF, "->") /* accessors */ \ | |
118 | OP(CPP_DOT, ".") \ | |
119 | OP(CPP_SCOPE, "::") \ | |
120 | OP(CPP_DEREF_STAR, "->*") \ | |
121 | OP(CPP_DOT_STAR, ".*") \ | |
cc937581 | 122 | OP(CPP_ATSIGN, "@") /* used in Objective C */ \ |
1368ee70 | 123 | \ |
96be6998 ZW |
124 | TK(CPP_NAME, SPELL_IDENT) /* word */ \ |
125 | TK(CPP_INT, SPELL_STRING) /* 23 */ \ | |
126 | TK(CPP_FLOAT, SPELL_STRING) /* 3.14159 */ \ | |
127 | TK(CPP_NUMBER, SPELL_STRING) /* 34_be+ta */ \ | |
1368ee70 | 128 | \ |
96be6998 ZW |
129 | TK(CPP_CHAR, SPELL_STRING) /* 'char' */ \ |
130 | TK(CPP_WCHAR, SPELL_STRING) /* L'char' */ \ | |
131 | TK(CPP_OTHER, SPELL_CHAR) /* stray punctuation */ \ | |
132 | \ | |
133 | TK(CPP_STRING, SPELL_STRING) /* "string" */ \ | |
134 | TK(CPP_WSTRING, SPELL_STRING) /* L"string" */ \ | |
135 | TK(CPP_HEADER_NAME, SPELL_STRING) /* <stdio.h> in #include */ \ | |
136 | \ | |
137 | TK(CPP_COMMENT, SPELL_STRING) /* Only if output comments. */ \ | |
138 | TK(CPP_MACRO_ARG, SPELL_NONE) /* Macro argument. */ \ | |
93c80368 | 139 | OP(CPP_EOF, "EOL") /* End of line or file. */ |
1368ee70 | 140 | |
96be6998 ZW |
141 | #define OP(e, s) e, |
142 | #define TK(e, s) e, | |
3a2b2c7a | 143 | enum cpp_ttype |
c45da1ca | 144 | { |
1368ee70 ZW |
145 | TTYPE_TABLE |
146 | N_TTYPES | |
147 | }; | |
96be6998 ZW |
148 | #undef OP |
149 | #undef TK | |
1368ee70 | 150 | |
dd07b884 NB |
151 | /* C language kind, used when calling cpp_reader_init. */ |
152 | enum c_lang {CLK_GNUC89 = 0, CLK_GNUC99, CLK_STDC89, CLK_STDC94, CLK_STDC99, | |
153 | CLK_GNUCXX, CLK_CXX98, CLK_OBJC, CLK_OBJCXX, CLK_ASM}; | |
154 | ||
bfb9dc7f ZW |
155 | /* Payload of a NUMBER, FLOAT, STRING, or COMMENT token. */ |
156 | struct cpp_string | |
1368ee70 ZW |
157 | { |
158 | unsigned int len; | |
f617b8e2 | 159 | const unsigned char *text; |
1368ee70 ZW |
160 | }; |
161 | ||
c5a04734 | 162 | /* Flags for the cpp_token structure. */ |
041c3194 | 163 | #define PREV_WHITE (1 << 0) /* If whitespace before this token. */ |
93c80368 NB |
164 | #define DIGRAPH (1 << 1) /* If it was a digraph. */ |
165 | #define STRINGIFY_ARG (1 << 2) /* If macro argument to be stringified. */ | |
166 | #define PASTE_LEFT (1 << 3) /* If on LHS of a ## operator. */ | |
dd07b884 | 167 | #define NAMED_OP (1 << 4) /* C++ named operators. */ |
93c80368 | 168 | #define NO_EXPAND (1 << 5) /* Do not macro-expand this token. */ |
26ec42ee | 169 | #define AVOID_LPASTE (1 << 6) /* Check left for accidental pastes. */ |
9e62c811 | 170 | |
1920de47 | 171 | /* A preprocessing token. This has been carefully packed and should |
93c80368 | 172 | occupy 12 bytes on 32-bit hosts and 16 bytes on 64-bit hosts. */ |
1368ee70 ZW |
173 | struct cpp_token |
174 | { | |
041c3194 ZW |
175 | ENUM_BITFIELD(cpp_ttype) type : CHAR_BIT; /* token type */ |
176 | unsigned char flags; /* flags - see above */ | |
177 | ||
1368ee70 ZW |
178 | union |
179 | { | |
608477bd | 180 | cpp_hashnode *node; /* An identifier. */ |
6c53ebff NB |
181 | struct cpp_string str; /* A string, or number. */ |
182 | unsigned int arg_no; /* Argument no. for a CPP_MACRO_ARG. */ | |
183 | unsigned char c; /* Character represented by CPP_OTHER. */ | |
1368ee70 | 184 | } val; |
7f2935c7 PB |
185 | }; |
186 | ||
93c80368 NB |
187 | /* The position of a token in the current file. */ |
188 | struct cpp_lexer_pos | |
189 | { | |
190 | unsigned int line; | |
191 | unsigned int output_line; | |
192 | unsigned short col; | |
193 | }; | |
1368ee70 | 194 | |
93c80368 NB |
195 | typedef struct cpp_token_with_pos cpp_token_with_pos; |
196 | struct cpp_token_with_pos | |
1368ee70 | 197 | { |
93c80368 NB |
198 | cpp_token token; |
199 | cpp_lexer_pos pos; | |
200 | }; | |
1368ee70 | 201 | |
93c80368 NB |
202 | /* Token lookahead. */ |
203 | struct cpp_lookahead | |
204 | { | |
205 | struct cpp_lookahead *next; | |
206 | cpp_token_with_pos *tokens; | |
207 | cpp_lexer_pos pos; | |
208 | unsigned int cur, count, cap; | |
209 | }; | |
1368ee70 | 210 | |
0d9f234d NB |
211 | /* A standalone character. We may want to make it unsigned for the |
212 | same reason we use unsigned char - to avoid signedness issues. */ | |
213 | typedef int cppchar_t; | |
214 | ||
ae79697b ZW |
215 | /* Values for opts.dump_macros. |
216 | dump_only means inhibit output of the preprocessed text | |
217 | and instead output the definitions of all user-defined | |
86702e31 | 218 | macros in a form suitable for use as input to cpp. |
ae79697b ZW |
219 | dump_names means pass #define and the macro name through to output. |
220 | dump_definitions means pass the whole definition (plus #define) through | |
221 | */ | |
222 | enum { dump_none = 0, dump_only, dump_names, dump_definitions }; | |
7f2935c7 | 223 | |
ae79697b ZW |
224 | /* This structure is nested inside struct cpp_reader, and |
225 | carries all the options visible to the command line. */ | |
226 | struct cpp_options | |
c50bca08 | 227 | { |
ae79697b ZW |
228 | /* Name of input and output files. */ |
229 | const char *in_fname; | |
230 | const char *out_fname; | |
194d7493 | 231 | |
6ab3e7dd NB |
232 | /* Characters between tab stops. */ |
233 | unsigned int tabstop; | |
234 | ||
ae79697b ZW |
235 | /* Pending options - -D, -U, -A, -I, -ixxx. */ |
236 | struct cpp_pending *pending; | |
7f2935c7 | 237 | |
ae79697b ZW |
238 | /* File name which deps are being written to. This is 0 if deps are |
239 | being written to stdout. */ | |
240 | const char *deps_file; | |
0b22d65c | 241 | |
ae79697b | 242 | /* Search paths for include files. */ |
591e15a1 NB |
243 | struct search_path *quote_include; /* "" */ |
244 | struct search_path *bracket_include; /* <> */ | |
7f2935c7 | 245 | |
ae79697b ZW |
246 | /* Map between header names and file names, used only on DOS where |
247 | file names are limited in length. */ | |
7e2eb697 PB |
248 | struct file_name_map_list *map_list; |
249 | ||
ae79697b ZW |
250 | /* Directory prefix that should replace `/usr/lib/gcc-lib/TARGET/VERSION' |
251 | in the standard include file directories. */ | |
252 | const char *include_prefix; | |
253 | unsigned int include_prefix_len; | |
254 | ||
6db83155 ZW |
255 | /* -fleading_underscore sets this to "_". */ |
256 | const char *user_label_prefix; | |
257 | ||
bdb05a7b NB |
258 | /* The language we're preprocessing. */ |
259 | enum c_lang lang; | |
260 | ||
7f2935c7 | 261 | /* Non-0 means -v, so print the full set of include dirs. */ |
ae79697b | 262 | unsigned char verbose; |
7f2935c7 PB |
263 | |
264 | /* Nonzero means use extra default include directories for C++. */ | |
ae79697b | 265 | unsigned char cplusplus; |
7f2935c7 PB |
266 | |
267 | /* Nonzero means handle cplusplus style comments */ | |
ae79697b | 268 | unsigned char cplusplus_comments; |
7f2935c7 PB |
269 | |
270 | /* Nonzero means handle #import, for objective C. */ | |
ae79697b | 271 | unsigned char objc; |
7f2935c7 | 272 | |
564ad5f4 | 273 | /* Nonzero means don't copy comments into the output file. */ |
ae79697b | 274 | unsigned char discard_comments; |
7f2935c7 | 275 | |
041c3194 | 276 | /* Nonzero means process the ISO trigraph sequences. */ |
ae79697b | 277 | unsigned char trigraphs; |
7f2935c7 | 278 | |
9b55f29a NB |
279 | /* Nonzero means process the ISO digraph sequences. */ |
280 | unsigned char digraphs; | |
281 | ||
bdb05a7b NB |
282 | /* Nonzero means to allow hexadecimal floats and LL suffixes. */ |
283 | unsigned char extended_numbers; | |
284 | ||
ae79697b ZW |
285 | /* Nonzero means print the names of included files rather than the |
286 | preprocessed output. 1 means just the #include "...", 2 means | |
287 | #include <...> as well. */ | |
288 | unsigned char print_deps; | |
7f2935c7 | 289 | |
a5a4ce3c NB |
290 | /* Nonzero if phony targets are created for each header. */ |
291 | unsigned char deps_phony_targets; | |
292 | ||
ae79697b ZW |
293 | /* Nonzero if missing .h files in -M output are assumed to be |
294 | generated files and not errors. */ | |
295 | unsigned char print_deps_missing_files; | |
7f2935c7 PB |
296 | |
297 | /* If true, fopen (deps_file, "a") else fopen (deps_file, "w"). */ | |
ae79697b | 298 | unsigned char print_deps_append; |
7f2935c7 PB |
299 | |
300 | /* Nonzero means print names of header files (-H). */ | |
ae79697b | 301 | unsigned char print_include_names; |
7f2935c7 | 302 | |
ae79697b ZW |
303 | /* Nonzero means cpp_pedwarn causes a hard error. */ |
304 | unsigned char pedantic_errors; | |
7f2935c7 | 305 | |
c1212d2f | 306 | /* Nonzero means don't print warning messages. */ |
ae79697b | 307 | unsigned char inhibit_warnings; |
7f2935c7 | 308 | |
317639a8 BC |
309 | /* Nonzero means don't suppress warnings from system headers. */ |
310 | unsigned char warn_system_headers; | |
311 | ||
ae79697b ZW |
312 | /* Nonzero means don't print error messages. Has no option to |
313 | select it, but can be set by a user of cpplib (e.g. fix-header). */ | |
314 | unsigned char inhibit_errors; | |
c1212d2f | 315 | |
7f2935c7 | 316 | /* Nonzero means warn if slash-star appears in a comment. */ |
ae79697b | 317 | unsigned char warn_comments; |
7f2935c7 PB |
318 | |
319 | /* Nonzero means warn if there are any trigraphs. */ | |
ae79697b | 320 | unsigned char warn_trigraphs; |
7f2935c7 PB |
321 | |
322 | /* Nonzero means warn if #import is used. */ | |
ae79697b | 323 | unsigned char warn_import; |
7f2935c7 | 324 | |
f9a0e96c ZW |
325 | /* Nonzero means warn about various incompatibilities with |
326 | traditional C. */ | |
07aa0b04 | 327 | unsigned char warn_traditional; |
7f2935c7 PB |
328 | |
329 | /* Nonzero means turn warnings into errors. */ | |
ae79697b | 330 | unsigned char warnings_are_errors; |
7f2935c7 | 331 | |
ae79697b ZW |
332 | /* Nonzero causes output not to be done, but directives such as |
333 | #define that have side effects are still obeyed. */ | |
334 | unsigned char no_output; | |
7f2935c7 | 335 | |
31031edd JL |
336 | /* Nonzero means we should look for header.gcc files that remap file |
337 | names. */ | |
ae79697b | 338 | unsigned char remap; |
31031edd | 339 | |
7f2935c7 | 340 | /* Nonzero means don't output line number information. */ |
ae79697b | 341 | unsigned char no_line_commands; |
7f2935c7 | 342 | |
ae79697b ZW |
343 | /* Nonzero means -I- has been seen, so don't look for #include "foo" |
344 | the source-file directory. */ | |
345 | unsigned char ignore_srcdir; | |
7f2935c7 | 346 | |
ae79697b ZW |
347 | /* Zero means dollar signs are punctuation. */ |
348 | unsigned char dollars_in_ident; | |
7f2935c7 | 349 | |
6ac34fdc | 350 | /* Nonzero means warn if undefined identifiers are evaluated in an #if. */ |
ae79697b | 351 | unsigned char warn_undef; |
6ac34fdc | 352 | |
31948547 | 353 | /* Nonzero for the 1999 C Standard, including corrigenda and amendments. */ |
ae79697b | 354 | unsigned char c99; |
31948547 | 355 | |
7f2935c7 | 356 | /* Nonzero means give all the error messages the ANSI standard requires. */ |
ae79697b | 357 | unsigned char pedantic; |
7f2935c7 | 358 | |
3773a46b JM |
359 | /* Nonzero means we're looking at already preprocessed code, so don't |
360 | bother trying to do macro expansion and whatnot. */ | |
ae79697b | 361 | unsigned char preprocessed; |
3773a46b | 362 | |
ae79697b ZW |
363 | /* Nonzero disables all the standard directories for headers. */ |
364 | unsigned char no_standard_includes; | |
7f2935c7 | 365 | |
ae79697b ZW |
366 | /* Nonzero disables the C++-specific standard directories for headers. */ |
367 | unsigned char no_standard_cplusplus_includes; | |
7f2935c7 | 368 | |
ae79697b ZW |
369 | /* Nonzero means dump macros in some fashion - see above. */ |
370 | unsigned char dump_macros; | |
7f2935c7 | 371 | |
ae79697b ZW |
372 | /* Nonzero means pass #include lines through to the output. */ |
373 | unsigned char dump_includes; | |
7f2935c7 | 374 | |
ae79697b ZW |
375 | /* Print column number in error messages. */ |
376 | unsigned char show_column; | |
be768055 JJ |
377 | |
378 | /* Treat C++ alternate operator names special. */ | |
379 | unsigned char operator_names; | |
7e96d768 NB |
380 | |
381 | /* True if --help, --version or --target-help appeared in the | |
382 | options. Stand-alone CPP should then bail out after option | |
383 | parsing; drivers might want to continue printing help. */ | |
384 | unsigned char help_only; | |
ae79697b | 385 | }; |
7f2935c7 | 386 | |
27e2564a NB |
387 | /* This structure is passed to the call back when changing file. */ |
388 | enum cpp_fc_reason {FC_ENTER = 0, FC_LEAVE, FC_RENAME}; | |
389 | ||
390 | struct cpp_file_loc | |
391 | { | |
392 | const char *filename; | |
393 | unsigned int lineno; | |
394 | }; | |
395 | ||
396 | typedef struct cpp_file_change cpp_file_change; | |
397 | struct cpp_file_change | |
398 | { | |
399 | struct cpp_file_loc from; /* Line of #include or #line. */ | |
400 | struct cpp_file_loc to; /* Line after #include or #line, or start. */ | |
401 | enum cpp_fc_reason reason; /* Reason for change. */ | |
402 | unsigned char sysp; /* Nonzero if system header. */ | |
403 | unsigned char externc; /* Nonzero if wrapper needed. */ | |
404 | }; | |
405 | ||
7e96d768 NB |
406 | /* Call backs. */ |
407 | struct cpp_callbacks | |
408 | { | |
409 | void (*file_change) PARAMS ((cpp_reader *, const cpp_file_change *)); | |
410 | void (*include) PARAMS ((cpp_reader *, const unsigned char *, | |
411 | const cpp_token *)); | |
412 | void (*define) PARAMS ((cpp_reader *, cpp_hashnode *)); | |
413 | void (*undef) PARAMS ((cpp_reader *, cpp_hashnode *)); | |
414 | void (*poison) PARAMS ((cpp_reader *)); | |
415 | void (*ident) PARAMS ((cpp_reader *, const cpp_string *)); | |
416 | void (*def_pragma) PARAMS ((cpp_reader *)); | |
417 | }; | |
418 | ||
ae79697b ZW |
419 | #define CPP_FATAL_LIMIT 1000 |
420 | /* True if we have seen a "fatal" error. */ | |
7e96d768 | 421 | #define CPP_FATAL_ERRORS(PFILE) (cpp_errors (PFILE) >= CPP_FATAL_LIMIT) |
ae79697b | 422 | |
7f2935c7 | 423 | /* Name under which this program was invoked. */ |
bcc5cac9 | 424 | extern const char *progname; |
7f2935c7 | 425 | |
ad2a084d NB |
426 | /* Where does this buffer come from? A faked include, a source file, |
427 | a builtin macro, a command-line option, or a _Pragma operator. */ | |
428 | enum cpp_buffer_type {BUF_FAKE, BUF_FILE, BUF_BUILTIN, | |
429 | BUF_CL_OPTION, BUF_PRAGMA}; | |
0bda4760 | 430 | |
93c80368 NB |
431 | /* The structure of a node in the hash table. The hash table has |
432 | entries for all identifiers: either macros defined by #define | |
433 | commands (type NT_MACRO), assertions created with #assert | |
434 | (NT_ASSERTION), or neither of the above (NT_VOID). Builtin macros | |
435 | like __LINE__ are flagged NODE_BUILTIN. Poisioned identifiers are | |
436 | flagged NODE_POISONED. NODE_OPERATOR (C++ only) indicates an | |
437 | identifier that behaves like an operator such as "xor". | |
438 | NODE_DIAGNOSTIC is for speed in lex_token: it indicates a | |
439 | diagnostic may be required for this node. Currently this only | |
440 | applies to __VA_ARGS__ and poisoned identifiers. */ | |
441 | ||
442 | /* Hash node flags. */ | |
443 | #define NODE_OPERATOR (1 << 0) /* C++ named operator. */ | |
444 | #define NODE_POISONED (1 << 1) /* Poisoned identifier. */ | |
445 | #define NODE_BUILTIN (1 << 2) /* Builtin macro. */ | |
446 | #define NODE_DIAGNOSTIC (1 << 3) /* Possible diagnostic when lexed. */ | |
618cdda7 | 447 | #define NODE_WARN (1 << 4) /* Warn if redefined or undefined. */ |
93c80368 NB |
448 | |
449 | /* Different flavors of hash node. */ | |
f8f769ea ZW |
450 | enum node_type |
451 | { | |
93c80368 NB |
452 | NT_VOID = 0, /* No definition yet. */ |
453 | NT_MACRO, /* A macro of some form. */ | |
454 | NT_ASSERTION /* Predicate for #assert. */ | |
455 | }; | |
456 | ||
457 | /* Different flavors of builtin macro. */ | |
458 | enum builtin_type | |
459 | { | |
460 | BT_SPECLINE = 0, /* `__LINE__' */ | |
461 | BT_DATE, /* `__DATE__' */ | |
462 | BT_FILE, /* `__FILE__' */ | |
463 | BT_BASE_FILE, /* `__BASE_FILE__' */ | |
464 | BT_INCLUDE_LEVEL, /* `__INCLUDE_LEVEL__' */ | |
465 | BT_TIME, /* `__TIME__' */ | |
7868b4a2 | 466 | BT_STDC /* `__STDC__' */ |
f8f769ea ZW |
467 | }; |
468 | ||
608477bd | 469 | #include "c-rid.h" |
f8f769ea | 470 | |
608477bd NB |
471 | #define C_RID_CODE(id) (((struct c_common_identifier *) (id))->rid_code) |
472 | ||
473 | /* The common part of an identifier node shared amongst all 3 C front | |
474 | ends. Also used to store CPP identifiers, which are a superset of | |
475 | identifiers in the grammatical sense. */ | |
476 | struct c_common_identifier | |
f8f769ea | 477 | { |
608477bd | 478 | struct tree_identifier ident; /* See tree-core.h. */ |
dd07b884 NB |
479 | unsigned short arg_index; /* Macro argument index. */ |
480 | unsigned char directive_index; /* Index into directive table. */ | |
608477bd NB |
481 | ENUM_BITFIELD(rid) rid_code : 8; /* Rid code - for front ends. */ |
482 | ENUM_BITFIELD(node_type) type : 8; /* CPP node type. */ | |
483 | unsigned char flags; /* CPP flags. */ | |
f8f769ea | 484 | |
041c3194 ZW |
485 | union |
486 | { | |
dd07b884 NB |
487 | cpp_macro *macro; /* If a macro. */ |
488 | struct answer *answers; /* Answers to an assertion. */ | |
489 | enum cpp_ttype operator; /* Code for a named operator. */ | |
490 | enum builtin_type builtin; /* Code for a builtin macro. */ | |
f8f769ea | 491 | } value; |
f8f769ea ZW |
492 | }; |
493 | ||
96302433 | 494 | /* Call this first to get a handle to pass to other functions. */ |
cf44ea52 | 495 | extern cpp_reader *cpp_create_reader PARAMS ((enum c_lang)); |
96302433 | 496 | |
400023a3 NB |
497 | /* Call this to release the handle. Any use of the handle after this |
498 | function returns is invalid. Returns cpp_errors (pfile). */ | |
499 | extern int cpp_destroy PARAMS ((cpp_reader *)); | |
500 | ||
7e96d768 NB |
501 | /* Call these to get pointers to the options and callback structures |
502 | for a given reader. These pointers are good until you call | |
503 | cpp_finish on that reader. You can either edit the callbacks | |
504 | through the pointer returned from cpp_get_callbacks, or set them | |
505 | with cpp_set_callbacks. */ | |
506 | extern cpp_options *cpp_get_options PARAMS ((cpp_reader *)); | |
507 | extern cpp_callbacks *cpp_get_callbacks PARAMS ((cpp_reader *)); | |
508 | extern void cpp_set_callbacks PARAMS ((cpp_reader *, cpp_callbacks *)); | |
509 | ||
96302433 NB |
510 | /* Now call cpp_handle_option[s] to handle 1[or more] switches. The |
511 | return value is the number of arguments used. If | |
512 | cpp_handle_options returns without using all arguments, it couldn't | |
513 | understand the next switch. When there are no switches left, you | |
514 | must call cpp_post_options before calling cpp_start_read. Only | |
515 | after cpp_post_options are the contents of the cpp_options | |
516 | structure reliable. */ | |
517 | extern int cpp_handle_options PARAMS ((cpp_reader *, int, char **)); | |
518 | extern int cpp_handle_option PARAMS ((cpp_reader *, int, char **)); | |
519 | extern void cpp_post_options PARAMS ((cpp_reader *)); | |
520 | ||
7e96d768 NB |
521 | /* Error count. */ |
522 | extern unsigned int cpp_errors PARAMS ((cpp_reader *)); | |
523 | ||
93c80368 | 524 | extern unsigned int cpp_token_len PARAMS ((const cpp_token *)); |
dd07b884 NB |
525 | extern unsigned char *cpp_token_as_text PARAMS ((cpp_reader *, |
526 | const cpp_token *)); | |
93c80368 NB |
527 | extern unsigned char *cpp_spell_token PARAMS ((cpp_reader *, const cpp_token *, |
528 | unsigned char *)); | |
58fea6af ZW |
529 | extern void cpp_register_pragma PARAMS ((cpp_reader *, |
530 | const char *, const char *, | |
531 | void (*) PARAMS ((cpp_reader *)))); | |
532 | extern void cpp_register_pragma_space PARAMS ((cpp_reader *, const char *)); | |
533 | ||
93c80368 NB |
534 | extern int cpp_start_read PARAMS ((cpp_reader *, const char *)); |
535 | extern void cpp_finish PARAMS ((cpp_reader *)); | |
93c80368 NB |
536 | extern int cpp_avoid_paste PARAMS ((cpp_reader *, const cpp_token *, |
537 | const cpp_token *)); | |
538 | extern enum cpp_ttype cpp_can_paste PARAMS ((cpp_reader *, const cpp_token *, | |
539 | const cpp_token *, int *)); | |
540 | extern void cpp_get_token PARAMS ((cpp_reader *, cpp_token *)); | |
541 | extern const cpp_lexer_pos *cpp_get_line PARAMS ((cpp_reader *)); | |
542 | extern const unsigned char *cpp_macro_definition PARAMS ((cpp_reader *, | |
543 | const cpp_hashnode *)); | |
041c3194 | 544 | |
c8a96070 NB |
545 | /* Evaluate a CPP_CHAR or CPP_WCHAR token. */ |
546 | extern HOST_WIDE_INT | |
547 | cpp_interpret_charconst PARAMS ((cpp_reader *, const cpp_token *, | |
548 | int, int, unsigned int *)); | |
549 | ||
7ceb3598 NB |
550 | extern void cpp_define PARAMS ((cpp_reader *, const char *)); |
551 | extern void cpp_assert PARAMS ((cpp_reader *, const char *)); | |
552 | extern void cpp_undef PARAMS ((cpp_reader *, const char *)); | |
553 | extern void cpp_unassert PARAMS ((cpp_reader *, const char *)); | |
7f2935c7 | 554 | |
711b8824 | 555 | extern cpp_buffer *cpp_push_buffer PARAMS ((cpp_reader *, |
0bda4760 NB |
556 | const unsigned char *, size_t, |
557 | enum cpp_buffer_type, | |
558 | const char *)); | |
711b8824 ZW |
559 | extern cpp_buffer *cpp_pop_buffer PARAMS ((cpp_reader *)); |
560 | extern int cpp_defined PARAMS ((cpp_reader *, const unsigned char *, int)); | |
c5a04734 | 561 | |
c1212d2f ZW |
562 | /* N.B. The error-message-printer prototypes have not been nicely |
563 | formatted because exgettext needs to see 'msgid' on the same line | |
564 | as the name of the function in order to work properly. Only the | |
565 | string argument gets a name in an effort to keep the lines from | |
566 | getting ridiculously oversized. */ | |
567 | ||
568 | extern void cpp_ice PARAMS ((cpp_reader *, const char *msgid, ...)) | |
487a6e06 | 569 | ATTRIBUTE_PRINTF_2; |
c1212d2f | 570 | extern void cpp_fatal PARAMS ((cpp_reader *, const char *msgid, ...)) |
487a6e06 | 571 | ATTRIBUTE_PRINTF_2; |
c1212d2f | 572 | extern void cpp_error PARAMS ((cpp_reader *, const char *msgid, ...)) |
487a6e06 | 573 | ATTRIBUTE_PRINTF_2; |
c1212d2f ZW |
574 | extern void cpp_warning PARAMS ((cpp_reader *, const char *msgid, ...)) |
575 | ATTRIBUTE_PRINTF_2; | |
576 | extern void cpp_pedwarn PARAMS ((cpp_reader *, const char *msgid, ...)) | |
577 | ATTRIBUTE_PRINTF_2; | |
578 | extern void cpp_notice PARAMS ((cpp_reader *, const char *msgid, ...)) | |
579 | ATTRIBUTE_PRINTF_2; | |
580 | extern void cpp_error_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...)) | |
554fbeef | 581 | ATTRIBUTE_PRINTF_4; |
c1212d2f | 582 | extern void cpp_warning_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...)) |
487a6e06 | 583 | ATTRIBUTE_PRINTF_4; |
c1212d2f | 584 | extern void cpp_pedwarn_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...)) |
487a6e06 | 585 | ATTRIBUTE_PRINTF_4; |
c1212d2f ZW |
586 | extern void cpp_pedwarn_with_file_and_line PARAMS ((cpp_reader *, const char *, int, int, const char *msgid, ...)) |
587 | ATTRIBUTE_PRINTF_5; | |
711b8824 ZW |
588 | extern void cpp_error_from_errno PARAMS ((cpp_reader *, const char *)); |
589 | extern void cpp_notice_from_errno PARAMS ((cpp_reader *, const char *)); | |
f2d5f0cc ZW |
590 | |
591 | /* In cpplex.c */ | |
bfb9dc7f ZW |
592 | extern int cpp_ideq PARAMS ((const cpp_token *, |
593 | const char *)); | |
93c80368 NB |
594 | extern void cpp_output_line PARAMS ((cpp_reader *, FILE *)); |
595 | extern void cpp_output_token PARAMS ((const cpp_token *, FILE *)); | |
596 | extern const char *cpp_type2name PARAMS ((enum cpp_ttype)); | |
1368ee70 | 597 | |
f2d5f0cc | 598 | /* In cpphash.c */ |
93c80368 NB |
599 | extern cpp_hashnode *cpp_lookup PARAMS ((cpp_reader *, |
600 | const unsigned char *, size_t)); | |
601 | extern void cpp_forall_identifiers PARAMS ((cpp_reader *, | |
602 | int (*) PARAMS ((cpp_reader *, | |
926c5678 GK |
603 | cpp_hashnode *, |
604 | void *)), | |
605 | void *)); | |
606 | ||
58fea6af | 607 | /* In cppmacro.c */ |
8dc4676d | 608 | extern void cpp_scan_buffer_nooutput PARAMS ((cpp_reader *, int)); |
93c80368 NB |
609 | extern void cpp_start_lookahead PARAMS ((cpp_reader *)); |
610 | extern void cpp_stop_lookahead PARAMS ((cpp_reader *, int)); | |
c691145a | 611 | extern int cpp_sys_macro_p PARAMS ((cpp_reader *)); |
6de1e2a9 | 612 | |
add7091b | 613 | /* In cppfiles.c */ |
711b8824 | 614 | extern int cpp_included PARAMS ((cpp_reader *, const char *)); |
614c7d37 | 615 | extern void cpp_make_system_header PARAMS ((cpp_reader *, int, int)); |
b0699dad | 616 | |
7f2935c7 PB |
617 | #ifdef __cplusplus |
618 | } | |
619 | #endif | |
990c642c | 620 | #endif /* __GCC_CPPLIB__ */ |