gcc/c-tree.h

   1 /* Definitions for C parsing and type checking.
   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 _C_TREE_H
  23 #define _C_TREE_H
  24
  25 #include "c-common.h"
  26
  27 /* Language-dependent contents of an identifier.  */
  28
  29 /* The limbo_value is used for block level extern declarations, which need
  30    to be type checked against subsequent extern declarations.  They can't
  31    be referenced after they fall out of scope, so they can't be global.  */
  32
  33 struct lang_identifier
  34 {
  35   struct tree_identifier ignore;
  36   tree global_value, local_value, label_value, implicit_decl;
  37   tree error_locus, limbo_value;
  38 };
  39
  40 /* Macros for access to language-specific slots in an identifier.  */
  41 /* Each of these slots contains a DECL node or null.  */
  42
  43 /* This represents the value which the identifier has in the
  44    file-scope namespace.  */
  45 #define IDENTIFIER_GLOBAL_VALUE(NODE)   \
  46   (((struct lang_identifier *) (NODE))->global_value)
  47 /* This represents the value which the identifier has in the current
  48    scope.  */
  49 #define IDENTIFIER_LOCAL_VALUE(NODE)    \
  50   (((struct lang_identifier *) (NODE))->local_value)
  51 /* This represents the value which the identifier has as a label in
  52    the current label scope.  */
  53 #define IDENTIFIER_LABEL_VALUE(NODE)    \
  54   (((struct lang_identifier *) (NODE))->label_value)
  55 /* This records the extern decl of this identifier, if it has had one
  56    at any point in this compilation.  */
  57 #define IDENTIFIER_LIMBO_VALUE(NODE)    \
  58   (((struct lang_identifier *) (NODE))->limbo_value)
  59 /* This records the implicit function decl of this identifier, if it
  60    has had one at any point in this compilation.  */
  61 #define IDENTIFIER_IMPLICIT_DECL(NODE)  \
  62   (((struct lang_identifier *) (NODE))->implicit_decl)
  63 /* This is the last function in which we printed an "undefined variable"
  64    message for this identifier.  Value is a FUNCTION_DECL or null.  */
  65 #define IDENTIFIER_ERROR_LOCUS(NODE)    \
  66   (((struct lang_identifier *) (NODE))->error_locus)
  67
  68 /* In identifiers, C uses the following fields in a special way:
  69    TREE_PUBLIC        to record that there was a previous local extern decl.
  70    TREE_USED          to record that such a decl was used.
  71    TREE_ADDRESSABLE   to record that the address of such a decl was used.  */
  72
  73 /* Nonzero means reject anything that ANSI standard C forbids.  */
  74 extern int pedantic;
  75
  76 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is read-only.  */
  77 #define C_TYPE_FIELDS_READONLY(type) TREE_LANG_FLAG_1 (type)
  78
  79 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is volatile.  */
  80 #define C_TYPE_FIELDS_VOLATILE(type) TREE_LANG_FLAG_2 (type)
  81
  82 /* In a RECORD_TYPE or UNION_TYPE or ENUMERAL_TYPE
  83    nonzero if the definition of the type has already started.  */
  84 #define C_TYPE_BEING_DEFINED(type) TYPE_LANG_FLAG_0 (type)
  85
  86 /* C types are partitioned into three subsets: object, function, and
  87    incomplete types.  */
  88 #define C_TYPE_OBJECT_P(type) \
  89   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
  90
  91 #define C_TYPE_FUNCTION_P(type) \
  92   (TREE_CODE (type) == FUNCTION_TYPE)
  93
  94 #define C_TYPE_INCOMPLETE_P(type) \
  95   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
  96
  97 /* For convenience we define a single macro to identify the class of
  98    object or incomplete types.  */
  99 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
 100   (!C_TYPE_FUNCTION_P (type))
 101
 102 /* In a RECORD_TYPE, a sorted array of the fields of the type.  */
 103 struct lang_type
 104 {
 105   int len;
 106   tree elts[1];
 107 };
 108
 109 /* Mark which labels are explicitly declared.
 110    These may be shadowed, and may be referenced from nested functions.  */
 111 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
 112
 113 /* Record whether a type or decl was written with nonconstant size.
 114    Note that TYPE_SIZE may have simplified to a constant.  */
 115 #define C_TYPE_VARIABLE_SIZE(type) TYPE_LANG_FLAG_1 (type)
 116 #define C_DECL_VARIABLE_SIZE(type) DECL_LANG_FLAG_0 (type)
 117
 118 /* Record in each node resulting from a binary operator
 119    what operator was specified for it.  */
 120 #define C_EXP_ORIGINAL_CODE(exp) ((enum tree_code) TREE_COMPLEXITY (exp))
 121
 122 #if 0 /* Not used.  */
 123 /* Record whether a decl for a function or function pointer has
 124    already been mentioned (in a warning) because it was called
 125    but didn't have a prototype.  */
 126 #define C_MISSING_PROTOTYPE_WARNED(decl) DECL_LANG_FLAG_2(decl)
 127 #endif
 128
 129 /* Store a value in that field.  */
 130 #define C_SET_EXP_ORIGINAL_CODE(exp, code) \
 131   (TREE_COMPLEXITY (exp) = (int) (code))
 132
 133 /* Record whether a typedef for type `int' was actually `signed int'.  */
 134 #define C_TYPEDEF_EXPLICITLY_SIGNED(exp) DECL_LANG_FLAG_1 ((exp))
 135
 136 /* Nonzero for a declaration of a built in function if there has been no
 137    occasion that would declare the function in ordinary C.
 138    Using the function draws a pedantic warning in this case.  */
 139 #define C_DECL_ANTICIPATED(exp) DECL_LANG_FLAG_3 ((exp))
 140
 141 /* For FUNCTION_TYPE, a hidden list of types of arguments.  The same as
 142    TYPE_ARG_TYPES for functions with prototypes, but created for functions
 143    without prototypes.  */
 144 #define TYPE_ACTUAL_ARG_TYPES(NODE) TYPE_NONCOPIED_PARTS (NODE)
 145
 146 /* In a FIELD_DECL, nonzero if the decl was originally a bitfield.  */
 147 #define DECL_C_BIT_FIELD(NODE) DECL_LANG_FLAG_4 (NODE)
 148
 149 /* In a VAR_DECL, means the variable is really an iterator.  */
 150 #define ITERATOR_P(D) (DECL_LANG_FLAG_4(D))
 151
 152 /* In a VAR_DECL for an iterator, means we are within
 153    an explicit loop over that iterator.  */
 154 #define ITERATOR_BOUND_P(NODE) ((NODE)->common.readonly_flag)
 155 \f
 156 /* in c-lang.c and objc-act.c */
 157 extern tree lookup_interface                    PARAMS ((tree));
 158 extern tree is_class_name                       PARAMS ((tree));
 159 extern void maybe_objc_check_decl               PARAMS ((tree));
 160 extern void finish_file                         PARAMS ((void));
 161 extern int maybe_objc_comptypes                 PARAMS ((tree, tree, int));
 162 extern tree maybe_building_objc_message_expr    PARAMS ((void));
 163 extern tree maybe_objc_method_name              PARAMS ((tree));
 164 extern int recognize_objc_keyword               PARAMS ((void));
 165 extern tree build_objc_string                   PARAMS ((int, const char *));
 166 \f
 167 /* in c-parse.in */
 168 extern void c_parse_init                        PARAMS ((void));
 169
 170 /* in c-aux-info.c */
 171 extern void gen_aux_info_record                 PARAMS ((tree, int, int, int));
 172
 173 /* In c-common.c */
 174 extern unsigned int min_precision               PARAMS ((tree, int));
 175
 176 /* in c-convert.c */
 177 extern tree convert                             PARAMS ((tree, tree));
 178
 179 /* in c-decl.c */
 180 extern tree build_enumerator                    PARAMS ((tree, tree));
 181 /* Add qualifiers to a type, in the fashion for C.  */
 182 extern tree c_build_qualified_type              PARAMS ((tree, int));
 183 #define c_build_type_variant(TYPE, CONST_P, VOLATILE_P)           \
 184   c_build_qualified_type (TYPE,                                   \
 185                           ((CONST_P) ? TYPE_QUAL_CONST : 0) |     \
 186                           ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
 187 extern int  c_decode_option                     PARAMS ((int, char **));
 188 extern void c_mark_varargs                      PARAMS ((void));
 189 extern tree check_identifier                    PARAMS ((tree, tree));
 190 extern void clear_parm_order                    PARAMS ((void));
 191 extern tree combine_parm_decls                  PARAMS ((tree, tree, int));
 192 extern int  complete_array_type                 PARAMS ((tree, tree, int));
 193 extern void declare_parm_level                  PARAMS ((int));
 194 extern tree define_label                        PARAMS ((char *, int, tree));
 195 extern void delete_block                        PARAMS ((tree));
 196 extern void finish_decl                         PARAMS ((tree, tree, tree));
 197 extern void finish_decl_top_level               PARAMS ((tree, tree, tree));
 198 extern tree finish_enum                         PARAMS ((tree, tree, tree));
 199 extern void finish_function                     PARAMS ((int));
 200 extern tree finish_struct                       PARAMS ((tree, tree, tree));
 201 extern tree get_parm_info                       PARAMS ((int));
 202 extern tree getdecls                            PARAMS ((void));
 203 extern tree gettags                             PARAMS ((void));
 204 extern int  global_bindings_p                   PARAMS ((void));
 205 extern tree grokfield                           PARAMS ((const char *, int, tree, tree, tree));
 206 extern tree groktypename                        PARAMS ((tree));
 207 extern tree groktypename_in_parm_context        PARAMS ((tree));
 208 extern tree implicitly_declare                  PARAMS ((tree));
 209 extern int  in_parm_level_p                     PARAMS ((void));
 210 extern void init_decl_processing                PARAMS ((void));
 211 extern void insert_block                        PARAMS ((tree));
 212 extern void keep_next_level                     PARAMS ((void));
 213 extern int  kept_level_p                        PARAMS ((void));
 214 extern tree lookup_label                        PARAMS ((tree));
 215 extern tree lookup_name                         PARAMS ((tree));
 216 extern tree lookup_name_current_level           PARAMS ((tree));
 217 extern tree lookup_name_current_level_global    PARAMS ((tree));
 218 extern tree maybe_build_cleanup                 PARAMS ((tree));
 219 extern void parmlist_tags_warning               PARAMS ((void));
 220 extern void pending_xref_error                  PARAMS ((void));
 221 extern void mark_c_function_context             PARAMS ((struct function *));
 222 extern void push_c_function_context             PARAMS ((struct function *));
 223 extern void pop_c_function_context              PARAMS ((struct function *));
 224 extern void pop_label_level                     PARAMS ((void));
 225 extern tree poplevel                            PARAMS ((int, int, int));
 226 extern void print_lang_decl                     PARAMS ((FILE *, tree, int));
 227 extern void print_lang_identifier               PARAMS ((FILE *, tree, int));
 228 extern void print_lang_type                     PARAMS ((FILE *, tree, int));
 229 extern void push_label_level                    PARAMS ((void));
 230 extern void push_parm_decl                      PARAMS ((tree));
 231 extern tree pushdecl                            PARAMS ((tree));
 232 extern tree pushdecl_top_level                  PARAMS ((tree));
 233 extern void pushlevel                           PARAMS ((int));
 234 extern void pushtag                             PARAMS ((tree, tree));
 235 extern void set_block                           PARAMS ((tree));
 236 extern tree shadow_label                        PARAMS ((tree));
 237 extern void shadow_record_fields                PARAMS ((tree));
 238 extern void shadow_tag                          PARAMS ((tree));
 239 extern void shadow_tag_warned                   PARAMS ((tree, int));
 240 extern tree start_enum                          PARAMS ((tree));
 241 extern int  start_function                      PARAMS ((tree, tree, tree,
 242                                                          tree));
 243 extern tree start_decl                          PARAMS ((tree, tree, int,
 244                                                          tree, tree));
 245 extern tree start_struct                        PARAMS ((enum tree_code, tree));
 246 extern void store_parm_decls                    PARAMS ((void));
 247 extern tree xref_tag                            PARAMS ((enum tree_code, tree));
 248
 249 /* in c-typeck.c */
 250 extern tree require_complete_type               PARAMS ((tree));
 251 extern void incomplete_type_error               PARAMS ((tree, tree));
 252 /* Given two integer or real types, return the type for their sum.
 253    Given two compatible ANSI C types, returns the merged type.  */
 254 extern tree common_type                         PARAMS ((tree, tree));
 255 extern int comptypes                            PARAMS ((tree, tree));
 256 extern tree c_sizeof                            PARAMS ((tree));
 257 extern tree c_sizeof_nowarn                     PARAMS ((tree));
 258 extern tree c_size_in_bytes                     PARAMS ((tree));
 259 extern tree c_alignof                           PARAMS ((tree));
 260 extern tree c_alignof_expr                      PARAMS ((tree));
 261 extern tree default_conversion                  PARAMS ((tree));
 262 extern tree build_component_ref                 PARAMS ((tree, tree));
 263 extern tree build_indirect_ref                  PARAMS ((tree, const char *));
 264 extern tree build_array_ref                     PARAMS ((tree, tree));
 265 extern tree build_function_call                 PARAMS ((tree, tree));
 266 extern tree parser_build_binary_op              PARAMS ((enum tree_code,
 267                                                          tree, tree));
 268 extern tree build_binary_op                     PARAMS ((enum tree_code,
 269                                                          tree, tree, int));
 270 extern tree build_unary_op                      PARAMS ((enum tree_code,
 271                                                          tree, int));
 272 extern int lvalue_p                             PARAMS ((tree));
 273 extern int lvalue_or_else                       PARAMS ((tree, const char *));
 274 extern void readonly_warning                    PARAMS ((tree, const char *));
 275 extern int mark_addressable                     PARAMS ((tree));
 276 extern tree build_conditional_expr              PARAMS ((tree, tree, tree));
 277 extern tree build_compound_expr                 PARAMS ((tree));
 278 extern tree build_c_cast                        PARAMS ((tree, tree));
 279 extern tree build_modify_expr                   PARAMS ((tree, enum tree_code,
 280                                                          tree));
 281 extern void store_init_value                    PARAMS ((tree, tree));
 282 extern void error_init                          PARAMS ((const char *));
 283 extern void pedwarn_init                        PARAMS ((const char *));
 284 extern void start_init                          PARAMS ((tree, tree, int));
 285 extern void finish_init                         PARAMS ((void));
 286 extern void really_start_incremental_init       PARAMS ((tree));
 287 extern void push_init_level                     PARAMS ((int));
 288 extern tree pop_init_level                      PARAMS ((int));
 289 extern void set_init_index                      PARAMS ((tree, tree));
 290 extern void set_init_label                      PARAMS ((tree));
 291 extern void process_init_element                PARAMS ((tree));
 292 extern void c_expand_asm_operands               PARAMS ((tree, tree, tree,
 293                                                          tree, int, char *,
 294                                                          int));
 295 extern void c_expand_return                     PARAMS ((tree));
 296 extern tree c_expand_start_case                 PARAMS ((tree));
 297
 298 /* in c-iterate.c */
 299 extern void init_iterators                      PARAMS ((void));
 300 extern void iterator_expand                     PARAMS ((tree));
 301 extern void iterator_for_loop_start             PARAMS ((tree));
 302 extern void iterator_for_loop_end               PARAMS ((tree));
 303 extern void iterator_for_loop_record            PARAMS ((tree));
 304 extern void push_iterator_stack                 PARAMS ((void));
 305 extern void pop_iterator_stack                  PARAMS ((void));
 306
 307 /* Set to 0 at beginning of a function definition, set to 1 if
 308    a return statement that specifies a return value is seen.  */
 309
 310 extern int current_function_returns_value;
 311
 312 /* Set to 0 at beginning of a function definition, set to 1 if
 313    a return statement with no argument is seen.  */
 314
 315 extern int current_function_returns_null;
 316
 317 /* Nonzero means the expression being parsed will never be evaluated.
 318    This is a count, since unevaluated expressions can nest.  */
 319
 320 extern int skip_evaluation;
 321
 322 /* Nonzero means `$' can be in an identifier.  */
 323
 324 extern int dollars_in_ident;
 325
 326 /* Nonzero means allow type mismatches in conditional expressions;
 327    just make their values `void'.   */
 328
 329 extern int flag_cond_mismatch;
 330
 331 /* Nonzero means don't recognize the keyword `asm'.  */
 332
 333 extern int flag_no_asm;
 334
 335 /* Nonzero means environment is hosted (i.e., not freestanding) */
 336
 337 extern int flag_hosted;
 338
 339 /* Nonzero means warn about implicit declarations.  */
 340
 341 extern int warn_implicit;
 342
 343 /* Nonzero means give string constants the type `const char *'
 344    to get extra warnings from them.  These warnings will be too numerous
 345    to be useful, except in thoroughly ANSIfied programs.  */
 346
 347 extern int flag_const_strings;
 348
 349 /* Nonzero means warn about sizeof (function) or addition/subtraction
 350    of function pointers.  */
 351
 352 extern int warn_pointer_arith;
 353
 354 /* Nonzero means warn for all old-style non-prototype function decls.  */
 355
 356 extern int warn_strict_prototypes;
 357
 358 /* Nonzero means warn about multiple (redundant) decls for the same single
 359    variable or function.  */
 360
 361 extern int warn_redundant_decls;
 362
 363 /* Nonzero means warn about extern declarations of objects not at
 364    file-scope level and about *all* declarations of functions (whether
 365    extern or static) not at file-scope level.  Note that we exclude
 366    implicit function declarations.  To get warnings about those, use
 367    -Wimplicit.  */
 368
 369 extern int warn_nested_externs;
 370
 371 /* Nonzero means warn about pointer casts that can drop a type qualifier
 372    from the pointer target type.  */
 373
 374 extern int warn_cast_qual;
 375
 376 /* Nonzero means warn when casting a function call to a type that does
 377    not match the return type (e.g. (float)sqrt() or (anything*)malloc()
 378    when there is no previous declaration of sqrt or malloc.  */
 379
 380 extern int warn_bad_function_cast;
 381
 382 /* Warn about functions which might be candidates for attribute noreturn. */
 383
 384 extern int warn_missing_noreturn;
 385
 386 /* Warn about traditional constructs whose meanings changed in ANSI C.  */
 387
 388 extern int warn_traditional;
 389
 390 /* Warn about *printf or *scanf format/argument anomalies. */
 391
 392 extern int warn_format;
 393
 394 /* Warn about a subscript that has type char.  */
 395
 396 extern int warn_char_subscripts;
 397
 398 /* Warn if a type conversion is done that might have confusing results.  */
 399
 400 extern int warn_conversion;
 401
 402 /* Warn if main is suspicious. */
 403
 404 extern int warn_main;
 405
 406 /* Nonzero means do some things the same way PCC does.  */
 407
 408 extern int flag_traditional;
 409
 410 /* Nonzero means use the ISO C99 dialect of C.  */
 411
 412 extern int flag_isoc99;
 413
 414 /* Nonzero means to allow single precision math even if we're generally
 415    being traditional. */
 416 extern int flag_allow_single_precision;
 417
 418 /* Nonzero means warn about suggesting putting in ()'s.  */
 419
 420 extern int warn_parentheses;
 421
 422 /* Warn if initializer is not completely bracketed.  */
 423
 424 extern int warn_missing_braces;
 425
 426 /* Warn about comparison of signed and unsigned values.  */
 427
 428 extern int warn_sign_compare;
 429
 430 /* Warn about testing equality of floating point numbers. */
 431
 432 extern int warn_float_equal;
 433
 434 /* Warn about multicharacter constants.  */
 435
 436 extern int warn_multichar;
 437
 438 /* Warn about long long.  */
 439
 440 extern int warn_long_long;
 441
 442 /* Nonzero means we are reading code that came from a system header file.  */
 443
 444 extern int system_header_p;
 445
 446 /* Nonzero enables objc features.  */
 447
 448 extern int doing_objc_thang;
 449
 450 /* In c-decl.c */
 451 extern void finish_incomplete_decl PARAMS ((tree));
 452
 453 #endif /* not _C_TREE_H */