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 unsigned char U_CHAR;
  32
  33 typedef struct cpp_reader cpp_reader;
  34 typedef struct cpp_buffer cpp_buffer;
  35 typedef struct cpp_options cpp_options;
  36
  37 enum cpp_token {
  38   CPP_EOF = -1,
  39   CPP_OTHER = 0,
  40   CPP_COMMENT = 1,
  41   CPP_HSPACE,
  42   CPP_VSPACE, /* newlines and #line directives */
  43   CPP_NAME,
  44   CPP_NUMBER,
  45   CPP_CHAR,
  46   CPP_STRING,
  47   CPP_DIRECTIVE,
  48   CPP_LPAREN,   /* "(" */
  49   CPP_RPAREN,   /* ")" */
  50   CPP_LBRACE,   /* "{" */
  51   CPP_RBRACE,   /* "}" */
  52   CPP_COMMA,    /* "," */
  53   CPP_SEMICOLON,/* ";" */
  54   CPP_3DOTS,    /* "..." */
  55   CPP_POP       /* We're about to pop the buffer stack.  */
  56 };
  57
  58 typedef enum cpp_token (*parse_underflow_t) PARAMS((cpp_reader *));
  59 typedef int (*parse_cleanup_t) PARAMS((cpp_buffer *, cpp_reader *));
  60
  61 extern int cpp_handle_option PARAMS ((cpp_reader *, int, char **));
  62 extern int cpp_handle_options PARAMS ((cpp_reader *, int, char **));
  63 extern enum cpp_token cpp_get_token PARAMS ((cpp_reader *));
  64 extern enum cpp_token cpp_get_non_space_token PARAMS ((cpp_reader *));
  65 extern enum cpp_token get_directive_token PARAMS ((cpp_reader *));
  66
  67 /* This frees resources used by PFILE. */
  68 extern void cpp_cleanup PARAMS ((cpp_reader *PFILE));
  69
  70 struct cpp_buffer
  71 {
  72   unsigned char *cur;    /* current position */
  73   unsigned char *rlimit; /* end of valid data */
  74   unsigned char *buf;    /* entire buffer */
  75   unsigned char *alimit; /* end of allocated buffer */
  76   unsigned char *line_base; /* start of current line */
  77
  78   struct cpp_buffer *prev;
  79
  80   /* Real filename.  (Alias to ->ihash->fname, obsolete). */
  81   const char *fname;
  82   /* Filename specified with #line command.  */
  83   const char *nominal_fname;
  84   /* Last filename specified with #line command.  */
  85   const char *last_nominal_fname;
  86   /* Actual directory of this file, used only for "" includes */
  87   struct file_name_list *actual_dir;
  88
  89   /* Pointer into the include hash table.  Used for include_next and
  90      to record control macros. */
  91   struct include_hash *ihash;
  92
  93   long lineno; /* Line number at CPP_LINE_BASE. */
  94   long colno; /* Column number at CPP_LINE_BASE. */
  95   long mark;  /* Saved position for lengthy backtrack. */
  96   parse_underflow_t underflow;
  97   parse_cleanup_t cleanup;
  98   void *data;
  99
 100   /* Value of if_stack at start of this file.
 101      Used to prohibit unmatched #endif (etc) in an include file.  */
 102   struct if_stack *if_stack;
 103
 104   /* True if this is a header file included using <FILENAME>.  */
 105   char system_header_p;
 106   char seen_eof;
 107
 108   /* True if buffer contains escape sequences.
 109      Currently there are two kinds:
 110      "\r-" means following identifier should not be macro-expanded.
 111      "\r " means a token-separator.  This turns into " " in final output
 112           if not stringizing and needed to separate tokens; otherwise nothing.
 113      Any other two-character sequence beginning with \r is an error.
 114
 115      If this is NOT set, then \r is a one-character escape meaning backslash
 116      newline.  This is guaranteed not to occur in the middle of a token.
 117      The two interpretations of \r do not conflict, because the two-character
 118      escapes are used only in macro buffers, and backslash-newline is removed
 119      from macro expansion text in collect_expansion and/or macarg.  */
 120   char has_escapes;
 121
 122   /* Used by the C++ frontend to implement redirected input (such as for
 123      default argument and/or template parsing).  */
 124   char manual_pop;
 125
 126   /* True if we have already warned about C++ comments in this file.
 127      The warning happens only for C89 extended mode with -pedantic on,
 128      and only once per file (otherwise it would be far too noisy).  */
 129   char warned_cplusplus_comments;
 130 };
 131
 132 struct file_name_map_list;
 133
 134 /* Maximum nesting of cpp_buffers.  We use a static limit, partly for
 135    efficiency, and partly to limit runaway recursion.  */
 136 #define CPP_STACK_MAX 200
 137
 138 /* A cpp_reader encapsulates the "state" of a pre-processor run.
 139    Applying cpp_get_token repeatedly yields a stream of pre-processor
 140    tokens.  Usually, there is only one cpp_reader object active. */
 141
 142 struct cpp_reader
 143 {
 144   parse_underflow_t get_token;
 145   cpp_buffer *buffer;
 146   cpp_options *opts;
 147
 148   /* A buffer used for both for cpp_get_token's output, and also internally. */
 149   unsigned char *token_buffer;
 150   /* Allocated size of token_buffer.  CPP_RESERVE allocates space.  */
 151   unsigned int token_buffer_size;
 152   /* End of the written part of token_buffer. */
 153   unsigned char *limit;
 154
 155   /* Error counter for exit code */
 156   int errors;
 157
 158   /* Line where a newline was first seen in a string constant.  */
 159   int multiline_string_line;
 160
 161   /* Current depth in #include directives that use <...>.  */
 162   int system_include_depth;
 163
 164   /* Current depth of buffer stack. */
 165   int buffer_stack_depth;
 166
 167   /* Hash table of macros and assertions.  See cpphash.c */
 168 #define HASHSIZE 1403
 169   struct hashnode **hashtab;
 170
 171   /* Hash table of other included files.  See cppfiles.c */
 172 #define ALL_INCLUDE_HASHSIZE 71
 173   struct include_hash *all_include_files[ALL_INCLUDE_HASHSIZE];
 174
 175   /* Chain of `actual directory' file_name_list entries,
 176      for "" inclusion. */
 177   struct file_name_list *actual_dirs;
 178
 179   /* Current maximum length of directory names in the search path
 180      for include files.  (Altered as we get more of them.)  */
 181   unsigned int max_include_len;
 182
 183   struct if_stack *if_stack;
 184
 185   /* Nonzero means we have printed (while error reporting) a list of
 186      containing files that matches the current status. */
 187   char input_stack_listing_current;
 188
 189   /* If non-zero, macros are not expanded. */
 190   char no_macro_expand;
 191
 192   /* If non-zero, directives cause a hard error.  Used when parsing
 193      macro arguments.  */
 194
 195   char no_directives;
 196
 197   /* Print column number in error messages. */
 198   char show_column;
 199
 200   /* We're printed a warning recommending against using #import. */
 201   char import_warning;
 202
 203   /* If true, character between '<' and '>' are a single (string) token. */
 204   char parsing_include_directive;
 205
 206   /* True if escape sequences (as described for has_escapes in
 207      parse_buffer) should be emitted. */
 208   char output_escapes;
 209
 210   /* 0: Have seen non-white-space on this line.
 211      1: Only seen white space so far on this line.
 212      2: Only seen white space so far in this file. */
 213    char only_seen_white;
 214
 215   /* Nonzero means this file was included with a -imacros or -include
 216      command line and should not be recorded as an include file.  */
 217
 218   int no_record_file;
 219
 220   long lineno;
 221
 222   struct tm *timebuf;
 223
 224   /* Buffer of -M output.  */
 225   char *deps_buffer;
 226
 227   /* Number of bytes allocated in above.  */
 228   int deps_allocated_size;
 229
 230   /* Number of bytes used.  */
 231   int deps_size;
 232
 233   /* Number of bytes since the last newline.  */
 234   int deps_column;
 235
 236   /* A buffer and a table, used only by read_and_prescan (in cppfiles.c)
 237      which are allocated once per cpp_reader object to keep them off the
 238      stack and avoid setup costs.  */
 239   U_CHAR *input_buffer;
 240   U_CHAR *input_speccase;
 241   size_t input_buffer_len;
 242 };
 243
 244 #define CPP_FATAL_LIMIT 1000
 245 /* True if we have seen a "fatal" error. */
 246 #define CPP_FATAL_ERRORS(READER) ((READER)->errors >= CPP_FATAL_LIMIT)
 247
 248 #define CPP_BUF_PEEK(BUFFER) \
 249   ((BUFFER)->cur < (BUFFER)->rlimit ? *(BUFFER)->cur : EOF)
 250 #define CPP_BUF_GET(BUFFER) \
 251   ((BUFFER)->cur < (BUFFER)->rlimit ? *(BUFFER)->cur++ : EOF)
 252 #define CPP_FORWARD(BUFFER, N) ((BUFFER)->cur += (N))
 253
 254 /* Macros for manipulating the token_buffer. */
 255
 256 #define CPP_OUT_BUFFER(PFILE) ((PFILE)->token_buffer)
 257
 258 /* Number of characters currently in PFILE's output buffer. */
 259 #define CPP_WRITTEN(PFILE) ((size_t)((PFILE)->limit - (PFILE)->token_buffer))
 260 #define CPP_PWRITTEN(PFILE) ((PFILE)->limit)
 261
 262 /* Make sure PFILE->token_buffer has space for at least N more characters. */
 263 #define CPP_RESERVE(PFILE, N) \
 264   (CPP_WRITTEN (PFILE) + (size_t)(N) > (PFILE)->token_buffer_size \
 265    && (cpp_grow_buffer (PFILE, N), 0))
 266
 267 /* Append string STR (of length N) to PFILE's output buffer.
 268    Assume there is enough space. */
 269 #define CPP_PUTS_Q(PFILE, STR, N) \
 270   (memcpy ((PFILE)->limit, STR, (N)), (PFILE)->limit += (N))
 271 /* Append string STR (of length N) to PFILE's output buffer.  Make space. */
 272 #define CPP_PUTS(PFILE, STR, N) CPP_RESERVE(PFILE, N), CPP_PUTS_Q(PFILE, STR,N)
 273 /* Append character CH to PFILE's output buffer.  Assume sufficient space. */
 274 #define CPP_PUTC_Q(PFILE, CH) (*(PFILE)->limit++ = (CH))
 275 /* Append character CH to PFILE's output buffer.  Make space if need be. */
 276 #define CPP_PUTC(PFILE, CH) (CPP_RESERVE (PFILE, 1), CPP_PUTC_Q (PFILE, CH))
 277 /* Make sure PFILE->limit is followed by '\0'. */
 278 #define CPP_NUL_TERMINATE_Q(PFILE) (*(PFILE)->limit = 0)
 279 #define CPP_NUL_TERMINATE(PFILE) (CPP_RESERVE(PFILE, 1), *(PFILE)->limit = 0)
 280 #define CPP_ADJUST_WRITTEN(PFILE,DELTA) ((PFILE)->limit += (DELTA))
 281 #define CPP_SET_WRITTEN(PFILE,N) ((PFILE)->limit = (PFILE)->token_buffer + (N))
 282
 283 /* Advance the current line by one. */
 284 #define CPP_BUMP_BUFFER_LINE(PBUF) ((PBUF)->lineno++,\
 285                                     (PBUF)->line_base = (PBUF)->cur)
 286 #define CPP_BUMP_LINE(PFILE) CPP_BUMP_BUFFER_LINE(CPP_BUFFER(PFILE))
 287
 288 #define CPP_OPTIONS(PFILE) ((PFILE)->opts)
 289 #define CPP_BUFFER(PFILE) ((PFILE)->buffer)
 290 #define CPP_PREV_BUFFER(BUFFER) ((BUFFER)->prev)
 291 /* The bottom of the buffer stack. */
 292 #define CPP_NULL_BUFFER(PFILE) NULL
 293
 294 /* The `pending' structure accumulates all the options that are not
 295    actually processed until we hit cpp_start_read.  It consists of
 296    several lists, one for each type of option.  We keep both head and
 297    tail pointers for quick insertion. */
 298 struct cpp_pending
 299 {
 300   struct pending_option *define_head, *define_tail;
 301   struct pending_option *assert_head, *assert_tail;
 302
 303   struct file_name_list *quote_head, *quote_tail;
 304   struct file_name_list *brack_head, *brack_tail;
 305   struct file_name_list *systm_head, *systm_tail;
 306   struct file_name_list *after_head, *after_tail;
 307
 308   struct pending_option *imacros_head, *imacros_tail;
 309   struct pending_option *include_head, *include_tail;
 310 };
 311
 312 /* Pointed to by cpp_reader.opts. */
 313 struct cpp_options {
 314   char *in_fname;
 315
 316   /* Name of output file, for error messages.  */
 317   const char *out_fname;
 318
 319   struct file_name_map_list *map_list;
 320
 321   /* Non-0 means -v, so print the full set of include dirs.  */
 322   char verbose;
 323
 324   /* Nonzero means use extra default include directories for C++.  */
 325
 326   char cplusplus;
 327
 328   /* Nonzero means handle cplusplus style comments */
 329
 330   char cplusplus_comments;
 331
 332   /* Nonzero means handle #import, for objective C.  */
 333
 334   char objc;
 335
 336   /* Nonzero means this is an assembly file, so ignore unrecognized
 337      directives and the "# 33" form of #line, both of which are
 338      probably comments.  Also, permit unbalanced ' strings (again,
 339      likely to be in comments).  */
 340
 341   char lang_asm;
 342
 343   /* Nonzero means this is Fortran, and we don't know where the
 344      comments are, so permit unbalanced ' strings.  Unlike lang_asm,
 345      this does not ignore unrecognized directives.  */
 346
 347   char lang_fortran;
 348
 349   /* Nonzero means handle CHILL comment syntax
 350      and output CHILL string delimiter for __DATE___ etc. */
 351
 352   char chill;
 353
 354   /* Nonzero means don't copy comments into the output file.  */
 355
 356   char discard_comments;
 357
 358   /* Nonzero means process the ANSI trigraph sequences.  */
 359
 360   char trigraphs;
 361
 362   /* Nonzero means print the names of included files rather than
 363      the preprocessed output.  1 means just the #include "...",
 364      2 means #include <...> as well.  */
 365
 366   char print_deps;
 367
 368   /* Nonzero if missing .h files in -M output are assumed to be generated
 369      files and not errors.  */
 370
 371   char print_deps_missing_files;
 372
 373   /* If true, fopen (deps_file, "a") else fopen (deps_file, "w"). */
 374   char print_deps_append;
 375
 376   /* Nonzero means print names of header files (-H).  */
 377
 378   char print_include_names;
 379
 380   /* Nonzero means try to make failure to fit ANSI C an error.  */
 381
 382   char pedantic_errors;
 383
 384   /* Nonzero means don't print warning messages.  */
 385
 386   char inhibit_warnings;
 387
 388   /* Nonzero means don't print error messages.  Has no option to select it,
 389      but can be set by a user of cpplib (e.g. fix-header).  */
 390
 391   char inhibit_errors;
 392
 393   /* Nonzero means warn if slash-star appears in a comment.  */
 394
 395   char warn_comments;
 396
 397   /* Nonzero means warn if there are any trigraphs.  */
 398
 399   char warn_trigraphs;
 400
 401   /* Nonzero means warn if #import is used.  */
 402
 403   char warn_import;
 404
 405   /* Nonzero means warn if a macro argument is (or would be)
 406      stringified with -traditional.  */
 407
 408   char warn_stringify;
 409
 410   /* Nonzero means turn warnings into errors.  */
 411
 412   char warnings_are_errors;
 413
 414   /* Nonzero causes output not to be done,
 415      but directives such as #define that have side effects
 416      are still obeyed.  */
 417
 418   char no_output;
 419
 420   /* Nonzero means we should look for header.gcc files that remap file
 421      names.  */
 422   char remap;
 423
 424   /* Nonzero means don't output line number information.  */
 425
 426   char no_line_commands;
 427
 428 /* Nonzero means output the text in failing conditionals,
 429    inside #failed ... #endfailed.  */
 430
 431   char output_conditionals;
 432
 433   /* Nonzero means -I- has been seen,
 434      so don't look for #include "foo" the source-file directory.  */
 435   char ignore_srcdir;
 436
 437   /* Zero means dollar signs are punctuation.
 438      This used to be needed for conformance to the C Standard,
 439      before the C Standard was corrected.  */
 440   char dollars_in_ident;
 441
 442   /* Nonzero means try to imitate old fashioned non-ANSI preprocessor.  */
 443   char traditional;
 444
 445   /* Nonzero means warn if undefined identifiers are evaluated in an #if.  */
 446   char warn_undef;
 447
 448   /* Nonzero for the 1989 C Standard, including corrigenda and amendments.  */
 449   char c89;
 450
 451   /* Nonzero for the 1999 C Standard, including corrigenda and amendments.  */
 452   char c99;
 453
 454   /* Nonzero means give all the error messages the ANSI standard requires.  */
 455   char pedantic;
 456
 457   /* Nonzero means we're looking at already preprocessed code, so don't
 458      bother trying to do macro expansion and whatnot.  */
 459   char preprocessed;
 460
 461   char done_initializing;
 462
 463   /* Search paths for include files.  */
 464   struct file_name_list *quote_include;  /* First dir to search for "file" */
 465   struct file_name_list *bracket_include;/* First dir to search for <file> */
 466
 467   /* Directory prefix that should replace `/usr/lib/gcc-lib/TARGET/VERSION'
 468      in the standard include file directories.  */
 469   char *include_prefix;
 470   int include_prefix_len;
 471
 472   char no_standard_includes;
 473   char no_standard_cplusplus_includes;
 474
 475 /* dump_only means inhibit output of the preprocessed text
 476              and instead output the definitions of all user-defined
 477              macros in a form suitable for use as input to cccp.
 478    dump_names means pass #define and the macro name through to output.
 479    dump_definitions means pass the whole definition (plus #define) through
 480 */
 481
 482   enum {dump_none = 0, dump_only, dump_names, dump_definitions}
 483      dump_macros;
 484
 485 /* Nonzero means pass all #define and #undef directives which we actually
 486    process through to the output stream.  This feature is used primarily
 487    to allow cc1 to record the #defines and #undefs for the sake of
 488    debuggers which understand about preprocessor macros, but it may
 489    also be useful with -E to figure out how symbols are defined, and
 490    where they are defined.  */
 491   int debug_output;
 492
 493   /* Nonzero means pass #include lines through to the output,
 494      even if they are ifdefed out.  */
 495   int dump_includes;
 496
 497   /* Pending options - -D, -U, -A, -I, -ixxx. */
 498   struct cpp_pending *pending;
 499
 500   /* File name which deps are being written to.
 501      This is 0 if deps are being written to stdout.  */
 502   char *deps_file;
 503
 504   /* Target-name to write with the dependency information.  */
 505   char *deps_target;
 506 };
 507
 508 #define CPP_TRADITIONAL(PFILE) (CPP_OPTIONS(PFILE)-> traditional)
 509 #define CPP_WARN_UNDEF(PFILE) (CPP_OPTIONS(PFILE)->warn_undef)
 510 #define CPP_C89(PFILE) (CPP_OPTIONS(PFILE)->c89)
 511 #define CPP_PEDANTIC(PFILE) (CPP_OPTIONS (PFILE)->pedantic)
 512 #define CPP_PREPROCESSED(PFILE) (CPP_OPTIONS (PFILE)->preprocessed)
 513 #define CPP_PRINT_DEPS(PFILE) (CPP_OPTIONS (PFILE)->print_deps)
 514
 515 /* List of directories to look for include files in. */
 516 struct file_name_list
 517 {
 518   struct file_name_list *next;
 519   struct file_name_list *alloc; /* for the cache of
 520                                    current directory entries */
 521   char *name;
 522   unsigned int nlen;
 523   /* We use these to tell if the directory mentioned here is a duplicate
 524      of an earlier directory on the search path. */
 525   ino_t ino;
 526   dev_t dev;
 527   /* If the following is nonzero, it is a C-language system include
 528      directory.  */
 529   int sysp;
 530   /* Mapping of file names for this directory.
 531      Only used on MS-DOS and related platforms. */
 532   struct file_name_map *name_map;
 533 };
 534 #define ABSOLUTE_PATH ((struct file_name_list *)-1)
 535
 536 /* This structure is used for the table of all includes.  It is
 537    indexed by the `short name' (the name as it appeared in the
 538    #include statement) which is stored in *nshort.  */
 539 struct include_hash
 540 {
 541   struct include_hash *next;
 542   /* Next file with the same short name but a
 543      different (partial) pathname). */
 544   struct include_hash *next_this_file;
 545
 546   /* Location of the file in the include search path.
 547      Used for include_next */
 548   struct file_name_list *foundhere;
 549   const char *name;             /* (partial) pathname of file */
 550   const char *nshort;           /* name of file as referenced in #include */
 551   const char *control_macro;    /* macro, if any, preventing reinclusion -
 552                                    see redundant_include_p */
 553   char *buf, *limit;            /* for file content cache,
 554                                    not yet implemented */
 555 };
 556
 557 /* Name under which this program was invoked.  */
 558
 559 extern const char *progname;
 560
 561 /* The structure of a node in the hash table.  The hash table
 562    has entries for all tokens defined by #define commands (type T_MACRO),
 563    plus some special tokens like __LINE__ (these each have their own
 564    type, and the appropriate code is run when that type of node is seen.
 565    It does not contain control words like "#define", which are recognized
 566    by a separate piece of code. */
 567
 568 /* different flavors of hash nodes --- also used in keyword table */
 569 enum node_type {
 570  T_DEFINE = 1,  /* the `#define' keyword */
 571  T_INCLUDE,     /* the `#include' keyword */
 572  T_INCLUDE_NEXT, /* the `#include_next' keyword */
 573  T_IMPORT,      /* the `#import' keyword */
 574  T_IFDEF,       /* the `#ifdef' keyword */
 575  T_IFNDEF,      /* the `#ifndef' keyword */
 576  T_IF,          /* the `#if' keyword */
 577  T_ELSE,        /* `#else' */
 578  T_PRAGMA,      /* `#pragma' */
 579  T_ELIF,        /* `#elif' */
 580  T_UNDEF,       /* `#undef' */
 581  T_LINE,        /* `#line' */
 582  T_ERROR,       /* `#error' */
 583  T_WARNING,     /* `#warning' */
 584  T_ENDIF,       /* `#endif' */
 585  T_SCCS,        /* `#sccs', used on system V.  */
 586  T_IDENT,       /* `#ident', used on system V.  */
 587  T_ASSERT,      /* `#assert', taken from system V.  */
 588  T_UNASSERT,    /* `#unassert', taken from system V.  */
 589  T_SPECLINE,    /* special symbol `__LINE__' */
 590  T_DATE,        /* `__DATE__' */
 591  T_FILE,        /* `__FILE__' */
 592  T_BASE_FILE,   /* `__BASE_FILE__' */
 593  T_INCLUDE_LEVEL, /* `__INCLUDE_LEVEL__' */
 594  T_VERSION,     /* `__VERSION__' */
 595  T_TIME,        /* `__TIME__' */
 596  T_STDC,        /* `__STDC__' */
 597  T_CONST,       /* Constant string, used by `__SIZE_TYPE__' etc */
 598  T_MACRO,       /* macro defined by `#define' */
 599  T_DISABLED,    /* macro temporarily turned off for rescan */
 600  T_POISON,      /* defined with `#pragma poison' */
 601  T_UNUSED       /* Used for something not defined.  */
 602  };
 603
 604 /* Character classes.
 605    If the definition of `numchar' looks odd to you, please look up the
 606    definition of a pp-number in the C standard [section 6.4.8 of C99] */
 607 #define ISidnum         0x01    /* a-zA-Z0-9_ */
 608 #define ISidstart       0x02    /* _a-zA-Z */
 609 #define ISnumstart      0x04    /* 0-9 */
 610 #define IShspace        0x08    /* ' ' \t \f \v */
 611 #define ISspace         0x10    /* ' ' \t \f \v \n */
 612
 613 #define is_idchar(x)    (IStable[x] & ISidnum)
 614 #define is_numchar(x)   (IStable[x] & ISidnum)
 615 #define is_idstart(x)   (IStable[x] & ISidstart)
 616 #define is_numstart(x)  (IStable[x] & ISnumstart)
 617 #define is_hspace(x)    (IStable[x] & IShspace)
 618 #define is_space(x)     (IStable[x] & ISspace)
 619
 620 /* This table is not really `const', but it is only modified at
 621    initialization time, in a separate translation unit from the rest
 622    of the library.  We let the rest of the library think it is `const'
 623    to get better code and some additional compile-time checks.  */
 624 #ifndef FAKE_CONST
 625 #define FAKE_CONST const
 626 #endif
 627 extern FAKE_CONST unsigned char IStable[256];
 628 #undef FAKE_CONST
 629
 630 /* Stack of conditionals currently in progress
 631    (including both successful and failing conditionals).  */
 632
 633 struct if_stack {
 634   struct if_stack *next;        /* for chaining to the next stack frame */
 635   const char *fname;            /* copied from input when frame is made */
 636   int lineno;                   /* similarly */
 637   int if_succeeded;             /* true if a leg of this if-group
 638                                     has been passed through rescan */
 639   unsigned char *control_macro; /* For #ifndef at start of file,
 640                                    this is the macro name tested.  */
 641   enum node_type type;          /* type of last directive seen in this group */
 642 };
 643 typedef struct if_stack IF_STACK_FRAME;
 644
 645 extern void cpp_buf_line_and_col PARAMS((cpp_buffer *, long *, long *));
 646 extern cpp_buffer* cpp_file_buffer PARAMS((cpp_reader *));
 647 extern void cpp_define PARAMS ((cpp_reader *, unsigned char *));
 648 extern void cpp_assert PARAMS ((cpp_reader *, unsigned char *));
 649 extern void cpp_undef  PARAMS ((cpp_reader *, unsigned char *));
 650 extern void cpp_unassert PARAMS ((cpp_reader *, unsigned char *));
 651
 652 /* N.B. The error-message-printer prototypes have not been nicely
 653    formatted because exgettext needs to see 'msgid' on the same line
 654    as the name of the function in order to work properly.  Only the
 655    string argument gets a name in an effort to keep the lines from
 656    getting ridiculously oversized.  */
 657
 658 extern void cpp_ice PARAMS ((cpp_reader *, const char *msgid, ...))
 659   ATTRIBUTE_PRINTF_2;
 660 extern void cpp_fatal PARAMS ((cpp_reader *, const char *msgid, ...))
 661   ATTRIBUTE_PRINTF_2;
 662 extern void cpp_error PARAMS ((cpp_reader *, const char *msgid, ...))
 663   ATTRIBUTE_PRINTF_2;
 664 extern void cpp_warning PARAMS ((cpp_reader *, const char *msgid, ...))
 665   ATTRIBUTE_PRINTF_2;
 666 extern void cpp_pedwarn PARAMS ((cpp_reader *, const char *msgid, ...))
 667   ATTRIBUTE_PRINTF_2;
 668 extern void cpp_notice PARAMS ((cpp_reader *, const char *msgid, ...))
 669   ATTRIBUTE_PRINTF_2;
 670 extern void cpp_error_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...))
 671   ATTRIBUTE_PRINTF_4;
 672 extern void cpp_warning_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...))
 673   ATTRIBUTE_PRINTF_4;
 674 extern void cpp_pedwarn_with_line PARAMS ((cpp_reader *, int, int, const char *msgid, ...))
 675   ATTRIBUTE_PRINTF_4;
 676 extern void cpp_pedwarn_with_file_and_line PARAMS ((cpp_reader *, const char *, int, int, const char *msgid, ...))
 677   ATTRIBUTE_PRINTF_5;
 678 extern void cpp_error_from_errno PARAMS ((cpp_reader *, const char *));
 679 extern void cpp_notice_from_errno PARAMS ((cpp_reader *, const char *));
 680
 681 extern void cpp_grow_buffer PARAMS ((cpp_reader *, long));
 682 extern cpp_buffer *cpp_push_buffer PARAMS ((cpp_reader *,
 683                                             unsigned char *, long));
 684 extern cpp_buffer *cpp_pop_buffer PARAMS ((cpp_reader *));
 685 extern int cpp_defined PARAMS ((cpp_reader *, const U_CHAR *, int));
 686
 687 extern void cpp_reader_init PARAMS ((cpp_reader *));
 688 extern void cpp_options_init PARAMS ((cpp_options *));
 689 extern int cpp_start_read PARAMS ((cpp_reader *, char *));
 690 extern int cpp_read_check_assertion PARAMS ((cpp_reader *));
 691 extern void cpp_finish PARAMS ((cpp_reader *));
 692
 693 extern void quote_string                PARAMS ((cpp_reader *, const char *));
 694 extern void cpp_expand_to_buffer        PARAMS ((cpp_reader *, const U_CHAR *,
 695                                                  int));
 696 extern void cpp_scan_buffer             PARAMS ((cpp_reader *));
 697 extern int check_macro_name             PARAMS ((cpp_reader *, const U_CHAR *));
 698
 699 /* Last arg to output_line_command.  */
 700 enum file_change_code {same_file, enter_file, leave_file};
 701 extern void output_line_command         PARAMS ((cpp_reader *,
 702                                                  enum file_change_code));
 703
 704 /* In cppfiles.c */
 705 extern void simplify_pathname           PARAMS ((char *));
 706 extern void merge_include_chains        PARAMS ((struct cpp_options *));
 707 extern int find_include_file            PARAMS ((cpp_reader *, const char *,
 708                                                 struct file_name_list *,
 709                                                 struct include_hash **,
 710                                                 int *));
 711 extern int finclude                     PARAMS ((cpp_reader *, int,
 712                                                 struct include_hash *));
 713 extern void deps_output                 PARAMS ((cpp_reader *,
 714                                                 const char *, int));
 715 extern struct include_hash *include_hash PARAMS ((cpp_reader *, const char *, int));
 716
 717 #ifdef __cplusplus
 718 }
 719 #endif
 720 #endif /* __GCC_CPPLIB__ */