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 ((const char *, int,
 195                                                          tree));
 196 extern void delete_block                        PARAMS ((tree));
 197 extern void finish_decl                         PARAMS ((tree, tree, tree));
 198 extern void finish_decl_top_level               PARAMS ((tree, tree, tree));
 199 extern tree finish_enum                         PARAMS ((tree, tree, tree));
 200 extern void finish_function                     PARAMS ((int));
 201 extern tree finish_struct                       PARAMS ((tree, tree, tree));
 202 extern tree get_parm_info                       PARAMS ((int));
 203 extern tree getdecls                            PARAMS ((void));
 204 extern tree gettags                             PARAMS ((void));
 205 extern int  global_bindings_p                   PARAMS ((void));
 206 extern tree grokfield                           PARAMS ((const char *, int, tree, tree, tree));
 207 extern tree groktypename                        PARAMS ((tree));
 208 extern tree groktypename_in_parm_context        PARAMS ((tree));
 209 extern tree implicitly_declare                  PARAMS ((tree));
 210 extern int  in_parm_level_p                     PARAMS ((void));
 211 extern void init_decl_processing                PARAMS ((void));
 212 extern void insert_block                        PARAMS ((tree));
 213 extern void keep_next_level                     PARAMS ((void));
 214 extern int  kept_level_p                        PARAMS ((void));
 215 extern tree lookup_label                        PARAMS ((tree));
 216 extern tree lookup_name                         PARAMS ((tree));
 217 extern tree lookup_name_current_level           PARAMS ((tree));
 218 extern tree lookup_name_current_level_global    PARAMS ((tree));
 219 extern tree maybe_build_cleanup                 PARAMS ((tree));
 220 extern void parmlist_tags_warning               PARAMS ((void));
 221 extern void pending_xref_error                  PARAMS ((void));
 222 extern void mark_c_function_context             PARAMS ((struct function *));
 223 extern void push_c_function_context             PARAMS ((struct function *));
 224 extern void pop_c_function_context              PARAMS ((struct function *));
 225 extern void pop_label_level                     PARAMS ((void));
 226 extern tree poplevel                            PARAMS ((int, int, int));
 227 extern void print_lang_decl                     PARAMS ((FILE *, tree, int));
 228 extern void print_lang_identifier               PARAMS ((FILE *, tree, int));
 229 extern void print_lang_type                     PARAMS ((FILE *, tree, int));
 230 extern void push_label_level                    PARAMS ((void));
 231 extern void push_parm_decl                      PARAMS ((tree));
 232 extern tree pushdecl                            PARAMS ((tree));
 233 extern tree pushdecl_top_level                  PARAMS ((tree));
 234 extern void pushlevel                           PARAMS ((int));
 235 extern void pushtag                             PARAMS ((tree, tree));
 236 extern void set_block                           PARAMS ((tree));
 237 extern tree shadow_label                        PARAMS ((tree));
 238 extern void shadow_record_fields                PARAMS ((tree));
 239 extern void shadow_tag                          PARAMS ((tree));
 240 extern void shadow_tag_warned                   PARAMS ((tree, int));
 241 extern tree start_enum                          PARAMS ((tree));
 242 extern int  start_function                      PARAMS ((tree, tree, tree,
 243                                                          tree));
 244 extern tree start_decl                          PARAMS ((tree, tree, int,
 245                                                          tree, tree));
 246 extern tree start_struct                        PARAMS ((enum tree_code, tree));
 247 extern void store_parm_decls                    PARAMS ((void));
 248 extern tree xref_tag                            PARAMS ((enum tree_code, tree));
 249
 250 /* in c-typeck.c */
 251 extern tree require_complete_type               PARAMS ((tree));
 252 extern void incomplete_type_error               PARAMS ((tree, tree));
 253 /* Given two integer or real types, return the type for their sum.
 254    Given two compatible ANSI C types, returns the merged type.  */
 255 extern tree common_type                         PARAMS ((tree, tree));
 256 extern int comptypes                            PARAMS ((tree, tree));
 257 extern tree c_sizeof                            PARAMS ((tree));
 258 extern tree c_sizeof_nowarn                     PARAMS ((tree));
 259 extern tree c_size_in_bytes                     PARAMS ((tree));
 260 extern tree c_alignof                           PARAMS ((tree));
 261 extern tree c_alignof_expr                      PARAMS ((tree));
 262 extern tree default_conversion                  PARAMS ((tree));
 263 extern tree build_component_ref                 PARAMS ((tree, tree));
 264 extern tree build_indirect_ref                  PARAMS ((tree, const char *));
 265 extern tree build_array_ref                     PARAMS ((tree, tree));
 266 extern tree build_function_call                 PARAMS ((tree, tree));
 267 extern tree parser_build_binary_op              PARAMS ((enum tree_code,
 268                                                          tree, tree));
 269 extern tree build_binary_op                     PARAMS ((enum tree_code,
 270                                                          tree, tree, int));
 271 extern tree build_unary_op                      PARAMS ((enum tree_code,
 272                                                          tree, int));
 273 extern int lvalue_p                             PARAMS ((tree));
 274 extern int lvalue_or_else                       PARAMS ((tree, const char *));
 275 extern void readonly_warning                    PARAMS ((tree, const char *));
 276 extern int mark_addressable                     PARAMS ((tree));
 277 extern tree build_conditional_expr              PARAMS ((tree, tree, tree));
 278 extern tree build_compound_expr                 PARAMS ((tree));
 279 extern tree build_c_cast                        PARAMS ((tree, tree));
 280 extern tree build_modify_expr                   PARAMS ((tree, enum tree_code,
 281                                                          tree));
 282 extern void store_init_value                    PARAMS ((tree, tree));
 283 extern void error_init                          PARAMS ((const char *));
 284 extern void pedwarn_init                        PARAMS ((const char *));
 285 extern void start_init                          PARAMS ((tree, tree, int));
 286 extern void finish_init                         PARAMS ((void));
 287 extern void really_start_incremental_init       PARAMS ((tree));
 288 extern void push_init_level                     PARAMS ((int));
 289 extern tree pop_init_level                      PARAMS ((int));
 290 extern void set_init_index                      PARAMS ((tree, tree));
 291 extern void set_init_label                      PARAMS ((tree));
 292 extern void process_init_element                PARAMS ((tree));
 293 extern void c_expand_asm_operands               PARAMS ((tree, tree, tree,
 294                                                          tree, int,
 295                                                          const char *, int));
 296 extern void c_expand_return                     PARAMS ((tree));
 297 extern tree c_expand_start_case                 PARAMS ((tree));
 298
 299 /* in c-iterate.c */
 300 extern void init_iterators                      PARAMS ((void));
 301 extern void iterator_expand                     PARAMS ((tree));
 302 extern void iterator_for_loop_start             PARAMS ((tree));
 303 extern void iterator_for_loop_end               PARAMS ((tree));
 304 extern void iterator_for_loop_record            PARAMS ((tree));
 305 extern void push_iterator_stack                 PARAMS ((void));
 306 extern void pop_iterator_stack                  PARAMS ((void));
 307
 308 /* Set to 0 at beginning of a function definition, set to 1 if
 309    a return statement that specifies a return value is seen.  */
 310
 311 extern int current_function_returns_value;
 312
 313 /* Set to 0 at beginning of a function definition, set to 1 if
 314    a return statement with no argument is seen.  */
 315
 316 extern int current_function_returns_null;
 317
 318 /* Nonzero means the expression being parsed will never be evaluated.
 319    This is a count, since unevaluated expressions can nest.  */
 320
 321 extern int skip_evaluation;
 322
 323 /* Nonzero means `$' can be in an identifier.  */
 324
 325 extern int dollars_in_ident;
 326
 327 /* Nonzero means allow type mismatches in conditional expressions;
 328    just make their values `void'.   */
 329
 330 extern int flag_cond_mismatch;
 331
 332 /* Nonzero means don't recognize the keyword `asm'.  */
 333
 334 extern int flag_no_asm;
 335
 336 /* Nonzero means environment is hosted (i.e., not freestanding) */
 337
 338 extern int flag_hosted;
 339
 340 /* Nonzero means warn about implicit declarations.  */
 341
 342 extern int warn_implicit;
 343
 344 /* Nonzero means give string constants the type `const char *'
 345    to get extra warnings from them.  These warnings will be too numerous
 346    to be useful, except in thoroughly ANSIfied programs.  */
 347
 348 extern int flag_const_strings;
 349
 350 /* Nonzero means warn about sizeof (function) or addition/subtraction
 351    of function pointers.  */
 352
 353 extern int warn_pointer_arith;
 354
 355 /* Nonzero means warn for all old-style non-prototype function decls.  */
 356
 357 extern int warn_strict_prototypes;
 358
 359 /* Nonzero means warn about multiple (redundant) decls for the same single
 360    variable or function.  */
 361
 362 extern int warn_redundant_decls;
 363
 364 /* Nonzero means warn about extern declarations of objects not at
 365    file-scope level and about *all* declarations of functions (whether
 366    extern or static) not at file-scope level.  Note that we exclude
 367    implicit function declarations.  To get warnings about those, use
 368    -Wimplicit.  */
 369
 370 extern int warn_nested_externs;
 371
 372 /* Nonzero means warn about pointer casts that can drop a type qualifier
 373    from the pointer target type.  */
 374
 375 extern int warn_cast_qual;
 376
 377 /* Nonzero means warn when casting a function call to a type that does
 378    not match the return type (e.g. (float)sqrt() or (anything*)malloc()
 379    when there is no previous declaration of sqrt or malloc.  */
 380
 381 extern int warn_bad_function_cast;
 382
 383 /* Warn about functions which might be candidates for attribute noreturn. */
 384
 385 extern int warn_missing_noreturn;
 386
 387 /* Warn about traditional constructs whose meanings changed in ANSI C.  */
 388
 389 extern int warn_traditional;
 390
 391 /* Warn about *printf or *scanf format/argument anomalies. */
 392
 393 extern int warn_format;
 394
 395 /* Warn about a subscript that has type char.  */
 396
 397 extern int warn_char_subscripts;
 398
 399 /* Warn if a type conversion is done that might have confusing results.  */
 400
 401 extern int warn_conversion;
 402
 403 /* Warn if main is suspicious. */
 404
 405 extern int warn_main;
 406
 407 /* Nonzero means do some things the same way PCC does.  */
 408
 409 extern int flag_traditional;
 410
 411 /* Nonzero means use the ISO C99 dialect of C.  */
 412
 413 extern int flag_isoc99;
 414
 415 /* Nonzero means to allow single precision math even if we're generally
 416    being traditional. */
 417 extern int flag_allow_single_precision;
 418
 419 /* Nonzero means warn about suggesting putting in ()'s.  */
 420
 421 extern int warn_parentheses;
 422
 423 /* Warn if initializer is not completely bracketed.  */
 424
 425 extern int warn_missing_braces;
 426
 427 /* Warn about comparison of signed and unsigned values.  */
 428
 429 extern int warn_sign_compare;
 430
 431 /* Warn about testing equality of floating point numbers. */
 432
 433 extern int warn_float_equal;
 434
 435 /* Warn about multicharacter constants.  */
 436
 437 extern int warn_multichar;
 438
 439 /* Warn about long long.  */
 440
 441 extern int warn_long_long;
 442
 443 /* Nonzero means we are reading code that came from a system header file.  */
 444
 445 extern int system_header_p;
 446
 447 /* Nonzero enables objc features.  */
 448
 449 #define doing_objc_thang \
 450   (c_language == clk_objective_c)
 451
 452 /* In c-decl.c */
 453 extern void finish_incomplete_decl PARAMS ((tree));
 454
 455 #endif /* not _C_TREE_H */