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