OSDN Git Service

2004-08-19 Eric Christopher <echristo@redhat.com>
[pf3gnuchains/gcc-fork.git] / gcc / tree.h
1 /* Front-end tree definitions for GNU compiler.
2    Copyright (C) 1989, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3    2001, 2002, 2003, 2004 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_TREE_H
23 #define GCC_TREE_H
24
25 #include "machmode.h"
26 #include "input.h"
27 #include "statistics.h"
28 #include "vec.h"
29
30 /* Codes of tree nodes */
31
32 #define DEFTREECODE(SYM, STRING, TYPE, NARGS)   SYM,
33
34 enum tree_code {
35 #include "tree.def"
36
37   LAST_AND_UNUSED_TREE_CODE     /* A convenient way to get a value for
38                                    NUM_TREE_CODES.  */
39 };
40
41 #undef DEFTREECODE
42
43 /* Number of language-independent tree codes.  */
44 #define NUM_TREE_CODES ((int) LAST_AND_UNUSED_TREE_CODE)
45
46 /* Indexed by enum tree_code, contains a character which is
47    `<' for a comparison expression, `1', for a unary arithmetic
48    expression, `2' for a binary arithmetic expression, `e' for
49    other types of expressions, `r' for a reference, `c' for a
50    constant, `d' for a decl, `t' for a type, `s' for a statement,
51    and `x' for anything else (TREE_LIST, IDENTIFIER, etc).  */
52
53 #define MAX_TREE_CODES 256
54 extern const char tree_code_type[];
55 #define TREE_CODE_CLASS(CODE)   tree_code_type[(int) (CODE)]
56
57 /* Returns nonzero iff CLASS is not the tree code of a type.  */
58
59 #define IS_NON_TYPE_CODE_CLASS(CLASS) ((CLASS) != 't')
60
61 /* Returns nonzero iff CLASS is the tree-code class of an
62    expression.  */
63
64 #define IS_EXPR_CODE_CLASS(CLASS) (strchr ("<12ers", (CLASS)) != 0)
65
66 /* Returns nonzero iff NODE is an expression of some kind.  */
67
68 #define EXPR_P(NODE) IS_EXPR_CODE_CLASS (TREE_CODE_CLASS (TREE_CODE (NODE)))
69
70 /* Number of argument-words in each kind of tree-node.  */
71
72 extern const unsigned char tree_code_length[];
73 #define TREE_CODE_LENGTH(CODE)  tree_code_length[(int) (CODE)]
74
75 /* Names of tree components.  */
76
77 extern const char *const tree_code_name[];
78
79 /* A vector of trees.  */
80 DEF_VEC_P(tree);
81
82 \f
83 /* Classify which part of the compiler has defined a given builtin function.
84    Note that we assume below that this is no more than two bits.  */
85 enum built_in_class
86 {
87   NOT_BUILT_IN = 0,
88   BUILT_IN_FRONTEND,
89   BUILT_IN_MD,
90   BUILT_IN_NORMAL
91 };
92
93 /* Names for the above.  */
94 extern const char *const built_in_class_names[4];
95
96 /* Codes that identify the various built in functions
97    so that expand_call can identify them quickly.  */
98
99 #define DEF_BUILTIN(ENUM, N, C, T, LT, B, F, NA, AT, IM) ENUM,
100 enum built_in_function
101 {
102 #include "builtins.def"
103
104   /* Upper bound on non-language-specific builtins.  */
105   END_BUILTINS
106 };
107 #undef DEF_BUILTIN
108
109 /* Names for the above.  */
110 extern const char *const built_in_names[(int) END_BUILTINS];
111
112 /* Helper macros for math builtins.  */
113
114 #define BUILTIN_EXP10_P(FN) \
115  ((FN) == BUILT_IN_EXP10 || (FN) == BUILT_IN_EXP10F || (FN) == BUILT_IN_EXP10L \
116   || (FN) == BUILT_IN_POW10 || (FN) == BUILT_IN_POW10F || (FN) == BUILT_IN_POW10L)
117
118 #define BUILTIN_EXPONENT_P(FN) (BUILTIN_EXP10_P (FN) \
119   || (FN) == BUILT_IN_EXP || (FN) == BUILT_IN_EXPF || (FN) == BUILT_IN_EXPL \
120   || (FN) == BUILT_IN_EXP2 || (FN) == BUILT_IN_EXP2F || (FN) == BUILT_IN_EXP2L)
121
122 #define BUILTIN_SQRT_P(FN) \
123  ((FN) == BUILT_IN_SQRT || (FN) == BUILT_IN_SQRTF || (FN) == BUILT_IN_SQRTL)
124
125 #define BUILTIN_CBRT_P(FN) \
126  ((FN) == BUILT_IN_CBRT || (FN) == BUILT_IN_CBRTF || (FN) == BUILT_IN_CBRTL)
127
128 #define BUILTIN_ROOT_P(FN) (BUILTIN_SQRT_P (FN) || BUILTIN_CBRT_P (FN))
129
130 /* An array of _DECL trees for the above.  */
131 extern GTY(()) tree built_in_decls[(int) END_BUILTINS];
132 extern GTY(()) tree implicit_built_in_decls[(int) END_BUILTINS];
133 \f
134 /* The definition of tree nodes fills the next several pages.  */
135
136 /* A tree node can represent a data type, a variable, an expression
137    or a statement.  Each node has a TREE_CODE which says what kind of
138    thing it represents.  Some common codes are:
139    INTEGER_TYPE -- represents a type of integers.
140    ARRAY_TYPE -- represents a type of pointer.
141    VAR_DECL -- represents a declared variable.
142    INTEGER_CST -- represents a constant integer value.
143    PLUS_EXPR -- represents a sum (an expression).
144
145    As for the contents of a tree node: there are some fields
146    that all nodes share.  Each TREE_CODE has various special-purpose
147    fields as well.  The fields of a node are never accessed directly,
148    always through accessor macros.  */
149
150 /* Every kind of tree node starts with this structure,
151    so all nodes have these fields.
152
153    See the accessor macros, defined below, for documentation of the
154    fields.  */
155 union tree_ann_d;
156
157 struct tree_common GTY(())
158 {
159   tree chain;
160   tree type;
161   union tree_ann_d *ann;
162
163   ENUM_BITFIELD(tree_code) code : 8;
164
165   unsigned side_effects_flag : 1;
166   unsigned constant_flag : 1;
167   unsigned addressable_flag : 1;
168   unsigned volatile_flag : 1;
169   unsigned readonly_flag : 1;
170   unsigned unsigned_flag : 1;
171   unsigned asm_written_flag: 1;
172   unsigned nowarning_flag : 1;
173
174   unsigned used_flag : 1;
175   unsigned nothrow_flag : 1;
176   unsigned static_flag : 1;
177   unsigned public_flag : 1;
178   unsigned private_flag : 1;
179   unsigned protected_flag : 1;
180   unsigned deprecated_flag : 1;
181   unsigned invariant_flag : 1;
182
183   unsigned lang_flag_0 : 1;
184   unsigned lang_flag_1 : 1;
185   unsigned lang_flag_2 : 1;
186   unsigned lang_flag_3 : 1;
187   unsigned lang_flag_4 : 1;
188   unsigned lang_flag_5 : 1;
189   unsigned lang_flag_6 : 1;
190   unsigned visited : 1;
191 };
192
193 /* The following table lists the uses of each of the above flags and
194    for which types of nodes they are defined.  Note that expressions
195    include decls.
196
197    addressable_flag:
198
199        TREE_ADDRESSABLE in
200            VAR_DECL, FUNCTION_DECL, FIELD_DECL, CONSTRUCTOR, LABEL_DECL,
201            ..._TYPE, IDENTIFIER_NODE.
202            In a STMT_EXPR, it means we want the result of the enclosed
203            expression.
204        CALL_EXPR_TAILCALL in CALL_EXPR
205
206    static_flag:
207
208        TREE_STATIC in
209            VAR_DECL, FUNCTION_DECL, CONSTRUCTOR, ADDR_EXPR
210        BINFO_VIRTUAL_P in
211            TREE_BINFO
212        TREE_CONSTANT_OVERFLOW in
213            INTEGER_CST, REAL_CST, COMPLEX_CST, VECTOR_CST
214        TREE_SYMBOL_REFERENCED in
215            IDENTIFIER_NODE
216        CLEANUP_EH_ONLY in
217            TARGET_EXPR, WITH_CLEANUP_EXPR
218        ASM_INPUT_P in
219            ASM_EXPR
220        EH_FILTER_MUST_NOT_THROW in EH_FILTER_EXPR
221        TYPE_REF_CAN_ALIAS_ALL in
222            POINTER_TYPE, REFERENCE_TYPE
223
224    public_flag:
225
226        TREE_OVERFLOW in
227            INTEGER_CST, REAL_CST, COMPLEX_CST, VECTOR_CST
228            ??? and other expressions?
229        TREE_PUBLIC in
230            VAR_DECL or FUNCTION_DECL or IDENTIFIER_NODE
231        ASM_VOLATILE_P in
232            ASM_EXPR
233        TYPE_CACHED_VALUES_P in
234           ..._TYPE
235
236    private_flag:
237
238        TREE_PRIVATE in
239            ..._DECL
240        CALL_EXPR_HAS_RETURN_SLOT_ADDR in
241            CALL_EXPR
242        DECL_BY_REFERENCE in
243            PARM_DECL, RESULT_DECL
244
245    protected_flag:
246
247        TREE_PROTECTED in
248            BLOCK
249            ..._DECL
250        CALL_FROM_THUNK_P in
251            CALL_EXPR
252
253    side_effects_flag:
254
255        TREE_SIDE_EFFECTS in
256            all expressions
257            all decls
258            all constants
259
260        FORCED_LABEL in
261            LABEL_DECL
262
263    volatile_flag:
264
265        TREE_THIS_VOLATILE in
266            all expressions
267        TYPE_VOLATILE in
268            ..._TYPE
269
270    readonly_flag:
271
272        TREE_READONLY in
273            all expressions
274        TYPE_READONLY in
275            ..._TYPE
276
277    constant_flag:
278
279        TREE_CONSTANT in
280            all expressions
281            all decls
282            all constants
283
284    unsigned_flag:
285
286        TYPE_UNSIGNED in
287            all types
288        DECL_UNSIGNED in
289            all decls
290        BIT_FIELD_REF_UNSIGNED in
291            BIT_FIELD_REF
292
293    asm_written_flag:
294
295        TREE_ASM_WRITTEN in
296            VAR_DECL, FUNCTION_DECL, RECORD_TYPE, UNION_TYPE, QUAL_UNION_TYPE
297            BLOCK, SSA_NAME
298
299    used_flag:
300
301        TREE_USED in
302            expressions, IDENTIFIER_NODE
303
304    nothrow_flag:
305
306        TREE_NOTHROW in
307            CALL_EXPR, FUNCTION_DECL
308
309        TYPE_ALIGN_OK in
310            ..._TYPE
311
312        TREE_THIS_NOTRAP in
313           INDIRECT_REF, ARRAY_REF, ARRAY_RANGE_REF
314
315    deprecated_flag:
316
317         TREE_DEPRECATED in
318            ..._DECL
319
320    visited:
321
322         Used in tree traversals to mark visited nodes.
323
324    invariant_flag:
325
326         TREE_INVARIANT in
327             all expressions.
328
329    nowarning_flag:
330
331        TREE_NO_WARNING in
332            ... any expr node
333 */
334
335 /* Define accessors for the fields that all tree nodes have
336    (though some fields are not used for all kinds of nodes).  */
337
338 /* The tree-code says what kind of node it is.
339    Codes are defined in tree.def.  */
340 #define TREE_CODE(NODE) ((enum tree_code) (NODE)->common.code)
341 #define TREE_SET_CODE(NODE, VALUE) ((NODE)->common.code = (VALUE))
342
343 /* When checking is enabled, errors will be generated if a tree node
344    is accessed incorrectly. The macros abort with a fatal error.  */
345 #if defined ENABLE_TREE_CHECKING && (GCC_VERSION >= 2007)
346
347 #define TREE_CHECK(T, CODE) __extension__                               \
348 ({  const tree __t = (T);                                               \
349     if (TREE_CODE (__t) != (CODE))                                      \
350       tree_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,         \
351                          (CODE), 0);                                    \
352     __t; })
353
354 #define TREE_NOT_CHECK(T, CODE) __extension__                           \
355 ({  const tree __t = (T);                                               \
356     if (TREE_CODE (__t) == (CODE))                                      \
357       tree_not_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,     \
358                              (CODE), 0);                                \
359     __t; })
360
361 #define TREE_CHECK2(T, CODE1, CODE2) __extension__                      \
362 ({  const tree __t = (T);                                               \
363     if (TREE_CODE (__t) != (CODE1)                                      \
364         && TREE_CODE (__t) != (CODE2))                                  \
365       tree_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,         \
366                          (CODE1), (CODE2), 0);                          \
367     __t; })
368
369 #define TREE_NOT_CHECK2(T, CODE1, CODE2) __extension__                  \
370 ({  const tree __t = (T);                                               \
371     if (TREE_CODE (__t) == (CODE1)                                      \
372         || TREE_CODE (__t) == (CODE2))                                  \
373       tree_not_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,     \
374                              (CODE1), (CODE2), 0);                      \
375     __t; })
376
377 #define TREE_CHECK3(T, CODE1, CODE2, CODE3) __extension__               \
378 ({  const tree __t = (T);                                               \
379     if (TREE_CODE (__t) != (CODE1)                                      \
380         && TREE_CODE (__t) != (CODE2)                                   \
381         && TREE_CODE (__t) != (CODE3))                                  \
382       tree_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,         \
383                              (CODE1), (CODE2), (CODE3), 0);             \
384     __t; })
385
386 #define TREE_NOT_CHECK3(T, CODE1, CODE2, CODE3) __extension__           \
387 ({  const tree __t = (T);                                               \
388     if (TREE_CODE (__t) == (CODE1)                                      \
389         || TREE_CODE (__t) == (CODE2)                                   \
390         || TREE_CODE (__t) == (CODE3))                                  \
391       tree_not_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,     \
392                              (CODE1), (CODE2), (CODE3), 0);             \
393     __t; })
394
395 #define TREE_CHECK4(T, CODE1, CODE2, CODE3, CODE4) __extension__        \
396 ({  const tree __t = (T);                                               \
397     if (TREE_CODE (__t) != (CODE1)                                      \
398         && TREE_CODE (__t) != (CODE2)                                   \
399         && TREE_CODE (__t) != (CODE3)                                   \
400         && TREE_CODE (__t) != (CODE4))                                  \
401       tree_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,         \
402                              (CODE1), (CODE2), (CODE3), (CODE4), 0);    \
403     __t; })
404
405 #define NON_TREE_CHECK4(T, CODE1, CODE2, CODE3, CODE4) __extension__    \
406 ({  const tree __t = (T);                                               \
407     if (TREE_CODE (__t) == (CODE1)                                      \
408         || TREE_CODE (__t) == (CODE2)                                   \
409         || TREE_CODE (__t) == (CODE3)                                   \
410         || TREE_CODE (__t) == (CODE4))                                  \
411       tree_not_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,     \
412                              (CODE1), (CODE2), (CODE3), (CODE4), 0);    \
413     __t; })
414
415 #define TREE_CHECK5(T, CODE1, CODE2, CODE3, CODE4, CODE5) __extension__ \
416 ({  const tree __t = (T);                                               \
417     if (TREE_CODE (__t) != (CODE1)                                      \
418         && TREE_CODE (__t) != (CODE2)                                   \
419         && TREE_CODE (__t) != (CODE3)                                   \
420         && TREE_CODE (__t) != (CODE4)                                   \
421         && TREE_CODE (__t) != (CODE5))                                  \
422       tree_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,         \
423                              (CODE1), (CODE2), (CODE3), (CODE4), (CODE5), 0);\
424     __t; })
425
426 #define TREE_NOT_CHECK5(T, CODE1, CODE2, CODE3, CODE4, CODE5) __extension__ \
427 ({  const tree __t = (T);                                               \
428     if (TREE_CODE (__t) == (CODE1)                                      \
429         || TREE_CODE (__t) == (CODE2)                                   \
430         || TREE_CODE (__t) == (CODE3)                                   \
431         || TREE_CODE (__t) == (CODE4)                                   \
432         || TREE_CODE (__t) == (CODE5))                                  \
433       tree_not_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,     \
434                              (CODE1), (CODE2), (CODE3), (CODE4), (CODE5), 0);\
435     __t; })
436
437 #define TREE_CLASS_CHECK(T, CLASS) __extension__                        \
438 ({  const tree __t = (T);                                               \
439     if (TREE_CODE_CLASS (TREE_CODE(__t)) != (CLASS))                    \
440       tree_class_check_failed (__t, (CLASS), __FILE__, __LINE__,        \
441                                __FUNCTION__);                           \
442     __t; })
443
444 /* These checks have to be special cased.  */
445 #define EXPR_CHECK(T) __extension__                                     \
446 ({  const tree __t = (T);                                               \
447     char const __c = TREE_CODE_CLASS (TREE_CODE (__t));                 \
448     if (!IS_EXPR_CODE_CLASS (__c))                                      \
449       tree_class_check_failed (__t, 'E', __FILE__, __LINE__,            \
450                                __FUNCTION__);                           \
451     __t; })
452
453 /* These checks have to be special cased.  */
454 #define NON_TYPE_CHECK(T) __extension__                                 \
455 ({  const tree __t = (T);                                               \
456     char const __c = TREE_CODE_CLASS (TREE_CODE (__t));                 \
457     if (!IS_NON_TYPE_CODE_CLASS (__c))                                  \
458       tree_class_check_failed (__t, 'T', __FILE__, __LINE__,            \
459                                __FUNCTION__);                           \
460     __t; })
461
462 #define TREE_VEC_ELT_CHECK(T, I) __extension__                          \
463 (*({const tree __t = (T);                                               \
464     const int __i = (I);                                                \
465     if (TREE_CODE (__t) != TREE_VEC)                                    \
466       tree_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,         \
467                          TREE_VEC, 0);                                  \
468     if (__i < 0 || __i >= __t->vec.length)                              \
469       tree_vec_elt_check_failed (__i, __t->vec.length,                  \
470                                  __FILE__, __LINE__, __FUNCTION__);     \
471     &__t->vec.a[__i]; }))
472
473 #define PHI_NODE_ELT_CHECK(t, i) __extension__                          \
474 (*({const tree __t = t;                                                 \
475     const int __i = (i);                                                \
476     if (TREE_CODE (__t) != PHI_NODE)                                    \
477       tree_check_failed (__t, __FILE__, __LINE__, __FUNCTION__,         \
478                          PHI_NODE, 0);                                  \
479     if (__i < 0 || __i >= __t->phi.capacity)                            \
480       phi_node_elt_check_failed (__i, __t->phi.num_args,                \
481                                  __FILE__, __LINE__, __FUNCTION__);     \
482     &__t->phi.a[__i]; }))
483
484 /* Special checks for TREE_OPERANDs.  */
485 #define TREE_OPERAND_CHECK(T, I) __extension__                          \
486 (*({const tree __t = EXPR_CHECK (T);                                    \
487     const int __i = (I);                                                \
488     if (__i < 0 || __i >= TREE_CODE_LENGTH (TREE_CODE (__t)))           \
489       tree_operand_check_failed (__i, TREE_CODE (__t),                  \
490                                  __FILE__, __LINE__, __FUNCTION__);     \
491     &__t->exp.operands[__i]; }))
492
493 #define TREE_OPERAND_CHECK_CODE(T, CODE, I) __extension__               \
494 (*({const tree __t = (T);                                               \
495     const int __i = (I);                                                \
496     if (TREE_CODE (__t) != CODE)                                        \
497       tree_check_failed (__t, __FILE__, __LINE__, __FUNCTION__, (CODE), 0);\
498     if (__i < 0 || __i >= TREE_CODE_LENGTH (CODE))                      \
499       tree_operand_check_failed (__i, (CODE),                           \
500                                  __FILE__, __LINE__, __FUNCTION__);     \
501     &__t->exp.operands[__i]; }))
502
503 #define TREE_RTL_OPERAND_CHECK(T, CODE, I) __extension__                \
504 (*(rtx *)                                                               \
505  ({const tree __t = (T);                                                \
506     const int __i = (I);                                                \
507     if (TREE_CODE (__t) != (CODE))                                      \
508       tree_check_failed (__t, __FILE__, __LINE__, __FUNCTION__, (CODE), 0); \
509     if (__i < 0 || __i >= TREE_CODE_LENGTH ((CODE)))                    \
510       tree_operand_check_failed (__i, (CODE),                           \
511                                  __FILE__, __LINE__, __FUNCTION__);     \
512     &__t->exp.operands[__i]; }))
513
514 extern void tree_check_failed (const tree, const char *, int, const char *,
515                                ...) ATTRIBUTE_NORETURN;
516 extern void tree_not_check_failed (const tree, const char *, int, const char *,
517                                    ...) ATTRIBUTE_NORETURN;
518 extern void tree_class_check_failed (const tree, int,
519                                      const char *, int, const char *)
520     ATTRIBUTE_NORETURN;
521 extern void tree_vec_elt_check_failed (int, int, const char *,
522                                        int, const char *)
523     ATTRIBUTE_NORETURN;
524 extern void phi_node_elt_check_failed (int, int, const char *,
525                                        int, const char *)
526     ATTRIBUTE_NORETURN;
527 extern void tree_operand_check_failed (int, enum tree_code,
528                                        const char *, int, const char *)
529     ATTRIBUTE_NORETURN;
530
531 #else /* not ENABLE_TREE_CHECKING, or not gcc */
532
533 #define TREE_CHECK(T, CODE)                     (T)
534 #define TREE_NOT_CHECK(T, CODE)                 (T)
535 #define TREE_CHECK2(T, CODE1, CODE2)            (T)
536 #define TREE_NOT_CHECK2(T, CODE1, CODE2)        (T)
537 #define TREE_CHECK3(T, CODE1, CODE2, CODE3)     (T)
538 #define TREE_NOT_CHECK3(T, CODE1, CODE2, CODE3) (T)
539 #define TREE_CHECK4(T, CODE1, CODE2, CODE3, CODE4) (T)
540 #define TREE_NOT_CHECK4(T, CODE1, CODE2, CODE3, CODE4) (T)
541 #define TREE_CHECK5(T, CODE1, CODE2, CODE3, CODE4, CODE5) (T)
542 #define TREE_NOT_CHECK5(T, CODE1, CODE2, CODE3, CODE4, CODE5) (T)
543 #define TREE_CLASS_CHECK(T, CODE)               (T)
544 #define EXPR_CHECK(T)                           (T)
545 #define NON_TYPE_CHECK(T)                       (T)
546 #define TREE_VEC_ELT_CHECK(T, I)                ((T)->vec.a[I])
547 #define TREE_OPERAND_CHECK(T, I)                ((T)->exp.operands[I])
548 #define TREE_OPERAND_CHECK_CODE(T, CODE, I)     ((T)->exp.operands[I])
549 #define TREE_RTL_OPERAND_CHECK(T, CODE, I)  (*(rtx *) &((T)->exp.operands[I]))
550 #define PHI_NODE_ELT_CHECK(T, i)        ((T)->phi.a[i])
551
552 #endif
553
554 #define TREE_BLOCK(NODE)                ((NODE)->exp.block)
555
556 #include "tree-check.h"
557
558 #define TYPE_CHECK(T)           TREE_CLASS_CHECK (T, 't')
559 #define DECL_CHECK(T)           TREE_CLASS_CHECK (T, 'd')
560 #define CST_CHECK(T)            TREE_CLASS_CHECK (T, 'c')
561 #define STMT_CHECK(T)           TREE_CLASS_CHECK (T, 's')
562 #define FUNC_OR_METHOD_CHECK(T) TREE_CHECK2 (T, FUNCTION_TYPE, METHOD_TYPE)
563 #define PTR_OR_REF_CHECK(T)     TREE_CHECK2 (T, POINTER_TYPE, REFERENCE_TYPE)
564
565 #define SET_OR_ARRAY_CHECK(T) \
566   TREE_CHECK2 (T, ARRAY_TYPE, SET_TYPE)
567
568 #define RECORD_OR_UNION_CHECK(T)        \
569   TREE_CHECK3 (T, RECORD_TYPE, UNION_TYPE, QUAL_UNION_TYPE)
570 #define NOT_RECORD_OR_UNION_CHECK(T) \
571   TREE_NOT_CHECK3 (T, RECORD_TYPE, UNION_TYPE, QUAL_UNION_TYPE)
572
573 #define NUMERICAL_TYPE_CHECK(T)                                 \
574   TREE_CHECK5 (T, INTEGER_TYPE, ENUMERAL_TYPE, BOOLEAN_TYPE,    \
575                CHAR_TYPE, REAL_TYPE)
576
577 /* In all nodes that are expressions, this is the data type of the expression.
578    In POINTER_TYPE nodes, this is the type that the pointer points to.
579    In ARRAY_TYPE nodes, this is the type of the elements.
580    In VECTOR_TYPE nodes, this is the type of the elements.  */
581 #define TREE_TYPE(NODE) ((NODE)->common.type)
582
583 /* Here is how primitive or already-canonicalized types' hash codes
584    are made.  */
585 #define TYPE_HASH(TYPE) (TYPE_UID (TYPE))
586
587 /* A simple hash function for an arbitrary tree node.  This must not be
588    used in hash tables which are saved to a PCH.  */
589 #define TREE_HASH(NODE) ((size_t) (NODE) & 0777777)
590
591 /* Nodes are chained together for many purposes.
592    Types are chained together to record them for being output to the debugger
593    (see the function `chain_type').
594    Decls in the same scope are chained together to record the contents
595    of the scope.
596    Statement nodes for successive statements used to be chained together.
597    Often lists of things are represented by TREE_LIST nodes that
598    are chained together.  */
599
600 #define TREE_CHAIN(NODE) ((NODE)->common.chain)
601
602 /* Given an expression as a tree, strip any NON_LVALUE_EXPRs and NOP_EXPRs
603    that don't change the machine mode.  */
604
605 #define STRIP_NOPS(EXP)                                         \
606   while ((TREE_CODE (EXP) == NOP_EXPR                           \
607           || TREE_CODE (EXP) == CONVERT_EXPR                    \
608           || TREE_CODE (EXP) == NON_LVALUE_EXPR)                \
609          && TREE_OPERAND (EXP, 0) != error_mark_node            \
610          && (TYPE_MODE (TREE_TYPE (EXP))                        \
611              == TYPE_MODE (TREE_TYPE (TREE_OPERAND (EXP, 0))))) \
612     (EXP) = TREE_OPERAND (EXP, 0)
613
614 /* Like STRIP_NOPS, but don't let the signedness change either.  */
615
616 #define STRIP_SIGN_NOPS(EXP) \
617   while ((TREE_CODE (EXP) == NOP_EXPR                           \
618           || TREE_CODE (EXP) == CONVERT_EXPR                    \
619           || TREE_CODE (EXP) == NON_LVALUE_EXPR)                \
620          && TREE_OPERAND (EXP, 0) != error_mark_node            \
621          && (TYPE_MODE (TREE_TYPE (EXP))                        \
622              == TYPE_MODE (TREE_TYPE (TREE_OPERAND (EXP, 0))))  \
623          && (TYPE_UNSIGNED (TREE_TYPE (EXP))                    \
624              == TYPE_UNSIGNED (TREE_TYPE (TREE_OPERAND (EXP, 0))))) \
625     (EXP) = TREE_OPERAND (EXP, 0)
626
627 /* Like STRIP_NOPS, but don't alter the TREE_TYPE main variant either.  */
628
629 #define STRIP_MAIN_TYPE_NOPS(EXP)                                       \
630   while ((TREE_CODE (EXP) == NOP_EXPR                                   \
631           || TREE_CODE (EXP) == CONVERT_EXPR                            \
632           || TREE_CODE (EXP) == NON_LVALUE_EXPR)                        \
633          && TREE_OPERAND (EXP, 0) != error_mark_node                    \
634          && (TYPE_MAIN_VARIANT (TREE_TYPE (EXP))                        \
635              == TYPE_MAIN_VARIANT (TREE_TYPE (TREE_OPERAND (EXP, 0))))) \
636     (EXP) = TREE_OPERAND (EXP, 0)
637
638 /* Like STRIP_NOPS, but don't alter the TREE_TYPE either.  */
639
640 #define STRIP_TYPE_NOPS(EXP) \
641   while ((TREE_CODE (EXP) == NOP_EXPR                           \
642           || TREE_CODE (EXP) == CONVERT_EXPR                    \
643           || TREE_CODE (EXP) == NON_LVALUE_EXPR)                \
644          && TREE_OPERAND (EXP, 0) != error_mark_node            \
645          && (TREE_TYPE (EXP)                                    \
646              == TREE_TYPE (TREE_OPERAND (EXP, 0))))             \
647     (EXP) = TREE_OPERAND (EXP, 0)
648
649 /* Remove unnecessary type conversions according to
650    tree_ssa_useless_type_conversion.  */
651
652 #define STRIP_USELESS_TYPE_CONVERSION(EXP)                              \
653       while (tree_ssa_useless_type_conversion (EXP))                    \
654         EXP = TREE_OPERAND (EXP, 0)
655
656 /* Nonzero if TYPE represents an integral type.  Note that we do not
657    include COMPLEX types here.  */
658
659 #define INTEGRAL_TYPE_P(TYPE)  \
660   (TREE_CODE (TYPE) == INTEGER_TYPE || TREE_CODE (TYPE) == ENUMERAL_TYPE  \
661    || TREE_CODE (TYPE) == BOOLEAN_TYPE || TREE_CODE (TYPE) == CHAR_TYPE)
662
663 /* Nonzero if TYPE represents a scalar floating-point type.  */
664
665 #define SCALAR_FLOAT_TYPE_P(TYPE) (TREE_CODE (TYPE) == REAL_TYPE)
666
667 /* Nonzero if TYPE represents a complex floating-point type.  */
668
669 #define COMPLEX_FLOAT_TYPE_P(TYPE)      \
670   (TREE_CODE (TYPE) == COMPLEX_TYPE     \
671    && TREE_CODE (TREE_TYPE (TYPE)) == REAL_TYPE)
672
673 /* Nonzero if TYPE represents a vector floating-point type.  */
674
675 #define VECTOR_FLOAT_TYPE_P(TYPE)       \
676   (TREE_CODE (TYPE) == VECTOR_TYPE      \
677    && TREE_CODE (TREE_TYPE (TYPE)) == REAL_TYPE)
678
679 /* Nonzero if TYPE represents a floating-point type, including complex
680    and vector floating-point types.  */
681
682 #define FLOAT_TYPE_P(TYPE)              \
683   (SCALAR_FLOAT_TYPE_P (TYPE) || COMPLEX_FLOAT_TYPE_P (TYPE)    \
684    || VECTOR_FLOAT_TYPE_P (TYPE))
685
686 /* Nonzero if TYPE represents an aggregate (multi-component) type.  */
687
688 #define AGGREGATE_TYPE_P(TYPE) \
689   (TREE_CODE (TYPE) == ARRAY_TYPE || TREE_CODE (TYPE) == RECORD_TYPE \
690    || TREE_CODE (TYPE) == UNION_TYPE || TREE_CODE (TYPE) == QUAL_UNION_TYPE \
691    || TREE_CODE (TYPE) == SET_TYPE)
692
693 /* Nonzero if TYPE represents a pointer or reference type.
694    (It should be renamed to INDIRECT_TYPE_P.)  */
695
696 #define POINTER_TYPE_P(TYPE) \
697   (TREE_CODE (TYPE) == POINTER_TYPE || TREE_CODE (TYPE) == REFERENCE_TYPE)
698
699 /* Nonzero if this type is a complete type.  */
700 #define COMPLETE_TYPE_P(NODE) (TYPE_SIZE (NODE) != NULL_TREE)
701
702 /* Nonzero if this type is the (possibly qualified) void type.  */
703 #define VOID_TYPE_P(NODE) (TREE_CODE (NODE) == VOID_TYPE)
704
705 /* Nonzero if this type is complete or is cv void.  */
706 #define COMPLETE_OR_VOID_TYPE_P(NODE) \
707   (COMPLETE_TYPE_P (NODE) || VOID_TYPE_P (NODE))
708
709 /* Nonzero if this type is complete or is an array with unspecified bound.  */
710 #define COMPLETE_OR_UNBOUND_ARRAY_TYPE_P(NODE) \
711   (COMPLETE_TYPE_P (TREE_CODE (NODE) == ARRAY_TYPE ? TREE_TYPE (NODE) : (NODE)))
712
713 /* Nonzero if TYPE represents a type.  */
714
715 #define TYPE_P(TYPE)    (TREE_CODE_CLASS (TREE_CODE (TYPE)) == 't')
716 \f
717 /* Define many boolean fields that all tree nodes have.  */
718
719 /* In VAR_DECL nodes, nonzero means address of this is needed.
720    So it cannot be in a register.
721    In a FUNCTION_DECL, nonzero means its address is needed.
722    So it must be compiled even if it is an inline function.
723    In a FIELD_DECL node, it means that the programmer is permitted to
724    construct the address of this field.  This is used for aliasing
725    purposes: see record_component_aliases.
726    In CONSTRUCTOR nodes, it means object constructed must be in memory.
727    In LABEL_DECL nodes, it means a goto for this label has been seen
728    from a place outside all binding contours that restore stack levels.
729    In ..._TYPE nodes, it means that objects of this type must
730    be fully addressable.  This means that pieces of this
731    object cannot go into register parameters, for example.
732    In IDENTIFIER_NODEs, this means that some extern decl for this name
733    had its address taken.  That matters for inline functions.  */
734 #define TREE_ADDRESSABLE(NODE) ((NODE)->common.addressable_flag)
735
736 #define CALL_EXPR_TAILCALL(NODE) (CALL_EXPR_CHECK(NODE)->common.addressable_flag)
737
738 /* In a VAR_DECL, nonzero means allocate static storage.
739    In a FUNCTION_DECL, nonzero if function has been defined.
740    In a CONSTRUCTOR, nonzero means allocate static storage.
741
742    ??? This is also used in lots of other nodes in unclear ways which
743    should be cleaned up some day.  */
744 #define TREE_STATIC(NODE) ((NODE)->common.static_flag)
745
746 /* In a TARGET_EXPR, WITH_CLEANUP_EXPR, means that the pertinent cleanup
747    should only be executed if an exception is thrown, not on normal exit
748    of its scope.  */
749 #define CLEANUP_EH_ONLY(NODE) ((NODE)->common.static_flag)
750
751 /* In an expr node (usually a conversion) this means the node was made
752    implicitly and should not lead to any sort of warning.  */
753 #define TREE_NO_WARNING(NODE) ((NODE)->common.nowarning_flag)
754
755 /* In an INTEGER_CST, REAL_CST, COMPLEX_CST, or VECTOR_CST this means
756    there was an overflow in folding.  This is distinct from
757    TREE_OVERFLOW because ANSI C requires a diagnostic when overflows
758    occur in constant expressions.  */
759 #define TREE_CONSTANT_OVERFLOW(NODE) (CST_CHECK (NODE)->common.static_flag)
760
761 /* In an IDENTIFIER_NODE, this means that assemble_name was called with
762    this string as an argument.  */
763 #define TREE_SYMBOL_REFERENCED(NODE) \
764   (IDENTIFIER_NODE_CHECK (NODE)->common.static_flag)
765
766 /* Nonzero in a pointer or reference type means the data pointed to
767    by this type can alias anything.  */
768 #define TYPE_REF_CAN_ALIAS_ALL(NODE) \
769   (PTR_OR_REF_CHECK (NODE)->common.static_flag)
770
771 /* In an INTEGER_CST, REAL_CST, COMPLEX_CST, or VECTOR_CST, this means
772    there was an overflow in folding, and no warning has been issued
773    for this subexpression.  TREE_OVERFLOW implies TREE_CONSTANT_OVERFLOW,
774    but not vice versa.
775
776    ??? Apparently, lots of code assumes this is defined in all
777    expressions.  */
778 #define TREE_OVERFLOW(NODE) ((NODE)->common.public_flag)
779
780 /* In a VAR_DECL or FUNCTION_DECL,
781    nonzero means name is to be accessible from outside this module.
782    In an IDENTIFIER_NODE, nonzero means an external declaration
783    accessible from outside this module was previously seen
784    for this name in an inner scope.  */
785 #define TREE_PUBLIC(NODE) ((NODE)->common.public_flag)
786
787 /* In a _TYPE, indicates whether TYPE_CACHED_VALUES contains a vector
788    of cached values, or is something else.  */
789 #define TYPE_CACHED_VALUES_P(NODE) (TYPE_CHECK(NODE)->common.public_flag)
790
791 /* In any expression, decl, or constant, nonzero means it has side effects or
792    reevaluation of the whole expression could produce a different value.
793    This is set if any subexpression is a function call, a side effect or a
794    reference to a volatile variable.  In a ..._DECL, this is set only if the
795    declaration said `volatile'.  This will never be set for a constant.  */
796 #define TREE_SIDE_EFFECTS(NODE) \
797   (NON_TYPE_CHECK (NODE)->common.side_effects_flag)
798
799 /* In a LABEL_DECL, nonzero means this label had its address taken
800    and therefore can never be deleted and is a jump target for
801    computed gotos.  */
802 #define FORCED_LABEL(NODE) ((NODE)->common.side_effects_flag)
803
804 /* Nonzero means this expression is volatile in the C sense:
805    its address should be of type `volatile WHATEVER *'.
806    In other words, the declared item is volatile qualified.
807    This is used in _DECL nodes and _REF nodes.
808
809    In a ..._TYPE node, means this type is volatile-qualified.
810    But use TYPE_VOLATILE instead of this macro when the node is a type,
811    because eventually we may make that a different bit.
812
813    If this bit is set in an expression, so is TREE_SIDE_EFFECTS.  */
814 #define TREE_THIS_VOLATILE(NODE) ((NODE)->common.volatile_flag)
815
816 /* Nonzero means this node will not trap.  In an INDIRECT_REF, means
817    accessing the memory pointed to won't generate a trap.  However,
818    this only applies to an object when used appropriately: it doesn't
819    mean that writing a READONLY mem won't trap.
820
821    In ARRAY_REF and ARRAY_RANGE_REF means that we know that the index
822    (or slice of the array) always belongs to the range of the array.
823    I.e. that the access will not trap, provided that the access to
824    the base to the array will not trap.  */
825 #define TREE_THIS_NOTRAP(NODE) ((NODE)->common.nothrow_flag)
826
827 /* In a VAR_DECL, PARM_DECL or FIELD_DECL, or any kind of ..._REF node,
828    nonzero means it may not be the lhs of an assignment.  */
829 #define TREE_READONLY(NODE) (NON_TYPE_CHECK (NODE)->common.readonly_flag)
830
831 /* Nonzero if NODE is a _DECL with TREE_READONLY set.  */
832 #define TREE_READONLY_DECL_P(NODE) (DECL_P (NODE) && TREE_READONLY (NODE))
833
834 /* Value of expression is constant.  Always on in all ..._CST nodes.  May
835    also appear in an expression or decl where the value is constant.  */
836 #define TREE_CONSTANT(NODE) (NON_TYPE_CHECK (NODE)->common.constant_flag)
837
838 /* In a decl (most significantly a FIELD_DECL), means an unsigned field.  */
839 #define DECL_UNSIGNED(NODE) (DECL_CHECK (NODE)->common.unsigned_flag)
840
841 /* In a BIT_FIELD_REF, means the bitfield is to be interpreted as unsigned.  */
842 #define BIT_FIELD_REF_UNSIGNED(NODE) \
843   (BIT_FIELD_REF_CHECK (NODE)->common.unsigned_flag)
844
845 /* In integral and pointer types, means an unsigned type.  */
846 #define TYPE_UNSIGNED(NODE) (TYPE_CHECK (NODE)->common.unsigned_flag)
847
848 #define TYPE_TRAP_SIGNED(NODE) \
849   (flag_trapv && ! TYPE_UNSIGNED (NODE))
850
851 /* Nonzero in a VAR_DECL means assembler code has been written.
852    Nonzero in a FUNCTION_DECL means that the function has been compiled.
853    This is interesting in an inline function, since it might not need
854    to be compiled separately.
855    Nonzero in a RECORD_TYPE, UNION_TYPE, QUAL_UNION_TYPE or ENUMERAL_TYPE
856    if the sdb debugging info for the type has been written.
857    In a BLOCK node, nonzero if reorder_blocks has already seen this block.
858    In an SSA_NAME node, nonzero if the SSA_NAME occurs in an abnormal
859    PHI node.  */
860 #define TREE_ASM_WRITTEN(NODE) ((NODE)->common.asm_written_flag)
861
862 /* Nonzero in a _DECL if the name is used in its scope.
863    Nonzero in an expr node means inhibit warning if value is unused.
864    In IDENTIFIER_NODEs, this means that some extern decl for this name
865    was used.  */
866 #define TREE_USED(NODE) ((NODE)->common.used_flag)
867
868 /* In a FUNCTION_DECL, nonzero means a call to the function cannot throw
869    an exception.  In a CALL_EXPR, nonzero means the call cannot throw.  */
870 #define TREE_NOTHROW(NODE) ((NODE)->common.nothrow_flag)
871
872 /* In a CALL_EXPR, means that the address of the return slot is part of the
873    argument list.  */
874 #define CALL_EXPR_HAS_RETURN_SLOT_ADDR(NODE) ((NODE)->common.private_flag)
875
876 /* In a RESULT_DECL or PARM_DECL, means that it is passed by invisible
877    reference (and the TREE_TYPE is a pointer to the true type).  */
878 #define DECL_BY_REFERENCE(NODE) (DECL_CHECK (NODE)->common.private_flag)
879
880 /* In a CALL_EXPR, means that the call is the jump from a thunk to the
881    thunked-to function.  */
882 #define CALL_FROM_THUNK_P(NODE) ((NODE)->common.protected_flag)
883
884 /* In a type, nonzero means that all objects of the type are guaranteed by the
885    language or front-end to be properly aligned, so we can indicate that a MEM
886    of this type is aligned at least to the alignment of the type, even if it
887    doesn't appear that it is.  We see this, for example, in object-oriented
888    languages where a tag field may show this is an object of a more-aligned
889    variant of the more generic type.
890
891    In an SSA_NAME node, nonzero if the SSA_NAME node is on the SSA_NAME
892    freelist.  */
893 #define TYPE_ALIGN_OK(NODE) (TYPE_CHECK (NODE)->common.nothrow_flag)
894
895 /* Used in classes in C++.  */
896 #define TREE_PRIVATE(NODE) ((NODE)->common.private_flag)
897 /* Used in classes in C++.
898    In a BLOCK node, this is BLOCK_HANDLER_BLOCK.  */
899 #define TREE_PROTECTED(NODE) ((NODE)->common.protected_flag)
900
901 /* Nonzero in an IDENTIFIER_NODE if the use of the name is defined as a
902    deprecated feature by __attribute__((deprecated)).  */
903 #define TREE_DEPRECATED(NODE) ((NODE)->common.deprecated_flag)
904
905 /* Value of expression is function invariant.  A strict subset of
906    TREE_CONSTANT, such an expression is constant over any one function
907    invocation, though not across different invocations.  May appear in
908    any expression node.  */
909 #define TREE_INVARIANT(NODE) ((NODE)->common.invariant_flag)
910
911 /* These flags are available for each language front end to use internally.  */
912 #define TREE_LANG_FLAG_0(NODE) ((NODE)->common.lang_flag_0)
913 #define TREE_LANG_FLAG_1(NODE) ((NODE)->common.lang_flag_1)
914 #define TREE_LANG_FLAG_2(NODE) ((NODE)->common.lang_flag_2)
915 #define TREE_LANG_FLAG_3(NODE) ((NODE)->common.lang_flag_3)
916 #define TREE_LANG_FLAG_4(NODE) ((NODE)->common.lang_flag_4)
917 #define TREE_LANG_FLAG_5(NODE) ((NODE)->common.lang_flag_5)
918 #define TREE_LANG_FLAG_6(NODE) ((NODE)->common.lang_flag_6)
919 \f
920 /* Define additional fields and accessors for nodes representing constants.  */
921
922 /* In an INTEGER_CST node.  These two together make a 2-word integer.
923    If the data type is signed, the value is sign-extended to 2 words
924    even though not all of them may really be in use.
925    In an unsigned constant shorter than 2 words, the extra bits are 0.  */
926 #define TREE_INT_CST(NODE) (INTEGER_CST_CHECK (NODE)->int_cst.int_cst)
927 #define TREE_INT_CST_LOW(NODE) (TREE_INT_CST (NODE).low)
928 #define TREE_INT_CST_HIGH(NODE) (TREE_INT_CST (NODE).high)
929
930 #define INT_CST_LT(A, B)                                \
931   (TREE_INT_CST_HIGH (A) < TREE_INT_CST_HIGH (B)        \
932    || (TREE_INT_CST_HIGH (A) == TREE_INT_CST_HIGH (B)   \
933        && TREE_INT_CST_LOW (A) < TREE_INT_CST_LOW (B)))
934
935 #define INT_CST_LT_UNSIGNED(A, B)                               \
936   (((unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (A)              \
937     < (unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (B))           \
938    || (((unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (A)          \
939         == (unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (B))      \
940        && TREE_INT_CST_LOW (A) < TREE_INT_CST_LOW (B)))
941
942 struct tree_int_cst GTY(())
943 {
944   struct tree_common common;
945   /* A sub-struct is necessary here because the function `const_hash'
946      wants to scan both words as a unit and taking the address of the
947      sub-struct yields the properly inclusive bounded pointer.  */
948   struct tree_int_cst_lowhi {
949     unsigned HOST_WIDE_INT low;
950     HOST_WIDE_INT high;
951   } int_cst;
952 };
953
954 /* In a REAL_CST node.  struct real_value is an opaque entity, with
955    manipulators defined in real.h.  We don't want tree.h depending on
956    real.h and transitively on tm.h.  */
957 struct real_value;
958
959 #define TREE_REAL_CST_PTR(NODE) (REAL_CST_CHECK (NODE)->real_cst.real_cst_ptr)
960 #define TREE_REAL_CST(NODE) (*TREE_REAL_CST_PTR (NODE))
961
962 struct tree_real_cst GTY(())
963 {
964   struct tree_common common;
965   struct real_value * real_cst_ptr;
966 };
967
968 /* In a STRING_CST */
969 #define TREE_STRING_LENGTH(NODE) (STRING_CST_CHECK (NODE)->string.length)
970 #define TREE_STRING_POINTER(NODE) (STRING_CST_CHECK (NODE)->string.pointer)
971
972 struct tree_string GTY(())
973 {
974   struct tree_common common;
975   int length;
976   const char *pointer;
977 };
978
979 /* In a COMPLEX_CST node.  */
980 #define TREE_REALPART(NODE) (COMPLEX_CST_CHECK (NODE)->complex.real)
981 #define TREE_IMAGPART(NODE) (COMPLEX_CST_CHECK (NODE)->complex.imag)
982
983 struct tree_complex GTY(())
984 {
985   struct tree_common common;
986   tree real;
987   tree imag;
988 };
989
990 /* In a VECTOR_CST node.  */
991 #define TREE_VECTOR_CST_ELTS(NODE) (VECTOR_CST_CHECK (NODE)->vector.elements)
992
993 struct tree_vector GTY(())
994 {
995   struct tree_common common;
996   tree elements;
997 };
998 \f
999 #include "symtab.h"
1000
1001 /* Define fields and accessors for some special-purpose tree nodes.  */
1002
1003 #define IDENTIFIER_LENGTH(NODE) \
1004   (IDENTIFIER_NODE_CHECK (NODE)->identifier.id.len)
1005 #define IDENTIFIER_POINTER(NODE) \
1006   ((const char *) IDENTIFIER_NODE_CHECK (NODE)->identifier.id.str)
1007 #define IDENTIFIER_HASH_VALUE(NODE) \
1008   (IDENTIFIER_NODE_CHECK (NODE)->identifier.id.hash_value)
1009
1010 /* Translate a hash table identifier pointer to a tree_identifier
1011    pointer, and vice versa.  */
1012
1013 #define HT_IDENT_TO_GCC_IDENT(NODE) \
1014   ((tree) ((char *) (NODE) - sizeof (struct tree_common)))
1015 #define GCC_IDENT_TO_HT_IDENT(NODE) (&((struct tree_identifier *) (NODE))->id)
1016
1017 struct tree_identifier GTY(())
1018 {
1019   struct tree_common common;
1020   struct ht_identifier id;
1021 };
1022
1023 /* In a TREE_LIST node.  */
1024 #define TREE_PURPOSE(NODE) (TREE_LIST_CHECK (NODE)->list.purpose)
1025 #define TREE_VALUE(NODE) (TREE_LIST_CHECK (NODE)->list.value)
1026
1027 struct tree_list GTY(())
1028 {
1029   struct tree_common common;
1030   tree purpose;
1031   tree value;
1032 };
1033
1034 /* In a TREE_VEC node.  */
1035 #define TREE_VEC_LENGTH(NODE) (TREE_VEC_CHECK (NODE)->vec.length)
1036 #define TREE_VEC_END(NODE) \
1037   ((void) TREE_VEC_CHECK (NODE), &((NODE)->vec.a[(NODE)->vec.length]))
1038
1039 #define TREE_VEC_ELT(NODE,I) TREE_VEC_ELT_CHECK (NODE, I)
1040
1041 struct tree_vec GTY(())
1042 {
1043   struct tree_common common;
1044   int length;
1045   tree GTY ((length ("TREE_VEC_LENGTH ((tree)&%h)"))) a[1];
1046 };
1047
1048 /* Define fields and accessors for some nodes that represent expressions.  */
1049
1050 /* Nonzero if NODE is an empty statement (NOP_EXPR <0>).  */
1051 #define IS_EMPTY_STMT(NODE)     (TREE_CODE (NODE) == NOP_EXPR \
1052                                  && VOID_TYPE_P (TREE_TYPE (NODE)) \
1053                                  && integer_zerop (TREE_OPERAND (NODE, 0)))
1054
1055 /* In a CONSTRUCTOR node.  */
1056 #define CONSTRUCTOR_ELTS(NODE) TREE_OPERAND_CHECK_CODE (NODE, CONSTRUCTOR, 0)
1057
1058 /* In ordinary expression nodes.  */
1059 #define TREE_OPERAND(NODE, I) TREE_OPERAND_CHECK (NODE, I)
1060 #define TREE_COMPLEXITY(NODE) (EXPR_CHECK (NODE)->exp.complexity)
1061
1062 /* In a LABELED_BLOCK_EXPR node.  */
1063 #define LABELED_BLOCK_LABEL(NODE) \
1064   TREE_OPERAND_CHECK_CODE (NODE, LABELED_BLOCK_EXPR, 0)
1065 #define LABELED_BLOCK_BODY(NODE) \
1066   TREE_OPERAND_CHECK_CODE (NODE, LABELED_BLOCK_EXPR, 1)
1067
1068 /* In an EXIT_BLOCK_EXPR node.  */
1069 #define EXIT_BLOCK_LABELED_BLOCK(NODE) \
1070   TREE_OPERAND_CHECK_CODE (NODE, EXIT_BLOCK_EXPR, 0)
1071 #define EXIT_BLOCK_RETURN(NODE) TREE_OPERAND_CHECK_CODE (NODE, EXIT_BLOCK_EXPR, 1)
1072
1073 /* In a LOOP_EXPR node.  */
1074 #define LOOP_EXPR_BODY(NODE) TREE_OPERAND_CHECK_CODE (NODE, LOOP_EXPR, 0)
1075
1076 #ifdef USE_MAPPED_LOCATION
1077 /* The source location of this expression.  Non-tree_exp nodes such as
1078    decls and constants can be shared among multiple locations, so
1079    return nothing.  */
1080 #define EXPR_LOCATION(NODE)                                     \
1081   (IS_EXPR_CODE_CLASS (TREE_CODE_CLASS (TREE_CODE (NODE)))      \
1082    ? (NODE)->exp.locus                                          \
1083    : UNKNOWN_LOCATION)
1084 #define SET_EXPR_LOCATION(NODE, FROM) \
1085   (EXPR_CHECK (NODE)->exp.locus = (FROM))
1086 #define EXPR_HAS_LOCATION(NODE) (EXPR_LOCATION (NODE) != UNKNOWN_LOCATION)
1087 /* EXPR_LOCUS and SET_EXPR_LOCUS are deprecated. */
1088 #define EXPR_LOCUS(NODE)                                        \
1089   (IS_EXPR_CODE_CLASS (TREE_CODE_CLASS (TREE_CODE (NODE)))      \
1090    ? &(NODE)->exp.locus                                         \
1091    : (location_t *)NULL)
1092 #define SET_EXPR_LOCUS(NODE, FROM) \
1093   do { source_location *loc_tmp = FROM; \
1094        EXPR_CHECK (NODE)->exp.locus \
1095        = loc_tmp == NULL ? UNKNOWN_LOCATION : *loc_tmp; } while (0)
1096 #define EXPR_FILENAME(NODE) \
1097   LOCATION_FILE (EXPR_CHECK (NODE)->exp.locus)
1098 #define EXPR_LINENO(NODE) \
1099   LOCATION_LINE (EXPR_CHECK (NODE)->exp.locus)
1100 #else
1101 /* The source location of this expression.  Non-tree_exp nodes such as
1102    decls and constants can be shared among multiple locations, so
1103    return nothing.  */
1104 #define EXPR_LOCUS(NODE)                                        \
1105   (IS_EXPR_CODE_CLASS (TREE_CODE_CLASS (TREE_CODE (NODE)))      \
1106    ? (NODE)->exp.locus                                          \
1107    : (location_t *)NULL)
1108 #define SET_EXPR_LOCUS(NODE, FROM) \
1109   (EXPR_CHECK (NODE)->exp.locus = (FROM))
1110 #define SET_EXPR_LOCATION(NODE, FROM) annotate_with_locus (NODE, FROM)
1111 #define EXPR_FILENAME(NODE) \
1112   (EXPR_CHECK (NODE)->exp.locus->file)
1113 #define EXPR_LINENO(NODE) \
1114   (EXPR_CHECK (NODE)->exp.locus->line)
1115 #define EXPR_HAS_LOCATION(NODE) (EXPR_LOCUS (NODE) != NULL)
1116 #define EXPR_LOCATION(NODE) \
1117   (EXPR_HAS_LOCATION(NODE) ? *(NODE)->exp.locus : UNKNOWN_LOCATION)
1118 #endif
1119
1120 /* In a TARGET_EXPR node.  */
1121 #define TARGET_EXPR_SLOT(NODE) TREE_OPERAND_CHECK_CODE (NODE, TARGET_EXPR, 0)
1122 #define TARGET_EXPR_INITIAL(NODE) TREE_OPERAND_CHECK_CODE (NODE, TARGET_EXPR, 1)
1123 #define TARGET_EXPR_CLEANUP(NODE) TREE_OPERAND_CHECK_CODE (NODE, TARGET_EXPR, 2)
1124
1125 /* DECL_EXPR accessor. This gives access to the DECL associated with
1126    the given declaration statement.  */
1127 #define DECL_EXPR_DECL(NODE)    TREE_OPERAND (DECL_EXPR_CHECK (NODE), 0)
1128
1129 #define EXIT_EXPR_COND(NODE)         TREE_OPERAND (EXIT_EXPR_CHECK (NODE), 0)
1130
1131 /* SWITCH_EXPR accessors. These give access to the condition, body and
1132    original condition type (before any compiler conversions)
1133    of the switch statement, respectively.  */
1134 #define SWITCH_COND(NODE)       TREE_OPERAND ((NODE), 0)
1135 #define SWITCH_BODY(NODE)       TREE_OPERAND ((NODE), 1)
1136 #define SWITCH_LABELS(NODE)     TREE_OPERAND ((NODE), 2)
1137
1138 /* CASE_LABEL_EXPR accessors. These give access to the high and low values
1139    of a case label, respectively.  */
1140 #define CASE_LOW(NODE)          TREE_OPERAND ((NODE), 0)
1141 #define CASE_HIGH(NODE)         TREE_OPERAND ((NODE), 1)
1142 #define CASE_LABEL(NODE)        TREE_OPERAND ((NODE), 2)
1143
1144 /* The operands of a BIND_EXPR.  */
1145 #define BIND_EXPR_VARS(NODE) (TREE_OPERAND (BIND_EXPR_CHECK (NODE), 0))
1146 #define BIND_EXPR_BODY(NODE) (TREE_OPERAND (BIND_EXPR_CHECK (NODE), 1))
1147 #define BIND_EXPR_BLOCK(NODE) (TREE_OPERAND (BIND_EXPR_CHECK (NODE), 2))
1148
1149 /* GOTO_EXPR accessor. This gives access to the label associated with
1150    a goto statement.  */
1151 #define GOTO_DESTINATION(NODE)  TREE_OPERAND ((NODE), 0)
1152
1153 /* ASM_EXPR accessors. ASM_STRING returns a STRING_CST for the
1154    instruction (e.g., "mov x, y"). ASM_OUTPUTS, ASM_INPUTS, and
1155    ASM_CLOBBERS represent the outputs, inputs, and clobbers for the
1156    statement.  */
1157 #define ASM_STRING(NODE)        TREE_OPERAND ((NODE), 0)
1158 #define ASM_OUTPUTS(NODE)       TREE_OPERAND ((NODE), 1)
1159 #define ASM_INPUTS(NODE)        TREE_OPERAND ((NODE), 2)
1160 #define ASM_CLOBBERS(NODE)      TREE_OPERAND ((NODE), 3)
1161 /* Nonzero if we want to create an ASM_INPUT instead of an
1162    ASM_OPERAND with no operands.  */
1163 #define ASM_INPUT_P(NODE) (TREE_STATIC (NODE))
1164 #define ASM_VOLATILE_P(NODE) (TREE_PUBLIC (NODE))
1165
1166 /* COND_EXPR accessors.  */
1167 #define COND_EXPR_COND(NODE)    (TREE_OPERAND (COND_EXPR_CHECK (NODE), 0))
1168 #define COND_EXPR_THEN(NODE)    (TREE_OPERAND (COND_EXPR_CHECK (NODE), 1))
1169 #define COND_EXPR_ELSE(NODE)    (TREE_OPERAND (COND_EXPR_CHECK (NODE), 2))
1170
1171 /* LABEL_EXPR accessor. This gives access to the label associated with
1172    the given label expression.  */
1173 #define LABEL_EXPR_LABEL(NODE)  TREE_OPERAND (LABEL_EXPR_CHECK (NODE), 0)
1174
1175 /* VDEF_EXPR accessors are specified in tree-flow.h, along with the other
1176    accessors for SSA operands.  */
1177
1178 /* CATCH_EXPR accessors.  */
1179 #define CATCH_TYPES(NODE)       TREE_OPERAND (CATCH_EXPR_CHECK (NODE), 0)
1180 #define CATCH_BODY(NODE)        TREE_OPERAND (CATCH_EXPR_CHECK (NODE), 1)
1181
1182 /* EH_FILTER_EXPR accessors.  */
1183 #define EH_FILTER_TYPES(NODE)   TREE_OPERAND (EH_FILTER_EXPR_CHECK (NODE), 0)
1184 #define EH_FILTER_FAILURE(NODE) TREE_OPERAND (EH_FILTER_EXPR_CHECK (NODE), 1)
1185 #define EH_FILTER_MUST_NOT_THROW(NODE) TREE_STATIC (EH_FILTER_EXPR_CHECK (NODE))
1186
1187 /* OBJ_TYPE_REF accessors.  */
1188 #define OBJ_TYPE_REF_EXPR(NODE)   TREE_OPERAND (OBJ_TYPE_REF_CHECK (NODE), 0)
1189 #define OBJ_TYPE_REF_OBJECT(NODE) TREE_OPERAND (OBJ_TYPE_REF_CHECK (NODE), 1)
1190 #define OBJ_TYPE_REF_TOKEN(NODE)  TREE_OPERAND (OBJ_TYPE_REF_CHECK (NODE), 2)
1191
1192 struct tree_exp GTY(())
1193 {
1194   struct tree_common common;
1195   source_locus locus;
1196   int complexity;
1197   tree block;
1198   tree GTY ((special ("tree_exp"),
1199              desc ("TREE_CODE ((tree) &%0)")))
1200     operands[1];
1201 };
1202 \f
1203 /* SSA_NAME accessors.  */
1204
1205 /* Returns the variable being referenced.  Once released, this is the
1206    only field that can be relied upon.  */
1207 #define SSA_NAME_VAR(NODE)      SSA_NAME_CHECK (NODE)->ssa_name.var
1208
1209 /* Returns the statement which defines this reference.   Note that
1210    we use the same field when chaining SSA_NAME nodes together on
1211    the SSA_NAME freelist.  */
1212 #define SSA_NAME_DEF_STMT(NODE) SSA_NAME_CHECK (NODE)->common.chain
1213
1214 /* Returns the SSA version number of this SSA name.  Note that in
1215    tree SSA, version numbers are not per variable and may be recycled.  */
1216 #define SSA_NAME_VERSION(NODE)  SSA_NAME_CHECK (NODE)->ssa_name.version
1217
1218 /* Nonzero if this SSA name occurs in an abnormal PHI.  SSA_NAMES are
1219    never output, so we can safely use the ASM_WRITTEN_FLAG for this
1220    status bit.  */
1221 #define SSA_NAME_OCCURS_IN_ABNORMAL_PHI(NODE) \
1222     SSA_NAME_CHECK (NODE)->common.asm_written_flag
1223
1224 /* Nonzero if this SSA_NAME expression is currently on the free list of
1225    SSA_NAMES.  Using NOTHROW_FLAG seems reasonably safe since throwing
1226    has no meaning for an SSA_NAME.  */
1227 #define SSA_NAME_IN_FREE_LIST(NODE) \
1228     SSA_NAME_CHECK (NODE)->common.nothrow_flag
1229
1230 /* Attributes for SSA_NAMEs for pointer-type variables.  */
1231 #define SSA_NAME_PTR_INFO(N) \
1232     SSA_NAME_CHECK (N)->ssa_name.ptr_info
1233
1234 /* Get the value of this SSA_NAME, if available.  */
1235 #define SSA_NAME_VALUE(N) \
1236    SSA_NAME_CHECK (N)->ssa_name.value_handle
1237
1238 /* Auxiliary pass-specific data.  */
1239 #define SSA_NAME_AUX(N) \
1240    SSA_NAME_CHECK (N)->ssa_name.aux
1241
1242 #ifndef _TREE_FLOW_H
1243 struct ptr_info_def;
1244 #endif
1245
1246 struct tree_ssa_name GTY(())
1247 {
1248   struct tree_common common;
1249
1250   /* _DECL wrapped by this SSA name.  */
1251   tree var;
1252
1253   /* SSA version number.  */
1254   unsigned int version;
1255
1256   /* Pointer attributes used for alias analysis.  */
1257   struct ptr_info_def *ptr_info;
1258
1259   /* Value for SSA name used by GVN.  */
1260   tree GTY((skip)) value_handle;
1261
1262   /* Auxiliary information stored with the ssa name.  */
1263   PTR GTY((skip)) aux;
1264 };
1265 \f
1266 /* In a PHI_NODE node.  */
1267 #define PHI_RESULT_TREE(NODE)           PHI_NODE_CHECK (NODE)->phi.result
1268 #define PHI_ARG_DEF_TREE(NODE, I)       PHI_NODE_ELT_CHECK (NODE, I).def
1269
1270 /* PHI_NODEs for each basic block are chained together in a single linked
1271    list.  The head of the list is linked from the block annotation, and
1272    the link to the next PHI is in PHI_CHAIN.  */
1273 #define PHI_CHAIN(NODE)         TREE_CHAIN (PHI_NODE_CHECK (NODE))
1274
1275 /* Nonzero if the PHI node was rewritten by a previous pass through the
1276    SSA renamer.  */
1277 #define PHI_REWRITTEN(NODE)             PHI_NODE_CHECK (NODE)->phi.rewritten
1278 #define PHI_NUM_ARGS(NODE)              PHI_NODE_CHECK (NODE)->phi.num_args
1279 #define PHI_ARG_CAPACITY(NODE)          PHI_NODE_CHECK (NODE)->phi.capacity
1280 #define PHI_ARG_ELT(NODE, I)            PHI_NODE_ELT_CHECK (NODE, I)
1281 #define PHI_ARG_EDGE(NODE, I)           PHI_NODE_ELT_CHECK (NODE, I).e
1282 #define PHI_ARG_NONZERO(NODE, I)        PHI_NODE_ELT_CHECK (NODE, I).nonzero
1283
1284 struct edge_def;
1285
1286 struct phi_arg_d GTY(())
1287 {
1288   tree def;
1289   struct edge_def * GTY((skip (""))) e;
1290   bool nonzero;
1291 };
1292
1293 struct tree_phi_node GTY(())
1294 {
1295   struct tree_common common;
1296   tree result;
1297   int num_args;
1298   int capacity;
1299
1300   /* Nonzero if the PHI node was rewritten by a previous pass through the
1301      SSA renamer.  */
1302   int rewritten;
1303
1304   struct phi_arg_d GTY ((length ("((tree)&%h)->phi.capacity"))) a[1];
1305 };
1306 \f
1307
1308 struct varray_head_tag;
1309
1310 /* In a BLOCK node.  */
1311 #define BLOCK_VARS(NODE) (BLOCK_CHECK (NODE)->block.vars)
1312 #define BLOCK_SUBBLOCKS(NODE) (BLOCK_CHECK (NODE)->block.subblocks)
1313 #define BLOCK_SUPERCONTEXT(NODE) (BLOCK_CHECK (NODE)->block.supercontext)
1314 /* Note: when changing this, make sure to find the places
1315    that use chainon or nreverse.  */
1316 #define BLOCK_CHAIN(NODE) TREE_CHAIN (BLOCK_CHECK (NODE))
1317 #define BLOCK_ABSTRACT_ORIGIN(NODE) (BLOCK_CHECK (NODE)->block.abstract_origin)
1318 #define BLOCK_ABSTRACT(NODE) (BLOCK_CHECK (NODE)->block.abstract_flag)
1319
1320 /* Nonzero means that this block is prepared to handle exceptions
1321    listed in the BLOCK_VARS slot.  */
1322 #define BLOCK_HANDLER_BLOCK(NODE) \
1323   (BLOCK_CHECK (NODE)->block.handler_block_flag)
1324
1325 /* An index number for this block.  These values are not guaranteed to
1326    be unique across functions -- whether or not they are depends on
1327    the debugging output format in use.  */
1328 #define BLOCK_NUMBER(NODE) (BLOCK_CHECK (NODE)->block.block_num)
1329
1330 /* If block reordering splits a lexical block into discontiguous
1331    address ranges, we'll make a copy of the original block.
1332
1333    Note that this is logically distinct from BLOCK_ABSTRACT_ORIGIN.
1334    In that case, we have one source block that has been replicated
1335    (through inlining or unrolling) into many logical blocks, and that
1336    these logical blocks have different physical variables in them.
1337
1338    In this case, we have one logical block split into several
1339    non-contiguous address ranges.  Most debug formats can't actually
1340    represent this idea directly, so we fake it by creating multiple
1341    logical blocks with the same variables in them.  However, for those
1342    that do support non-contiguous regions, these allow the original
1343    logical block to be reconstructed, along with the set of address
1344    ranges.
1345
1346    One of the logical block fragments is arbitrarily chosen to be
1347    the ORIGIN.  The other fragments will point to the origin via
1348    BLOCK_FRAGMENT_ORIGIN; the origin itself will have this pointer
1349    be null.  The list of fragments will be chained through
1350    BLOCK_FRAGMENT_CHAIN from the origin.  */
1351
1352 #define BLOCK_FRAGMENT_ORIGIN(NODE) (BLOCK_CHECK (NODE)->block.fragment_origin)
1353 #define BLOCK_FRAGMENT_CHAIN(NODE) (BLOCK_CHECK (NODE)->block.fragment_chain)
1354
1355 struct tree_block GTY(())
1356 {
1357   struct tree_common common;
1358
1359   unsigned handler_block_flag : 1;
1360   unsigned abstract_flag : 1;
1361   unsigned block_num : 30;
1362
1363   tree vars;
1364   tree subblocks;
1365   tree supercontext;
1366   tree abstract_origin;
1367   tree fragment_origin;
1368   tree fragment_chain;
1369 };
1370 \f
1371 /* Define fields and accessors for nodes representing data types.  */
1372
1373 /* See tree.def for documentation of the use of these fields.
1374    Look at the documentation of the various ..._TYPE tree codes.
1375
1376    Note that the type.values, type.minval, and type.maxval fields are
1377    overloaded and used for different macros in different kinds of types.
1378    Each macro must check to ensure the tree node is of the proper kind of
1379    type.  Note also that some of the front-ends also overload these fields,
1380    so they must be checked as well.  */
1381
1382 #define TYPE_UID(NODE) (TYPE_CHECK (NODE)->type.uid)
1383 #define TYPE_SIZE(NODE) (TYPE_CHECK (NODE)->type.size)
1384 #define TYPE_SIZE_UNIT(NODE) (TYPE_CHECK (NODE)->type.size_unit)
1385 #define TYPE_MODE(NODE) (TYPE_CHECK (NODE)->type.mode)
1386 #define TYPE_VALUES(NODE) (ENUMERAL_TYPE_CHECK (NODE)->type.values)
1387 #define TYPE_DOMAIN(NODE) (SET_OR_ARRAY_CHECK (NODE)->type.values)
1388 #define TYPE_FIELDS(NODE) (RECORD_OR_UNION_CHECK (NODE)->type.values)
1389 #define TYPE_CACHED_VALUES(NODE) (TYPE_CHECK(NODE)->type.values)
1390 #define TYPE_ORIG_SIZE_TYPE(NODE)                       \
1391   (INTEGER_TYPE_CHECK (NODE)->type.values               \
1392   ? TREE_TYPE ((NODE)->type.values) : NULL_TREE)
1393 #define TYPE_METHODS(NODE) (RECORD_OR_UNION_CHECK (NODE)->type.maxval)
1394 #define TYPE_VFIELD(NODE) (RECORD_OR_UNION_CHECK (NODE)->type.minval)
1395 #define TYPE_ARG_TYPES(NODE) (FUNC_OR_METHOD_CHECK (NODE)->type.values)
1396 #define TYPE_METHOD_BASETYPE(NODE) (FUNC_OR_METHOD_CHECK (NODE)->type.maxval)
1397 #define TYPE_OFFSET_BASETYPE(NODE) (OFFSET_TYPE_CHECK (NODE)->type.maxval)
1398 #define TYPE_POINTER_TO(NODE) (TYPE_CHECK (NODE)->type.pointer_to)
1399 #define TYPE_REFERENCE_TO(NODE) (TYPE_CHECK (NODE)->type.reference_to)
1400 #define TYPE_NEXT_PTR_TO(NODE) (POINTER_TYPE_CHECK (NODE)->type.minval)
1401 #define TYPE_NEXT_REF_TO(NODE) (REFERENCE_TYPE_CHECK (NODE)->type.minval)
1402 #define TYPE_MIN_VALUE(NODE) (NUMERICAL_TYPE_CHECK (NODE)->type.minval)
1403 #define TYPE_MAX_VALUE(NODE) (NUMERICAL_TYPE_CHECK (NODE)->type.maxval)
1404 #define TYPE_PRECISION(NODE) (TYPE_CHECK (NODE)->type.precision)
1405 #define TYPE_SYMTAB_ADDRESS(NODE) (TYPE_CHECK (NODE)->type.symtab.address)
1406 #define TYPE_SYMTAB_POINTER(NODE) (TYPE_CHECK (NODE)->type.symtab.pointer)
1407 #define TYPE_SYMTAB_DIE(NODE) (TYPE_CHECK (NODE)->type.symtab.die)
1408 #define TYPE_NAME(NODE) (TYPE_CHECK (NODE)->type.name)
1409 #define TYPE_NEXT_VARIANT(NODE) (TYPE_CHECK (NODE)->type.next_variant)
1410 #define TYPE_MAIN_VARIANT(NODE) (TYPE_CHECK (NODE)->type.main_variant)
1411 #define TYPE_CONTEXT(NODE) (TYPE_CHECK (NODE)->type.context)
1412 #define TYPE_LANG_SPECIFIC(NODE) (TYPE_CHECK (NODE)->type.lang_specific)
1413
1414 /* For a VECTOR_TYPE node, this describes a different type which is emitted
1415    in the debugging output.  We use this to describe a vector as a
1416    structure containing an array.  */
1417 #define TYPE_DEBUG_REPRESENTATION_TYPE(NODE) (VECTOR_TYPE_CHECK (NODE)->type.values)
1418
1419 /* For record and union types, information about this type, as a base type
1420    for itself. */
1421 #define TYPE_BINFO(NODE) (RECORD_OR_UNION_CHECK(NODE)->type.binfo)
1422
1423 /* For non record and union types, used in a language-dependent way.  */
1424 #define TYPE_LANG_SLOT_1(NODE) (NOT_RECORD_OR_UNION_CHECK(NODE)->type.binfo)
1425
1426 /* The (language-specific) typed-based alias set for this type.
1427    Objects whose TYPE_ALIAS_SETs are different cannot alias each
1428    other.  If the TYPE_ALIAS_SET is -1, no alias set has yet been
1429    assigned to this type.  If the TYPE_ALIAS_SET is 0, objects of this
1430    type can alias objects of any type.  */
1431 #define TYPE_ALIAS_SET(NODE) (TYPE_CHECK (NODE)->type.alias_set)
1432
1433 /* Nonzero iff the typed-based alias set for this type has been
1434    calculated.  */
1435 #define TYPE_ALIAS_SET_KNOWN_P(NODE) (TYPE_CHECK (NODE)->type.alias_set != -1)
1436
1437 /* A TREE_LIST of IDENTIFIER nodes of the attributes that apply
1438    to this type.  */
1439 #define TYPE_ATTRIBUTES(NODE) (TYPE_CHECK (NODE)->type.attributes)
1440
1441 /* The alignment necessary for objects of this type.
1442    The value is an int, measured in bits.  */
1443 #define TYPE_ALIGN(NODE) (TYPE_CHECK (NODE)->type.align)
1444
1445 /* 1 if the alignment for this type was requested by "aligned" attribute,
1446    0 if it is the default for this type.  */
1447 #define TYPE_USER_ALIGN(NODE) (TYPE_CHECK (NODE)->type.user_align)
1448
1449 /* The alignment for NODE, in bytes.  */
1450 #define TYPE_ALIGN_UNIT(NODE) (TYPE_ALIGN (NODE) / BITS_PER_UNIT)
1451
1452 /* If your language allows you to declare types, and you want debug info
1453    for them, then you need to generate corresponding TYPE_DECL nodes.
1454    These "stub" TYPE_DECL nodes have no name, and simply point at the
1455    type node.  You then set the TYPE_STUB_DECL field of the type node
1456    to point back at the TYPE_DECL node.  This allows the debug routines
1457    to know that the two nodes represent the same type, so that we only
1458    get one debug info record for them.  */
1459 #define TYPE_STUB_DECL(NODE) TREE_CHAIN (NODE)
1460
1461 /* In a RECORD_TYPE, UNION_TYPE or QUAL_UNION_TYPE, it means the type
1462    has BLKmode only because it lacks the alignment requirement for
1463    its size.  */
1464 #define TYPE_NO_FORCE_BLK(NODE) (TYPE_CHECK (NODE)->type.no_force_blk_flag)
1465
1466 /* In an INTEGER_TYPE, it means the type represents a size.  We use
1467    this both for validity checking and to permit optimizations that
1468    are unsafe for other types.  Note that the C `size_t' type should
1469    *not* have this flag set.  The `size_t' type is simply a typedef
1470    for an ordinary integer type that happens to be the type of an
1471    expression returned by `sizeof'; `size_t' has no special
1472    properties.  Expressions whose type have TYPE_IS_SIZETYPE set are
1473    always actual sizes.  */
1474 #define TYPE_IS_SIZETYPE(NODE) \
1475   (INTEGER_TYPE_CHECK (NODE)->type.no_force_blk_flag)
1476
1477 /* In a FUNCTION_TYPE, indicates that the function returns with the stack
1478    pointer depressed.  */
1479 #define TYPE_RETURNS_STACK_DEPRESSED(NODE) \
1480   (FUNCTION_TYPE_CHECK (NODE)->type.no_force_blk_flag)
1481
1482 /* Nonzero in a type considered volatile as a whole.  */
1483 #define TYPE_VOLATILE(NODE) (TYPE_CHECK (NODE)->common.volatile_flag)
1484
1485 /* Means this type is const-qualified.  */
1486 #define TYPE_READONLY(NODE) (TYPE_CHECK (NODE)->common.readonly_flag)
1487
1488 /* If nonzero, this type is `restrict'-qualified, in the C sense of
1489    the term.  */
1490 #define TYPE_RESTRICT(NODE) (TYPE_CHECK (NODE)->type.restrict_flag)
1491
1492 /* There is a TYPE_QUAL value for each type qualifier.  They can be
1493    combined by bitwise-or to form the complete set of qualifiers for a
1494    type.  */
1495
1496 #define TYPE_UNQUALIFIED   0x0
1497 #define TYPE_QUAL_CONST    0x1
1498 #define TYPE_QUAL_VOLATILE 0x2
1499 #define TYPE_QUAL_RESTRICT 0x4
1500
1501 /* The set of type qualifiers for this type.  */
1502 #define TYPE_QUALS(NODE)                                        \
1503   ((TYPE_READONLY (NODE) * TYPE_QUAL_CONST)                     \
1504    | (TYPE_VOLATILE (NODE) * TYPE_QUAL_VOLATILE)                \
1505    | (TYPE_RESTRICT (NODE) * TYPE_QUAL_RESTRICT))
1506
1507 /* These flags are available for each language front end to use internally.  */
1508 #define TYPE_LANG_FLAG_0(NODE) (TYPE_CHECK (NODE)->type.lang_flag_0)
1509 #define TYPE_LANG_FLAG_1(NODE) (TYPE_CHECK (NODE)->type.lang_flag_1)
1510 #define TYPE_LANG_FLAG_2(NODE) (TYPE_CHECK (NODE)->type.lang_flag_2)
1511 #define TYPE_LANG_FLAG_3(NODE) (TYPE_CHECK (NODE)->type.lang_flag_3)
1512 #define TYPE_LANG_FLAG_4(NODE) (TYPE_CHECK (NODE)->type.lang_flag_4)
1513 #define TYPE_LANG_FLAG_5(NODE) (TYPE_CHECK (NODE)->type.lang_flag_5)
1514 #define TYPE_LANG_FLAG_6(NODE) (TYPE_CHECK (NODE)->type.lang_flag_6)
1515
1516 /* Used to keep track of visited nodes in tree traversals.  This is set to
1517    0 by copy_node and make_node.  */
1518 #define TREE_VISITED(NODE) ((NODE)->common.visited)
1519
1520 /* If set in an ARRAY_TYPE, indicates a string type (for languages
1521    that distinguish string from array of char).
1522    If set in a SET_TYPE, indicates a bitstring type.  */
1523 #define TYPE_STRING_FLAG(NODE) (TYPE_CHECK (NODE)->type.string_flag)
1524
1525 /* If non-NULL, this is an upper bound of the size (in bytes) of an
1526    object of the given ARRAY_TYPE.  This allows temporaries to be
1527    allocated.  */
1528 #define TYPE_ARRAY_MAX_SIZE(ARRAY_TYPE) \
1529   (ARRAY_TYPE_CHECK (ARRAY_TYPE)->type.maxval)
1530
1531 /* For a VECTOR_TYPE, this is the number of sub-parts of the vector.  */
1532 #define TYPE_VECTOR_SUBPARTS(VECTOR_TYPE) \
1533   (VECTOR_TYPE_CHECK (VECTOR_TYPE)->type.precision)
1534
1535 /* Indicates that objects of this type must be initialized by calling a
1536    function when they are created.  */
1537 #define TYPE_NEEDS_CONSTRUCTING(NODE) \
1538   (TYPE_CHECK (NODE)->type.needs_constructing_flag)
1539
1540 /* Indicates that objects of this type (a UNION_TYPE), should be passed
1541    the same way that the first union alternative would be passed.  */
1542 #define TYPE_TRANSPARENT_UNION(NODE)  \
1543   (UNION_TYPE_CHECK (NODE)->type.transparent_union_flag)
1544
1545 /* For an ARRAY_TYPE, indicates that it is not permitted to
1546    take the address of a component of the type.  */
1547 #define TYPE_NONALIASED_COMPONENT(NODE) \
1548   (ARRAY_TYPE_CHECK (NODE)->type.transparent_union_flag)
1549
1550 /* Indicated that objects of this type should be laid out in as
1551    compact a way as possible.  */
1552 #define TYPE_PACKED(NODE) (TYPE_CHECK (NODE)->type.packed_flag)
1553
1554 struct die_struct;
1555
1556 struct tree_type GTY(())
1557 {
1558   struct tree_common common;
1559   tree values;
1560   tree size;
1561   tree size_unit;
1562   tree attributes;
1563   unsigned int uid;
1564
1565   unsigned int precision : 9;
1566   ENUM_BITFIELD(machine_mode) mode : 7;
1567
1568   unsigned string_flag : 1;
1569   unsigned no_force_blk_flag : 1;
1570   unsigned needs_constructing_flag : 1;
1571   unsigned transparent_union_flag : 1;
1572   unsigned packed_flag : 1;
1573   unsigned restrict_flag : 1;
1574   unsigned spare : 2;
1575
1576   unsigned lang_flag_0 : 1;
1577   unsigned lang_flag_1 : 1;
1578   unsigned lang_flag_2 : 1;
1579   unsigned lang_flag_3 : 1;
1580   unsigned lang_flag_4 : 1;
1581   unsigned lang_flag_5 : 1;
1582   unsigned lang_flag_6 : 1;
1583   unsigned user_align : 1;
1584
1585   unsigned int align;
1586   tree pointer_to;
1587   tree reference_to;
1588   union tree_type_symtab {
1589     int GTY ((tag ("0"))) address;
1590     char * GTY ((tag ("1"))) pointer;
1591     struct die_struct * GTY ((tag ("2"))) die;
1592   } GTY ((desc ("debug_hooks == &sdb_debug_hooks ? 1 : debug_hooks == &dwarf2_debug_hooks ? 2 : 0"),
1593           descbits ("2"))) symtab;
1594   tree name;
1595   tree minval;
1596   tree maxval;
1597   tree next_variant;
1598   tree main_variant;
1599   tree binfo;
1600   tree context;
1601   HOST_WIDE_INT alias_set;
1602   /* Points to a structure whose details depend on the language in use.  */
1603   struct lang_type *lang_specific;
1604 };
1605 \f
1606 /* Define accessor macros for information about type inheritance
1607    and basetypes.
1608
1609    A "basetype" means a particular usage of a data type for inheritance
1610    in another type.  Each such basetype usage has its own "binfo"
1611    object to describe it.  The binfo object is a TREE_VEC node.
1612
1613    Inheritance is represented by the binfo nodes allocated for a
1614    given type.  For example, given types C and D, such that D is
1615    inherited by C, 3 binfo nodes will be allocated: one for describing
1616    the binfo properties of C, similarly one for D, and one for
1617    describing the binfo properties of D as a base type for C.
1618    Thus, given a pointer to class C, one can get a pointer to the binfo
1619    of D acting as a basetype for C by looking at C's binfo's basetypes.  */
1620
1621 /* BINFO specific flags.  */
1622
1623 /* Nonzero means that the derivation chain is via a `virtual' declaration.  */
1624 #define BINFO_VIRTUAL_P(NODE) (TREE_BINFO_CHECK (NODE)->common.static_flag)
1625
1626 /* Flags for language dependent use.  */
1627 #define BINFO_MARKED(NODE) TREE_LANG_FLAG_0(TREE_BINFO_CHECK(NODE))
1628 #define BINFO_FLAG_1(NODE) TREE_LANG_FLAG_1(TREE_BINFO_CHECK(NODE))
1629 #define BINFO_FLAG_2(NODE) TREE_LANG_FLAG_2(TREE_BINFO_CHECK(NODE))
1630 #define BINFO_FLAG_3(NODE) TREE_LANG_FLAG_3(TREE_BINFO_CHECK(NODE))
1631 #define BINFO_FLAG_4(NODE) TREE_LANG_FLAG_4(TREE_BINFO_CHECK(NODE))
1632 #define BINFO_FLAG_5(NODE) TREE_LANG_FLAG_5(TREE_BINFO_CHECK(NODE))
1633 #define BINFO_FLAG_6(NODE) TREE_LANG_FLAG_6(TREE_BINFO_CHECK(NODE))
1634
1635 /* The actual data type node being inherited in this basetype.  */
1636 #define BINFO_TYPE(NODE) TREE_TYPE (TREE_BINFO_CHECK(NODE))
1637
1638 /* The offset where this basetype appears in its containing type.
1639    BINFO_OFFSET slot holds the offset (in bytes)
1640    from the base of the complete object to the base of the part of the
1641    object that is allocated on behalf of this `type'.
1642    This is always 0 except when there is multiple inheritance.  */
1643
1644 #define BINFO_OFFSET(NODE) (TREE_BINFO_CHECK(NODE)->binfo.offset)
1645 #define BINFO_OFFSET_ZEROP(NODE) (integer_zerop (BINFO_OFFSET (NODE)))
1646
1647 /* The virtual function table belonging to this basetype.  Virtual
1648    function tables provide a mechanism for run-time method dispatching.
1649    The entries of a virtual function table are language-dependent.  */
1650
1651 #define BINFO_VTABLE(NODE) (TREE_BINFO_CHECK(NODE)->binfo.vtable)
1652
1653 /* The virtual functions in the virtual function table.  This is
1654    a TREE_LIST that is used as an initial approximation for building
1655    a virtual function table for this basetype.  */
1656 #define BINFO_VIRTUALS(NODE) (TREE_BINFO_CHECK(NODE)->binfo.virtuals)
1657
1658 /* A vector of binfos for the direct basetypes inherited by this
1659    basetype.
1660
1661    If this basetype describes type D as inherited in C, and if the
1662    basetypes of D are E and F, then this vector contains binfos for
1663    inheritance of E and F by C.  */
1664 #define BINFO_BASE_BINFOS(NODE) (&TREE_BINFO_CHECK(NODE)->binfo.base_binfos)
1665
1666 /* The number of basetypes for NODE.  */
1667 #define BINFO_N_BASE_BINFOS(NODE) (VEC_length (tree, BINFO_BASE_BINFOS (NODE)))
1668
1669 /* Accessor macro to get to the Nth base binfo of this binfo.  */
1670 #define BINFO_BASE_BINFO(NODE,N) \
1671  (VEC_index (tree, BINFO_BASE_BINFOS (NODE), (N)))
1672 #define BINFO_BASE_ITERATE(NODE,N,B) \
1673  (VEC_iterate (tree, BINFO_BASE_BINFOS (NODE), (N), (B)))
1674 #define BINFO_BASE_APPEND(NODE,T) \
1675  (VEC_quick_push (tree, BINFO_BASE_BINFOS (NODE), (T)))
1676
1677 /* For a BINFO record describing a virtual base class, i.e., one where
1678    TREE_VIA_VIRTUAL is set, this field assists in locating the virtual
1679    base.  The actual contents are language-dependent.  In the C++
1680    front-end this field is an INTEGER_CST giving an offset into the
1681    vtable where the offset to the virtual base can be found.  */
1682 #define BINFO_VPTR_FIELD(NODE) (TREE_BINFO_CHECK(NODE)->binfo.vptr_field)
1683
1684 /* Indicates the accesses this binfo has to its bases. The values are
1685    access_public_node, access_protected_node or access_private_node.
1686    If this array is not present, public access is implied.  */
1687 #define BINFO_BASE_ACCESSES(NODE) (TREE_BINFO_CHECK(NODE)->binfo.base_accesses)
1688
1689 #define BINFO_BASE_ACCESS(NODE,N) \
1690   VEC_index (tree, BINFO_BASE_ACCESSES (NODE), (N))
1691 #define BINFO_BASE_ACCESS_APPEND(NODE,T) \
1692   VEC_quick_push (tree, BINFO_BASE_ACCESSES (NODE), (T))
1693
1694 /* The index in the VTT where this subobject's sub-VTT can be found.
1695    NULL_TREE if there is no sub-VTT.  */
1696 #define BINFO_SUBVTT_INDEX(NODE) (TREE_BINFO_CHECK(NODE)->binfo.vtt_subvtt)
1697
1698 /* The index in the VTT where the vptr for this subobject can be
1699    found.  NULL_TREE if there is no secondary vptr in the VTT.  */
1700 #define BINFO_VPTR_INDEX(NODE) (TREE_BINFO_CHECK(NODE)->binfo.vtt_vptr)
1701
1702 /* The binfo of which NODE is a primary base.  (This is different from
1703    BINFO_INHERITANCE_CHAIN for virtual base because a virtual base is
1704    sometimes a primary base for a class for which it is not an
1705    immediate base.)  */
1706 #define BINFO_PRIMARY_BASE_OF(NODE) (TREE_BINFO_CHECK(NODE)->binfo.primary)
1707
1708 /* The BINFO_INHERITANCE_CHAIN points at the binfo for the base
1709    inheriting this base for non-virtual bases. For virtual bases it
1710    points to the binfo of the most derived type.  */
1711 #define BINFO_INHERITANCE_CHAIN(NODE) \
1712         (TREE_BINFO_CHECK(NODE)->binfo.inheritance)
1713
1714 struct tree_binfo GTY (())
1715 {
1716   struct tree_common common;
1717
1718   tree offset;
1719   tree vtable;
1720   tree virtuals;
1721   tree vptr_field;
1722   VEC(tree) *base_accesses;
1723   tree inheritance;
1724
1725   tree vtt_subvtt;
1726   tree vtt_vptr;
1727   tree primary;
1728
1729   VEC(tree) base_binfos;
1730 };
1731
1732 \f
1733 /* Define fields and accessors for nodes representing declared names.  */
1734
1735 /* Nonzero if DECL represents a decl.  */
1736 #define DECL_P(DECL)    (TREE_CODE_CLASS (TREE_CODE (DECL)) == 'd')
1737
1738 /* Nonzero if DECL represents a variable for the SSA passes.  */
1739 #define SSA_VAR_P(DECL) \
1740         (TREE_CODE (DECL) == VAR_DECL   \
1741          || TREE_CODE (DECL) == PARM_DECL \
1742          || TREE_CODE (DECL) == RESULT_DECL \
1743          || (TREE_CODE (DECL) == SSA_NAME \
1744              && (TREE_CODE (SSA_NAME_VAR (DECL)) == VAR_DECL \
1745                  || TREE_CODE (SSA_NAME_VAR (DECL)) == PARM_DECL \
1746                  || TREE_CODE (SSA_NAME_VAR (DECL)) == RESULT_DECL)))
1747
1748 /* This is the name of the object as written by the user.
1749    It is an IDENTIFIER_NODE.  */
1750 #define DECL_NAME(NODE) (DECL_CHECK (NODE)->decl.name)
1751
1752 /* The name of the object as the assembler will see it (but before any
1753    translations made by ASM_OUTPUT_LABELREF).  Often this is the same
1754    as DECL_NAME.  It is an IDENTIFIER_NODE.  */
1755 #define DECL_ASSEMBLER_NAME(NODE) decl_assembler_name (NODE)
1756
1757 /* Returns nonzero if the DECL_ASSEMBLER_NAME for NODE has been set.  If zero,
1758    the NODE might still have a DECL_ASSEMBLER_NAME -- it just hasn't been set
1759    yet.  */
1760 #define DECL_ASSEMBLER_NAME_SET_P(NODE) \
1761   (DECL_CHECK (NODE)->decl.assembler_name != NULL_TREE)
1762
1763 /* Set the DECL_ASSEMBLER_NAME for NODE to NAME.  */
1764 #define SET_DECL_ASSEMBLER_NAME(NODE, NAME) \
1765   (DECL_CHECK (NODE)->decl.assembler_name = (NAME))
1766
1767 /* Copy the DECL_ASSEMBLER_NAME from DECL1 to DECL2.  Note that if DECL1's
1768    DECL_ASSEMBLER_NAME has not yet been set, using this macro will not cause
1769    the DECL_ASSEMBLER_NAME of either DECL to be set.  In other words, the
1770    semantics of using this macro, are different than saying:
1771
1772      SET_DECL_ASSEMBLER_NAME(DECL2, DECL_ASSEMBLER_NAME (DECL1))
1773
1774    which will try to set the DECL_ASSEMBLER_NAME for DECL1.  */
1775
1776 #define COPY_DECL_ASSEMBLER_NAME(DECL1, DECL2)                          \
1777   (DECL_ASSEMBLER_NAME_SET_P (DECL1)                                    \
1778    ? (void) SET_DECL_ASSEMBLER_NAME (DECL2,                             \
1779                                      DECL_ASSEMBLER_NAME (DECL1))       \
1780    : (void) 0)
1781
1782 /* Records the section name in a section attribute.  Used to pass
1783    the name from decl_attributes to make_function_rtl and make_decl_rtl.  */
1784 #define DECL_SECTION_NAME(NODE) (DECL_CHECK (NODE)->decl.section_name)
1785
1786 /*  For FIELD_DECLs, this is the RECORD_TYPE, UNION_TYPE, or
1787     QUAL_UNION_TYPE node that the field is a member of.  For VAR_DECL,
1788     PARM_DECL, FUNCTION_DECL, LABEL_DECL, and CONST_DECL nodes, this
1789     points to either the FUNCTION_DECL for the containing function,
1790     the RECORD_TYPE or UNION_TYPE for the containing type, or
1791     NULL_TREE or a TRANSLATION_UNIT_DECL if the given decl has "file
1792     scope".  */
1793 #define DECL_CONTEXT(NODE) (DECL_CHECK (NODE)->decl.context)
1794 #define DECL_FIELD_CONTEXT(NODE) (FIELD_DECL_CHECK (NODE)->decl.context)
1795 /* In a DECL this is the field where attributes are stored.  */
1796 #define DECL_ATTRIBUTES(NODE) (DECL_CHECK (NODE)->decl.attributes)
1797 /* In a FIELD_DECL, this is the field position, counting in bytes, of the
1798    byte containing the bit closest to the beginning of the structure.  */
1799 #define DECL_FIELD_OFFSET(NODE) (FIELD_DECL_CHECK (NODE)->decl.arguments)
1800 /* In a FIELD_DECL, this is the offset, in bits, of the first bit of the
1801    field from DECL_FIELD_OFFSET.  */
1802 #define DECL_FIELD_BIT_OFFSET(NODE) (FIELD_DECL_CHECK (NODE)->decl.u2.t)
1803 /* In a FIELD_DECL, this indicates whether the field was a bit-field and
1804    if so, the type that was originally specified for it.
1805    TREE_TYPE may have been modified (in finish_struct).  */
1806 #define DECL_BIT_FIELD_TYPE(NODE) (FIELD_DECL_CHECK (NODE)->decl.result)
1807 /* In FUNCTION_DECL, a chain of ..._DECL nodes.
1808    VAR_DECL and PARM_DECL reserve the arguments slot for language-specific
1809    uses.  */
1810 #define DECL_ARGUMENTS(NODE) (DECL_CHECK (NODE)->decl.arguments)
1811 /* This field is used to reference anything in decl.result and is meant only
1812    for use by the garbage collector.  */
1813 #define DECL_RESULT_FLD(NODE) (DECL_CHECK (NODE)->decl.result)
1814 /* In FUNCTION_DECL, holds the decl for the return value.  */
1815 #define DECL_RESULT(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.result)
1816 /* For a TYPE_DECL, holds the "original" type.  (TREE_TYPE has the copy.) */
1817 #define DECL_ORIGINAL_TYPE(NODE) (TYPE_DECL_CHECK (NODE)->decl.result)
1818 /* In PARM_DECL, holds the type as written (perhaps a function or array).  */
1819 #define DECL_ARG_TYPE_AS_WRITTEN(NODE) (PARM_DECL_CHECK (NODE)->decl.result)
1820 /* For a FUNCTION_DECL, holds the tree of BINDINGs.
1821    For a TRANSLATION_UNIT_DECL, holds the namespace's BLOCK.
1822    For a VAR_DECL, holds the initial value.
1823    For a PARM_DECL, not used--default
1824    values for parameters are encoded in the type of the function,
1825    not in the PARM_DECL slot.
1826
1827    ??? Need to figure out some way to check this isn't a PARM_DECL.  */
1828 #define DECL_INITIAL(NODE) (DECL_CHECK (NODE)->decl.initial)
1829 /* For a PARM_DECL, records the data type used to pass the argument,
1830    which may be different from the type seen in the program.  */
1831 #define DECL_ARG_TYPE(NODE) (PARM_DECL_CHECK (NODE)->decl.initial)
1832 /* For a FIELD_DECL in a QUAL_UNION_TYPE, records the expression, which
1833    if nonzero, indicates that the field occupies the type.  */
1834 #define DECL_QUALIFIER(NODE) (FIELD_DECL_CHECK (NODE)->decl.initial)
1835 /* These two fields describe where in the source code the declaration
1836    was.  If the declaration appears in several places (as for a C
1837    function that is declared first and then defined later), this
1838    information should refer to the definition.  */
1839 #define DECL_SOURCE_LOCATION(NODE) (DECL_CHECK (NODE)->decl.locus)
1840 #define DECL_SOURCE_FILE(NODE) LOCATION_FILE (DECL_SOURCE_LOCATION (NODE))
1841 #define DECL_SOURCE_LINE(NODE) LOCATION_LINE (DECL_SOURCE_LOCATION (NODE))
1842 #ifdef USE_MAPPED_LOCATION
1843 #define DECL_IS_BUILTIN(DECL) \
1844   (DECL_SOURCE_LOCATION (DECL) <= BUILTINS_LOCATION)
1845 #else
1846 #define DECL_IS_BUILTIN(DECL) (DECL_SOURCE_LINE(DECL) == 0)
1847 #endif
1848 /* Holds the size of the datum, in bits, as a tree expression.
1849    Need not be constant.  */
1850 #define DECL_SIZE(NODE) (DECL_CHECK (NODE)->decl.size)
1851 /* Likewise for the size in bytes.  */
1852 #define DECL_SIZE_UNIT(NODE) (DECL_CHECK (NODE)->decl.size_unit)
1853 /* Holds the alignment required for the datum, in bits.  */
1854 #define DECL_ALIGN(NODE) (DECL_CHECK (NODE)->decl.u1.a.align)
1855 /* The alignment of NODE, in bytes.  */
1856 #define DECL_ALIGN_UNIT(NODE) (DECL_ALIGN (NODE) / BITS_PER_UNIT)
1857 /* For FIELD_DECLs, off_align holds the number of low-order bits of
1858    DECL_FIELD_OFFSET which are known to be always zero.
1859    DECL_OFFSET_ALIGN thus returns the alignment that DECL_FIELD_OFFSET
1860    has.  */
1861 #define DECL_OFFSET_ALIGN(NODE) \
1862   (((unsigned HOST_WIDE_INT)1) << FIELD_DECL_CHECK (NODE)->decl.u1.a.off_align)
1863 /* Specify that DECL_ALIGN(NODE) is a multiple of X.  */
1864 #define SET_DECL_OFFSET_ALIGN(NODE, X) \
1865   (FIELD_DECL_CHECK (NODE)->decl.u1.a.off_align = exact_log2 ((X) & -(X)))
1866 /* 1 if the alignment for this type was requested by "aligned" attribute,
1867    0 if it is the default for this type.  */
1868 #define DECL_USER_ALIGN(NODE) (DECL_CHECK (NODE)->decl.user_align)
1869 /* Holds the machine mode corresponding to the declaration of a variable or
1870    field.  Always equal to TYPE_MODE (TREE_TYPE (decl)) except for a
1871    FIELD_DECL.  */
1872 #define DECL_MODE(NODE) (DECL_CHECK (NODE)->decl.mode)
1873 /* Holds the RTL expression for the value of a variable or function.
1874    This value can be evaluated lazily for functions, variables with
1875    static storage duration, and labels.  */
1876 #define DECL_RTL(NODE)                                  \
1877   (DECL_CHECK (NODE)->decl.rtl                          \
1878    ? (NODE)->decl.rtl                                   \
1879    : (make_decl_rtl (NODE), (NODE)->decl.rtl))
1880 /* Set the DECL_RTL for NODE to RTL.  */
1881 #define SET_DECL_RTL(NODE, RTL) set_decl_rtl (NODE, RTL)
1882 /* Returns nonzero if the DECL_RTL for NODE has already been set.  */
1883 #define DECL_RTL_SET_P(NODE)  (DECL_CHECK (NODE)->decl.rtl != NULL)
1884 /* Copy the RTL from NODE1 to NODE2.  If the RTL was not set for
1885    NODE1, it will not be set for NODE2; this is a lazy copy.  */
1886 #define COPY_DECL_RTL(NODE1, NODE2) \
1887   (DECL_CHECK (NODE2)->decl.rtl = DECL_CHECK (NODE1)->decl.rtl)
1888 /* The DECL_RTL for NODE, if it is set, or NULL, if it is not set.  */
1889 #define DECL_RTL_IF_SET(NODE) (DECL_RTL_SET_P (NODE) ? DECL_RTL (NODE) : NULL)
1890
1891 /* For PARM_DECL, holds an RTL for the stack slot or register
1892    where the data was actually passed.  */
1893 #define DECL_INCOMING_RTL(NODE) (PARM_DECL_CHECK (NODE)->decl.u2.r)
1894
1895 /* For FUNCTION_DECL, this holds a pointer to a structure ("struct function")
1896    that describes the status of this function.  */
1897 #define DECL_STRUCT_FUNCTION(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.u2.f)
1898
1899 /* For FUNCTION_DECL, if it is built-in,
1900    this identifies which built-in operation it is.  */
1901 #define DECL_FUNCTION_CODE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.u1.f)
1902
1903 /* The DECL_VINDEX is used for FUNCTION_DECLS in two different ways.
1904    Before the struct containing the FUNCTION_DECL is laid out,
1905    DECL_VINDEX may point to a FUNCTION_DECL in a base class which
1906    is the FUNCTION_DECL which this FUNCTION_DECL will replace as a virtual
1907    function.  When the class is laid out, this pointer is changed
1908    to an INTEGER_CST node which is suitable for use as an index
1909    into the virtual function table.  */
1910 #define DECL_VINDEX(NODE) (DECL_CHECK (NODE)->decl.vindex)
1911
1912 /* For FIELD_DECLS, DECL_FCONTEXT is the *first* baseclass in
1913    which this FIELD_DECL is defined.  This information is needed when
1914    writing debugging information about vfield and vbase decls for C++.  */
1915 #define DECL_FCONTEXT(NODE) (FIELD_DECL_CHECK (NODE)->decl.vindex)
1916
1917 /* Every ..._DECL node gets a unique number.  */
1918 #define DECL_UID(NODE) (DECL_CHECK (NODE)->decl.uid)
1919
1920 /* For any sort of a ..._DECL node, this points to the original (abstract)
1921    decl node which this decl is an instance of, or else it is NULL indicating
1922    that this decl is not an instance of some other decl.  For example,
1923    in a nested declaration of an inline function, this points back to the
1924    definition.  */
1925 #define DECL_ABSTRACT_ORIGIN(NODE) (DECL_CHECK (NODE)->decl.abstract_origin)
1926
1927 /* Like DECL_ABSTRACT_ORIGIN, but returns NODE if there's no abstract
1928    origin.  This is useful when setting the DECL_ABSTRACT_ORIGIN.  */
1929 #define DECL_ORIGIN(NODE) \
1930   (DECL_ABSTRACT_ORIGIN (NODE) ? DECL_ABSTRACT_ORIGIN (NODE) : (NODE))
1931
1932 /* Nonzero for any sort of ..._DECL node means this decl node represents an
1933    inline instance of some original (abstract) decl from an inline function;
1934    suppress any warnings about shadowing some other variable.  FUNCTION_DECL
1935    nodes can also have their abstract origin set to themselves.  */
1936 #define DECL_FROM_INLINE(NODE) (DECL_ABSTRACT_ORIGIN (NODE) != NULL_TREE \
1937                                 && DECL_ABSTRACT_ORIGIN (NODE) != (NODE))
1938
1939 /* Nonzero if a _DECL means that the name of this decl should be ignored
1940    for symbolic debug purposes.  */
1941 #define DECL_IGNORED_P(NODE) (DECL_CHECK (NODE)->decl.ignored_flag)
1942
1943 /* Nonzero for a given ..._DECL node means that this node represents an
1944    "abstract instance" of the given declaration (e.g. in the original
1945    declaration of an inline function).  When generating symbolic debugging
1946    information, we mustn't try to generate any address information for nodes
1947    marked as "abstract instances" because we don't actually generate
1948    any code or allocate any data space for such instances.  */
1949 #define DECL_ABSTRACT(NODE) (DECL_CHECK (NODE)->decl.abstract_flag)
1950
1951 /* Nonzero if a _DECL means that no warnings should be generated just
1952    because this decl is unused.  */
1953 #define DECL_IN_SYSTEM_HEADER(NODE) \
1954   (DECL_CHECK (NODE)->decl.in_system_header_flag)
1955
1956 /* Nonzero for a given ..._DECL node means that this node should be
1957    put in .common, if possible.  If a DECL_INITIAL is given, and it
1958    is not error_mark_node, then the decl cannot be put in .common.  */
1959 #define DECL_COMMON(NODE) (DECL_CHECK (NODE)->decl.common_flag)
1960
1961 /* Language-specific decl information.  */
1962 #define DECL_LANG_SPECIFIC(NODE) (DECL_CHECK (NODE)->decl.lang_specific)
1963
1964 /* In a VAR_DECL or FUNCTION_DECL,
1965    nonzero means external reference:
1966    do not allocate storage, and refer to a definition elsewhere.  */
1967 #define DECL_EXTERNAL(NODE) (DECL_CHECK (NODE)->decl.external_flag)
1968
1969 /* In a VAR_DECL for a RECORD_TYPE, sets number for non-init_priority
1970    initializations.  */
1971 #define DEFAULT_INIT_PRIORITY 65535
1972 #define MAX_INIT_PRIORITY 65535
1973 #define MAX_RESERVED_INIT_PRIORITY 100
1974
1975 /* In a TYPE_DECL
1976    nonzero means the detail info about this type is not dumped into stabs.
1977    Instead it will generate cross reference ('x') of names.
1978    This uses the same flag as DECL_EXTERNAL.  */
1979 #define TYPE_DECL_SUPPRESS_DEBUG(NODE) \
1980   (TYPE_DECL_CHECK (NODE)->decl.external_flag)
1981
1982 /* In VAR_DECL and PARM_DECL nodes, nonzero means declared `register'.  */
1983 #define DECL_REGISTER(NODE) (DECL_CHECK (NODE)->decl.regdecl_flag)
1984
1985 /* In LABEL_DECL nodes, nonzero means that an error message about
1986    jumping into such a binding contour has been printed for this label.  */
1987 #define DECL_ERROR_ISSUED(NODE) (LABEL_DECL_CHECK (NODE)->decl.regdecl_flag)
1988
1989 /* In a FIELD_DECL, indicates this field should be bit-packed.  */
1990 #define DECL_PACKED(NODE) (FIELD_DECL_CHECK (NODE)->decl.regdecl_flag)
1991
1992 /* In a FUNCTION_DECL with a nonzero DECL_CONTEXT, indicates that a
1993    static chain is not needed.  */
1994 #define DECL_NO_STATIC_CHAIN(NODE) \
1995   (FUNCTION_DECL_CHECK (NODE)->decl.regdecl_flag)
1996
1997 /* Nonzero in a ..._DECL means this variable is ref'd from a nested function.
1998    For VAR_DECL nodes, PARM_DECL nodes, and FUNCTION_DECL nodes.
1999
2000    For LABEL_DECL nodes, nonzero if nonlocal gotos to the label are permitted.
2001
2002    Also set in some languages for variables, etc., outside the normal
2003    lexical scope, such as class instance variables.  */
2004 #define DECL_NONLOCAL(NODE) (DECL_CHECK (NODE)->decl.nonlocal_flag)
2005
2006 /* Nonzero in a FUNCTION_DECL means this function can be substituted
2007    where it is called.  */
2008 #define DECL_INLINE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.inline_flag)
2009
2010 /* Nonzero in a FUNCTION_DECL means that this function was declared inline,
2011    such as via the `inline' keyword in C/C++.  This flag controls the linkage
2012    semantics of 'inline'; whether or not the function is inlined is
2013    controlled by DECL_INLINE.  */
2014 #define DECL_DECLARED_INLINE_P(NODE) \
2015   (FUNCTION_DECL_CHECK (NODE)->decl.declared_inline_flag)
2016
2017 /* Nonzero in a decl means that the gimplifier has seen (or placed)
2018    this variable in a BIND_EXPR.  */
2019 #define DECL_SEEN_IN_BIND_EXPR_P(NODE) \
2020   (DECL_CHECK (NODE)->decl.seen_in_bind_expr)
2021
2022 /* In a VAR_DECL, nonzero if the decl is a register variable with
2023    an explicit asm specification.  */
2024 #define DECL_HARD_REGISTER(NODE)  (DECL_CHECK (NODE)->decl.inline_flag)
2025
2026 /* Value of the decls's visibility attribute */
2027 #define DECL_VISIBILITY(NODE) (DECL_CHECK (NODE)->decl.visibility)
2028
2029 /* Nonzero means that the decl had its visibility specified rather than
2030    being inferred.  */
2031 #define DECL_VISIBILITY_SPECIFIED(NODE) (DECL_CHECK (NODE)->decl.visibility_specified)
2032
2033 /* In a FUNCTION_DECL, nonzero if the function cannot be inlined.  */
2034 #define DECL_UNINLINABLE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.uninlinable)
2035
2036 /* In a VAR_DECL, nonzero if the data should be allocated from
2037    thread-local storage.  */
2038 #define DECL_THREAD_LOCAL(NODE) (VAR_DECL_CHECK (NODE)->decl.thread_local_flag)
2039
2040 /* In a FUNCTION_DECL, the saved representation of the body of the
2041    entire function.  */
2042 #define DECL_SAVED_TREE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.saved_tree)
2043
2044 /* In a VAR_DECL or PARM_DECL, the location at which the value may be found,
2045    if transformations have made this more complicated than evaluating the
2046    decl itself.  This should only be used for debugging; once this field has
2047    been set, the decl itself may not legitimately appear in the function.  */
2048 #define DECL_VALUE_EXPR(NODE) \
2049   (TREE_CHECK2 (NODE, VAR_DECL, PARM_DECL)->decl.saved_tree)
2050
2051 /* List of FUNCTION_DECLs inlined into this function's body.  */
2052 #define DECL_INLINED_FNS(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.inlined_fns)
2053
2054 /* Nonzero in a FUNCTION_DECL means this function should be treated
2055    as if it were a malloc, meaning it returns a pointer that is
2056    not an alias.  */
2057 #define DECL_IS_MALLOC(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.malloc_flag)
2058
2059 /* Nonzero in a FUNCTION_DECL means this function should be treated
2060    as "pure" function (like const function, but may read global memory).  */
2061 #define DECL_IS_PURE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.pure_flag)
2062
2063 /* Nonzero in a FIELD_DECL means it is a bit field, and must be accessed
2064    specially.  */
2065 #define DECL_BIT_FIELD(NODE) (FIELD_DECL_CHECK (NODE)->decl.bit_field_flag)
2066
2067 /* Unused in FUNCTION_DECL.  */
2068
2069 /* In a VAR_DECL that's static,
2070    nonzero if the space is in the text section.  */
2071 #define DECL_IN_TEXT_SECTION(NODE) (VAR_DECL_CHECK (NODE)->decl.bit_field_flag)
2072
2073 /* In a FUNCTION_DECL, nonzero means a built in function.  */
2074 #define DECL_BUILT_IN(NODE) (DECL_BUILT_IN_CLASS (NODE) != NOT_BUILT_IN)
2075
2076 /* For a builtin function, identify which part of the compiler defined it.  */
2077 #define DECL_BUILT_IN_CLASS(NODE) \
2078    (FUNCTION_DECL_CHECK (NODE)->decl.built_in_class)
2079
2080 /* Used in VAR_DECLs to indicate that the variable is a vtable.
2081    Used in FIELD_DECLs for vtable pointers.
2082    Used in FUNCTION_DECLs to indicate that the function is virtual.  */
2083 #define DECL_VIRTUAL_P(NODE) (DECL_CHECK (NODE)->decl.virtual_flag)
2084
2085 /* Used to indicate that the linkage status of this DECL is not yet known,
2086    so it should not be output now.  */
2087 #define DECL_DEFER_OUTPUT(NODE) (DECL_CHECK (NODE)->decl.defer_output)
2088
2089 /* Used in PARM_DECLs whose type are unions to indicate that the
2090    argument should be passed in the same way that the first union
2091    alternative would be passed.  */
2092 #define DECL_TRANSPARENT_UNION(NODE) \
2093   (PARM_DECL_CHECK (NODE)->decl.transparent_union)
2094
2095 /* Used in FUNCTION_DECLs to indicate that they should be run automatically
2096    at the beginning or end of execution.  */
2097 #define DECL_STATIC_CONSTRUCTOR(NODE) \
2098   (FUNCTION_DECL_CHECK (NODE)->decl.static_ctor_flag)
2099
2100 #define DECL_STATIC_DESTRUCTOR(NODE) \
2101 (FUNCTION_DECL_CHECK (NODE)->decl.static_dtor_flag)
2102
2103 /* Used to indicate that this DECL represents a compiler-generated entity.  */
2104 #define DECL_ARTIFICIAL(NODE) (DECL_CHECK (NODE)->decl.artificial_flag)
2105
2106 /* Used to indicate that this DECL has weak linkage.  */
2107 #define DECL_WEAK(NODE) (DECL_CHECK (NODE)->decl.weak_flag)
2108
2109 /* Used in TREE_PUBLIC decls to indicate that copies of this DECL in
2110    multiple translation units should be merged.  */
2111 #define DECL_ONE_ONLY(NODE) (DECL_CHECK (NODE)->decl.transparent_union)
2112
2113 /* Used in a DECL to indicate that, even if it TREE_PUBLIC, it need
2114    not be put out unless it is needed in this translation unit.
2115    Entities like this are shared across translation units (like weak
2116    entities), but are guaranteed to be generated by any translation
2117    unit that needs them, and therefore need not be put out anywhere
2118    where they are not needed.  DECL_COMDAT is just a hint to the
2119    back-end; it is up to front-ends which set this flag to ensure
2120    that there will never be any harm, other than bloat, in putting out
2121    something which is DECL_COMDAT.  */
2122 #define DECL_COMDAT(NODE) (DECL_CHECK (NODE)->decl.comdat_flag)
2123
2124 /* Used in FUNCTION_DECLs to indicate that function entry and exit should
2125    be instrumented with calls to support routines.  */
2126 #define DECL_NO_INSTRUMENT_FUNCTION_ENTRY_EXIT(NODE) \
2127   (FUNCTION_DECL_CHECK (NODE)->decl.no_instrument_function_entry_exit)
2128
2129 /* Used in FUNCTION_DECLs to indicate that limit-stack-* should be
2130    disabled in this function.  */
2131 #define DECL_NO_LIMIT_STACK(NODE) \
2132   (FUNCTION_DECL_CHECK (NODE)->decl.no_limit_stack)
2133
2134 /* Additional flags for language-specific uses.  */
2135 #define DECL_LANG_FLAG_0(NODE) (DECL_CHECK (NODE)->decl.lang_flag_0)
2136 #define DECL_LANG_FLAG_1(NODE) (DECL_CHECK (NODE)->decl.lang_flag_1)
2137 #define DECL_LANG_FLAG_2(NODE) (DECL_CHECK (NODE)->decl.lang_flag_2)
2138 #define DECL_LANG_FLAG_3(NODE) (DECL_CHECK (NODE)->decl.lang_flag_3)
2139 #define DECL_LANG_FLAG_4(NODE) (DECL_CHECK (NODE)->decl.lang_flag_4)
2140 #define DECL_LANG_FLAG_5(NODE) (DECL_CHECK (NODE)->decl.lang_flag_5)
2141 #define DECL_LANG_FLAG_6(NODE) (DECL_CHECK (NODE)->decl.lang_flag_6)
2142 #define DECL_LANG_FLAG_7(NODE) (DECL_CHECK (NODE)->decl.lang_flag_7)
2143
2144 /* Used to indicate that the pointer to this DECL cannot be treated as
2145    an address constant.  */
2146 #define DECL_NON_ADDR_CONST_P(NODE) (DECL_CHECK (NODE)->decl.non_addr_const_p)
2147
2148 /* Used in a FIELD_DECL to indicate that we cannot form the address of
2149    this component.  */
2150 #define DECL_NONADDRESSABLE_P(NODE) \
2151   (FIELD_DECL_CHECK (NODE)->decl.non_addressable)
2152
2153 /* Used to indicate an alias set for the memory pointed to by this
2154    particular FIELD_DECL, PARM_DECL, or VAR_DECL, which must have
2155    pointer (or reference) type.  */
2156 #define DECL_POINTER_ALIAS_SET(NODE) \
2157   (DECL_CHECK (NODE)->decl.pointer_alias_set)
2158
2159 /* Used to store the alias_var for a DECL node.  */
2160 #define DECL_PTA_ALIASVAR(NODE) \
2161   (DECL_CHECK (NODE)->decl.alias_var)
2162
2163 /* A numeric unique identifier for a LABEL_DECL.  The UID allocation is
2164    dense, unique within any one function, and may be used to index arrays.
2165    If the value is -1, then no UID has been assigned.  */
2166 #define LABEL_DECL_UID(NODE) \
2167   (LABEL_DECL_CHECK (NODE)->decl.pointer_alias_set)
2168
2169 /* Nonzero if an alias set has been assigned to this declaration.  */
2170 #define DECL_POINTER_ALIAS_SET_KNOWN_P(NODE) \
2171   (DECL_POINTER_ALIAS_SET (NODE) != - 1)
2172
2173 /* Nonzero for a decl which is at file scope.  */
2174 #define DECL_FILE_SCOPE_P(EXP)                                  \
2175   (! DECL_CONTEXT (EXP)                                         \
2176    || TREE_CODE (DECL_CONTEXT (EXP)) == TRANSLATION_UNIT_DECL)
2177
2178 /* Nonzero for a decl that cgraph has decided should be inlined into
2179    at least one call site.  It is not meaningful to look at this
2180    directly; always use cgraph_function_possibly_inlined_p.  */
2181 #define DECL_POSSIBLY_INLINED(DECL) \
2182   FUNCTION_DECL_CHECK (DECL)->decl.possibly_inlined
2183
2184 /* Nonzero for a decl that is decorated using attribute used.
2185    This indicates compiler tools that this decl needs to be preserved.  */
2186 #define DECL_PRESERVE_P(DECL) \
2187   DECL_CHECK (DECL)->decl.preserve_flag
2188
2189 /* Internal to the gimplifier.  Indicates that the value is a formal
2190    temporary controlled by the gimplifier.  */
2191 #define DECL_GIMPLE_FORMAL_TEMP_P(DECL) \
2192   DECL_CHECK (DECL)->decl.gimple_formal_temp
2193
2194 /* Enumerate visibility settings.  */
2195 #ifndef SYMBOL_VISIBILITY_DEFINED
2196 #define SYMBOL_VISIBILITY_DEFINED
2197 enum symbol_visibility
2198 {
2199   VISIBILITY_DEFAULT,
2200   VISIBILITY_INTERNAL,
2201   VISIBILITY_HIDDEN,
2202   VISIBILITY_PROTECTED
2203 };
2204 #endif
2205
2206 struct function;
2207 union alias_var_def;
2208 struct tree_decl GTY(())
2209 {
2210   struct tree_common common;
2211   location_t locus;
2212   unsigned int uid;
2213   tree size;
2214   ENUM_BITFIELD(machine_mode) mode : 8;
2215
2216   unsigned external_flag : 1;
2217   unsigned nonlocal_flag : 1;
2218   unsigned regdecl_flag : 1;
2219   unsigned inline_flag : 1;
2220   unsigned bit_field_flag : 1;
2221   unsigned virtual_flag : 1;
2222   unsigned ignored_flag : 1;
2223   unsigned abstract_flag : 1;
2224
2225   unsigned in_system_header_flag : 1;
2226   unsigned common_flag : 1;
2227   unsigned defer_output : 1;
2228   unsigned transparent_union : 1;
2229   unsigned static_ctor_flag : 1;
2230   unsigned static_dtor_flag : 1;
2231   unsigned artificial_flag : 1;
2232   unsigned weak_flag : 1;
2233
2234   unsigned non_addr_const_p : 1;
2235   unsigned no_instrument_function_entry_exit : 1;
2236   unsigned comdat_flag : 1;
2237   unsigned malloc_flag : 1;
2238   unsigned no_limit_stack : 1;
2239   ENUM_BITFIELD(built_in_class) built_in_class : 2;
2240   unsigned pure_flag : 1;
2241
2242   unsigned non_addressable : 1;
2243   unsigned user_align : 1;
2244   unsigned uninlinable : 1;
2245   unsigned thread_local_flag : 1;
2246   unsigned declared_inline_flag : 1;
2247   unsigned seen_in_bind_expr : 1;
2248   ENUM_BITFIELD(symbol_visibility) visibility : 2;
2249   unsigned visibility_specified : 1;
2250
2251   unsigned lang_flag_0 : 1;
2252   unsigned lang_flag_1 : 1;
2253   unsigned lang_flag_2 : 1;
2254   unsigned lang_flag_3 : 1;
2255   unsigned lang_flag_4 : 1;
2256   unsigned lang_flag_5 : 1;
2257   unsigned lang_flag_6 : 1;
2258   unsigned lang_flag_7 : 1;
2259
2260   unsigned possibly_inlined : 1;
2261   unsigned preserve_flag: 1;
2262   unsigned gimple_formal_temp : 1;
2263   /* 13 unused bits.  */
2264
2265   union tree_decl_u1 {
2266     /* In a FUNCTION_DECL for which DECL_BUILT_IN holds, this is
2267        DECL_FUNCTION_CODE.  */
2268     enum built_in_function f;
2269     /* In a FUNCTION_DECL for which DECL_BUILT_IN does not hold, this
2270        is used by language-dependent code.  */
2271     HOST_WIDE_INT i;
2272     /* DECL_ALIGN and DECL_OFFSET_ALIGN.  (These are not used for
2273        FUNCTION_DECLs).  */
2274     struct tree_decl_u1_a {
2275       unsigned int align : 24;
2276       unsigned int off_align : 8;
2277     } a;
2278   } GTY ((skip)) u1;
2279
2280   tree size_unit;
2281   tree name;
2282   tree context;
2283   tree arguments;       /* Also used for DECL_FIELD_OFFSET */
2284   tree result;  /* Also used for DECL_BIT_FIELD_TYPE */
2285   tree initial; /* Also used for DECL_QUALIFIER */
2286   tree abstract_origin;
2287   tree assembler_name;
2288   tree section_name;
2289   tree attributes;
2290   rtx rtl;      /* RTL representation for object.  */
2291
2292   /* In FUNCTION_DECL, if it is inline, holds the saved insn chain.
2293      In FIELD_DECL, is DECL_FIELD_BIT_OFFSET.
2294      In PARM_DECL, holds an RTL for the stack slot
2295      of register where the data was actually passed.
2296      Used by Chill and Java in LABEL_DECL and by C++ and Java in VAR_DECL.  */
2297   union tree_decl_u2 {
2298     struct function * GTY ((tag ("FUNCTION_DECL"))) f;
2299     rtx GTY ((tag ("PARM_DECL"))) r;
2300     tree GTY ((tag ("FIELD_DECL"))) t;
2301     int GTY ((tag ("VAR_DECL"))) i;
2302   } GTY ((desc ("TREE_CODE((tree) &(%0))"))) u2;
2303
2304   /* In a FUNCTION_DECL, this is DECL_SAVED_TREE.
2305      In a VAR_DECL or PARM_DECL, this is DECL_VALUE_EXPR.  */
2306   tree saved_tree;
2307
2308   /* In a FUNCTION_DECL, these are function data which is to be kept
2309      as long as FUNCTION_DECL is kept.  */
2310   tree inlined_fns;
2311
2312   tree vindex;
2313   HOST_WIDE_INT pointer_alias_set;
2314   union alias_var_def *GTY ((skip(""))) alias_var;
2315   /* Points to a structure whose details depend on the language in use.  */
2316   struct lang_decl *lang_specific;
2317 };
2318
2319 \f
2320 /* A STATEMENT_LIST chains statements together in GENERIC and GIMPLE.
2321    To reduce overhead, the nodes containing the statements are not trees.
2322    This avoids the overhead of tree_common on all linked list elements.
2323
2324    Use the interface in tree-iterator.h to access this node.  */
2325
2326 #define STATEMENT_LIST_HEAD(NODE) \
2327   (STATEMENT_LIST_CHECK (NODE)->stmt_list.head)
2328 #define STATEMENT_LIST_TAIL(NODE) \
2329   (STATEMENT_LIST_CHECK (NODE)->stmt_list.tail)
2330
2331 struct tree_statement_list_node
2332   GTY ((chain_next ("%h.next"), chain_prev ("%h.prev")))
2333 {
2334   struct tree_statement_list_node *prev;
2335   struct tree_statement_list_node *next;
2336   tree stmt;
2337 };
2338
2339 struct tree_statement_list
2340   GTY(())
2341 {
2342   struct tree_common common;
2343   struct tree_statement_list_node *head;
2344   struct tree_statement_list_node *tail;
2345 };
2346
2347 #define VALUE_HANDLE_ID(NODE)           \
2348   (VALUE_HANDLE_CHECK (NODE)->value_handle.id)
2349
2350 #define VALUE_HANDLE_EXPR_SET(NODE)     \
2351   (VALUE_HANDLE_CHECK (NODE)->value_handle.expr_set)
2352
2353 /* Defined and used in tree-ssa-pre.c.  */
2354 struct value_set;
2355
2356 struct tree_value_handle GTY(())
2357 {
2358   struct tree_common common;
2359
2360   /* The set of expressions represented by this handle.  */
2361   struct value_set * GTY ((skip)) expr_set;
2362
2363   /* Unique ID for this value handle.  IDs are handed out in a
2364      conveniently dense form starting at 0, so that we can make
2365      bitmaps of value handles. */
2366   unsigned int id;
2367 };
2368 \f
2369 enum tree_node_structure_enum {
2370   TS_COMMON,
2371   TS_INT_CST,
2372   TS_REAL_CST,
2373   TS_VECTOR,
2374   TS_STRING,
2375   TS_COMPLEX,
2376   TS_IDENTIFIER,
2377   TS_DECL,
2378   TS_TYPE,
2379   TS_LIST,
2380   TS_VEC,
2381   TS_EXP,
2382   TS_SSA_NAME,
2383   TS_PHI_NODE,
2384   TS_BLOCK,
2385   TS_BINFO,
2386   TS_STATEMENT_LIST,
2387   TS_VALUE_HANDLE,
2388   LAST_TS_ENUM
2389 };
2390
2391 /* Define the overall contents of a tree node.
2392    It may be any of the structures declared above
2393    for various types of node.  */
2394
2395 union tree_node GTY ((ptr_alias (union lang_tree_node),
2396                       desc ("tree_node_structure (&%h)")))
2397 {
2398   struct tree_common GTY ((tag ("TS_COMMON"))) common;
2399   struct tree_int_cst GTY ((tag ("TS_INT_CST"))) int_cst;
2400   struct tree_real_cst GTY ((tag ("TS_REAL_CST"))) real_cst;
2401   struct tree_vector GTY ((tag ("TS_VECTOR"))) vector;
2402   struct tree_string GTY ((tag ("TS_STRING"))) string;
2403   struct tree_complex GTY ((tag ("TS_COMPLEX"))) complex;
2404   struct tree_identifier GTY ((tag ("TS_IDENTIFIER"))) identifier;
2405   struct tree_decl GTY ((tag ("TS_DECL"))) decl;
2406   struct tree_type GTY ((tag ("TS_TYPE"))) type;
2407   struct tree_list GTY ((tag ("TS_LIST"))) list;
2408   struct tree_vec GTY ((tag ("TS_VEC"))) vec;
2409   struct tree_exp GTY ((tag ("TS_EXP"))) exp;
2410   struct tree_ssa_name GTY ((tag ("TS_SSA_NAME"))) ssa_name;
2411   struct tree_phi_node GTY ((tag ("TS_PHI_NODE"))) phi;
2412   struct tree_block GTY ((tag ("TS_BLOCK"))) block;
2413   struct tree_binfo GTY ((tag ("TS_BINFO"))) binfo;
2414   struct tree_statement_list GTY ((tag ("TS_STATEMENT_LIST"))) stmt_list;
2415   struct tree_value_handle GTY ((tag ("TS_VALUE_HANDLE"))) value_handle;
2416 };
2417 \f
2418 /* Standard named or nameless data types of the C compiler.  */
2419
2420 enum tree_index
2421 {
2422   TI_ERROR_MARK,
2423   TI_INTQI_TYPE,
2424   TI_INTHI_TYPE,
2425   TI_INTSI_TYPE,
2426   TI_INTDI_TYPE,
2427   TI_INTTI_TYPE,
2428
2429   TI_UINTQI_TYPE,
2430   TI_UINTHI_TYPE,
2431   TI_UINTSI_TYPE,
2432   TI_UINTDI_TYPE,
2433   TI_UINTTI_TYPE,
2434
2435   TI_INTEGER_ZERO,
2436   TI_INTEGER_ONE,
2437   TI_INTEGER_MINUS_ONE,
2438   TI_NULL_POINTER,
2439
2440   TI_SIZE_ZERO,
2441   TI_SIZE_ONE,
2442
2443   TI_BITSIZE_ZERO,
2444   TI_BITSIZE_ONE,
2445   TI_BITSIZE_UNIT,
2446
2447   TI_PUBLIC,
2448   TI_PROTECTED,
2449   TI_PRIVATE,
2450
2451   TI_BOOLEAN_FALSE,
2452   TI_BOOLEAN_TRUE,
2453
2454   TI_COMPLEX_INTEGER_TYPE,
2455   TI_COMPLEX_FLOAT_TYPE,
2456   TI_COMPLEX_DOUBLE_TYPE,
2457   TI_COMPLEX_LONG_DOUBLE_TYPE,
2458
2459   TI_FLOAT_TYPE,
2460   TI_DOUBLE_TYPE,
2461   TI_LONG_DOUBLE_TYPE,
2462
2463   TI_FLOAT_PTR_TYPE,
2464   TI_DOUBLE_PTR_TYPE,
2465   TI_LONG_DOUBLE_PTR_TYPE,
2466   TI_INTEGER_PTR_TYPE,
2467
2468   TI_VOID_TYPE,
2469   TI_PTR_TYPE,
2470   TI_CONST_PTR_TYPE,
2471   TI_SIZE_TYPE,
2472   TI_PID_TYPE,
2473   TI_PTRDIFF_TYPE,
2474   TI_VA_LIST_TYPE,
2475   TI_BOOLEAN_TYPE,
2476   TI_FILEPTR_TYPE,
2477
2478   TI_VOID_LIST_NODE,
2479
2480   TI_MAIN_IDENTIFIER,
2481
2482   TI_MAX
2483 };
2484
2485 extern GTY(()) tree global_trees[TI_MAX];
2486
2487 #define error_mark_node                 global_trees[TI_ERROR_MARK]
2488
2489 #define intQI_type_node                 global_trees[TI_INTQI_TYPE]
2490 #define intHI_type_node                 global_trees[TI_INTHI_TYPE]
2491 #define intSI_type_node                 global_trees[TI_INTSI_TYPE]
2492 #define intDI_type_node                 global_trees[TI_INTDI_TYPE]
2493 #define intTI_type_node                 global_trees[TI_INTTI_TYPE]
2494
2495 #define unsigned_intQI_type_node        global_trees[TI_UINTQI_TYPE]
2496 #define unsigned_intHI_type_node        global_trees[TI_UINTHI_TYPE]
2497 #define unsigned_intSI_type_node        global_trees[TI_UINTSI_TYPE]
2498 #define unsigned_intDI_type_node        global_trees[TI_UINTDI_TYPE]
2499 #define unsigned_intTI_type_node        global_trees[TI_UINTTI_TYPE]
2500
2501 #define integer_zero_node               global_trees[TI_INTEGER_ZERO]
2502 #define integer_one_node                global_trees[TI_INTEGER_ONE]
2503 #define integer_minus_one_node          global_trees[TI_INTEGER_MINUS_ONE]
2504 #define size_zero_node                  global_trees[TI_SIZE_ZERO]
2505 #define size_one_node                   global_trees[TI_SIZE_ONE]
2506 #define bitsize_zero_node               global_trees[TI_BITSIZE_ZERO]
2507 #define bitsize_one_node                global_trees[TI_BITSIZE_ONE]
2508 #define bitsize_unit_node               global_trees[TI_BITSIZE_UNIT]
2509
2510 /* Base access nodes.  */
2511 #define access_public_node              global_trees[TI_PUBLIC]
2512 #define access_protected_node           global_trees[TI_PROTECTED]
2513 #define access_private_node             global_trees[TI_PRIVATE]
2514
2515 #define null_pointer_node               global_trees[TI_NULL_POINTER]
2516
2517 #define float_type_node                 global_trees[TI_FLOAT_TYPE]
2518 #define double_type_node                global_trees[TI_DOUBLE_TYPE]
2519 #define long_double_type_node           global_trees[TI_LONG_DOUBLE_TYPE]
2520
2521 #define float_ptr_type_node             global_trees[TI_FLOAT_PTR_TYPE]
2522 #define double_ptr_type_node            global_trees[TI_DOUBLE_PTR_TYPE]
2523 #define long_double_ptr_type_node       global_trees[TI_LONG_DOUBLE_PTR_TYPE]
2524 #define integer_ptr_type_node           global_trees[TI_INTEGER_PTR_TYPE]
2525
2526 #define complex_integer_type_node       global_trees[TI_COMPLEX_INTEGER_TYPE]
2527 #define complex_float_type_node         global_trees[TI_COMPLEX_FLOAT_TYPE]
2528 #define complex_double_type_node        global_trees[TI_COMPLEX_DOUBLE_TYPE]
2529 #define complex_long_double_type_node   global_trees[TI_COMPLEX_LONG_DOUBLE_TYPE]
2530
2531 #define void_type_node                  global_trees[TI_VOID_TYPE]
2532 /* The C type `void *'.  */
2533 #define ptr_type_node                   global_trees[TI_PTR_TYPE]
2534 /* The C type `const void *'.  */
2535 #define const_ptr_type_node             global_trees[TI_CONST_PTR_TYPE]
2536 /* The C type `size_t'.  */
2537 #define size_type_node                  global_trees[TI_SIZE_TYPE]
2538 #define pid_type_node                   global_trees[TI_PID_TYPE]
2539 #define ptrdiff_type_node               global_trees[TI_PTRDIFF_TYPE]
2540 #define va_list_type_node               global_trees[TI_VA_LIST_TYPE]
2541 /* The C type `FILE *'.  */
2542 #define fileptr_type_node               global_trees[TI_FILEPTR_TYPE]
2543
2544 #define boolean_type_node               global_trees[TI_BOOLEAN_TYPE]
2545 #define boolean_false_node              global_trees[TI_BOOLEAN_FALSE]
2546 #define boolean_true_node               global_trees[TI_BOOLEAN_TRUE]
2547
2548 /* The node that should be placed at the end of a parameter list to
2549    indicate that the function does not take a variable number of
2550    arguments.  The TREE_VALUE will be void_type_node and there will be
2551    no TREE_CHAIN.  Language-independent code should not assume
2552    anything else about this node.  */
2553 #define void_list_node                  global_trees[TI_VOID_LIST_NODE]
2554
2555 #define main_identifier_node            global_trees[TI_MAIN_IDENTIFIER]
2556 #define MAIN_NAME_P(NODE) (IDENTIFIER_NODE_CHECK (NODE) == main_identifier_node)
2557
2558 /* An enumeration of the standard C integer types.  These must be
2559    ordered so that shorter types appear before longer ones, and so
2560    that signed types appear before unsigned ones, for the correct
2561    functioning of interpret_integer() in c-lex.c.  */
2562 enum integer_type_kind
2563 {
2564   itk_char,
2565   itk_signed_char,
2566   itk_unsigned_char,
2567   itk_short,
2568   itk_unsigned_short,
2569   itk_int,
2570   itk_unsigned_int,
2571   itk_long,
2572   itk_unsigned_long,
2573   itk_long_long,
2574   itk_unsigned_long_long,
2575   itk_none
2576 };
2577
2578 typedef enum integer_type_kind integer_type_kind;
2579
2580 /* The standard C integer types.  Use integer_type_kind to index into
2581    this array.  */
2582 extern GTY(()) tree integer_types[itk_none];
2583
2584 #define char_type_node                  integer_types[itk_char]
2585 #define signed_char_type_node           integer_types[itk_signed_char]
2586 #define unsigned_char_type_node         integer_types[itk_unsigned_char]
2587 #define short_integer_type_node         integer_types[itk_short]
2588 #define short_unsigned_type_node        integer_types[itk_unsigned_short]
2589 #define integer_type_node               integer_types[itk_int]
2590 #define unsigned_type_node              integer_types[itk_unsigned_int]
2591 #define long_integer_type_node          integer_types[itk_long]
2592 #define long_unsigned_type_node         integer_types[itk_unsigned_long]
2593 #define long_long_integer_type_node     integer_types[itk_long_long]
2594 #define long_long_unsigned_type_node    integer_types[itk_unsigned_long_long]
2595 \f
2596 /* Set to the default thread-local storage (tls) model to use.  */
2597
2598 extern enum tls_model flag_tls_default;
2599
2600 \f
2601 /* A pointer-to-function member type looks like:
2602
2603      struct {
2604        __P __pfn;
2605        ptrdiff_t __delta;
2606      };
2607
2608    If __pfn is NULL, it is a NULL pointer-to-member-function.
2609
2610    (Because the vtable is always the first thing in the object, we
2611    don't need its offset.)  If the function is virtual, then PFN is
2612    one plus twice the index into the vtable; otherwise, it is just a
2613    pointer to the function.
2614
2615    Unfortunately, using the lowest bit of PFN doesn't work in
2616    architectures that don't impose alignment requirements on function
2617    addresses, or that use the lowest bit to tell one ISA from another,
2618    for example.  For such architectures, we use the lowest bit of
2619    DELTA instead of the lowest bit of the PFN, and DELTA will be
2620    multiplied by 2.  */
2621
2622 enum ptrmemfunc_vbit_where_t
2623 {
2624   ptrmemfunc_vbit_in_pfn,
2625   ptrmemfunc_vbit_in_delta
2626 };
2627 \f
2628 #define NULL_TREE (tree) NULL
2629
2630 extern GTY(()) tree frame_base_decl;
2631 extern tree decl_assembler_name (tree);
2632
2633 /* Compute the number of bytes occupied by 'node'.  This routine only
2634    looks at TREE_CODE and, if the code is TREE_VEC, TREE_VEC_LENGTH.  */
2635
2636 extern size_t tree_size (tree);
2637
2638 /* Lowest level primitive for allocating a node.
2639    The TREE_CODE is the only argument.  Contents are initialized
2640    to zero except for a few of the common fields.  */
2641
2642 extern tree make_node_stat (enum tree_code MEM_STAT_DECL);
2643 #define make_node(t) make_node_stat (t MEM_STAT_INFO)
2644
2645 /* Make a copy of a node, with all the same contents.  */
2646
2647 extern tree copy_node_stat (tree MEM_STAT_DECL);
2648 #define copy_node(t) copy_node_stat (t MEM_STAT_INFO)
2649
2650 /* Make a copy of a chain of TREE_LIST nodes.  */
2651
2652 extern tree copy_list (tree);
2653
2654 /* Make a BINFO.  */
2655 extern tree make_tree_binfo_stat (unsigned MEM_STAT_DECL);
2656 #define make_tree_binfo(t) make_tree_binfo_stat (t MEM_STAT_INFO)
2657
2658 /* Make a TREE_VEC.  */
2659
2660 extern tree make_tree_vec_stat (int MEM_STAT_DECL);
2661 #define make_tree_vec(t) make_tree_vec_stat (t MEM_STAT_INFO)
2662
2663 /* Tree nodes for SSA analysis.  */
2664
2665 extern tree make_phi_node (tree, int);
2666 extern void init_phinodes (void);
2667 extern void fini_phinodes (void);
2668 extern void release_phi_node (tree);
2669 #ifdef GATHER_STATISTICS
2670 extern void phinodes_print_statistics (void);
2671 #endif
2672
2673 extern void init_ssanames (void);
2674 extern void fini_ssanames (void);
2675 extern tree make_ssa_name (tree, tree);
2676 extern tree duplicate_ssa_name (tree, tree);
2677 extern void release_ssa_name (tree);
2678 extern void release_defs (tree);
2679 extern void replace_ssa_name_symbol (tree, tree);
2680
2681 #ifdef GATHER_STATISTICS
2682 extern void ssanames_print_statistics (void);
2683 #endif
2684
2685 extern void mark_for_rewrite (tree);
2686 extern void unmark_all_for_rewrite (void);
2687 extern bool marked_for_rewrite_p (tree);
2688 extern bool any_marked_for_rewrite_p (void);
2689 extern struct bitmap_head_def *marked_ssa_names (void);
2690
2691
2692 /* Return the (unique) IDENTIFIER_NODE node for a given name.
2693    The name is supplied as a char *.  */
2694
2695 extern tree get_identifier (const char *);
2696
2697 #if GCC_VERSION >= 3000
2698 #define get_identifier(str) \
2699   (__builtin_constant_p (str)                           \
2700     ? get_identifier_with_length ((str), strlen (str))  \
2701     : get_identifier (str))
2702 #endif
2703
2704
2705 /* Identical to get_identifier, except that the length is assumed
2706    known.  */
2707
2708 extern tree get_identifier_with_length (const char *, size_t);
2709
2710 /* If an identifier with the name TEXT (a null-terminated string) has
2711    previously been referred to, return that node; otherwise return
2712    NULL_TREE.  */
2713
2714 extern tree maybe_get_identifier (const char *);
2715
2716 /* Construct various types of nodes.  */
2717
2718 extern tree build (enum tree_code, tree, ...);
2719 extern tree build_nt (enum tree_code, ...);
2720
2721 #if GCC_VERSION >= 3000 || __STDC_VERSION__ >= 199901L
2722 /* Use preprocessor trickery to map "build" to "buildN" where N is the
2723    expected number of arguments.  This is used for both efficiency (no
2724    varargs), and checking (verifying number of passed arguments).  */
2725 #define build(code, ...) \
2726   _buildN1(build, _buildC1(__VA_ARGS__))(code, __VA_ARGS__)
2727 #define _buildN1(BASE, X)       _buildN2(BASE, X)
2728 #define _buildN2(BASE, X)       BASE##X
2729 #define _buildC1(...)           _buildC2(__VA_ARGS__,9,8,7,6,5,4,3,2,1,0,0)
2730 #define _buildC2(x,a1,a2,a3,a4,a5,a6,a7,a8,a9,c,...) c
2731 #endif
2732
2733 extern tree build0_stat (enum tree_code, tree MEM_STAT_DECL);
2734 #define build0(c,t) build0_stat (c,t MEM_STAT_INFO)
2735 extern tree build1_stat (enum tree_code, tree, tree MEM_STAT_DECL);
2736 #define build1(c,t1,t2) build1_stat (c,t1,t2 MEM_STAT_INFO)
2737 extern tree build2_stat (enum tree_code, tree, tree, tree MEM_STAT_DECL);
2738 #define build2(c,t1,t2,t3) build2_stat (c,t1,t2,t3 MEM_STAT_INFO)
2739 extern tree build3_stat (enum tree_code, tree, tree, tree, tree MEM_STAT_DECL);
2740 #define build3(c,t1,t2,t3,t4) build3_stat (c,t1,t2,t3,t4 MEM_STAT_INFO)
2741 extern tree build4_stat (enum tree_code, tree, tree, tree, tree,
2742                          tree MEM_STAT_DECL);
2743 #define build4(c,t1,t2,t3,t4,t5) build4_stat (c,t1,t2,t3,t4,t5 MEM_STAT_INFO)
2744
2745 extern tree build_int_cst (tree, unsigned HOST_WIDE_INT, HOST_WIDE_INT);
2746 extern tree build_vector (tree, tree);
2747 extern tree build_constructor (tree, tree);
2748 extern tree build_real_from_int_cst (tree, tree);
2749 extern tree build_complex (tree, tree, tree);
2750 extern tree build_string (int, const char *);
2751 extern tree build_tree_list_stat (tree, tree MEM_STAT_DECL);
2752 #define build_tree_list(t,q) build_tree_list_stat(t,q MEM_STAT_INFO)
2753 extern tree build_decl_stat (enum tree_code, tree, tree MEM_STAT_DECL);
2754 #define build_decl(c,t,q) build_decl_stat (c,t,q MEM_STAT_INFO)
2755 extern tree build_block (tree, tree, tree, tree, tree);
2756 #ifndef USE_MAPPED_LOCATION
2757 extern void annotate_with_file_line (tree, const char *, int);
2758 extern void annotate_with_locus (tree, location_t);
2759 #endif
2760 extern tree build_empty_stmt (void);
2761
2762 /* Construct various nodes representing data types.  */
2763
2764 extern tree make_signed_type (int);
2765 extern tree make_unsigned_type (int);
2766 extern void initialize_sizetypes (void);
2767 extern void set_sizetype (tree);
2768 extern void fixup_unsigned_type (tree);
2769 extern tree build_pointer_type_for_mode (tree, enum machine_mode, bool);
2770 extern tree build_pointer_type (tree);
2771 extern tree build_reference_type_for_mode (tree, enum machine_mode, bool);
2772 extern tree build_reference_type (tree);
2773 extern tree build_vector_type_for_mode (tree, enum machine_mode);
2774 extern tree build_vector_type (tree innertype, int nunits);
2775 extern tree build_type_no_quals (tree);
2776 extern tree build_index_type (tree);
2777 extern tree build_index_2_type (tree, tree);
2778 extern tree build_array_type (tree, tree);
2779 extern tree build_function_type (tree, tree);
2780 extern tree build_function_type_list (tree, ...);
2781 extern tree build_method_type_directly (tree, tree, tree);
2782 extern tree build_method_type (tree, tree);
2783 extern tree build_offset_type (tree, tree);
2784 extern tree build_complex_type (tree);
2785 extern tree array_type_nelts (tree);
2786 extern bool in_array_bounds_p (tree);
2787
2788 extern tree value_member (tree, tree);
2789 extern tree purpose_member (tree, tree);
2790
2791 extern int attribute_list_equal (tree, tree);
2792 extern int attribute_list_contained (tree, tree);
2793 extern int tree_int_cst_equal (tree, tree);
2794 extern int tree_int_cst_lt (tree, tree);
2795 extern int tree_int_cst_compare (tree, tree);
2796 extern int host_integerp (tree, int);
2797 extern HOST_WIDE_INT tree_low_cst (tree, int);
2798 extern int tree_int_cst_msb (tree);
2799 extern int tree_int_cst_sgn (tree);
2800 extern int tree_expr_nonnegative_p (tree);
2801 extern int rtl_expr_nonnegative_p (rtx);
2802 extern tree get_inner_array_type (tree);
2803
2804 /* From expmed.c.  Since rtl.h is included after tree.h, we can't
2805    put the prototype here.  Rtl.h does declare the prototype if
2806    tree.h had been included.  */
2807
2808 extern tree make_tree (tree, rtx);
2809 \f
2810 /* Return a type like TTYPE except that its TYPE_ATTRIBUTES
2811    is ATTRIBUTE.
2812
2813    Such modified types already made are recorded so that duplicates
2814    are not made.  */
2815
2816 extern tree build_type_attribute_variant (tree, tree);
2817 extern tree build_decl_attribute_variant (tree, tree);
2818
2819 /* Structure describing an attribute and a function to handle it.  */
2820 struct attribute_spec
2821 {
2822   /* The name of the attribute (without any leading or trailing __),
2823      or NULL to mark the end of a table of attributes.  */
2824   const char *const name;
2825   /* The minimum length of the list of arguments of the attribute.  */
2826   const int min_length;
2827   /* The maximum length of the list of arguments of the attribute
2828      (-1 for no maximum).  */
2829   const int max_length;
2830   /* Whether this attribute requires a DECL.  If it does, it will be passed
2831      from types of DECLs, function return types and array element types to
2832      the DECLs, function types and array types respectively; but when
2833      applied to a type in any other circumstances, it will be ignored with
2834      a warning.  (If greater control is desired for a given attribute,
2835      this should be false, and the flags argument to the handler may be
2836      used to gain greater control in that case.)  */
2837   const bool decl_required;
2838   /* Whether this attribute requires a type.  If it does, it will be passed
2839      from a DECL to the type of that DECL.  */
2840   const bool type_required;
2841   /* Whether this attribute requires a function (or method) type.  If it does,
2842      it will be passed from a function pointer type to the target type,
2843      and from a function return type (which is not itself a function
2844      pointer type) to the function type.  */
2845   const bool function_type_required;
2846   /* Function to handle this attribute.  NODE points to the node to which
2847      the attribute is to be applied.  If a DECL, it should be modified in
2848      place; if a TYPE, a copy should be created.  NAME is the name of the
2849      attribute (possibly with leading or trailing __).  ARGS is the TREE_LIST
2850      of the arguments (which may be NULL).  FLAGS gives further information
2851      about the context of the attribute.  Afterwards, the attributes will
2852      be added to the DECL_ATTRIBUTES or TYPE_ATTRIBUTES, as appropriate,
2853      unless *NO_ADD_ATTRS is set to true (which should be done on error,
2854      as well as in any other cases when the attributes should not be added
2855      to the DECL or TYPE).  Depending on FLAGS, any attributes to be
2856      applied to another type or DECL later may be returned;
2857      otherwise the return value should be NULL_TREE.  This pointer may be
2858      NULL if no special handling is required beyond the checks implied
2859      by the rest of this structure.  */
2860   tree (*const handler) (tree *node, tree name, tree args,
2861                                  int flags, bool *no_add_attrs);
2862 };
2863
2864 /* Flags that may be passed in the third argument of decl_attributes, and
2865    to handler functions for attributes.  */
2866 enum attribute_flags
2867 {
2868   /* The type passed in is the type of a DECL, and any attributes that
2869      should be passed in again to be applied to the DECL rather than the
2870      type should be returned.  */
2871   ATTR_FLAG_DECL_NEXT = 1,
2872   /* The type passed in is a function return type, and any attributes that
2873      should be passed in again to be applied to the function type rather
2874      than the return type should be returned.  */
2875   ATTR_FLAG_FUNCTION_NEXT = 2,
2876   /* The type passed in is an array element type, and any attributes that
2877      should be passed in again to be applied to the array type rather
2878      than the element type should be returned.  */
2879   ATTR_FLAG_ARRAY_NEXT = 4,
2880   /* The type passed in is a structure, union or enumeration type being
2881      created, and should be modified in place.  */
2882   ATTR_FLAG_TYPE_IN_PLACE = 8,
2883   /* The attributes are being applied by default to a library function whose
2884      name indicates known behavior, and should be silently ignored if they
2885      are not in fact compatible with the function type.  */
2886   ATTR_FLAG_BUILT_IN = 16
2887 };
2888
2889 /* Default versions of target-overridable functions.  */
2890
2891 extern tree merge_decl_attributes (tree, tree);
2892 extern tree merge_type_attributes (tree, tree);
2893 extern void default_register_cpp_builtins (struct cpp_reader *);
2894
2895 /* Split a list of declspecs and attributes into two.  */
2896
2897 extern void split_specs_attrs (tree, tree *, tree *);
2898
2899 /* Strip attributes from a list of combined specs and attrs.  */
2900
2901 extern tree strip_attrs (tree);
2902
2903 /* Return 1 if an attribute and its arguments are valid for a decl or type.  */
2904
2905 extern int valid_machine_attribute (tree, tree, tree, tree);
2906
2907 /* Given a tree node and a string, return nonzero if the tree node is
2908    a valid attribute name for the string.  */
2909
2910 extern int is_attribute_p (const char *, tree);
2911
2912 /* Given an attribute name and a list of attributes, return the list element
2913    of the attribute or NULL_TREE if not found.  */
2914
2915 extern tree lookup_attribute (const char *, tree);
2916
2917 /* Given two attributes lists, return a list of their union.  */
2918
2919 extern tree merge_attributes (tree, tree);
2920
2921 #if TARGET_DLLIMPORT_DECL_ATTRIBUTES
2922 /* Given two Windows decl attributes lists, possibly including
2923    dllimport, return a list of their union .  */
2924 extern tree merge_dllimport_decl_attributes (tree, tree);
2925
2926 /* Handle a "dllimport" or "dllexport" attribute.  */
2927 extern tree handle_dll_attribute (tree *, tree, tree, int, bool *);
2928 #endif
2929
2930 /* Check whether CAND is suitable to be returned from get_qualified_type
2931    (BASE, TYPE_QUALS).  */
2932
2933 extern bool check_qualified_type (tree, tree, int);
2934
2935 /* Return a version of the TYPE, qualified as indicated by the
2936    TYPE_QUALS, if one exists.  If no qualified version exists yet,
2937    return NULL_TREE.  */
2938
2939 extern tree get_qualified_type (tree, int);
2940
2941 /* Like get_qualified_type, but creates the type if it does not
2942    exist.  This function never returns NULL_TREE.  */
2943
2944 extern tree build_qualified_type (tree, int);
2945
2946 /* Like build_qualified_type, but only deals with the `const' and
2947    `volatile' qualifiers.  This interface is retained for backwards
2948    compatibility with the various front-ends; new code should use
2949    build_qualified_type instead.  */
2950
2951 #define build_type_variant(TYPE, CONST_P, VOLATILE_P)                   \
2952   build_qualified_type ((TYPE),                                         \
2953                         ((CONST_P) ? TYPE_QUAL_CONST : 0)               \
2954                         | ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
2955
2956 /* Make a copy of a type node.  */
2957
2958 extern tree build_type_copy (tree);
2959
2960 /* Finish up a builtin RECORD_TYPE. Give it a name and provide its
2961    fields. Optionally specify an alignment, and then lay it out.  */
2962
2963 extern void finish_builtin_struct (tree, const char *,
2964                                                          tree, tree);
2965
2966 /* Given a ..._TYPE node, calculate the TYPE_SIZE, TYPE_SIZE_UNIT,
2967    TYPE_ALIGN and TYPE_MODE fields.  If called more than once on one
2968    node, does nothing except for the first time.  */
2969
2970 extern void layout_type (tree);
2971
2972 /* These functions allow a front-end to perform a manual layout of a
2973    RECORD_TYPE.  (For instance, if the placement of subsequent fields
2974    depends on the placement of fields so far.)  Begin by calling
2975    start_record_layout.  Then, call place_field for each of the
2976    fields.  Then, call finish_record_layout.  See layout_type for the
2977    default way in which these functions are used.  */
2978
2979 typedef struct record_layout_info_s
2980 {
2981   /* The RECORD_TYPE that we are laying out.  */
2982   tree t;
2983   /* The offset into the record so far, in bytes, not including bits in
2984      BITPOS.  */
2985   tree offset;
2986   /* The last known alignment of SIZE.  */
2987   unsigned int offset_align;
2988   /* The bit position within the last OFFSET_ALIGN bits, in bits.  */
2989   tree bitpos;
2990   /* The alignment of the record so far, in bits.  */
2991   unsigned int record_align;
2992   /* The alignment of the record so far, ignoring #pragma pack and
2993      __attribute__ ((packed)), in bits.  */
2994   unsigned int unpacked_align;
2995   /* The previous field layed out.  */
2996   tree prev_field;
2997   /* The static variables (i.e., class variables, as opposed to
2998      instance variables) encountered in T.  */
2999   tree pending_statics;
3000   /* Bits remaining in the current alignment group */
3001   int remaining_in_alignment;
3002   /* True if we've seen a packed field that didn't have normal
3003      alignment anyway.  */
3004   int packed_maybe_necessary;
3005 } *record_layout_info;
3006
3007 extern void set_lang_adjust_rli (void (*) (record_layout_info));
3008 extern record_layout_info start_record_layout (tree);
3009 extern tree bit_from_pos (tree, tree);
3010 extern tree byte_from_pos (tree, tree);
3011 extern void pos_from_bit (tree *, tree *, unsigned int, tree);
3012 extern void normalize_offset (tree *, tree *, unsigned int);
3013 extern tree rli_size_unit_so_far (record_layout_info);
3014 extern tree rli_size_so_far (record_layout_info);
3015 extern void normalize_rli (record_layout_info);
3016 extern void place_field (record_layout_info, tree);
3017 extern void compute_record_mode (tree);
3018 extern void finish_record_layout (record_layout_info, int);
3019
3020 /* Given a hashcode and a ..._TYPE node (for which the hashcode was made),
3021    return a canonicalized ..._TYPE node, so that duplicates are not made.
3022    How the hash code is computed is up to the caller, as long as any two
3023    callers that could hash identical-looking type nodes agree.  */
3024
3025 extern tree type_hash_canon (unsigned int, tree);
3026
3027 /* Given a VAR_DECL, PARM_DECL, RESULT_DECL or FIELD_DECL node,
3028    calculates the DECL_SIZE, DECL_SIZE_UNIT, DECL_ALIGN and DECL_MODE
3029    fields.  Call this only once for any given decl node.
3030
3031    Second argument is the boundary that this field can be assumed to
3032    be starting at (in bits).  Zero means it can be assumed aligned
3033    on any boundary that may be needed.  */
3034
3035 extern void layout_decl (tree, unsigned);
3036
3037 /* Given a VAR_DECL, PARM_DECL or RESULT_DECL, clears the results of
3038    a previous call to layout_decl and calls it again.  */
3039
3040 extern void relayout_decl (tree);
3041
3042 /* Return the mode for data of a given size SIZE and mode class CLASS.
3043    If LIMIT is nonzero, then don't use modes bigger than MAX_FIXED_MODE_SIZE.
3044    The value is BLKmode if no other mode is found.  This is like
3045    mode_for_size, but is passed a tree.  */
3046
3047 extern enum machine_mode mode_for_size_tree (tree, enum mode_class, int);
3048
3049 /* Return an expr equal to X but certainly not valid as an lvalue.  */
3050
3051 extern tree non_lvalue (tree);
3052 extern tree pedantic_non_lvalue (tree);
3053
3054 extern tree convert (tree, tree);
3055 extern unsigned int expr_align (tree);
3056 extern tree expr_first (tree);
3057 extern tree expr_last (tree);
3058 extern tree expr_only (tree);
3059 extern tree size_in_bytes (tree);
3060 extern HOST_WIDE_INT int_size_in_bytes (tree);
3061 extern tree bit_position (tree);
3062 extern HOST_WIDE_INT int_bit_position (tree);
3063 extern tree byte_position (tree);
3064 extern HOST_WIDE_INT int_byte_position (tree);
3065
3066 /* Define data structures, macros, and functions for handling sizes
3067    and the various types used to represent sizes.  */
3068
3069 enum size_type_kind
3070 {
3071   SIZETYPE,             /* Normal representation of sizes in bytes.  */
3072   SSIZETYPE,            /* Signed representation of sizes in bytes.  */
3073   USIZETYPE,            /* Unsigned representation of sizes in bytes.  */
3074   BITSIZETYPE,          /* Normal representation of sizes in bits.  */
3075   SBITSIZETYPE,         /* Signed representation of sizes in bits.  */
3076   UBITSIZETYPE,         /* Unsigned representation of sizes in bits.  */
3077   TYPE_KIND_LAST};
3078
3079 extern GTY(()) tree sizetype_tab[(int) TYPE_KIND_LAST];
3080
3081 #define sizetype sizetype_tab[(int) SIZETYPE]
3082 #define bitsizetype sizetype_tab[(int) BITSIZETYPE]
3083 #define ssizetype sizetype_tab[(int) SSIZETYPE]
3084 #define usizetype sizetype_tab[(int) USIZETYPE]
3085 #define sbitsizetype sizetype_tab[(int) SBITSIZETYPE]
3086 #define ubitsizetype sizetype_tab[(int) UBITSIZETYPE]
3087
3088 extern tree size_binop (enum tree_code, tree, tree);
3089 extern tree size_diffop (tree, tree);
3090 extern tree size_int_kind (HOST_WIDE_INT, enum size_type_kind);
3091 extern tree size_int_type (HOST_WIDE_INT, tree);
3092
3093 #define size_int(L) size_int_kind (L, SIZETYPE)
3094 #define ssize_int(L) size_int_kind (L, SSIZETYPE)
3095 #define bitsize_int(L) size_int_kind (L, BITSIZETYPE)
3096 #define sbitsize_int(L) size_int_kind (L, SBITSIZETYPE)
3097
3098 extern tree round_up (tree, int);
3099 extern tree round_down (tree, int);
3100 extern tree get_pending_sizes (void);
3101 extern void put_pending_size (tree);
3102 extern void put_pending_sizes (tree);
3103
3104 /* Type for sizes of data-type.  */
3105
3106 #define BITS_PER_UNIT_LOG \
3107   ((BITS_PER_UNIT > 1) + (BITS_PER_UNIT > 2) + (BITS_PER_UNIT > 4) \
3108    + (BITS_PER_UNIT > 8) + (BITS_PER_UNIT > 16) + (BITS_PER_UNIT > 32) \
3109    + (BITS_PER_UNIT > 64) + (BITS_PER_UNIT > 128) + (BITS_PER_UNIT > 256))
3110
3111 /* If nonzero, an upper limit on alignment of structure fields, in bits.  */
3112 extern unsigned int maximum_field_alignment;
3113
3114 /* If nonzero, the alignment of a bitstring or (power-)set value, in bits.  */
3115 extern unsigned int set_alignment;
3116
3117 /* Concatenate two lists (chains of TREE_LIST nodes) X and Y
3118    by making the last node in X point to Y.
3119    Returns X, except if X is 0 returns Y.  */
3120
3121 extern tree chainon (tree, tree);
3122
3123 /* Make a new TREE_LIST node from specified PURPOSE, VALUE and CHAIN.  */
3124
3125 extern tree tree_cons_stat (tree, tree, tree MEM_STAT_DECL);
3126 #define tree_cons(t,q,w) tree_cons_stat (t,q,w MEM_STAT_INFO)
3127
3128 /* Return the last tree node in a chain.  */
3129
3130 extern tree tree_last (tree);
3131
3132 /* Reverse the order of elements in a chain, and return the new head.  */
3133
3134 extern tree nreverse (tree);
3135
3136 /* Returns the length of a chain of nodes
3137    (number of chain pointers to follow before reaching a null pointer).  */
3138
3139 extern int list_length (tree);
3140
3141 /* Returns the number of FIELD_DECLs in a type.  */
3142
3143 extern int fields_length (tree);
3144
3145 /* Given an initializer INIT, return TRUE if INIT is zero or some
3146    aggregate of zeros.  Otherwise return FALSE.  */
3147
3148 extern bool initializer_zerop (tree);
3149
3150 extern void categorize_ctor_elements (tree, HOST_WIDE_INT *, HOST_WIDE_INT *);
3151 extern HOST_WIDE_INT count_type_elements (tree);
3152 extern int mostly_zeros_p (tree);
3153
3154 /* add_var_to_bind_expr (bind_expr, var) binds var to bind_expr.  */
3155
3156 extern void add_var_to_bind_expr (tree, tree);
3157
3158 /* integer_zerop (tree x) is nonzero if X is an integer constant of value 0 */
3159
3160 extern int integer_zerop (tree);
3161
3162 /* integer_onep (tree x) is nonzero if X is an integer constant of value 1 */
3163
3164 extern int integer_onep (tree);
3165
3166 /* integer_all_onesp (tree x) is nonzero if X is an integer constant
3167    all of whose significant bits are 1.  */
3168
3169 extern int integer_all_onesp (tree);
3170
3171 /* integer_pow2p (tree x) is nonzero is X is an integer constant with
3172    exactly one bit 1.  */
3173
3174 extern int integer_pow2p (tree);
3175
3176 /* integer_nonzerop (tree x) is nonzero if X is an integer constant
3177    with a nonzero value.  */
3178
3179 extern int integer_nonzerop (tree);
3180
3181 /* staticp (tree x) is true if X is a reference to data allocated
3182    at a fixed address in memory.  */
3183
3184 extern bool staticp (tree);
3185
3186 /* save_expr (EXP) returns an expression equivalent to EXP
3187    but it can be used multiple times within context CTX
3188    and only evaluate EXP once.  */
3189
3190 extern tree save_expr (tree);
3191
3192 /* Look inside EXPR and into any simple arithmetic operations.  Return
3193    the innermost non-arithmetic node.  */
3194
3195 extern tree skip_simple_arithmetic (tree);
3196
3197 /* Returns the index of the first non-tree operand for CODE, or the number
3198    of operands if all are trees.  */
3199
3200 extern int first_rtl_op (enum tree_code);
3201
3202 /* Return which tree structure is used by T.  */
3203
3204 enum tree_node_structure_enum tree_node_structure (tree);
3205
3206 /* Return 1 if EXP contains a PLACEHOLDER_EXPR; i.e., if it represents a size
3207    or offset that depends on a field within a record.
3208
3209    Note that we only allow such expressions within simple arithmetic
3210    or a COND_EXPR.  */
3211
3212 extern bool contains_placeholder_p (tree);
3213
3214 /* This macro calls the above function but short-circuits the common
3215    case of a constant to save time.  Also check for null.  */
3216
3217 #define CONTAINS_PLACEHOLDER_P(EXP) \
3218   ((EXP) != 0 && ! TREE_CONSTANT (EXP) && contains_placeholder_p (EXP))
3219
3220 /* Return 1 if any part of the computation of TYPE involves a PLACEHOLDER_EXPR.
3221    This includes size, bounds, qualifiers (for QUAL_UNION_TYPE) and field
3222    positions.  */
3223
3224 extern bool type_contains_placeholder_p (tree);
3225
3226 /* Return 1 if EXP contains any expressions that produce cleanups for an
3227    outer scope to deal with.  Used by fold.  */
3228
3229 extern int has_cleanups (tree);
3230
3231 /* Given a tree EXP, a FIELD_DECL F, and a replacement value R,
3232    return a tree with all occurrences of references to F in a
3233    PLACEHOLDER_EXPR replaced by R.   Note that we assume here that EXP
3234    contains only arithmetic expressions.  */
3235
3236 extern tree substitute_in_expr (tree, tree, tree);
3237
3238 /* This macro calls the above function but short-circuits the common
3239    case of a constant to save time and also checks for NULL.  */
3240
3241 #define SUBSTITUTE_IN_EXPR(EXP, F, R) \
3242   ((EXP) == 0 || TREE_CONSTANT (EXP) ? (EXP) : substitute_in_expr (EXP, F, R))
3243
3244 /* Similar, but look for a PLACEHOLDER_EXPR in EXP and find a replacement
3245    for it within OBJ, a tree that is an object or a chain of references.  */
3246
3247 extern tree substitute_placeholder_in_expr (tree, tree);
3248
3249 /* This macro calls the above function but short-circuits the common
3250    case of a constant to save time and also checks for NULL.  */
3251
3252 #define SUBSTITUTE_PLACEHOLDER_IN_EXPR(EXP, OBJ) \
3253   ((EXP) == 0 || TREE_CONSTANT (EXP) ? (EXP)    \
3254    : substitute_placeholder_in_expr (EXP, OBJ))
3255
3256 /* variable_size (EXP) is like save_expr (EXP) except that it
3257    is for the special case of something that is part of a
3258    variable size for a data type.  It makes special arrangements
3259    to compute the value at the right time when the data type
3260    belongs to a function parameter.  */
3261
3262 extern tree variable_size (tree);
3263
3264 /* stabilize_reference (EXP) returns a reference equivalent to EXP
3265    but it can be used multiple times
3266    and only evaluate the subexpressions once.  */
3267
3268 extern tree stabilize_reference (tree);
3269
3270 /* Subroutine of stabilize_reference; this is called for subtrees of
3271    references.  Any expression with side-effects must be put in a SAVE_EXPR
3272    to ensure that it is only evaluated once.  */
3273
3274 extern tree stabilize_reference_1 (tree);
3275
3276 /* Return EXP, stripped of any conversions to wider types
3277    in such a way that the result of converting to type FOR_TYPE
3278    is the same as if EXP were converted to FOR_TYPE.
3279    If FOR_TYPE is 0, it signifies EXP's type.  */
3280
3281 extern tree get_unwidened (tree, tree);
3282
3283 /* Return OP or a simpler expression for a narrower value
3284    which can be sign-extended or zero-extended to give back OP.
3285    Store in *UNSIGNEDP_PTR either 1 if the value should be zero-extended
3286    or 0 if the value should be sign-extended.  */
3287
3288 extern tree get_narrower (tree, int *);
3289
3290 /* Given an expression EXP that may be a COMPONENT_REF or an ARRAY_REF,
3291    look for nested component-refs or array-refs at constant positions
3292    and find the ultimate containing object, which is returned.  */
3293
3294 extern tree get_inner_reference (tree, HOST_WIDE_INT *, HOST_WIDE_INT *,
3295                                  tree *, enum machine_mode *, int *, int *);
3296
3297 /* Return 1 if T is an expression that get_inner_reference handles.  */
3298
3299 extern int handled_component_p (tree);
3300
3301 /* Return a tree of sizetype representing the size, in bytes, of the element
3302    of EXP, an ARRAY_REF.  */
3303
3304 extern tree array_ref_element_size (tree);
3305
3306 /* Return a tree representing the lower bound of the array mentioned in
3307    EXP, an ARRAY_REF.  */
3308
3309 extern tree array_ref_low_bound (tree);
3310
3311 /* Return a tree representing the upper bound of the array mentioned in
3312    EXP, an ARRAY_REF.  */
3313
3314 extern tree array_ref_up_bound (tree);
3315
3316 /* Return a tree representing the offset, in bytes, of the field referenced
3317    by EXP.  This does not include any offset in DECL_FIELD_BIT_OFFSET.  */
3318
3319 extern tree component_ref_field_offset (tree);
3320
3321 /* Given a DECL or TYPE, return the scope in which it was declared, or
3322    NUL_TREE if there is no containing scope.  */
3323
3324 extern tree get_containing_scope (tree);
3325
3326 /* Return the FUNCTION_DECL which provides this _DECL with its context,
3327    or zero if none.  */
3328 extern tree decl_function_context (tree);
3329
3330 /* Return the RECORD_TYPE, UNION_TYPE, or QUAL_UNION_TYPE which provides
3331    this _DECL with its context, or zero if none.  */
3332 extern tree decl_type_context (tree);
3333
3334 /* Return 1 if EXPR is the real constant zero.  */
3335 extern int real_zerop (tree);
3336 \f
3337 /* Declare commonly used variables for tree structure.  */
3338
3339 /* Nonzero means lvalues are limited to those valid in pedantic ANSI C.
3340    Zero means allow extended lvalues.  */
3341
3342 extern int pedantic_lvalues;
3343
3344 /* Points to the FUNCTION_DECL of the function whose body we are reading.  */
3345
3346 extern GTY(()) tree current_function_decl;
3347
3348 /* Nonzero means a FUNC_BEGIN label was emitted.  */
3349 extern GTY(()) tree current_function_func_begin_label;
3350 \f
3351 /* In tree.c */
3352 extern unsigned crc32_string (unsigned, const char *);
3353 extern void clean_symbol_name (char *);
3354 extern tree get_file_function_name_long (const char *);
3355 extern tree get_set_constructor_bits (tree, char *, int);
3356 extern tree get_set_constructor_bytes (tree, unsigned char *, int);
3357 extern tree get_callee_fndecl (tree);
3358 extern void change_decl_assembler_name (tree, tree);
3359 extern int type_num_arguments (tree);
3360 extern bool associative_tree_code (enum tree_code);
3361 extern bool commutative_tree_code (enum tree_code);
3362
3363 \f
3364 /* In stmt.c */
3365
3366 extern void expand_expr_stmt (tree);
3367 extern void expand_expr_stmt_value (tree, int, int);
3368 extern int warn_if_unused_value (tree, location_t);
3369 extern void expand_decl_init (tree);
3370 extern void expand_label (tree);
3371 extern void expand_goto (tree);
3372 extern void expand_asm (tree, int);
3373
3374 extern rtx expand_stack_save (void);
3375 extern void expand_stack_restore (tree);
3376 extern void expand_return (tree);
3377 extern int is_body_block (tree);
3378
3379 /* In tree-eh.c */
3380 extern void using_eh_for_cleanups (void);
3381
3382 /* In fold-const.c */
3383
3384 /* Fold constants as much as possible in an expression.
3385    Returns the simplified expression.
3386    Acts only on the top level of the expression;
3387    if the argument itself cannot be simplified, its
3388    subexpressions are not changed.  */
3389
3390 extern tree fold (tree);
3391 extern tree fold_initializer (tree);
3392 extern tree fold_convert (tree, tree);
3393 extern tree fold_single_bit_test (enum tree_code, tree, tree, tree);
3394 extern tree fold_ignored_result (tree);
3395 extern tree fold_abs_const (tree, tree);
3396
3397 extern tree force_fit_type (tree, int, bool, bool);
3398
3399 extern int add_double (unsigned HOST_WIDE_INT, HOST_WIDE_INT,
3400                        unsigned HOST_WIDE_INT, HOST_WIDE_INT,
3401                        unsigned HOST_WIDE_INT *, HOST_WIDE_INT *);
3402 extern int neg_double (unsigned HOST_WIDE_INT, HOST_WIDE_INT,
3403                        unsigned HOST_WIDE_INT *, HOST_WIDE_INT *);
3404 extern int mul_double (unsigned HOST_WIDE_INT, HOST_WIDE_INT,
3405                        unsigned HOST_WIDE_INT, HOST_WIDE_INT,
3406                        unsigned HOST_WIDE_INT *, HOST_WIDE_INT *);
3407 extern void lshift_double (unsigned HOST_WIDE_INT, HOST_WIDE_INT,
3408                            HOST_WIDE_INT, unsigned int,
3409                            unsigned HOST_WIDE_INT *, HOST_WIDE_INT *, int);
3410 extern void rshift_double (unsigned HOST_WIDE_INT, HOST_WIDE_INT,
3411                            HOST_WIDE_INT, unsigned int,
3412                            unsigned HOST_WIDE_INT *, HOST_WIDE_INT *, int);
3413 extern void lrotate_double (unsigned HOST_WIDE_INT, HOST_WIDE_INT,
3414                             HOST_WIDE_INT, unsigned int,
3415                             unsigned HOST_WIDE_INT *, HOST_WIDE_INT *);
3416 extern void rrotate_double (unsigned HOST_WIDE_INT, HOST_WIDE_INT,
3417                             HOST_WIDE_INT, unsigned int,
3418                             unsigned HOST_WIDE_INT *, HOST_WIDE_INT *);
3419
3420 extern int div_and_round_double (enum tree_code, int, unsigned HOST_WIDE_INT,
3421                                  HOST_WIDE_INT, unsigned HOST_WIDE_INT,
3422                                  HOST_WIDE_INT, unsigned HOST_WIDE_INT *,
3423                                  HOST_WIDE_INT *, unsigned HOST_WIDE_INT *,
3424                                  HOST_WIDE_INT *);
3425
3426 enum operand_equal_flag
3427 {
3428   OEP_ONLY_CONST = 1,
3429   OEP_PURE_SAME = 2
3430 };
3431
3432 extern int operand_equal_p (tree, tree, unsigned int);
3433
3434 extern tree omit_one_operand (tree, tree, tree);
3435 extern tree omit_two_operands (tree, tree, tree, tree);
3436 extern tree invert_truthvalue (tree);
3437 extern tree nondestructive_fold_unary_to_constant (enum tree_code, tree, tree);
3438 extern tree nondestructive_fold_binary_to_constant (enum tree_code, tree, tree, tree);
3439 extern tree fold_read_from_constant_string (tree);
3440 extern tree int_const_binop (enum tree_code, tree, tree, int);
3441 extern tree build_fold_addr_expr (tree);
3442 extern tree build_fold_addr_expr_with_type (tree, tree);
3443 extern tree build_fold_indirect_ref (tree);
3444 extern tree constant_boolean_node (int, tree);
3445
3446 extern bool tree_swap_operands_p (tree, tree, bool);
3447 extern enum tree_code swap_tree_comparison (enum tree_code);
3448
3449 /* In builtins.c */
3450 extern tree fold_builtin (tree, bool);
3451 extern tree fold_builtin_fputs (tree, bool, bool, tree);
3452 extern tree fold_builtin_strcpy (tree, tree);
3453 extern tree fold_builtin_strncpy (tree, tree);
3454 extern enum built_in_function builtin_mathfn_code (tree);
3455 extern tree build_function_call_expr (tree, tree);
3456 extern tree mathfn_built_in (tree, enum built_in_function fn);
3457 extern tree strip_float_extensions (tree);
3458 extern tree simplify_builtin (tree, int);
3459 extern tree c_strlen (tree, int);
3460 extern tree std_gimplify_va_arg_expr (tree, tree, tree *, tree *);
3461
3462 /* In convert.c */
3463 extern tree strip_float_extensions (tree);
3464
3465 /* In alias.c */
3466 extern void record_component_aliases (tree);
3467 extern HOST_WIDE_INT get_alias_set (tree);
3468 extern int alias_sets_conflict_p (HOST_WIDE_INT, HOST_WIDE_INT);
3469 extern int alias_sets_might_conflict_p (HOST_WIDE_INT, HOST_WIDE_INT);
3470 extern int objects_must_conflict_p (tree, tree);
3471
3472 /* In tree.c */
3473 extern int really_constant_p (tree);
3474 extern int int_fits_type_p (tree, tree);
3475 extern bool variably_modified_type_p (tree, tree);
3476 extern int tree_log2 (tree);
3477 extern int tree_floor_log2 (tree);
3478 extern int simple_cst_equal (tree, tree);
3479 extern unsigned int iterative_hash_expr (tree, unsigned int);
3480 extern int compare_tree_int (tree, unsigned HOST_WIDE_INT);
3481 extern int type_list_equal (tree, tree);
3482 extern int chain_member (tree, tree);
3483 extern tree type_hash_lookup (unsigned int, tree);
3484 extern void type_hash_add (unsigned int, tree);
3485 extern int simple_cst_list_equal (tree, tree);
3486 extern void dump_tree_statistics (void);
3487 extern void expand_function_end (void);
3488 extern void expand_function_start (tree);
3489 extern void expand_pending_sizes (tree);
3490 extern void recompute_tree_invarant_for_addr_expr (tree);
3491 extern bool is_global_var (tree t);
3492 extern bool needs_to_live_in_memory (tree);
3493 extern tree reconstruct_complex_type (tree, tree);
3494
3495 extern int real_onep (tree);
3496 extern int real_twop (tree);
3497 extern int real_minus_onep (tree);
3498 extern void init_ttree (void);
3499 extern void build_common_tree_nodes (int);
3500 extern void build_common_tree_nodes_2 (int);
3501 extern tree build_nonstandard_integer_type (unsigned HOST_WIDE_INT, int);
3502 extern tree build_range_type (tree, tree, tree);
3503 extern HOST_WIDE_INT int_cst_value (tree);
3504 extern tree tree_fold_gcd (tree, tree);
3505
3506 extern bool fields_compatible_p (tree, tree);
3507 extern tree find_compatible_field (tree, tree);
3508
3509 /* In function.c */
3510 extern void expand_main_function (void);
3511 extern void init_dummy_function_start (void);
3512 extern void expand_dummy_function_end (void);
3513 extern void init_function_for_compilation (void);
3514 extern void allocate_struct_function (tree);
3515 extern void init_function_start (tree);
3516 extern bool use_register_for_decl (tree);
3517 extern void assign_parms (tree);
3518 extern void setjmp_vars_warning (tree);
3519 extern void setjmp_args_warning (void);
3520 extern void init_temp_slots (void);
3521 extern void combine_temp_slots (void);
3522 extern void free_temp_slots (void);
3523 extern void pop_temp_slots (void);
3524 extern void push_temp_slots (void);
3525 extern void preserve_temp_slots (rtx);
3526 extern void preserve_rtl_expr_temps (tree);
3527 extern int aggregate_value_p (tree, tree);
3528 extern void push_function_context (void);
3529 extern void pop_function_context (void);
3530 extern void push_function_context_to (tree);
3531 extern void pop_function_context_from (tree);
3532
3533 /* In print-rtl.c */
3534 #ifdef BUFSIZ
3535 extern void print_rtl (FILE *, rtx);
3536 #endif
3537
3538 /* In print-tree.c */
3539 extern void debug_tree (tree);
3540 #ifdef BUFSIZ
3541 extern void print_node (FILE *, const char *, tree, int);
3542 extern void print_node_brief (FILE *, const char *, tree, int);
3543 extern void indent_to (FILE *, int);
3544 #endif
3545
3546 /* In tree-inline.c:  */
3547 extern bool debug_find_tree (tree, tree);
3548 /* This is in tree-inline.c since the routine uses
3549    data structures from the inliner.  */
3550 extern tree unsave_expr_now (tree);
3551
3552 /* In expr.c */
3553 extern rtx expand_builtin_return_addr (enum built_in_function, int, rtx);
3554 extern void check_max_integer_computation_mode (tree);
3555
3556 /* In emit-rtl.c */
3557 extern rtx emit_line_note (location_t);
3558
3559 /* In calls.c */
3560
3561 /* Nonzero if this is a call to a `const' function.  */
3562 #define ECF_CONST               1
3563 /* Nonzero if this is a call to a `volatile' function.  */
3564 #define ECF_NORETURN            2
3565 /* Nonzero if this is a call to malloc or a related function.  */
3566 #define ECF_MALLOC              4
3567 /* Nonzero if it is plausible that this is a call to alloca.  */
3568 #define ECF_MAY_BE_ALLOCA       8
3569 /* Nonzero if this is a call to a function that won't throw an exception.  */
3570 #define ECF_NOTHROW             16
3571 /* Nonzero if this is a call to setjmp or a related function.  */
3572 #define ECF_RETURNS_TWICE       32
3573 /* Nonzero if this is a call to `longjmp'.  */
3574 #define ECF_LONGJMP             64
3575 /* Nonzero if this is a syscall that makes a new process in the image of
3576    the current one.  */
3577 #define ECF_SIBCALL             128
3578 /* Nonzero if this is a call to "pure" function (like const function,
3579    but may read memory.  */
3580 #define ECF_PURE                256
3581 /* Nonzero if this is a call to a function that returns with the stack
3582    pointer depressed.  */
3583 #define ECF_SP_DEPRESSED        512
3584 /* Nonzero if this call is known to always return.  */
3585 #define ECF_ALWAYS_RETURN       1024
3586 /* Create libcall block around the call.  */
3587 #define ECF_LIBCALL_BLOCK       2048
3588
3589 extern int flags_from_decl_or_type (tree);
3590 extern int call_expr_flags (tree);
3591
3592 extern int setjmp_call_p (tree);
3593 extern bool alloca_call_p (tree);
3594 extern bool must_pass_in_stack_var_size (enum machine_mode, tree);
3595 extern bool must_pass_in_stack_var_size_or_pad (enum machine_mode, tree);
3596
3597 /* In attribs.c.  */
3598
3599 /* Process the attributes listed in ATTRIBUTES and install them in *NODE,
3600    which is either a DECL (including a TYPE_DECL) or a TYPE.  If a DECL,
3601    it should be modified in place; if a TYPE, a copy should be created
3602    unless ATTR_FLAG_TYPE_IN_PLACE is set in FLAGS.  FLAGS gives further
3603    information, in the form of a bitwise OR of flags in enum attribute_flags
3604    from tree.h.  Depending on these flags, some attributes may be
3605    returned to be applied at a later stage (for example, to apply
3606    a decl attribute to the declaration rather than to its type).  */
3607 extern tree decl_attributes (tree *, tree, int);
3608
3609 /* In integrate.c */
3610 extern void set_decl_abstract_flags (tree, int);
3611 extern void set_decl_origin_self (tree);
3612
3613 /* In stor-layout.c */
3614 extern void set_min_and_max_values_for_integral_type (tree, int, bool);
3615 extern void fixup_signed_type (tree);
3616 extern void internal_reference_types (void);
3617 extern unsigned int update_alignment_for_field (record_layout_info, tree,
3618                                                 unsigned int);
3619 /* varasm.c */
3620 extern void make_decl_rtl (tree);
3621 extern void make_decl_one_only (tree);
3622 extern int supports_one_only (void);
3623 extern void variable_section (tree, int);
3624 enum tls_model decl_tls_model (tree);
3625 extern void resolve_unique_section (tree, int, int);
3626 extern void mark_referenced (tree);
3627 extern void mark_decl_referenced (tree);
3628 extern void notice_global_symbol (tree);
3629 extern void set_user_assembler_name (tree, const char *);
3630
3631 /* In stmt.c */
3632 extern void expand_computed_goto (tree);
3633 extern bool parse_output_constraint (const char **, int, int, int,
3634                                      bool *, bool *, bool *);
3635 extern bool parse_input_constraint (const char **, int, int, int, int,
3636                                     const char * const *, bool *, bool *);
3637 extern void expand_asm_operands (tree, tree, tree, tree, int, location_t);
3638 extern void expand_asm_expr (tree);
3639 extern bool asm_op_is_mem_input (tree, tree);
3640 extern tree resolve_asm_operand_names (tree, tree, tree);
3641 extern void expand_case (tree);
3642 extern void expand_decl (tree);
3643 extern void expand_anon_union_decl (tree, tree, tree);
3644
3645 /* In gimplify.c.  */
3646 extern tree create_artificial_label (void);
3647 extern void gimplify_function_tree (tree);
3648 extern const char *get_name (tree);
3649 extern tree unshare_expr (tree);
3650 extern void sort_case_labels (tree);
3651
3652 /* If KIND=='I', return a suitable global initializer (constructor) name.
3653    If KIND=='D', return a suitable global clean-up (destructor) name.  */
3654 extern tree get_file_function_name (int);
3655 \f
3656 /* Interface of the DWARF2 unwind info support.  */
3657
3658 /* Generate a new label for the CFI info to refer to.  */
3659
3660 extern char *dwarf2out_cfi_label (void);
3661
3662 /* Entry point to update the canonical frame address (CFA).  */
3663
3664 extern void dwarf2out_def_cfa (const char *, unsigned, HOST_WIDE_INT);
3665
3666 /* Add the CFI for saving a register window.  */
3667
3668 extern void dwarf2out_window_save (const char *);
3669
3670 /* Add a CFI to update the running total of the size of arguments pushed
3671    onto the stack.  */
3672
3673 extern void dwarf2out_args_size (const char *, HOST_WIDE_INT);
3674
3675 /* Entry point for saving a register to the stack.  */
3676
3677 extern void dwarf2out_reg_save (const char *, unsigned, HOST_WIDE_INT);
3678
3679 /* Entry point for saving the return address in the stack.  */
3680
3681 extern void dwarf2out_return_save (const char *, HOST_WIDE_INT);
3682
3683 /* Entry point for saving the return address in a register.  */
3684
3685 extern void dwarf2out_return_reg (const char *, unsigned);
3686
3687 /* In tree-inline.c  */
3688
3689 /* The type of a callback function for walking over tree structure.  */
3690
3691 typedef tree (*walk_tree_fn) (tree *, int *, void *);
3692 extern tree walk_tree (tree*, walk_tree_fn, void*, void*);
3693 extern tree walk_tree_without_duplicates (tree*, walk_tree_fn, void*);
3694
3695 /* In tree-dump.c */
3696
3697 /* Different tree dump places.  When you add new tree dump places,
3698    extend the DUMP_FILES array in tree-dump.c.  */
3699 enum tree_dump_index
3700 {
3701   TDI_none,                     /* No dump */
3702   TDI_tu,                       /* dump the whole translation unit.  */
3703   TDI_class,                    /* dump class hierarchy.  */
3704   TDI_original,                 /* dump each function before optimizing it */
3705   TDI_generic,                  /* dump each function after genericizing it */
3706   TDI_nested,                   /* dump each function after unnesting it */
3707   TDI_inlined,                  /* dump each function after inlining
3708                                    within it.  */
3709   TDI_vcg,                      /* create a VCG graph file for each
3710                                    function's flowgraph.  */
3711   TDI_xml,                      /* dump function call graph.  */
3712   TDI_all,                      /* enable all the dumps.  */
3713   TDI_end
3714 };
3715
3716 /* Bit masks to control tree dumping. Not all values are applicable to
3717    all tree dumps. Add new ones at the end. When you define new
3718    values, extend the DUMP_OPTIONS array in tree-dump.c */
3719 #define TDF_ADDRESS     (1 << 0)        /* dump node addresses */
3720 #define TDF_SLIM        (1 << 1)        /* don't go wild following links */
3721 #define TDF_RAW         (1 << 2)        /* don't unparse the function */
3722 #define TDF_DETAILS     (1 << 3)        /* show more detailed info about
3723                                            each pass */
3724 #define TDF_STATS       (1 << 4)        /* dump various statistics about
3725                                            each pass */
3726 #define TDF_BLOCKS      (1 << 5)        /* display basic block boundaries */
3727 #define TDF_VOPS        (1 << 6)        /* display virtual operands */
3728 #define TDF_LINENO      (1 << 7)        /* display statement line numbers */
3729 #define TDF_UID         (1 << 8)        /* display decl UIDs */
3730
3731
3732 typedef struct dump_info *dump_info_p;
3733
3734 extern int dump_flag (dump_info_p, int, tree);
3735 extern int dump_enabled_p (enum tree_dump_index);
3736 extern FILE *dump_begin (enum tree_dump_index, int *);
3737 extern void dump_end (enum tree_dump_index, FILE *);
3738 extern void dump_node (tree, int, FILE *);
3739 extern int dump_switch_p (const char *);
3740 extern const char *dump_flag_name (enum tree_dump_index);
3741 /* Assign the RTX to declaration.  */
3742
3743 extern void set_decl_rtl (tree, rtx);
3744 extern void set_decl_incoming_rtl (tree, rtx);
3745 \f
3746 /* Redefine abort to report an internal error w/o coredump, and
3747    reporting the location of the error in the source file.  This logic
3748    is duplicated in rtl.h and tree.h because every file that needs the
3749    special abort includes one or both.  toplev.h gets too few files,
3750    system.h gets too many.  */
3751
3752 extern void fancy_abort (const char *, int, const char *)
3753     ATTRIBUTE_NORETURN;
3754 #define abort() fancy_abort (__FILE__, __LINE__, __FUNCTION__)
3755
3756 /* Enum and arrays used for tree allocation stats.
3757    Keep in sync with tree.c:tree_node_kind_names.  */
3758 typedef enum
3759 {
3760   d_kind,
3761   t_kind,
3762   b_kind,
3763   s_kind,
3764   r_kind,
3765   e_kind,
3766   c_kind,
3767   id_kind,
3768   perm_list_kind,
3769   temp_list_kind,
3770   vec_kind,
3771   binfo_kind,
3772   phi_kind,
3773   ssa_name_kind,
3774   x_kind,
3775   lang_decl,
3776   lang_type,
3777   all_kinds
3778 } tree_node_kind;
3779
3780 extern int tree_node_counts[];
3781 extern int tree_node_sizes[];
3782
3783 /* True if we are in gimple form and the actions of the folders need to
3784    be restricted.  False if we are not in gimple form and folding is not
3785    restricted to creating gimple expressions.  */
3786 extern bool in_gimple_form;
3787
3788 /* In tree-ssa-loop-niter.c.  */
3789 tree lower_bound_in_type (tree, tree);
3790 tree upper_bound_in_type (tree, tree);
3791
3792 /* In tree-ssa-threadupdate.c.  */
3793 extern bool thread_through_all_blocks (void);
3794
3795 /* In tree-gimple.c.  */
3796 extern tree get_base_address (tree t);
3797
3798 #endif  /* GCC_TREE_H  */