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