gcc/c-common.h

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