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   I(CPP_NAME,           0)      /* word */      \
 113   I(CPP_INT,            0)      /* 23 */        \
 114   I(CPP_FLOAT,          0)      /* 3.14159 */   \
 115   I(CPP_NUMBER,         0)      /* 34_be+ta  */ \
 116   S(CPP_CHAR,           0)      /* 'char' */    \
 117   S(CPP_WCHAR,          0)      /* L'char' */   \
 118   S(CPP_STRING,         0)      /* "string" */  \
 119   S(CPP_WSTRING,        0)      /* L"string" */ \
 120 \
 121   I(CPP_COMMENT,        0)      /* Only if output comments.  */ \
 122   N(CPP_MACRO_ARG,      0)      /* Macro argument.  */          \
 123   N(CPP_SUBLIST,        0)      /* Sublist.  */                 \
 124   T(CPP_VSPACE,         "\n")   /* End of line.  */             \
 125   N(CPP_EOF,            0)      /* End of file.  */             \
 126   N(CPP_HEADER_NAME,    0)      /* <stdio.h> in #include */     \
 127 \
 128   /* Obsolete - will be removed when no code uses them still.  */       \
 129   N(CPP_HSPACE,         0)      /* Horizontal white space.  */  \
 130   N(CPP_DIRECTIVE,      0)      /* #define and the like */      \
 131   N(CPP_MACRO,          0)      /* Like a NAME, but expanded.  */
 132
 133 #define T(e, s) e,
 134 #define I(e, s) e,
 135 #define S(e, s) e,
 136 #define C(e, s) e,
 137 #define N(e, s) e,
 138 enum cpp_ttype
 139 {
 140   TTYPE_TABLE
 141   N_TTYPES
 142 };
 143 #undef T
 144 #undef I
 145 #undef S
 146 #undef C
 147 #undef N
 148
 149 /* Payload of a NAME, NUMBER, FLOAT, STRING, or COMMENT token.  */
 150 struct cpp_name
 151 {
 152   unsigned int len;
 153   const unsigned char *text;
 154 };
 155
 156 /* Accessor macros for token lists - all expect you have a
 157    list and an index.  */
 158
 159 #define TOK_TYPE(l_, i_)   ((l_)->tokens[i_].type)
 160 #define TOK_FLAGS(l_, i_)  ((l_)->tokens[i_].flags)
 161 #define TOK_AUX(l_, i_)    ((l_)->tokens[i_].aux)
 162 #define TOK_COL(l_, i_)    ((l_)->tokens[i_].col)
 163 #define TOK_INT(l_, i_)    ((l_)->tokens[i_].val.integer)
 164 #define TOK_NAME(l_, i_)   ((l_)->tokens[i_].val.name.text)
 165 #define TOK_LEN(l_, i_)    ((l_)->tokens[i_].val.name.len)
 166
 167 #define TOK_PREV_WHITE(l_, i_) (TOK_FLAGS(l_, i_) & PREV_WHITESPACE)
 168
 169 /* Flags for the cpp_token structure.  */
 170 #define PREV_WHITESPACE     1   /* If whitespace before this token.  */
 171 #define DIGRAPH             2   /* If it was a digraph.  */
 172 #define UNSIGNED_INT        4   /* If int preprocessing token unsigned.  */
 173
 174 /* A preprocessing token.  This has been carefully packed and should
 175    occupy 16 bytes on both 32- and 64-bit hosts.  */
 176 struct cpp_token
 177 {
 178   unsigned short col;                   /* starting column of this token */
 179   ENUM_BITFIELD(cpp_ttype) type : CHAR_BIT;  /* node type */
 180   unsigned char flags;                  /* flags - see above */
 181   unsigned int aux;                     /* CPP_OTHER character.  Hash of a
 182                                            NAME, or something - see uses
 183                                            in the code */
 184   union
 185   {
 186     struct cpp_name name;               /* a string */
 187     HOST_WIDEST_INT integer;            /* an integer */
 188   } val;
 189 };
 190
 191 /* General flags.  */
 192 #define LIST_OFFSET    (1 << 0)
 193
 194 /* Directive flags.  */
 195 #define SYNTAX_INCLUDE (1 << 8)
 196
 197 typedef int (*directive_handler) PARAMS ((cpp_reader *));
 198
 199 struct cpp_toklist
 200 {
 201   cpp_token *tokens;            /* actual tokens as an array */
 202   unsigned int tokens_used;     /* tokens used */
 203   unsigned int tokens_cap;      /* tokens allocated */
 204
 205   unsigned char *namebuf;       /* names buffer */
 206   unsigned int name_used;       /* _bytes_ used */
 207   unsigned int name_cap;        /* _bytes_ allocated */
 208
 209   unsigned int line;            /* starting line number */
 210
 211   /* Comment copying.  */
 212   cpp_token *comments;          /* comment tokens.  */
 213   unsigned int comments_used;   /* comment tokens used.  */
 214   unsigned int comments_cap;    /* comment token capacity.  */
 215
 216   /* The handler to call after lexing the rest of this line.
 217      -1 for none */
 218   short dirno;
 219
 220   /* Per-list flags, see above */
 221   unsigned short flags;
 222 };
 223
 224 struct cpp_buffer
 225 {
 226   const unsigned char *cur;      /* current position */
 227   const unsigned char *rlimit; /* end of valid data */
 228   const unsigned char *buf;      /* entire buffer */
 229   const unsigned char *line_base; /* start of current line */
 230   const unsigned char *mark;  /* Saved position for lengthy backtrack. */
 231
 232   struct cpp_buffer *prev;
 233
 234   /* Filename specified with #line command.  */
 235   const char *nominal_fname;
 236   /* Actual directory of this file, used only for "" includes */
 237   struct file_name_list *actual_dir;
 238
 239   /* Pointer into the include hash table.  Used for include_next and
 240      to record control macros. */
 241   struct ihash *ihash;
 242
 243   /* If the buffer is the expansion of a macro, this points to the
 244      macro's hash table entry.  */
 245   struct hashnode *macro;
 246
 247   /* Value of if_stack at start of this file.
 248      Used to prohibit unmatched #endif (etc) in an include file.  */
 249   struct if_stack *if_stack;
 250
 251   /* Line number at line_base (above). */
 252   unsigned int lineno;
 253
 254   /* True if this is a header file included using <FILENAME>.  */
 255   char system_header_p;
 256
 257   /* True if buffer contains escape sequences.
 258      Currently there are two kinds:
 259      "\r-" means following identifier should not be macro-expanded.
 260      "\r " means a token-separator.  This turns into " " in final output
 261           if not stringizing and needed to separate tokens; otherwise nothing.
 262      Any other two-character sequence beginning with \r is an error.
 263
 264      If this is NOT set, then \r is a one-character escape meaning backslash
 265      newline.  This is guaranteed not to occur in the middle of a token.
 266      The two interpretations of \r do not conflict, because the two-character
 267      escapes are used only in macro buffers, and backslash-newline is removed
 268      from macro expansion text in collect_expansion and/or macarg.  */
 269   char has_escapes;
 270
 271   /* True if we have already warned about C++ comments in this file.
 272      The warning happens only for C89 extended mode with -pedantic on,
 273      or for -Wtraditional, and only once per file (otherwise it would
 274      be far too noisy).  */
 275   char warned_cplusplus_comments;
 276
 277   /* In a file buffer, true if this buffer's data is mmapped
 278      (currently never the case).  In a macro buffer, true if this
 279      buffer's data must be freed.  */
 280   char mapped;
 281 };
 282
 283 struct file_name_map_list;
 284 struct htab;
 285
 286 /* Maximum nesting of cpp_buffers.  We use a static limit, partly for
 287    efficiency, and partly to limit runaway recursion.  */
 288 #define CPP_STACK_MAX 200
 289
 290 /* Values for opts.dump_macros.
 291   dump_only means inhibit output of the preprocessed text
 292              and instead output the definitions of all user-defined
 293              macros in a form suitable for use as input to cpp.
 294    dump_names means pass #define and the macro name through to output.
 295    dump_definitions means pass the whole definition (plus #define) through
 296 */
 297 enum { dump_none = 0, dump_only, dump_names, dump_definitions };
 298
 299 /* This structure is nested inside struct cpp_reader, and
 300    carries all the options visible to the command line.  */
 301 struct cpp_options
 302 {
 303   /* Name of input and output files.  */
 304   const char *in_fname;
 305   const char *out_fname;
 306
 307   /* Characters between tab stops.  */
 308   unsigned int tabstop;
 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   /* Token column position adjustment owing to tabs in whitespace.  */
 519   unsigned int col_adjust;
 520
 521   /* Buffer of -M output.  */
 522   struct deps *deps;
 523
 524   /* A buffer used only by read_and_prescan (in cppfiles.c), which is
 525      allocated once per cpp_reader object to keep it off the stack.  */
 526   unsigned char *input_buffer;
 527   size_t input_buffer_len;
 528
 529   /* User visible options.  */
 530   struct cpp_options opts;
 531
 532   /* Nonzero means we have printed (while error reporting) a list of
 533      containing files that matches the current status.  */
 534   unsigned char input_stack_listing_current;
 535
 536   /* If non-zero, macros are not expanded.  */
 537   unsigned char no_macro_expand;
 538
 539   /* If non-zero, directives cause a hard error.  Used when parsing
 540      macro arguments.  */
 541   unsigned char no_directives;
 542
 543   /* We're printed a warning recommending against using #import.  */
 544   unsigned char import_warning;
 545
 546   /* If true, characters between '<' and '>' are a single (string) token.  */
 547   unsigned char parsing_include_directive;
 548
 549   /* True if escape sequences (as described for has_escapes in
 550      parse_buffer) should be emitted.  */
 551   unsigned char output_escapes;
 552
 553   /* 0: Have seen non-white-space on this line.
 554      1: Only seen white space so far on this line.
 555      2: Only seen white space so far in this file.  */
 556   unsigned char only_seen_white;
 557
 558   /* True after cpp_start_read completes.  Used to inhibit some
 559      warnings while parsing the command line.  */
 560   unsigned char done_initializing;
 561 };
 562
 563 /* struct cpp_printer encapsulates state used to convert the stream of
 564    tokens coming from cpp_get_token back into a text file.  Not
 565    everyone wants to do that, hence we separate the function.  */
 566
 567 struct cpp_printer
 568 {
 569   FILE *outf;                   /* stream to write to */
 570   const char *last_fname;       /* previous file name */
 571   unsigned int last_bsd;        /* did we just push? */
 572   unsigned int lineno;          /* line currently being written */
 573   unsigned int written;         /* low water mark in token buffer */
 574 };
 575
 576 #define CPP_FATAL_LIMIT 1000
 577 /* True if we have seen a "fatal" error. */
 578 #define CPP_FATAL_ERRORS(READER) ((READER)->errors >= CPP_FATAL_LIMIT)
 579
 580 /* Macros for manipulating the token_buffer. */
 581
 582 /* Number of characters currently in PFILE's output buffer. */
 583 #define CPP_WRITTEN(PFILE) ((size_t)((PFILE)->limit - (PFILE)->token_buffer))
 584 #define CPP_PWRITTEN(PFILE) ((PFILE)->limit)
 585 #define CPP_ADJUST_WRITTEN(PFILE,DELTA) ((PFILE)->limit += (DELTA))
 586 #define CPP_SET_WRITTEN(PFILE,N) ((PFILE)->limit = (PFILE)->token_buffer + (N))
 587
 588 #define CPP_OPTION(PFILE, OPTION) ((PFILE)->opts.OPTION)
 589 #define CPP_BUFFER(PFILE) ((PFILE)->buffer)
 590 #define CPP_BUF_LINE(BUF) ((BUF)->lineno)
 591 #define CPP_BUF_COLUMN(BUF, CUR) ((CUR) - (BUF)->line_base + pfile->col_adjust)
 592 #define CPP_BUF_COL(BUF) CPP_BUF_COLUMN(BUF, (BUF)->cur)
 593
 594 /* Name under which this program was invoked.  */
 595 extern const char *progname;
 596
 597 extern void _cpp_lex_file PARAMS((cpp_reader *));
 598 extern int cpp_handle_options PARAMS ((cpp_reader *, int, char **));
 599 extern enum cpp_ttype cpp_get_token PARAMS ((cpp_reader *));
 600 extern enum cpp_ttype cpp_get_non_space_token PARAMS ((cpp_reader *));
 601
 602 extern void cpp_reader_init PARAMS ((cpp_reader *));
 603 extern cpp_printer *cpp_printer_init PARAMS ((cpp_reader *, cpp_printer *));
 604 extern int cpp_start_read PARAMS ((cpp_reader *, cpp_printer *, const char *));
 605 extern void cpp_output_tokens PARAMS ((cpp_reader *, cpp_printer *));
 606 extern void cpp_output_list PARAMS ((cpp_reader *, cpp_printer *,
 607                                      const cpp_toklist *));
 608 extern void cpp_finish PARAMS ((cpp_reader *, cpp_printer *));
 609 extern void cpp_cleanup PARAMS ((cpp_reader *));
 610
 611 extern cpp_buffer *cpp_file_buffer PARAMS((cpp_reader *));
 612 extern void cpp_define PARAMS ((cpp_reader *, const char *));
 613 extern void cpp_assert PARAMS ((cpp_reader *, const char *));
 614 extern void cpp_undef  PARAMS ((cpp_reader *, const char *));
 615 extern void cpp_unassert PARAMS ((cpp_reader *, const char *));
 616
 617 extern void cpp_free_token_list PARAMS ((cpp_toklist *));
 618
 619 /* N.B. The error-message-printer prototypes have not been nicely
 620    formatted because exgettext needs to see 'msgid' on the same line
 621    as the name of the function in order to work properly.  Only the
 622    string argument gets a name in an effort to keep the lines from
 623    getting ridiculously oversized.  */
 624
 625 extern void cpp_ice PARAMS ((cpp_reader *, const char *msgid, ...))
 626   ATTRIBUTE_PRINTF_2;
 627 extern void cpp_fatal PARAMS ((cpp_reader *, const char *msgid, ...))
 628   ATTRIBUTE_PRINTF_2;
 629 extern void cpp_error PARAMS ((cpp_reader *, const char *msgid, ...))
 630   ATTRIBUTE_PRINTF_2;
 631 extern void cpp_warning PARAMS ((cpp_reader *, const char *msgid, ...))
 632   ATTRIBUTE_PRINTF_2;
 633 extern void cpp_pedwarn PARAMS ((cpp_reader *, const char *msgid, ...))
 634   ATTRIBUTE_PRINTF_2;
 635 extern void cpp_notice PARAMS ((cpp_reader *, const char *msgid, ...))
 636   ATTRIBUTE_PRINTF_2;
 637 extern void cpp_error_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...))
 638   ATTRIBUTE_PRINTF_4;
 639 extern void cpp_warning_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...))
 640   ATTRIBUTE_PRINTF_4;
 641 extern void cpp_pedwarn_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...))
 642   ATTRIBUTE_PRINTF_4;
 643 extern void cpp_pedwarn_with_file_and_line PARAMS ((cpp_reader *, const char *, int, int, const char *msgid, ...))
 644   ATTRIBUTE_PRINTF_5;
 645 extern void cpp_error_from_errno        PARAMS ((cpp_reader *, const char *));
 646 extern void cpp_notice_from_errno       PARAMS ((cpp_reader *, const char *));
 647
 648 /* In cpplex.c */
 649 extern cpp_buffer *cpp_push_buffer      PARAMS ((cpp_reader *,
 650                                                  const unsigned char *, long));
 651 extern cpp_buffer *cpp_pop_buffer       PARAMS ((cpp_reader *));
 652 extern void cpp_scan_buffer             PARAMS ((cpp_reader *, cpp_printer *));
 653 extern void cpp_scan_buffer_nooutput    PARAMS ((cpp_reader *));
 654 extern int cpp_idcmp                    PARAMS ((const unsigned char *,
 655                                                  size_t, const char *));
 656
 657 /* In cpphash.c */
 658 extern int cpp_defined                  PARAMS ((cpp_reader *,
 659                                                  const unsigned char *, int));
 660
 661 /* In cppfiles.c */
 662 extern int cpp_included                 PARAMS ((cpp_reader *, const char *));
 663 extern int cpp_read_file                PARAMS ((cpp_reader *, const char *));
 664
 665 #ifdef __cplusplus
 666 }
 667 #endif
 668 #endif /* __GCC_CPPLIB__ */