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 /* This is called after options have been parsed, and partially
788    processed.  */
789 extern void cpp_post_options (cpp_reader *);
790 
791 /* Set up translation to the target character set.  */
792 extern void cpp_init_iconv (cpp_reader *);
793 
794 /* Call this to finish preprocessing.  If you requested dependency
795    generation, pass an open stream to write the information to,
796    otherwise NULL.  It is your responsibility to close the stream.  */
797 extern void cpp_finish (cpp_reader *, FILE *deps_stream);
798 
799 /* Call this to release the handle at the end of preprocessing.  Any
800    use of the handle after this function returns is invalid.  */
801 extern void cpp_destroy (cpp_reader *);
802 
803 extern unsigned int cpp_token_len (const cpp_token *);
804 extern unsigned char *cpp_token_as_text (cpp_reader *, const cpp_token *);
805 extern unsigned char *cpp_spell_token (cpp_reader *, const cpp_token *,
806 				       unsigned char *, bool);
807 extern void cpp_register_pragma (cpp_reader *, const char *, const char *,
808 				 void (*) (cpp_reader *), bool);
809 extern void cpp_register_deferred_pragma (cpp_reader *, const char *,
810 					  const char *, unsigned, bool, bool);
811 extern int cpp_avoid_paste (cpp_reader *, const cpp_token *,
812 			    const cpp_token *);
813 extern const cpp_token *cpp_get_token (cpp_reader *);
814 extern const cpp_token *cpp_get_token_with_location (cpp_reader *,
815 						     source_location *);
816 extern bool cpp_fun_like_macro_p (cpp_hashnode *);
817 extern const unsigned char *cpp_macro_definition (cpp_reader *,
818 						  cpp_hashnode *);
819 extern void _cpp_backup_tokens (cpp_reader *, unsigned int);
820 extern const cpp_token *cpp_peek_token (cpp_reader *, int);
821 
822 /* Evaluate a CPP_*CHAR* token.  */
823 extern cppchar_t cpp_interpret_charconst (cpp_reader *, const cpp_token *,
824 					  unsigned int *, int *);
825 /* Evaluate a vector of CPP_*STRING* tokens.  */
826 extern bool cpp_interpret_string (cpp_reader *,
827 				  const cpp_string *, size_t,
828 				  cpp_string *, enum cpp_ttype);
829 extern bool cpp_interpret_string_notranslate (cpp_reader *,
830 					      const cpp_string *, size_t,
831 					      cpp_string *, enum cpp_ttype);
832 
833 /* Convert a host character constant to the execution character set.  */
834 extern cppchar_t cpp_host_to_exec_charset (cpp_reader *, cppchar_t);
835 
836 /* Used to register macros and assertions, perhaps from the command line.
837    The text is the same as the command line argument.  */
838 extern void cpp_define (cpp_reader *, const char *);
839 extern void cpp_define_formatted (cpp_reader *pfile,
840 				  const char *fmt, ...) ATTRIBUTE_PRINTF_2;
841 extern void cpp_assert (cpp_reader *, const char *);
842 extern void cpp_undef (cpp_reader *, const char *);
843 extern void cpp_unassert (cpp_reader *, const char *);
844 
845 /* Undefine all macros and assertions.  */
846 extern void cpp_undef_all (cpp_reader *);
847 
848 extern cpp_buffer *cpp_push_buffer (cpp_reader *, const unsigned char *,
849 				    size_t, int);
850 extern int cpp_defined (cpp_reader *, const unsigned char *, int);
851 
852 /* A preprocessing number.  Code assumes that any unused high bits of
853    the double integer are set to zero.  */
854 
855 /* This type has to be equal to unsigned HOST_WIDE_INT, see
856    gcc/c-family/c-lex.c.  */
857 typedef uint64_t cpp_num_part;
858 typedef struct cpp_num cpp_num;
859 struct cpp_num
860 {
861   cpp_num_part high;
862   cpp_num_part low;
863   bool unsignedp;  /* True if value should be treated as unsigned.  */
864   bool overflow;   /* True if the most recent calculation overflowed.  */
865 };
866 
867 /* cpplib provides two interfaces for interpretation of preprocessing
868    numbers.
869 
870    cpp_classify_number categorizes numeric constants according to
871    their field (integer, floating point, or invalid), radix (decimal,
872    octal, hexadecimal), and type suffixes.  */
873 
874 #define CPP_N_CATEGORY  0x000F
875 #define CPP_N_INVALID	0x0000
876 #define CPP_N_INTEGER	0x0001
877 #define CPP_N_FLOATING	0x0002
878 
879 #define CPP_N_WIDTH	0x00F0
880 #define CPP_N_SMALL	0x0010	/* int, float, shrot _Fract/Accum  */
881 #define CPP_N_MEDIUM	0x0020	/* long, double, long _Fract/_Accum.  */
882 #define CPP_N_LARGE	0x0040	/* long long, long double,
883 				   long long _Fract/Accum.  */
884 
885 #define CPP_N_WIDTH_MD	0xF0000	/* machine defined.  */
886 #define CPP_N_MD_W	0x10000
887 #define CPP_N_MD_Q	0x20000
888 
889 #define CPP_N_RADIX	0x0F00
890 #define CPP_N_DECIMAL	0x0100
891 #define CPP_N_HEX	0x0200
892 #define CPP_N_OCTAL	0x0400
893 #define CPP_N_BINARY	0x0800
894 
895 #define CPP_N_UNSIGNED	0x1000	/* Properties.  */
896 #define CPP_N_IMAGINARY	0x2000
897 #define CPP_N_DFLOAT	0x4000
898 #define CPP_N_DEFAULT	0x8000
899 
900 #define CPP_N_FRACT	0x100000 /* Fract types.  */
901 #define CPP_N_ACCUM	0x200000 /* Accum types.  */
902 
903 #define CPP_N_USERDEF	0x1000000 /* C++0x user-defined literal.  */
904 
905 /* Classify a CPP_NUMBER token.  The return value is a combination of
906    the flags from the above sets.  */
907 extern unsigned cpp_classify_number (cpp_reader *, const cpp_token *,
908 				     const char **, source_location);
909 
910 /* Return the classification flags for a float suffix.  */
911 extern unsigned int cpp_interpret_float_suffix (cpp_reader *, const char *,
912 						size_t);
913 
914 /* Return the classification flags for an int suffix.  */
915 extern unsigned int cpp_interpret_int_suffix (cpp_reader *, const char *,
916 					      size_t);
917 
918 /* Evaluate a token classified as category CPP_N_INTEGER.  */
919 extern cpp_num cpp_interpret_integer (cpp_reader *, const cpp_token *,
920 				      unsigned int);
921 
922 /* Sign extend a number, with PRECISION significant bits and all
923    others assumed clear, to fill out a cpp_num structure.  */
924 cpp_num cpp_num_sign_extend (cpp_num, size_t);
925 
926 /* Diagnostic levels.  To get a diagnostic without associating a
927    position in the translation unit with it, use cpp_error_with_line
928    with a line number of zero.  */
929 
930 enum {
931   /* Warning, an error with -Werror.  */
932   CPP_DL_WARNING = 0,
933   /* Same as CPP_DL_WARNING, except it is not suppressed in system headers.  */
934   CPP_DL_WARNING_SYSHDR,
935   /* Warning, an error with -pedantic-errors or -Werror.  */
936   CPP_DL_PEDWARN,
937   /* An error.  */
938   CPP_DL_ERROR,
939   /* An internal consistency check failed.  Prints "internal error: ",
940      otherwise the same as CPP_DL_ERROR.  */
941   CPP_DL_ICE,
942   /* An informative note following a warning.  */
943   CPP_DL_NOTE,
944   /* A fatal error.  */
945   CPP_DL_FATAL
946 };
947 
948 /* Warning reason codes. Use a reason code of zero for unclassified warnings
949    and errors that are not warnings.  */
950 enum {
951   CPP_W_NONE = 0,
952   CPP_W_DEPRECATED,
953   CPP_W_COMMENTS,
954   CPP_W_MISSING_INCLUDE_DIRS,
955   CPP_W_TRIGRAPHS,
956   CPP_W_MULTICHAR,
957   CPP_W_TRADITIONAL,
958   CPP_W_LONG_LONG,
959   CPP_W_ENDIF_LABELS,
960   CPP_W_NUM_SIGN_CHANGE,
961   CPP_W_VARIADIC_MACROS,
962   CPP_W_BUILTIN_MACRO_REDEFINED,
963   CPP_W_DOLLARS,
964   CPP_W_UNDEF,
965   CPP_W_UNUSED_MACROS,
966   CPP_W_CXX_OPERATOR_NAMES,
967   CPP_W_NORMALIZE,
968   CPP_W_INVALID_PCH,
969   CPP_W_WARNING_DIRECTIVE,
970   CPP_W_LITERAL_SUFFIX,
971   CPP_W_DATE_TIME,
972   CPP_W_PEDANTIC,
973   CPP_W_C90_C99_COMPAT,
974   CPP_W_CXX11_COMPAT
975 };
976 
977 /* Output a diagnostic of some kind.  */
978 extern bool cpp_error (cpp_reader *, int, const char *msgid, ...)
979   ATTRIBUTE_PRINTF_3;
980 extern bool cpp_warning (cpp_reader *, int, const char *msgid, ...)
981   ATTRIBUTE_PRINTF_3;
982 extern bool cpp_pedwarning (cpp_reader *, int, const char *msgid, ...)
983   ATTRIBUTE_PRINTF_3;
984 extern bool cpp_warning_syshdr (cpp_reader *, int, const char *msgid, ...)
985   ATTRIBUTE_PRINTF_3;
986 
987 /* Output a diagnostic with "MSGID: " preceding the
988    error string of errno.  No location is printed.  */
989 extern bool cpp_errno (cpp_reader *, int, const char *msgid);
990 /* Similarly, but with "FILENAME: " instead of "MSGID: ", where
991    the filename is not localized.  */
992 extern bool cpp_errno_filename (cpp_reader *, int, const char *filename);
993 
994 /* Same as cpp_error, except additionally specifies a position as a
995    (translation unit) physical line and physical column.  If the line is
996    zero, then no location is printed.  */
997 extern bool cpp_error_with_line (cpp_reader *, int, source_location,
998                                  unsigned, const char *msgid, ...)
999   ATTRIBUTE_PRINTF_5;
1000 extern bool cpp_warning_with_line (cpp_reader *, int, source_location,
1001                                    unsigned, const char *msgid, ...)
1002   ATTRIBUTE_PRINTF_5;
1003 extern bool cpp_pedwarning_with_line (cpp_reader *, int, source_location,
1004                                       unsigned, const char *msgid, ...)
1005   ATTRIBUTE_PRINTF_5;
1006 extern bool cpp_warning_with_line_syshdr (cpp_reader *, int, source_location,
1007                                           unsigned, const char *msgid, ...)
1008   ATTRIBUTE_PRINTF_5;
1009 
1010 /* In lex.c */
1011 extern int cpp_ideq (const cpp_token *, const char *);
1012 extern void cpp_output_line (cpp_reader *, FILE *);
1013 extern unsigned char *cpp_output_line_to_string (cpp_reader *,
1014 						 const unsigned char *);
1015 extern void cpp_output_token (const cpp_token *, FILE *);
1016 extern const char *cpp_type2name (enum cpp_ttype, unsigned char flags);
1017 /* Returns the value of an escape sequence, truncated to the correct
1018    target precision.  PSTR points to the input pointer, which is just
1019    after the backslash.  LIMIT is how much text we have.  WIDE is true
1020    if the escape sequence is part of a wide character constant or
1021    string literal.  Handles all relevant diagnostics.  */
1022 extern cppchar_t cpp_parse_escape (cpp_reader *, const unsigned char ** pstr,
1023 				   const unsigned char *limit, int wide);
1024 
1025 /* Structure used to hold a comment block at a given location in the
1026    source code.  */
1027 
1028 typedef struct
1029 {
1030   /* Text of the comment including the terminators.  */
1031   char *comment;
1032 
1033   /* source location for the given comment.  */
1034   source_location sloc;
1035 } cpp_comment;
1036 
1037 /* Structure holding all comments for a given cpp_reader.  */
1038 
1039 typedef struct
1040 {
1041   /* table of comment entries.  */
1042   cpp_comment *entries;
1043 
1044   /* number of actual entries entered in the table.  */
1045   int count;
1046 
1047   /* number of entries allocated currently.  */
1048   int allocated;
1049 } cpp_comment_table;
1050 
1051 /* Returns the table of comments encountered by the preprocessor. This
1052    table is only populated when pfile->state.save_comments is true. */
1053 extern cpp_comment_table *cpp_get_comments (cpp_reader *);
1054 
1055 /* In hash.c */
1056 
1057 /* Lookup an identifier in the hashtable.  Puts the identifier in the
1058    table if it is not already there.  */
1059 extern cpp_hashnode *cpp_lookup (cpp_reader *, const unsigned char *,
1060 				 unsigned int);
1061 
1062 typedef int (*cpp_cb) (cpp_reader *, cpp_hashnode *, void *);
1063 extern void cpp_forall_identifiers (cpp_reader *, cpp_cb, void *);
1064 
1065 /* In macro.c */
1066 extern void cpp_scan_nooutput (cpp_reader *);
1067 extern int  cpp_sys_macro_p (cpp_reader *);
1068 extern unsigned char *cpp_quote_string (unsigned char *, const unsigned char *,
1069 					unsigned int);
1070 
1071 /* In files.c */
1072 extern bool cpp_included (cpp_reader *, const char *);
1073 extern bool cpp_included_before (cpp_reader *, const char *, source_location);
1074 extern void cpp_make_system_header (cpp_reader *, int, int);
1075 extern bool cpp_push_include (cpp_reader *, const char *);
1076 extern bool cpp_push_default_include (cpp_reader *, const char *);
1077 extern void cpp_change_file (cpp_reader *, enum lc_reason, const char *);
1078 extern const char *cpp_get_path (struct _cpp_file *);
1079 extern cpp_dir *cpp_get_dir (struct _cpp_file *);
1080 extern cpp_buffer *cpp_get_buffer (cpp_reader *);
1081 extern struct _cpp_file *cpp_get_file (cpp_buffer *);
1082 extern cpp_buffer *cpp_get_prev (cpp_buffer *);
1083 extern void cpp_clear_file_cache (cpp_reader *);
1084 
1085 /* In pch.c */
1086 struct save_macro_data;
1087 extern int cpp_save_state (cpp_reader *, FILE *);
1088 extern int cpp_write_pch_deps (cpp_reader *, FILE *);
1089 extern int cpp_write_pch_state (cpp_reader *, FILE *);
1090 extern int cpp_valid_state (cpp_reader *, const char *, int);
1091 extern void cpp_prepare_state (cpp_reader *, struct save_macro_data **);
1092 extern int cpp_read_state (cpp_reader *, const char *, FILE *,
1093 			   struct save_macro_data *);
1094 
1095 /* In lex.c */
1096 extern void cpp_force_token_locations (cpp_reader *, source_location *);
1097 extern void cpp_stop_forcing_token_locations (cpp_reader *);
1098 
1099 /* In expr.c */
1100 extern enum cpp_ttype cpp_userdef_string_remove_type
1101   (enum cpp_ttype type);
1102 extern enum cpp_ttype cpp_userdef_string_add_type
1103   (enum cpp_ttype type);
1104 extern enum cpp_ttype cpp_userdef_char_remove_type
1105   (enum cpp_ttype type);
1106 extern enum cpp_ttype cpp_userdef_char_add_type
1107   (enum cpp_ttype type);
1108 extern bool cpp_userdef_string_p
1109   (enum cpp_ttype type);
1110 extern bool cpp_userdef_char_p
1111   (enum cpp_ttype type);
1112 extern const char * cpp_get_userdef_suffix
1113   (const cpp_token *);
1114 
1115 #endif /* ! LIBCPP_CPPLIB_H */
1116