gcc/c-common.h

   1 /* Definitions for c-common.c.
   2    Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
   3    1999, 2000, 2001 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
  28 /* Usage of TREE_LANG_FLAG_?:
  29    0: COMPOUND_STMT_NO_SCOPE (in COMPOUND_STMT).
  30       TREE_NEGATED_INT (in INTEGER_CST).
  31       IDENTIFIER_MARKED (used by search routines).
  32       SCOPE_BEGIN_P (in SCOPE_STMT)
  33       DECL_PRETTY_FUNCTION_P (in VAR_DECL)
  34       NEW_FOR_SCOPE_P (in FOR_STMT)
  35       ASM_INPUT_P (in ASM_STMT)
  36    1: C_DECLARED_LABEL_FLAG (in LABEL_DECL)
  37       STMT_IS_FULL_EXPR_P (in _STMT)
  38    2: STMT_LINENO_FOR_FN_P (in _STMT)
  39    3: SCOPE_NO_CLEANUPS_P (in SCOPE_STMT)
  40    4: SCOPE_PARTIAL_P (in SCOPE_STMT)
  41 */
  42
  43 /* Reserved identifiers.  This is the union of all the keywords for C,
  44    C++, and Objective C.  All the type modifiers have to be in one
  45    block at the beginning, because they are used as mask bits.  There
  46    are 27 type modifiers; if we add many more we will have to redesign
  47    the mask mechanism.  */
  48
  49 enum rid
  50 {
  51   /* Modifiers: */
  52   /* C, in empirical order of frequency. */
  53   RID_STATIC = 0,
  54   RID_UNSIGNED, RID_LONG,    RID_CONST, RID_EXTERN,
  55   RID_REGISTER, RID_TYPEDEF, RID_SHORT, RID_INLINE,
  56   RID_VOLATILE, RID_SIGNED,  RID_AUTO,  RID_RESTRICT,
  57
  58   /* C extensions */
  59   RID_BOUNDED, RID_UNBOUNDED, RID_COMPLEX,
  60
  61   /* C++ */
  62   RID_FRIEND, RID_VIRTUAL, RID_EXPLICIT, RID_EXPORT, RID_MUTABLE,
  63
  64   /* ObjC */
  65   RID_IN, RID_OUT, RID_INOUT, RID_BYCOPY, RID_BYREF, RID_ONEWAY,
  66
  67   /* C */
  68   RID_INT,     RID_CHAR,   RID_FLOAT,    RID_DOUBLE, RID_VOID,
  69   RID_ENUM,    RID_STRUCT, RID_UNION,    RID_IF,     RID_ELSE,
  70   RID_WHILE,   RID_DO,     RID_FOR,      RID_SWITCH, RID_CASE,
  71   RID_DEFAULT, RID_BREAK,  RID_CONTINUE, RID_RETURN, RID_GOTO,
  72   RID_SIZEOF,
  73
  74   /* C extensions */
  75   RID_ASM,       RID_TYPEOF,   RID_ALIGNOF,  RID_ATTRIBUTE,  RID_VA_ARG,
  76   RID_EXTENSION, RID_IMAGPART, RID_REALPART, RID_LABEL,      RID_PTRBASE,
  77   RID_PTREXTENT, RID_PTRVALUE,
  78
  79   /* Too many ways of getting the name of a function as a string */
  80   RID_FUNCTION_NAME, RID_PRETTY_FUNCTION_NAME, RID_C99_FUNCTION_NAME,
  81
  82   /* C++ */
  83   RID_BOOL,     RID_WCHAR,    RID_CLASS,
  84   RID_PUBLIC,   RID_PRIVATE,  RID_PROTECTED,
  85   RID_TEMPLATE, RID_NULL,     RID_CATCH,
  86   RID_DELETE,   RID_FALSE,    RID_NAMESPACE,
  87   RID_NEW,      RID_OPERATOR, RID_THIS,
  88   RID_THROW,    RID_TRUE,     RID_TRY,
  89   RID_TYPENAME, RID_TYPEID,   RID_USING,
  90
  91   /* casts */
  92   RID_CONSTCAST, RID_DYNCAST, RID_REINTCAST, RID_STATCAST,
  93
  94   /* alternate spellings */
  95   RID_AND, RID_AND_EQ, RID_NOT, RID_NOT_EQ,
  96   RID_OR,  RID_OR_EQ,  RID_XOR, RID_XOR_EQ,
  97   RID_BITAND, RID_BITOR, RID_COMPL,
  98
  99   /* Objective C */
 100   RID_ID,          RID_AT_ENCODE,    RID_AT_END,
 101   RID_AT_CLASS,    RID_AT_ALIAS,     RID_AT_DEFS,
 102   RID_AT_PRIVATE,  RID_AT_PROTECTED, RID_AT_PUBLIC,
 103   RID_AT_PROTOCOL, RID_AT_SELECTOR,  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_AT = RID_AT_ENCODE,
 112   RID_LAST_AT = RID_AT_IMPLEMENTATION,
 113   RID_FIRST_PQ = RID_IN,
 114   RID_LAST_PQ = RID_ONEWAY
 115 };
 116
 117 #define OBJC_IS_AT_KEYWORD(rid) \
 118   ((unsigned int)(rid) >= (unsigned int)RID_FIRST_AT && \
 119    (unsigned int)(rid) <= (unsigned int)RID_LAST_AT)
 120
 121 #define OBJC_IS_PQ_KEYWORD(rid) \
 122   ((unsigned int)(rid) >= (unsigned int)RID_FIRST_PQ && \
 123    (unsigned int)(rid) <= (unsigned int)RID_LAST_PQ)
 124
 125 /* The elements of `ridpointers' are identifier nodes for the reserved
 126    type names and storage classes.  It is indexed by a RID_... value.  */
 127 extern tree *ridpointers;
 128
 129 /* Standard named or nameless data types of the C compiler.  */
 130
 131 enum c_tree_index
 132 {
 133     CTI_WCHAR_TYPE,
 134     CTI_SIGNED_WCHAR_TYPE,
 135     CTI_UNSIGNED_WCHAR_TYPE,
 136     CTI_WINT_TYPE,
 137     CTI_C_SIZE_TYPE, /* The type used for the size_t typedef and the
 138                         result type of sizeof (an ordinary type without
 139                         TYPE_IS_SIZETYPE set, unlike the internal
 140                         sizetype).  */
 141     CTI_SIGNED_SIZE_TYPE, /* For format checking only.  */
 142     CTI_UNSIGNED_PTRDIFF_TYPE, /* For format checking only.  */
 143     CTI_INTMAX_TYPE,
 144     CTI_UINTMAX_TYPE,
 145     CTI_WIDEST_INT_LIT_TYPE,
 146     CTI_WIDEST_UINT_LIT_TYPE,
 147
 148     CTI_CHAR_ARRAY_TYPE,
 149     CTI_WCHAR_ARRAY_TYPE,
 150     CTI_INT_ARRAY_TYPE,
 151     CTI_STRING_TYPE,
 152     CTI_CONST_STRING_TYPE,
 153
 154     /* Type for boolean expressions (bool in C++, int in C).  */
 155     CTI_BOOLEAN_TYPE,
 156     CTI_BOOLEAN_TRUE,
 157     CTI_BOOLEAN_FALSE,
 158     /* C99's _Bool type.  */
 159     CTI_C_BOOL_TYPE,
 160     CTI_C_BOOL_TRUE,
 161     CTI_C_BOOL_FALSE,
 162     CTI_DEFAULT_FUNCTION_TYPE,
 163
 164     CTI_G77_INTEGER_TYPE,
 165     CTI_G77_UINTEGER_TYPE,
 166     CTI_G77_LONGINT_TYPE,
 167     CTI_G77_ULONGINT_TYPE,
 168
 169     /* These are not types, but we have to look them up all the time. */
 170     CTI_FUNCTION_NAME_DECL,
 171     CTI_PRETTY_FUNCTION_NAME_DECL,
 172     CTI_C99_FUNCTION_NAME_DECL,
 173     CTI_SAVED_FUNCTION_NAME_DECLS,
 174
 175     CTI_VOID_ZERO,
 176
 177     CTI_MAX
 178 };
 179
 180 #define C_RID_CODE(id)  (((struct c_common_identifier *) (id))->rid_code)
 181
 182 /* Identifier part common to the C front ends.  Inherits from
 183    tree_identifier, despite appearances.  */
 184 struct c_common_identifier
 185 {
 186   struct tree_common common;
 187   struct cpp_hashnode node;
 188   ENUM_BITFIELD(rid) rid_code: CHAR_BIT;
 189 };
 190
 191 #define wchar_type_node                 c_global_trees[CTI_WCHAR_TYPE]
 192 #define signed_wchar_type_node          c_global_trees[CTI_SIGNED_WCHAR_TYPE]
 193 #define unsigned_wchar_type_node        c_global_trees[CTI_UNSIGNED_WCHAR_TYPE]
 194 #define wint_type_node                  c_global_trees[CTI_WINT_TYPE]
 195 #define c_size_type_node                c_global_trees[CTI_C_SIZE_TYPE]
 196 #define signed_size_type_node           c_global_trees[CTI_SIGNED_SIZE_TYPE]
 197 #define unsigned_ptrdiff_type_node      c_global_trees[CTI_UNSIGNED_PTRDIFF_TYPE]
 198 #define intmax_type_node                c_global_trees[CTI_INTMAX_TYPE]
 199 #define uintmax_type_node               c_global_trees[CTI_UINTMAX_TYPE]
 200 #define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
 201 #define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
 202
 203 #define boolean_type_node               c_global_trees[CTI_BOOLEAN_TYPE]
 204 #define boolean_true_node               c_global_trees[CTI_BOOLEAN_TRUE]
 205 #define boolean_false_node              c_global_trees[CTI_BOOLEAN_FALSE]
 206
 207 #define c_bool_type_node                c_global_trees[CTI_C_BOOL_TYPE]
 208 #define c_bool_true_node                c_global_trees[CTI_C_BOOL_TRUE]
 209 #define c_bool_false_node               c_global_trees[CTI_C_BOOL_FALSE]
 210
 211 #define char_array_type_node            c_global_trees[CTI_CHAR_ARRAY_TYPE]
 212 #define wchar_array_type_node           c_global_trees[CTI_WCHAR_ARRAY_TYPE]
 213 #define int_array_type_node             c_global_trees[CTI_INT_ARRAY_TYPE]
 214 #define string_type_node                c_global_trees[CTI_STRING_TYPE]
 215 #define const_string_type_node          c_global_trees[CTI_CONST_STRING_TYPE]
 216
 217 #define default_function_type           c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
 218
 219 /* g77 integer types, which which must be kept in sync with f/com.h */
 220 #define g77_integer_type_node           c_global_trees[CTI_G77_INTEGER_TYPE]
 221 #define g77_uinteger_type_node          c_global_trees[CTI_G77_UINTEGER_TYPE]
 222 #define g77_longint_type_node           c_global_trees[CTI_G77_LONGINT_TYPE]
 223 #define g77_ulongint_type_node          c_global_trees[CTI_G77_ULONGINT_TYPE]
 224
 225 #define function_name_decl_node         c_global_trees[CTI_FUNCTION_NAME_DECL]
 226 #define pretty_function_name_decl_node  c_global_trees[CTI_PRETTY_FUNCTION_NAME_DECL]
 227 #define c99_function_name_decl_node             c_global_trees[CTI_C99_FUNCTION_NAME_DECL]
 228 #define saved_function_name_decls       c_global_trees[CTI_SAVED_FUNCTION_NAME_DECLS]
 229
 230 /* A node for `((void) 0)'.  */
 231 #define void_zero_node                  c_global_trees[CTI_VOID_ZERO]
 232
 233 extern tree c_global_trees[CTI_MAX];
 234
 235 /* Mark which labels are explicitly declared.
 236    These may be shadowed, and may be referenced from nested functions.  */
 237 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
 238
 239 typedef enum c_language_kind
 240 {
 241   clk_c,           /* A dialect of C: K&R C, ANSI/ISO C89, C2000,
 242                        etc. */
 243   clk_cplusplus,   /* ANSI/ISO C++ */
 244   clk_objective_c  /* Objective C */
 245 }
 246 c_language_kind;
 247
 248 /* Information about a statement tree.  */
 249
 250 struct stmt_tree_s {
 251   /* The last statement added to the tree.  */
 252   tree x_last_stmt;
 253   /* The type of the last expression statement.  (This information is
 254      needed to implement the statement-expression extension.)  */
 255   tree x_last_expr_type;
 256   /* In C++, Non-zero if we should treat statements as full
 257      expressions.  In particular, this variable is no-zero if at the
 258      end of a statement we should destroy any temporaries created
 259      during that statement.  Similarly, if, at the end of a block, we
 260      should destroy any local variables in this block.  Normally, this
 261      variable is non-zero, since those are the normal semantics of
 262      C++.
 263
 264      However, in order to represent aggregate initialization code as
 265      tree structure, we use statement-expressions.  The statements
 266      within the statement expression should not result in cleanups
 267      being run until the entire enclosing statement is complete.
 268
 269      This flag has no effect in C.  */
 270   int stmts_are_full_exprs_p;
 271 };
 272
 273 typedef struct stmt_tree_s *stmt_tree;
 274
 275 /* Global state pertinent to the current function.  Some C dialects
 276    extend this structure with additional fields.  */
 277
 278 struct language_function {
 279   /* While we are parsing the function, this contains information
 280      about the statement-tree that we are building.  */
 281   struct stmt_tree_s x_stmt_tree;
 282   /* The stack of SCOPE_STMTs for the current function.  */
 283   tree x_scope_stmt_stack;
 284 };
 285
 286 /* When building a statement-tree, this is the last statement added to
 287    the tree.  */
 288
 289 #define last_tree (current_stmt_tree ()->x_last_stmt)
 290
 291 /* The type of the last expression-statement we have seen.  */
 292
 293 #define last_expr_type (current_stmt_tree ()->x_last_expr_type)
 294
 295 /* LAST_TREE contains the last statement parsed.  These are chained
 296    together through the TREE_CHAIN field, but often need to be
 297    re-organized since the parse is performed bottom-up.  This macro
 298    makes LAST_TREE the indicated SUBSTMT of STMT.  */
 299
 300 #define RECHAIN_STMTS(stmt, substmt)            \
 301   do {                                          \
 302     substmt = TREE_CHAIN (stmt);                \
 303     TREE_CHAIN (stmt) = NULL_TREE;              \
 304     last_tree = stmt;                           \
 305   } while (0)
 306
 307 /* Language-specific hooks.  */
 308
 309 extern int (*lang_statement_code_p)             PARAMS ((enum tree_code));
 310 extern void (*lang_expand_stmt)                 PARAMS ((tree));
 311 extern void (*lang_expand_decl_stmt)            PARAMS ((tree));
 312 extern void (*lang_expand_function_end)         PARAMS ((void));
 313
 314 /* Callback that determines if it's ok for a function to have no
 315    noreturn attribute.  */
 316 extern int (*lang_missing_noreturn_ok_p)        PARAMS ((tree));
 317
 318
 319 /* The type of a function that walks over tree structure.  */
 320
 321 typedef tree (*walk_tree_fn)                    PARAMS ((tree *,
 322                                                          int *,
 323                                                          void *));
 324
 325 extern stmt_tree current_stmt_tree              PARAMS ((void));
 326 extern tree *current_scope_stmt_stack           PARAMS ((void));
 327 extern void begin_stmt_tree                     PARAMS ((tree *));
 328 extern tree add_stmt                            PARAMS ((tree));
 329 extern void add_decl_stmt                       PARAMS ((tree));
 330 extern tree add_scope_stmt                      PARAMS ((int, int));
 331 extern void finish_stmt_tree                    PARAMS ((tree *));
 332
 333 extern int statement_code_p                     PARAMS ((enum tree_code));
 334 extern tree walk_stmt_tree                      PARAMS ((tree *,
 335                                                          walk_tree_fn,
 336                                                          void *));
 337 extern void prep_stmt                           PARAMS ((tree));
 338 extern void expand_stmt                         PARAMS ((tree));
 339 extern void mark_stmt_tree                      PARAMS ((void *));
 340
 341 /* Extra information associated with a DECL.  Other C dialects extend
 342    this structure in various ways.  The C front-end only uses this
 343    structure for FUNCTION_DECLs; all other DECLs have a NULL
 344    DECL_LANG_SPECIFIC field.  */
 345
 346 struct c_lang_decl {
 347   /* In a FUNCTION_DECL, this is DECL_SAVED_TREE.  */
 348   tree saved_tree;
 349 };
 350
 351 /* In a FUNCTION_DECL, the saved representation of the body of the
 352    entire function.  Usually a COMPOUND_STMT, but in C++ this may also
 353    be a RETURN_INIT, CTOR_INITIALIZER, or TRY_BLOCK.  */
 354 #define DECL_SAVED_TREE(NODE)                                               \
 355   (((struct c_lang_decl *) DECL_LANG_SPECIFIC (FUNCTION_DECL_CHECK (NODE))) \
 356    ->saved_tree)
 357
 358 /* In a FUNCTION_DECL for which DECL_BUILT_IN does not hold, this is
 359      the approximate number of statements in this function.  There is
 360      no need for this number to be exact; it is only used in various
 361      heuristics regarding optimization.  */
 362 #define DECL_NUM_STMTS(NODE) \
 363   (FUNCTION_DECL_CHECK (NODE)->decl.u1.i)
 364
 365 extern void c_mark_lang_decl                    PARAMS ((struct c_lang_decl *));
 366
 367 /* The variant of the C language being processed.  Each C language
 368    front-end defines this variable.  */
 369
 370 extern c_language_kind c_language;
 371
 372 /* Nonzero means give string constants the type `const char *', rather
 373    than `char *'.  */
 374
 375 extern int flag_const_strings;
 376
 377 /* Nonzero means give `double' the same size as `float'.  */
 378
 379 extern int flag_short_double;
 380
 381 /* Nonzero means give `wchar_t' the same size as `short'.  */
 382
 383 extern int flag_short_wchar;
 384
 385 /* Warn about *printf or *scanf format/argument anomalies. */
 386
 387 extern int warn_format;
 388
 389 /* Warn about Y2K problems with strftime formats.  */
 390
 391 extern int warn_format_y2k;
 392
 393 /* Warn about excess arguments to formats.  */
 394
 395 extern int warn_format_extra_args;
 396
 397 /* Warn about non-literal format arguments.  */
 398
 399 extern int warn_format_nonliteral;
 400
 401 /* Warn about possible security problems with calls to format functions.  */
 402
 403 extern int warn_format_security;
 404
 405 /* Warn about possible violations of sequence point rules.  */
 406
 407 extern int warn_sequence_point;
 408
 409 /* Warn about functions which might be candidates for format attributes.  */
 410
 411 extern int warn_missing_format_attribute;
 412
 413 /* Nonzero means warn about sizeof (function) or addition/subtraction
 414    of function pointers.  */
 415
 416 extern int warn_pointer_arith;
 417
 418 /* Nonzero means do some things the same way PCC does.  */
 419
 420 extern int flag_traditional;
 421
 422 /* Nonzero means enable C89 Amendment 1 features.  */
 423
 424 extern int flag_isoc94;
 425
 426 /* Nonzero means use the ISO C99 dialect of C.  */
 427
 428 extern int flag_isoc99;
 429
 430 /* Nonzero means environment is hosted (i.e., not freestanding) */
 431
 432 extern int flag_hosted;
 433
 434 /* Nonzero means add default format_arg attributes for functions not
 435    in ISO C.  */
 436
 437 extern int flag_noniso_default_format_attributes;
 438
 439 /* Nonzero means don't recognize any builtin functions.  */
 440
 441 extern int flag_no_builtin;
 442
 443 /* Nonzero means don't recognize the non-ANSI builtin functions.
 444    -ansi sets this.  */
 445
 446 extern int flag_no_nonansi_builtin;
 447
 448 /* Nonzero means warn about suggesting putting in ()'s.  */
 449
 450 extern int warn_parentheses;
 451
 452 /* Warn if a type conversion is done that might have confusing results.  */
 453
 454 extern int warn_conversion;
 455
 456 /* Nonzero means warn about usage of long long,
 457    when `-pedantic' and not C99.  */
 458
 459 extern int warn_long_long;
 460
 461 /* C types are partitioned into three subsets: object, function, and
 462    incomplete types.  */
 463 #define C_TYPE_OBJECT_P(type) \
 464   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
 465
 466 #define C_TYPE_INCOMPLETE_P(type) \
 467   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
 468
 469 #define C_TYPE_FUNCTION_P(type) \
 470   (TREE_CODE (type) == FUNCTION_TYPE)
 471
 472 /* Return the qualifiers that apply to this type.  In C++, that means
 473    descending through array types.  Note that this macro evaluates its
 474    arguments mor than once.  */
 475 #define C_TYPE_QUALS(TYPE)                              \
 476   (TYPE_QUALS ((TREE_CODE (TYPE) == ARRAY_TYPE          \
 477                 && c_language == clk_cplusplus)         \
 478                ? strip_array_types (TYPE) : TYPE))
 479
 480 /* For convenience we define a single macro to identify the class of
 481    object or incomplete types.  */
 482 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
 483   (!C_TYPE_FUNCTION_P (type))
 484
 485 /* Record in each node resulting from a binary operator
 486    what operator was specified for it.  */
 487 #define C_EXP_ORIGINAL_CODE(exp) ((enum tree_code) TREE_COMPLEXITY (exp))
 488
 489 /* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
 490    ID is the identifier to use, NAME is the string.
 491    TYPE_DEP indicates whether it depends on type of the function or not
 492    (i.e. __PRETTY_FUNCTION__).  */
 493
 494 extern tree (*make_fname_decl)                  PARAMS ((tree, int));
 495
 496 extern tree identifier_global_value             PARAMS ((tree));
 497 extern void record_builtin_type                 PARAMS ((enum rid,
 498                                                          const char *, tree));
 499 extern tree build_void_list_node                PARAMS ((void));
 500 extern void start_fname_decls                   PARAMS ((void));
 501 extern void finish_fname_decls                  PARAMS ((void));
 502 extern const char *fname_as_string              PARAMS ((int));
 503 extern tree fname_decl                          PARAMS ((unsigned, tree));
 504 extern const char *fname_string                 PARAMS ((unsigned));
 505
 506 /* Flags that may be passed in the third argument of decl_attributes.  */
 507 enum attribute_flags
 508 {
 509   /* The type passed in is the type of a DECL, and any attributes that
 510      should be passed in again to be applied to the DECL rather than the
 511      type should be returned.  */
 512   ATTR_FLAG_DECL_NEXT = 1,
 513   /* The type passed in is a function return type, and any attributes that
 514      should be passed in again to be applied to the function type rather
 515      than the return type should be returned.  */
 516   ATTR_FLAG_FUNCTION_NEXT = 2,
 517   /* The type passed in is an array element type, and any attributes that
 518      should be passed in again to be applied to the array type rather
 519      than the element type should be returned.  */
 520   ATTR_FLAG_ARRAY_NEXT = 4
 521 };
 522
 523 extern tree decl_attributes                     PARAMS ((tree *, tree, int));
 524 extern void init_function_format_info           PARAMS ((void));
 525 extern void check_function_format               PARAMS ((int *, tree, tree, tree));
 526 extern void set_Wformat                         PARAMS ((int));
 527 extern void decl_handle_format_attribute        PARAMS ((tree, tree));
 528 extern void decl_handle_format_arg_attribute    PARAMS ((tree, tree));
 529 extern void c_apply_type_quals_to_decl          PARAMS ((int, tree));
 530 extern tree c_sizeof                            PARAMS ((tree));
 531 extern tree c_alignof                           PARAMS ((tree));
 532 extern tree c_alignof_expr                      PARAMS ((tree));
 533 /* Print an error message for invalid operands to arith operation CODE.
 534    NOP_EXPR is used as a special case (see truthvalue_conversion).  */
 535 extern void binary_op_error                     PARAMS ((enum tree_code));
 536 extern tree c_expand_expr_stmt                  PARAMS ((tree));
 537 extern void c_expand_start_cond                 PARAMS ((tree, int));
 538 extern void c_finish_then                       PARAMS ((void));
 539 extern void c_expand_start_else                 PARAMS ((void));
 540 extern void c_finish_else                   PARAMS ((void));
 541 extern void c_expand_end_cond                   PARAMS ((void));
 542 /* Validate the expression after `case' and apply default promotions.  */
 543 extern tree check_case_value                    PARAMS ((tree));
 544 /* Concatenate a list of STRING_CST nodes into one STRING_CST.  */
 545 extern tree combine_strings                     PARAMS ((tree));
 546 extern void constant_expression_warning         PARAMS ((tree));
 547 extern tree convert_and_check                   PARAMS ((tree, tree));
 548 extern void overflow_warning                    PARAMS ((tree));
 549 extern void unsigned_conversion_warning         PARAMS ((tree, tree));
 550
 551 /* Read the rest of the current #-directive line.  */
 552 extern char *get_directive_line                 PARAMS ((void));
 553 #define GET_DIRECTIVE_LINE() get_directive_line ()
 554
 555 /* Subroutine of build_binary_op, used for comparison operations.
 556    See if the operands have both been converted from subword integer types
 557    and, if so, perhaps change them both back to their original type.  */
 558 extern tree shorten_compare                     PARAMS ((tree *, tree *, tree *, enum tree_code *));
 559
 560 extern unsigned int min_precision               PARAMS ((tree, int));
 561
 562 /* Add qualifiers to a type, in the fashion for C.  */
 563 extern tree c_build_qualified_type              PARAMS ((tree, int));
 564
 565 /* Build tree nodes and builtin functions common to both C and C++ language
 566    frontends.  */
 567 extern void c_common_nodes_and_builtins         PARAMS ((void));
 568
 569 extern tree build_va_arg                        PARAMS ((tree, tree));
 570
 571 extern void c_common_lang_init                  PARAMS ((void));
 572
 573 extern bool c_promoting_integer_type_p          PARAMS ((tree));
 574 extern int self_promoting_args_p                PARAMS ((tree));
 575 extern tree simple_type_promotes_to             PARAMS ((tree));
 576 extern tree strip_array_types                   PARAMS ((tree));
 577
 578 /* These macros provide convenient access to the various _STMT nodes.  */
 579
 580 /* Nonzero if this statement should be considered a full-expression,
 581    i.e., if temporaries created during this statement should have
 582    their destructors run at the end of this statement.  (In C, this
 583    will always be false, since there are no destructors.)  */
 584 #define STMT_IS_FULL_EXPR_P(NODE) TREE_LANG_FLAG_1 ((NODE))
 585
 586 /* IF_STMT accessors. These give access to the condtion of the if
 587    statement, the then block of the if statement, and the else block
 588    of the if stsatement if it exists. */
 589 #define IF_COND(NODE)           TREE_OPERAND (IF_STMT_CHECK (NODE), 0)
 590 #define THEN_CLAUSE(NODE)       TREE_OPERAND (IF_STMT_CHECK (NODE), 1)
 591 #define ELSE_CLAUSE(NODE)       TREE_OPERAND (IF_STMT_CHECK (NODE), 2)
 592
 593 /* WHILE_STMT accessors. These give access to the condtion of the
 594    while statement and the body of the while statement, respectively. */
 595 #define WHILE_COND(NODE)        TREE_OPERAND (WHILE_STMT_CHECK (NODE), 0)
 596 #define WHILE_BODY(NODE)        TREE_OPERAND (WHILE_STMT_CHECK (NODE), 1)
 597
 598 /* DO_STMT accessors. These give access to the condition of the do
 599    statement and the body of the do statement, respectively. */
 600 #define DO_COND(NODE)           TREE_OPERAND (DO_STMT_CHECK (NODE), 0)
 601 #define DO_BODY(NODE)           TREE_OPERAND (DO_STMT_CHECK (NODE), 1)
 602
 603 /* RETURN_STMT accessors. These give the expression associated with a
 604    return statement, and whether it should be ignored when expanding
 605    (as opposed to inlining).  */
 606 #define RETURN_EXPR(NODE)       TREE_OPERAND (RETURN_STMT_CHECK (NODE), 0)
 607
 608 /* EXPR_STMT accessor. This gives the expression associated with an
 609    expression statement. */
 610 #define EXPR_STMT_EXPR(NODE)    TREE_OPERAND (EXPR_STMT_CHECK (NODE), 0)
 611
 612 /* FOR_STMT accessors. These give access to the init statement,
 613    condition, update expression, and body of the for statement,
 614    respectively. */
 615 #define FOR_INIT_STMT(NODE)     TREE_OPERAND (FOR_STMT_CHECK (NODE), 0)
 616 #define FOR_COND(NODE)          TREE_OPERAND (FOR_STMT_CHECK (NODE), 1)
 617 #define FOR_EXPR(NODE)          TREE_OPERAND (FOR_STMT_CHECK (NODE), 2)
 618 #define FOR_BODY(NODE)          TREE_OPERAND (FOR_STMT_CHECK (NODE), 3)
 619
 620 /* SWITCH_STMT accessors. These give access to the condition and body
 621    of the switch statement, respectively. */
 622 #define SWITCH_COND(NODE)       TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 0)
 623 #define SWITCH_BODY(NODE)       TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 1)
 624
 625 /* CASE_LABEL accessors. These give access to the high and low values
 626    of a case label, respectively. */
 627 #define CASE_LOW(NODE)          TREE_OPERAND (CASE_LABEL_CHECK (NODE), 0)
 628 #define CASE_HIGH(NODE)         TREE_OPERAND (CASE_LABEL_CHECK (NODE), 1)
 629 #define CASE_LABEL_DECL(NODE)   TREE_OPERAND (CASE_LABEL_CHECK (NODE), 2)
 630
 631 /* GOTO_STMT accessor. This gives access to the label associated with
 632    a goto statement. */
 633 #define GOTO_DESTINATION(NODE)  TREE_OPERAND (GOTO_STMT_CHECK (NODE), 0)
 634
 635 /* COMPOUND_STMT accessor. This gives access to the TREE_LIST of
 636    statements assocated with a compound statement. The result is the
 637    first statement in the list. Succeeding nodes can be acccessed by
 638    calling TREE_CHAIN on a node in the list. */
 639 #define COMPOUND_BODY(NODE)     TREE_OPERAND (COMPOUND_STMT_CHECK (NODE), 0)
 640
 641 /* ASM_STMT accessors. ASM_STRING returns a STRING_CST for the
 642    instruction (e.g., "mov x, y"). ASM_OUTPUTS, ASM_INPUTS, and
 643    ASM_CLOBBERS represent the outputs, inputs, and clobbers for the
 644    statement. */
 645 #define ASM_CV_QUAL(NODE)       TREE_OPERAND (ASM_STMT_CHECK (NODE), 0)
 646 #define ASM_STRING(NODE)        TREE_OPERAND (ASM_STMT_CHECK (NODE), 1)
 647 #define ASM_OUTPUTS(NODE)       TREE_OPERAND (ASM_STMT_CHECK (NODE), 2)
 648 #define ASM_INPUTS(NODE)        TREE_OPERAND (ASM_STMT_CHECK (NODE), 3)
 649 #define ASM_CLOBBERS(NODE)      TREE_OPERAND (ASM_STMT_CHECK (NODE), 4)
 650
 651 /* DECL_STMT accessor. This gives access to the DECL associated with
 652    the given declaration statement. */
 653 #define DECL_STMT_DECL(NODE)    TREE_OPERAND (DECL_STMT_CHECK (NODE), 0)
 654
 655 /* STMT_EXPR accessor. */
 656 #define STMT_EXPR_STMT(NODE)    TREE_OPERAND (STMT_EXPR_CHECK (NODE), 0)
 657
 658 /* LABEL_STMT accessor. This gives access to the label associated with
 659    the given label statement. */
 660 #define LABEL_STMT_LABEL(NODE)  TREE_OPERAND (LABEL_STMT_CHECK (NODE), 0)
 661
 662 /* Nonzero if this SCOPE_STMT is for the beginning of a scope.  */
 663 #define SCOPE_BEGIN_P(NODE) \
 664   (TREE_LANG_FLAG_0 (SCOPE_STMT_CHECK (NODE)))
 665
 666 /* Nonzero if this SCOPE_STMT is for the end of a scope.  */
 667 #define SCOPE_END_P(NODE) \
 668   (!SCOPE_BEGIN_P (SCOPE_STMT_CHECK (NODE)))
 669
 670 /* The BLOCK containing the declarations contained in this scope.  */
 671 #define SCOPE_STMT_BLOCK(NODE) \
 672   (TREE_OPERAND (SCOPE_STMT_CHECK (NODE), 0))
 673
 674 /* Nonzero for a SCOPE_STMT if there were no variables in this scope.  */
 675 #define SCOPE_NULLIFIED_P(NODE) \
 676   (SCOPE_STMT_BLOCK ((NODE)) == NULL_TREE)
 677
 678 /* Nonzero for a SCOPE_STMT which represents a lexical scope, but
 679    which should be treated as non-existant from the point of view of
 680    running cleanup actions.  */
 681 #define SCOPE_NO_CLEANUPS_P(NODE) \
 682   (TREE_LANG_FLAG_3 (SCOPE_STMT_CHECK (NODE)))
 683
 684 /* Nonzero for a SCOPE_STMT if this statement is for a partial scope.
 685    For example, in:
 686
 687      S s;
 688      l:
 689      S s2;
 690      goto l;
 691
 692    there is (implicitly) a new scope after `l', even though there are
 693    no curly braces.  In particular, when we hit the goto, we must
 694    destroy s2 and then re-construct it.  For the implicit scope,
 695    SCOPE_PARTIAL_P will be set.  */
 696 #define SCOPE_PARTIAL_P(NODE) \
 697   (TREE_LANG_FLAG_4 (SCOPE_STMT_CHECK (NODE)))
 698
 699 /* Nonzero for an ASM_STMT if the assembly statement is volatile.  */
 700 #define ASM_VOLATILE_P(NODE)                    \
 701   (ASM_CV_QUAL (ASM_STMT_CHECK (NODE)) != NULL_TREE)
 702
 703 /* The line-number at which a statement began.  But if
 704    STMT_LINENO_FOR_FN_P does holds, then this macro gives the
 705    line number for the end of the current function instead.  */
 706 #define STMT_LINENO(NODE)                       \
 707   (TREE_COMPLEXITY ((NODE)))
 708
 709 /* If non-zero, the STMT_LINENO for NODE is the line at which the
 710    function ended.  */
 711 #define STMT_LINENO_FOR_FN_P(NODE)              \
 712   (TREE_LANG_FLAG_2 ((NODE)))
 713
 714 /* Nonzero if we want the new ISO rules for pushing a new scope for `for'
 715    initialization variables. */
 716 #define NEW_FOR_SCOPE_P(NODE) (TREE_LANG_FLAG_0 (NODE))
 717
 718 /* Nonzero if we want to create an ASM_INPUT instead of an
 719    ASM_OPERAND with no operands.  */
 720 #define ASM_INPUT_P(NODE) (TREE_LANG_FLAG_0 (NODE))
 721
 722 #define DEFTREECODE(SYM, NAME, TYPE, LENGTH) SYM,
 723
 724 enum c_tree_code {
 725   C_DUMMY_TREE_CODE = LAST_AND_UNUSED_TREE_CODE,
 726 #include "c-common.def"
 727   LAST_C_TREE_CODE
 728 };
 729
 730 #undef DEFTREECODE
 731
 732 extern void add_c_tree_codes                    PARAMS ((void));
 733 extern void genrtl_do_pushlevel                 PARAMS ((void));
 734 extern void genrtl_goto_stmt                    PARAMS ((tree));
 735 extern void genrtl_expr_stmt                    PARAMS ((tree));
 736 extern void genrtl_decl_stmt                    PARAMS ((tree));
 737 extern void genrtl_if_stmt                      PARAMS ((tree));
 738 extern void genrtl_while_stmt                   PARAMS ((tree));
 739 extern void genrtl_do_stmt                      PARAMS ((tree));
 740 extern void genrtl_return_stmt                  PARAMS ((tree));
 741 extern void genrtl_for_stmt                     PARAMS ((tree));
 742 extern void genrtl_break_stmt                   PARAMS ((void));
 743 extern void genrtl_continue_stmt                PARAMS ((void));
 744 extern void genrtl_scope_stmt                   PARAMS ((tree));
 745 extern void genrtl_switch_stmt                  PARAMS ((tree));
 746 extern void genrtl_case_label                   PARAMS ((tree));
 747 extern void genrtl_compound_stmt                PARAMS ((tree));
 748 extern void genrtl_asm_stmt                     PARAMS ((tree, tree,
 749                                                          tree, tree,
 750                                                          tree, int));
 751 extern void genrtl_decl_cleanup                 PARAMS ((tree, tree));
 752 extern int stmts_are_full_exprs_p               PARAMS ((void));
 753 extern int anon_aggr_type_p                     PARAMS ((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 /* In a VAR_DECL, nonzero if the decl is a register variable with
 768    an explicit asm specification.  */
 769 #define DECL_C_HARD_REGISTER(DECL)  DECL_LANG_FLAG_4 (VAR_DECL_CHECK (DECL))
 770
 771 extern void emit_local_var                      PARAMS ((tree));
 772 extern void make_rtl_for_local_static           PARAMS ((tree));
 773 extern tree expand_cond                         PARAMS ((tree));
 774 extern tree c_expand_return                     PARAMS ((tree));
 775 extern tree do_case                             PARAMS ((tree, tree));
 776 extern tree build_stmt                          PARAMS ((enum tree_code, ...));
 777 extern tree build_case_label                    PARAMS ((tree, tree, tree));
 778 extern tree build_continue_stmt                 PARAMS ((void));
 779 extern tree build_break_stmt                    PARAMS ((void));
 780 extern tree build_return_stmt                   PARAMS ((tree));
 781
 782 #define COMPOUND_STMT_NO_SCOPE(NODE)    TREE_LANG_FLAG_0 (NODE)
 783
 784 extern void c_expand_asm_operands               PARAMS ((tree, tree, tree, tree, int, const char *, int));
 785
 786 /* These functions must be defined by each front-end which implements
 787    a variant of the C language.  They are used in c-common.c.  */
 788
 789 extern tree build_unary_op                      PARAMS ((enum tree_code,
 790                                                          tree, int));
 791 extern tree build_binary_op                     PARAMS ((enum tree_code,
 792                                                          tree, tree, int));
 793 extern int lvalue_p                             PARAMS ((tree));
 794 extern tree default_conversion                  PARAMS ((tree));
 795
 796 /* Given two integer or real types, return the type for their sum.
 797    Given two compatible ANSI C types, returns the merged type.  */
 798
 799 extern tree common_type                         PARAMS ((tree, tree));
 800
 801 extern tree expand_tree_builtin                 PARAMS ((tree, tree, tree));
 802
 803 extern tree decl_constant_value         PARAMS ((tree));
 804
 805 /* Handle increment and decrement of boolean types.  */
 806 extern tree boolean_increment                   PARAMS ((enum tree_code,
 807                                                          tree));
 808
 809 /* Hook currently used only by the C++ front end to reset internal state
 810    after entering or leaving a header file.  */
 811 extern void extract_interface_info              PARAMS ((void));
 812
 813 extern void mark_c_language_function            PARAMS ((struct language_function *));
 814
 815 extern int case_compare                         PARAMS ((splay_tree_key,
 816                                                          splay_tree_key));
 817
 818 extern tree c_add_case_label                    PARAMS ((splay_tree,
 819                                                          tree, tree,
 820                                                          tree));
 821
 822 extern tree build_function_call                 PARAMS ((tree, tree));
 823
 824 extern tree finish_label_address_expr           PARAMS ((tree));
 825
 826 /* Same function prototype, but the C and C++ front ends have
 827    different implementations.  Used in c-common.c.  */
 828 extern tree lookup_label                        PARAMS ((tree));
 829
 830 /* If this variable is defined to a non-NULL value, it will be called
 831    after the file has been completely parsed.  The argument will be
 832    the GLOBAL_NAMESPACE in C++, or the list of top-level declarations
 833    in C.  */
 834 extern void (*back_end_hook) PARAMS ((tree));
 835
 836 #ifdef RTX_CODE
 837
 838 extern struct rtx_def *c_expand_expr            PARAMS ((tree, rtx,
 839                                                          enum machine_mode,
 840                                                          enum expand_modifier));
 841
 842 extern int c_safe_from_p                        PARAMS ((rtx, tree));
 843 #endif
 844
 845 extern int c_unsafe_for_reeval                  PARAMS ((tree));
 846
 847 /* In c-dump.c */
 848
 849 /* Different tree dump places.  When you add new tree dump places,
 850    extend the DUMP_FILES array in c-dump.c */
 851 enum tree_dump_index
 852 {
 853   TDI_all,                      /* dump the whole translation unit */
 854   TDI_class,                    /* dump class heirarchy */
 855   TDI_original,                 /* dump each function before optimizing it */
 856   TDI_optimized,                /* dump each function after optimizing it */
 857   TDI_inlined,                  /* dump each function after inlining
 858                                    within it. */
 859   TDI_end
 860 };
 861
 862 /* Bit masks to control tree dumping. Not all values are applicable to
 863    all tree dumps. Add new ones at the end. When you define new
 864    values, extend the DUMP_OPTIONS array in c-dump.c */
 865 #define TDF_ADDRESS     (1 << 0)        /* dump node addresses */
 866 #define TDF_SLIM        (1 << 1)        /* don't go wild following links */
 867
 868 typedef struct dump_info *dump_info_p;
 869
 870 /* A callback function used dump language-specific parts of tree
 871    nodes.  Returns non-zero if it does not want the usual dumping of
 872    the second argument.  */
 873
 874 typedef int (*dump_tree_fn) PARAMS ((dump_info_p, tree));
 875
 876 extern dump_tree_fn lang_dump_tree;
 877
 878 extern int dump_flag                    PARAMS ((dump_info_p, int, tree));
 879 extern int dump_enabled_p               PARAMS ((enum tree_dump_index));
 880 extern FILE *dump_begin                 PARAMS ((enum tree_dump_index, int *));
 881 extern void dump_end                    PARAMS ((enum tree_dump_index, FILE *));
 882 extern void dump_node                   PARAMS ((tree, int, FILE *));
 883 extern int dump_switch_p                PARAMS ((const char *));
 884 extern const char *dump_flag_name       PARAMS ((enum tree_dump_index));
 885
 886 /* Information recorded about each file examined during compilation.  */
 887
 888 struct c_fileinfo
 889 {
 890   int time;     /* Time spent in the file.  */
 891   short interface_only;         /* Flags - used only by C++ */
 892   short interface_unknown;
 893 };
 894
 895 struct c_fileinfo *get_fileinfo                 PARAMS ((const char *));
 896 extern void dump_time_statistics                PARAMS ((void));
 897
 898 #endif /* ! GCC_C_COMMON_H */