gcc/c-common.h

   1 /* Definitions for c-common.c.
   2    Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
   3    1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify it under
   8 the terms of the GNU General Public License as published by the Free
   9 Software Foundation; either version 2, or (at your option) any later
  10 version.
  11
  12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GCC; see the file COPYING.  If not, write to the Free
  19 Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
  20 02110-1301, USA.  */
  21
  22 #ifndef GCC_C_COMMON_H
  23 #define GCC_C_COMMON_H
  24
  25 #include "splay-tree.h"
  26 #include "cpplib.h"
  27 #include "ggc.h"
  28
  29 /* Usage of TREE_LANG_FLAG_?:
  30    0: TREE_NEGATED_INT (in INTEGER_CST).
  31       IDENTIFIER_MARKED (used by search routines).
  32       DECL_PRETTY_FUNCTION_P (in VAR_DECL)
  33    1: C_DECLARED_LABEL_FLAG (in LABEL_DECL)
  34       STATEMENT_LIST_STMT_EXPR (in STATEMENT_LIST)
  35    2: unused
  36    3: STATEMENT_LIST_HAS_LABEL (in STATEMENT_LIST)
  37    4: unused
  38 */
  39
  40 /* Reserved identifiers.  This is the union of all the keywords for C,
  41    C++, and Objective-C.  All the type modifiers have to be in one
  42    block at the beginning, because they are used as mask bits.  There
  43    are 27 type modifiers; if we add many more we will have to redesign
  44    the mask mechanism.  */
  45
  46 enum rid
  47 {
  48   /* Modifiers: */
  49   /* C, in empirical order of frequency.  */
  50   RID_STATIC = 0,
  51   RID_UNSIGNED, RID_LONG,    RID_CONST, RID_EXTERN,
  52   RID_REGISTER, RID_TYPEDEF, RID_SHORT, RID_INLINE,
  53   RID_VOLATILE, RID_SIGNED,  RID_AUTO,  RID_RESTRICT,
  54
  55   /* C extensions */
  56   RID_COMPLEX, RID_THREAD,
  57
  58   /* C++ */
  59   RID_FRIEND, RID_VIRTUAL, RID_EXPLICIT, RID_EXPORT, RID_MUTABLE,
  60
  61   /* ObjC */
  62   RID_IN, RID_OUT, RID_INOUT, RID_BYCOPY, RID_BYREF, RID_ONEWAY,
  63
  64   /* C */
  65   RID_INT,     RID_CHAR,   RID_FLOAT,    RID_DOUBLE, RID_VOID,
  66   RID_ENUM,    RID_STRUCT, RID_UNION,    RID_IF,     RID_ELSE,
  67   RID_WHILE,   RID_DO,     RID_FOR,      RID_SWITCH, RID_CASE,
  68   RID_DEFAULT, RID_BREAK,  RID_CONTINUE, RID_RETURN, RID_GOTO,
  69   RID_SIZEOF,
  70
  71   /* C extensions */
  72   RID_ASM,       RID_TYPEOF,   RID_ALIGNOF,  RID_ATTRIBUTE,  RID_VA_ARG,
  73   RID_EXTENSION, RID_IMAGPART, RID_REALPART, RID_LABEL,      RID_CHOOSE_EXPR,
  74   RID_TYPES_COMPATIBLE_P,
  75   RID_DFLOAT32, RID_DFLOAT64, RID_DFLOAT128,
  76
  77   /* Too many ways of getting the name of a function as a string */
  78   RID_FUNCTION_NAME, RID_PRETTY_FUNCTION_NAME, RID_C99_FUNCTION_NAME,
  79
  80   /* C++ */
  81   RID_BOOL,     RID_WCHAR,    RID_CLASS,
  82   RID_PUBLIC,   RID_PRIVATE,  RID_PROTECTED,
  83   RID_TEMPLATE, RID_NULL,     RID_CATCH,
  84   RID_DELETE,   RID_FALSE,    RID_NAMESPACE,
  85   RID_NEW,      RID_OFFSETOF, RID_OPERATOR,
  86   RID_THIS,     RID_THROW,    RID_TRUE,
  87   RID_TRY,      RID_TYPENAME, RID_TYPEID,
  88   RID_USING,
  89
  90   /* casts */
  91   RID_CONSTCAST, RID_DYNCAST, RID_REINTCAST, RID_STATCAST,
  92
  93   /* C++0x */
  94   RID_STATIC_ASSERT,
  95
  96   /* Objective-C */
  97   RID_AT_ENCODE,   RID_AT_END,
  98   RID_AT_CLASS,    RID_AT_ALIAS,     RID_AT_DEFS,
  99   RID_AT_PRIVATE,  RID_AT_PROTECTED, RID_AT_PUBLIC,
 100   RID_AT_PROTOCOL, RID_AT_SELECTOR,
 101   RID_AT_THROW,    RID_AT_TRY,       RID_AT_CATCH,
 102   RID_AT_FINALLY,  RID_AT_SYNCHRONIZED,
 103   RID_AT_INTERFACE,
 104   RID_AT_IMPLEMENTATION,
 105
 106   RID_MAX,
 107
 108   RID_FIRST_MODIFIER = RID_STATIC,
 109   RID_LAST_MODIFIER = RID_ONEWAY,
 110
 111   RID_FIRST_AT = RID_AT_ENCODE,
 112   RID_LAST_AT = RID_AT_IMPLEMENTATION,
 113   RID_FIRST_PQ = RID_IN,
 114   RID_LAST_PQ = RID_ONEWAY
 115 };
 116
 117 #define OBJC_IS_AT_KEYWORD(rid) \
 118   ((unsigned int) (rid) >= (unsigned int) RID_FIRST_AT && \
 119    (unsigned int) (rid) <= (unsigned int) RID_LAST_AT)
 120
 121 #define OBJC_IS_PQ_KEYWORD(rid) \
 122   ((unsigned int) (rid) >= (unsigned int) RID_FIRST_PQ && \
 123    (unsigned int) (rid) <= (unsigned int) RID_LAST_PQ)
 124
 125 /* The elements of `ridpointers' are identifier nodes for the reserved
 126    type names and storage classes.  It is indexed by a RID_... value.  */
 127 extern GTY ((length ("(int) RID_MAX"))) tree *ridpointers;
 128
 129 /* Standard named or nameless data types of the C compiler.  */
 130
 131 enum c_tree_index
 132 {
 133     CTI_WCHAR_TYPE,
 134     CTI_SIGNED_WCHAR_TYPE,
 135     CTI_UNSIGNED_WCHAR_TYPE,
 136     CTI_WINT_TYPE,
 137     CTI_SIGNED_SIZE_TYPE, /* For format checking only.  */
 138     CTI_UNSIGNED_PTRDIFF_TYPE, /* For format checking only.  */
 139     CTI_INTMAX_TYPE,
 140     CTI_UINTMAX_TYPE,
 141     CTI_WIDEST_INT_LIT_TYPE,
 142     CTI_WIDEST_UINT_LIT_TYPE,
 143
 144     CTI_CHAR_ARRAY_TYPE,
 145     CTI_WCHAR_ARRAY_TYPE,
 146     CTI_INT_ARRAY_TYPE,
 147     CTI_STRING_TYPE,
 148     CTI_CONST_STRING_TYPE,
 149
 150     /* Type for boolean expressions (bool in C++, int in C).  */
 151     CTI_TRUTHVALUE_TYPE,
 152     CTI_TRUTHVALUE_TRUE,
 153     CTI_TRUTHVALUE_FALSE,
 154
 155     CTI_DEFAULT_FUNCTION_TYPE,
 156
 157     /* These are not types, but we have to look them up all the time.  */
 158     CTI_FUNCTION_NAME_DECL,
 159     CTI_PRETTY_FUNCTION_NAME_DECL,
 160     CTI_C99_FUNCTION_NAME_DECL,
 161     CTI_SAVED_FUNCTION_NAME_DECLS,
 162
 163     CTI_VOID_ZERO,
 164
 165     CTI_NULL,
 166
 167     CTI_MAX
 168 };
 169
 170 #define C_RID_CODE(id)  (((struct c_common_identifier *) (id))->node.rid_code)
 171
 172 /* Identifier part common to the C front ends.  Inherits from
 173    tree_identifier, despite appearances.  */
 174 struct c_common_identifier GTY(())
 175 {
 176   struct tree_common common;
 177   struct cpp_hashnode node;
 178 };
 179
 180 #define wchar_type_node                 c_global_trees[CTI_WCHAR_TYPE]
 181 #define signed_wchar_type_node          c_global_trees[CTI_SIGNED_WCHAR_TYPE]
 182 #define unsigned_wchar_type_node        c_global_trees[CTI_UNSIGNED_WCHAR_TYPE]
 183 #define wint_type_node                  c_global_trees[CTI_WINT_TYPE]
 184 #define signed_size_type_node           c_global_trees[CTI_SIGNED_SIZE_TYPE]
 185 #define unsigned_ptrdiff_type_node      c_global_trees[CTI_UNSIGNED_PTRDIFF_TYPE]
 186 #define intmax_type_node                c_global_trees[CTI_INTMAX_TYPE]
 187 #define uintmax_type_node               c_global_trees[CTI_UINTMAX_TYPE]
 188 #define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
 189 #define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
 190
 191 #define truthvalue_type_node            c_global_trees[CTI_TRUTHVALUE_TYPE]
 192 #define truthvalue_true_node            c_global_trees[CTI_TRUTHVALUE_TRUE]
 193 #define truthvalue_false_node           c_global_trees[CTI_TRUTHVALUE_FALSE]
 194
 195 #define char_array_type_node            c_global_trees[CTI_CHAR_ARRAY_TYPE]
 196 #define wchar_array_type_node           c_global_trees[CTI_WCHAR_ARRAY_TYPE]
 197 #define int_array_type_node             c_global_trees[CTI_INT_ARRAY_TYPE]
 198 #define string_type_node                c_global_trees[CTI_STRING_TYPE]
 199 #define const_string_type_node          c_global_trees[CTI_CONST_STRING_TYPE]
 200
 201 #define default_function_type           c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
 202
 203 #define function_name_decl_node         c_global_trees[CTI_FUNCTION_NAME_DECL]
 204 #define pretty_function_name_decl_node  c_global_trees[CTI_PRETTY_FUNCTION_NAME_DECL]
 205 #define c99_function_name_decl_node             c_global_trees[CTI_C99_FUNCTION_NAME_DECL]
 206 #define saved_function_name_decls       c_global_trees[CTI_SAVED_FUNCTION_NAME_DECLS]
 207
 208 /* A node for `((void) 0)'.  */
 209 #define void_zero_node                  c_global_trees[CTI_VOID_ZERO]
 210
 211 /* The node for C++ `__null'.  */
 212 #define null_node                       c_global_trees[CTI_NULL]
 213
 214 extern GTY(()) tree c_global_trees[CTI_MAX];
 215
 216 /* In a RECORD_TYPE, a sorted array of the fields of the type, not a
 217    tree for size reasons.  */
 218 struct sorted_fields_type GTY(())
 219 {
 220   int len;
 221   tree GTY((length ("%h.len"))) elts[1];
 222 };
 223
 224 /* Mark which labels are explicitly declared.
 225    These may be shadowed, and may be referenced from nested functions.  */
 226 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
 227
 228 typedef enum c_language_kind
 229 {
 230   clk_c         = 0,            /* C90, C94 or C99 */
 231   clk_objc      = 1,            /* clk_c with ObjC features.  */
 232   clk_cxx       = 2,            /* ANSI/ISO C++ */
 233   clk_objcxx    = 3             /* clk_cxx with ObjC features.  */
 234 }
 235 c_language_kind;
 236
 237 /* To test for a specific language use c_language, defined by each
 238    front end.  For "ObjC features" or "not C++" use the macros.  */
 239 extern c_language_kind c_language;
 240
 241 #define c_dialect_cxx()         (c_language & clk_cxx)
 242 #define c_dialect_objc()        (c_language & clk_objc)
 243
 244 /* Information about a statement tree.  */
 245
 246 struct stmt_tree_s GTY(()) {
 247   /* The current statement list being collected.  */
 248   tree x_cur_stmt_list;
 249
 250   /* In C++, Nonzero if we should treat statements as full
 251      expressions.  In particular, this variable is no-zero if at the
 252      end of a statement we should destroy any temporaries created
 253      during that statement.  Similarly, if, at the end of a block, we
 254      should destroy any local variables in this block.  Normally, this
 255      variable is nonzero, since those are the normal semantics of
 256      C++.
 257
 258      However, in order to represent aggregate initialization code as
 259      tree structure, we use statement-expressions.  The statements
 260      within the statement expression should not result in cleanups
 261      being run until the entire enclosing statement is complete.
 262
 263      This flag has no effect in C.  */
 264   int stmts_are_full_exprs_p;
 265 };
 266
 267 typedef struct stmt_tree_s *stmt_tree;
 268
 269 /* Global state pertinent to the current function.  Some C dialects
 270    extend this structure with additional fields.  */
 271
 272 struct c_language_function GTY(()) {
 273   /* While we are parsing the function, this contains information
 274      about the statement-tree that we are building.  */
 275   struct stmt_tree_s x_stmt_tree;
 276 };
 277
 278 /* When building a statement-tree, this is the current statement list
 279    being collected.  It's TREE_CHAIN is a back-pointer to the previous
 280    statement list.  */
 281
 282 #define cur_stmt_list (current_stmt_tree ()->x_cur_stmt_list)
 283
 284 /* Language-specific hooks.  */
 285
 286 /* Callback that determines if it's ok for a function to have no
 287    noreturn attribute.  */
 288 extern int (*lang_missing_noreturn_ok_p) (tree);
 289
 290 /* If non-NULL, this function is called after a precompile header file
 291    is loaded.  */
 292 extern void (*lang_post_pch_load) (void);
 293
 294 extern void push_file_scope (void);
 295 extern void pop_file_scope (void);
 296 extern stmt_tree current_stmt_tree (void);
 297 extern tree push_stmt_list (void);
 298 extern tree pop_stmt_list (tree);
 299 extern tree add_stmt (tree);
 300 extern void push_cleanup (tree, tree, bool);
 301 extern tree pushdecl_top_level (tree);
 302 extern tree pushdecl (tree);
 303 extern tree build_modify_expr (tree, enum tree_code, tree);
 304 extern tree build_indirect_ref (tree, const char *);
 305
 306 extern int c_expand_decl (tree);
 307
 308 extern int field_decl_cmp (const void *, const void *);
 309 extern void resort_sorted_fields (void *, void *, gt_pointer_operator,
 310                                   void *);
 311 extern bool has_c_linkage (tree decl);
 312 \f
 313 /* Switches common to the C front ends.  */
 314
 315 /* Nonzero if prepreprocessing only.  */
 316
 317 extern int flag_preprocess_only;
 318
 319 /* Zero means that faster, ...NonNil variants of objc_msgSend...
 320    calls will be used in ObjC; passing nil receivers to such calls
 321    will most likely result in crashes.  */
 322 extern int flag_nil_receivers;
 323
 324 /* Nonzero means that we will allow new ObjC exception syntax (@throw,
 325    @try, etc.) in source code.  */
 326 extern int flag_objc_exceptions;
 327
 328 /* Nonzero means that we generate NeXT setjmp based exceptions.  */
 329 extern int flag_objc_sjlj_exceptions;
 330
 331 /* Nonzero means that code generation will be altered to support
 332    "zero-link" execution.  This currently affects ObjC only, but may
 333    affect other languages in the future.  */
 334 extern int flag_zero_link;
 335
 336 /* Nonzero means emit an '__OBJC, __image_info' for the current translation
 337    unit.  It will inform the ObjC runtime that class definition(s) herein
 338    contained are to replace one(s) previously loaded.  */
 339 extern int flag_replace_objc_classes;
 340
 341 /* Nonzero means don't output line number information.  */
 342
 343 extern char flag_no_line_commands;
 344
 345 /* Nonzero causes -E output not to be done, but directives such as
 346    #define that have side effects are still obeyed.  */
 347
 348 extern char flag_no_output;
 349
 350 /* Nonzero means dump macros in some fashion; contains the 'D', 'M' or
 351    'N' of the command line switch.  */
 352
 353 extern char flag_dump_macros;
 354
 355 /* Nonzero means pass #include lines through to the output.  */
 356
 357 extern char flag_dump_includes;
 358
 359 /* Nonzero means process PCH files while preprocessing.  */
 360
 361 extern bool flag_pch_preprocess;
 362
 363 /* The file name to which we should write a precompiled header, or
 364    NULL if no header will be written in this compile.  */
 365
 366 extern const char *pch_file;
 367
 368 /* Nonzero if an ISO standard was selected.  It rejects macros in the
 369    user's namespace.  */
 370
 371 extern int flag_iso;
 372
 373 /* Nonzero if -undef was given.  It suppresses target built-in macros
 374    and assertions.  */
 375
 376 extern int flag_undef;
 377
 378 /* Nonzero means don't recognize the non-ANSI builtin functions.  */
 379
 380 extern int flag_no_builtin;
 381
 382 /* Nonzero means don't recognize the non-ANSI builtin functions.
 383    -ansi sets this.  */
 384
 385 extern int flag_no_nonansi_builtin;
 386
 387 /* Nonzero means give `double' the same size as `float'.  */
 388
 389 extern int flag_short_double;
 390
 391 /* Nonzero means give `wchar_t' the same size as `short'.  */
 392
 393 extern int flag_short_wchar;
 394
 395 /* Nonzero means allow implicit conversions between vectors with
 396    differing numbers of subparts and/or differing element types.  */
 397 extern int flag_lax_vector_conversions;
 398
 399 /* Nonzero means allow Microsoft extensions without warnings or errors.  */
 400 extern int flag_ms_extensions;
 401
 402 /* Nonzero means don't recognize the keyword `asm'.  */
 403
 404 extern int flag_no_asm;
 405
 406 /* Nonzero means give string constants the type `const char *', as mandated
 407    by the standard.  */
 408
 409 extern int flag_const_strings;
 410
 411 /* Nonzero means to treat bitfields as signed unless they say `unsigned'.  */
 412
 413 extern int flag_signed_bitfields;
 414
 415 /* Warn about #pragma directives that are not recognized.  */
 416
 417 extern int warn_unknown_pragmas; /* Tri state variable.  */
 418
 419 /* Warn about format/argument anomalies in calls to formatted I/O functions
 420    (*printf, *scanf, strftime, strfmon, etc.).  */
 421
 422 extern int warn_format;
 423
 424
 425 /* C/ObjC language option variables.  */
 426
 427
 428 /* Nonzero means allow type mismatches in conditional expressions;
 429    just make their values `void'.  */
 430
 431 extern int flag_cond_mismatch;
 432
 433 /* Nonzero means enable C89 Amendment 1 features.  */
 434
 435 extern int flag_isoc94;
 436
 437 /* Nonzero means use the ISO C99 dialect of C.  */
 438
 439 extern int flag_isoc99;
 440
 441 /* Nonzero means that we have builtin functions, and main is an int.  */
 442
 443 extern int flag_hosted;
 444
 445 /* Warn if main is suspicious.  */
 446
 447 extern int warn_main;
 448
 449
 450 /* ObjC language option variables.  */
 451
 452
 453 /* Open and close the file for outputting class declarations, if
 454    requested (ObjC).  */
 455
 456 extern int flag_gen_declaration;
 457
 458 /* Tells the compiler that this is a special run.  Do not perform any
 459    compiling, instead we are to test some platform dependent features
 460    and output a C header file with appropriate definitions.  */
 461
 462 extern int print_struct_values;
 463
 464 /* ???.  Undocumented.  */
 465
 466 extern const char *constant_string_class_name;
 467
 468
 469 /* C++ language option variables.  */
 470
 471
 472 /* Nonzero means don't recognize any extension keywords.  */
 473
 474 extern int flag_no_gnu_keywords;
 475
 476 /* Nonzero means do emit exported implementations of functions even if
 477    they can be inlined.  */
 478
 479 extern int flag_implement_inlines;
 480
 481 /* Nonzero means that implicit instantiations will be emitted if needed.  */
 482
 483 extern int flag_implicit_templates;
 484
 485 /* Nonzero means that implicit instantiations of inline templates will be
 486    emitted if needed, even if instantiations of non-inline templates
 487    aren't.  */
 488
 489 extern int flag_implicit_inline_templates;
 490
 491 /* Nonzero means generate separate instantiation control files and
 492    juggle them at link time.  */
 493
 494 extern int flag_use_repository;
 495
 496 /* Nonzero if we want to issue diagnostics that the standard says are not
 497    required.  */
 498
 499 extern int flag_optional_diags;
 500
 501 /* Nonzero means we should attempt to elide constructors when possible.  */
 502
 503 extern int flag_elide_constructors;
 504
 505 /* Nonzero means that member functions defined in class scope are
 506    inline by default.  */
 507
 508 extern int flag_default_inline;
 509
 510 /* Controls whether compiler generates 'type descriptor' that give
 511    run-time type information.  */
 512
 513 extern int flag_rtti;
 514
 515 /* Nonzero if we want to conserve space in the .o files.  We do this
 516    by putting uninitialized data and runtime initialized data into
 517    .common instead of .data at the expense of not flagging multiple
 518    definitions.  */
 519
 520 extern int flag_conserve_space;
 521
 522 /* Nonzero if we want to obey access control semantics.  */
 523
 524 extern int flag_access_control;
 525
 526 /* Nonzero if we want to check the return value of new and avoid calling
 527    constructors if it is a null pointer.  */
 528
 529 extern int flag_check_new;
 530
 531 /* Nonzero if we want to allow the use of experimental features that
 532    are likely to become part of C++0x. */
 533
 534 extern int flag_cpp0x;
 535
 536 /* Nonzero if we want the new ISO rules for pushing a new scope for `for'
 537    initialization variables.
 538    0: Old rules, set by -fno-for-scope.
 539    2: New ISO rules, set by -ffor-scope.
 540    1: Try to implement new ISO rules, but with backup compatibility
 541    (and warnings).  This is the default, for now.  */
 542
 543 extern int flag_new_for_scope;
 544
 545 /* Nonzero if we want to emit defined symbols with common-like linkage as
 546    weak symbols where possible, in order to conform to C++ semantics.
 547    Otherwise, emit them as local symbols.  */
 548
 549 extern int flag_weak;
 550
 551 /* 0 means we want the preprocessor to not emit line directives for
 552    the current working directory.  1 means we want it to do it.  -1
 553    means we should decide depending on whether debugging information
 554    is being emitted or not.  */
 555
 556 extern int flag_working_directory;
 557
 558 /* Nonzero to use __cxa_atexit, rather than atexit, to register
 559    destructors for local statics and global objects.  */
 560
 561 extern int flag_use_cxa_atexit;
 562
 563 /* Nonzero to use __cxa_get_exception_ptr in the C++ exception-handling
 564    logic.  */
 565
 566 extern int flag_use_cxa_get_exception_ptr;
 567
 568 /* Nonzero means make the default pedwarns warnings instead of errors.
 569    The value of this flag is ignored if -pedantic is specified.  */
 570
 571 extern int flag_permissive;
 572
 573 /* Nonzero means to implement standard semantics for exception
 574    specifications, calling unexpected if an exception is thrown that
 575    doesn't match the specification.  Zero means to treat them as
 576    assertions and optimize accordingly, but not check them.  */
 577
 578 extern int flag_enforce_eh_specs;
 579
 580 /* Nonzero (the default) means to generate thread-safe code for
 581    initializing local statics.  */
 582
 583 extern int flag_threadsafe_statics;
 584
 585 /* Nonzero means warn about implicit declarations.  */
 586
 587 extern int warn_implicit;
 588
 589 /* Warn about using __null (as NULL in C++) as sentinel.  For code compiled
 590    with GCC this doesn't matter as __null is guaranteed to have the right
 591    size.  */
 592
 593 extern int warn_strict_null_sentinel;
 594
 595 /* Maximum template instantiation depth.  This limit is rather
 596    arbitrary, but it exists to limit the time it takes to notice
 597    infinite template instantiations.  */
 598
 599 extern int max_tinst_depth;
 600
 601 /* Nonzero means the expression being parsed will never be evaluated.
 602    This is a count, since unevaluated expressions can nest.  */
 603
 604 extern int skip_evaluation;
 605
 606 /* C types are partitioned into three subsets: object, function, and
 607    incomplete types.  */
 608 #define C_TYPE_OBJECT_P(type) \
 609   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
 610
 611 #define C_TYPE_INCOMPLETE_P(type) \
 612   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
 613
 614 #define C_TYPE_FUNCTION_P(type) \
 615   (TREE_CODE (type) == FUNCTION_TYPE)
 616
 617 /* For convenience we define a single macro to identify the class of
 618    object or incomplete types.  */
 619 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
 620   (!C_TYPE_FUNCTION_P (type))
 621
 622 /* Attribute table common to the C front ends.  */
 623 extern const struct attribute_spec c_common_attribute_table[];
 624 extern const struct attribute_spec c_common_format_attribute_table[];
 625
 626 /* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
 627    ID is the identifier to use, NAME is the string.
 628    TYPE_DEP indicates whether it depends on type of the function or not
 629    (i.e. __PRETTY_FUNCTION__).  */
 630
 631 extern tree (*make_fname_decl) (tree, int);
 632
 633 extern tree identifier_global_value (tree);
 634 extern void record_builtin_type (enum rid, const char *, tree);
 635 extern tree build_void_list_node (void);
 636 extern void start_fname_decls (void);
 637 extern void finish_fname_decls (void);
 638 extern const char *fname_as_string (int);
 639 extern tree fname_decl (unsigned, tree);
 640
 641 extern void check_function_arguments (tree, tree, tree);
 642 extern void check_function_arguments_recurse (void (*)
 643                                               (void *, tree,
 644                                                unsigned HOST_WIDE_INT),
 645                                               void *, tree,
 646                                               unsigned HOST_WIDE_INT);
 647 extern void check_function_format (tree, tree);
 648 extern void set_Wformat (int);
 649 extern tree handle_format_attribute (tree *, tree, tree, int, bool *);
 650 extern tree handle_format_arg_attribute (tree *, tree, tree, int, bool *);
 651 extern int c_common_handle_option (size_t code, const char *arg, int value);
 652 extern bool c_common_missing_argument (const char *opt, size_t code);
 653 extern tree c_common_type_for_mode (enum machine_mode, int);
 654 extern tree c_common_type_for_size (unsigned int, int);
 655 extern tree c_common_unsigned_type (tree);
 656 extern tree c_common_signed_type (tree);
 657 extern tree c_common_signed_or_unsigned_type (int, tree);
 658 extern tree c_build_bitfield_integer_type (unsigned HOST_WIDE_INT, int);
 659 extern bool decl_with_nonnull_addr_p (tree);
 660 extern tree c_common_truthvalue_conversion (tree);
 661 extern void c_apply_type_quals_to_decl (int, tree);
 662 extern tree c_sizeof_or_alignof_type (tree, bool, int);
 663 extern tree c_alignof_expr (tree);
 664 /* Print an error message for invalid operands to arith operation CODE.
 665    NOP_EXPR is used as a special case (see truthvalue_conversion).  */
 666 extern void binary_op_error (enum tree_code);
 667 extern tree fix_string_type (tree);
 668 struct varray_head_tag;
 669 extern void constant_expression_warning (tree);
 670 extern void strict_aliasing_warning (tree, tree, tree);
 671 extern void empty_body_warning (tree, tree);
 672 extern tree convert_and_check (tree, tree);
 673 extern void overflow_warning (tree);
 674 extern void check_main_parameter_types (tree decl);
 675 extern bool c_determine_visibility (tree);
 676 extern bool same_scalar_type_ignoring_signedness (tree, tree);
 677
 678 #define c_sizeof(T)  c_sizeof_or_alignof_type (T, true, 1)
 679 #define c_alignof(T) c_sizeof_or_alignof_type (T, false, 1)
 680
 681 /* Subroutine of build_binary_op, used for comparison operations.
 682    See if the operands have both been converted from subword integer types
 683    and, if so, perhaps change them both back to their original type.  */
 684 extern tree shorten_compare (tree *, tree *, tree *, enum tree_code *);
 685
 686 extern tree pointer_int_sum (enum tree_code, tree, tree);
 687 extern unsigned int min_precision (tree, int);
 688
 689 /* Add qualifiers to a type, in the fashion for C.  */
 690 extern tree c_build_qualified_type (tree, int);
 691
 692 /* Build tree nodes and builtin functions common to both C and C++ language
 693    frontends.  */
 694 extern void c_common_nodes_and_builtins (void);
 695
 696 extern void set_builtin_user_assembler_name (tree decl, const char *asmspec);
 697
 698 extern void disable_builtin_function (const char *);
 699
 700 extern void set_compound_literal_name (tree decl);
 701
 702 extern tree build_va_arg (tree, tree);
 703
 704 extern unsigned int c_common_init_options (unsigned int, const char **);
 705 extern bool c_common_post_options (const char **);
 706 extern bool c_common_init (void);
 707 extern void c_common_finish (void);
 708 extern void c_common_parse_file (int);
 709 extern HOST_WIDE_INT c_common_get_alias_set (tree);
 710 extern void c_register_builtin_type (tree, const char*);
 711 extern bool c_promoting_integer_type_p (tree);
 712 extern int self_promoting_args_p (tree);
 713 extern tree strip_array_types (tree);
 714 extern tree strip_pointer_operator (tree);
 715 extern HOST_WIDE_INT c_common_to_target_charset (HOST_WIDE_INT);
 716
 717 /* This is the basic parsing function.  */
 718 extern void c_parse_file (void);
 719 /* This is misnamed, it actually performs end-of-compilation processing.  */
 720 extern void finish_file (void);
 721
 722
 723 /* These macros provide convenient access to the various _STMT nodes.  */
 724
 725 /* Nonzero if a given STATEMENT_LIST represents the outermost binding
 726    if a statement expression.  */
 727 #define STATEMENT_LIST_STMT_EXPR(NODE) \
 728   TREE_LANG_FLAG_1 (STATEMENT_LIST_CHECK (NODE))
 729
 730 /* Nonzero if a label has been added to the statement list.  */
 731 #define STATEMENT_LIST_HAS_LABEL(NODE) \
 732   TREE_LANG_FLAG_3 (STATEMENT_LIST_CHECK (NODE))
 733
 734 /* COMPOUND_LITERAL_EXPR accessors.  */
 735 #define COMPOUND_LITERAL_EXPR_DECL_STMT(NODE)           \
 736   TREE_OPERAND (COMPOUND_LITERAL_EXPR_CHECK (NODE), 0)
 737 #define COMPOUND_LITERAL_EXPR_DECL(NODE)                        \
 738   DECL_EXPR_DECL (COMPOUND_LITERAL_EXPR_DECL_STMT (NODE))
 739
 740 #define DEFTREECODE(SYM, NAME, TYPE, LENGTH) SYM,
 741
 742 enum c_tree_code {
 743   C_DUMMY_TREE_CODE = LAST_AND_UNUSED_TREE_CODE,
 744 #include "c-common.def"
 745   LAST_C_TREE_CODE
 746 };
 747
 748 #undef DEFTREECODE
 749
 750 extern int anon_aggr_type_p (tree);
 751
 752 /* For a VAR_DECL that is an anonymous union, these are the various
 753    sub-variables that make up the anonymous union.  */
 754 #define DECL_ANON_UNION_ELEMS(NODE) DECL_ARGUMENTS ((NODE))
 755
 756 /* In a FIELD_DECL, nonzero if the decl was originally a bitfield.  */
 757 #define DECL_C_BIT_FIELD(NODE) \
 758   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
 759 #define SET_DECL_C_BIT_FIELD(NODE) \
 760   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
 761 #define CLEAR_DECL_C_BIT_FIELD(NODE) \
 762   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
 763
 764 extern void emit_local_var (tree);
 765 extern tree do_case (tree, tree);
 766 extern tree build_stmt (enum tree_code, ...);
 767 extern tree build_case_label (tree, tree, tree);
 768
 769 /* These functions must be defined by each front-end which implements
 770    a variant of the C language.  They are used in c-common.c.  */
 771
 772 extern tree build_unary_op (enum tree_code, tree, int);
 773 extern tree build_binary_op (enum tree_code, tree, tree, int);
 774 extern tree perform_integral_promotions (tree);
 775
 776 /* These functions must be defined by each front-end which implements
 777    a variant of the C language.  They are used by port files.  */
 778
 779 extern tree default_conversion (tree);
 780
 781 /* Given two integer or real types, return the type for their sum.
 782    Given two compatible ANSI C types, returns the merged type.  */
 783
 784 extern tree common_type (tree, tree);
 785
 786 extern tree decl_constant_value (tree);
 787
 788 /* Handle increment and decrement of boolean types.  */
 789 extern tree boolean_increment (enum tree_code, tree);
 790
 791 extern int case_compare (splay_tree_key, splay_tree_key);
 792
 793 extern tree c_add_case_label (splay_tree, tree, tree, tree, tree);
 794
 795 extern void c_do_switch_warnings (splay_tree, location_t, tree, tree);
 796
 797 extern tree build_function_call (tree, tree);
 798
 799 extern tree resolve_overloaded_builtin (tree, tree);
 800
 801 extern tree finish_label_address_expr (tree);
 802
 803 /* Same function prototype, but the C and C++ front ends have
 804    different implementations.  Used in c-common.c.  */
 805 extern tree lookup_label (tree);
 806 extern tree lookup_name (tree);
 807
 808 extern bool vector_types_convertible_p (tree t1, tree t2, bool emit_lax_note);
 809
 810 extern rtx c_expand_expr (tree, rtx, enum machine_mode, int, rtx *);
 811
 812 extern tree c_staticp (tree);
 813
 814 extern void init_c_lex (void);
 815
 816 extern void c_cpp_builtins (cpp_reader *);
 817
 818 /* Positive if an implicit `extern "C"' scope has just been entered;
 819    negative if such a scope has just been exited.  */
 820 extern GTY(()) int pending_lang_change;
 821
 822 /* Information recorded about each file examined during compilation.  */
 823
 824 struct c_fileinfo
 825 {
 826   int time;     /* Time spent in the file.  */
 827
 828   /* Flags used only by C++.
 829      INTERFACE_ONLY nonzero means that we are in an "interface" section
 830      of the compiler.  INTERFACE_UNKNOWN nonzero means we cannot trust
 831      the value of INTERFACE_ONLY.  If INTERFACE_UNKNOWN is zero and
 832      INTERFACE_ONLY is zero, it means that we are responsible for
 833      exporting definitions that others might need.  */
 834   short interface_only;
 835   short interface_unknown;
 836 };
 837
 838 struct c_fileinfo *get_fileinfo (const char *);
 839 extern void dump_time_statistics (void);
 840
 841 extern bool c_dump_tree (void *, tree);
 842
 843 extern void c_warn_unused_result (tree *);
 844
 845 extern void verify_sequence_points (tree);
 846
 847 extern tree fold_offsetof (tree, tree);
 848
 849 /* Places where an lvalue, or modifiable lvalue, may be required.
 850    Used to select diagnostic messages in lvalue_error and
 851    readonly_error.  */
 852 enum lvalue_use {
 853   lv_assign,
 854   lv_increment,
 855   lv_decrement,
 856   lv_addressof,
 857   lv_asm
 858 };
 859
 860 extern void lvalue_error (enum lvalue_use);
 861
 862 extern int complete_array_type (tree *, tree, bool);
 863
 864 extern tree builtin_type_for_size (int, bool);
 865
 866 extern void warn_array_subscript_with_type_char (tree);
 867 extern void warn_about_parentheses (enum tree_code, enum tree_code,
 868                                     enum tree_code);
 869
 870
 871 /* In c-gimplify.c  */
 872 extern void c_genericize (tree);
 873 extern int c_gimplify_expr (tree *, tree *, tree *);
 874 extern tree c_build_bind_expr (tree, tree);
 875
 876 /* In c-pch.c  */
 877 extern void pch_init (void);
 878 extern int c_common_valid_pch (cpp_reader *pfile, const char *name, int fd);
 879 extern void c_common_read_pch (cpp_reader *pfile, const char *name, int fd,
 880                                const char *orig);
 881 extern void c_common_write_pch (void);
 882 extern void c_common_no_more_pch (void);
 883 extern void c_common_pch_pragma (cpp_reader *pfile, const char *);
 884 extern void c_common_print_pch_checksum (FILE *f);
 885
 886 /* In *-checksum.c */
 887 extern const unsigned char executable_checksum[16];
 888
 889 extern void builtin_define_with_value (const char *, const char *, int);
 890 extern void c_stddef_cpp_builtins (void);
 891 extern void fe_file_change (const struct line_map *);
 892 extern void c_parse_error (const char *, enum cpp_ttype, tree);
 893
 894 /* Objective-C / Objective-C++ entry points.  */
 895
 896 /* The following ObjC/ObjC++ functions are called by the C and/or C++
 897    front-ends; they all must have corresponding stubs in stub-objc.c.  */
 898 extern tree objc_is_class_name (tree);
 899 extern tree objc_is_object_ptr (tree);
 900 extern void objc_check_decl (tree);
 901 extern int objc_is_reserved_word (tree);
 902 extern bool objc_compare_types (tree, tree, int, tree);
 903 extern void objc_volatilize_decl (tree);
 904 extern bool objc_type_quals_match (tree, tree);
 905 extern tree objc_rewrite_function_call (tree, tree);
 906 extern tree objc_message_selector (void);
 907 extern tree objc_lookup_ivar (tree, tree);
 908 extern void objc_clear_super_receiver (void);
 909 extern int objc_is_public (tree, tree);
 910 extern tree objc_is_id (tree);
 911 extern void objc_declare_alias (tree, tree);
 912 extern void objc_declare_class (tree);
 913 extern void objc_declare_protocols (tree);
 914 extern tree objc_build_message_expr (tree);
 915 extern tree objc_finish_message_expr (tree, tree, tree);
 916 extern tree objc_build_selector_expr (tree);
 917 extern tree objc_build_protocol_expr (tree);
 918 extern tree objc_build_encode_expr (tree);
 919 extern tree objc_build_string_object (tree);
 920 extern tree objc_get_protocol_qualified_type (tree, tree);
 921 extern tree objc_get_class_reference (tree);
 922 extern tree objc_get_class_ivars (tree);
 923 extern void objc_start_class_interface (tree, tree, tree);
 924 extern void objc_start_category_interface (tree, tree, tree);
 925 extern void objc_start_protocol (tree, tree);
 926 extern void objc_continue_interface (void);
 927 extern void objc_finish_interface (void);
 928 extern void objc_start_class_implementation (tree, tree);
 929 extern void objc_start_category_implementation (tree, tree);
 930 extern void objc_continue_implementation (void);
 931 extern void objc_finish_implementation (void);
 932 extern void objc_set_visibility (int);
 933 extern void objc_set_method_type (enum tree_code);
 934 extern tree objc_build_method_signature (tree, tree, tree, bool);
 935 extern void objc_add_method_declaration (tree);
 936 extern void objc_start_method_definition (tree);
 937 extern void objc_finish_method_definition (tree);
 938 extern void objc_add_instance_variable (tree);
 939 extern tree objc_build_keyword_decl (tree, tree, tree);
 940 extern tree objc_build_throw_stmt (tree);
 941 extern void objc_begin_try_stmt (location_t, tree);
 942 extern tree objc_finish_try_stmt (void);
 943 extern void objc_begin_catch_clause (tree);
 944 extern void objc_finish_catch_clause (void);
 945 extern void objc_build_finally_clause (location_t, tree);
 946 extern tree objc_build_synchronized (location_t, tree, tree);
 947 extern int objc_static_init_needed_p (void);
 948 extern tree objc_generate_static_init_call (tree);
 949 extern tree objc_generate_write_barrier (tree, enum tree_code, tree);
 950
 951 /* The following are provided by the C and C++ front-ends, and called by
 952    ObjC/ObjC++.  */
 953 extern void *objc_get_current_scope (void);
 954 extern void objc_mark_locals_volatile (void *);
 955
 956 /* In c-ppoutput.c  */
 957 extern void init_pp_output (FILE *);
 958 extern void preprocess_file (cpp_reader *);
 959 extern void pp_file_change (const struct line_map *);
 960 extern void pp_dir_change (cpp_reader *, const char *);
 961 extern bool check_missing_format_attribute (tree, tree);
 962
 963 /* In c-omp.c  */
 964 extern tree c_finish_omp_master (tree);
 965 extern tree c_finish_omp_critical (tree, tree);
 966 extern tree c_finish_omp_ordered (tree);
 967 extern void c_finish_omp_barrier (void);
 968 extern tree c_finish_omp_atomic (enum tree_code, tree, tree);
 969 extern void c_finish_omp_flush (void);
 970 extern tree c_finish_omp_for (location_t, tree, tree, tree, tree, tree, tree);
 971 extern void c_split_parallel_clauses (tree, tree *, tree *);
 972 extern enum omp_clause_default_kind c_omp_predetermined_sharing (tree);
 973
 974 /* Not in c-omp.c; provided by the front end.  */
 975 extern bool c_omp_sharing_predetermined (tree);
 976 extern tree c_omp_remap_decl (tree, bool);
 977
 978 /* In order for the format checking to accept the C frontend
 979    diagnostic framework extensions, you must include this file before
 980    toplev.h, not after.  The C front end formats are a subset of those
 981    for C++, so they are the appropriate set to use in common code;
 982    cp-tree.h overrides this for C++.  */
 983 #ifndef GCC_DIAG_STYLE
 984 #define GCC_DIAG_STYLE __gcc_cdiag__
 985 #endif
 986
 987 #endif /* ! GCC_C_COMMON_H */