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