gcc/c-common.h

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