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