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