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