Mercurial > hg > CbC > CbC_gcc
comparison libcpp/include/cpplib.h @ 0:a06113de4d67
first commit
author | kent <kent@cr.ie.u-ryukyu.ac.jp> |
---|---|
date | Fri, 17 Jul 2009 14:47:48 +0900 |
parents | |
children | 77e2b8dfacca |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:a06113de4d67 |
---|---|
1 /* Definitions for CPP library. | |
2 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, | |
3 2004, 2005, 2007, 2008, 2009 | |
4 Free Software Foundation, Inc. | |
5 Written by Per Bothner, 1994-95. | |
6 | |
7 This program is free software; you can redistribute it and/or modify it | |
8 under the terms of the GNU General Public License as published by the | |
9 Free Software Foundation; either version 3, or (at your option) any | |
10 later version. | |
11 | |
12 This program is distributed in the hope that it will be useful, | |
13 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 GNU General Public License for more details. | |
16 | |
17 You should have received a copy of the GNU General Public License | |
18 along with this program; see the file COPYING3. If not see | |
19 <http://www.gnu.org/licenses/>. | |
20 | |
21 In other words, you are welcome to use, share and improve this program. | |
22 You are forbidden to forbid anyone else to use, share and improve | |
23 what you give them. Help stamp out software-hoarding! */ | |
24 #ifndef LIBCPP_CPPLIB_H | |
25 #define LIBCPP_CPPLIB_H | |
26 | |
27 #include <sys/types.h> | |
28 #include "symtab.h" | |
29 #include "line-map.h" | |
30 | |
31 #ifdef __cplusplus | |
32 extern "C" { | |
33 #endif | |
34 | |
35 typedef struct cpp_reader cpp_reader; | |
36 typedef struct cpp_buffer cpp_buffer; | |
37 typedef struct cpp_options cpp_options; | |
38 typedef struct cpp_token cpp_token; | |
39 typedef struct cpp_string cpp_string; | |
40 typedef struct cpp_hashnode cpp_hashnode; | |
41 typedef struct cpp_macro cpp_macro; | |
42 typedef struct cpp_callbacks cpp_callbacks; | |
43 typedef struct cpp_dir cpp_dir; | |
44 | |
45 struct answer; | |
46 struct _cpp_file; | |
47 | |
48 /* The first three groups, apart from '=', can appear in preprocessor | |
49 expressions (+= and -= are used to indicate unary + and - resp.). | |
50 This allows a lookup table to be implemented in _cpp_parse_expr. | |
51 | |
52 The first group, to CPP_LAST_EQ, can be immediately followed by an | |
53 '='. The lexer needs operators ending in '=', like ">>=", to be in | |
54 the same order as their counterparts without the '=', like ">>". | |
55 | |
56 See the cpp_operator table optab in expr.c if you change the order or | |
57 add or remove anything in the first group. */ | |
58 | |
59 #define TTYPE_TABLE \ | |
60 OP(EQ, "=") \ | |
61 OP(NOT, "!") \ | |
62 OP(GREATER, ">") /* compare */ \ | |
63 OP(LESS, "<") \ | |
64 OP(PLUS, "+") /* math */ \ | |
65 OP(MINUS, "-") \ | |
66 OP(MULT, "*") \ | |
67 OP(DIV, "/") \ | |
68 OP(MOD, "%") \ | |
69 OP(AND, "&") /* bit ops */ \ | |
70 OP(OR, "|") \ | |
71 OP(XOR, "^") \ | |
72 OP(RSHIFT, ">>") \ | |
73 OP(LSHIFT, "<<") \ | |
74 \ | |
75 OP(COMPL, "~") \ | |
76 OP(AND_AND, "&&") /* logical */ \ | |
77 OP(OR_OR, "||") \ | |
78 OP(QUERY, "?") \ | |
79 OP(COLON, ":") \ | |
80 OP(COMMA, ",") /* grouping */ \ | |
81 OP(OPEN_PAREN, "(") \ | |
82 OP(CLOSE_PAREN, ")") \ | |
83 TK(EOF, NONE) \ | |
84 OP(EQ_EQ, "==") /* compare */ \ | |
85 OP(NOT_EQ, "!=") \ | |
86 OP(GREATER_EQ, ">=") \ | |
87 OP(LESS_EQ, "<=") \ | |
88 \ | |
89 /* These two are unary + / - in preprocessor expressions. */ \ | |
90 OP(PLUS_EQ, "+=") /* math */ \ | |
91 OP(MINUS_EQ, "-=") \ | |
92 \ | |
93 OP(MULT_EQ, "*=") \ | |
94 OP(DIV_EQ, "/=") \ | |
95 OP(MOD_EQ, "%=") \ | |
96 OP(AND_EQ, "&=") /* bit ops */ \ | |
97 OP(OR_EQ, "|=") \ | |
98 OP(XOR_EQ, "^=") \ | |
99 OP(RSHIFT_EQ, ">>=") \ | |
100 OP(LSHIFT_EQ, "<<=") \ | |
101 /* Digraphs together, beginning with CPP_FIRST_DIGRAPH. */ \ | |
102 OP(HASH, "#") /* digraphs */ \ | |
103 OP(PASTE, "##") \ | |
104 OP(OPEN_SQUARE, "[") \ | |
105 OP(CLOSE_SQUARE, "]") \ | |
106 OP(OPEN_BRACE, "{") \ | |
107 OP(CLOSE_BRACE, "}") \ | |
108 /* The remainder of the punctuation. Order is not significant. */ \ | |
109 OP(SEMICOLON, ";") /* structure */ \ | |
110 OP(ELLIPSIS, "...") \ | |
111 OP(PLUS_PLUS, "++") /* increment */ \ | |
112 OP(MINUS_MINUS, "--") \ | |
113 OP(DEREF, "->") /* accessors */ \ | |
114 OP(DOT, ".") \ | |
115 OP(SCOPE, "::") \ | |
116 OP(DEREF_STAR, "->*") \ | |
117 OP(DOT_STAR, ".*") \ | |
118 OP(ATSIGN, "@") /* used in Objective-C */ \ | |
119 \ | |
120 TK(NAME, IDENT) /* word */ \ | |
121 TK(AT_NAME, IDENT) /* @word - Objective-C */ \ | |
122 TK(NUMBER, LITERAL) /* 34_be+ta */ \ | |
123 \ | |
124 TK(CHAR, LITERAL) /* 'char' */ \ | |
125 TK(WCHAR, LITERAL) /* L'char' */ \ | |
126 TK(CHAR16, LITERAL) /* u'char' */ \ | |
127 TK(CHAR32, LITERAL) /* U'char' */ \ | |
128 TK(OTHER, LITERAL) /* stray punctuation */ \ | |
129 \ | |
130 TK(STRING, LITERAL) /* "string" */ \ | |
131 TK(WSTRING, LITERAL) /* L"string" */ \ | |
132 TK(STRING16, LITERAL) /* u"string" */ \ | |
133 TK(STRING32, LITERAL) /* U"string" */ \ | |
134 TK(OBJC_STRING, LITERAL) /* @"string" - Objective-C */ \ | |
135 TK(HEADER_NAME, LITERAL) /* <stdio.h> in #include */ \ | |
136 \ | |
137 TK(COMMENT, LITERAL) /* Only if output comments. */ \ | |
138 /* SPELL_LITERAL happens to DTRT. */ \ | |
139 TK(MACRO_ARG, NONE) /* Macro argument. */ \ | |
140 TK(PRAGMA, NONE) /* Only for deferred pragmas. */ \ | |
141 TK(PRAGMA_EOL, NONE) /* End-of-line for deferred pragmas. */ \ | |
142 TK(PADDING, NONE) /* Whitespace for -E. */ | |
143 | |
144 #define OP(e, s) CPP_ ## e, | |
145 #define TK(e, s) CPP_ ## e, | |
146 enum cpp_ttype | |
147 { | |
148 TTYPE_TABLE | |
149 N_TTYPES, | |
150 | |
151 /* Positions in the table. */ | |
152 CPP_LAST_EQ = CPP_LSHIFT, | |
153 CPP_FIRST_DIGRAPH = CPP_HASH, | |
154 CPP_LAST_PUNCTUATOR= CPP_ATSIGN, | |
155 CPP_LAST_CPP_OP = CPP_LESS_EQ | |
156 }; | |
157 #undef OP | |
158 #undef TK | |
159 | |
160 /* C language kind, used when calling cpp_create_reader. */ | |
161 enum c_lang {CLK_GNUC89 = 0, CLK_GNUC99, CLK_STDC89, CLK_STDC94, CLK_STDC99, | |
162 CLK_GNUCXX, CLK_CXX98, CLK_GNUCXX0X, CLK_CXX0X, CLK_ASM}; | |
163 | |
164 /* Payload of a NUMBER, STRING, CHAR or COMMENT token. */ | |
165 struct cpp_string GTY(()) | |
166 { | |
167 unsigned int len; | |
168 const unsigned char *text; | |
169 }; | |
170 | |
171 /* Flags for the cpp_token structure. */ | |
172 #define PREV_WHITE (1 << 0) /* If whitespace before this token. */ | |
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. */ | |
176 #define NAMED_OP (1 << 4) /* C++ named operators. */ | |
177 #define NO_EXPAND (1 << 5) /* Do not macro-expand this token. */ | |
178 #define BOL (1 << 6) /* Token at beginning of line. */ | |
179 #define PURE_ZERO (1 << 7) /* Single 0 digit, used by the C++ frontend, | |
180 set in c-lex.c. */ | |
181 | |
182 /* Specify which field, if any, of the cpp_token union is used. */ | |
183 | |
184 enum cpp_token_fld_kind { | |
185 CPP_TOKEN_FLD_NODE, | |
186 CPP_TOKEN_FLD_SOURCE, | |
187 CPP_TOKEN_FLD_STR, | |
188 CPP_TOKEN_FLD_ARG_NO, | |
189 CPP_TOKEN_FLD_PRAGMA, | |
190 CPP_TOKEN_FLD_NONE | |
191 }; | |
192 | |
193 /* A preprocessing token. This has been carefully packed and should | |
194 occupy 16 bytes on 32-bit hosts and 24 bytes on 64-bit hosts. */ | |
195 struct cpp_token GTY(()) | |
196 { | |
197 source_location src_loc; /* Location of first char of token. */ | |
198 ENUM_BITFIELD(cpp_ttype) type : CHAR_BIT; /* token type */ | |
199 unsigned char flags; /* flags - see above */ | |
200 | |
201 union cpp_token_u | |
202 { | |
203 /* An identifier. */ | |
204 cpp_hashnode * | |
205 GTY ((nested_ptr (union tree_node, | |
206 "%h ? CPP_HASHNODE (GCC_IDENT_TO_HT_IDENT (%h)) : NULL", | |
207 "%h ? HT_IDENT_TO_GCC_IDENT (HT_NODE (%h)) : NULL"), | |
208 tag ("CPP_TOKEN_FLD_NODE"))) | |
209 node; | |
210 | |
211 /* Inherit padding from this token. */ | |
212 cpp_token * GTY ((tag ("CPP_TOKEN_FLD_SOURCE"))) source; | |
213 | |
214 /* A string, or number. */ | |
215 struct cpp_string GTY ((tag ("CPP_TOKEN_FLD_STR"))) str; | |
216 | |
217 /* Argument no. for a CPP_MACRO_ARG. */ | |
218 unsigned int GTY ((tag ("CPP_TOKEN_FLD_ARG_NO"))) arg_no; | |
219 | |
220 /* Caller-supplied identifier for a CPP_PRAGMA. */ | |
221 unsigned int GTY ((tag ("CPP_TOKEN_FLD_PRAGMA"))) pragma; | |
222 } GTY ((desc ("cpp_token_val_index (&%1)"))) val; | |
223 }; | |
224 | |
225 /* Say which field is in use. */ | |
226 extern enum cpp_token_fld_kind cpp_token_val_index (cpp_token *tok); | |
227 | |
228 /* A type wide enough to hold any multibyte source character. | |
229 cpplib's character constant interpreter requires an unsigned type. | |
230 Also, a typedef for the signed equivalent. | |
231 The width of this type is capped at 32 bits; there do exist targets | |
232 where wchar_t is 64 bits, but only in a non-default mode, and there | |
233 would be no meaningful interpretation for a wchar_t value greater | |
234 than 2^32 anyway -- the widest wide-character encoding around is | |
235 ISO 10646, which stops at 2^31. */ | |
236 #if CHAR_BIT * SIZEOF_INT >= 32 | |
237 # define CPPCHAR_SIGNED_T int | |
238 #elif CHAR_BIT * SIZEOF_LONG >= 32 | |
239 # define CPPCHAR_SIGNED_T long | |
240 #else | |
241 # error "Cannot find a least-32-bit signed integer type" | |
242 #endif | |
243 typedef unsigned CPPCHAR_SIGNED_T cppchar_t; | |
244 typedef CPPCHAR_SIGNED_T cppchar_signed_t; | |
245 | |
246 /* Style of header dependencies to generate. */ | |
247 enum cpp_deps_style { DEPS_NONE = 0, DEPS_USER, DEPS_SYSTEM }; | |
248 | |
249 /* The possible normalization levels, from most restrictive to least. */ | |
250 enum cpp_normalize_level { | |
251 /* In NFKC. */ | |
252 normalized_KC = 0, | |
253 /* In NFC. */ | |
254 normalized_C, | |
255 /* In NFC, except for subsequences where being in NFC would make | |
256 the identifier invalid. */ | |
257 normalized_identifier_C, | |
258 /* Not normalized at all. */ | |
259 normalized_none | |
260 }; | |
261 | |
262 /* This structure is nested inside struct cpp_reader, and | |
263 carries all the options visible to the command line. */ | |
264 struct cpp_options | |
265 { | |
266 /* Characters between tab stops. */ | |
267 unsigned int tabstop; | |
268 | |
269 /* The language we're preprocessing. */ | |
270 enum c_lang lang; | |
271 | |
272 /* Nonzero means use extra default include directories for C++. */ | |
273 unsigned char cplusplus; | |
274 | |
275 /* Nonzero means handle cplusplus style comments. */ | |
276 unsigned char cplusplus_comments; | |
277 | |
278 /* Nonzero means define __OBJC__, treat @ as a special token, use | |
279 the OBJC[PLUS]_INCLUDE_PATH environment variable, and allow | |
280 "#import". */ | |
281 unsigned char objc; | |
282 | |
283 /* Nonzero means don't copy comments into the output file. */ | |
284 unsigned char discard_comments; | |
285 | |
286 /* Nonzero means don't copy comments into the output file during | |
287 macro expansion. */ | |
288 unsigned char discard_comments_in_macro_exp; | |
289 | |
290 /* Nonzero means process the ISO trigraph sequences. */ | |
291 unsigned char trigraphs; | |
292 | |
293 /* Nonzero means process the ISO digraph sequences. */ | |
294 unsigned char digraphs; | |
295 | |
296 /* Nonzero means to allow hexadecimal floats and LL suffixes. */ | |
297 unsigned char extended_numbers; | |
298 | |
299 /* Nonzero means process u/U prefix literals (UTF-16/32). */ | |
300 unsigned char uliterals; | |
301 | |
302 /* Nonzero means print names of header files (-H). */ | |
303 unsigned char print_include_names; | |
304 | |
305 /* Nonzero means cpp_pedwarn causes a hard error. */ | |
306 unsigned char pedantic_errors; | |
307 | |
308 /* Nonzero means don't print warning messages. */ | |
309 unsigned char inhibit_warnings; | |
310 | |
311 /* Nonzero means complain about deprecated features. */ | |
312 unsigned char warn_deprecated; | |
313 | |
314 /* Nonzero means don't suppress warnings from system headers. */ | |
315 unsigned char warn_system_headers; | |
316 | |
317 /* Nonzero means don't print error messages. Has no option to | |
318 select it, but can be set by a user of cpplib (e.g. fix-header). */ | |
319 unsigned char inhibit_errors; | |
320 | |
321 /* Nonzero means warn if slash-star appears in a comment. */ | |
322 unsigned char warn_comments; | |
323 | |
324 /* Nonzero means warn if a user-supplied include directory does not | |
325 exist. */ | |
326 unsigned char warn_missing_include_dirs; | |
327 | |
328 /* Nonzero means warn if there are any trigraphs. */ | |
329 unsigned char warn_trigraphs; | |
330 | |
331 /* Nonzero means warn about multicharacter charconsts. */ | |
332 unsigned char warn_multichar; | |
333 | |
334 /* Nonzero means warn about various incompatibilities with | |
335 traditional C. */ | |
336 unsigned char warn_traditional; | |
337 | |
338 /* Nonzero means warn about long long numeric constants. */ | |
339 unsigned char warn_long_long; | |
340 | |
341 /* Nonzero means warn about text after an #endif (or #else). */ | |
342 unsigned char warn_endif_labels; | |
343 | |
344 /* Nonzero means warn about implicit sign changes owing to integer | |
345 promotions. */ | |
346 unsigned char warn_num_sign_change; | |
347 | |
348 /* Zero means don't warn about __VA_ARGS__ usage in c89 pedantic mode. | |
349 Presumably the usage is protected by the appropriate #ifdef. */ | |
350 unsigned char warn_variadic_macros; | |
351 | |
352 /* Nonzero means warn about builtin macros that are redefined or | |
353 explicitly undefined. */ | |
354 unsigned char warn_builtin_macro_redefined; | |
355 | |
356 /* Nonzero means turn warnings into errors. */ | |
357 unsigned char warnings_are_errors; | |
358 | |
359 /* Nonzero means we should look for header.gcc files that remap file | |
360 names. */ | |
361 unsigned char remap; | |
362 | |
363 /* Zero means dollar signs are punctuation. */ | |
364 unsigned char dollars_in_ident; | |
365 | |
366 /* Nonzero means UCNs are accepted in identifiers. */ | |
367 unsigned char extended_identifiers; | |
368 | |
369 /* True if we should warn about dollars in identifiers or numbers | |
370 for this translation unit. */ | |
371 unsigned char warn_dollars; | |
372 | |
373 /* Nonzero means warn if undefined identifiers are evaluated in an #if. */ | |
374 unsigned char warn_undef; | |
375 | |
376 /* Nonzero means warn of unused macros from the main file. */ | |
377 unsigned char warn_unused_macros; | |
378 | |
379 /* Nonzero for the 1999 C Standard, including corrigenda and amendments. */ | |
380 unsigned char c99; | |
381 | |
382 /* Nonzero if we are conforming to a specific C or C++ standard. */ | |
383 unsigned char std; | |
384 | |
385 /* Nonzero means give all the error messages the ANSI standard requires. */ | |
386 unsigned char pedantic; | |
387 | |
388 /* Nonzero means we're looking at already preprocessed code, so don't | |
389 bother trying to do macro expansion and whatnot. */ | |
390 unsigned char preprocessed; | |
391 | |
392 /* Print column number in error messages. */ | |
393 unsigned char show_column; | |
394 | |
395 /* Nonzero means handle C++ alternate operator names. */ | |
396 unsigned char operator_names; | |
397 | |
398 /* True for traditional preprocessing. */ | |
399 unsigned char traditional; | |
400 | |
401 /* Holds the name of the target (execution) character set. */ | |
402 const char *narrow_charset; | |
403 | |
404 /* Holds the name of the target wide character set. */ | |
405 const char *wide_charset; | |
406 | |
407 /* Holds the name of the input character set. */ | |
408 const char *input_charset; | |
409 | |
410 /* The minimum permitted level of normalization before a warning | |
411 is generated. */ | |
412 enum cpp_normalize_level warn_normalize; | |
413 | |
414 /* True to warn about precompiled header files we couldn't use. */ | |
415 bool warn_invalid_pch; | |
416 | |
417 /* True if dependencies should be restored from a precompiled header. */ | |
418 bool restore_pch_deps; | |
419 | |
420 /* Dependency generation. */ | |
421 struct | |
422 { | |
423 /* Style of header dependencies to generate. */ | |
424 enum cpp_deps_style style; | |
425 | |
426 /* Assume missing files are generated files. */ | |
427 bool missing_files; | |
428 | |
429 /* Generate phony targets for each dependency apart from the first | |
430 one. */ | |
431 bool phony_targets; | |
432 | |
433 /* If true, no dependency is generated on the main file. */ | |
434 bool ignore_main_file; | |
435 } deps; | |
436 | |
437 /* Target-specific features set by the front end or client. */ | |
438 | |
439 /* Precision for target CPP arithmetic, target characters, target | |
440 ints and target wide characters, respectively. */ | |
441 size_t precision, char_precision, int_precision, wchar_precision; | |
442 | |
443 /* True means chars (wide chars) are unsigned. */ | |
444 bool unsigned_char, unsigned_wchar; | |
445 | |
446 /* True if the most significant byte in a word has the lowest | |
447 address in memory. */ | |
448 bool bytes_big_endian; | |
449 | |
450 /* Nonzero means __STDC__ should have the value 0 in system headers. */ | |
451 unsigned char stdc_0_in_system_headers; | |
452 | |
453 /* True means error callback should be used for diagnostics. */ | |
454 bool client_diagnostic; | |
455 | |
456 /* True disables tokenization outside of preprocessing directives. */ | |
457 bool directives_only; | |
458 }; | |
459 | |
460 /* Callback for header lookup for HEADER, which is the name of a | |
461 source file. It is used as a method of last resort to find headers | |
462 that are not otherwise found during the normal include processing. | |
463 The return value is the malloced name of a header to try and open, | |
464 if any, or NULL otherwise. This callback is called only if the | |
465 header is otherwise unfound. */ | |
466 typedef const char *(*missing_header_cb)(cpp_reader *, const char *header, cpp_dir **); | |
467 | |
468 /* Call backs to cpplib client. */ | |
469 struct cpp_callbacks | |
470 { | |
471 /* Called when a new line of preprocessed output is started. */ | |
472 void (*line_change) (cpp_reader *, const cpp_token *, int); | |
473 | |
474 /* Called when switching to/from a new file. | |
475 The line_map is for the new file. It is NULL if there is no new file. | |
476 (In C this happens when done with <built-in>+<command line> and also | |
477 when done with a main file.) This can be used for resource cleanup. */ | |
478 void (*file_change) (cpp_reader *, const struct line_map *); | |
479 | |
480 void (*dir_change) (cpp_reader *, const char *); | |
481 void (*include) (cpp_reader *, unsigned int, const unsigned char *, | |
482 const char *, int, const cpp_token **); | |
483 void (*define) (cpp_reader *, unsigned int, cpp_hashnode *); | |
484 void (*undef) (cpp_reader *, unsigned int, cpp_hashnode *); | |
485 void (*ident) (cpp_reader *, unsigned int, const cpp_string *); | |
486 void (*def_pragma) (cpp_reader *, unsigned int); | |
487 int (*valid_pch) (cpp_reader *, const char *, int); | |
488 void (*read_pch) (cpp_reader *, const char *, int, const char *); | |
489 missing_header_cb missing_header; | |
490 | |
491 /* Context-sensitive macro support. Returns macro (if any) that should | |
492 be expanded. */ | |
493 cpp_hashnode * (*macro_to_expand) (cpp_reader *, const cpp_token *); | |
494 | |
495 /* Called to emit a diagnostic if client_diagnostic option is true. | |
496 This callback receives the translated message. */ | |
497 void (*error) (cpp_reader *, int, const char *, va_list *) | |
498 ATTRIBUTE_FPTR_PRINTF(3,0); | |
499 | |
500 /* Callbacks for when a macro is expanded, or tested (whether | |
501 defined or not at the time) in #ifdef, #ifndef or "defined". */ | |
502 void (*used_define) (cpp_reader *, unsigned int, cpp_hashnode *); | |
503 void (*used_undef) (cpp_reader *, unsigned int, cpp_hashnode *); | |
504 /* Called before #define and #undef or other macro definition | |
505 changes are processed. */ | |
506 void (*before_define) (cpp_reader *); | |
507 }; | |
508 | |
509 /* Chain of directories to look for include files in. */ | |
510 struct cpp_dir | |
511 { | |
512 /* NULL-terminated singly-linked list. */ | |
513 struct cpp_dir *next; | |
514 | |
515 /* NAME of the directory, NUL-terminated. */ | |
516 char *name; | |
517 unsigned int len; | |
518 | |
519 /* One if a system header, two if a system header that has extern | |
520 "C" guards for C++. */ | |
521 unsigned char sysp; | |
522 | |
523 /* Is this a user-supplied directory? */ | |
524 bool user_supplied_p; | |
525 | |
526 /* The canonicalized NAME as determined by lrealpath. This field | |
527 is only used by hosts that lack reliable inode numbers. */ | |
528 char *canonical_name; | |
529 | |
530 /* Mapping of file names for this directory for MS-DOS and related | |
531 platforms. A NULL-terminated array of (from, to) pairs. */ | |
532 const char **name_map; | |
533 | |
534 /* Routine to construct pathname, given the search path name and the | |
535 HEADER we are trying to find, return a constructed pathname to | |
536 try and open. If this is NULL, the constructed pathname is as | |
537 constructed by append_file_to_dir. */ | |
538 char *(*construct) (const char *header, cpp_dir *dir); | |
539 | |
540 /* The C front end uses these to recognize duplicated | |
541 directories in the search path. */ | |
542 ino_t ino; | |
543 dev_t dev; | |
544 }; | |
545 | |
546 /* Name under which this program was invoked. */ | |
547 extern const char *progname; | |
548 | |
549 /* The structure of a node in the hash table. The hash table has | |
550 entries for all identifiers: either macros defined by #define | |
551 commands (type NT_MACRO), assertions created with #assert | |
552 (NT_ASSERTION), or neither of the above (NT_VOID). Builtin macros | |
553 like __LINE__ are flagged NODE_BUILTIN. Poisoned identifiers are | |
554 flagged NODE_POISONED. NODE_OPERATOR (C++ only) indicates an | |
555 identifier that behaves like an operator such as "xor". | |
556 NODE_DIAGNOSTIC is for speed in lex_token: it indicates a | |
557 diagnostic may be required for this node. Currently this only | |
558 applies to __VA_ARGS__ and poisoned identifiers. */ | |
559 | |
560 /* Hash node flags. */ | |
561 #define NODE_OPERATOR (1 << 0) /* C++ named operator. */ | |
562 #define NODE_POISONED (1 << 1) /* Poisoned identifier. */ | |
563 #define NODE_BUILTIN (1 << 2) /* Builtin macro. */ | |
564 #define NODE_DIAGNOSTIC (1 << 3) /* Possible diagnostic when lexed. */ | |
565 #define NODE_WARN (1 << 4) /* Warn if redefined or undefined. */ | |
566 #define NODE_DISABLED (1 << 5) /* A disabled macro. */ | |
567 #define NODE_MACRO_ARG (1 << 6) /* Used during #define processing. */ | |
568 #define NODE_USED (1 << 7) /* Dumped with -dU. */ | |
569 #define NODE_CONDITIONAL (1 << 8) /* Conditional macro */ | |
570 | |
571 /* Different flavors of hash node. */ | |
572 enum node_type | |
573 { | |
574 NT_VOID = 0, /* No definition yet. */ | |
575 NT_MACRO, /* A macro of some form. */ | |
576 NT_ASSERTION /* Predicate for #assert. */ | |
577 }; | |
578 | |
579 /* Different flavors of builtin macro. _Pragma is an operator, but we | |
580 handle it with the builtin code for efficiency reasons. */ | |
581 enum builtin_type | |
582 { | |
583 BT_SPECLINE = 0, /* `__LINE__' */ | |
584 BT_DATE, /* `__DATE__' */ | |
585 BT_FILE, /* `__FILE__' */ | |
586 BT_BASE_FILE, /* `__BASE_FILE__' */ | |
587 BT_INCLUDE_LEVEL, /* `__INCLUDE_LEVEL__' */ | |
588 BT_TIME, /* `__TIME__' */ | |
589 BT_STDC, /* `__STDC__' */ | |
590 BT_PRAGMA, /* `_Pragma' operator */ | |
591 BT_TIMESTAMP, /* `__TIMESTAMP__' */ | |
592 BT_COUNTER /* `__COUNTER__' */ | |
593 }; | |
594 | |
595 #define CPP_HASHNODE(HNODE) ((cpp_hashnode *) (HNODE)) | |
596 #define HT_NODE(NODE) ((ht_identifier *) (NODE)) | |
597 #define NODE_LEN(NODE) HT_LEN (&(NODE)->ident) | |
598 #define NODE_NAME(NODE) HT_STR (&(NODE)->ident) | |
599 | |
600 /* Specify which field, if any, of the union is used. */ | |
601 | |
602 enum { | |
603 NTV_MACRO, | |
604 NTV_ANSWER, | |
605 NTV_BUILTIN, | |
606 NTV_ARGUMENT, | |
607 NTV_NONE | |
608 }; | |
609 | |
610 #define CPP_HASHNODE_VALUE_IDX(HNODE) \ | |
611 ((HNODE.flags & NODE_MACRO_ARG) ? NTV_ARGUMENT \ | |
612 : HNODE.type == NT_MACRO ? ((HNODE.flags & NODE_BUILTIN) \ | |
613 ? NTV_BUILTIN : NTV_MACRO) \ | |
614 : HNODE.type == NT_ASSERTION ? NTV_ANSWER \ | |
615 : NTV_NONE) | |
616 | |
617 /* The common part of an identifier node shared amongst all 3 C front | |
618 ends. Also used to store CPP identifiers, which are a superset of | |
619 identifiers in the grammatical sense. */ | |
620 | |
621 union _cpp_hashnode_value GTY(()) | |
622 { | |
623 /* If a macro. */ | |
624 cpp_macro * GTY((tag ("NTV_MACRO"))) macro; | |
625 /* Answers to an assertion. */ | |
626 struct answer * GTY ((tag ("NTV_ANSWER"))) answers; | |
627 /* Code for a builtin macro. */ | |
628 enum builtin_type GTY ((tag ("NTV_BUILTIN"))) builtin; | |
629 /* Macro argument index. */ | |
630 unsigned short GTY ((tag ("NTV_ARGUMENT"))) arg_index; | |
631 }; | |
632 | |
633 struct cpp_hashnode GTY(()) | |
634 { | |
635 struct ht_identifier ident; | |
636 unsigned int is_directive : 1; | |
637 unsigned int directive_index : 7; /* If is_directive, | |
638 then index into directive table. | |
639 Otherwise, a NODE_OPERATOR. */ | |
640 unsigned char rid_code; /* Rid code - for front ends. */ | |
641 ENUM_BITFIELD(node_type) type : 7; /* CPP node type. */ | |
642 unsigned int flags : 9; /* CPP flags. */ | |
643 | |
644 union _cpp_hashnode_value GTY ((desc ("CPP_HASHNODE_VALUE_IDX (%1)"))) value; | |
645 }; | |
646 | |
647 /* Call this first to get a handle to pass to other functions. | |
648 | |
649 If you want cpplib to manage its own hashtable, pass in a NULL | |
650 pointer. Otherwise you should pass in an initialized hash table | |
651 that cpplib will share; this technique is used by the C front | |
652 ends. */ | |
653 extern cpp_reader *cpp_create_reader (enum c_lang, struct ht *, | |
654 struct line_maps *); | |
655 | |
656 /* Reset the cpp_reader's line_map. This is only used after reading a | |
657 PCH file. */ | |
658 extern void cpp_set_line_map (cpp_reader *, struct line_maps *); | |
659 | |
660 /* Call this to change the selected language standard (e.g. because of | |
661 command line options). */ | |
662 extern void cpp_set_lang (cpp_reader *, enum c_lang); | |
663 | |
664 /* Set the include paths. */ | |
665 extern void cpp_set_include_chains (cpp_reader *, cpp_dir *, cpp_dir *, int); | |
666 | |
667 /* Call these to get pointers to the options, callback, and deps | |
668 structures for a given reader. These pointers are good until you | |
669 call cpp_finish on that reader. You can either edit the callbacks | |
670 through the pointer returned from cpp_get_callbacks, or set them | |
671 with cpp_set_callbacks. */ | |
672 extern cpp_options *cpp_get_options (cpp_reader *); | |
673 extern cpp_callbacks *cpp_get_callbacks (cpp_reader *); | |
674 extern void cpp_set_callbacks (cpp_reader *, cpp_callbacks *); | |
675 extern struct deps *cpp_get_deps (cpp_reader *); | |
676 | |
677 /* This function reads the file, but does not start preprocessing. It | |
678 returns the name of the original file; this is the same as the | |
679 input file, except for preprocessed input. This will generate at | |
680 least one file change callback, and possibly a line change callback | |
681 too. If there was an error opening the file, it returns NULL. */ | |
682 extern const char *cpp_read_main_file (cpp_reader *, const char *); | |
683 | |
684 /* Set up built-ins with special behavior. Use cpp_init_builtins() | |
685 instead unless your know what you are doing. */ | |
686 extern void cpp_init_special_builtins (cpp_reader *); | |
687 | |
688 /* Set up built-ins like __FILE__. */ | |
689 extern void cpp_init_builtins (cpp_reader *, int); | |
690 | |
691 /* This is called after options have been parsed, and partially | |
692 processed. */ | |
693 extern void cpp_post_options (cpp_reader *); | |
694 | |
695 /* Set up translation to the target character set. */ | |
696 extern void cpp_init_iconv (cpp_reader *); | |
697 | |
698 /* Call this to finish preprocessing. If you requested dependency | |
699 generation, pass an open stream to write the information to, | |
700 otherwise NULL. It is your responsibility to close the stream. | |
701 | |
702 Returns cpp_errors (pfile). */ | |
703 extern int cpp_finish (cpp_reader *, FILE *deps_stream); | |
704 | |
705 /* Call this to release the handle at the end of preprocessing. Any | |
706 use of the handle after this function returns is invalid. Returns | |
707 cpp_errors (pfile). */ | |
708 extern void cpp_destroy (cpp_reader *); | |
709 | |
710 /* Error count. */ | |
711 extern unsigned int cpp_errors (cpp_reader *); | |
712 | |
713 extern unsigned int cpp_token_len (const cpp_token *); | |
714 extern unsigned char *cpp_token_as_text (cpp_reader *, const cpp_token *); | |
715 extern unsigned char *cpp_spell_token (cpp_reader *, const cpp_token *, | |
716 unsigned char *, bool); | |
717 extern void cpp_register_pragma (cpp_reader *, const char *, const char *, | |
718 void (*) (cpp_reader *), bool); | |
719 extern void cpp_register_deferred_pragma (cpp_reader *, const char *, | |
720 const char *, unsigned, bool, bool); | |
721 extern int cpp_avoid_paste (cpp_reader *, const cpp_token *, | |
722 const cpp_token *); | |
723 extern const cpp_token *cpp_get_token (cpp_reader *); | |
724 extern const cpp_token *cpp_get_token_with_location (cpp_reader *, | |
725 source_location *); | |
726 extern const unsigned char *cpp_macro_definition (cpp_reader *, | |
727 const cpp_hashnode *); | |
728 extern void _cpp_backup_tokens (cpp_reader *, unsigned int); | |
729 extern const cpp_token *cpp_peek_token (cpp_reader *, int); | |
730 | |
731 /* Evaluate a CPP_CHAR or CPP_WCHAR token. */ | |
732 extern cppchar_t cpp_interpret_charconst (cpp_reader *, const cpp_token *, | |
733 unsigned int *, int *); | |
734 /* Evaluate a vector of CPP_STRING or CPP_WSTRING tokens. */ | |
735 extern bool cpp_interpret_string (cpp_reader *, | |
736 const cpp_string *, size_t, | |
737 cpp_string *, enum cpp_ttype); | |
738 extern bool cpp_interpret_string_notranslate (cpp_reader *, | |
739 const cpp_string *, size_t, | |
740 cpp_string *, enum cpp_ttype); | |
741 | |
742 /* Convert a host character constant to the execution character set. */ | |
743 extern cppchar_t cpp_host_to_exec_charset (cpp_reader *, cppchar_t); | |
744 | |
745 /* Used to register macros and assertions, perhaps from the command line. | |
746 The text is the same as the command line argument. */ | |
747 extern void cpp_define (cpp_reader *, const char *); | |
748 extern void cpp_define_formatted (cpp_reader *pfile, | |
749 const char *fmt, ...) ATTRIBUTE_PRINTF_2; | |
750 extern void cpp_assert (cpp_reader *, const char *); | |
751 extern void cpp_undef (cpp_reader *, const char *); | |
752 extern void cpp_unassert (cpp_reader *, const char *); | |
753 | |
754 extern cpp_macro *cpp_push_definition (cpp_reader *, const char *); | |
755 extern void cpp_pop_definition (cpp_reader *, const char *, cpp_macro *); | |
756 | |
757 /* Undefine all macros and assertions. */ | |
758 extern void cpp_undef_all (cpp_reader *); | |
759 | |
760 extern cpp_buffer *cpp_push_buffer (cpp_reader *, const unsigned char *, | |
761 size_t, int); | |
762 extern int cpp_defined (cpp_reader *, const unsigned char *, int); | |
763 | |
764 /* A preprocessing number. Code assumes that any unused high bits of | |
765 the double integer are set to zero. */ | |
766 typedef unsigned HOST_WIDE_INT cpp_num_part; | |
767 typedef struct cpp_num cpp_num; | |
768 struct cpp_num | |
769 { | |
770 cpp_num_part high; | |
771 cpp_num_part low; | |
772 bool unsignedp; /* True if value should be treated as unsigned. */ | |
773 bool overflow; /* True if the most recent calculation overflowed. */ | |
774 }; | |
775 | |
776 /* cpplib provides two interfaces for interpretation of preprocessing | |
777 numbers. | |
778 | |
779 cpp_classify_number categorizes numeric constants according to | |
780 their field (integer, floating point, or invalid), radix (decimal, | |
781 octal, hexadecimal), and type suffixes. */ | |
782 | |
783 #define CPP_N_CATEGORY 0x000F | |
784 #define CPP_N_INVALID 0x0000 | |
785 #define CPP_N_INTEGER 0x0001 | |
786 #define CPP_N_FLOATING 0x0002 | |
787 | |
788 #define CPP_N_WIDTH 0x00F0 | |
789 #define CPP_N_SMALL 0x0010 /* int, float, shrot _Fract/Accum */ | |
790 #define CPP_N_MEDIUM 0x0020 /* long, double, long _Fract/_Accum. */ | |
791 #define CPP_N_LARGE 0x0040 /* long long, long double, | |
792 long long _Fract/Accum. */ | |
793 | |
794 #define CPP_N_WIDTH_MD 0xF0000 /* machine defined. */ | |
795 #define CPP_N_MD_W 0x10000 | |
796 #define CPP_N_MD_Q 0x20000 | |
797 | |
798 #define CPP_N_RADIX 0x0F00 | |
799 #define CPP_N_DECIMAL 0x0100 | |
800 #define CPP_N_HEX 0x0200 | |
801 #define CPP_N_OCTAL 0x0400 | |
802 #define CPP_N_BINARY 0x0800 | |
803 | |
804 #define CPP_N_UNSIGNED 0x1000 /* Properties. */ | |
805 #define CPP_N_IMAGINARY 0x2000 | |
806 #define CPP_N_DFLOAT 0x4000 | |
807 | |
808 #define CPP_N_FRACT 0x100000 /* Fract types. */ | |
809 #define CPP_N_ACCUM 0x200000 /* Accum types. */ | |
810 | |
811 /* Classify a CPP_NUMBER token. The return value is a combination of | |
812 the flags from the above sets. */ | |
813 extern unsigned cpp_classify_number (cpp_reader *, const cpp_token *); | |
814 | |
815 /* Evaluate a token classified as category CPP_N_INTEGER. */ | |
816 extern cpp_num cpp_interpret_integer (cpp_reader *, const cpp_token *, | |
817 unsigned int type); | |
818 | |
819 /* Sign extend a number, with PRECISION significant bits and all | |
820 others assumed clear, to fill out a cpp_num structure. */ | |
821 cpp_num cpp_num_sign_extend (cpp_num, size_t); | |
822 | |
823 /* Diagnostic levels. To get a diagnostic without associating a | |
824 position in the translation unit with it, use cpp_error_with_line | |
825 with a line number of zero. */ | |
826 | |
827 /* Warning, an error with -Werror. */ | |
828 #define CPP_DL_WARNING 0x00 | |
829 /* Same as CPP_DL_WARNING, except it is not suppressed in system headers. */ | |
830 #define CPP_DL_WARNING_SYSHDR 0x01 | |
831 /* Warning, an error with -pedantic-errors or -Werror. */ | |
832 #define CPP_DL_PEDWARN 0x02 | |
833 /* An error. */ | |
834 #define CPP_DL_ERROR 0x03 | |
835 /* An internal consistency check failed. Prints "internal error: ", | |
836 otherwise the same as CPP_DL_ERROR. */ | |
837 #define CPP_DL_ICE 0x04 | |
838 /* Extracts a diagnostic level from an int. */ | |
839 #define CPP_DL_EXTRACT(l) (l & 0xf) | |
840 /* Nonzero if a diagnostic level is one of the warnings. */ | |
841 #define CPP_DL_WARNING_P(l) (CPP_DL_EXTRACT (l) >= CPP_DL_WARNING \ | |
842 && CPP_DL_EXTRACT (l) <= CPP_DL_PEDWARN) | |
843 | |
844 /* Output a diagnostic of some kind. */ | |
845 extern void cpp_error (cpp_reader *, int, const char *msgid, ...) | |
846 ATTRIBUTE_PRINTF_3; | |
847 | |
848 /* Output a diagnostic with "MSGID: " preceding the | |
849 error string of errno. No location is printed. */ | |
850 extern void cpp_errno (cpp_reader *, int, const char *msgid); | |
851 | |
852 /* Same as cpp_error, except additionally specifies a position as a | |
853 (translation unit) physical line and physical column. If the line is | |
854 zero, then no location is printed. */ | |
855 extern void cpp_error_with_line (cpp_reader *, int, source_location, unsigned, | |
856 const char *msgid, ...) ATTRIBUTE_PRINTF_5; | |
857 | |
858 /* In lex.c */ | |
859 extern int cpp_ideq (const cpp_token *, const char *); | |
860 extern void cpp_output_line (cpp_reader *, FILE *); | |
861 extern unsigned char *cpp_output_line_to_string (cpp_reader *, | |
862 const unsigned char *); | |
863 extern void cpp_output_token (const cpp_token *, FILE *); | |
864 extern const char *cpp_type2name (enum cpp_ttype); | |
865 /* Returns the value of an escape sequence, truncated to the correct | |
866 target precision. PSTR points to the input pointer, which is just | |
867 after the backslash. LIMIT is how much text we have. WIDE is true | |
868 if the escape sequence is part of a wide character constant or | |
869 string literal. Handles all relevant diagnostics. */ | |
870 extern cppchar_t cpp_parse_escape (cpp_reader *, const unsigned char ** pstr, | |
871 const unsigned char *limit, int wide); | |
872 | |
873 /* Structure used to hold a comment block at a given location in the | |
874 source code. */ | |
875 | |
876 typedef struct | |
877 { | |
878 /* Text of the comment including the terminators. */ | |
879 char *comment; | |
880 | |
881 /* source location for the given comment. */ | |
882 source_location sloc; | |
883 } cpp_comment; | |
884 | |
885 /* Structure holding all comments for a given cpp_reader. */ | |
886 | |
887 typedef struct | |
888 { | |
889 /* table of comment entries. */ | |
890 cpp_comment *entries; | |
891 | |
892 /* number of actual entries entered in the table. */ | |
893 int count; | |
894 | |
895 /* number of entries allocated currently. */ | |
896 int allocated; | |
897 } cpp_comment_table; | |
898 | |
899 /* Returns the table of comments encountered by the preprocessor. This | |
900 table is only populated when pfile->state.save_comments is true. */ | |
901 extern cpp_comment_table *cpp_get_comments (cpp_reader *); | |
902 | |
903 /* In hash.c */ | |
904 | |
905 /* Lookup an identifier in the hashtable. Puts the identifier in the | |
906 table if it is not already there. */ | |
907 extern cpp_hashnode *cpp_lookup (cpp_reader *, const unsigned char *, | |
908 unsigned int); | |
909 | |
910 typedef int (*cpp_cb) (cpp_reader *, cpp_hashnode *, void *); | |
911 extern void cpp_forall_identifiers (cpp_reader *, cpp_cb, void *); | |
912 | |
913 /* In macro.c */ | |
914 extern void cpp_scan_nooutput (cpp_reader *); | |
915 extern int cpp_sys_macro_p (cpp_reader *); | |
916 extern unsigned char *cpp_quote_string (unsigned char *, const unsigned char *, | |
917 unsigned int); | |
918 | |
919 /* In files.c */ | |
920 extern bool cpp_included (cpp_reader *, const char *); | |
921 extern bool cpp_included_before (cpp_reader *, const char *, source_location); | |
922 extern void cpp_make_system_header (cpp_reader *, int, int); | |
923 extern bool cpp_push_include (cpp_reader *, const char *); | |
924 extern void cpp_change_file (cpp_reader *, enum lc_reason, const char *); | |
925 extern const char *cpp_get_path (struct _cpp_file *); | |
926 extern cpp_dir *cpp_get_dir (struct _cpp_file *); | |
927 extern cpp_buffer *cpp_get_buffer (cpp_reader *); | |
928 extern struct _cpp_file *cpp_get_file (cpp_buffer *); | |
929 extern cpp_buffer *cpp_get_prev (cpp_buffer *); | |
930 extern void cpp_clear_file_cache (cpp_reader *); | |
931 | |
932 /* In pch.c */ | |
933 struct save_macro_data; | |
934 extern int cpp_save_state (cpp_reader *, FILE *); | |
935 extern int cpp_write_pch_deps (cpp_reader *, FILE *); | |
936 extern int cpp_write_pch_state (cpp_reader *, FILE *); | |
937 extern int cpp_valid_state (cpp_reader *, const char *, int); | |
938 extern void cpp_prepare_state (cpp_reader *, struct save_macro_data **); | |
939 extern int cpp_read_state (cpp_reader *, const char *, FILE *, | |
940 struct save_macro_data *); | |
941 | |
942 #ifdef __cplusplus | |
943 } | |
944 #endif | |
945 | |
946 #endif /* ! LIBCPP_CPPLIB_H */ |