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 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
  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    The rid_code field is used for keywords.  It is in all
  34    lang_identifier nodes, because some keywords are only special in a
  35    particular context.  */
  36
  37 struct lang_identifier GTY(())
  38 {
  39   struct c_common_identifier common_id;
  40   tree global_value;
  41   tree local_value;
  42   tree label_value;
  43   tree implicit_decl;
  44   tree error_locus;
  45   tree limbo_value;
  46 };
  47
  48 /* The resulting tree type.  */
  49
  50 union lang_tree_node
  51   GTY((desc ("TREE_CODE (&%h.generic) == IDENTIFIER_NODE")))
  52 {
  53   union tree_node GTY ((tag ("0"),
  54                         desc ("tree_node_structure (&%h)")))
  55     generic;
  56   struct lang_identifier GTY ((tag ("1"))) identifier;
  57 };
  58
  59 /* Language-specific declaration information.  */
  60
  61 struct lang_decl GTY(())
  62 {
  63   struct c_lang_decl base;
  64   /* The return types and parameter types may have variable size.
  65      This is a list of any SAVE_EXPRs that need to be evaluated to
  66      compute those sizes.  */
  67   tree pending_sizes;
  68 };
  69
  70 /* Macros for access to language-specific slots in an identifier.  */
  71 /* Each of these slots contains a DECL node or null.  */
  72
  73 /* This represents the value which the identifier has in the
  74    file-scope namespace.  */
  75 #define IDENTIFIER_GLOBAL_VALUE(NODE)   \
  76   (((struct lang_identifier *) (NODE))->global_value)
  77 /* This represents the value which the identifier has in the current
  78    scope.  */
  79 #define IDENTIFIER_LOCAL_VALUE(NODE)    \
  80   (((struct lang_identifier *) (NODE))->local_value)
  81 /* This represents the value which the identifier has as a label in
  82    the current label scope.  */
  83 #define IDENTIFIER_LABEL_VALUE(NODE)    \
  84   (((struct lang_identifier *) (NODE))->label_value)
  85 /* This records the extern decl of this identifier, if it has had one
  86    at any point in this compilation.  */
  87 #define IDENTIFIER_LIMBO_VALUE(NODE)    \
  88   (((struct lang_identifier *) (NODE))->limbo_value)
  89 /* This records the implicit function decl of this identifier, if it
  90    has had one at any point in this compilation.  */
  91 #define IDENTIFIER_IMPLICIT_DECL(NODE)  \
  92   (((struct lang_identifier *) (NODE))->implicit_decl)
  93 /* This is the last function in which we printed an "undefined variable"
  94    message for this identifier.  Value is a FUNCTION_DECL or null.  */
  95 #define IDENTIFIER_ERROR_LOCUS(NODE)    \
  96   (((struct lang_identifier *) (NODE))->error_locus)
  97
  98 /* In identifiers, C uses the following fields in a special way:
  99    TREE_PUBLIC        to record that there was a previous local extern decl.
 100    TREE_USED          to record that such a decl was used.
 101    TREE_ADDRESSABLE   to record that the address of such a decl was used.  */
 102
 103 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is read-only.  */
 104 #define C_TYPE_FIELDS_READONLY(TYPE) TREE_LANG_FLAG_1 (TYPE)
 105
 106 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is volatile.  */
 107 #define C_TYPE_FIELDS_VOLATILE(TYPE) TREE_LANG_FLAG_2 (TYPE)
 108
 109 /* In a RECORD_TYPE or UNION_TYPE or ENUMERAL_TYPE
 110    nonzero if the definition of the type has already started.  */
 111 #define C_TYPE_BEING_DEFINED(TYPE) TYPE_LANG_FLAG_0 (TYPE)
 112
 113 /* In an IDENTIFIER_NODE, nonzero if this identifier is actually a
 114    keyword.  C_RID_CODE (node) is then the RID_* value of the keyword,
 115    and C_RID_YYCODE is the token number wanted by Yacc.  */
 116 #define C_IS_RESERVED_WORD(ID) TREE_LANG_FLAG_0 (ID)
 117
 118 /* This function was declared inline.  This flag controls the linkage
 119    semantics of 'inline'; whether or not the function is inlined is
 120    controlled by DECL_INLINE.  */
 121 #define DECL_DECLARED_INLINE_P(NODE) \
 122   (DECL_LANG_SPECIFIC (NODE)->base.declared_inline)
 123
 124 /* In a RECORD_TYPE, a sorted array of the fields of the type.  */
 125 struct lang_type GTY(())
 126 {
 127   int len;
 128   tree GTY((length ("%h.len"))) elts[1];
 129 };
 130
 131 /* Record whether a type or decl was written with nonconstant size.
 132    Note that TYPE_SIZE may have simplified to a constant.  */
 133 #define C_TYPE_VARIABLE_SIZE(TYPE) TYPE_LANG_FLAG_1 (TYPE)
 134 #define C_DECL_VARIABLE_SIZE(TYPE) DECL_LANG_FLAG_0 (TYPE)
 135
 136 #if 0 /* Not used.  */
 137 /* Record whether a decl for a function or function pointer has
 138    already been mentioned (in a warning) because it was called
 139    but didn't have a prototype.  */
 140 #define C_MISSING_PROTOTYPE_WARNED(DECL) DECL_LANG_FLAG_2 (DECL)
 141 #endif
 142
 143 /* Store a value in that field.  */
 144 #define C_SET_EXP_ORIGINAL_CODE(EXP, CODE) \
 145   (TREE_COMPLEXITY (EXP) = (int) (CODE))
 146
 147 /* Record whether a typedef for type `int' was actually `signed int'.  */
 148 #define C_TYPEDEF_EXPLICITLY_SIGNED(EXP) DECL_LANG_FLAG_1 (EXP)
 149
 150 /* For a FUNCTION_DECL, nonzero if it was defined without an explicit
 151    return type.  */
 152 #define C_FUNCTION_IMPLICIT_INT(EXP) DECL_LANG_FLAG_1 (EXP)
 153
 154 /* Nonzero for a declaration of a built in function if there has been no
 155    occasion that would declare the function in ordinary C.
 156    Using the function draws a pedantic warning in this case.  */
 157 #define C_DECL_ANTICIPATED(EXP) DECL_LANG_FLAG_3 (EXP)
 158
 159 /* For FUNCTION_TYPE, a hidden list of types of arguments.  The same as
 160    TYPE_ARG_TYPES for functions with prototypes, but created for functions
 161    without prototypes.  */
 162 #define TYPE_ACTUAL_ARG_TYPES(NODE) TYPE_BINFO (NODE)
 163
 164 \f
 165 /* in c-lang.c and objc-act.c */
 166 extern tree lookup_interface                    PARAMS ((tree));
 167 extern tree is_class_name                       PARAMS ((tree));
 168 extern void maybe_objc_check_decl               PARAMS ((tree));
 169 extern void finish_file                         PARAMS ((void));
 170 extern int maybe_objc_comptypes                 PARAMS ((tree, tree, int));
 171 extern tree maybe_building_objc_message_expr    PARAMS ((void));
 172 extern int recognize_objc_keyword               PARAMS ((void));
 173 extern tree lookup_objc_ivar                    PARAMS ((tree));
 174
 175 \f
 176 /* in c-parse.in */
 177 extern void c_parse_init                        PARAMS ((void));
 178
 179 /* in c-aux-info.c */
 180 extern void gen_aux_info_record                 PARAMS ((tree, int, int, int));
 181
 182 /* in c-decl.c */
 183 extern int global_bindings_p                    PARAMS ((void));
 184 extern int kept_level_p                         PARAMS ((void));
 185 extern tree getdecls                            PARAMS ((void));
 186 extern void pushlevel                           PARAMS ((int));
 187 extern tree poplevel                            PARAMS ((int,int, int));
 188 extern void insert_block                        PARAMS ((tree));
 189 extern void set_block                           PARAMS ((tree));
 190 extern tree pushdecl                            PARAMS ((tree));
 191
 192 extern void c_insert_default_attributes         PARAMS ((tree));
 193 extern void c_init_decl_processing              PARAMS ((void));
 194 extern void c_dup_lang_specific_decl            PARAMS ((tree));
 195 extern void c_print_identifier                  PARAMS ((FILE *, tree, int));
 196 extern tree build_array_declarator              PARAMS ((tree, tree, int, int));
 197 extern tree build_enumerator                    PARAMS ((tree, tree));
 198 extern int  c_decode_option                     PARAMS ((int, char **));
 199 extern void check_for_loop_decls                PARAMS ((void));
 200 extern void clear_parm_order                    PARAMS ((void));
 201 extern int  complete_array_type                 PARAMS ((tree, tree, int));
 202 extern void declare_parm_level                  PARAMS ((int));
 203 extern tree define_label                        PARAMS ((const char *, int,
 204                                                          tree));
 205 extern void finish_decl                         PARAMS ((tree, tree, tree));
 206 extern tree finish_enum                         PARAMS ((tree, tree, tree));
 207 extern void finish_function                     PARAMS ((int, int));
 208 extern tree finish_struct                       PARAMS ((tree, tree, tree));
 209 extern tree get_parm_info                       PARAMS ((int));
 210 extern tree grokfield                           PARAMS ((const char *, int, tree, tree, tree));
 211 extern tree groktypename                        PARAMS ((tree));
 212 extern tree groktypename_in_parm_context        PARAMS ((tree));
 213 extern tree implicitly_declare                  PARAMS ((tree));
 214 extern void implicit_decl_warning               PARAMS ((tree));
 215 extern int  in_parm_level_p                     PARAMS ((void));
 216 extern void keep_next_level                     PARAMS ((void));
 217 extern tree lookup_name                         PARAMS ((tree));
 218 extern tree lookup_name_current_level           PARAMS ((tree));
 219 extern void parmlist_tags_warning               PARAMS ((void));
 220 extern void pending_xref_error                  PARAMS ((void));
 221 extern void c_push_function_context             PARAMS ((struct function *));
 222 extern void c_pop_function_context              PARAMS ((struct function *));
 223 extern void pop_label_level                     PARAMS ((void));
 224 extern void push_label_level                    PARAMS ((void));
 225 extern void push_parm_decl                      PARAMS ((tree));
 226 extern tree pushdecl_top_level                  PARAMS ((tree));
 227 extern void pushtag                             PARAMS ((tree, tree));
 228 extern tree set_array_declarator_type           PARAMS ((tree, tree, int));
 229 extern tree shadow_label                        PARAMS ((tree));
 230 extern void shadow_tag                          PARAMS ((tree));
 231 extern void shadow_tag_warned                   PARAMS ((tree, int));
 232 extern tree start_enum                          PARAMS ((tree));
 233 extern int  start_function                      PARAMS ((tree, tree, tree));
 234 extern tree start_decl                          PARAMS ((tree, tree, int,
 235                                                          tree));
 236 extern tree start_struct                        PARAMS ((enum tree_code, tree));
 237 extern void store_parm_decls                    PARAMS ((void));
 238 extern tree xref_tag                            PARAMS ((enum tree_code, tree));
 239 extern tree c_begin_compound_stmt               PARAMS ((void));
 240 extern void c_expand_deferred_function          PARAMS ((tree));
 241 extern void c_expand_decl_stmt                  PARAMS ((tree));
 242 extern tree make_pointer_declarator             PARAMS ((tree, tree));
 243
 244 /* in c-objc-common.c */
 245 extern int c_disregard_inline_limits            PARAMS ((tree));
 246 extern int c_cannot_inline_tree_fn              PARAMS ((tree *));
 247 extern const char *c_objc_common_init           PARAMS ((const char *));
 248 extern int c_missing_noreturn_ok_p              PARAMS ((tree));
 249 extern void c_objc_common_finish_file           PARAMS ((void));
 250 extern int defer_fn                             PARAMS ((tree));
 251 extern bool c_warn_unused_global_decl           PARAMS ((tree));
 252
 253 #define c_build_type_variant(TYPE, CONST_P, VOLATILE_P)           \
 254   c_build_qualified_type ((TYPE),                                 \
 255                           ((CONST_P) ? TYPE_QUAL_CONST : 0) |     \
 256                           ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
 257
 258 #define c_sizeof_nowarn(T)  c_sizeof_or_alignof_type (T, SIZEOF_EXPR, 0)
 259 /* in c-typeck.c */
 260 extern tree require_complete_type               PARAMS ((tree));
 261 extern int comptypes                            PARAMS ((tree, tree));
 262 extern tree c_size_in_bytes                     PARAMS ((tree));
 263 extern bool c_mark_addressable                  PARAMS ((tree));
 264 extern void c_incomplete_type_error             PARAMS ((tree, tree));
 265 extern tree c_type_promotes_to                  PARAMS ((tree));
 266 extern tree build_component_ref                 PARAMS ((tree, tree));
 267 extern tree build_indirect_ref                  PARAMS ((tree, const char *));
 268 extern tree build_array_ref                     PARAMS ((tree, tree));
 269 extern tree build_external_ref                  PARAMS ((tree, int));
 270 extern tree parser_build_binary_op              PARAMS ((enum tree_code,
 271                                                          tree, tree));
 272 extern void readonly_warning                    PARAMS ((tree, const char *));
 273 extern tree build_conditional_expr              PARAMS ((tree, tree, tree));
 274 extern tree build_compound_expr                 PARAMS ((tree));
 275 extern tree c_cast_expr                         PARAMS ((tree, tree));
 276 extern tree build_c_cast                        PARAMS ((tree, tree));
 277 extern tree build_modify_expr                   PARAMS ((tree, enum tree_code,
 278                                                          tree));
 279 extern void store_init_value                    PARAMS ((tree, tree));
 280 extern void error_init                          PARAMS ((const char *));
 281 extern void pedwarn_init                        PARAMS ((const char *));
 282 extern void start_init                          PARAMS ((tree, tree, int));
 283 extern void finish_init                         PARAMS ((void));
 284 extern void really_start_incremental_init       PARAMS ((tree));
 285 extern void push_init_level                     PARAMS ((int));
 286 extern tree pop_init_level                      PARAMS ((int));
 287 extern void set_init_index                      PARAMS ((tree, tree));
 288 extern void set_init_label                      PARAMS ((tree));
 289 extern void process_init_element                PARAMS ((tree));
 290 extern tree build_compound_literal              PARAMS ((tree, tree));
 291 extern void pedwarn_c99                         PARAMS ((const char *, ...))
 292                                                         ATTRIBUTE_PRINTF_1;
 293 extern tree c_start_case                        PARAMS ((tree));
 294 extern void c_finish_case                       PARAMS ((void));
 295 extern tree simple_asm_stmt                     PARAMS ((tree));
 296 extern tree build_asm_stmt                      PARAMS ((tree, tree, tree,
 297                                                          tree, tree));
 298 extern tree c_convert_parm_for_inlining         PARAMS ((tree, tree, tree));
 299
 300 /* Set to 0 at beginning of a function definition, set to 1 if
 301    a return statement that specifies a return value is seen.  */
 302
 303 extern int current_function_returns_value;
 304
 305 /* Set to 0 at beginning of a function definition, set to 1 if
 306    a return statement with no argument is seen.  */
 307
 308 extern int current_function_returns_null;
 309
 310 /* Set to 0 at beginning of a function definition, set to 1 if
 311    a call to a noreturn function is seen.  */
 312
 313 extern int current_function_returns_abnormally;
 314
 315 /* Nonzero means the expression being parsed will never be evaluated.
 316    This is a count, since unevaluated expressions can nest.  */
 317
 318 extern int skip_evaluation;
 319
 320 /* Nonzero means we are reading code that came from a system header file.  */
 321
 322 extern int system_header_p;
 323
 324 /* In c-decl.c */
 325 extern void c_finish_incomplete_decl PARAMS ((tree));
 326
 327 extern GTY(()) tree static_ctors;
 328 extern GTY(()) tree static_dtors;
 329
 330 #endif /* ! GCC_C_TREE_H */