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