gcc/c-tree.h

   1 /* Definitions for C parsing and type checking.
   2    Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
   3    1999, 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify it under
   8 the terms of the GNU General Public License as published by the Free
   9 Software Foundation; either version 2, or (at your option) any later
  10 version.
  11
  12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GCC; see the file COPYING.  If not, write to the Free
  19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  20 02111-1307, USA.  */
  21
  22 #ifndef GCC_C_TREE_H
  23 #define GCC_C_TREE_H
  24
  25 #include "c-common.h"
  26 #include "diagnostic.h"
  27
  28 /* struct lang_identifier is private to c-decl.c, but langhooks.c needs to
  29    know how big it is.  This is sanity-checked in c-decl.c.  */
  30 #define C_SIZEOF_STRUCT_LANG_IDENTIFIER \
  31   (sizeof (struct c_common_identifier) + 3 * sizeof (void *))
  32
  33 /* For gc purposes, return the most likely link for the longest chain.  */
  34 #define C_LANG_TREE_NODE_CHAIN_NEXT(T)                          \
  35   ((union lang_tree_node *)                                     \
  36    (TREE_CODE (T) == INTEGER_TYPE ? TYPE_NEXT_VARIANT (T)       \
  37     : TREE_CODE (T) == COMPOUND_EXPR ? TREE_OPERAND (T, 1)      \
  38     : TREE_CHAIN (T)))
  39
  40 /* Language-specific declaration information.  */
  41
  42 struct lang_decl GTY(())
  43 {
  44   /* The return types and parameter types may have variable size.
  45      This is a list of any SAVE_EXPRs that need to be evaluated to
  46      compute those sizes.  */
  47   tree pending_sizes;
  48 };
  49
  50 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is read-only.  */
  51 #define C_TYPE_FIELDS_READONLY(TYPE) TREE_LANG_FLAG_1 (TYPE)
  52
  53 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is volatile.  */
  54 #define C_TYPE_FIELDS_VOLATILE(TYPE) TREE_LANG_FLAG_2 (TYPE)
  55
  56 /* In a RECORD_TYPE or UNION_TYPE or ENUMERAL_TYPE
  57    nonzero if the definition of the type has already started.  */
  58 #define C_TYPE_BEING_DEFINED(TYPE) TYPE_LANG_FLAG_0 (TYPE)
  59
  60 /* In an incomplete RECORD_TYPE or UNION_TYPE, a list of variable
  61    declarations whose type would be completed by completing that type.  */
  62 #define C_TYPE_INCOMPLETE_VARS(TYPE) TYPE_VFIELD (TYPE)
  63
  64 /* In an IDENTIFIER_NODE, nonzero if this identifier is actually a
  65    keyword.  C_RID_CODE (node) is then the RID_* value of the keyword,
  66    and C_RID_YYCODE is the token number wanted by Yacc.  */
  67 #define C_IS_RESERVED_WORD(ID) TREE_LANG_FLAG_0 (ID)
  68
  69 struct lang_type GTY(())
  70 {
  71   /* In a RECORD_TYPE, a sorted array of the fields of the type.  */
  72   struct sorted_fields_type * GTY ((reorder ("resort_sorted_fields"))) s;
  73   /* In an ENUMERAL_TYPE, the min and max values.  */
  74   tree enum_min;
  75   tree enum_max;
  76 };
  77
  78 /* Record whether a type or decl was written with nonconstant size.
  79    Note that TYPE_SIZE may have simplified to a constant.  */
  80 #define C_TYPE_VARIABLE_SIZE(TYPE) TYPE_LANG_FLAG_1 (TYPE)
  81 #define C_DECL_VARIABLE_SIZE(TYPE) DECL_LANG_FLAG_0 (TYPE)
  82
  83 /* Record whether a typedef for type `int' was actually `signed int'.  */
  84 #define C_TYPEDEF_EXPLICITLY_SIGNED(EXP) DECL_LANG_FLAG_1 (EXP)
  85
  86 /* For a FUNCTION_DECL, nonzero if it was defined without an explicit
  87    return type.  */
  88 #define C_FUNCTION_IMPLICIT_INT(EXP) DECL_LANG_FLAG_1 (EXP)
  89
  90 /* For a FUNCTION_DECL, nonzero if it was an implicit declaration.  */
  91 #define C_DECL_IMPLICIT(EXP) DECL_LANG_FLAG_2 (EXP)
  92
  93 /* For FUNCTION_DECLs, evaluates true if the decl is built-in but has
  94    been declared.  */
  95 #define C_DECL_DECLARED_BUILTIN(EXP) DECL_LANG_FLAG_3 (EXP)
  96
  97 /* Record whether a decl was declared register.  This is strictly a
  98    front-end flag, whereas DECL_REGISTER is used for code generation;
  99    they may differ for structures with volatile fields.  */
 100 #define C_DECL_REGISTER(EXP) DECL_LANG_FLAG_4 (EXP)
 101
 102 /* Record whether a decl was used in an expression anywhere except an
 103    unevaluated operand of sizeof / typeof / alignof.  This is only
 104    used for functions declared static but not defined, though outside
 105    sizeof and typeof it is set for other function decls as well.  */
 106 #define C_DECL_USED(EXP) DECL_LANG_FLAG_5 (EXP)
 107
 108 /* Nonzero for a decl which either doesn't exist or isn't a prototype.
 109    N.B. Could be simplified if all built-in decls had complete prototypes
 110    (but this is presently difficult because some of them need FILE*).  */
 111 #define C_DECL_ISNT_PROTOTYPE(EXP)                      \
 112        (EXP == 0                                        \
 113         || (TYPE_ARG_TYPES (TREE_TYPE (EXP)) == 0       \
 114             && !DECL_BUILT_IN (EXP)))
 115
 116 /* For FUNCTION_TYPE, a hidden list of types of arguments.  The same as
 117    TYPE_ARG_TYPES for functions with prototypes, but created for functions
 118    without prototypes.  */
 119 #define TYPE_ACTUAL_ARG_TYPES(NODE) TYPE_LANG_SLOT_1 (NODE)
 120
 121 /* Record parser information about an expression that is irrelevant
 122    for code generation alongside a tree representing its value.  */
 123 struct c_expr
 124 {
 125   /* The value of the expression.  */
 126   tree value;
 127   /* Record the original binary operator of an expression, which may
 128      have been changed by fold, STRING_CST for unparenthesised string
 129      constants, or ERROR_MARK for other expressions (including
 130      parenthesized expressions).  */
 131   enum tree_code original_code;
 132 };
 133
 134 /* The various kinds of declarators in C.  */
 135 enum c_declarator_kind {
 136   /* An identifier.  */
 137   cdk_id,
 138   /* A function.  */
 139   cdk_function,
 140   /* An array.  */
 141   cdk_array,
 142   /* A pointer.  */
 143   cdk_pointer,
 144   /* Parenthesized declarator with nested attributes.  */
 145   cdk_attrs
 146 };
 147
 148 /* Information about the parameters in a function declarator.  */
 149 struct c_arg_info {
 150   /* A list of parameter decls.  */
 151   tree parms;
 152   /* A list of structure, union and enum tags defined.  */
 153   tree tags;
 154   /* A list of argument types to go in the FUNCTION_TYPE.  */
 155   tree types;
 156   /* A list of non-parameter decls (notably enumeration constants)
 157      defined with the parameters.  */
 158   tree others;
 159 };
 160
 161 /* A declarator.  */
 162 struct c_declarator {
 163   /* The kind of declarator.  */
 164   enum c_declarator_kind kind;
 165   /* Except for cdk_id, the contained declarator.  For cdk_id, NULL.  */
 166   struct c_declarator *declarator;
 167   union {
 168     /* For identifiers, an IDENTIFIER_NODE or NULL_TREE if an abstract
 169        declarator.  */
 170     tree id;
 171     /* For functions.  */
 172     struct c_arg_info *arg_info;
 173     /* For arrays.  */
 174     struct {
 175       /* The array dimension, or NULL for [] and [*].  */
 176       tree dimen;
 177       /* The qualifiers (and attributes, currently ignored) inside [].  */
 178       tree quals;
 179       /* Whether [static] was used.  */
 180       BOOL_BITFIELD static_p : 1;
 181       /* Whether [*] was used.  */
 182       BOOL_BITFIELD vla_unspec_p : 1;
 183     } array;
 184     /* For pointers, the qualifiers on the pointer type.  */
 185     tree pointer_quals;
 186     /* For attributes.  */
 187     tree attrs;
 188   } u;
 189 };
 190
 191 /* A type name.  */
 192 struct c_type_name {
 193   /* The declaration specifiers.  */
 194   tree specs;
 195   /* The declarator.  */
 196   struct c_declarator *declarator;
 197 };
 198
 199 /* A parameter.  */
 200 struct c_parm {
 201   /* The declaration specifiers, minus any prefix attributes.  */
 202   tree specs;
 203   /* The attributes.  */
 204   tree attrs;
 205   /* The declarator.  */
 206   struct c_declarator *declarator;
 207 };
 208
 209 /* Save and restore the variables in this file and elsewhere
 210    that keep track of the progress of compilation of the current function.
 211    Used for nested functions.  */
 212
 213 struct language_function GTY(())
 214 {
 215   struct c_language_function base;
 216   tree x_break_label;
 217   tree x_cont_label;
 218   struct c_switch * GTY((skip)) x_switch_stack;
 219   struct c_arg_info * GTY((skip)) arg_info;
 220   int returns_value;
 221   int returns_null;
 222   int returns_abnormally;
 223   int warn_about_return_type;
 224   int extern_inline;
 225 };
 226
 227 \f
 228 /* in c-parse.in */
 229 extern void c_parse_init (void);
 230
 231 /* in c-aux-info.c */
 232 extern void gen_aux_info_record (tree, int, int, int);
 233
 234 /* in c-decl.c */
 235 extern struct obstack parser_obstack;
 236 extern tree c_break_label;
 237 extern tree c_cont_label;
 238
 239 extern int global_bindings_p (void);
 240 extern void push_scope (void);
 241 extern tree pop_scope (void);
 242 extern void insert_block (tree);
 243 extern tree pushdecl (tree);
 244 extern void c_expand_body (tree);
 245
 246 extern void c_init_decl_processing (void);
 247 extern void c_dup_lang_specific_decl (tree);
 248 extern void c_print_identifier (FILE *, tree, int);
 249 extern struct c_declarator *build_array_declarator (tree, tree, bool, bool);
 250 extern tree build_enumerator (tree, tree);
 251 extern void check_for_loop_decls (void);
 252 extern void mark_forward_parm_decls (void);
 253 extern int  complete_array_type (tree, tree, int);
 254 extern void declare_parm_level (void);
 255 extern void undeclared_variable (tree);
 256 extern tree declare_label (tree);
 257 extern tree define_label (location_t, tree);
 258 extern void finish_decl (tree, tree, tree);
 259 extern tree finish_enum (tree, tree, tree);
 260 extern void finish_function (void);
 261 extern tree finish_struct (tree, tree, tree);
 262 extern struct c_arg_info *get_parm_info (bool);
 263 extern tree grokfield (struct c_declarator *, tree, tree);
 264 extern void split_specs_attrs (tree, tree *, tree *);
 265 extern tree groktypename (struct c_type_name *);
 266 extern tree grokparm (const struct c_parm *);
 267 extern tree implicitly_declare (tree);
 268 extern void keep_next_level (void);
 269 extern tree lookup_name (tree);
 270 extern void pending_xref_error (void);
 271 extern void c_push_function_context (struct function *);
 272 extern void c_pop_function_context (struct function *);
 273 extern void push_parm_decl (const struct c_parm *);
 274 extern tree pushdecl_top_level (tree);
 275 extern struct c_declarator *set_array_declarator_inner (struct c_declarator *,
 276                                                         struct c_declarator *,
 277                                                         bool);
 278 extern tree builtin_function (const char *, tree, int, enum built_in_class,
 279                               const char *, tree);
 280 extern void shadow_tag (tree);
 281 extern void shadow_tag_warned (tree, int);
 282 extern tree start_enum (tree);
 283 extern int  start_function (tree, struct c_declarator *, tree);
 284 extern tree start_decl (struct c_declarator *, tree, bool, tree);
 285 extern tree start_struct (enum tree_code, tree);
 286 extern void store_parm_decls (void);
 287 extern void store_parm_decls_from (struct c_arg_info *);
 288 extern tree xref_tag (enum tree_code, tree);
 289 extern int c_expand_decl (tree);
 290 extern struct c_parm *build_c_parm (tree, tree, struct c_declarator *);
 291 extern struct c_declarator *build_attrs_declarator (tree,
 292                                                     struct c_declarator *);
 293 extern struct c_declarator *build_function_declarator (struct c_arg_info *,
 294                                                        struct c_declarator *);
 295 extern struct c_declarator *build_id_declarator (tree);
 296 extern struct c_declarator *make_pointer_declarator (tree,
 297                                                      struct c_declarator *);
 298
 299 /* in c-objc-common.c */
 300 extern int c_disregard_inline_limits (tree);
 301 extern int c_cannot_inline_tree_fn (tree *);
 302 extern bool c_objc_common_init (void);
 303 extern bool c_missing_noreturn_ok_p (tree);
 304 extern tree c_objc_common_truthvalue_conversion (tree expr);
 305 extern int defer_fn (tree);
 306 extern bool c_warn_unused_global_decl (tree);
 307 extern void c_initialize_diagnostics (diagnostic_context *);
 308
 309 #define c_build_type_variant(TYPE, CONST_P, VOLATILE_P)           \
 310   c_build_qualified_type ((TYPE),                                 \
 311                           ((CONST_P) ? TYPE_QUAL_CONST : 0) |     \
 312                           ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
 313
 314 /* in c-typeck.c */
 315 extern int in_alignof;
 316 extern int in_sizeof;
 317 extern int in_typeof;
 318
 319 extern struct c_switch *c_switch_stack;
 320
 321 extern tree require_complete_type (tree);
 322 extern int same_translation_unit_p (tree, tree);
 323 extern int comptypes (tree, tree);
 324 extern tree c_size_in_bytes (tree);
 325 extern bool c_mark_addressable (tree);
 326 extern void c_incomplete_type_error (tree, tree);
 327 extern tree c_type_promotes_to (tree);
 328 extern tree composite_type (tree, tree);
 329 extern tree build_component_ref (tree, tree);
 330 extern tree build_indirect_ref (tree, const char *);
 331 extern tree build_array_ref (tree, tree);
 332 extern tree build_external_ref (tree, int);
 333 extern void record_maybe_used_decl (tree);
 334 extern void pop_maybe_used (bool);
 335 extern struct c_expr c_expr_sizeof_expr (struct c_expr);
 336 extern struct c_expr c_expr_sizeof_type (struct c_type_name *);
 337 extern struct c_expr parser_build_binary_op (enum tree_code, struct c_expr,
 338                                              struct c_expr);
 339 extern void readonly_error (tree, const char *);
 340 extern tree build_conditional_expr (tree, tree, tree);
 341 extern tree build_compound_expr (tree, tree);
 342 extern tree c_cast_expr (struct c_type_name *, tree);
 343 extern tree build_c_cast (tree, tree);
 344 extern tree build_modify_expr (tree, enum tree_code, tree);
 345 extern void store_init_value (tree, tree);
 346 extern void error_init (const char *);
 347 extern void pedwarn_init (const char *);
 348 extern void maybe_warn_string_init (tree, struct c_expr);
 349 extern void start_init (tree, tree, int);
 350 extern void finish_init (void);
 351 extern void really_start_incremental_init (tree);
 352 extern void push_init_level (int);
 353 extern struct c_expr pop_init_level (int);
 354 extern void set_init_index (tree, tree);
 355 extern void set_init_label (tree);
 356 extern void process_init_element (struct c_expr);
 357 extern tree build_compound_literal (tree, tree);
 358 extern void pedwarn_c90 (const char *, ...) ATTRIBUTE_PRINTF_1;
 359 extern void pedwarn_c99 (const char *, ...) ATTRIBUTE_PRINTF_1;
 360 extern tree c_start_case (tree);
 361 extern void c_finish_case (tree);
 362 extern tree build_asm_expr (tree, tree, tree, tree, bool);
 363 extern tree build_asm_stmt (tree, tree);
 364 extern tree c_convert_parm_for_inlining (tree, tree, tree, int);
 365 extern int c_types_compatible_p (tree, tree);
 366 extern tree c_begin_compound_stmt (bool);
 367 extern tree c_end_compound_stmt (tree, bool);
 368 extern void c_finish_if_stmt (location_t, tree, tree, tree, bool);
 369 extern void c_finish_loop (location_t, tree, tree, tree, tree, tree, bool);
 370 extern tree c_begin_stmt_expr (void);
 371 extern tree c_finish_stmt_expr (tree);
 372 extern tree c_process_expr_stmt (tree);
 373 extern tree c_finish_expr_stmt (tree);
 374 extern tree c_finish_return (tree);
 375 extern tree c_finish_bc_stmt (tree *, bool);
 376 extern tree c_finish_goto_label (tree);
 377 extern tree c_finish_goto_ptr (tree);
 378
 379 /* Set to 0 at beginning of a function definition, set to 1 if
 380    a return statement that specifies a return value is seen.  */
 381
 382 extern int current_function_returns_value;
 383
 384 /* Set to 0 at beginning of a function definition, set to 1 if
 385    a return statement with no argument is seen.  */
 386
 387 extern int current_function_returns_null;
 388
 389 /* Set to 0 at beginning of a function definition, set to 1 if
 390    a call to a noreturn function is seen.  */
 391
 392 extern int current_function_returns_abnormally;
 393
 394 /* Nonzero means we are reading code that came from a system header file.  */
 395
 396 extern int system_header_p;
 397
 398 /* True means global_bindings_p should return false even if the scope stack
 399    says we are in file scope.  */
 400
 401 extern bool c_override_global_bindings_to_false;
 402
 403 /* True means we've initialized exception handling.  */
 404 extern bool c_eh_initialized_p;
 405
 406 /* In c-decl.c */
 407 extern void c_finish_incomplete_decl (tree);
 408 extern void c_write_global_declarations (void);
 409
 410 /* In order for the format checking to accept the C frontend
 411    diagnostic framework extensions, you must include this file before
 412    toplev.h, not after.  */
 413 #define GCC_DIAG_STYLE __gcc_cdiag__
 414
 415 #endif /* ! GCC_C_TREE_H */