git.gag.com Git - fw/sdcc/blob - support/cpp2/cpplib.h

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