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