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