]>
Commit | Line | Data |
---|---|---|
7f2935c7 | 1 | /* Definitions for CPP library. |
c58b209a | 2 | Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003 |
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! */ | |
2a967f3d NB |
23 | #ifndef GCC_CPPLIB_H |
24 | #define GCC_CPPLIB_H | |
7f2935c7 PB |
25 | |
26 | #include <sys/types.h> | |
2a967f3d | 27 | #include "hashtable.h" |
d82fc108 | 28 | #include "line-map.h" |
7f2935c7 PB |
29 | |
30 | #ifdef __cplusplus | |
31 | extern "C" { | |
32 | #endif | |
33 | ||
7f2935c7 PB |
34 | typedef struct cpp_reader cpp_reader; |
35 | typedef struct cpp_buffer cpp_buffer; | |
36 | typedef struct cpp_options cpp_options; | |
1368ee70 | 37 | typedef struct cpp_token cpp_token; |
bfb9dc7f | 38 | typedef struct cpp_string cpp_string; |
a50882dc | 39 | typedef struct cpp_hashnode cpp_hashnode; |
93c80368 | 40 | typedef struct cpp_macro cpp_macro; |
7e96d768 | 41 | typedef struct cpp_callbacks cpp_callbacks; |
8f9b4009 | 42 | typedef struct cpp_dir cpp_dir; |
93c80368 | 43 | |
93c80368 | 44 | struct answer; |
c5a04734 | 45 | |
f8b954fc NB |
46 | /* The first three groups, apart from '=', can appear in preprocessor |
47 | expressions (+= and -= are used to indicate unary + and - resp.). | |
48 | This allows a lookup table to be implemented in _cpp_parse_expr. | |
c5a04734 ZW |
49 | |
50 | The first group, to CPP_LAST_EQ, can be immediately followed by an | |
51 | '='. The lexer needs operators ending in '=', like ">>=", to be in | |
52 | the same order as their counterparts without the '=', like ">>". */ | |
53 | ||
54 | /* Positions in the table. */ | |
6fee6033 | 55 | #define CPP_LAST_EQ CPP_MAX |
c5a04734 | 56 | #define CPP_FIRST_DIGRAPH CPP_HASH |
9ec7291f | 57 | #define CPP_LAST_PUNCTUATOR CPP_DOT_STAR |
87ed109f | 58 | #define CPP_LAST_CPP_OP CPP_LESS_EQ |
1368ee70 | 59 | |
1368ee70 | 60 | #define TTYPE_TABLE \ |
96be6998 ZW |
61 | OP(CPP_EQ = 0, "=") \ |
62 | OP(CPP_NOT, "!") \ | |
63 | OP(CPP_GREATER, ">") /* compare */ \ | |
64 | OP(CPP_LESS, "<") \ | |
65 | OP(CPP_PLUS, "+") /* math */ \ | |
66 | OP(CPP_MINUS, "-") \ | |
67 | OP(CPP_MULT, "*") \ | |
68 | OP(CPP_DIV, "/") \ | |
69 | OP(CPP_MOD, "%") \ | |
70 | OP(CPP_AND, "&") /* bit ops */ \ | |
71 | OP(CPP_OR, "|") \ | |
72 | OP(CPP_XOR, "^") \ | |
73 | OP(CPP_RSHIFT, ">>") \ | |
74 | OP(CPP_LSHIFT, "<<") \ | |
92936ecf ZW |
75 | OP(CPP_MIN, "<?") /* extension */ \ |
76 | OP(CPP_MAX, ">?") \ | |
c5a04734 | 77 | \ |
96be6998 ZW |
78 | OP(CPP_COMPL, "~") \ |
79 | OP(CPP_AND_AND, "&&") /* logical */ \ | |
80 | OP(CPP_OR_OR, "||") \ | |
81 | OP(CPP_QUERY, "?") \ | |
82 | OP(CPP_COLON, ":") \ | |
83 | OP(CPP_COMMA, ",") /* grouping */ \ | |
84 | OP(CPP_OPEN_PAREN, "(") \ | |
85 | OP(CPP_CLOSE_PAREN, ")") \ | |
87ed109f | 86 | TK(CPP_EOF, SPELL_NONE) \ |
96be6998 ZW |
87 | OP(CPP_EQ_EQ, "==") /* compare */ \ |
88 | OP(CPP_NOT_EQ, "!=") \ | |
89 | OP(CPP_GREATER_EQ, ">=") \ | |
90 | OP(CPP_LESS_EQ, "<=") \ | |
1368ee70 | 91 | \ |
87ed109f | 92 | /* These two are unary + / - in preprocessor expressions. */ \ |
96be6998 ZW |
93 | OP(CPP_PLUS_EQ, "+=") /* math */ \ |
94 | OP(CPP_MINUS_EQ, "-=") \ | |
f8b954fc | 95 | \ |
96be6998 ZW |
96 | OP(CPP_MULT_EQ, "*=") \ |
97 | OP(CPP_DIV_EQ, "/=") \ | |
98 | OP(CPP_MOD_EQ, "%=") \ | |
99 | OP(CPP_AND_EQ, "&=") /* bit ops */ \ | |
100 | OP(CPP_OR_EQ, "|=") \ | |
101 | OP(CPP_XOR_EQ, "^=") \ | |
102 | OP(CPP_RSHIFT_EQ, ">>=") \ | |
103 | OP(CPP_LSHIFT_EQ, "<<=") \ | |
92936ecf ZW |
104 | OP(CPP_MIN_EQ, "<?=") /* extension */ \ |
105 | OP(CPP_MAX_EQ, ">?=") \ | |
c5a04734 | 106 | /* Digraphs together, beginning with CPP_FIRST_DIGRAPH. */ \ |
96be6998 ZW |
107 | OP(CPP_HASH, "#") /* digraphs */ \ |
108 | OP(CPP_PASTE, "##") \ | |
109 | OP(CPP_OPEN_SQUARE, "[") \ | |
110 | OP(CPP_CLOSE_SQUARE, "]") \ | |
111 | OP(CPP_OPEN_BRACE, "{") \ | |
112 | OP(CPP_CLOSE_BRACE, "}") \ | |
113 | /* The remainder of the punctuation. Order is not significant. */ \ | |
114 | OP(CPP_SEMICOLON, ";") /* structure */ \ | |
115 | OP(CPP_ELLIPSIS, "...") \ | |
96be6998 ZW |
116 | OP(CPP_PLUS_PLUS, "++") /* increment */ \ |
117 | OP(CPP_MINUS_MINUS, "--") \ | |
118 | OP(CPP_DEREF, "->") /* accessors */ \ | |
119 | OP(CPP_DOT, ".") \ | |
120 | OP(CPP_SCOPE, "::") \ | |
121 | OP(CPP_DEREF_STAR, "->*") \ | |
122 | OP(CPP_DOT_STAR, ".*") \ | |
40f03658 | 123 | OP(CPP_ATSIGN, "@") /* used in Objective-C */ \ |
1368ee70 | 124 | \ |
96be6998 | 125 | TK(CPP_NAME, SPELL_IDENT) /* word */ \ |
e6cc3a24 | 126 | TK(CPP_AT_NAME, SPELL_IDENT) /* @word - Objective-C */ \ |
6338b358 | 127 | TK(CPP_NUMBER, SPELL_LITERAL) /* 34_be+ta */ \ |
1368ee70 | 128 | \ |
6338b358 NB |
129 | TK(CPP_CHAR, SPELL_LITERAL) /* 'char' */ \ |
130 | TK(CPP_WCHAR, SPELL_LITERAL) /* L'char' */ \ | |
131 | TK(CPP_OTHER, SPELL_LITERAL) /* stray punctuation */ \ | |
96be6998 | 132 | \ |
6338b358 NB |
133 | TK(CPP_STRING, SPELL_LITERAL) /* "string" */ \ |
134 | TK(CPP_WSTRING, SPELL_LITERAL) /* L"string" */ \ | |
e6cc3a24 | 135 | TK(CPP_OBJC_STRING, SPELL_LITERAL) /* @"string" - Objective-C */ \ |
6338b358 | 136 | TK(CPP_HEADER_NAME, SPELL_LITERAL) /* <stdio.h> in #include */ \ |
96be6998 | 137 | \ |
6338b358 NB |
138 | TK(CPP_COMMENT, SPELL_LITERAL) /* Only if output comments. */ \ |
139 | /* SPELL_LITERAL happens to DTRT. */ \ | |
96be6998 | 140 | TK(CPP_MACRO_ARG, SPELL_NONE) /* Macro argument. */ \ |
f8b954fc | 141 | TK(CPP_PADDING, SPELL_NONE) /* Whitespace for cpp0. */ |
1368ee70 | 142 | |
96be6998 ZW |
143 | #define OP(e, s) e, |
144 | #define TK(e, s) e, | |
3a2b2c7a | 145 | enum cpp_ttype |
c45da1ca | 146 | { |
1368ee70 ZW |
147 | TTYPE_TABLE |
148 | N_TTYPES | |
149 | }; | |
96be6998 ZW |
150 | #undef OP |
151 | #undef TK | |
1368ee70 | 152 | |
dd07b884 NB |
153 | /* C language kind, used when calling cpp_reader_init. */ |
154 | enum c_lang {CLK_GNUC89 = 0, CLK_GNUC99, CLK_STDC89, CLK_STDC94, CLK_STDC99, | |
bdcae02b | 155 | CLK_GNUCXX, CLK_CXX98, CLK_ASM}; |
dd07b884 | 156 | |
5d8ebbd8 | 157 | /* Payload of a NUMBER, STRING, CHAR or COMMENT token. */ |
bfb9dc7f | 158 | struct cpp_string |
1368ee70 ZW |
159 | { |
160 | unsigned int len; | |
f617b8e2 | 161 | const unsigned char *text; |
1368ee70 ZW |
162 | }; |
163 | ||
c5a04734 | 164 | /* Flags for the cpp_token structure. */ |
041c3194 | 165 | #define PREV_WHITE (1 << 0) /* If whitespace before this token. */ |
93c80368 NB |
166 | #define DIGRAPH (1 << 1) /* If it was a digraph. */ |
167 | #define STRINGIFY_ARG (1 << 2) /* If macro argument to be stringified. */ | |
168 | #define PASTE_LEFT (1 << 3) /* If on LHS of a ## operator. */ | |
dd07b884 | 169 | #define NAMED_OP (1 << 4) /* C++ named operators. */ |
93c80368 | 170 | #define NO_EXPAND (1 << 5) /* Do not macro-expand this token. */ |
4ed5bcfb | 171 | #define BOL (1 << 6) /* Token at beginning of line. */ |
9e62c811 | 172 | |
1920de47 | 173 | /* A preprocessing token. This has been carefully packed and should |
644eddaa | 174 | occupy 16 bytes on 32-bit hosts and 24 bytes on 64-bit hosts. */ |
1368ee70 ZW |
175 | struct cpp_token |
176 | { | |
dc3786d8 | 177 | fileline line; /* Logical line of first char of token. */ |
1444f2ed | 178 | unsigned short col; /* Column of first char of token. */ |
041c3194 ZW |
179 | ENUM_BITFIELD(cpp_ttype) type : CHAR_BIT; /* token type */ |
180 | unsigned char flags; /* flags - see above */ | |
181 | ||
1368ee70 ZW |
182 | union |
183 | { | |
2a967f3d | 184 | cpp_hashnode *node; /* An identifier. */ |
4ed5bcfb | 185 | const cpp_token *source; /* Inherit padding from this token. */ |
6c53ebff NB |
186 | struct cpp_string str; /* A string, or number. */ |
187 | unsigned int arg_no; /* Argument no. for a CPP_MACRO_ARG. */ | |
1368ee70 | 188 | } val; |
7f2935c7 PB |
189 | }; |
190 | ||
4268e8bb | 191 | /* A type wide enough to hold any multibyte source character. |
625458d0 | 192 | cpplib's character constant interpreter requires an unsigned type. |
43839642 ZW |
193 | Also, a typedef for the signed equivalent. |
194 | The width of this type is capped at 32 bits; there do exist targets | |
195 | where wchar_t is 64 bits, but only in a non-default mode, and there | |
196 | would be no meaningful interpretation for a wchar_t value greater | |
197 | than 2^32 anyway -- the widest wide-character encoding around is | |
198 | ISO 10646, which stops at 2^31. */ | |
199 | #if CHAR_BIT * SIZEOF_INT >= 32 | |
625458d0 | 200 | # define CPPCHAR_SIGNED_T int |
43839642 ZW |
201 | #elif CHAR_BIT * SIZEOF_LONG >= 32 |
202 | # define CPPCHAR_SIGNED_T long | |
625458d0 | 203 | #else |
43839642 | 204 | # error "Cannot find a least-32-bit signed integer type" |
625458d0 NB |
205 | #endif |
206 | typedef unsigned CPPCHAR_SIGNED_T cppchar_t; | |
207 | typedef CPPCHAR_SIGNED_T cppchar_signed_t; | |
0d9f234d | 208 | |
ae79697b ZW |
209 | /* This structure is nested inside struct cpp_reader, and |
210 | carries all the options visible to the command line. */ | |
211 | struct cpp_options | |
c50bca08 | 212 | { |
6ab3e7dd NB |
213 | /* Characters between tab stops. */ |
214 | unsigned int tabstop; | |
215 | ||
bdb05a7b NB |
216 | /* The language we're preprocessing. */ |
217 | enum c_lang lang; | |
218 | ||
7f2935c7 | 219 | /* Nonzero means use extra default include directories for C++. */ |
ae79697b | 220 | unsigned char cplusplus; |
7f2935c7 | 221 | |
6614fd40 | 222 | /* Nonzero means handle cplusplus style comments. */ |
ae79697b | 223 | unsigned char cplusplus_comments; |
7f2935c7 | 224 | |
bdcae02b NB |
225 | /* Nonzero means define __OBJC__, treat @ as a special token, and |
226 | use the OBJC[PLUS]_INCLUDE_PATH environment variable. */ | |
ae79697b | 227 | unsigned char objc; |
7f2935c7 | 228 | |
564ad5f4 | 229 | /* Nonzero means don't copy comments into the output file. */ |
ae79697b | 230 | unsigned char discard_comments; |
7f2935c7 | 231 | |
477cdac7 JT |
232 | /* Nonzero means don't copy comments into the output file during |
233 | macro expansion. */ | |
234 | unsigned char discard_comments_in_macro_exp; | |
235 | ||
041c3194 | 236 | /* Nonzero means process the ISO trigraph sequences. */ |
ae79697b | 237 | unsigned char trigraphs; |
7f2935c7 | 238 | |
9b55f29a NB |
239 | /* Nonzero means process the ISO digraph sequences. */ |
240 | unsigned char digraphs; | |
241 | ||
bdb05a7b NB |
242 | /* Nonzero means to allow hexadecimal floats and LL suffixes. */ |
243 | unsigned char extended_numbers; | |
244 | ||
7f2935c7 | 245 | /* Nonzero means print names of header files (-H). */ |
ae79697b | 246 | unsigned char print_include_names; |
7f2935c7 | 247 | |
ae79697b ZW |
248 | /* Nonzero means cpp_pedwarn causes a hard error. */ |
249 | unsigned char pedantic_errors; | |
7f2935c7 | 250 | |
c1212d2f | 251 | /* Nonzero means don't print warning messages. */ |
ae79697b | 252 | unsigned char inhibit_warnings; |
7f2935c7 | 253 | |
9fbd3e41 JM |
254 | /* Nonzero means complain about deprecated features. */ |
255 | unsigned char warn_deprecated; | |
256 | ||
317639a8 BC |
257 | /* Nonzero means don't suppress warnings from system headers. */ |
258 | unsigned char warn_system_headers; | |
259 | ||
ae79697b ZW |
260 | /* Nonzero means don't print error messages. Has no option to |
261 | select it, but can be set by a user of cpplib (e.g. fix-header). */ | |
262 | unsigned char inhibit_errors; | |
c1212d2f | 263 | |
7f2935c7 | 264 | /* Nonzero means warn if slash-star appears in a comment. */ |
ae79697b | 265 | unsigned char warn_comments; |
7f2935c7 PB |
266 | |
267 | /* Nonzero means warn if there are any trigraphs. */ | |
ae79697b | 268 | unsigned char warn_trigraphs; |
7f2935c7 | 269 | |
a5a49440 NB |
270 | /* Nonzero means warn about multicharacter charconsts. */ |
271 | unsigned char warn_multichar; | |
272 | ||
f9a0e96c ZW |
273 | /* Nonzero means warn about various incompatibilities with |
274 | traditional C. */ | |
07aa0b04 | 275 | unsigned char warn_traditional; |
7f2935c7 | 276 | |
cd7ab83f NB |
277 | /* Nonzero means warn about long long numeric constants. */ |
278 | unsigned char warn_long_long; | |
279 | ||
909de5da PE |
280 | /* Nonzero means warn about text after an #endif (or #else). */ |
281 | unsigned char warn_endif_labels; | |
282 | ||
68e65275 NB |
283 | /* Nonzero means warn about implicit sign changes owing to integer |
284 | promotions. */ | |
285 | unsigned char warn_num_sign_change; | |
286 | ||
7f2935c7 | 287 | /* Nonzero means turn warnings into errors. */ |
ae79697b | 288 | unsigned char warnings_are_errors; |
7f2935c7 | 289 | |
31031edd JL |
290 | /* Nonzero means we should look for header.gcc files that remap file |
291 | names. */ | |
ae79697b | 292 | unsigned char remap; |
31031edd | 293 | |
eebedaa5 | 294 | /* Zero means dollar signs are punctuation. */ |
ae79697b | 295 | unsigned char dollars_in_ident; |
7f2935c7 | 296 | |
78b8811a HPN |
297 | /* True if we should warn about dollars in identifiers or numbers |
298 | for this translation unit. */ | |
299 | unsigned char warn_dollars; | |
300 | ||
6ac34fdc | 301 | /* Nonzero means warn if undefined identifiers are evaluated in an #if. */ |
ae79697b | 302 | unsigned char warn_undef; |
6ac34fdc | 303 | |
a69cbaac NB |
304 | /* Nonzero means warn of unused macros from the main file. */ |
305 | unsigned char warn_unused_macros; | |
306 | ||
31948547 | 307 | /* Nonzero for the 1999 C Standard, including corrigenda and amendments. */ |
ae79697b | 308 | unsigned char c99; |
31948547 | 309 | |
58551c23 NB |
310 | /* Nonzero if we are conforming to a specific C or C++ standard. */ |
311 | unsigned char std; | |
312 | ||
7f2935c7 | 313 | /* Nonzero means give all the error messages the ANSI standard requires. */ |
ae79697b | 314 | unsigned char pedantic; |
7f2935c7 | 315 | |
3773a46b JM |
316 | /* Nonzero means we're looking at already preprocessed code, so don't |
317 | bother trying to do macro expansion and whatnot. */ | |
ae79697b | 318 | unsigned char preprocessed; |
3773a46b | 319 | |
ae79697b ZW |
320 | /* Print column number in error messages. */ |
321 | unsigned char show_column; | |
be768055 | 322 | |
644eddaa | 323 | /* Nonzero means handle C++ alternate operator names. */ |
be768055 | 324 | unsigned char operator_names; |
7e96d768 | 325 | |
004cb263 NB |
326 | /* True for traditional preprocessing. */ |
327 | unsigned char traditional; | |
328 | ||
e6cc3a24 ZW |
329 | /* Holds the name of the target (execution) character set. */ |
330 | const char *narrow_charset; | |
331 | ||
332 | /* Holds the name of the target wide character set. */ | |
333 | const char *wide_charset; | |
334 | ||
cf551fba EC |
335 | /* Holds the name of the input character set. */ |
336 | const char *input_charset; | |
337 | ||
783e2989 NB |
338 | /* True to warn about precompiled header files we couldn't use. */ |
339 | bool warn_invalid_pch; | |
340 | ||
341 | /* True if dependencies should be restored from a precompiled header. */ | |
342 | bool restore_pch_deps; | |
343 | ||
f4ff5a69 NB |
344 | /* Dependency generation. */ |
345 | struct | |
346 | { | |
347 | /* Style of header dependencies to generate. */ | |
348 | enum {DEPS_NONE = 0, DEPS_USER, DEPS_SYSTEM } style; | |
349 | ||
350 | /* Assume missing files are generated files. */ | |
351 | bool missing_files; | |
352 | ||
353 | /* Generate phony targets for each dependency apart from the first | |
354 | one. */ | |
355 | bool phony_targets; | |
182d89a3 NB |
356 | |
357 | /* If true, no dependency is generated on the main file. */ | |
358 | bool ignore_main_file; | |
f4ff5a69 NB |
359 | } deps; |
360 | ||
44a147ad NB |
361 | /* Target-specific features set by the front end or client. */ |
362 | ||
363 | /* Precision for target CPP arithmetic, target characters, target | |
364 | ints and target wide characters, respectively. */ | |
365 | size_t precision, char_precision, int_precision, wchar_precision; | |
366 | ||
23ff0223 NB |
367 | /* True means chars (wide chars) are unsigned. */ |
368 | bool unsigned_char, unsigned_wchar; | |
5279d739 | 369 | |
e6cc3a24 ZW |
370 | /* True if the most significant byte in a word has the lowest |
371 | address in memory. */ | |
372 | bool bytes_big_endian; | |
783e2989 | 373 | |
5279d739 ZW |
374 | /* Nonzero means __STDC__ should have the value 0 in system headers. */ |
375 | unsigned char stdc_0_in_system_headers; | |
b20d9f0c AO |
376 | |
377 | /* Nonzero means output a directory line marker right after the | |
378 | initial file name line marker, and before a duplicate initial | |
379 | line marker. */ | |
380 | bool working_directory; | |
ae79697b | 381 | }; |
7f2935c7 | 382 | |
48c4721e | 383 | /* Call backs to cpplib client. */ |
7e96d768 NB |
384 | struct cpp_callbacks |
385 | { | |
97293897 | 386 | /* Called when a new line of preprocessed output is started. */ |
6cf87ca4 | 387 | void (*line_change) (cpp_reader *, const cpp_token *, int); |
4dc299fb PB |
388 | |
389 | /* Called when switching to/from a new file. | |
390 | The line_map is for the new file. It is NULL if there is no new file. | |
391 | (In C this happens when done with <built-in>+<command line> and also | |
392 | when done with a main file.) This can be used for resource cleanup. */ | |
6cf87ca4 | 393 | void (*file_change) (cpp_reader *, const struct line_map *); |
4dc299fb | 394 | |
b20d9f0c | 395 | void (*dir_change) (cpp_reader *, const char *); |
6cf87ca4 ZW |
396 | void (*include) (cpp_reader *, unsigned int, const unsigned char *, |
397 | const char *, int); | |
398 | void (*define) (cpp_reader *, unsigned int, cpp_hashnode *); | |
399 | void (*undef) (cpp_reader *, unsigned int, cpp_hashnode *); | |
400 | void (*ident) (cpp_reader *, unsigned int, const cpp_string *); | |
401 | void (*def_pragma) (cpp_reader *, unsigned int); | |
402 | int (*valid_pch) (cpp_reader *, const char *, int); | |
403 | void (*read_pch) (cpp_reader *, const char *, int, const char *); | |
7e96d768 NB |
404 | }; |
405 | ||
5793b276 | 406 | /* Chain of directories to look for include files in. */ |
8f9b4009 | 407 | struct cpp_dir |
5793b276 NB |
408 | { |
409 | /* NULL-terminated singly-linked list. */ | |
8f9b4009 | 410 | struct cpp_dir *next; |
5793b276 | 411 | |
8f9b4009 | 412 | /* NAME of the directory, NUL-terminated. */ |
5793b276 NB |
413 | char *name; |
414 | unsigned int len; | |
415 | ||
416 | /* One if a system header, two if a system header that has extern | |
417 | "C" guards for C++. */ | |
418 | unsigned char sysp; | |
419 | ||
8f9b4009 NB |
420 | /* Mapping of file names for this directory for MS-DOS and related |
421 | platforms. A NULL-terminated array of (from, to) pairs. */ | |
422 | const char **name_map; | |
cf551fba | 423 | |
5793b276 NB |
424 | /* The C front end uses these to recognize duplicated |
425 | directories in the search path. */ | |
426 | ino_t ino; | |
427 | dev_t dev; | |
428 | }; | |
429 | ||
7f2935c7 | 430 | /* Name under which this program was invoked. */ |
bcc5cac9 | 431 | extern const char *progname; |
7f2935c7 | 432 | |
93c80368 NB |
433 | /* The structure of a node in the hash table. The hash table has |
434 | entries for all identifiers: either macros defined by #define | |
435 | commands (type NT_MACRO), assertions created with #assert | |
436 | (NT_ASSERTION), or neither of the above (NT_VOID). Builtin macros | |
95bd1dd7 | 437 | like __LINE__ are flagged NODE_BUILTIN. Poisoned identifiers are |
93c80368 NB |
438 | flagged NODE_POISONED. NODE_OPERATOR (C++ only) indicates an |
439 | identifier that behaves like an operator such as "xor". | |
440 | NODE_DIAGNOSTIC is for speed in lex_token: it indicates a | |
441 | diagnostic may be required for this node. Currently this only | |
442 | applies to __VA_ARGS__ and poisoned identifiers. */ | |
443 | ||
444 | /* Hash node flags. */ | |
445 | #define NODE_OPERATOR (1 << 0) /* C++ named operator. */ | |
446 | #define NODE_POISONED (1 << 1) /* Poisoned identifier. */ | |
447 | #define NODE_BUILTIN (1 << 2) /* Builtin macro. */ | |
448 | #define NODE_DIAGNOSTIC (1 << 3) /* Possible diagnostic when lexed. */ | |
618cdda7 | 449 | #define NODE_WARN (1 << 4) /* Warn if redefined or undefined. */ |
644eddaa | 450 | #define NODE_DISABLED (1 << 5) /* A disabled macro. */ |
71c0e7fc | 451 | #define NODE_MACRO_ARG (1 << 6) /* Used during #define processing. */ |
93c80368 NB |
452 | |
453 | /* Different flavors of hash node. */ | |
f8f769ea ZW |
454 | enum node_type |
455 | { | |
93c80368 NB |
456 | NT_VOID = 0, /* No definition yet. */ |
457 | NT_MACRO, /* A macro of some form. */ | |
458 | NT_ASSERTION /* Predicate for #assert. */ | |
459 | }; | |
460 | ||
644eddaa NB |
461 | /* Different flavors of builtin macro. _Pragma is an operator, but we |
462 | handle it with the builtin code for efficiency reasons. */ | |
93c80368 NB |
463 | enum builtin_type |
464 | { | |
465 | BT_SPECLINE = 0, /* `__LINE__' */ | |
466 | BT_DATE, /* `__DATE__' */ | |
467 | BT_FILE, /* `__FILE__' */ | |
468 | BT_BASE_FILE, /* `__BASE_FILE__' */ | |
469 | BT_INCLUDE_LEVEL, /* `__INCLUDE_LEVEL__' */ | |
470 | BT_TIME, /* `__TIME__' */ | |
644eddaa NB |
471 | BT_STDC, /* `__STDC__' */ |
472 | BT_PRAGMA /* `_Pragma' operator */ | |
f8f769ea ZW |
473 | }; |
474 | ||
2a967f3d NB |
475 | #define CPP_HASHNODE(HNODE) ((cpp_hashnode *) (HNODE)) |
476 | #define HT_NODE(NODE) ((ht_identifier *) (NODE)) | |
477 | #define NODE_LEN(NODE) HT_LEN (&(NODE)->ident) | |
478 | #define NODE_NAME(NODE) HT_STR (&(NODE)->ident) | |
f8f769ea | 479 | |
2a967f3d NB |
480 | /* The common part of an identifier node shared amongst all 3 C front |
481 | ends. Also used to store CPP identifiers, which are a superset of | |
482 | identifiers in the grammatical sense. */ | |
17211ab5 | 483 | struct cpp_hashnode GTY(()) |
f8f769ea | 484 | { |
2a967f3d | 485 | struct ht_identifier ident; |
4977bab6 | 486 | unsigned int is_directive : 1; |
cf551fba | 487 | unsigned int directive_index : 7; /* If is_directive, |
4977bab6 | 488 | then index into directive table. |
71c0e7fc | 489 | Otherwise, a NODE_OPERATOR. */ |
2a967f3d NB |
490 | unsigned char rid_code; /* Rid code - for front ends. */ |
491 | ENUM_BITFIELD(node_type) type : 8; /* CPP node type. */ | |
492 | unsigned char flags; /* CPP flags. */ | |
f8f769ea | 493 | |
4977bab6 | 494 | union _cpp_hashnode_value |
041c3194 | 495 | { |
17211ab5 GK |
496 | /* If a macro. */ |
497 | cpp_macro * GTY((skip (""))) macro; | |
498 | /* Answers to an assertion. */ | |
499 | struct answer * GTY ((skip (""))) answers; | |
500 | /* Code for a builtin macro. */ | |
501 | enum builtin_type GTY ((tag ("1"))) builtin; | |
502 | /* Macro argument index. */ | |
503 | unsigned short GTY ((tag ("0"))) arg_index; | |
504 | } GTY ((desc ("0"))) value; | |
f8f769ea ZW |
505 | }; |
506 | ||
b4e46cea PB |
507 | /* Call this first to get a handle to pass to other functions. |
508 | ||
509 | If you want cpplib to manage its own hashtable, pass in a NULL | |
510 | pointer. Otherwise you should pass in an initialized hash table | |
511 | that cpplib will share; this technique is used by the C front | |
512 | ends. */ | |
6cf87ca4 | 513 | extern cpp_reader *cpp_create_reader (enum c_lang, struct ht *); |
400023a3 | 514 | |
f749a36b NB |
515 | /* Call this to change the selected language standard (e.g. because of |
516 | command line options). */ | |
6cf87ca4 | 517 | extern void cpp_set_lang (cpp_reader *, enum c_lang); |
f749a36b | 518 | |
76c3e73e NB |
519 | /* Add a dependency TARGET. Quote it for "make" if QUOTE. Can be |
520 | called any number of times before cpp_read_main_file(). If no | |
521 | targets have been added before cpp_read_main_file(), then the | |
522 | default target is used. */ | |
6cf87ca4 | 523 | extern void cpp_add_dependency_target (cpp_reader *, const char *, int); |
76c3e73e | 524 | |
5793b276 | 525 | /* Set the include paths. */ |
8f9b4009 | 526 | extern void cpp_set_include_chains (cpp_reader *, cpp_dir *, cpp_dir *, int); |
5793b276 | 527 | |
7e96d768 NB |
528 | /* Call these to get pointers to the options and callback structures |
529 | for a given reader. These pointers are good until you call | |
530 | cpp_finish on that reader. You can either edit the callbacks | |
531 | through the pointer returned from cpp_get_callbacks, or set them | |
532 | with cpp_set_callbacks. */ | |
6cf87ca4 ZW |
533 | extern cpp_options *cpp_get_options (cpp_reader *); |
534 | extern const struct line_maps *cpp_get_line_maps (cpp_reader *); | |
535 | extern cpp_callbacks *cpp_get_callbacks (cpp_reader *); | |
536 | extern void cpp_set_callbacks (cpp_reader *, cpp_callbacks *); | |
7e96d768 | 537 | |
4dc299fb PB |
538 | /* This function finds the main file, but does not start reading it. |
539 | Returns true iff the file was found. */ | |
540 | extern bool cpp_find_main_file (cpp_reader *, const char *); | |
541 | ||
542 | /* This function reads the file, but does not start preprocessing. | |
543 | This will generate at least one file change callback, and possibly | |
544 | a line change callback. */ | |
545 | extern void cpp_push_main_file (cpp_reader *); | |
f5e99456 | 546 | |
c1bad961 | 547 | /* Set up built-ins like __FILE__. */ |
6cf87ca4 | 548 | extern void cpp_init_builtins (cpp_reader *, int); |
f5e99456 | 549 | |
4169c321 | 550 | /* This is called after options have been parsed, and partially |
59e4e217 | 551 | processed. */ |
4169c321 PB |
552 | extern void cpp_post_options (cpp_reader *); |
553 | ||
e6cc3a24 ZW |
554 | /* Set up translation to the target character set. */ |
555 | extern void cpp_init_iconv (cpp_reader *); | |
556 | ||
f4ff5a69 NB |
557 | /* Call this to finish preprocessing. If you requested dependency |
558 | generation, pass an open stream to write the information to, | |
559 | otherwise NULL. It is your responsibility to close the stream. | |
560 | ||
561 | Returns cpp_errors (pfile). */ | |
6cf87ca4 | 562 | extern int cpp_finish (cpp_reader *, FILE *deps_stream); |
f4ff5a69 | 563 | |
f5e99456 NB |
564 | /* Call this to release the handle at the end of preprocessing. Any |
565 | use of the handle after this function returns is invalid. Returns | |
566 | cpp_errors (pfile). */ | |
6cf87ca4 | 567 | extern void cpp_destroy (cpp_reader *); |
f5e99456 | 568 | |
7e96d768 | 569 | /* Error count. */ |
6cf87ca4 ZW |
570 | extern unsigned int cpp_errors (cpp_reader *); |
571 | ||
572 | extern unsigned int cpp_token_len (const cpp_token *); | |
573 | extern unsigned char *cpp_token_as_text (cpp_reader *, const cpp_token *); | |
574 | extern unsigned char *cpp_spell_token (cpp_reader *, const cpp_token *, | |
575 | unsigned char *); | |
576 | extern void cpp_register_pragma (cpp_reader *, const char *, const char *, | |
577 | void (*) (cpp_reader *)); | |
578 | extern int cpp_avoid_paste (cpp_reader *, const cpp_token *, | |
579 | const cpp_token *); | |
580 | extern const cpp_token *cpp_get_token (cpp_reader *); | |
581 | extern const unsigned char *cpp_macro_definition (cpp_reader *, | |
582 | const cpp_hashnode *); | |
583 | extern void _cpp_backup_tokens (cpp_reader *, unsigned int); | |
041c3194 | 584 | |
c8a96070 | 585 | /* Evaluate a CPP_CHAR or CPP_WCHAR token. */ |
6cf87ca4 ZW |
586 | extern cppchar_t cpp_interpret_charconst (cpp_reader *, const cpp_token *, |
587 | unsigned int *, int *); | |
e6cc3a24 ZW |
588 | /* Evaluate a vector of CPP_STRING or CPP_WSTRING tokens. */ |
589 | extern bool cpp_interpret_string (cpp_reader *, | |
590 | const cpp_string *, size_t, | |
591 | cpp_string *, bool); | |
c8a96070 | 592 | |
c1bad961 | 593 | /* Used to register macros and assertions, perhaps from the command line. |
3d90d290 | 594 | The text is the same as the command line argument. */ |
6cf87ca4 ZW |
595 | extern void cpp_define (cpp_reader *, const char *); |
596 | extern void cpp_assert (cpp_reader *, const char *); | |
597 | extern void cpp_undef (cpp_reader *, const char *); | |
598 | extern void cpp_unassert (cpp_reader *, const char *); | |
7f2935c7 | 599 | |
d1bd0ded GK |
600 | /* Undefine all macros and assertions. */ |
601 | extern void cpp_undef_all (cpp_reader *); | |
602 | ||
6cf87ca4 | 603 | extern cpp_buffer *cpp_push_buffer (cpp_reader *, const unsigned char *, |
4dc299fb | 604 | size_t, int); |
6cf87ca4 | 605 | extern int cpp_defined (cpp_reader *, const unsigned char *, int); |
c5a04734 | 606 | |
cd7ab83f NB |
607 | /* A preprocessing number. Code assumes that any unused high bits of |
608 | the double integer are set to zero. */ | |
609 | typedef unsigned HOST_WIDE_INT cpp_num_part; | |
610 | typedef struct cpp_num cpp_num; | |
611 | struct cpp_num | |
612 | { | |
613 | cpp_num_part high; | |
614 | cpp_num_part low; | |
615 | bool unsignedp; /* True if value should be treated as unsigned. */ | |
616 | bool overflow; /* True if the most recent calculation overflowed. */ | |
617 | }; | |
618 | ||
619 | /* cpplib provides two interfaces for interpretation of preprocessing | |
620 | numbers. | |
621 | ||
622 | cpp_classify_number categorizes numeric constants according to | |
623 | their field (integer, floating point, or invalid), radix (decimal, | |
624 | octal, hexadecimal), and type suffixes. */ | |
625 | ||
626 | #define CPP_N_CATEGORY 0x000F | |
627 | #define CPP_N_INVALID 0x0000 | |
628 | #define CPP_N_INTEGER 0x0001 | |
629 | #define CPP_N_FLOATING 0x0002 | |
630 | ||
631 | #define CPP_N_WIDTH 0x00F0 | |
632 | #define CPP_N_SMALL 0x0010 /* int, float. */ | |
633 | #define CPP_N_MEDIUM 0x0020 /* long, double. */ | |
634 | #define CPP_N_LARGE 0x0040 /* long long, long double. */ | |
635 | ||
636 | #define CPP_N_RADIX 0x0F00 | |
637 | #define CPP_N_DECIMAL 0x0100 | |
638 | #define CPP_N_HEX 0x0200 | |
639 | #define CPP_N_OCTAL 0x0400 | |
640 | ||
641 | #define CPP_N_UNSIGNED 0x1000 /* Properties. */ | |
642 | #define CPP_N_IMAGINARY 0x2000 | |
643 | ||
644 | /* Classify a CPP_NUMBER token. The return value is a combination of | |
645 | the flags from the above sets. */ | |
6cf87ca4 | 646 | extern unsigned cpp_classify_number (cpp_reader *, const cpp_token *); |
cd7ab83f NB |
647 | |
648 | /* Evaluate a token classified as category CPP_N_INTEGER. */ | |
6cf87ca4 ZW |
649 | extern cpp_num cpp_interpret_integer (cpp_reader *, const cpp_token *, |
650 | unsigned int type); | |
cd7ab83f | 651 | |
ceeedfc1 NB |
652 | /* Sign extend a number, with PRECISION significant bits and all |
653 | others assumed clear, to fill out a cpp_num structure. */ | |
6cf87ca4 | 654 | cpp_num cpp_num_sign_extend (cpp_num, size_t); |
ceeedfc1 | 655 | |
95bd1dd7 | 656 | /* Diagnostic levels. To get a diagnostic without associating a |
ebef4e8c NB |
657 | position in the translation unit with it, use cpp_error_with_line |
658 | with a line number of zero. */ | |
659 | ||
660 | /* Warning, an error with -Werror. */ | |
0527bc4e JDA |
661 | #define CPP_DL_WARNING 0x00 |
662 | /* Same as CPP_DL_WARNING, except it is not suppressed in system headers. */ | |
663 | #define CPP_DL_WARNING_SYSHDR 0x01 | |
ebef4e8c | 664 | /* Warning, an error with -pedantic-errors or -Werror. */ |
0527bc4e | 665 | #define CPP_DL_PEDWARN 0x02 |
ebef4e8c | 666 | /* An error. */ |
0527bc4e | 667 | #define CPP_DL_ERROR 0x03 |
ebef4e8c | 668 | /* An internal consistency check failed. Prints "internal error: ", |
0527bc4e JDA |
669 | otherwise the same as CPP_DL_ERROR. */ |
670 | #define CPP_DL_ICE 0x04 | |
ebef4e8c | 671 | /* Extracts a diagnostic level from an int. */ |
0527bc4e | 672 | #define CPP_DL_EXTRACT(l) (l & 0xf) |
da7d8304 | 673 | /* Nonzero if a diagnostic level is one of the warnings. */ |
0527bc4e JDA |
674 | #define CPP_DL_WARNING_P(l) (CPP_DL_EXTRACT (l) >= CPP_DL_WARNING \ |
675 | && CPP_DL_EXTRACT (l) <= CPP_DL_PEDWARN) | |
ebef4e8c | 676 | |
c1212d2f ZW |
677 | /* N.B. The error-message-printer prototypes have not been nicely |
678 | formatted because exgettext needs to see 'msgid' on the same line | |
679 | as the name of the function in order to work properly. Only the | |
680 | string argument gets a name in an effort to keep the lines from | |
681 | getting ridiculously oversized. */ | |
682 | ||
ebef4e8c | 683 | /* Output a diagnostic of some kind. */ |
6cf87ca4 | 684 | extern void cpp_error (cpp_reader *, int, const char *msgid, ...) |
ebef4e8c NB |
685 | ATTRIBUTE_PRINTF_3; |
686 | ||
6cf87ca4 | 687 | /* Output a diagnostic with "MSGID: " preceding the |
ebef4e8c | 688 | error string of errno. No location is printed. */ |
6cf87ca4 | 689 | extern void cpp_errno (cpp_reader *, int, const char *msgid); |
ebef4e8c NB |
690 | |
691 | /* Same as cpp_error, except additionally specifies a position as a | |
692 | (translation unit) physical line and physical column. If the line is | |
693 | zero, then no location is printed. */ | |
dc3786d8 PB |
694 | extern void cpp_error_with_line (cpp_reader *, int, fileline, unsigned, |
695 | const char *msgid, ...) ATTRIBUTE_PRINTF_5; | |
f2d5f0cc ZW |
696 | |
697 | /* In cpplex.c */ | |
6cf87ca4 ZW |
698 | extern int cpp_ideq (const cpp_token *, const char *); |
699 | extern void cpp_output_line (cpp_reader *, FILE *); | |
700 | extern void cpp_output_token (const cpp_token *, FILE *); | |
701 | extern const char *cpp_type2name (enum cpp_ttype); | |
4268e8bb NB |
702 | /* Returns the value of an escape sequence, truncated to the correct |
703 | target precision. PSTR points to the input pointer, which is just | |
704 | after the backslash. LIMIT is how much text we have. WIDE is true | |
705 | if the escape sequence is part of a wide character constant or | |
706 | string literal. Handles all relevant diagnostics. */ | |
6cf87ca4 ZW |
707 | extern cppchar_t cpp_parse_escape (cpp_reader *, const unsigned char ** pstr, |
708 | const unsigned char *limit, int wide); | |
1368ee70 | 709 | |
f2d5f0cc | 710 | /* In cpphash.c */ |
2a967f3d NB |
711 | |
712 | /* Lookup an identifier in the hashtable. Puts the identifier in the | |
713 | table if it is not already there. */ | |
6cf87ca4 ZW |
714 | extern cpp_hashnode *cpp_lookup (cpp_reader *, const unsigned char *, |
715 | unsigned int); | |
2a967f3d | 716 | |
6cf87ca4 ZW |
717 | typedef int (*cpp_cb) (cpp_reader *, cpp_hashnode *, void *); |
718 | extern void cpp_forall_identifiers (cpp_reader *, cpp_cb, void *); | |
926c5678 | 719 | |
58fea6af | 720 | /* In cppmacro.c */ |
6cf87ca4 ZW |
721 | extern void cpp_scan_nooutput (cpp_reader *); |
722 | extern int cpp_sys_macro_p (cpp_reader *); | |
723 | extern unsigned char *cpp_quote_string (unsigned char *, const unsigned char *, | |
724 | unsigned int); | |
6de1e2a9 | 725 | |
add7091b | 726 | /* In cppfiles.c */ |
8f9b4009 | 727 | extern bool cpp_included (cpp_reader *, const char *); |
6cf87ca4 | 728 | extern void cpp_make_system_header (cpp_reader *, int, int); |
6cf87ca4 ZW |
729 | extern bool cpp_push_include (cpp_reader *, const char *); |
730 | extern void cpp_change_file (cpp_reader *, enum lc_reason, const char *); | |
b0699dad | 731 | |
17211ab5 GK |
732 | /* In cpppch.c */ |
733 | struct save_macro_data; | |
6cf87ca4 ZW |
734 | extern int cpp_save_state (cpp_reader *, FILE *); |
735 | extern int cpp_write_pch_deps (cpp_reader *, FILE *); | |
736 | extern int cpp_write_pch_state (cpp_reader *, FILE *); | |
737 | extern int cpp_valid_state (cpp_reader *, const char *, int); | |
738 | extern void cpp_prepare_state (cpp_reader *, struct save_macro_data **); | |
739 | extern int cpp_read_state (cpp_reader *, const char *, FILE *, | |
740 | struct save_macro_data *); | |
17211ab5 | 741 | |
7f2935c7 PB |
742 | #ifdef __cplusplus |
743 | } | |
744 | #endif | |
88657302 RH |
745 | |
746 | #endif /* ! GCC_CPPLIB_H */ |