gcc/cpplib.h

   1 /* Definitions for CPP library.
   2    Copyright (C) 1995, 96-99, 2000 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 2, 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; if not, write to the Free Software
  17 Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  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 __GCC_CPPLIB__
  23 #define __GCC_CPPLIB__
  24
  25 #include <sys/types.h>
  26
  27 #ifdef __cplusplus
  28 extern "C" {
  29 #endif
  30
  31 typedef struct cpp_reader cpp_reader;
  32 typedef struct cpp_buffer cpp_buffer;
  33 typedef struct cpp_options cpp_options;
  34 typedef struct cpp_printer cpp_printer;
  35 typedef struct cpp_token cpp_token;
  36 typedef struct cpp_toklist cpp_toklist;
  37 typedef struct cpp_name cpp_name;
  38
  39 /* The first two groups, apart from '=', can appear in preprocessor
  40    expressions.  This allows a lookup table to be implemented in
  41    _cpp_parse_expr.
  42
  43    The first group, to CPP_LAST_EQ, can be immediately followed by an
  44    '='.  The lexer needs operators ending in '=', like ">>=", to be in
  45    the same order as their counterparts without the '=', like ">>".  */
  46
  47 /* Positions in the table.  */
  48 #define CPP_LAST_EQ CPP_LSHIFT
  49 #define CPP_FIRST_DIGRAPH CPP_HASH
  50
  51 #define TTYPE_TABLE                             \
  52   T(CPP_EQ = 0,         "=")                    \
  53   T(CPP_NOT,            "!")                    \
  54   T(CPP_GREATER,        ">")    /* compare */   \
  55   T(CPP_LESS,           "<")                    \
  56   T(CPP_PLUS,           "+")    /* math */      \
  57   T(CPP_MINUS,          "-")                    \
  58   T(CPP_MULT,           "*")                    \
  59   T(CPP_DIV,            "/")                    \
  60   T(CPP_MOD,            "%")                    \
  61   T(CPP_AND,            "&")    /* bit ops */   \
  62   T(CPP_OR,             "|")                    \
  63   T(CPP_XOR,            "^")                    \
  64   T(CPP_RSHIFT,         ">>")                   \
  65   T(CPP_LSHIFT,         "<<")                   \
  66 \
  67   T(CPP_COMPL,          "~")                    \
  68   T(CPP_AND_AND,        "&&")   /* logical */   \
  69   T(CPP_OR_OR,          "||")                   \
  70   T(CPP_QUERY,          "?")                    \
  71   T(CPP_COLON,          ":")                    \
  72   T(CPP_COMMA,          ",")    /* grouping */  \
  73   T(CPP_OPEN_PAREN,     "(")                    \
  74   T(CPP_CLOSE_PAREN,    ")")                    \
  75   T(CPP_EQ_EQ,          "==")   /* compare */   \
  76   T(CPP_NOT_EQ,         "!=")                   \
  77   T(CPP_GREATER_EQ,     ">=")                   \
  78   T(CPP_LESS_EQ,        "<=")                   \
  79 \
  80   T(CPP_PLUS_EQ,        "+=")   /* math */      \
  81   T(CPP_MINUS_EQ,       "-=")                   \
  82   T(CPP_MULT_EQ,        "*=")                   \
  83   T(CPP_DIV_EQ,         "/=")                   \
  84   T(CPP_MOD_EQ,         "%=")                   \
  85   T(CPP_AND_EQ,         "&=")   /* bit ops */   \
  86   T(CPP_OR_EQ,          "|=")                   \
  87   T(CPP_XOR_EQ,         "^=")                   \
  88   T(CPP_RSHIFT_EQ,      ">>=")                  \
  89   T(CPP_LSHIFT_EQ,      "<<=")                  \
  90   /* Digraphs together, beginning with CPP_FIRST_DIGRAPH.  */   \
  91   T(CPP_HASH,           "#")    /* digraphs */  \
  92   T(CPP_PASTE,          "##")                   \
  93   T(CPP_OPEN_SQUARE,    "[")                    \
  94   T(CPP_CLOSE_SQUARE,   "]")                    \
  95   T(CPP_OPEN_BRACE,     "{")                    \
  96   T(CPP_CLOSE_BRACE,    "}")                    \
  97   /* The remainder of the punctuation.  Order is not significant. */    \
  98   T(CPP_SEMICOLON,      ";")    /* structure */ \
  99   T(CPP_ELLIPSIS,       "...")                  \
 100   T(CPP_BACKSLASH,      "\\")                   \
 101   T(CPP_PLUS_PLUS,      "++")   /* increment */ \
 102   T(CPP_MINUS_MINUS,    "--")                   \
 103   T(CPP_DEREF,          "->")   /* accessors */ \
 104   T(CPP_DOT,            ".")                    \
 105   T(CPP_SCOPE,          "::")                   \
 106   T(CPP_DEREF_STAR,     "->*")                  \
 107   T(CPP_DOT_STAR,       ".*")                   \
 108   T(CPP_MIN,            "<?")   /* extension */ \
 109   T(CPP_MAX,            ">?")                   \
 110   C(CPP_OTHER,          0)      /* stray punctuation */ \
 111 \
 112   H(CPP_NAME,           spell_name)     /* word */      \
 113   N(CPP_INT,            0)              /* 23 */        \
 114   N(CPP_FLOAT,          0)              /* 3.14159 */   \
 115   H(CPP_NUMBER,         spell_name)     /* 34_be+ta  */ \
 116   H(CPP_CHAR,           spell_string)   /* 'char' */    \
 117   H(CPP_WCHAR,          spell_string)   /* L'char' */   \
 118   H(CPP_STRING,         spell_string)   /* "string" */  \
 119   H(CPP_WSTRING,        spell_string)   /* L"string" */ \
 120 \
 121   H(CPP_C_COMMENT,      spell_comment)  /* Only if output comments.  */ \
 122   H(CPP_CPP_COMMENT,    spell_comment)  /* Only if output comments.  */ \
 123   H(CPP_CHILL_COMMENT,  spell_comment)  /* Only if output comments.  */ \
 124   N(CPP_MACRO_ARG,      0)              /* Macro argument.  */          \
 125   N(CPP_SUBLIST,        0)              /* Sublist.  */                 \
 126   E(CPP_VSPACE,         "\n")           /* End of line.  */             \
 127   N(CPP_EOF,            0)              /* End of file.  */             \
 128   N(CPP_HEADER_NAME,    0)              /* <stdio.h> in #include */     \
 129   N(CPP_ASSERTION,      0)              /* (...) in #assert */          \
 130 \
 131   /* Obsolete - will be removed when no code uses them still.  */       \
 132   H(CPP_COMMENT,        0)              /* Only if output comments.  */ \
 133   N(CPP_HSPACE,         0)              /* Horizontal white space.  */  \
 134   N(CPP_DIRECTIVE,      0)              /* #define and the like */      \
 135   N(CPP_MACRO,          0)              /* Like a NAME, but expanded.  */
 136
 137 #define T(e, s) e,
 138 #define H(e, s) e,
 139 #define C(e, s) e,
 140 #define N(e, s) e,
 141 #define E(e, s) e,
 142 enum cpp_ttype
 143 {
 144   TTYPE_TABLE
 145   N_TTYPES
 146 };
 147 #undef T
 148 #undef H
 149 #undef C
 150 #undef N
 151 #undef E
 152
 153 /* Payload of a NAME, NUMBER, FLOAT, STRING, or COMMENT token.  */
 154 struct cpp_name
 155 {
 156   unsigned int len;
 157   unsigned int offset;          /* from list->namebuf */
 158 };
 159
 160 /* Accessor macros for token lists - all expect you have a
 161    list and an index.  */
 162
 163 #define TOK_TYPE(l_, i_)   ((l_)->tokens[i_].type)
 164 #define TOK_FLAGS(l_, i_)  ((l_)->tokens[i_].flags)
 165 #define TOK_AUX(l_, i_)    ((l_)->tokens[i_].aux)
 166 #define TOK_COL(l_, i_)    ((l_)->tokens[i_].col)
 167 #define TOK_INT(l_, i_)    ((l_)->tokens[i_].val.integer)
 168 #define TOK_OFFSET(l_, i_) ((l_)->tokens[i_].val.name.offset)
 169 #define TOK_NAME(l_, i_)   ((l_)->tokens[i_].val.name.offset + (l_)->namebuf)
 170 #define TOK_LEN(l_, i_)    ((l_)->tokens[i_].val.name.len)
 171
 172 #define TOK_PREV_WHITE(l_, i_) (TOK_FLAGS(l_, i_) & PREV_WHITESPACE)
 173
 174 /* Flags for the cpp_token structure.  */
 175 #define PREV_WHITESPACE     1   /* If whitespace before this token.  */
 176 #define DIGRAPH             2   /* If it was a digraph.  */
 177 #define UNSIGNED_INT        4   /* If int preprocessing token unsigned.  */
 178
 179 /* A preprocessing token.  This has been carefully packed and should
 180    occupy 16 bytes on both 32- and 64-bit hosts.  */
 181 struct cpp_token
 182 {
 183   unsigned short col;                   /* starting column of this token */
 184   ENUM_BITFIELD(cpp_ttype) type : CHAR_BIT;  /* node type */
 185   unsigned char flags;                  /* flags - see above */
 186   unsigned int aux;                     /* CPP_OTHER character.  Hash of a
 187                                            NAME, or something - see uses
 188                                            in the code */
 189   union
 190   {
 191     struct cpp_name name;               /* a string */
 192     HOST_WIDEST_INT integer;            /* an integer */
 193   } val;
 194 };
 195
 196 /* Directive flags.  */
 197 #define SYNTAX_INCLUDE (1 << 8)
 198 #define SYNTAX_ASSERT  (1 << 9)
 199
 200 typedef int (*directive_handler) PARAMS ((cpp_reader *));
 201
 202 struct cpp_toklist
 203 {
 204   cpp_token *tokens;            /* actual tokens as an array */
 205   unsigned int tokens_used;     /* tokens used */
 206   unsigned int tokens_cap;      /* tokens allocated */
 207
 208   unsigned char *namebuf;       /* names buffer */
 209   unsigned int name_used;       /* _bytes_ used */
 210   unsigned int name_cap;        /* _bytes_ allocated */
 211
 212   unsigned int line;            /* starting line number */
 213
 214   /* Comment copying.  */
 215   cpp_token *comments;          /* comment tokens.  */
 216   unsigned int comments_used;   /* comment tokens used.  */
 217   unsigned int comments_cap;    /* comment token capacity.  */
 218
 219   /* Only used if tokens[0].type == CPP_DIRECTIVE.  This is the
 220      handler to call after lexing the rest of this line.  The flags
 221      indicate whether the rest of the line gets special treatment
 222      during lexing (#include, #if, #assert, #unassert).  */
 223   directive_handler dir_handler;
 224   unsigned short dir_flags;
 225 };
 226
 227 struct cpp_buffer
 228 {
 229   const unsigned char *cur;      /* current position */
 230   const unsigned char *rlimit; /* end of valid data */
 231   const unsigned char *buf;      /* entire buffer */
 232   const unsigned char *line_base; /* start of current line */
 233   const unsigned char *mark;  /* Saved position for lengthy backtrack. */
 234
 235   struct cpp_buffer *prev;
 236
 237   /* Filename specified with #line command.  */
 238   const char *nominal_fname;
 239   /* Actual directory of this file, used only for "" includes */
 240   struct file_name_list *actual_dir;
 241
 242   /* Pointer into the include hash table.  Used for include_next and
 243      to record control macros. */
 244   struct ihash *ihash;
 245
 246   /* If the buffer is the expansion of a macro, this points to the
 247      macro's hash table entry.  */
 248   struct hashnode *macro;
 249
 250   /* Value of if_stack at start of this file.
 251      Used to prohibit unmatched #endif (etc) in an include file.  */
 252   struct if_stack *if_stack;
 253
 254   /* Line number at line_base (above). */
 255   unsigned int lineno;
 256
 257   /* True if this is a header file included using <FILENAME>.  */
 258   char system_header_p;
 259
 260   /* True if buffer contains escape sequences.
 261      Currently there are two kinds:
 262      "\r-" means following identifier should not be macro-expanded.
 263      "\r " means a token-separator.  This turns into " " in final output
 264           if not stringizing and needed to separate tokens; otherwise nothing.
 265      Any other two-character sequence beginning with \r is an error.
 266
 267      If this is NOT set, then \r is a one-character escape meaning backslash
 268      newline.  This is guaranteed not to occur in the middle of a token.
 269      The two interpretations of \r do not conflict, because the two-character
 270      escapes are used only in macro buffers, and backslash-newline is removed
 271      from macro expansion text in collect_expansion and/or macarg.  */
 272   char has_escapes;
 273
 274   /* True if we have already warned about C++ comments in this file.
 275      The warning happens only for C89 extended mode with -pedantic on,
 276      or for -Wtraditional, and only once per file (otherwise it would
 277      be far too noisy).  */
 278   char warned_cplusplus_comments;
 279
 280   /* In a file buffer, true if this buffer's data is mmapped
 281      (currently never the case).  In a macro buffer, true if this
 282      buffer's data must be freed.  */
 283   char mapped;
 284 };
 285
 286 struct file_name_map_list;
 287 struct htab;
 288
 289 /* Maximum nesting of cpp_buffers.  We use a static limit, partly for
 290    efficiency, and partly to limit runaway recursion.  */
 291 #define CPP_STACK_MAX 200
 292
 293 /* Values for opts.dump_macros.
 294   dump_only means inhibit output of the preprocessed text
 295              and instead output the definitions of all user-defined
 296              macros in a form suitable for use as input to cpp.
 297    dump_names means pass #define and the macro name through to output.
 298    dump_definitions means pass the whole definition (plus #define) through
 299 */
 300 enum { dump_none = 0, dump_only, dump_names, dump_definitions };
 301
 302 /* This structure is nested inside struct cpp_reader, and
 303    carries all the options visible to the command line.  */
 304 struct cpp_options
 305 {
 306   /* Name of input and output files.  */
 307   const char *in_fname;
 308   const char *out_fname;
 309
 310   /* Pending options - -D, -U, -A, -I, -ixxx. */
 311   struct cpp_pending *pending;
 312
 313   /* File name which deps are being written to.  This is 0 if deps are
 314      being written to stdout.  */
 315   const char *deps_file;
 316
 317   /* Target-name to write with the dependency information.  */
 318   char *deps_target;
 319
 320   /* Search paths for include files.  */
 321   struct file_name_list *quote_include;  /* First dir to search for "file" */
 322   struct file_name_list *bracket_include;/* First dir to search for <file> */
 323
 324   /* Map between header names and file names, used only on DOS where
 325      file names are limited in length.  */
 326   struct file_name_map_list *map_list;
 327
 328   /* Directory prefix that should replace `/usr/lib/gcc-lib/TARGET/VERSION'
 329      in the standard include file directories.  */
 330   const char *include_prefix;
 331   unsigned int include_prefix_len;
 332
 333   /* Non-0 means -v, so print the full set of include dirs.  */
 334   unsigned char verbose;
 335
 336   /* Nonzero means use extra default include directories for C++.  */
 337   unsigned char cplusplus;
 338
 339   /* Nonzero means handle cplusplus style comments */
 340   unsigned char cplusplus_comments;
 341
 342   /* Nonzero means handle #import, for objective C.  */
 343   unsigned char objc;
 344
 345   /* Nonzero means this is an assembly file, so ignore unrecognized
 346      directives and the "# 33" form of #line, both of which are
 347      probably comments.  Also, permit unbalanced ' strings (again,
 348      likely to be in comments).  */
 349   unsigned char lang_asm;
 350
 351   /* Nonzero means this is Fortran, and we don't know where the
 352      comments are, so permit unbalanced ' strings.  Unlike lang_asm,
 353      this does not ignore unrecognized directives.  */
 354   unsigned char lang_fortran;
 355
 356   /* Nonzero means handle CHILL comment syntax and output CHILL string
 357      delimiters for __DATE__ etc. */
 358   unsigned char chill;
 359
 360   /* Nonzero means don't copy comments into the output file.  */
 361   unsigned char discard_comments;
 362
 363   /* Nonzero means process the ANSI trigraph sequences.  */
 364   unsigned char trigraphs;
 365
 366   /* Nonzero means print the names of included files rather than the
 367      preprocessed output.  1 means just the #include "...", 2 means
 368      #include <...> as well.  */
 369   unsigned char print_deps;
 370
 371   /* Nonzero if missing .h files in -M output are assumed to be
 372      generated files and not errors.  */
 373   unsigned char print_deps_missing_files;
 374
 375   /* If true, fopen (deps_file, "a") else fopen (deps_file, "w"). */
 376   unsigned char print_deps_append;
 377
 378   /* Nonzero means print names of header files (-H).  */
 379   unsigned char print_include_names;
 380
 381   /* Nonzero means cpp_pedwarn causes a hard error.  */
 382   unsigned char pedantic_errors;
 383
 384   /* Nonzero means don't print warning messages.  */
 385   unsigned char inhibit_warnings;
 386
 387   /* Nonzero means don't print error messages.  Has no option to
 388      select it, but can be set by a user of cpplib (e.g. fix-header).  */
 389   unsigned char inhibit_errors;
 390
 391   /* Nonzero means warn if slash-star appears in a comment.  */
 392   unsigned char warn_comments;
 393
 394   /* Nonzero means warn if there are any trigraphs.  */
 395   unsigned char warn_trigraphs;
 396
 397   /* Nonzero means warn if #import is used.  */
 398   unsigned char warn_import;
 399
 400   /* Nonzero means warn if a macro argument is (or would be)
 401      stringified with -traditional, and warn about directives
 402      with the # indented from the beginning of the line.  */
 403   unsigned char warn_traditional;
 404
 405   /* Nonzero means turn warnings into errors.  */
 406   unsigned char warnings_are_errors;
 407
 408   /* Nonzero causes output not to be done, but directives such as
 409      #define that have side effects are still obeyed.  */
 410   unsigned char no_output;
 411
 412   /* Nonzero means we should look for header.gcc files that remap file
 413      names.  */
 414   unsigned char remap;
 415
 416   /* Nonzero means don't output line number information.  */
 417   unsigned char no_line_commands;
 418
 419   /* Nonzero means -I- has been seen, so don't look for #include "foo"
 420      the source-file directory.  */
 421   unsigned char ignore_srcdir;
 422
 423   /* Zero means dollar signs are punctuation. */
 424   unsigned char dollars_in_ident;
 425
 426   /* Nonzero means try to imitate old fashioned non-ANSI preprocessor.  */
 427   unsigned char traditional;
 428
 429   /* Nonzero means warn if undefined identifiers are evaluated in an #if.  */
 430   unsigned char warn_undef;
 431
 432   /* Nonzero for the 1989 C Standard, including corrigenda and amendments.  */
 433   unsigned char c89;
 434
 435   /* Nonzero for the 1999 C Standard, including corrigenda and amendments.  */
 436   unsigned char c99;
 437
 438   /* Nonzero means give all the error messages the ANSI standard requires.  */
 439   unsigned char pedantic;
 440
 441   /* Nonzero means we're looking at already preprocessed code, so don't
 442      bother trying to do macro expansion and whatnot.  */
 443   unsigned char preprocessed;
 444
 445   /* Nonzero disables all the standard directories for headers.  */
 446   unsigned char no_standard_includes;
 447
 448   /* Nonzero disables the C++-specific standard directories for headers.  */
 449   unsigned char no_standard_cplusplus_includes;
 450
 451   /* Nonzero means dump macros in some fashion - see above.  */
 452   unsigned char dump_macros;
 453
 454   /* Nonzero means pass all #define and #undef directives which we
 455      actually process through to the output stream.  This feature is
 456      used primarily to allow cc1 to record the #defines and #undefs
 457      for the sake of debuggers which understand about preprocessor
 458      macros, but it may also be useful with -E to figure out how
 459      symbols are defined, and where they are defined.  */
 460   unsigned char debug_output;
 461
 462   /* Nonzero means pass #include lines through to the output.  */
 463   unsigned char dump_includes;
 464
 465   /* Print column number in error messages.  */
 466   unsigned char show_column;
 467 };
 468
 469
 470 /* A cpp_reader encapsulates the "state" of a pre-processor run.
 471    Applying cpp_get_token repeatedly yields a stream of pre-processor
 472    tokens.  Usually, there is only one cpp_reader object active. */
 473
 474 struct cpp_reader
 475 {
 476   /* Top of buffer stack.  */
 477   cpp_buffer *buffer;
 478
 479   /* Token list used by get_directive_token.  */
 480   cpp_toklist directbuf;
 481
 482   /* A buffer used for both for cpp_get_token's output, and also internally. */
 483   unsigned char *token_buffer;
 484   /* Allocated size of token_buffer.  CPP_RESERVE allocates space.  */
 485   unsigned int token_buffer_size;
 486   /* End of the written part of token_buffer. */
 487   unsigned char *limit;
 488
 489   /* Error counter for exit code */
 490   unsigned int errors;
 491
 492   /* Line where a newline was first seen in a string constant.  */
 493   unsigned int multiline_string_line;
 494
 495   /* Current depth in #include directives that use <...>.  */
 496   unsigned int system_include_depth;
 497
 498   /* Current depth of buffer stack. */
 499   unsigned int buffer_stack_depth;
 500
 501   /* Hash table of macros and assertions.  See cpphash.c */
 502   struct htab *hashtab;
 503
 504   /* Hash table of other included files.  See cppfiles.c */
 505   struct htab *all_include_files;
 506
 507   /* Chain of `actual directory' file_name_list entries,
 508      for "" inclusion. */
 509   struct file_name_list *actual_dirs;
 510
 511   /* Current maximum length of directory names in the search path
 512      for include files.  (Altered as we get more of them.)  */
 513   unsigned int max_include_len;
 514
 515   struct if_stack *if_stack;
 516   const unsigned char *potential_control_macro;
 517
 518   /* Buffer of -M output.  */
 519   struct deps *deps;
 520
 521   /* A buffer used only by read_and_prescan (in cppfiles.c), which is
 522      allocated once per cpp_reader object to keep it off the stack.  */
 523   unsigned char *input_buffer;
 524   size_t input_buffer_len;
 525
 526   /* User visible options.  */
 527   struct cpp_options opts;
 528
 529   /* Nonzero means we have printed (while error reporting) a list of
 530      containing files that matches the current status.  */
 531   unsigned char input_stack_listing_current;
 532
 533   /* If non-zero, macros are not expanded.  */
 534   unsigned char no_macro_expand;
 535
 536   /* If non-zero, directives cause a hard error.  Used when parsing
 537      macro arguments.  */
 538   unsigned char no_directives;
 539
 540   /* We're printed a warning recommending against using #import.  */
 541   unsigned char import_warning;
 542
 543   /* If true, characters between '<' and '>' are a single (string) token.  */
 544   unsigned char parsing_include_directive;
 545
 546   /* If true, # introduces an assertion (see do_assert) */
 547   unsigned char parsing_if_directive;
 548
 549   /* If true, # and ## are the STRINGIZE and TOKPASTE operators */
 550   unsigned char parsing_define_directive;
 551
 552   /* True if escape sequences (as described for has_escapes in
 553      parse_buffer) should be emitted.  */
 554   unsigned char output_escapes;
 555
 556   /* 0: Have seen non-white-space on this line.
 557      1: Only seen white space so far on this line.
 558      2: Only seen white space so far in this file.  */
 559   unsigned char only_seen_white;
 560
 561   /* True after cpp_start_read completes.  Used to inhibit some
 562      warnings while parsing the command line.  */
 563   unsigned char done_initializing;
 564 };
 565
 566 /* struct cpp_printer encapsulates state used to convert the stream of
 567    tokens coming from cpp_get_token back into a text file.  Not
 568    everyone wants to do that, hence we separate the function.  */
 569
 570 struct cpp_printer
 571 {
 572   FILE *outf;                   /* stream to write to */
 573   const char *last_fname;       /* previous file name */
 574   unsigned int last_bsd;        /* did we just push? */
 575   unsigned int lineno;          /* line currently being written */
 576   unsigned int written;         /* low water mark in token buffer */
 577 };
 578
 579 #define CPP_FATAL_LIMIT 1000
 580 /* True if we have seen a "fatal" error. */
 581 #define CPP_FATAL_ERRORS(READER) ((READER)->errors >= CPP_FATAL_LIMIT)
 582
 583 /* Macros for manipulating the token_buffer. */
 584
 585 /* Number of characters currently in PFILE's output buffer. */
 586 #define CPP_WRITTEN(PFILE) ((size_t)((PFILE)->limit - (PFILE)->token_buffer))
 587 #define CPP_PWRITTEN(PFILE) ((PFILE)->limit)
 588 #define CPP_ADJUST_WRITTEN(PFILE,DELTA) ((PFILE)->limit += (DELTA))
 589 #define CPP_SET_WRITTEN(PFILE,N) ((PFILE)->limit = (PFILE)->token_buffer + (N))
 590
 591 #define CPP_OPTION(PFILE, OPTION) ((PFILE)->opts.OPTION)
 592 #define CPP_BUFFER(PFILE) ((PFILE)->buffer)
 593 #define CPP_BUF_LINE(BUF) ((BUF)->lineno)
 594 #define CPP_BUF_COL(BUF) ((BUF)->cur - (BUF)->line_base)
 595
 596 /* Name under which this program was invoked.  */
 597 extern const char *progname;
 598
 599 extern void _cpp_lex_file PARAMS((cpp_reader *));
 600 extern int cpp_handle_options PARAMS ((cpp_reader *, int, char **));
 601 extern enum cpp_ttype cpp_get_token PARAMS ((cpp_reader *));
 602 extern enum cpp_ttype cpp_get_non_space_token PARAMS ((cpp_reader *));
 603
 604 extern void cpp_reader_init PARAMS ((cpp_reader *));
 605 extern cpp_printer *cpp_printer_init PARAMS ((cpp_reader *, cpp_printer *));
 606 extern int cpp_start_read PARAMS ((cpp_reader *, cpp_printer *, const char *));
 607 extern void cpp_output_tokens PARAMS ((cpp_reader *, cpp_printer *));
 608 extern void cpp_output_list PARAMS ((cpp_reader *, cpp_printer *,
 609                                      const cpp_toklist *));
 610 extern void cpp_finish PARAMS ((cpp_reader *, cpp_printer *));
 611 extern void cpp_cleanup PARAMS ((cpp_reader *));
 612
 613 extern cpp_buffer *cpp_file_buffer PARAMS((cpp_reader *));
 614 extern void cpp_define PARAMS ((cpp_reader *, const char *));
 615 extern void cpp_assert PARAMS ((cpp_reader *, const char *));
 616 extern void cpp_undef  PARAMS ((cpp_reader *, const char *));
 617 extern void cpp_unassert PARAMS ((cpp_reader *, const char *));
 618
 619 extern void cpp_free_token_list PARAMS ((cpp_toklist *));
 620
 621 /* N.B. The error-message-printer prototypes have not been nicely
 622    formatted because exgettext needs to see 'msgid' on the same line
 623    as the name of the function in order to work properly.  Only the
 624    string argument gets a name in an effort to keep the lines from
 625    getting ridiculously oversized.  */
 626
 627 extern void cpp_ice PARAMS ((cpp_reader *, const char *msgid, ...))
 628   ATTRIBUTE_PRINTF_2;
 629 extern void cpp_fatal PARAMS ((cpp_reader *, const char *msgid, ...))
 630   ATTRIBUTE_PRINTF_2;
 631 extern void cpp_error PARAMS ((cpp_reader *, const char *msgid, ...))
 632   ATTRIBUTE_PRINTF_2;
 633 extern void cpp_warning PARAMS ((cpp_reader *, const char *msgid, ...))
 634   ATTRIBUTE_PRINTF_2;
 635 extern void cpp_pedwarn PARAMS ((cpp_reader *, const char *msgid, ...))
 636   ATTRIBUTE_PRINTF_2;
 637 extern void cpp_notice PARAMS ((cpp_reader *, const char *msgid, ...))
 638   ATTRIBUTE_PRINTF_2;
 639 extern void cpp_error_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...))
 640   ATTRIBUTE_PRINTF_4;
 641 extern void cpp_warning_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...))
 642   ATTRIBUTE_PRINTF_4;
 643 extern void cpp_pedwarn_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...))
 644   ATTRIBUTE_PRINTF_4;
 645 extern void cpp_pedwarn_with_file_and_line PARAMS ((cpp_reader *, const char *, int, int, const char *msgid, ...))
 646   ATTRIBUTE_PRINTF_5;
 647 extern void cpp_error_from_errno        PARAMS ((cpp_reader *, const char *));
 648 extern void cpp_notice_from_errno       PARAMS ((cpp_reader *, const char *));
 649
 650 /* In cpplex.c */
 651 extern cpp_buffer *cpp_push_buffer      PARAMS ((cpp_reader *,
 652                                                  const unsigned char *, long));
 653 extern cpp_buffer *cpp_pop_buffer       PARAMS ((cpp_reader *));
 654 extern void cpp_scan_buffer             PARAMS ((cpp_reader *, cpp_printer *));
 655 extern void cpp_scan_buffer_nooutput    PARAMS ((cpp_reader *));
 656 extern int cpp_idcmp                    PARAMS ((const unsigned char *,
 657                                                  size_t, const char *));
 658
 659 /* In cpphash.c */
 660 extern int cpp_defined                  PARAMS ((cpp_reader *,
 661                                                  const unsigned char *, int));
 662
 663 /* In cppfiles.c */
 664 extern int cpp_included                 PARAMS ((cpp_reader *, const char *));
 665 extern int cpp_read_file                PARAMS ((cpp_reader *, const char *));
 666
 667 #ifdef __cplusplus
 668 }
 669 #endif
 670 #endif /* __GCC_CPPLIB__ */