OSDN Git Service

* Makefile.in (C_AND_OBJC_OBJS): Remove c-iterate.o.
[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    Free Software Foundation, Inc.
4
5 This file is part of GNU CC.
6
7 GNU CC is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
11
12 GNU CC is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with GNU CC; see the file COPYING.  If not, write to
19 the Free Software Foundation, 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA.  */
21
22 #include "machmode.h"
23 #include "version.h"
24
25 #ifndef RTX_CODE
26 struct rtx_def;
27 #endif
28
29 /* Codes of tree nodes */
30
31 #define DEFTREECODE(SYM, STRING, TYPE, NARGS)   SYM,
32
33 enum tree_code {
34 #include "tree.def"
35
36   LAST_AND_UNUSED_TREE_CODE     /* A convenient way to get a value for
37                                    NUM_TREE_CODE.  */
38 };
39
40 #undef DEFTREECODE
41
42 /* Number of language-independent tree codes.  */
43 #define NUM_TREE_CODES ((int) LAST_AND_UNUSED_TREE_CODE)
44
45 /* Indexed by enum tree_code, contains a character which is
46    `<' for a comparison expression, `1', for a unary arithmetic
47    expression, `2' for a binary arithmetic expression, `e' for
48    other types of expressions, `r' for a reference, `c' for a
49    constant, `d' for a decl, `t' for a type, `s' for a statement,
50    and `x' for anything else (TREE_LIST, IDENTIFIER, etc).  */
51
52 #define MAX_TREE_CODES 256
53 extern char tree_code_type[MAX_TREE_CODES];
54 #define TREE_CODE_CLASS(CODE)   tree_code_type[(int) (CODE)]
55
56 /* Returns non-zero iff CLASS is the tree-code class of an
57    expression.  */
58
59 #define IS_EXPR_CODE_CLASS(CLASS) \
60   (CLASS == '<' || CLASS == '1' || CLASS == '2' || CLASS == 'e')
61
62 /* Number of argument-words in each kind of tree-node.  */
63
64 extern int tree_code_length[MAX_TREE_CODES];
65 #define TREE_CODE_LENGTH(CODE)  tree_code_length[(int) (CODE)]
66
67 /* Names of tree components.  */
68
69 extern const char *tree_code_name[MAX_TREE_CODES];
70 \f
71 /* Classify which part of the compiler has defined a given builtin function.
72    Note that we assume below that this is no more than two bits.  */
73 enum built_in_class
74 {
75   NOT_BUILT_IN = 0,
76   BUILT_IN_FRONTEND,
77   BUILT_IN_MD,
78   BUILT_IN_NORMAL
79 };
80
81 /* Names for the above.  */
82 extern const char *const built_in_class_names[4];
83
84 /* Codes that identify the various built in functions
85    so that expand_call can identify them quickly.  */
86
87 #define DEF_BUILTIN(x) x,
88 enum built_in_function
89 {
90 #include "builtins.def"
91
92   /* Upper bound on non-language-specific builtins. */
93   END_BUILTINS
94 };
95 #undef DEF_BUILTIN
96
97 /* Names for the above.  */
98 extern const char *const built_in_names[(int) END_BUILTINS];
99 \f
100 /* The definition of tree nodes fills the next several pages.  */
101
102 /* A tree node can represent a data type, a variable, an expression
103    or a statement.  Each node has a TREE_CODE which says what kind of
104    thing it represents.  Some common codes are:
105    INTEGER_TYPE -- represents a type of integers.
106    ARRAY_TYPE -- represents a type of pointer.
107    VAR_DECL -- represents a declared variable.
108    INTEGER_CST -- represents a constant integer value.
109    PLUS_EXPR -- represents a sum (an expression).
110
111    As for the contents of a tree node: there are some fields
112    that all nodes share.  Each TREE_CODE has various special-purpose
113    fields as well.  The fields of a node are never accessed directly,
114    always through accessor macros.  */
115
116 /* This type is used everywhere to refer to a tree node.  */
117
118 typedef union tree_node *tree;
119
120 /* Every kind of tree node starts with this structure,
121    so all nodes have these fields.
122
123    See the accessor macros, defined below, for documentation of the
124    fields.   */
125
126 struct tree_common
127 {
128   union tree_node *chain;
129   union tree_node *type;
130   ENUM_BITFIELD(tree_code) code : 8;
131   unsigned side_effects_flag : 1;
132   unsigned constant_flag : 1;
133   unsigned permanent_flag : 1;
134   unsigned addressable_flag : 1;
135   unsigned volatile_flag : 1;
136   unsigned readonly_flag : 1;
137   unsigned unsigned_flag : 1;
138   unsigned asm_written_flag: 1;
139
140   unsigned used_flag : 1;
141   unsigned nothrow_flag : 1;
142   unsigned static_flag : 1;
143   unsigned public_flag : 1;
144   unsigned private_flag : 1;
145   unsigned protected_flag : 1;
146   unsigned bounded_flag : 1;
147
148   unsigned lang_flag_0 : 1;
149   unsigned lang_flag_1 : 1;
150   unsigned lang_flag_2 : 1;
151   unsigned lang_flag_3 : 1;
152   unsigned lang_flag_4 : 1;
153   unsigned lang_flag_5 : 1;
154   unsigned lang_flag_6 : 1;
155 };
156
157 /* The following table lists the uses of each of the above flags and
158    for which types of nodes they are defined.  Note that expressions
159    include decls.
160
161    addressable_flag:
162
163        TREE_ADDRESSABLE in
164            VAR_DECL, FUNCTION_DECL, FIELD_DECL, CONSTRUCTOR, LABEL_DECL,
165            ..._TYPE, IDENTIFIER_NODE
166
167    static_flag:
168
169        TREE_STATIC in
170            VAR_DECL, FUNCTION_DECL, CONSTRUCTOR, ADDR_EXPR
171        TREE_NO_UNUSED_WARNING in
172            CONVERT_EXPR, NOP_EXPR, COMPOUND_EXPR
173        TREE_VIA_VIRTUAL in
174            TREE_LIST or TREE_VEC
175        TREE_CONSTANT_OVERFLOW in
176            INTEGER_CST, REAL_CST, COMPLEX_CST
177        TREE_SYMBOL_REFERENCED in
178            IDENTIFIER_NODE
179
180    public_flag:
181
182        TREE_OVERFLOW in
183            INTEGER_CST, REAL_CST, COMPLEX_CST
184        TREE_PUBLIC in
185            VAR_DECL or FUNCTION_DECL
186        TREE_VIA_PUBLIC in
187            TREE_LIST or TREE_VEC
188        EXPR_WFL_EMIT_LINE_NOTE in
189            EXPR_WITH_FILE_LOCATION
190
191    private_flag:
192
193        TREE_VIA_PRIVATE in
194            TREE_LIST or TREE_VEC
195        TREE_PRIVATE in
196            ??? unspecified nodes
197
198    protected_flag:
199
200        TREE_VIA_PROTECTED in
201            TREE_LIST
202        TREE_PROTECTED in
203            BLOCK
204            ??? unspecified nodes
205
206    side_effects_flag:
207
208        TREE_SIDE_EFFECTS in
209            all expressions
210
211    volatile_flag:
212
213        TREE_THIS_VOLATILE in
214            all expressions
215        TYPE_VOLATILE in
216            ..._TYPE
217
218    readonly_flag:
219
220        TREE_READONLY in
221            all expressions
222        TYPE_READONLY in
223            ..._TYPE
224
225    constant_flag:
226
227        TREE_CONSTANT in
228            all expressions
229
230    permanent_flag: TREE_PERMANENT in all nodes
231
232    unsigned_flag:
233
234        TREE_UNSIGNED in
235            INTEGER_TYPE, ENUMERAL_TYPE, FIELD_DECL
236        DECL_BUILT_IN_NONANSI in
237            FUNCTION_DECL
238        TREE_PARMLIST in
239            TREE_PARMLIST (C++)
240        SAVE_EXPR_NOPLACEHOLDER in
241            SAVE_EXPR
242
243    asm_written_flag:
244
245        TREE_ASM_WRITTEN in
246            VAR_DECL, FUNCTION_DECL, RECORD_TYPE, UNION_TYPE, QUAL_UNION_TYPE
247            BLOCK
248
249    used_flag:
250
251        TREE_USED in
252            expressions, IDENTIFIER_NODE
253
254    nothrow_flag:
255
256        TREE_NOTHROW in
257            CALL_EXPR, FUNCTION_DECL
258
259    bounded_flag:
260
261        TREE_BOUNDED in
262            expressions, VAR_DECL, PARM_DECL, FIELD_DECL, FUNCTION_DECL
263        TYPE_BOUNDED in
264            ..._TYPE
265 */
266
267 /* Define accessors for the fields that all tree nodes have
268    (though some fields are not used for all kinds of nodes).  */
269
270 /* The tree-code says what kind of node it is.
271    Codes are defined in tree.def.  */
272 #define TREE_CODE(NODE) ((enum tree_code) (NODE)->common.code)
273 #define TREE_SET_CODE(NODE, VALUE) ((NODE)->common.code = (int) (VALUE))
274
275 /* When checking is enabled, errors will be generated if a tree node
276    is accessed incorrectly. The macros abort with a fatal error.  */
277 #if defined ENABLE_TREE_CHECKING && (GCC_VERSION >= 2007)
278
279 #define TREE_CHECK(t, code) __extension__                               \
280 ({  const tree __t = t;                                                 \
281     if (TREE_CODE(__t) != (code))                                       \
282       tree_check_failed (__t, code, __FILE__, __LINE__, __FUNCTION__);  \
283     __t; })
284 #define TREE_CLASS_CHECK(t, class) __extension__                        \
285 ({  const tree __t = t;                                                 \
286     if (TREE_CODE_CLASS(TREE_CODE(__t)) != (class))                     \
287       tree_class_check_failed (__t, class, __FILE__, __LINE__, __FUNCTION__); \
288     __t; })
289
290 /* These checks have to be special cased.  */
291 #define CST_OR_CONSTRUCTOR_CHECK(t) __extension__                       \
292 ({  const tree __t = t;                                                 \
293     enum tree_code __c = TREE_CODE(__t);                                \
294     if (__c != CONSTRUCTOR && TREE_CODE_CLASS(__c) != 'c')              \
295       tree_check_failed (__t, CONSTRUCTOR, __FILE__, __LINE__, __FUNCTION__); \
296     __t; })
297 #define EXPR_CHECK(t) __extension__                                     \
298 ({  const tree __t = t;                                                 \
299     char __c = TREE_CODE_CLASS(TREE_CODE(__t));                         \
300     if (__c != 'r' && __c != 's' && __c != '<'                          \
301         && __c != '1' && __c != '2' && __c != 'e')                      \
302       tree_class_check_failed(__t, 'e', __FILE__, __LINE__, __FUNCTION__); \
303     __t; })
304
305 extern void tree_check_failed PARAMS ((const tree, enum tree_code,
306                                        const char *, int, const char *))
307     ATTRIBUTE_NORETURN;
308 extern void tree_class_check_failed PARAMS ((const tree, int,
309                                              const char *, int, const char *))
310     ATTRIBUTE_NORETURN;
311
312 #else /* not ENABLE_TREE_CHECKING, or not gcc */
313
314 #define TREE_CHECK(t, code)             (t)
315 #define TREE_CLASS_CHECK(t, code)       (t)
316 #define CST_OR_CONSTRUCTOR_CHECK(t)     (t)
317 #define EXPR_CHECK(t)                   (t)
318
319 #endif
320
321 #include "tree-check.h"
322
323 #define TYPE_CHECK(tree)        TREE_CLASS_CHECK  (tree, 't')
324 #define DECL_CHECK(tree)        TREE_CLASS_CHECK  (tree, 'd')
325 #define CST_CHECK(tree)         TREE_CLASS_CHECK  (tree, 'c')
326
327 /* In all nodes that are expressions, this is the data type of the expression.
328    In POINTER_TYPE nodes, this is the type that the pointer points to.
329    In ARRAY_TYPE nodes, this is the type of the elements.
330    In VECTOR_TYPE nodes, this is the type of the elements.  */
331 #define TREE_TYPE(NODE) ((NODE)->common.type)
332
333 /* Nodes are chained together for many purposes.
334    Types are chained together to record them for being output to the debugger
335    (see the function `chain_type').
336    Decls in the same scope are chained together to record the contents
337    of the scope.
338    Statement nodes for successive statements used to be chained together.
339    Often lists of things are represented by TREE_LIST nodes that
340    are chained together.  */
341
342 #define TREE_CHAIN(NODE) ((NODE)->common.chain)
343
344 /* Given an expression as a tree, strip any NON_LVALUE_EXPRs and NOP_EXPRs
345    that don't change the machine mode.  */
346
347 #define STRIP_NOPS(EXP)                                         \
348   while ((TREE_CODE (EXP) == NOP_EXPR                           \
349           || TREE_CODE (EXP) == CONVERT_EXPR                    \
350           || TREE_CODE (EXP) == NON_LVALUE_EXPR)                \
351          && TREE_OPERAND (EXP, 0) != error_mark_node            \
352          && (TYPE_MODE (TREE_TYPE (EXP))                        \
353              == TYPE_MODE (TREE_TYPE (TREE_OPERAND (EXP, 0))))) \
354     (EXP) = TREE_OPERAND (EXP, 0);
355
356 /* Like STRIP_NOPS, but don't let the signedness change either.  */
357
358 #define STRIP_SIGN_NOPS(EXP) \
359   while ((TREE_CODE (EXP) == NOP_EXPR                           \
360           || TREE_CODE (EXP) == CONVERT_EXPR                    \
361           || TREE_CODE (EXP) == NON_LVALUE_EXPR)                \
362          && TREE_OPERAND (EXP, 0) != error_mark_node            \
363          && (TYPE_MODE (TREE_TYPE (EXP))                        \
364              == TYPE_MODE (TREE_TYPE (TREE_OPERAND (EXP, 0))))  \
365          && (TREE_UNSIGNED (TREE_TYPE (EXP))                    \
366              == TREE_UNSIGNED (TREE_TYPE (TREE_OPERAND (EXP, 0))))) \
367     (EXP) = TREE_OPERAND (EXP, 0);
368
369 /* Like STRIP_NOPS, but don't alter the TREE_TYPE either.  */
370
371 #define STRIP_TYPE_NOPS(EXP) \
372   while ((TREE_CODE (EXP) == NOP_EXPR                           \
373           || TREE_CODE (EXP) == CONVERT_EXPR                    \
374           || TREE_CODE (EXP) == NON_LVALUE_EXPR)                \
375          && TREE_OPERAND (EXP, 0) != error_mark_node            \
376          && (TREE_TYPE (EXP)                                    \
377              == TREE_TYPE (TREE_OPERAND (EXP, 0))))             \
378     (EXP) = TREE_OPERAND (EXP, 0);
379
380 /* Nonzero if TYPE represents an integral type.  Note that we do not
381    include COMPLEX types here.  */
382
383 #define INTEGRAL_TYPE_P(TYPE)  \
384   (TREE_CODE (TYPE) == INTEGER_TYPE || TREE_CODE (TYPE) == ENUMERAL_TYPE  \
385    || TREE_CODE (TYPE) == BOOLEAN_TYPE || TREE_CODE (TYPE) == CHAR_TYPE)
386
387 /* Nonzero if TYPE represents a floating-point type, including complex
388    floating-point types.  */
389
390 #define FLOAT_TYPE_P(TYPE)              \
391   (TREE_CODE (TYPE) == REAL_TYPE        \
392    || (TREE_CODE (TYPE) == COMPLEX_TYPE \
393        && TREE_CODE (TREE_TYPE (TYPE)) == REAL_TYPE))
394
395 /* Nonzero if TYPE represents an aggregate (multi-component) type. */
396
397 #define AGGREGATE_TYPE_P(TYPE) \
398   (TREE_CODE (TYPE) == ARRAY_TYPE || TREE_CODE (TYPE) == RECORD_TYPE \
399    || TREE_CODE (TYPE) == UNION_TYPE || TREE_CODE (TYPE) == QUAL_UNION_TYPE \
400    || TREE_CODE (TYPE) == SET_TYPE)
401
402 /* Nonzero if TYPE represents an unbounded pointer or unbounded
403    reference type.  (It should be renamed to INDIRECT_TYPE_P.)  */
404
405 #define POINTER_TYPE_P(TYPE) \
406   (TREE_CODE (TYPE) == POINTER_TYPE || TREE_CODE (TYPE) == REFERENCE_TYPE)
407
408 /* Nonzero if TYPE represents a bounded pointer or bounded reference type.  */
409
410 #define BOUNDED_INDIRECT_TYPE_P(TYPE) \
411   (TREE_CODE (TYPE) == RECORD_TYPE && TREE_TYPE (TYPE))
412
413 /* Nonzero if TYPE represents a bounded pointer type.  */
414
415 #define BOUNDED_POINTER_TYPE_P(TYPE) \
416   (BOUNDED_INDIRECT_TYPE_P (TYPE) \
417    && TREE_CODE (TYPE_BOUNDED_SUBTYPE (TYPE)) == POINTER_TYPE)
418
419 /* Nonzero if TYPE represents a bounded reference type.  Bounded
420    reference types have two specific uses: (1) When a reference is
421    seated to a variable-length RECORD_TYPE that has an array of
422    indeterminate length as its final field.  For all other objects, it
423    is sufficient to check bounds at the time the reference is seated,
424    and assume that all future uses of the reference are safe, since
425    the address of references cannot change.  (2) When a reference
426    supertype is seated to an subtype object.  The bounds "remember"
427    the true size of the complete object, so that subsequent upcasts of
428    the address of the reference will be checked properly (is such a
429    thing valid C++?).  */
430
431 #define BOUNDED_REFERENCE_TYPE_P(TYPE) \
432   (BOUNDED_INDIRECT_TYPE_P (TYPE) \
433    && TREE_CODE (TYPE_BOUNDED_SUBTYPE (TYPE)) == REFERENCE_TYPE)
434
435 /* Nonzero if TYPE represents a pointer or reference type, either
436    bounded or unbounded.  */
437
438 #define MAYBE_BOUNDED_INDIRECT_TYPE_P(TYPE) \
439   (POINTER_TYPE_P (TYPE) || BOUNDED_INDIRECT_TYPE_P (TYPE))
440
441 /* Nonzero if TYPE represents a pointer type, either bounded or unbounded.  */
442
443 #define MAYBE_BOUNDED_POINTER_TYPE_P(TYPE) \
444   (TREE_CODE (TYPE) == POINTER_TYPE || BOUNDED_POINTER_TYPE_P (TYPE))
445
446 /* Nonzero if TYPE represents a reference type, either bounded or unbounded.  */
447
448 #define MAYBE_BOUNDED_REFERENCE_TYPE_P(TYPE) \
449   (TREE_CODE (TYPE) == REFERENCE_TYPE || BOUNDED_REFERENCE_TYPE_P (TYPE))
450
451 /* Nonzero if this type is a complete type.  */
452 #define COMPLETE_TYPE_P(NODE) (TYPE_SIZE (NODE) != NULL_TREE)
453
454 /* Nonzero if this type is the (possibly qualified) void type.  */
455 #define VOID_TYPE_P(NODE) (TREE_CODE (NODE) == VOID_TYPE)
456
457 /* Nonzero if this type is complete or is cv void.  */
458 #define COMPLETE_OR_VOID_TYPE_P(NODE) \
459     (COMPLETE_TYPE_P (NODE) || VOID_TYPE_P (NODE))
460
461 /* Nonzero if this type is complete or is an array with unspecified bound.  */
462 #define COMPLETE_OR_UNBOUND_ARRAY_TYPE_P(NODE) \
463     (COMPLETE_TYPE_P (TREE_CODE (NODE) == ARRAY_TYPE ? TREE_TYPE (NODE) : NODE))
464
465 /* Nonzero if TYPE represents a type.  */
466
467 #define TYPE_P(TYPE)    (TREE_CODE_CLASS (TREE_CODE (TYPE)) == 't')
468 \f
469 /* Define many boolean fields that all tree nodes have.  */
470
471 /* In VAR_DECL nodes, nonzero means address of this is needed.
472    So it cannot be in a register.
473    In a FUNCTION_DECL, nonzero means its address is needed.
474    So it must be compiled even if it is an inline function.
475    In a FIELD_DECL node, it means that the programmer is permitted to
476    construct the address of this field.  This is used for aliasing
477    purposes: see record_component_aliases.
478    In CONSTRUCTOR nodes, it means object constructed must be in memory.
479    In LABEL_DECL nodes, it means a goto for this label has been seen 
480    from a place outside all binding contours that restore stack levels.
481    In ..._TYPE nodes, it means that objects of this type must
482    be fully addressable.  This means that pieces of this
483    object cannot go into register parameters, for example.
484    In IDENTIFIER_NODEs, this means that some extern decl for this name
485    had its address taken.  That matters for inline functions.  */
486 #define TREE_ADDRESSABLE(NODE) ((NODE)->common.addressable_flag)
487
488 /* In a VAR_DECL, nonzero means allocate static storage.
489    In a FUNCTION_DECL, nonzero if function has been defined.
490    In a CONSTRUCTOR, nonzero means allocate static storage.  */
491 #define TREE_STATIC(NODE) ((NODE)->common.static_flag)
492
493 /* In a CONVERT_EXPR, NOP_EXPR or COMPOUND_EXPR, this means the node was
494    made implicitly and should not lead to an "unused value" warning.  */
495 #define TREE_NO_UNUSED_WARNING(NODE) ((NODE)->common.static_flag)
496
497 /* Nonzero for a TREE_LIST or TREE_VEC node means that the derivation
498    chain is via a `virtual' declaration.  */
499 #define TREE_VIA_VIRTUAL(NODE) ((NODE)->common.static_flag)
500
501 /* In an INTEGER_CST, REAL_CST, or COMPLEX_CST, this means there was an
502    overflow in folding.  This is distinct from TREE_OVERFLOW because ANSI C
503    requires a diagnostic when overflows occur in constant expressions.  */
504 #define TREE_CONSTANT_OVERFLOW(NODE) ((NODE)->common.static_flag)
505
506 /* In an IDENTIFIER_NODE, this means that assemble_name was called with
507    this string as an argument.  */
508 #define TREE_SYMBOL_REFERENCED(NODE) ((NODE)->common.static_flag)
509
510 /* In an INTEGER_CST, REAL_CST, of COMPLEX_CST, this means there was an
511    overflow in folding, and no warning has been issued for this subexpression.
512    TREE_OVERFLOW implies TREE_CONSTANT_OVERFLOW, but not vice versa.  */
513 #define TREE_OVERFLOW(NODE) ((NODE)->common.public_flag)
514
515 /* In a VAR_DECL or FUNCTION_DECL,
516    nonzero means name is to be accessible from outside this module.
517    In an identifier node, nonzero means an external declaration
518    accessible from outside this module was previously seen
519    for this name in an inner scope.  */
520 #define TREE_PUBLIC(NODE) ((NODE)->common.public_flag)
521
522 /* Nonzero for TREE_LIST or TREE_VEC node means that the path to the
523    base class is via a `public' declaration, which preserves public
524    fields from the base class as public.  */
525 #define TREE_VIA_PUBLIC(NODE) ((NODE)->common.public_flag)
526
527 /* Ditto, for `private' declarations.  */
528 #define TREE_VIA_PRIVATE(NODE) ((NODE)->common.private_flag)
529
530 /* Nonzero for TREE_LIST node means that the path to the
531    base class is via a `protected' declaration, which preserves
532    protected fields from the base class as protected.
533    OVERLOADED.  */
534 #define TREE_VIA_PROTECTED(NODE) ((NODE)->common.protected_flag)
535
536 /* In any expression, nonzero means it has side effects or reevaluation
537    of the whole expression could produce a different value.
538    This is set if any subexpression is a function call, a side effect
539    or a reference to a volatile variable.
540    In a ..._DECL, this is set only if the declaration said `volatile'.  */
541 #define TREE_SIDE_EFFECTS(NODE) ((NODE)->common.side_effects_flag)
542
543 /* Nonzero means this expression is volatile in the C sense:
544    its address should be of type `volatile WHATEVER *'.
545    In other words, the declared item is volatile qualified.
546    This is used in _DECL nodes and _REF nodes.
547
548    In a ..._TYPE node, means this type is volatile-qualified.
549    But use TYPE_VOLATILE instead of this macro when the node is a type,
550    because eventually we may make that a different bit.
551
552    If this bit is set in an expression, so is TREE_SIDE_EFFECTS.  */
553 #define TREE_THIS_VOLATILE(NODE) ((NODE)->common.volatile_flag)
554
555 /* In a VAR_DECL, PARM_DECL or FIELD_DECL, or any kind of ..._REF node,
556    nonzero means it may not be the lhs of an assignment.
557    In a ..._TYPE node, means this type is const-qualified
558    (but the macro TYPE_READONLY should be used instead of this macro
559    when the node is a type).  */
560 #define TREE_READONLY(NODE) ((NODE)->common.readonly_flag)
561
562 /* Value of expression is constant.
563    Always appears in all ..._CST nodes.
564    May also appear in an arithmetic expression, an ADDR_EXPR or a CONSTRUCTOR
565    if the value is constant.  */
566 #define TREE_CONSTANT(NODE) ((NODE)->common.constant_flag)
567
568 /* Nonzero means permanent node;
569    node will continue to exist for the entire compiler run.
570    Otherwise it will be recycled at the end of the function.
571    This flag is always zero if garbage collection is in use.
572    Try not to use this.  Only set it with TREE_SET_PERMANENT.  */
573 #define TREE_PERMANENT(NODE) ((NODE)->common.permanent_flag)
574 #define TREE_SET_PERMANENT(NODE) do { \
575   if (!ggc_p && current_obstack == &permanent_obstack) \
576     TREE_PERMANENT(NODE) = 1; \
577 } while (0) 
578
579 /* In INTEGER_TYPE or ENUMERAL_TYPE nodes, means an unsigned type.
580    In FIELD_DECL nodes, means an unsigned bit field.
581    The same bit is used in functions as DECL_BUILT_IN_NONANSI.  */
582 #define TREE_UNSIGNED(NODE) ((NODE)->common.unsigned_flag)
583
584 /* Nonzero in a VAR_DECL means assembler code has been written.
585    Nonzero in a FUNCTION_DECL means that the function has been compiled.
586    This is interesting in an inline function, since it might not need
587    to be compiled separately.
588    Nonzero in a RECORD_TYPE, UNION_TYPE, QUAL_UNION_TYPE or ENUMERAL_TYPE
589    if the sdb debugging info for the type has been written.
590    In a BLOCK node, nonzero if reorder_blocks has already seen this block.  */
591 #define TREE_ASM_WRITTEN(NODE) ((NODE)->common.asm_written_flag)
592
593 /* Nonzero in a _DECL if the name is used in its scope.
594    Nonzero in an expr node means inhibit warning if value is unused.
595    In IDENTIFIER_NODEs, this means that some extern decl for this name
596    was used.  */
597 #define TREE_USED(NODE) ((NODE)->common.used_flag)
598
599 /* In a FUNCTION_DECL, nonzero means a call to the function cannot throw
600    an exception.  In a CALL_EXPR, nonzero means the call cannot throw.  */
601 #define TREE_NOTHROW(NODE) ((NODE)->common.nothrow_flag)
602
603 /* Used in classes in C++.  */
604 #define TREE_PRIVATE(NODE) ((NODE)->common.private_flag)
605 /* Used in classes in C++.
606    In a BLOCK node, this is BLOCK_HANDLER_BLOCK.  */
607 #define TREE_PROTECTED(NODE) ((NODE)->common.protected_flag)
608
609 /* In a ..._TYPE node, nonzero means that the type's size and layout,
610    (or the size and layout of its arguments and/or return value in the
611    case of a FUNCTION_TYPE or METHOD_TYPE) was changed by the presence
612    of pointer bounds.  Use TYPE_BOUNDED instead of this macro when the
613    node is a type, because eventually we may make that a different
614    bit.  TYPE_BOUNDED doesn't mean that this type is a bounded indirect
615    type--use BOUNDED_POINTER_TYPE_P, BOUNDED_REFERENCE_TYPE_P,
616    BOUNDED_INDIRECT_TYPE_P to test for that.
617
618    In a FUNCTION_DECL, nonzero means that the size and layout of one
619    of its arguments and/or return value was changed by the presence of
620    pointer bounds.  This value can differ from the value of
621    TYPE_BOUNDED (TREE_TYPE (fundecl)) if the function was implicitly
622    declared, then later called with pointer args, or was declared with
623    a variable argument list and is later called with pointer values in
624    the variable argument list.
625
626    In a VAR_DECL, PARM_DECL or FIELD_DECL, TREE_BOUNDED matches the value
627    of the decl's type's BOUNDED_POINTER_TYPE_P.
628
629    In a CONSTRUCTOR or other expression, nonzero means the value is a
630    bounded pointer.  It is insufficient to determine the boundedness
631    of an expression EXP with BOUNDED_POINTER_TYPE_P (TREE_TYPE (EXP)),
632    since we allow pointer to be temporarily cast to integer for
633    rounding up to an alignment boudary in a way that preserves the
634    pointer's bounds.
635
636    In an IDENTIFIER_NODE, nonzero means that the name is prefixed with
637    BP_PREFIX (see varasm.c).  This occurs for the DECL_ASSEMBLER_NAME
638    of a function that has bounded pointer(s) for its return type and/or
639    argument type(s).  */
640
641 #define TREE_BOUNDED(NODE) ((NODE)->common.bounded_flag)
642
643 /* These flags are available for each language front end to use internally.  */
644 #define TREE_LANG_FLAG_0(NODE) ((NODE)->common.lang_flag_0)
645 #define TREE_LANG_FLAG_1(NODE) ((NODE)->common.lang_flag_1)
646 #define TREE_LANG_FLAG_2(NODE) ((NODE)->common.lang_flag_2)
647 #define TREE_LANG_FLAG_3(NODE) ((NODE)->common.lang_flag_3)
648 #define TREE_LANG_FLAG_4(NODE) ((NODE)->common.lang_flag_4)
649 #define TREE_LANG_FLAG_5(NODE) ((NODE)->common.lang_flag_5)
650 #define TREE_LANG_FLAG_6(NODE) ((NODE)->common.lang_flag_6)
651 \f
652 /* Define additional fields and accessors for nodes representing constants.  */
653
654 /* In an INTEGER_CST node.  These two together make a 2-word integer.
655    If the data type is signed, the value is sign-extended to 2 words
656    even though not all of them may really be in use.
657    In an unsigned constant shorter than 2 words, the extra bits are 0.  */
658 #define TREE_INT_CST_LOW(NODE) (INTEGER_CST_CHECK (NODE)->int_cst.int_cst_low)
659 #define TREE_INT_CST_HIGH(NODE) (INTEGER_CST_CHECK (NODE)->int_cst.int_cst_high)
660
661 #define INT_CST_LT(A, B)  \
662 (TREE_INT_CST_HIGH (A) < TREE_INT_CST_HIGH (B)                  \
663  || (TREE_INT_CST_HIGH (A) == TREE_INT_CST_HIGH (B)             \
664      && TREE_INT_CST_LOW (A) < TREE_INT_CST_LOW (B)))
665
666 #define INT_CST_LT_UNSIGNED(A, B)  \
667 (((unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (A)        \
668   < (unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (B))     \
669  || (((unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (A)    \
670       == (unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (B)) \
671      && TREE_INT_CST_LOW (A) < TREE_INT_CST_LOW (B)))
672
673 struct tree_int_cst
674 {
675   struct tree_common common;
676   struct rtx_def *rtl;  /* acts as link to register transfer language
677                            (rtl) info */
678   unsigned HOST_WIDE_INT int_cst_low;
679   HOST_WIDE_INT int_cst_high;
680 };
681
682 /* In REAL_CST, STRING_CST, COMPLEX_CST nodes, and CONSTRUCTOR nodes,
683    and generally in all kinds of constants that could
684    be given labels (rather than being immediate).  */
685
686 #define TREE_CST_RTL(NODE) (CST_OR_CONSTRUCTOR_CHECK (NODE)->real_cst.rtl)
687
688 /* In a REAL_CST node.  */
689 /* We can represent a real value as either a `double' or a string.
690    Strings don't allow for any optimization, but they do allow
691    for cross-compilation.  */
692
693 #define TREE_REAL_CST(NODE) (REAL_CST_CHECK (NODE)->real_cst.real_cst)
694
695 #include "real.h"
696
697 struct tree_real_cst
698 {
699   struct tree_common common;
700   struct rtx_def *rtl;  /* acts as link to register transfer language
701                                    (rtl) info */
702   REAL_VALUE_TYPE real_cst;
703 };
704
705 /* In a STRING_CST */
706 #define TREE_STRING_LENGTH(NODE) (STRING_CST_CHECK (NODE)->string.length)
707 #define TREE_STRING_POINTER(NODE) (STRING_CST_CHECK (NODE)->string.pointer)
708
709 struct tree_string
710 {
711   struct tree_common common;
712   struct rtx_def *rtl;  /* acts as link to register transfer language
713                                    (rtl) info */
714   int length;
715   char *pointer;
716 };
717
718 /* In a COMPLEX_CST node.  */
719 #define TREE_REALPART(NODE) (COMPLEX_CST_CHECK (NODE)->complex.real)
720 #define TREE_IMAGPART(NODE) (COMPLEX_CST_CHECK (NODE)->complex.imag)
721
722 struct tree_complex
723 {
724   struct tree_common common;
725   struct rtx_def *rtl;  /* acts as link to register transfer language
726                                    (rtl) info */
727   union tree_node *real;
728   union tree_node *imag;
729 };
730 \f
731 /* Define fields and accessors for some special-purpose tree nodes.  */
732
733 #define IDENTIFIER_LENGTH(NODE) (IDENTIFIER_NODE_CHECK (NODE)->identifier.length)
734 #define IDENTIFIER_POINTER(NODE) (IDENTIFIER_NODE_CHECK (NODE)->identifier.pointer)
735
736 struct tree_identifier
737 {
738   struct tree_common common;
739   int length;
740   char *pointer;
741 };
742
743 /* In a TREE_LIST node.  */
744 #define TREE_PURPOSE(NODE) (TREE_LIST_CHECK (NODE)->list.purpose)
745 #define TREE_VALUE(NODE) (TREE_LIST_CHECK (NODE)->list.value)
746
747 struct tree_list
748 {
749   struct tree_common common;
750   union tree_node *purpose;
751   union tree_node *value;
752 };
753
754 /* In a TREE_VEC node.  */
755 #define TREE_VEC_LENGTH(NODE) (TREE_VEC_CHECK (NODE)->vec.length)
756 #define TREE_VEC_ELT(NODE,I) (TREE_VEC_CHECK (NODE)->vec.a[I])
757 #define TREE_VEC_END(NODE) ((void) TREE_VEC_CHECK (NODE),&((NODE)->vec.a[(NODE)->vec.length]))
758
759 struct tree_vec
760 {
761   struct tree_common common;
762   int length;
763   union tree_node *a[1];
764 };
765
766 /* Define fields and accessors for some nodes that represent expressions.  */
767
768 /* In a SAVE_EXPR node.  */
769 #define SAVE_EXPR_CONTEXT(NODE) TREE_OPERAND(NODE, 1)
770 #define SAVE_EXPR_RTL(NODE) (*(struct rtx_def **) &EXPR_CHECK (NODE)->exp.operands[2])
771 #define SAVE_EXPR_NOPLACEHOLDER(NODE) TREE_UNSIGNED (NODE)
772 /* Nonzero if the SAVE_EXPRs value should be kept, even if it occurs
773    both in normal code and in a handler.  (Normally, in a handler, all
774    SAVE_EXPRs are unsaved, meaning that there values are
775    recalculated.)  */
776 #define SAVE_EXPR_PERSISTENT_P(NODE) TREE_ASM_WRITTEN (NODE)
777
778 /* In a RTL_EXPR node.  */
779 #define RTL_EXPR_SEQUENCE(NODE) (*(struct rtx_def **) &EXPR_CHECK (NODE)->exp.operands[0])
780 #define RTL_EXPR_RTL(NODE) (*(struct rtx_def **) &EXPR_CHECK (NODE)->exp.operands[1])
781
782 /* In a CALL_EXPR node.  */
783 #define CALL_EXPR_RTL(NODE) (*(struct rtx_def **) &EXPR_CHECK (NODE)->exp.operands[2])
784
785 /* In a CONSTRUCTOR node.  */
786 #define CONSTRUCTOR_ELTS(NODE) TREE_OPERAND (NODE, 1)
787
788 /* In ordinary expression nodes.  */
789 #define TREE_OPERAND(NODE, I) (EXPR_CHECK (NODE)->exp.operands[I])
790 #define TREE_COMPLEXITY(NODE) (EXPR_CHECK (NODE)->exp.complexity)
791
792 /* In a LABELED_BLOCK_EXPR node.  */
793 #define LABELED_BLOCK_LABEL(NODE) TREE_OPERAND (NODE, 0)
794 #define LABELED_BLOCK_BODY(NODE) TREE_OPERAND (NODE, 1)
795
796 /* In a EXIT_BLOCK_EXPR node.  */
797 #define EXIT_BLOCK_LABELED_BLOCK(NODE) TREE_OPERAND (NODE, 0)
798 #define EXIT_BLOCK_RETURN(NODE) TREE_OPERAND (NODE, 1)
799
800 /* In a LOOP_EXPR node.  */
801 #define LOOP_EXPR_BODY(NODE) TREE_OPERAND (NODE, 0)
802
803 /* In a EXPR_WITH_FILE_LOCATION node.  */
804 #define EXPR_WFL_NODE(NODE) TREE_OPERAND((NODE), 0)
805 #define EXPR_WFL_FILENAME(NODE) \
806   (IDENTIFIER_POINTER (EXPR_WFL_FILENAME_NODE ((NODE))))
807 #define EXPR_WFL_FILENAME_NODE(NODE) TREE_OPERAND((NODE), 1)
808 #define EXPR_WFL_LINENO(NODE) (EXPR_CHECK (NODE)->exp.complexity >> 12)
809 #define EXPR_WFL_COLNO(NODE) (EXPR_CHECK (NODE)->exp.complexity & 0xfff)
810 #define EXPR_WFL_LINECOL(NODE) (EXPR_CHECK (NODE)->exp.complexity)
811 #define EXPR_WFL_SET_LINECOL(NODE, LINE, COL) \
812   (EXPR_WFL_LINECOL(NODE) = ((LINE) << 12) | ((COL) & 0xfff))
813 #define EXPR_WFL_EMIT_LINE_NOTE(NODE) ((NODE)->common.public_flag)
814
815 struct tree_exp
816 {
817   struct tree_common common;
818   int complexity;
819   union tree_node *operands[1];
820 };
821 \f
822 /* In a BLOCK node.  */
823 #define BLOCK_VARS(NODE) (BLOCK_CHECK (NODE)->block.vars)
824 #define BLOCK_SUBBLOCKS(NODE) (BLOCK_CHECK (NODE)->block.subblocks)
825 #define BLOCK_SUPERCONTEXT(NODE) (BLOCK_CHECK (NODE)->block.supercontext)
826 /* Note: when changing this, make sure to find the places
827    that use chainon or nreverse.  */
828 #define BLOCK_CHAIN(NODE) TREE_CHAIN (NODE)
829 #define BLOCK_ABSTRACT_ORIGIN(NODE) (BLOCK_CHECK (NODE)->block.abstract_origin)
830 #define BLOCK_ABSTRACT(NODE) (BLOCK_CHECK (NODE)->block.abstract_flag)
831
832 /* Nonzero means that this block is prepared to handle exceptions
833    listed in the BLOCK_VARS slot.  */
834 #define BLOCK_HANDLER_BLOCK(NODE) (BLOCK_CHECK (NODE)->block.handler_block_flag)
835
836 /* An index number for this block.  These values are not guaranteed to
837    be unique across functions -- whether or not they are depends on
838    the debugging output format in use.  */
839 #define BLOCK_NUMBER(NODE) (BLOCK_CHECK (NODE)->block.block_num)
840
841 struct tree_block
842 {
843   struct tree_common common;
844
845   unsigned handler_block_flag : 1;
846   unsigned abstract_flag : 1;
847   unsigned block_num : 30;
848
849   union tree_node *vars;
850   union tree_node *subblocks;
851   union tree_node *supercontext;
852   union tree_node *abstract_origin;
853 };
854 \f
855 /* Define fields and accessors for nodes representing data types.  */
856
857 /* See tree.def for documentation of the use of these fields.
858    Look at the documentation of the various ..._TYPE tree codes.  */
859
860 #define TYPE_UID(NODE) (TYPE_CHECK (NODE)->type.uid)
861 #define TYPE_SIZE(NODE) (TYPE_CHECK (NODE)->type.size)
862 #define TYPE_SIZE_UNIT(NODE) (TYPE_CHECK (NODE)->type.size_unit)
863 #define TYPE_MODE(NODE) (TYPE_CHECK (NODE)->type.mode)
864 #define TYPE_VALUES(NODE) (TYPE_CHECK (NODE)->type.values)
865 #define TYPE_DOMAIN(NODE) (TYPE_CHECK (NODE)->type.values)
866 #define TYPE_FIELDS(NODE) (TYPE_CHECK (NODE)->type.values)
867 #define TYPE_METHODS(NODE) (TYPE_CHECK (NODE)->type.maxval)
868 #define TYPE_VFIELD(NODE) (TYPE_CHECK (NODE)->type.minval)
869 #define TYPE_ARG_TYPES(NODE) (TYPE_CHECK (NODE)->type.values)
870 #define TYPE_METHOD_BASETYPE(NODE) (TYPE_CHECK (NODE)->type.maxval)
871 #define TYPE_OFFSET_BASETYPE(NODE) (TYPE_CHECK (NODE)->type.maxval)
872 #define TYPE_POINTER_TO(NODE) (TYPE_CHECK (NODE)->type.pointer_to)
873 #define TYPE_REFERENCE_TO(NODE) (TYPE_CHECK (NODE)->type.reference_to)
874 #define TYPE_MIN_VALUE(NODE) (TYPE_CHECK (NODE)->type.minval)
875 #define TYPE_MAX_VALUE(NODE) (TYPE_CHECK (NODE)->type.maxval)
876 #define TYPE_PRECISION(NODE) (TYPE_CHECK (NODE)->type.precision)
877 #define TYPE_SYMTAB_ADDRESS(NODE) (TYPE_CHECK (NODE)->type.symtab.address)
878 #define TYPE_SYMTAB_POINTER(NODE) (TYPE_CHECK (NODE)->type.symtab.pointer)
879 #define TYPE_NAME(NODE) (TYPE_CHECK (NODE)->type.name)
880 #define TYPE_NEXT_VARIANT(NODE) (TYPE_CHECK (NODE)->type.next_variant)
881 #define TYPE_MAIN_VARIANT(NODE) (TYPE_CHECK (NODE)->type.main_variant)
882 #define TYPE_NONCOPIED_PARTS(NODE) (TYPE_CHECK (NODE)->type.noncopied_parts)
883 #define TYPE_CONTEXT(NODE) (TYPE_CHECK (NODE)->type.context)
884 #define TYPE_OBSTACK(NODE) (TYPE_CHECK (NODE)->type.obstack)
885 #define TYPE_LANG_SPECIFIC(NODE) (TYPE_CHECK (NODE)->type.lang_specific)
886
887 /* For a VECTOR_TYPE node, this describes a different type which is emitted
888    in the debugging output.  We use this to describe a vector as a
889    structure containing an array.  */
890 #define TYPE_DEBUG_REPRESENTATION_TYPE(NODE) (TYPE_CHECK (NODE)->type.values)
891
892 /* Indirect types present difficulties because they may be represented
893    as either POINTER_TYPE/REFERENCE_TYPE nodes (unbounded) or as
894    RECORD_TYPE nodes (bounded).  Bounded and unbounded pointers might
895    be logically equivalent, but physically different.  Simple
896    comparison of the main variant only tells if the types are
897    logically equivalent.  Use this predicate to compare for physical
898    equivalency.  */
899
900 /* Types have the same main variant, and have the same boundedness.  */
901 #define TYPE_MAIN_VARIANTS_PHYSICALLY_EQUAL_P(TYPE1, TYPE2)     \
902   (TYPE_MAIN_VARIANT (TYPE1) == TYPE_MAIN_VARIANT (TYPE2)       \
903    && TREE_CODE (TYPE1) == TREE_CODE (TYPE2))
904
905 /* Return the type variant that has no qualifiers (i.e., the main variant),
906    except that the boundedness qualifier is preserved.  */
907 #define TYPE_MAIN_PHYSICAL_VARIANT(TYPE)                \
908   (BOUNDED_POINTER_TYPE_P (TYPE)                        \
909    ? build_qualified_type (TYPE, TYPE_QUAL_BOUNDED)     \
910    : TYPE_MAIN_VARIANT (TYPE))
911
912 /* For aggregate types, information about this type, as a base type
913    for itself.  Used in a language-dependent way for types that are
914    neither a RECORD_TYPE, QUAL_UNION_TYPE, nor a UNION_TYPE.  */
915 #define TYPE_BINFO(NODE) (TYPE_CHECK (NODE)->type.binfo)
916
917 /* The (language-specific) typed-based alias set for this type.
918    Objects whose TYPE_ALIAS_SETs are different cannot alias each
919    other.  If the TYPE_ALIAS_SET is -1, no alias set has yet been
920    assigned to this type.  If the TYPE_ALIAS_SET is 0, objects of this
921    type can alias objects of any type.  */
922 #define TYPE_ALIAS_SET(NODE) (TYPE_CHECK (NODE)->type.alias_set)
923
924 /* Nonzero iff the typed-based alias set for this type has been
925    calculated.  */
926 #define TYPE_ALIAS_SET_KNOWN_P(NODE) \
927   (TYPE_CHECK (NODE)->type.alias_set != -1)
928
929 /* A TREE_LIST of IDENTIFIER nodes of the attributes that apply
930    to this type.  */
931 #define TYPE_ATTRIBUTES(NODE) (TYPE_CHECK (NODE)->type.attributes)
932
933 /* The alignment necessary for objects of this type.
934    The value is an int, measured in bits.  */
935 #define TYPE_ALIGN(NODE) (TYPE_CHECK (NODE)->type.align)
936
937 /* 1 if the alignment for this type was requested by "aligned" attribute,
938    0 if it is the default for this type.  */
939 #define TYPE_USER_ALIGN(NODE) (TYPE_CHECK (NODE)->type.user_align)
940
941 /* The alignment for NODE, in bytes.  */
942 #define TYPE_ALIGN_UNIT(NODE) \
943   (TYPE_ALIGN (NODE) / BITS_PER_UNIT)
944
945 #define TYPE_STUB_DECL(NODE) (TREE_CHAIN (NODE))
946
947 /* In a RECORD_TYPE, UNION_TYPE or QUAL_UNION_TYPE, it means the type
948    has BLKmode only because it lacks the alignment requirement for
949    its size.  */
950 #define TYPE_NO_FORCE_BLK(NODE) (TYPE_CHECK (NODE)->type.no_force_blk_flag)
951
952 /* In an INTEGER_TYPE, it means the type represents a size.  We use this
953    both for validity checking and to permit optimziations that are unsafe
954    for other types.  */
955 #define TYPE_IS_SIZETYPE(NODE) \
956   (INTEGER_TYPE_CHECK (NODE)->type.no_force_blk_flag)
957
958 /* In a FUNCTION_TYPE, indicates that the function returns with the stack
959    pointer depressed.  */
960 #define TYPE_RETURNS_STACK_DEPRESSED(NODE) \
961   (FUNCTION_TYPE_CHECK (NODE)->type.no_force_blk_flag)
962
963 /* Nonzero in a type considered volatile as a whole.  */
964 #define TYPE_VOLATILE(NODE) ((NODE)->common.volatile_flag)
965
966 /* Means this type is const-qualified.  */
967 #define TYPE_READONLY(NODE) ((NODE)->common.readonly_flag)
968
969 /* If nonzero, this type is `restrict'-qualified, in the C sense of
970    the term.  */
971 #define TYPE_RESTRICT(NODE) (TYPE_CHECK (NODE)->type.restrict_flag)
972
973 /* If nonzero, this type's size and layout, (or the size and layout of
974    its arguments and/or return value in the case of a FUNCTION_TYPE or
975    METHOD_TYPE) was changed by the presence of pointer bounds.  */
976 #define TYPE_BOUNDED(NODE) (TYPE_CHECK (NODE)->common.bounded_flag)
977
978 /* There is a TYPE_QUAL value for each type qualifier.  They can be
979    combined by bitwise-or to form the complete set of qualifiers for a
980    type.  */
981
982 #define TYPE_UNQUALIFIED   0x0
983 #define TYPE_QUAL_CONST    0x1
984 #define TYPE_QUAL_VOLATILE 0x2
985 #define TYPE_QUAL_RESTRICT 0x4
986 #define TYPE_QUAL_BOUNDED  0x8
987
988 /* The set of type qualifiers for this type.  */
989 #define TYPE_QUALS(NODE)                                        \
990   ((TYPE_READONLY (NODE) * TYPE_QUAL_CONST)                     \
991    | (TYPE_VOLATILE (NODE) * TYPE_QUAL_VOLATILE)                \
992    | (TYPE_RESTRICT (NODE) * TYPE_QUAL_RESTRICT)                \
993    | (BOUNDED_INDIRECT_TYPE_P (NODE) * TYPE_QUAL_BOUNDED))
994
995 /* The set of qualifiers pertinent to an expression node.  */
996 #define TREE_EXPR_QUALS(NODE)                           \
997   ((TREE_READONLY (NODE) * TYPE_QUAL_CONST)             \
998    | (TREE_THIS_VOLATILE (NODE) * TYPE_QUAL_VOLATILE)   \
999    | (TREE_BOUNDED (NODE) * TYPE_QUAL_BOUNDED))
1000
1001 /* The set of qualifiers pertinent to a FUNCTION_DECL node.  */
1002 #define TREE_FUNC_QUALS(NODE)                           \
1003   ((TREE_READONLY (NODE) * TYPE_QUAL_CONST)             \
1004    | (TREE_THIS_VOLATILE (NODE) * TYPE_QUAL_VOLATILE))
1005
1006 /* These flags are available for each language front end to use internally.  */
1007 #define TYPE_LANG_FLAG_0(NODE) (TYPE_CHECK (NODE)->type.lang_flag_0)
1008 #define TYPE_LANG_FLAG_1(NODE) (TYPE_CHECK (NODE)->type.lang_flag_1)
1009 #define TYPE_LANG_FLAG_2(NODE) (TYPE_CHECK (NODE)->type.lang_flag_2)
1010 #define TYPE_LANG_FLAG_3(NODE) (TYPE_CHECK (NODE)->type.lang_flag_3)
1011 #define TYPE_LANG_FLAG_4(NODE) (TYPE_CHECK (NODE)->type.lang_flag_4)
1012 #define TYPE_LANG_FLAG_5(NODE) (TYPE_CHECK (NODE)->type.lang_flag_5)
1013 #define TYPE_LANG_FLAG_6(NODE) (TYPE_CHECK (NODE)->type.lang_flag_6)
1014
1015 /* If set in an ARRAY_TYPE, indicates a string type (for languages
1016    that distinguish string from array of char).
1017    If set in a SET_TYPE, indicates a bitstring type. */
1018 #define TYPE_STRING_FLAG(NODE) (TYPE_CHECK (NODE)->type.string_flag)
1019
1020 /* If non-NULL, this is a upper bound of the size (in bytes) of an
1021    object of the given ARRAY_TYPE.  This allows temporaries to be allocated. */
1022 #define TYPE_ARRAY_MAX_SIZE(ARRAY_TYPE) TYPE_MAX_VALUE (ARRAY_TYPE)
1023
1024 /* For a VECTOR_TYPE, this is the number of sub-parts of the vector.  */
1025 #define TYPE_VECTOR_SUBPARTS(VECTOR_TYPE) (GET_MODE_NUNITS (TYPE_CHECK (VECTOR_TYPE)->type.mode))
1026
1027   /* Indicates that objects of this type must be initialized by calling a
1028    function when they are created.  */
1029 #define TYPE_NEEDS_CONSTRUCTING(NODE) \
1030   (TYPE_CHECK (NODE)->type.needs_constructing_flag)
1031
1032 /* Indicates that objects of this type (a UNION_TYPE), should be passed
1033    the same way that the first union alternative would be passed.  */
1034 #define TYPE_TRANSPARENT_UNION(NODE)  \
1035   (UNION_TYPE_CHECK (NODE)->type.transparent_union_flag)
1036
1037 /* For an ARRAY_TYPE, indicates that it is not permitted to
1038    take the address of a component of the type.  */
1039 #define TYPE_NONALIASED_COMPONENT(NODE) \
1040   (ARRAY_TYPE_CHECK (NODE)->type.transparent_union_flag)
1041
1042 /* Indicated that objects of this type should be laid out in as
1043    compact a way as possible.  */
1044 #define TYPE_PACKED(NODE) (TYPE_CHECK (NODE)->type.packed_flag)
1045
1046 /* A bounded pointer or bounded reference type (collectively called
1047    indirect types) is represented as a RECORD_TYPE node containing
1048    three pointer fields whose type is the corresponding unbounded
1049    POINTER_TYPE or REFERENCE_TYPE.  A RECORD_TYPE node that represents
1050    a bounded indirect type differs from a normal RECORD_TYPE node in
1051    that its TREE_TYPE is non-NULL and has the pointed-to type just as
1052    a POINTER_TYPE or REFERENCE_TYPE node has.  The bounded RECORD_TYPE
1053    nodes are stored on the same type variant chain alongside the
1054    variants of the underlaying indirect types nodes.  The main variant
1055    of such chains is always the unbounded type.  */
1056
1057 /* Access the field decls of a bounded-pointer type.  */
1058 #define TYPE_BOUNDED_VALUE(TYPE) TYPE_FIELDS (TYPE)
1059 #define TYPE_BOUNDED_BASE(TYPE) TREE_CHAIN (TYPE_BOUNDED_VALUE (TYPE))
1060 #define TYPE_BOUNDED_EXTENT(TYPE) TREE_CHAIN (TYPE_BOUNDED_BASE (TYPE))
1061
1062 /* Access the simple-pointer subtype of a bounded-pointer type.  */
1063 #define TYPE_BOUNDED_SUBTYPE(TYPE) TREE_TYPE (TYPE_BOUNDED_VALUE (TYPE))
1064
1065 /* Find the unbounded counterpart to a type, or return TYPE if it is
1066    already unbounded.  */
1067 #define TYPE_UNBOUNDED_VARIANT(TYPE) \
1068   (BOUNDED_POINTER_TYPE_P (TYPE) ? TYPE_BOUNDED_SUBTYPE (TYPE) : (TYPE))
1069
1070 /* This field comprises two bits, for values in the range 0..3:
1071
1072    depth=0 means that type is a scalar, or an aggregate that contains
1073    only depth=0 types, or a function that has only depth=0 types for
1074    its return value and argument types.
1075
1076    depth=1 means that type is a pointer to a depth=0 type, or an
1077    aggregate that contains only depth=0 and depth=1 types, or a
1078    function that has only depth=0 and depth=1 types for its return
1079    value and argument types.
1080
1081    The meanings of depth=2 and depth=3 are obvious by induction.
1082    Varargs functions are depth=3.  The type `va_list' is depth=3.
1083
1084    The purpose of measuring pointer depth of a type is to determine
1085    the eligibility of a function for an automatically-generated
1086    bounded-pointer thunk.  A depth=0 functions needs no thunk.  A
1087    depth=1 function is eligible for an automatic thunk.  Functions
1088    with depth 2 or more are too complex to get automatic thunks.
1089
1090    Function decls also have a pointer_depth field, since we also
1091    consider the actual argument types for functions.  */
1092
1093 #define TYPE_POINTER_DEPTH(TYPE) (TYPE_CHECK (TYPE)->type.pointer_depth)
1094
1095 /* In a FUNCTION_TYPE node, this bit stores the value of
1096    default_pointer_boundedness at the time TYPE was created.  It is
1097    useful for choosing default boundedness of function arguments for
1098    non-prototype function decls and for varargs/stdarg lists.  */
1099 #define TYPE_AMBIENT_BOUNDEDNESS(TYPE) \
1100   (FUNCTION_TYPE_CHECK (TYPE)->type.transparent_union_flag)
1101
1102 #define MAX_POINTER_DEPTH 2
1103 #define VA_LIST_POINTER_DEPTH 3
1104
1105 struct tree_type
1106 {
1107   struct tree_common common;
1108   union tree_node *values;
1109   union tree_node *size;
1110   union tree_node *size_unit;
1111   union tree_node *attributes;
1112   unsigned int uid;
1113
1114   unsigned int precision : 9;
1115   ENUM_BITFIELD(machine_mode) mode : 7;
1116
1117   unsigned string_flag : 1;
1118   unsigned no_force_blk_flag : 1;
1119   unsigned needs_constructing_flag : 1;
1120   unsigned transparent_union_flag : 1;
1121   unsigned packed_flag : 1;
1122   unsigned restrict_flag : 1;
1123   unsigned pointer_depth : 2;
1124
1125   unsigned lang_flag_0 : 1;
1126   unsigned lang_flag_1 : 1;
1127   unsigned lang_flag_2 : 1;
1128   unsigned lang_flag_3 : 1;
1129   unsigned lang_flag_4 : 1;
1130   unsigned lang_flag_5 : 1;
1131   unsigned lang_flag_6 : 1;
1132   unsigned user_align : 1;
1133
1134   unsigned int align;
1135   union tree_node *pointer_to;
1136   union tree_node *reference_to;
1137   union {int address; char *pointer; } symtab;
1138   union tree_node *name;
1139   union tree_node *minval;
1140   union tree_node *maxval;
1141   union tree_node *next_variant;
1142   union tree_node *main_variant;
1143   union tree_node *binfo;
1144   union tree_node *noncopied_parts;
1145   union tree_node *context;
1146   struct obstack *obstack;
1147   HOST_WIDE_INT alias_set;
1148   /* Points to a structure whose details depend on the language in use.  */
1149   struct lang_type *lang_specific;
1150 };
1151 \f
1152 /* Define accessor macros for information about type inheritance
1153    and basetypes.
1154
1155    A "basetype" means a particular usage of a data type for inheritance
1156    in another type.  Each such basetype usage has its own "binfo"
1157    object to describe it.  The binfo object is a TREE_VEC node.
1158
1159    Inheritance is represented by the binfo nodes allocated for a
1160    given type.  For example, given types C and D, such that D is
1161    inherited by C, 3 binfo nodes will be allocated: one for describing
1162    the binfo properties of C, similarly one for D, and one for
1163    describing the binfo properties of D as a base type for C.
1164    Thus, given a pointer to class C, one can get a pointer to the binfo
1165    of D acting as a basetype for C by looking at C's binfo's basetypes.  */
1166
1167 /* The actual data type node being inherited in this basetype.  */
1168 #define BINFO_TYPE(NODE) TREE_TYPE (NODE)
1169
1170 /* The offset where this basetype appears in its containing type.
1171    BINFO_OFFSET slot holds the offset (in bytes)
1172    from the base of the complete object to the base of the part of the
1173    object that is allocated on behalf of this `type'.
1174    This is always 0 except when there is multiple inheritance.  */
1175    
1176 #define BINFO_OFFSET(NODE) TREE_VEC_ELT ((NODE), 1)
1177 #define TYPE_BINFO_OFFSET(NODE) BINFO_OFFSET (TYPE_BINFO (NODE))
1178 #define BINFO_OFFSET_ZEROP(NODE) (integer_zerop (BINFO_OFFSET (NODE)))
1179
1180 /* The virtual function table belonging to this basetype.  Virtual
1181    function tables provide a mechanism for run-time method dispatching.
1182    The entries of a virtual function table are language-dependent.  */
1183
1184 #define BINFO_VTABLE(NODE) TREE_VEC_ELT ((NODE), 2)
1185 #define TYPE_BINFO_VTABLE(NODE) BINFO_VTABLE (TYPE_BINFO (NODE))
1186
1187 /* The virtual functions in the virtual function table.  This is
1188    a TREE_LIST that is used as an initial approximation for building
1189    a virtual function table for this basetype.  */
1190 #define BINFO_VIRTUALS(NODE) TREE_VEC_ELT ((NODE), 3)
1191 #define TYPE_BINFO_VIRTUALS(NODE) BINFO_VIRTUALS (TYPE_BINFO (NODE))
1192
1193 /* A vector of binfos for the direct basetypes inherited by this
1194    basetype.
1195
1196    If this basetype describes type D as inherited in C, and if the
1197    basetypes of D are E and F, then this vector contains binfos for
1198    inheritance of E and F by C.
1199
1200    ??? This could probably be done by just allocating the
1201    base types at the end of this TREE_VEC (instead of using
1202    another TREE_VEC).  This would simplify the calculation
1203    of how many basetypes a given type had.  */
1204 #define BINFO_BASETYPES(NODE) TREE_VEC_ELT ((NODE), 4)
1205 #define TYPE_BINFO_BASETYPES(NODE) TREE_VEC_ELT (TYPE_BINFO (NODE), 4)
1206
1207 /* The number of basetypes for NODE.  */
1208 #define BINFO_N_BASETYPES(NODE) \
1209   (BINFO_BASETYPES (NODE) ? TREE_VEC_LENGTH (BINFO_BASETYPES (NODE)) : 0)
1210
1211 /* Accessor macro to get to the Nth basetype of this basetype.  */
1212 #define BINFO_BASETYPE(NODE,N) TREE_VEC_ELT (BINFO_BASETYPES (NODE), (N))
1213 #define TYPE_BINFO_BASETYPE(NODE,N) BINFO_TYPE (TREE_VEC_ELT (BINFO_BASETYPES (TYPE_BINFO (NODE)), (N)))
1214
1215 /* For a BINFO record describing a virtual base class, i.e., one where
1216    TREE_VIA_VIRTUAL is set, this field assists in locating the virtual
1217    base.  The actual contents are language-dependent.  Under the old
1218    ABI, the C++ front-end uses a FIELD_DECL whose contents are a
1219    pointer to the virtual base; under the new ABI this field is
1220    instead a INTEGER_CST giving an offset into the vtable where the
1221    offset to the virtual base can be found.  */
1222 #define BINFO_VPTR_FIELD(NODE) TREE_VEC_ELT ((NODE), 5)
1223
1224 /* The size of a base class subobject of this type.  Not all frontends
1225    currently allocate the space for these fields.  */
1226 #define BINFO_SIZE(NODE) TREE_VEC_ELT ((NODE), 6)
1227 #define BINFO_SIZE_UNIT(NODE) TREE_VEC_ELT ((NODE), 7)
1228 #define TYPE_BINFO_SIZE(NODE) BINFO_SIZE (TYPE_BINFO (NODE))
1229 #define TYPE_BINFO_SIZE_UNIT(NODE) BINFO_SIZE_UNIT (TYPE_BINFO (NODE))
1230
1231 /* Slot used to build a chain that represents a use of inheritance.
1232    For example, if X is derived from Y, and Y is derived from Z,
1233    then this field can be used to link the binfo node for X to
1234    the binfo node for X's Y to represent the use of inheritance
1235    from X to Y.  Similarly, this slot of the binfo node for X's Y
1236    can point to the Z from which Y is inherited (in X's inheritance
1237    hierarchy).  In this fashion, one can represent and traverse specific
1238    uses of inheritance using the binfo nodes themselves (instead of
1239    consing new space pointing to binfo nodes).
1240    It is up to the language-dependent front-ends to maintain
1241    this information as necessary.  */
1242 #define BINFO_INHERITANCE_CHAIN(NODE) TREE_VEC_ELT ((NODE), 0)
1243 \f
1244 /* Define fields and accessors for nodes representing declared names.  */
1245
1246 /* Nonzero if DECL represents a decl.  */
1247 #define DECL_P(DECL)    (TREE_CODE_CLASS (TREE_CODE (DECL)) == 'd')
1248 /* This is the name of the object as written by the user.
1249    It is an IDENTIFIER_NODE.  */
1250 #define DECL_NAME(NODE) (DECL_CHECK (NODE)->decl.name)
1251 /* This is the name of the object as the assembler will see it
1252    (but before any translations made by ASM_OUTPUT_LABELREF).
1253    Often this is the same as DECL_NAME.
1254    It is an IDENTIFIER_NODE.  */
1255 #define DECL_ASSEMBLER_NAME(NODE) (DECL_CHECK (NODE)->decl.assembler_name)
1256 /* Records the section name in a section attribute.  Used to pass
1257    the name from decl_attributes to make_function_rtl and make_decl_rtl.  */
1258 #define DECL_SECTION_NAME(NODE) (DECL_CHECK (NODE)->decl.section_name)
1259 /*  For FIELD_DECLs, this is the
1260     RECORD_TYPE, UNION_TYPE, or QUAL_UNION_TYPE node that the field is
1261     a member of.  For VAR_DECL, PARM_DECL, FUNCTION_DECL, LABEL_DECL,
1262     and CONST_DECL nodes, this points to either the FUNCTION_DECL for the
1263     containing function, the RECORD_TYPE or UNION_TYPE for the containing
1264     type, or NULL_TREE if the given decl has "file scope".  */
1265 #define DECL_CONTEXT(NODE) (DECL_CHECK (NODE)->decl.context)
1266 #define DECL_FIELD_CONTEXT(NODE) (FIELD_DECL_CHECK (NODE)->decl.context)
1267 /* In a DECL this is the field where configuration dependent machine
1268    attributes are store */
1269 #define DECL_MACHINE_ATTRIBUTES(NODE) (DECL_CHECK (NODE)->decl.machine_attributes)
1270 /* In a FIELD_DECL, this is the field position, counting in bytes, of the
1271    byte containing the bit closest to the beginning of the structure.  */
1272 #define DECL_FIELD_OFFSET(NODE) (FIELD_DECL_CHECK (NODE)->decl.arguments)
1273 /* In a FIELD_DECL, this is the offset, in bits, of the first bit of the
1274    field from DECL_FIELD_OFFSET.  */
1275 #define DECL_FIELD_BIT_OFFSET(NODE) (FIELD_DECL_CHECK (NODE)->decl.u2.t)
1276 /* In a FIELD_DECL, this indicates whether the field was a bit-field and
1277    if so, the type that was originally specified for it.
1278    TREE_TYPE may have been modified (in finish_struct).  */
1279 #define DECL_BIT_FIELD_TYPE(NODE) (FIELD_DECL_CHECK (NODE)->decl.result)
1280 /* In FUNCTION_DECL, a chain of ..._DECL nodes.  */
1281 /* VAR_DECL and PARM_DECL reserve the arguments slot
1282    for language-specific uses.  */
1283 #define DECL_ARGUMENTS(NODE) (DECL_CHECK (NODE)->decl.arguments)
1284 /* This field is used to reference anything in decl.result and is meant only
1285    for use by the garbage collector.  */
1286 #define DECL_RESULT_FLD(NODE) (DECL_CHECK (NODE)->decl.result)
1287 /* In FUNCTION_DECL, holds the decl for the return value.  */
1288 #define DECL_RESULT(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.result)
1289 /* For a TYPE_DECL, holds the "original" type.  (TREE_TYPE has the copy.) */
1290 #define DECL_ORIGINAL_TYPE(NODE) (TYPE_DECL_CHECK (NODE)->decl.result)
1291 /* In PARM_DECL, holds the type as written (perhaps a function or array).  */
1292 #define DECL_ARG_TYPE_AS_WRITTEN(NODE) (PARM_DECL_CHECK (NODE)->decl.result)
1293 /* For a FUNCTION_DECL, holds the tree of BINDINGs.
1294    For a VAR_DECL, holds the initial value.
1295    For a PARM_DECL, not used--default
1296    values for parameters are encoded in the type of the function,
1297    not in the PARM_DECL slot.  */
1298 #define DECL_INITIAL(NODE) (DECL_CHECK (NODE)->decl.initial)
1299 /* For a PARM_DECL, records the data type used to pass the argument,
1300    which may be different from the type seen in the program.  */
1301 #define DECL_ARG_TYPE(NODE) (PARM_DECL_CHECK (NODE)->decl.initial)
1302 /* For a FIELD_DECL in a QUAL_UNION_TYPE, records the expression, which
1303    if nonzero, indicates that the field occupies the type.  */
1304 #define DECL_QUALIFIER(NODE) (FIELD_DECL_CHECK (NODE)->decl.initial)
1305 /* These two fields describe where in the source code the declaration was.  */
1306 #define DECL_SOURCE_FILE(NODE) (DECL_CHECK (NODE)->decl.filename)
1307 #define DECL_SOURCE_LINE(NODE) (DECL_CHECK (NODE)->decl.linenum)
1308 /* Holds the size of the datum, in bits, as a tree expression.
1309    Need not be constant.  */
1310 #define DECL_SIZE(NODE) (DECL_CHECK (NODE)->decl.size)
1311 /* Likewise for the size in bytes.  */
1312 #define DECL_SIZE_UNIT(NODE) (DECL_CHECK (NODE)->decl.size_unit)
1313 /* Holds the alignment required for the datum.  */
1314 #define DECL_ALIGN(NODE) (DECL_CHECK (NODE)->decl.u1.a.align)
1315 /* For FIELD_DECLs, off_align holds the number of low-order bits of
1316    DECL_FIELD_OFFSET which are known to be always zero.
1317    DECL_OFFSET_ALIGN thus returns the alignment that DECL_FIELD_OFFSET
1318    has.  */
1319 #define DECL_OFFSET_ALIGN(NODE) \
1320   (((unsigned HOST_WIDE_INT)1) << FIELD_DECL_CHECK (NODE)->decl.u1.a.off_align)
1321 /* Specify that DECL_ALIGN(NODE) is a multiple of X.  */
1322 #define SET_DECL_OFFSET_ALIGN(NODE, X) \
1323   (FIELD_DECL_CHECK (NODE)->decl.u1.a.off_align = exact_log2 ((X) & -(X)))
1324 /* 1 if the alignment for this type was requested by "aligned" attribute,
1325    0 if it is the default for this type.  */
1326 #define DECL_USER_ALIGN(NODE) (DECL_CHECK (NODE)->decl.user_align)
1327 /* Holds the machine mode corresponding to the declaration of a variable or
1328    field.  Always equal to TYPE_MODE (TREE_TYPE (decl)) except for a
1329    FIELD_DECL.  */
1330 #define DECL_MODE(NODE) (DECL_CHECK (NODE)->decl.mode)
1331 /* Holds the RTL expression for the value of a variable or function.  If
1332    PROMOTED_MODE is defined, the mode of this expression may not be same
1333    as DECL_MODE.  In that case, DECL_MODE contains the mode corresponding
1334    to the variable's data type, while the mode
1335    of DECL_RTL is the mode actually used to contain the data.  */
1336 #define DECL_RTL(NODE) (DECL_CHECK (NODE)->decl.rtl)
1337 /* Holds an INSN_LIST of all of the live ranges in which the variable
1338    has been moved to a possibly different register.  */
1339 #define DECL_LIVE_RANGE_RTL(NODE) (DECL_CHECK (NODE)->decl.live_range_rtl)
1340 /* For PARM_DECL, holds an RTL for the stack slot or register
1341    where the data was actually passed.  */
1342 #define DECL_INCOMING_RTL(NODE) (PARM_DECL_CHECK (NODE)->decl.u2.r)
1343 /* For FUNCTION_DECL, if it is inline, holds the saved insn chain.  */
1344 #define DECL_SAVED_INSNS(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.u2.f)
1345 /* For FUNCTION_DECL, if it is inline,
1346    holds the size of the stack frame, as an integer.  */
1347 #define DECL_FRAME_SIZE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.u1.i)
1348 /* For FUNCTION_DECL, if it is built-in,
1349    this identifies which built-in operation it is.  */
1350 #define DECL_FUNCTION_CODE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.u1.f)
1351
1352 /* The DECL_VINDEX is used for FUNCTION_DECLS in two different ways.
1353    Before the struct containing the FUNCTION_DECL is laid out,
1354    DECL_VINDEX may point to a FUNCTION_DECL in a base class which
1355    is the FUNCTION_DECL which this FUNCTION_DECL will replace as a virtual
1356    function.  When the class is laid out, this pointer is changed
1357    to an INTEGER_CST node which is suitable for use as an index
1358    into the virtual function table.  */
1359 #define DECL_VINDEX(NODE) (DECL_CHECK (NODE)->decl.vindex)
1360 /* For FIELD_DECLS, DECL_FCONTEXT is the *first* baseclass in
1361    which this FIELD_DECL is defined.  This information is needed when
1362    writing debugging information about vfield and vbase decls for C++.  */
1363 #define DECL_FCONTEXT(NODE) (FIELD_DECL_CHECK (NODE)->decl.vindex)
1364
1365 /* Every ..._DECL node gets a unique number.  */
1366 #define DECL_UID(NODE) (DECL_CHECK (NODE)->decl.uid)
1367
1368 /* For any sort of a ..._DECL node, this points to the original (abstract)
1369    decl node which this decl is an instance of, or else it is NULL indicating
1370    that this decl is not an instance of some other decl.  For example,
1371    in a nested declaration of an inline function, this points back to the
1372    definition.  */
1373 #define DECL_ABSTRACT_ORIGIN(NODE) (DECL_CHECK (NODE)->decl.abstract_origin)
1374
1375 /* Like DECL_ABSTRACT_ORIGIN, but returns NODE if there's no abstract
1376    origin.  This is useful when setting the DECL_ABSTRACT_ORIGIN.  */
1377 #define DECL_ORIGIN(NODE) \
1378   (DECL_ABSTRACT_ORIGIN (NODE) ? DECL_ABSTRACT_ORIGIN (NODE) : NODE)
1379
1380 /* Nonzero for any sort of ..._DECL node means this decl node represents
1381    an inline instance of some original (abstract) decl from an inline function;
1382    suppress any warnings about shadowing some other variable.
1383    FUNCTION_DECL nodes can also have their abstract origin set to themselves
1384    (see save_for_inline_copying).  */
1385 #define DECL_FROM_INLINE(NODE) (DECL_ABSTRACT_ORIGIN (NODE) != (tree) 0 \
1386                                 && DECL_ABSTRACT_ORIGIN (NODE) != (NODE))
1387
1388 /* Nonzero if a _DECL means that the name of this decl should be ignored
1389    for symbolic debug purposes.  */
1390 #define DECL_IGNORED_P(NODE) (DECL_CHECK (NODE)->decl.ignored_flag)
1391
1392 /* Nonzero for a given ..._DECL node means that this node represents an
1393    "abstract instance" of the given declaration (e.g. in the original
1394    declaration of an inline function).  When generating symbolic debugging
1395    information, we mustn't try to generate any address information for nodes
1396    marked as "abstract instances" because we don't actually generate
1397    any code or allocate any data space for such instances.  */
1398 #define DECL_ABSTRACT(NODE) (DECL_CHECK (NODE)->decl.abstract_flag)
1399
1400 /* Nonzero if a _DECL means that no warnings should be generated just
1401    because this decl is unused.  */
1402 #define DECL_IN_SYSTEM_HEADER(NODE) (DECL_CHECK (NODE)->decl.in_system_header_flag)
1403
1404 /* Nonzero for a given ..._DECL node means that this node should be
1405    put in .common, if possible.  If a DECL_INITIAL is given, and it
1406    is not error_mark_node, then the decl cannot be put in .common.  */
1407 #define DECL_COMMON(NODE) (DECL_CHECK (NODE)->decl.common_flag)
1408
1409 /* Language-specific decl information.  */
1410 #define DECL_LANG_SPECIFIC(NODE) (DECL_CHECK (NODE)->decl.lang_specific)
1411
1412 /* In a VAR_DECL or FUNCTION_DECL,
1413    nonzero means external reference:
1414    do not allocate storage, and refer to a definition elsewhere.  */
1415 #define DECL_EXTERNAL(NODE) (DECL_CHECK (NODE)->decl.external_flag)
1416
1417 /* In a VAR_DECL for a RECORD_TYPE, sets number for non-init_priority
1418    initializatons. */
1419 #define DEFAULT_INIT_PRIORITY 65535
1420 #define MAX_INIT_PRIORITY 65535
1421 #define MAX_RESERVED_INIT_PRIORITY 100
1422
1423 /* In a TYPE_DECL
1424    nonzero means the detail info about this type is not dumped into stabs.
1425    Instead it will generate cross reference ('x') of names. 
1426    This uses the same flag as DECL_EXTERNAL. */
1427 #define TYPE_DECL_SUPPRESS_DEBUG(NODE) \
1428 (TYPE_DECL_CHECK (NODE)->decl.external_flag)
1429
1430 /* In VAR_DECL and PARM_DECL nodes, nonzero means declared `register'.  */
1431 #define DECL_REGISTER(NODE) (DECL_CHECK (NODE)->decl.regdecl_flag)
1432 /* In LABEL_DECL nodes, nonzero means that an error message about
1433    jumping into such a binding contour has been printed for this label.  */
1434 #define DECL_ERROR_ISSUED(NODE) (LABEL_DECL_CHECK (NODE)->decl.regdecl_flag)
1435 /* In a FIELD_DECL, indicates this field should be bit-packed.  */
1436 #define DECL_PACKED(NODE) (FIELD_DECL_CHECK (NODE)->decl.regdecl_flag)
1437 /* In a FUNCTION_DECL with a non-zero DECL_CONTEXT, indicates that a
1438    static chain is not needed.  */
1439 #define DECL_NO_STATIC_CHAIN(NODE) \
1440 (FUNCTION_DECL_CHECK (NODE)->decl.regdecl_flag)
1441
1442 /* Nonzero in a ..._DECL means this variable is ref'd from a nested function.
1443    For VAR_DECL nodes, PARM_DECL nodes, and FUNCTION_DECL nodes.
1444
1445    For LABEL_DECL nodes, nonzero if nonlocal gotos to the label are permitted.
1446
1447    Also set in some languages for variables, etc., outside the normal
1448    lexical scope, such as class instance variables.  */
1449 #define DECL_NONLOCAL(NODE) (DECL_CHECK (NODE)->decl.nonlocal_flag)
1450
1451 /* Nonzero in a FUNCTION_DECL means this function can be substituted
1452    where it is called.  */
1453 #define DECL_INLINE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.inline_flag)
1454
1455 /* Nonzero in a FUNCTION_DECL means this is a built-in function
1456    that is not specified by ansi C and that users are supposed to be allowed
1457    to redefine for any purpose whatever.  */
1458 #define DECL_BUILT_IN_NONANSI(NODE) \
1459 (FUNCTION_DECL_CHECK (NODE)->common.unsigned_flag)
1460
1461 /* Nonzero in a FUNCTION_DECL means this function should be treated
1462    as if it were a malloc, meaning it returns a pointer that is
1463    not an alias.  */
1464 #define DECL_IS_MALLOC(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.malloc_flag)
1465
1466 /* Nonzero in a FUNCTION_DECL means this function should be treated
1467    as "pure" function (like const function, but may read global memory).  */
1468 #define DECL_IS_PURE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.pure_flag)
1469
1470 /* Nonzero in a FIELD_DECL means it is a bit field, and must be accessed
1471    specially.  */
1472 #define DECL_BIT_FIELD(NODE) (FIELD_DECL_CHECK (NODE)->decl.bit_field_flag)
1473 /* In a LABEL_DECL, nonzero means label was defined inside a binding
1474    contour that restored a stack level and which is now exited.  */
1475 #define DECL_TOO_LATE(NODE) (LABEL_DECL_CHECK (NODE)->decl.bit_field_flag)
1476
1477 /* Unused in FUNCTION_DECL.  */
1478
1479 /* In a VAR_DECL that's static,
1480    nonzero if the space is in the text section.  */
1481 #define DECL_IN_TEXT_SECTION(NODE) (VAR_DECL_CHECK (NODE)->decl.bit_field_flag)
1482
1483 /* In a FUNCTION_DECL, nonzero means a built in function.  */
1484 #define DECL_BUILT_IN(NODE) (DECL_BUILT_IN_CLASS (NODE) != NOT_BUILT_IN)
1485 /* For a builtin function, identify which part of the compiler defined it.  */
1486 #define DECL_BUILT_IN_CLASS(NODE) \
1487 (FUNCTION_DECL_CHECK (NODE)->decl.built_in_class)
1488
1489 /* Used in VAR_DECLs to indicate that the variable is a vtable.
1490    Used in FIELD_DECLs for vtable pointers.
1491    Used in FUNCTION_DECLs to indicate that the function is virtual.  */
1492 #define DECL_VIRTUAL_P(NODE) (DECL_CHECK (NODE)->decl.virtual_flag)
1493
1494 /* Used to indicate that the linkage status of this DECL is not yet known,
1495    so it should not be output now.  */
1496 #define DECL_DEFER_OUTPUT(NODE) (DECL_CHECK (NODE)->decl.defer_output)
1497
1498 /* Used in PARM_DECLs whose type are unions to indicate that the
1499    argument should be passed in the same way that the first union
1500    alternative would be passed.  */
1501 #define DECL_TRANSPARENT_UNION(NODE) \
1502 (PARM_DECL_CHECK (NODE)->decl.transparent_union)
1503
1504 /* Used in FUNCTION_DECLs to indicate that they should be run automatically
1505    at the beginning or end of execution.  */
1506 #define DECL_STATIC_CONSTRUCTOR(NODE) \
1507 (FUNCTION_DECL_CHECK (NODE)->decl.static_ctor_flag)
1508
1509 #define DECL_STATIC_DESTRUCTOR(NODE) \
1510 (FUNCTION_DECL_CHECK (NODE)->decl.static_dtor_flag)
1511
1512 /* Used to indicate that this DECL represents a compiler-generated entity.  */
1513 #define DECL_ARTIFICIAL(NODE) (DECL_CHECK (NODE)->decl.artificial_flag)
1514
1515 /* Used to indicate that this DECL has weak linkage.  */
1516 #define DECL_WEAK(NODE) (DECL_CHECK (NODE)->decl.weak_flag)
1517
1518 /* Used in TREE_PUBLIC decls to indicate that copies of this DECL in
1519    multiple translation units should be merged.  */
1520 #define DECL_ONE_ONLY(NODE) (DECL_CHECK (NODE)->decl.transparent_union)
1521
1522 /* Used in a DECL to indicate that, even if it TREE_PUBLIC, it need
1523    not be put out unless it is needed in this translation unit.
1524    Entities like this are shared across translation units (like weak
1525    entities), but are guaranteed to be generated by any translation
1526    unit that needs them, and therefore need not be put out anywhere
1527    where they are not needed.  DECL_COMDAT is just a hint to the
1528    back-end; it is up to front-ends which set this flag to ensure
1529    that there will never be any harm, other than bloat, in putting out
1530    something which is DECL_COMDAT.  */
1531 #define DECL_COMDAT(NODE) (DECL_CHECK (NODE)->decl.comdat_flag)
1532
1533 /* Used in FUNCTION_DECLs to indicate that function entry and exit should
1534    be instrumented with calls to support routines.  */
1535 #define DECL_NO_INSTRUMENT_FUNCTION_ENTRY_EXIT(NODE) \
1536 (FUNCTION_DECL_CHECK (NODE)->decl.no_instrument_function_entry_exit)
1537
1538 /* Used in FUNCTION_DECLs to indicate that check-memory-usage should be
1539    disabled in this function.  */
1540 #define DECL_NO_CHECK_MEMORY_USAGE(NODE) \
1541 (FUNCTION_DECL_CHECK (NODE)->decl.no_check_memory_usage)
1542
1543 /* Used in FUNCTION_DECLs to indicate that limit-stack-* should be
1544    disabled in this function.  */
1545 #define DECL_NO_LIMIT_STACK(NODE) \
1546 (FUNCTION_DECL_CHECK (NODE)->decl.no_limit_stack)
1547
1548 /* Additional flags for language-specific uses.  */
1549 #define DECL_LANG_FLAG_0(NODE) (DECL_CHECK (NODE)->decl.lang_flag_0)
1550 #define DECL_LANG_FLAG_1(NODE) (DECL_CHECK (NODE)->decl.lang_flag_1)
1551 #define DECL_LANG_FLAG_2(NODE) (DECL_CHECK (NODE)->decl.lang_flag_2)
1552 #define DECL_LANG_FLAG_3(NODE) (DECL_CHECK (NODE)->decl.lang_flag_3)
1553 #define DECL_LANG_FLAG_4(NODE) (DECL_CHECK (NODE)->decl.lang_flag_4)
1554 #define DECL_LANG_FLAG_5(NODE) (DECL_CHECK (NODE)->decl.lang_flag_5)
1555 #define DECL_LANG_FLAG_6(NODE) (DECL_CHECK (NODE)->decl.lang_flag_6)
1556 #define DECL_LANG_FLAG_7(NODE) (DECL_CHECK (NODE)->decl.lang_flag_7)
1557
1558 /* Used to indicate that the pointer to this DECL cannot be treated as
1559    an address constant.  */
1560 #define DECL_NON_ADDR_CONST_P(NODE) (DECL_CHECK (NODE)->decl.non_addr_const_p)
1561
1562 /* Used in a FIELD_DECL to indicate that we cannot form the address of
1563    this component.  */
1564 #define DECL_NONADDRESSABLE_P(NODE) \
1565   (FIELD_DECL_CHECK (NODE)->decl.non_addressable)
1566
1567 /* Used to indicate an alias set for the memory pointed to by this
1568    particular FIELD_DECL, PARM_DECL, or VAR_DECL, which must have
1569    pointer (or reference) type.  */
1570 #define DECL_POINTER_ALIAS_SET(NODE) \
1571   (DECL_CHECK (NODE)->decl.pointer_alias_set)
1572
1573 /* Nonzero if an alias set has been assigned to this declaration.  */
1574 #define DECL_POINTER_ALIAS_SET_KNOWN_P(NODE) \
1575   (DECL_POINTER_ALIAS_SET (NODE) != - 1)
1576
1577 /* The pointer_depth field comprises two bits for values in the range
1578    0..3.  The value is normally equal to TYPE_POINTER_DEPTH of decl's
1579    type node, but for functions it migth be greater.  For example,
1580    this can happen when the function is declared to accept a parameter
1581    of type void* (depth=1), but is actually called with an argument of
1582    type foo** (depth=2).  The function type will get the formal
1583    parameter's depth, but the function decl will get the actual
1584    argument's depth.  */
1585 #define DECL_POINTER_DEPTH(DECL) (DECL_CHECK (DECL)->decl.pointer_depth)
1586
1587 struct tree_decl
1588 {
1589   struct tree_common common;
1590   const char *filename;
1591   int linenum;
1592   unsigned int uid;
1593   union tree_node *size;
1594   ENUM_BITFIELD(machine_mode) mode : 8;
1595
1596   unsigned external_flag : 1;
1597   unsigned nonlocal_flag : 1;
1598   unsigned regdecl_flag : 1;
1599   unsigned inline_flag : 1;
1600   unsigned bit_field_flag : 1;
1601   unsigned virtual_flag : 1;
1602   unsigned ignored_flag : 1;
1603   unsigned abstract_flag : 1;
1604
1605   unsigned in_system_header_flag : 1;
1606   unsigned common_flag : 1;
1607   unsigned defer_output : 1;
1608   unsigned transparent_union : 1;
1609   unsigned static_ctor_flag : 1;
1610   unsigned static_dtor_flag : 1;
1611   unsigned artificial_flag : 1;
1612   unsigned weak_flag : 1;
1613
1614   unsigned non_addr_const_p : 1;
1615   unsigned no_instrument_function_entry_exit : 1;
1616   unsigned no_check_memory_usage : 1;
1617   unsigned comdat_flag : 1;
1618   unsigned malloc_flag : 1;
1619   unsigned no_limit_stack : 1;
1620   ENUM_BITFIELD(built_in_class) built_in_class : 2;
1621
1622   unsigned pure_flag : 1;
1623   unsigned pointer_depth : 2;
1624   unsigned non_addressable : 1;
1625   unsigned user_align : 1;
1626   /* Three unused bits.  */
1627
1628   unsigned lang_flag_0 : 1;
1629   unsigned lang_flag_1 : 1;
1630   unsigned lang_flag_2 : 1;
1631   unsigned lang_flag_3 : 1;
1632   unsigned lang_flag_4 : 1;
1633   unsigned lang_flag_5 : 1;
1634   unsigned lang_flag_6 : 1;
1635   unsigned lang_flag_7 : 1;
1636
1637   /* For a FUNCTION_DECL, if inline, this is the size of frame needed.
1638      If built-in, this is the code for which built-in function.
1639      For other kinds of decls, this is DECL_ALIGN and DECL_OFFSET_ALIGN.  */
1640   union {
1641     HOST_WIDE_INT i;
1642     enum built_in_function f;
1643     struct {unsigned int align : 24; unsigned int off_align : 8;} a;
1644   } u1;
1645
1646   union tree_node *size_unit;
1647   union tree_node *name;
1648   union tree_node *context;
1649   union tree_node *arguments;   /* Also used for DECL_FIELD_OFFSET */
1650   union tree_node *result;      /* Also used for DECL_BIT_FIELD_TYPE */
1651   union tree_node *initial;     /* Also used for DECL_QUALIFIER */
1652   union tree_node *abstract_origin;
1653   union tree_node *assembler_name;
1654   union tree_node *section_name;
1655   union tree_node *machine_attributes;
1656   struct rtx_def *rtl;  /* RTL representation for object.  */
1657   struct rtx_def *live_range_rtl;
1658
1659   /* In FUNCTION_DECL, if it is inline, holds the saved insn chain.
1660      In FIELD_DECL, is DECL_FIELD_BIT_OFFSET.
1661      In PARM_DECL, holds an RTL for the stack slot
1662      of register where the data was actually passed.
1663      Used by Chill and Java in LABEL_DECL and by C++ and Java in VAR_DECL.  */
1664   union {
1665     struct function *f;
1666     struct rtx_def *r;
1667     union tree_node *t;
1668     int i;
1669   } u2;
1670
1671   union tree_node *vindex;
1672   HOST_WIDE_INT pointer_alias_set;
1673   /* Points to a structure whose details depend on the language in use.  */
1674   struct lang_decl *lang_specific;
1675 };
1676 \f
1677 /* Define the overall contents of a tree node.
1678    It may be any of the structures declared above
1679    for various types of node.  */
1680
1681 union tree_node
1682 {
1683   struct tree_common common;
1684   struct tree_int_cst int_cst;
1685   struct tree_real_cst real_cst;
1686   struct tree_string string;
1687   struct tree_complex complex;
1688   struct tree_identifier identifier;
1689   struct tree_decl decl;
1690   struct tree_type type;
1691   struct tree_list list;
1692   struct tree_vec vec;
1693   struct tree_exp exp;
1694   struct tree_block block;
1695  };
1696 \f
1697 /* Standard named or nameless data types of the C compiler.  */
1698
1699 enum tree_index
1700 {
1701   TI_ERROR_MARK,
1702   TI_INTQI_TYPE,
1703   TI_INTHI_TYPE,
1704   TI_INTSI_TYPE,
1705   TI_INTDI_TYPE,
1706   TI_INTTI_TYPE,
1707
1708   TI_UINTQI_TYPE,
1709   TI_UINTHI_TYPE,
1710   TI_UINTSI_TYPE,
1711   TI_UINTDI_TYPE,
1712   TI_UINTTI_TYPE,
1713     
1714   TI_INTEGER_ZERO,
1715   TI_INTEGER_ONE,
1716   TI_NULL_POINTER,
1717
1718   TI_SIZE_ZERO,
1719   TI_SIZE_ONE,
1720
1721   TI_BITSIZE_ZERO,
1722   TI_BITSIZE_ONE,
1723   TI_BITSIZE_UNIT,
1724
1725   TI_COMPLEX_INTEGER_TYPE,
1726   TI_COMPLEX_FLOAT_TYPE,
1727   TI_COMPLEX_DOUBLE_TYPE,
1728   TI_COMPLEX_LONG_DOUBLE_TYPE,
1729
1730   TI_FLOAT_TYPE,
1731   TI_DOUBLE_TYPE,
1732   TI_LONG_DOUBLE_TYPE,
1733
1734   TI_VOID_TYPE,
1735   TI_PTR_TYPE,
1736   TI_CONST_PTR_TYPE,
1737   TI_PTRDIFF_TYPE,
1738   TI_VA_LIST_TYPE,
1739
1740   TI_V4SF_TYPE,
1741   TI_V4SI_TYPE,
1742   TI_V8QI_TYPE,
1743   TI_V4HI_TYPE,
1744   TI_V2SI_TYPE,
1745
1746   TI_MAIN_IDENTIFIER,
1747
1748   TI_MAX
1749 };
1750
1751 extern tree global_trees[TI_MAX];
1752
1753 #define error_mark_node                 global_trees[TI_ERROR_MARK]
1754  
1755 #define intQI_type_node                 global_trees[TI_INTQI_TYPE]
1756 #define intHI_type_node                 global_trees[TI_INTHI_TYPE]
1757 #define intSI_type_node                 global_trees[TI_INTSI_TYPE]
1758 #define intDI_type_node                 global_trees[TI_INTDI_TYPE]
1759 #define intTI_type_node                 global_trees[TI_INTTI_TYPE]
1760
1761 #define unsigned_intQI_type_node        global_trees[TI_UINTQI_TYPE]
1762 #define unsigned_intHI_type_node        global_trees[TI_UINTHI_TYPE]
1763 #define unsigned_intSI_type_node        global_trees[TI_UINTSI_TYPE]
1764 #define unsigned_intDI_type_node        global_trees[TI_UINTDI_TYPE]
1765 #define unsigned_intTI_type_node        global_trees[TI_UINTTI_TYPE]
1766
1767 #define integer_zero_node               global_trees[TI_INTEGER_ZERO]
1768 #define integer_one_node                global_trees[TI_INTEGER_ONE]
1769 #define size_zero_node                  global_trees[TI_SIZE_ZERO]
1770 #define size_one_node                   global_trees[TI_SIZE_ONE]
1771 #define bitsize_zero_node               global_trees[TI_BITSIZE_ZERO]
1772 #define bitsize_one_node                global_trees[TI_BITSIZE_ONE]
1773 #define bitsize_unit_node               global_trees[TI_BITSIZE_UNIT]
1774
1775 #define null_pointer_node               global_trees[TI_NULL_POINTER]
1776
1777 #define float_type_node                 global_trees[TI_FLOAT_TYPE]
1778 #define double_type_node                global_trees[TI_DOUBLE_TYPE]
1779 #define long_double_type_node           global_trees[TI_LONG_DOUBLE_TYPE]
1780
1781 #define complex_integer_type_node       global_trees[TI_COMPLEX_INTEGER_TYPE]
1782 #define complex_float_type_node         global_trees[TI_COMPLEX_FLOAT_TYPE]
1783 #define complex_double_type_node        global_trees[TI_COMPLEX_DOUBLE_TYPE]
1784 #define complex_long_double_type_node   global_trees[TI_COMPLEX_LONG_DOUBLE_TYPE]
1785
1786 #define void_type_node                  global_trees[TI_VOID_TYPE]
1787 /* The C type `void *'.  */
1788 #define ptr_type_node                   global_trees[TI_PTR_TYPE]
1789 /* The C type `const void *'.  */
1790 #define const_ptr_type_node             global_trees[TI_CONST_PTR_TYPE]
1791 #define ptrdiff_type_node               global_trees[TI_PTRDIFF_TYPE]
1792 #define va_list_type_node               global_trees[TI_VA_LIST_TYPE]
1793
1794 #define main_identifier_node            global_trees[TI_MAIN_IDENTIFIER]
1795 #define MAIN_NAME_P(NODE) (IDENTIFIER_NODE_CHECK (NODE) == main_identifier_node)
1796
1797 #define V4SF_type_node                  global_trees[TI_V4SF_TYPE]
1798 #define V4SI_type_node                  global_trees[TI_V4SI_TYPE]
1799 #define V8QI_type_node                  global_trees[TI_V8QI_TYPE]
1800 #define V4HI_type_node                  global_trees[TI_V4HI_TYPE]
1801 #define V2SI_type_node                  global_trees[TI_V2SI_TYPE]
1802
1803 /* An enumeration of the standard C integer types.  These must be
1804    ordered so that shorter types appear before longer ones.  */
1805 enum integer_type_kind 
1806 {
1807   itk_char,
1808   itk_signed_char,
1809   itk_unsigned_char,
1810   itk_short,
1811   itk_unsigned_short,
1812   itk_int,
1813   itk_unsigned_int,
1814   itk_long,
1815   itk_unsigned_long,
1816   itk_long_long,
1817   itk_unsigned_long_long,
1818   itk_none
1819 };
1820
1821 typedef enum integer_type_kind integer_type_kind;
1822
1823 /* The standard C integer types.  Use integer_type_kind to index into
1824    this array.  */
1825 extern tree integer_types[itk_none];
1826
1827 #define char_type_node                  integer_types[itk_char]
1828 #define signed_char_type_node           integer_types[itk_signed_char]
1829 #define unsigned_char_type_node         integer_types[itk_unsigned_char]
1830 #define short_integer_type_node         integer_types[itk_short]
1831 #define short_unsigned_type_node        integer_types[itk_unsigned_short]
1832 #define integer_type_node               integer_types[itk_int]
1833 #define unsigned_type_node              integer_types[itk_unsigned_int]
1834 #define long_integer_type_node          integer_types[itk_long]
1835 #define long_unsigned_type_node         integer_types[itk_unsigned_long]
1836 #define long_long_integer_type_node     integer_types[itk_long_long]
1837 #define long_long_unsigned_type_node    integer_types[itk_unsigned_long_long]
1838
1839 \f
1840 #define NULL_TREE (tree) NULL
1841
1842 /* The following functions accept a wide integer argument.  Rather than
1843    having to cast on every function call, we use a macro instead, that is
1844    defined here and in rtl.h.  */
1845
1846 #ifndef exact_log2
1847 #define exact_log2(N) exact_log2_wide ((unsigned HOST_WIDE_INT) (N))
1848 #define floor_log2(N) floor_log2_wide ((unsigned HOST_WIDE_INT) (N))
1849 #endif
1850 extern int exact_log2_wide             PARAMS ((unsigned HOST_WIDE_INT));
1851 extern int floor_log2_wide             PARAMS ((unsigned HOST_WIDE_INT));
1852
1853 extern char *oballoc                    PARAMS ((int));
1854 extern char *permalloc                  PARAMS ((int));
1855 extern char *savealloc                  PARAMS ((int));
1856 extern char *expralloc                  PARAMS ((int));
1857
1858 /* Lowest level primitive for allocating a node.
1859    The TREE_CODE is the only argument.  Contents are initialized
1860    to zero except for a few of the common fields.  */
1861
1862 extern tree make_node                   PARAMS ((enum tree_code));
1863 extern tree make_lang_type              PARAMS ((enum tree_code));
1864 extern tree (*make_lang_type_fn)                PARAMS ((enum tree_code));
1865
1866 /* Make a copy of a node, with all the same contents except
1867    for TREE_PERMANENT.  (The copy is permanent
1868    iff nodes being made now are permanent.)  */
1869
1870 extern tree copy_node                   PARAMS ((tree));
1871
1872 /* Make a copy of a chain of TREE_LIST nodes.  */
1873
1874 extern tree copy_list                   PARAMS ((tree));
1875
1876 /* Make a TREE_VEC.  */
1877
1878 extern tree make_tree_vec               PARAMS ((int));
1879
1880 /* Return the (unique) IDENTIFIER_NODE node for a given name.
1881    The name is supplied as a char *.  */
1882
1883 extern tree get_identifier              PARAMS ((const char *));
1884
1885 /* If an identifier with the name TEXT (a null-terminated string) has
1886    previously been referred to, return that node; otherwise return
1887    NULL_TREE.  */
1888
1889 extern tree maybe_get_identifier        PARAMS ((const char *));
1890
1891 /* Construct various types of nodes.  */
1892
1893 #define build_int_2(LO,HI)  \
1894   build_int_2_wide ((unsigned HOST_WIDE_INT) (LO), (HOST_WIDE_INT) (HI))
1895
1896 extern tree build                       PARAMS ((enum tree_code, tree, ...));
1897 extern tree build_nt                    PARAMS ((enum tree_code, ...));
1898 extern tree build_parse_node            PARAMS ((enum tree_code, ...));
1899
1900 extern tree build_int_2_wide            PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT));
1901 extern tree build_real                  PARAMS ((tree, REAL_VALUE_TYPE));
1902 extern tree build_real_from_int_cst     PARAMS ((tree, tree));
1903 extern tree build_complex               PARAMS ((tree, tree, tree));
1904 extern tree build_string                PARAMS ((int, const char *));
1905 extern tree build1                      PARAMS ((enum tree_code, tree, tree));
1906 extern tree build_tree_list             PARAMS ((tree, tree));
1907 extern tree build_decl_list             PARAMS ((tree, tree));
1908 extern tree build_expr_list             PARAMS ((tree, tree));
1909 extern tree build_decl                  PARAMS ((enum tree_code, tree, tree));
1910 extern tree build_block                 PARAMS ((tree, tree, tree, tree, tree));
1911 extern tree build_expr_wfl              PARAMS ((tree, const char *, int, int));
1912
1913 /* Construct various nodes representing data types.  */
1914
1915 extern tree make_signed_type            PARAMS ((int));
1916 extern tree make_unsigned_type          PARAMS ((int));
1917 extern void initialize_sizetypes        PARAMS ((void));
1918 extern void set_sizetype                PARAMS ((tree));
1919 extern tree signed_or_unsigned_type     PARAMS ((int, tree));
1920 extern void fixup_unsigned_type         PARAMS ((tree));
1921 extern tree build_pointer_type          PARAMS ((tree));
1922 extern tree build_reference_type        PARAMS ((tree));
1923 extern tree build_index_type            PARAMS ((tree));
1924 extern tree build_index_2_type          PARAMS ((tree, tree));
1925 extern tree build_array_type            PARAMS ((tree, tree));
1926 extern tree build_function_type         PARAMS ((tree, tree));
1927 extern tree build_method_type           PARAMS ((tree, tree));
1928 extern tree build_offset_type           PARAMS ((tree, tree));
1929 extern tree build_complex_type          PARAMS ((tree));
1930 extern tree array_type_nelts            PARAMS ((tree));
1931
1932 extern tree value_member                PARAMS ((tree, tree));
1933 extern tree purpose_member              PARAMS ((tree, tree));
1934 extern tree binfo_member                PARAMS ((tree, tree));
1935 extern unsigned int attribute_hash_list PARAMS ((tree));
1936 extern int attribute_list_equal         PARAMS ((tree, tree));
1937 extern int attribute_list_contained     PARAMS ((tree, tree));
1938 extern int tree_int_cst_equal           PARAMS ((tree, tree));
1939 extern int tree_int_cst_lt              PARAMS ((tree, tree));
1940 extern int host_integerp                PARAMS ((tree, int));
1941 extern HOST_WIDE_INT tree_low_cst       PARAMS ((tree, int));
1942 extern int tree_int_cst_msb             PARAMS ((tree));
1943 extern int tree_int_cst_sgn             PARAMS ((tree));
1944 extern int tree_expr_nonnegative_p      PARAMS ((tree));
1945 extern int rtl_expr_nonnegative_p       PARAMS ((struct rtx_def *));
1946 extern int index_type_equal             PARAMS ((tree, tree));
1947 extern tree get_inner_array_type        PARAMS ((tree));
1948
1949 /* From expmed.c.  Since rtl.h is included after tree.h, we can't
1950    put the prototype here.  Rtl.h does declare the prototype if
1951    tree.h had been included.  */
1952
1953 extern tree make_tree                   PARAMS ((tree, struct rtx_def *));
1954 \f
1955 /* Return a type like TTYPE except that its TYPE_ATTRIBUTES
1956    is ATTRIBUTE.
1957
1958    Such modified types already made are recorded so that duplicates
1959    are not made. */
1960
1961 extern tree build_type_attribute_variant PARAMS ((tree, tree));
1962 extern tree build_decl_attribute_variant PARAMS ((tree, tree));
1963
1964 extern tree merge_machine_decl_attributes PARAMS ((tree, tree));
1965 extern tree merge_machine_type_attributes PARAMS ((tree, tree));
1966
1967 /* Split a list of declspecs and attributes into two.  */
1968
1969 extern void split_specs_attrs           PARAMS ((tree, tree *, tree *));
1970
1971 /* Strip attributes from a list of combined specs and attrs.  */
1972
1973 extern tree strip_attrs                 PARAMS ((tree));
1974
1975 /* Return 1 if an attribute and its arguments are valid for a decl or type.  */
1976
1977 extern int valid_machine_attribute      PARAMS ((tree, tree, tree, tree));
1978
1979 /* Given a tree node and a string, return non-zero if the tree node is
1980    a valid attribute name for the string.  */
1981
1982 extern int is_attribute_p               PARAMS ((const char *, tree));
1983
1984 /* Given an attribute name and a list of attributes, return the list element
1985    of the attribute or NULL_TREE if not found.  */
1986
1987 extern tree lookup_attribute            PARAMS ((const char *, tree));
1988
1989 /* Given two attributes lists, return a list of their union.  */
1990
1991 extern tree merge_attributes            PARAMS ((tree, tree));
1992
1993 /* Given a type node TYPE and a TYPE_QUALIFIER_SET, return a type for
1994    the same kind of data as TYPE describes.  Variants point to the
1995    "main variant" (which has no qualifiers set) via TYPE_MAIN_VARIANT,
1996    and it points to a chain of other variants so that duplicate
1997    variants are never made.  Only main variants should ever appear as
1998    types of expressions.  */
1999
2000 extern tree build_qualified_type        PARAMS ((tree, int));
2001
2002 /* Like build_qualified_type, but only deals with the `const' and
2003    `volatile' qualifiers.  This interface is retained for backwards
2004    compatiblity with the various front-ends; new code should use
2005    build_qualified_type instead.  */
2006
2007 #define build_type_variant(TYPE, CONST_P, VOLATILE_P)                   \
2008   build_qualified_type (TYPE,                                           \
2009                         ((CONST_P) ? TYPE_QUAL_CONST : 0)               \
2010                         | ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
2011
2012 /* Make a copy of a type node.  */
2013
2014 extern tree build_type_copy             PARAMS ((tree));
2015
2016 /* Given a ..._TYPE node, calculate the TYPE_SIZE, TYPE_SIZE_UNIT,
2017    TYPE_ALIGN and TYPE_MODE fields.  If called more than once on one
2018    node, does nothing except for the first time.  */
2019
2020 extern void layout_type                 PARAMS ((tree));
2021
2022 /* These functions allow a front-end to perform a manual layout of a
2023    RECORD_TYPE.  (For instance, if the placement of subsequent fields
2024    depends on the placement of fields so far.)  Begin by calling
2025    start_record_layout.  Then, call place_field for each of the
2026    fields.  Then, call finish_record_layout.  See layout_type for the
2027    default way in which these functions are used.  */
2028
2029 typedef struct record_layout_info_s
2030 {
2031   /* The RECORD_TYPE that we are laying out.  */
2032   tree t;
2033   /* The offset into the record so far, in bytes, not including bits in
2034      BITPOS.  */
2035   tree offset;
2036   /* The last known alignment of SIZE.  */
2037   unsigned int offset_align;
2038   /* The bit position within the last OFFSET_ALIGN bits, in bits.  */
2039   tree bitpos;
2040   /* The alignment of the record so far, in bits.  */
2041   unsigned int record_align;
2042   /* The alignment of the record so far, not including padding, in bits.  */
2043   unsigned int unpacked_align;
2044   /* The static variables (i.e., class variables, as opposed to
2045      instance variables) encountered in T.  */
2046   tree pending_statics;
2047   int packed_maybe_necessary;
2048 } *record_layout_info;
2049
2050 extern record_layout_info start_record_layout PARAMS ((tree));
2051 extern tree bit_from_pos                PARAMS ((tree, tree));
2052 extern tree byte_from_pos               PARAMS ((tree, tree));
2053 extern void pos_from_byte               PARAMS ((tree *, tree *, unsigned int,
2054                                                  tree));
2055 extern void pos_from_bit                PARAMS ((tree *, tree *, unsigned int,
2056                                                  tree));
2057 extern void normalize_offset            PARAMS ((tree *, tree *,
2058                                                  unsigned int));
2059 extern tree rli_size_unit_so_far        PARAMS ((record_layout_info));
2060 extern tree rli_size_so_far             PARAMS ((record_layout_info));
2061 extern void normalize_rli               PARAMS ((record_layout_info));
2062 extern void place_field                 PARAMS ((record_layout_info, tree));
2063 extern void compute_record_mode         PARAMS ((tree));
2064 extern void finish_record_layout        PARAMS ((record_layout_info));
2065
2066 /* Given a hashcode and a ..._TYPE node (for which the hashcode was made),
2067    return a canonicalized ..._TYPE node, so that duplicates are not made.
2068    How the hash code is computed is up to the caller, as long as any two
2069    callers that could hash identical-looking type nodes agree.  */
2070
2071 extern tree type_hash_canon             PARAMS ((unsigned int, tree));
2072
2073 /* Given a VAR_DECL, PARM_DECL, RESULT_DECL or FIELD_DECL node,
2074    calculates the DECL_SIZE, DECL_SIZE_UNIT, DECL_ALIGN and DECL_MODE
2075    fields.  Call this only once for any given decl node.
2076
2077    Second argument is the boundary that this field can be assumed to
2078    be starting at (in bits).  Zero means it can be assumed aligned
2079    on any boundary that may be needed.  */
2080
2081 extern void layout_decl                 PARAMS ((tree, unsigned));
2082
2083 /* Return the mode for data of a given size SIZE and mode class CLASS.
2084    If LIMIT is nonzero, then don't use modes bigger than MAX_FIXED_MODE_SIZE.
2085    The value is BLKmode if no other mode is found.  This is like
2086    mode_for_size, but is passed a tree.  */
2087
2088 extern enum machine_mode mode_for_size_tree PARAMS ((tree, enum mode_class,
2089                                                      int));
2090
2091 /* Return an expr equal to X but certainly not valid as an lvalue.  */
2092
2093 extern tree non_lvalue                  PARAMS ((tree));
2094 extern tree pedantic_non_lvalue         PARAMS ((tree));
2095
2096 extern tree convert                     PARAMS ((tree, tree));
2097 extern unsigned int expr_align          PARAMS ((tree));
2098 extern tree size_in_bytes               PARAMS ((tree));
2099 extern HOST_WIDE_INT int_size_in_bytes  PARAMS ((tree));
2100 extern tree bit_position                PARAMS ((tree));
2101 extern HOST_WIDE_INT int_bit_position   PARAMS ((tree));
2102 extern tree byte_position               PARAMS ((tree));
2103 extern HOST_WIDE_INT int_byte_position  PARAMS ((tree));
2104
2105 /* Define data structures, macros, and functions for handling sizes
2106    and the various types used to represent sizes.  */
2107
2108 enum size_type_kind
2109 {
2110   SIZETYPE,             /* Normal representation of sizes in bytes. */
2111   SSIZETYPE,            /* Signed representation of sizes in bytes. */
2112   USIZETYPE,            /* Unsigned representation of sizes in bytes.  */
2113   BITSIZETYPE,          /* Normal representation of sizes in bits.  */
2114   SBITSIZETYPE,         /* Signed representation of sizes in bits.  */
2115   UBITSIZETYPE,         /* Unsifgned representation of sizes in bits.  */
2116   TYPE_KIND_LAST};
2117
2118 extern tree sizetype_tab[(int) TYPE_KIND_LAST];
2119
2120 #define sizetype sizetype_tab[(int) SIZETYPE]
2121 #define bitsizetype sizetype_tab[(int) BITSIZETYPE]
2122 #define ssizetype sizetype_tab[(int) SSIZETYPE]
2123 #define usizetype sizetype_tab[(int) USIZETYPE]
2124 #define sbitsizetype sizetype_tab[(int) SBITSIZETYPE]
2125 #define ubitsizetype sizetype_tab[(int) UBITSIZETYPE]
2126
2127 extern tree size_binop                  PARAMS ((enum tree_code, tree, tree));
2128 extern tree size_diffop                 PARAMS ((tree, tree));
2129 extern tree size_int_wide               PARAMS ((HOST_WIDE_INT,
2130                                                  enum size_type_kind));
2131 extern tree size_int_type_wide          PARAMS ((HOST_WIDE_INT, tree));
2132
2133 #define size_int_type(L, T) size_int_type_wide ((HOST_WIDE_INT) (L), T)
2134 #define size_int(L) size_int_wide ((HOST_WIDE_INT) (L), SIZETYPE)
2135 #define ssize_int(L) size_int_wide ((HOST_WIDE_INT) (L), SSIZETYPE)
2136 #define bitsize_int(L) size_int_wide ((HOST_WIDE_INT) (L), BITSIZETYPE)
2137 #define sbitsize_int(L) size_int_wide ((HOST_WIDE_INT) (L), SBITSIZETYPE)
2138
2139 extern tree round_up                    PARAMS ((tree, int));
2140 extern tree round_down                  PARAMS ((tree, int));
2141 extern tree get_pending_sizes           PARAMS ((void));
2142 extern void put_pending_sizes           PARAMS ((tree));
2143
2144 /* Type for sizes of data-type.  */
2145
2146 #define BITS_PER_UNIT_LOG \
2147   ((BITS_PER_UNIT > 1) + (BITS_PER_UNIT > 2) + (BITS_PER_UNIT > 4) \
2148    + (BITS_PER_UNIT > 8) + (BITS_PER_UNIT > 16) + (BITS_PER_UNIT > 32) \
2149    + (BITS_PER_UNIT > 64) + (BITS_PER_UNIT > 128) + (BITS_PER_UNIT > 256))
2150
2151 /* If nonzero, an upper limit on alignment of structure fields, in bits. */
2152 extern unsigned int maximum_field_alignment;
2153
2154 /* If non-zero, the alignment of a bitstring or (power-)set value, in bits. */
2155 extern unsigned int set_alignment;
2156
2157 /* Concatenate two lists (chains of TREE_LIST nodes) X and Y
2158    by making the last node in X point to Y.
2159    Returns X, except if X is 0 returns Y.  */
2160
2161 extern tree chainon                     PARAMS ((tree, tree));
2162
2163 /* Make a new TREE_LIST node from specified PURPOSE, VALUE and CHAIN.  */
2164
2165 extern tree tree_cons                   PARAMS ((tree, tree, tree));
2166 extern tree perm_tree_cons              PARAMS ((tree, tree, tree));
2167 extern tree temp_tree_cons              PARAMS ((tree, tree, tree));
2168 extern tree saveable_tree_cons          PARAMS ((tree, tree, tree));
2169 extern tree decl_tree_cons              PARAMS ((tree, tree, tree));
2170 extern tree expr_tree_cons              PARAMS ((tree, tree, tree));
2171
2172 /* Return the last tree node in a chain.  */
2173
2174 extern tree tree_last                   PARAMS ((tree));
2175
2176 /* Reverse the order of elements in a chain, and return the new head.  */
2177
2178 extern tree nreverse                    PARAMS ((tree));
2179
2180 /* Returns the length of a chain of nodes
2181    (number of chain pointers to follow before reaching a null pointer).  */
2182
2183 extern int list_length                  PARAMS ((tree));
2184
2185 /* Returns the number of FIELD_DECLs in a type.  */
2186
2187 extern int fields_length                PARAMS ((tree));
2188
2189 /* integer_zerop (tree x) is nonzero if X is an integer constant of value 0 */
2190
2191 extern int integer_zerop                PARAMS ((tree));
2192
2193 /* integer_onep (tree x) is nonzero if X is an integer constant of value 1 */
2194
2195 extern int integer_onep                 PARAMS ((tree));
2196
2197 /* integer_all_onesp (tree x) is nonzero if X is an integer constant
2198    all of whose significant bits are 1.  */
2199
2200 extern int integer_all_onesp            PARAMS ((tree));
2201
2202 /* integer_pow2p (tree x) is nonzero is X is an integer constant with
2203    exactly one bit 1.  */
2204
2205 extern int integer_pow2p                PARAMS ((tree));
2206
2207 /* staticp (tree x) is nonzero if X is a reference to data allocated
2208    at a fixed address in memory.  */
2209
2210 extern int staticp                      PARAMS ((tree));
2211
2212 /* Gets an error if argument X is not an lvalue.
2213    Also returns 1 if X is an lvalue, 0 if not.  */
2214
2215 extern int lvalue_or_else               PARAMS ((tree, const char *));
2216
2217 /* save_expr (EXP) returns an expression equivalent to EXP
2218    but it can be used multiple times within context CTX
2219    and only evaluate EXP once.  */
2220
2221 extern tree save_expr                   PARAMS ((tree));
2222
2223 /* Returns the index of the first non-tree operand for CODE, or the number
2224    of operands if all are trees.  */
2225
2226 extern int first_rtl_op                 PARAMS ((enum tree_code));
2227
2228 /* unsave_expr (EXP) returns an expression equivalent to EXP but it
2229    can be used multiple times and will evaluate EXP in its entirety
2230    each time.  */
2231
2232 extern tree unsave_expr                 PARAMS ((tree));
2233
2234 /* Reset EXP in place so that it can be expaned again.  Does not
2235    recurse into subtrees.  */
2236
2237 extern void unsave_expr_1               PARAMS ((tree));
2238
2239 /* Like unsave_expr_1, but recurses into all subtrees.  */
2240
2241 extern tree unsave_expr_now             PARAMS ((tree));
2242
2243 /* If non-null, these are language-specific helper functions for
2244    unsave_expr_now.  If present, LANG_UNSAVE is called before its
2245    argument (an UNSAVE_EXPR) is to be unsaved, and all other
2246    processing in unsave_expr_now is aborted.  LANG_UNSAVE_EXPR_NOW is
2247    called from unsave_expr_1 for language-specific tree codes.  */
2248 extern void (*lang_unsave)              PARAMS ((tree *));
2249 extern void (*lang_unsave_expr_now)     PARAMS ((tree));
2250
2251 /* Return 0 if it is safe to evaluate EXPR multiple times,
2252    return 1 if it is safe if EXPR is unsaved afterward, or
2253    return 2 if it is completely unsafe.  */
2254 extern int unsafe_for_reeval PARAMS ((tree));
2255
2256 /* Return 1 if EXP contains a PLACEHOLDER_EXPR; i.e., if it represents a size
2257    or offset that depends on a field within a record.
2258
2259    Note that we only allow such expressions within simple arithmetic
2260    or a COND_EXPR.  */
2261
2262 extern int contains_placeholder_p       PARAMS ((tree));
2263
2264 /* Return 1 if EXP contains any expressions that produce cleanups for an
2265    outer scope to deal with.  Used by fold.  */
2266
2267 extern int has_cleanups                 PARAMS ((tree));
2268
2269 /* Given a tree EXP, a FIELD_DECL F, and a replacement value R,
2270    return a tree with all occurrences of references to F in a
2271    PLACEHOLDER_EXPR replaced by R.   Note that we assume here that EXP
2272    contains only arithmetic expressions.  */
2273
2274 extern tree substitute_in_expr          PARAMS ((tree, tree, tree));
2275
2276 /* variable_size (EXP) is like save_expr (EXP) except that it
2277    is for the special case of something that is part of a
2278    variable size for a data type.  It makes special arrangements
2279    to compute the value at the right time when the data type
2280    belongs to a function parameter.  */
2281
2282 extern tree variable_size               PARAMS ((tree));
2283
2284 /* stabilize_reference (EXP) returns an reference equivalent to EXP
2285    but it can be used multiple times
2286    and only evaluate the subexpressions once.  */
2287
2288 extern tree stabilize_reference         PARAMS ((tree));
2289
2290 /* Subroutine of stabilize_reference; this is called for subtrees of
2291    references.  Any expression with side-effects must be put in a SAVE_EXPR
2292    to ensure that it is only evaluated once.  */
2293
2294 extern tree stabilize_reference_1       PARAMS ((tree));
2295
2296 /* Return EXP, stripped of any conversions to wider types
2297    in such a way that the result of converting to type FOR_TYPE
2298    is the same as if EXP were converted to FOR_TYPE.
2299    If FOR_TYPE is 0, it signifies EXP's type.  */
2300
2301 extern tree get_unwidened               PARAMS ((tree, tree));
2302
2303 /* Return OP or a simpler expression for a narrower value
2304    which can be sign-extended or zero-extended to give back OP.
2305    Store in *UNSIGNEDP_PTR either 1 if the value should be zero-extended
2306    or 0 if the value should be sign-extended.  */
2307
2308 extern tree get_narrower                PARAMS ((tree, int *));
2309
2310 /* Given MODE and UNSIGNEDP, return a suitable type-tree
2311    with that mode.
2312    The definition of this resides in language-specific code
2313    as the repertoire of available types may vary.  */
2314
2315 extern tree type_for_mode               PARAMS ((enum machine_mode, int));
2316
2317 /* Given PRECISION and UNSIGNEDP, return a suitable type-tree
2318    for an integer type with at least that precision.
2319    The definition of this resides in language-specific code
2320    as the repertoire of available types may vary.  */
2321
2322 extern tree type_for_size               PARAMS ((unsigned, int));
2323
2324 /* Given an integer type T, return a type like T but unsigned.
2325    If T is unsigned, the value is T.
2326    The definition of this resides in language-specific code
2327    as the repertoire of available types may vary.  */
2328
2329 extern tree unsigned_type               PARAMS ((tree));
2330
2331 /* Given an integer type T, return a type like T but signed.
2332    If T is signed, the value is T.
2333    The definition of this resides in language-specific code
2334    as the repertoire of available types may vary.  */
2335
2336 extern tree signed_type                 PARAMS ((tree));
2337
2338 /* This function must be defined in the language-specific files.
2339    expand_expr calls it to build the cleanup-expression for a TARGET_EXPR.
2340    This is defined in a language-specific file.  */
2341
2342 extern tree maybe_build_cleanup         PARAMS ((tree));
2343
2344 /* Given an expression EXP that may be a COMPONENT_REF or an ARRAY_REF,
2345    look for nested component-refs or array-refs at constant positions
2346    and find the ultimate containing object, which is returned.  */
2347
2348 extern tree get_inner_reference         PARAMS ((tree, HOST_WIDE_INT *,
2349                                                  HOST_WIDE_INT *, tree *,
2350                                                  enum machine_mode *, int *,
2351                                                  int *, unsigned int *));
2352
2353 /* Given a DECL or TYPE, return the scope in which it was declared, or
2354    NUL_TREE if there is no containing scope.  */
2355
2356 extern tree get_containing_scope        PARAMS ((tree));
2357
2358 /* Return the FUNCTION_DECL which provides this _DECL with its context,
2359    or zero if none.  */
2360 extern tree decl_function_context       PARAMS ((tree));
2361
2362 /* Return the RECORD_TYPE, UNION_TYPE, or QUAL_UNION_TYPE which provides
2363    this _DECL with its context, or zero if none.  */
2364 extern tree decl_type_context           PARAMS ((tree));
2365
2366 /* Given the FUNCTION_DECL for the current function,
2367    return zero if it is ok for this function to be inline.
2368    Otherwise return a warning message with a single %s
2369    for the function's name.  */
2370
2371 extern const char *function_cannot_inline_p     PARAMS ((tree));
2372
2373 /* Return 1 if EXPR is the real constant zero.  */
2374 extern int real_zerop PARAMS ((tree));
2375 \f
2376 /* Declare commonly used variables for tree structure.  */
2377
2378 /* Points to the name of the input file from which the current input
2379    being parsed originally came (before it went into cpp).  */
2380 extern const char *input_filename;
2381
2382 /* Current line number in input file.  */
2383 extern int lineno;
2384
2385 /* Nonzero for -pedantic switch: warn about anything
2386    that standard C forbids.  */
2387 extern int pedantic;
2388
2389 /* Nonzero means lvalues are limited to those valid in pedantic ANSI C.
2390    Zero means allow extended lvalues.  */
2391
2392 extern int pedantic_lvalues;
2393
2394 /* Nonzero means can safely call expand_expr now;
2395    otherwise layout_type puts variable sizes onto `pending_sizes' instead.  */
2396
2397 extern int immediate_size_expand;
2398
2399 /* Points to the FUNCTION_DECL of the function whose body we are reading. */
2400
2401 extern tree current_function_decl;
2402
2403 /* Nonzero means a FUNC_BEGIN label was emitted.  */
2404 extern tree current_function_func_begin_label;
2405
2406 /* Nonzero means all ..._TYPE nodes should be allocated permanently.  */
2407
2408 extern int all_types_permanent;
2409
2410 /* Pointer to function to compute the name to use to print a declaration.
2411    DECL is the declaration in question.
2412    VERBOSITY determines what information will be printed:
2413      0: DECL_NAME, demangled as necessary.
2414      1: and scope information.
2415      2: and any other information that might be interesting, such as function
2416         parameter types in C++.  */
2417
2418 extern const char *(*decl_printable_name)       PARAMS ((tree, int));
2419
2420 /* Pointer to function to finish handling an incomplete decl at the
2421    end of compilation.  */
2422
2423 extern void (*incomplete_decl_finalize_hook)    PARAMS ((tree));
2424
2425 extern const char *init_parse                   PARAMS ((const char *));
2426 extern void finish_parse                        PARAMS ((void));
2427
2428 extern const char * const language_string;
2429
2430 /* Declare a predefined function.  Return the declaration.  This function is
2431    provided by each language frontend.  */
2432 extern tree builtin_function                    PARAMS ((const char *, tree, int,
2433                                                        enum built_in_class,
2434                                                        const char *));
2435 \f
2436 /* In tree.c */
2437 extern char *perm_calloc                        PARAMS ((int, long));
2438 extern tree get_file_function_name              PARAMS ((int));
2439 extern tree get_file_function_name_long         PARAMS ((const char *));
2440 extern tree get_set_constructor_bits            PARAMS ((tree, char *, int));
2441 extern tree get_set_constructor_bytes           PARAMS ((tree,
2442                                                        unsigned char *, int));
2443 extern tree get_callee_fndecl                   PARAMS ((tree));
2444 \f
2445 /* In stmt.c */
2446
2447 extern int in_control_zone_p                    PARAMS ((void));
2448 extern void expand_fixups                       PARAMS ((struct rtx_def *));
2449 extern tree expand_start_stmt_expr              PARAMS ((void));
2450 extern tree expand_end_stmt_expr                PARAMS ((tree));
2451 extern void expand_expr_stmt                    PARAMS ((tree));
2452 extern int warn_if_unused_value                 PARAMS ((tree));
2453 extern void expand_decl_init                    PARAMS ((tree));
2454 extern void clear_last_expr                     PARAMS ((void));
2455 extern void expand_label                        PARAMS ((tree));
2456 extern void expand_goto                         PARAMS ((tree));
2457 extern void expand_asm                          PARAMS ((tree));
2458 extern void expand_start_cond                   PARAMS ((tree, int));
2459 extern void expand_end_cond                     PARAMS ((void));
2460 extern void expand_start_else                   PARAMS ((void));
2461 extern void expand_start_elseif                 PARAMS ((tree));
2462 extern struct nesting *expand_start_loop        PARAMS ((int));
2463 extern struct nesting *expand_start_loop_continue_elsewhere     PARAMS ((int));
2464 extern void expand_loop_continue_here           PARAMS ((void));
2465 extern void expand_end_loop                     PARAMS ((void));
2466 extern int expand_continue_loop                 PARAMS ((struct nesting *));
2467 extern int expand_exit_loop                     PARAMS ((struct nesting *));
2468 extern int expand_exit_loop_if_false            PARAMS ((struct nesting *,
2469                                                        tree));
2470 extern int expand_exit_something                PARAMS ((void));
2471
2472 extern void expand_null_return                  PARAMS ((void));
2473 extern void expand_return                       PARAMS ((tree));
2474 extern int optimize_tail_recursion              PARAMS ((tree, struct rtx_def *));
2475 extern void expand_start_bindings_and_block     PARAMS ((int, tree));
2476 #define expand_start_bindings(flags) \
2477   expand_start_bindings_and_block(flags, NULL_TREE)
2478 extern void expand_end_bindings                 PARAMS ((tree, int, int));
2479 extern void warn_about_unused_variables         PARAMS ((tree));
2480 extern void start_cleanup_deferral              PARAMS ((void));
2481 extern void end_cleanup_deferral                PARAMS ((void));
2482 extern int is_body_block                        PARAMS ((tree));
2483
2484 extern void mark_block_as_eh_region             PARAMS ((void));
2485 extern void mark_block_as_not_eh_region         PARAMS ((void));
2486 extern int is_eh_region                         PARAMS ((void));
2487 extern int conditional_context                  PARAMS ((void));
2488 extern tree last_cleanup_this_contour           PARAMS ((void));
2489 extern int expand_dhc_cleanup                   PARAMS ((tree));
2490 extern int expand_dcc_cleanup                   PARAMS ((tree));
2491 extern void expand_start_case                   PARAMS ((int, tree, tree,
2492                                                        const char *));
2493 extern void expand_end_case                     PARAMS ((tree));
2494 extern int pushcase                             PARAMS ((tree,
2495                                                        tree (*) (tree, tree),
2496                                                        tree, tree *));
2497 extern int pushcase_range                       PARAMS ((tree, tree,
2498                                                        tree (*) (tree, tree),
2499                                                        tree, tree *));
2500 extern void using_eh_for_cleanups               PARAMS ((void));
2501 extern int stmt_loop_nest_empty                 PARAMS ((void));
2502
2503 /* In fold-const.c */
2504
2505 /* Fold constants as much as possible in an expression.
2506    Returns the simplified expression.
2507    Acts only on the top level of the expression;
2508    if the argument itself cannot be simplified, its
2509    subexpressions are not changed.  */
2510
2511 extern tree fold                PARAMS ((tree));
2512
2513 extern int force_fit_type       PARAMS ((tree, int));
2514 extern int add_double           PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2515                                          unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2516                                          unsigned HOST_WIDE_INT *,
2517                                          HOST_WIDE_INT *));
2518 extern int neg_double           PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2519                                          unsigned HOST_WIDE_INT *,
2520                                          HOST_WIDE_INT *));
2521 extern int mul_double           PARAMS ((unsigned HOST_WIDE_INT,
2522                                          HOST_WIDE_INT,
2523                                          unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2524                                          unsigned HOST_WIDE_INT *,
2525                                          HOST_WIDE_INT *));
2526 extern void lshift_double       PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2527                                          HOST_WIDE_INT, unsigned int,
2528                                          unsigned HOST_WIDE_INT *,
2529                                          HOST_WIDE_INT *, int));
2530 extern void rshift_double       PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2531                                          HOST_WIDE_INT, unsigned int,
2532                                          unsigned HOST_WIDE_INT *,
2533                                          HOST_WIDE_INT *, int));
2534 extern void lrotate_double      PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2535                                          HOST_WIDE_INT, unsigned int,
2536                                          unsigned HOST_WIDE_INT *,
2537                                          HOST_WIDE_INT *));
2538 extern void rrotate_double      PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2539                                          HOST_WIDE_INT, unsigned int,
2540                                          unsigned HOST_WIDE_INT *,
2541                                          HOST_WIDE_INT *));
2542 extern int operand_equal_p      PARAMS ((tree, tree, int));
2543 extern tree invert_truthvalue   PARAMS ((tree));
2544
2545 /* In builtins.c.  Given a type, apply default promotions wrt unnamed
2546    function arguments and return the new type.  Return NULL_TREE if no
2547    change.  Required by any language that supports variadic arguments.  */
2548
2549 extern tree (*lang_type_promotes_to)    PARAMS ((tree));
2550 \f
2551 /* The language front-end must define these functions.  */
2552
2553 /* Function of no arguments for initializing options.  */
2554 extern void lang_init_options                   PARAMS ((void));
2555
2556 /* Function of no arguments for initializing lexical scanning.  */
2557 extern void init_lex                            PARAMS ((void));
2558 /* Function of no arguments for initializing the symbol table.  */
2559 extern void init_decl_processing                PARAMS ((void));
2560
2561 /* Functions called with no arguments at the beginning and end or processing
2562    the input source file.  */
2563 extern void lang_init                           PARAMS ((void));
2564 extern void lang_finish                         PARAMS ((void));
2565
2566 /* Function to identify which front-end produced the output file. */
2567 extern const char *lang_identify                        PARAMS ((void));
2568
2569 /* Called by report_error_function to print out function name.
2570  * Default may be overridden by language front-ends.  */
2571 extern void (*print_error_function) PARAMS ((const char *));
2572
2573 /* Function to replace the DECL_LANG_SPECIFIC field of a DECL with a copy.  */
2574 extern void copy_lang_decl                      PARAMS ((tree));
2575
2576 /* Function called with no arguments to parse and compile the input.  */
2577 extern int yyparse                              PARAMS ((void));
2578 /* Function called with option as argument
2579    to decode options starting with -f or -W or +.
2580    It should return nonzero if it handles the option.  */
2581 extern int lang_decode_option                   PARAMS ((int, char **));
2582
2583 /* Functions for processing symbol declarations.  */
2584 /* Function to enter a new lexical scope.
2585    Takes one argument: always zero when called from outside the front end.  */
2586 extern void pushlevel                           PARAMS ((int));
2587 /* Function to exit a lexical scope.  It returns a BINDING for that scope.
2588    Takes three arguments:
2589      KEEP -- nonzero if there were declarations in this scope.
2590      REVERSE -- reverse the order of decls before returning them.
2591      FUNCTIONBODY -- nonzero if this level is the body of a function.  */
2592 extern tree poplevel                            PARAMS ((int, int, int));
2593 /* Set the BLOCK node for the current scope level.  */
2594 extern void set_block                           PARAMS ((tree));
2595 /* Function to add a decl to the current scope level.
2596    Takes one argument, a decl to add.
2597    Returns that decl, or, if the same symbol is already declared, may
2598    return a different decl for that name.  */
2599 extern tree pushdecl                            PARAMS ((tree));
2600 /* Function to return the chain of decls so far in the current scope level.  */
2601 extern tree getdecls                            PARAMS ((void));
2602 /* Function to return the chain of structure tags in the current scope level.  */
2603 extern tree gettags                             PARAMS ((void));
2604
2605 extern tree build_range_type PARAMS ((tree, tree, tree));
2606
2607 /* Call when starting to parse a declaration:
2608    make expressions in the declaration last the length of the function.
2609    Returns an argument that should be passed to resume_momentary later.  */
2610 extern int suspend_momentary PARAMS ((void));
2611
2612 extern int allocation_temporary_p PARAMS ((void));
2613
2614 /* Call when finished parsing a declaration:
2615    restore the treatment of node-allocation that was
2616    in effect before the suspension.
2617    YES should be the value previously returned by suspend_momentary.  */
2618 extern void resume_momentary PARAMS ((int));
2619
2620 /* Called after finishing a record, union or enumeral type.  */
2621 extern void rest_of_type_compilation PARAMS ((tree, int));
2622
2623 /* Save the current set of obstacks, but don't change them.  */
2624 extern void push_obstacks_nochange PARAMS ((void));
2625
2626 extern void permanent_allocation PARAMS ((int));
2627 extern void push_momentary PARAMS ((void));
2628 extern void clear_momentary PARAMS ((void));
2629 extern void pop_momentary PARAMS ((void));
2630 extern void end_temporary_allocation PARAMS ((void));
2631
2632 /* Pop the obstack selection stack.  */
2633 extern void pop_obstacks PARAMS ((void));
2634
2635 /* In alias.c */
2636 extern void record_component_aliases            PARAMS ((tree));
2637 extern HOST_WIDE_INT get_alias_set              PARAMS ((tree));
2638
2639 /* In c-common.c */
2640 extern HOST_WIDE_INT lang_get_alias_set         PARAMS ((tree));
2641
2642 /* In tree.c */
2643 extern int really_constant_p            PARAMS ((tree));
2644 extern void push_obstacks               PARAMS ((struct obstack *,
2645                                                 struct obstack *));
2646 extern void pop_momentary_nofree        PARAMS ((void));
2647 extern void preserve_momentary          PARAMS ((void));
2648 extern void saveable_allocation         PARAMS ((void));
2649 extern void temporary_allocation        PARAMS ((void));
2650 extern void resume_temporary_allocation PARAMS ((void));
2651 extern tree get_file_function_name      PARAMS ((int));
2652 extern void set_identifier_size         PARAMS ((int));
2653 extern int int_fits_type_p              PARAMS ((tree, tree));
2654 extern int tree_log2                    PARAMS ((tree));
2655 extern int tree_floor_log2              PARAMS ((tree));
2656 extern void preserve_initializer        PARAMS ((void));
2657 extern void preserve_data               PARAMS ((void));
2658 extern int object_permanent_p           PARAMS ((tree));
2659 extern int type_precision               PARAMS ((tree));
2660 extern int simple_cst_equal             PARAMS ((tree, tree));
2661 extern int compare_tree_int             PARAMS ((tree, unsigned int));
2662 extern int type_list_equal              PARAMS ((tree, tree));
2663 extern int chain_member                 PARAMS ((tree, tree));
2664 extern int chain_member_purpose         PARAMS ((tree, tree));
2665 extern int chain_member_value           PARAMS ((tree, tree));
2666 extern tree listify                     PARAMS ((tree));
2667 extern tree type_hash_lookup            PARAMS ((unsigned int, tree));
2668 extern void type_hash_add               PARAMS ((unsigned int, tree));
2669 extern unsigned int type_hash_list      PARAMS ((tree));
2670 extern int simple_cst_list_equal        PARAMS ((tree, tree));
2671 extern void debug_obstack               PARAMS ((char *));
2672 extern void rtl_in_current_obstack      PARAMS ((void));
2673 extern void rtl_in_saveable_obstack     PARAMS ((void));
2674 extern void init_tree_codes             PARAMS ((void));
2675 extern void dump_tree_statistics        PARAMS ((void));
2676 extern void print_obstack_statistics    PARAMS ((const char *,
2677                                                 struct obstack *));
2678 #ifdef BUFSIZ
2679 extern void print_obstack_name          PARAMS ((char *, FILE *,
2680                                                  const char *));
2681 #endif
2682 extern void expand_function_end         PARAMS ((const char *, int, int));
2683 extern void expand_function_start       PARAMS ((tree, int));
2684
2685 extern int real_onep                    PARAMS ((tree));
2686 extern int real_twop                    PARAMS ((tree));
2687 extern void start_identifier_warnings   PARAMS ((void));
2688 extern void gcc_obstack_init            PARAMS ((struct obstack *));
2689 extern void init_obstacks               PARAMS ((void));
2690 extern void obfree                      PARAMS ((char *));
2691 extern void build_common_tree_nodes     PARAMS ((int));
2692 extern void build_common_tree_nodes_2   PARAMS ((int));
2693
2694 /* In function.c */
2695 extern void setjmp_protect_args         PARAMS ((void));
2696 extern void setjmp_protect              PARAMS ((tree));
2697 extern void expand_main_function        PARAMS ((void));
2698 extern void mark_varargs                PARAMS ((void));
2699 extern void init_dummy_function_start   PARAMS ((void));
2700 extern void expand_dummy_function_end   PARAMS ((void));
2701 extern void init_function_for_compilation       PARAMS ((void));
2702 extern void init_function_start         PARAMS ((tree, const char *, int));
2703 extern void assign_parms                PARAMS ((tree));
2704 extern void put_var_into_stack          PARAMS ((tree));
2705 extern void flush_addressof             PARAMS ((tree));
2706 extern void uninitialized_vars_warning  PARAMS ((tree));
2707 extern void setjmp_args_warning         PARAMS ((void));
2708 extern void mark_all_temps_used         PARAMS ((void));
2709 extern void init_temp_slots             PARAMS ((void));
2710 extern void combine_temp_slots          PARAMS ((void));
2711 extern void free_temp_slots             PARAMS ((void));
2712 extern void pop_temp_slots              PARAMS ((void));
2713 extern void push_temp_slots             PARAMS ((void));
2714 extern void preserve_temp_slots         PARAMS ((struct rtx_def *));
2715 extern void preserve_rtl_expr_temps     PARAMS ((tree));
2716 extern int aggregate_value_p            PARAMS ((tree));
2717 extern void free_temps_for_rtl_expr     PARAMS ((tree));
2718 extern void instantiate_virtual_regs    PARAMS ((tree, struct rtx_def *));
2719 extern void unshare_all_rtl             PARAMS ((tree, struct rtx_def *));
2720 extern int max_parm_reg_num             PARAMS ((void));
2721 extern void push_function_context       PARAMS ((void));
2722 extern void pop_function_context        PARAMS ((void));
2723 extern void push_function_context_to    PARAMS ((tree));
2724 extern void pop_function_context_from   PARAMS ((tree));
2725
2726 /* In print-rtl.c */
2727 #ifdef BUFSIZ
2728 extern void print_rtl                   PARAMS ((FILE *, struct rtx_def *));
2729 #endif
2730
2731 /* In print-tree.c */
2732 extern void debug_tree                  PARAMS ((tree));
2733 #ifdef BUFSIZ
2734 extern void print_node                  PARAMS ((FILE *, const char *, tree,
2735                                                  int));
2736 extern void print_node_brief            PARAMS ((FILE *, const char *, tree,
2737                                                  int));
2738 extern void indent_to                   PARAMS ((FILE *, int));
2739 #endif
2740
2741 /* In expr.c */
2742 extern void emit_queue                          PARAMS ((void));
2743 extern int apply_args_register_offset           PARAMS ((int));
2744 extern struct rtx_def *expand_builtin_return_addr
2745         PARAMS ((enum built_in_function, int, struct rtx_def *));
2746 extern void do_pending_stack_adjust             PARAMS ((void));
2747 extern struct rtx_def *expand_assignment        PARAMS ((tree, tree, int,
2748                                                          int));
2749 extern struct rtx_def *store_expr               PARAMS ((tree,
2750                                                          struct rtx_def *,
2751                                                         int));
2752 extern void check_max_integer_computation_mode  PARAMS ((tree));
2753
2754 /* In emit-rtl.c */
2755 extern void start_sequence_for_rtl_expr         PARAMS ((tree));
2756 extern struct rtx_def *emit_line_note_after     PARAMS ((const char *, int,
2757                                                          struct rtx_def *));
2758 extern struct rtx_def *emit_line_note           PARAMS ((const char *, int));
2759 extern struct rtx_def *emit_line_note_force     PARAMS ((const char *, int));
2760
2761 /* In calls.c */
2762
2763 extern int setjmp_call_p                PARAMS ((tree));
2764
2765 /* In front end.  */
2766
2767 extern int mark_addressable             PARAMS ((tree));
2768 extern void incomplete_type_error       PARAMS ((tree, tree));
2769 extern void print_lang_statistics       PARAMS ((void));
2770 extern tree truthvalue_conversion       PARAMS ((tree));
2771 extern void split_specs_attrs           PARAMS ((tree, tree *, tree *));
2772 #ifdef BUFSIZ
2773 extern void print_lang_decl             PARAMS ((FILE *, tree, int));
2774 extern void print_lang_type             PARAMS ((FILE *, tree, int));
2775 extern void print_lang_identifier       PARAMS ((FILE *, tree, int));
2776 #endif
2777 extern int global_bindings_p            PARAMS ((void));
2778 extern void insert_block                PARAMS ((tree));
2779
2780 /* In integrate.c */
2781 extern void save_for_inline_nocopy      PARAMS ((tree));
2782 extern void save_for_inline_copying     PARAMS ((tree));
2783 extern void set_decl_abstract_flags     PARAMS ((tree, int));
2784 extern void output_inline_function      PARAMS ((tree));
2785 extern void set_decl_origin_self        PARAMS ((tree));
2786
2787 /* In front end.  */
2788 extern void set_yydebug                 PARAMS ((int));
2789
2790 /* In stor-layout.c */
2791 extern void fixup_signed_type           PARAMS ((tree));
2792
2793 /* varasm.c */
2794 extern void make_decl_rtl               PARAMS ((tree, const char *, int));
2795 extern void make_decl_one_only          PARAMS ((tree));
2796 extern int supports_one_only            PARAMS ((void));
2797 extern void variable_section            PARAMS ((tree, int));
2798
2799 /* In fold-const.c */
2800 extern int div_and_round_double         PARAMS ((enum tree_code, int,
2801                                                  unsigned HOST_WIDE_INT,
2802                                                  HOST_WIDE_INT,
2803                                                  unsigned HOST_WIDE_INT,
2804                                                  HOST_WIDE_INT,
2805                                                  unsigned HOST_WIDE_INT *,
2806                                                  HOST_WIDE_INT *,
2807                                                  unsigned HOST_WIDE_INT *,
2808                                                  HOST_WIDE_INT *));
2809
2810 /* In stmt.c */
2811 extern void emit_nop                    PARAMS ((void));
2812 extern void expand_computed_goto        PARAMS ((tree));
2813 extern struct rtx_def *label_rtx        PARAMS ((tree));
2814 extern void expand_asm_operands         PARAMS ((tree, tree, tree, tree, int,
2815                                                  const char *, int));
2816 extern int any_pending_cleanups         PARAMS ((int));
2817 extern void init_stmt                   PARAMS ((void));
2818 extern void init_stmt_for_function      PARAMS ((void));
2819 extern int drop_through_at_end_p        PARAMS ((void));
2820 extern void expand_start_target_temps   PARAMS ((void));
2821 extern void expand_end_target_temps     PARAMS ((void));
2822 extern void expand_elseif               PARAMS ((tree));
2823 extern void save_stack_pointer          PARAMS ((void));
2824 extern void expand_decl                 PARAMS ((tree));
2825 extern int expand_decl_cleanup          PARAMS ((tree, tree));
2826 extern void expand_anon_union_decl      PARAMS ((tree, tree, tree));
2827 extern void move_cleanups_up            PARAMS ((void));
2828 extern void expand_start_case_dummy     PARAMS ((void));
2829 extern void expand_end_case_dummy       PARAMS ((void));
2830 extern tree case_index_expr_type        PARAMS ((void));
2831 extern HOST_WIDE_INT all_cases_count    PARAMS ((tree, int *));
2832 extern void check_for_full_enumeration_handling PARAMS ((tree));
2833 extern void declare_nonlocal_label      PARAMS ((tree));
2834 #ifdef BUFSIZ
2835 extern void lang_print_xnode            PARAMS ((FILE *, tree, int));
2836 #endif
2837
2838
2839 /* If KIND=='I', return a suitable global initializer (constructor) name.
2840    If KIND=='D', return a suitable global clean-up (destructor) name.  */
2841 extern tree get_file_function_name PARAMS ((int));
2842 \f
2843 /* Interface of the DWARF2 unwind info support.  */
2844
2845 /* Decide whether we want to emit frame unwind information for the current
2846    translation unit.  */
2847
2848 extern int dwarf2out_do_frame           PARAMS ((void));
2849
2850 /* Generate a new label for the CFI info to refer to.  */
2851
2852 extern char *dwarf2out_cfi_label        PARAMS ((void));
2853
2854 /* Entry point to update the canonical frame address (CFA).  */
2855
2856 extern void dwarf2out_def_cfa           PARAMS ((const char *, unsigned, long));
2857
2858 /* Add the CFI for saving a register window.  */
2859
2860 extern void dwarf2out_window_save       PARAMS ((const char *));
2861
2862 /* Add a CFI to update the running total of the size of arguments pushed
2863    onto the stack.  */
2864
2865 extern void dwarf2out_args_size         PARAMS ((const char *, long));
2866
2867 /* Entry point for saving a register to the stack.  */
2868
2869 extern void dwarf2out_reg_save          PARAMS ((const char *, unsigned, long));
2870
2871 /* Entry point for saving the return address in the stack.  */
2872
2873 extern void dwarf2out_return_save       PARAMS ((const char *, long));
2874
2875 /* Entry point for saving the return address in a register.  */
2876
2877 extern void dwarf2out_return_reg        PARAMS ((const char *, unsigned));
2878
2879 /* Output a marker (i.e. a label) for the beginning of a function, before
2880    the prologue.  */
2881
2882 extern void dwarf2out_begin_prologue    PARAMS ((void));
2883
2884 /* Output a marker (i.e. a label) for the absolute end of the generated
2885    code for a function definition.  */
2886
2887 extern void dwarf2out_end_epilogue      PARAMS ((void));
2888 \f
2889 /* Redefine abort to report an internal error w/o coredump, and
2890    reporting the location of the error in the source file.  This logic
2891    is duplicated in rtl.h and tree.h because every file that needs the
2892    special abort includes one or both.  toplev.h gets too few files,
2893    system.h gets too many.  */
2894
2895 extern void fancy_abort PARAMS ((const char *, int, const char *))
2896     ATTRIBUTE_NORETURN;
2897 #define abort() fancy_abort (__FILE__, __LINE__, __FUNCTION__)