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