cp-tree.def revision 96263
1/* This file contains the definitions and documentation for the
2   additional tree codes used in the GNU C++ compiler (see tree.def
3   for the standard codes).
4   Copyright (C) 1987, 1988, 1990, 1993, 1997, 1998,
5   1999, 2000, 2001 Free Software Foundation, Inc.
6   Hacked by Michael Tiemann (tiemann@cygnus.com)
7
8This file is part of GNU CC.
9
10GNU CC is free software; you can redistribute it and/or modify
11it under the terms of the GNU General Public License as published by
12the Free Software Foundation; either version 2, or (at your option)
13any later version.
14
15GNU CC is distributed in the hope that it will be useful,
16but WITHOUT ANY WARRANTY; without even the implied warranty of
17MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18GNU General Public License for more details.
19
20You should have received a copy of the GNU General Public License
21along with GNU CC; see the file COPYING.  If not, write to
22the Free Software Foundation, 59 Temple Place - Suite 330,
23Boston, MA 02111-1307, USA.  */
24
25 
26/* Reference to the contents of an offset
27   (a value whose type is an OFFSET_TYPE).
28   Operand 0 is the object within which the offset is taken.
29   Operand 1 is the offset.  The language independent OFFSET_REF
30   just won't work for us.  */
31DEFTREECODE (OFFSET_REF, "offset_ref", 'r', 2)
32
33/* A pointer-to-member constant.  For a pointer-to-member constant
34   `X::Y' The PTRMEM_CST_CLASS is the RECORD_TYPE for `X' and the
35   PTRMEM_CST_MEMBER is the _DECL for `Y'.  */
36DEFTREECODE (PTRMEM_CST, "ptrmem_cst", 'c', 2)
37
38/* For NEW_EXPR, operand 0 is the placement list.
39   Operand 1 is the new-declarator.
40   Operand 2 is the initializer.  */
41DEFTREECODE (NEW_EXPR, "nw_expr", 'e', 3)
42DEFTREECODE (VEC_NEW_EXPR, "vec_nw_expr", 'e', 3)
43
44/* For DELETE_EXPR, operand 0 is the store to be destroyed.
45   Operand 1 is the value to pass to the destroying function
46   saying whether the store should be deallocated as well.  */
47DEFTREECODE (DELETE_EXPR, "dl_expr", 'e', 2)
48DEFTREECODE (VEC_DELETE_EXPR, "vec_dl_expr", 'e', 2)
49
50/* Value is reference to particular overloaded class method.
51   Operand 0 is the class name (an IDENTIFIER_NODE);
52   operand 1 is the field (also an IDENTIFIER_NODE).
53   The COMPLEXITY field holds the class level (usually 0).  */
54DEFTREECODE (SCOPE_REF, "scope_ref", 'r', 2)
55
56/* When composing an object with a member, this is the result.
57   Operand 0 is the object.  Operand 1 is the member (usually
58   a dereferenced pointer to member).  */
59DEFTREECODE (MEMBER_REF, "member_ref", 'r', 2)
60
61/* Type conversion operator in C++.  TREE_TYPE is type that this
62   operator converts to.  Operand is expression to be converted.  */
63DEFTREECODE (TYPE_EXPR, "type_expr", 'e', 1)
64
65/* For AGGR_INIT_EXPR, operand 0 is function which performs initialization,
66   operand 1 is argument list to initialization function,
67   and operand 2 is the slot which was allocated for this expression.  */
68DEFTREECODE (AGGR_INIT_EXPR, "aggr_init_expr", 'e', 3)
69
70/* A throw expression.  operand 0 is the expression, if there was one,
71   else it is NULL_TREE.  */
72DEFTREECODE (THROW_EXPR, "throw_expr", 'e', 1)
73
74/* An empty class object.  The TREE_TYPE gives the class type.  We use
75   these to avoid actually creating instances of the empty classes.  */
76DEFTREECODE (EMPTY_CLASS_EXPR, "empty_class_expr", 'e', 0)
77
78/* Template definition.  The following fields have the specified uses,
79   although there are other macros in cp-tree.h that should be used for
80   accessing this data.
81        DECL_ARGUMENTS          template parm vector
82        DECL_TEMPLATE_INFO      template text &c
83	DECL_VINDEX		list of instantiations already produced;
84				only done for functions so far
85   For class template:
86        DECL_INITIAL            associated templates (methods &c)
87        DECL_TEMPLATE_RESULT    null
88   For non-class templates:
89	TREE_TYPE		type of object to be constructed
90        DECL_TEMPLATE_RESULT    decl for object to be created
91                                (e.g., FUNCTION_DECL with tmpl parms used)
92 */
93DEFTREECODE (TEMPLATE_DECL, "template_decl", 'd', 0)
94
95/* Index into a template parameter list.  The TEMPLATE_PARM_IDX gives
96   the index (from 0) of the parameter, while the TEMPLATE_PARM_LEVEL
97   gives the level (from 1) of the parameter.
98
99   Here's an example:
100   
101   template <class T> // Index 0, Level 1.
102   struct S
103   {
104      template <class U, // Index 0, Level 2.
105                class V> // Index 1, Level 2.
106      void f();
107   };  
108
109   The DESCENDANTS will be a chain of TEMPLATE_PARM_INDEXs descended
110   from this one.  The first descendant will have the same IDX, but
111   its LEVEL will be one less.  The TREE_CHAIN field is used to chain
112   together the descendants.  The TEMPLATE_PARM_DECL is the
113   declaration of this parameter, either a TYPE_DECL or CONST_DECL.
114   The TEMPLATE_PARM_ORIG_LEVEL is the LEVEL of the most distant
115   parent, i.e., the LEVEL that the parameter originally had when it
116   was declared.  For example, if we instantiate S<int>, we will have:
117
118   struct S<int>
119   {
120     template <class U, // Index 0, Level 1, Orig Level 2
121               class V> // Index 1, Level 1, Orig Level 2
122     void f();
123   };
124  
125   The LEVEL is the level of the parameter when we are worrying about
126   the types of things; the ORIG_LEVEL is the level when we are
127   worrying about instantiating things.  */
128DEFTREECODE (TEMPLATE_PARM_INDEX, "template_parm_index", 'x', 
129	     /* The addition of (sizeof(tree) - 1) in the next expression
130		is to handle the case when padding pushes us past an even
131		multiple of sizeof(tree).  */
132	     /* We used to try to calculate this using
133		1+3*sizeof(HOST_WIDE_INT), but that fails if alignment
134		makes it bigger.  */
135	     ((sizeof (template_parm_index) - sizeof (struct tree_common))
136	      + sizeof (tree) - 1)
137	     / sizeof (tree))
138
139/* Index into a template parameter list.  This parameter must be a type.
140   The TYPE_FIELDS value will be a TEMPLATE_PARM_INDEX.  */
141DEFTREECODE (TEMPLATE_TYPE_PARM, "template_type_parm", 't', 0)
142
143/* Index into a template parameter list for template template parameters.
144   This parameter must be a type.  The TYPE_FIELDS value will be a 
145   TEMPLATE_PARM_INDEX.
146
147   It is used without template arguments like TT in C<TT>, 
148   TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO is NULL_TREE
149   and TYPE_NAME is a TEMPLATE_DECL.  */
150DEFTREECODE (TEMPLATE_TEMPLATE_PARM, "template_template_parm", 't', 0)
151
152/* Like TEMPLATE_TEMPLATE_PARM it is used with bound template arguments 
153   like TT<int>.
154   In this case, TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO contains the
155   template name and its bound arguments.  TYPE_NAME is a TYPE_DECL.  */
156DEFTREECODE (BOUND_TEMPLATE_TEMPLATE_PARM, "bound_template_template_parm", 't', 0)
157
158/* A type designated by `typename T::t'.  TYPE_CONTEXT is `T',
159   TYPE_NAME is an IDENTIFIER_NODE for `t'.  If the type was named via
160   template-id, TYPENAME_TYPE_FULLNAME will hold the TEMPLATE_ID_EXPR.
161   If TREE_TYPE is present, this type was generated by the implicit
162   typename extension, and the TREE_TYPE is a _TYPE from a baseclass
163   of `T'.  */
164DEFTREECODE (TYPENAME_TYPE, "typename_type", 't', 0)
165
166/* For template template argument of the form `T::template C'.
167   TYPE_CONTEXT is `T', the template parameter dependent object.
168   TYPE_NAME is an IDENTIFIER_NODE for `C', the member class template.  */
169DEFTREECODE (UNBOUND_CLASS_TEMPLATE, "unbound_class_template", 't', 0)
170
171/* A type designated by `__typeof (expr)'.  TYPE_FIELDS is the
172   expression in question.  */
173DEFTREECODE (TYPEOF_TYPE, "typeof_type", 't', 0)
174
175/* A using declaration.  DECL_INITIAL contains the specified scope.  
176   This is not an alias, but is later expanded into multiple aliases.  */
177DEFTREECODE (USING_DECL, "using_decl", 'd', 0)
178
179/* A using directive. The operand is USING_STMT_NAMESPACE. */     
180DEFTREECODE (USING_STMT, "using_directive", 'e', 1)
181
182/* An un-parsed default argument.  Looks like an IDENTIFIER_NODE.  */
183DEFTREECODE (DEFAULT_ARG, "default_arg", 'x', 2)
184
185/* A template-id, like foo<int>.  The first operand is the template.
186   The second is the TREE_LIST or TREE_VEC of explicitly specified
187   arguments.  The template will be a FUNCTION_DECL, TEMPLATE_DECL, or
188   an OVERLOAD.  If the template-id refers to a member template, the
189   template may be an IDENTIFIER_NODE.  */
190DEFTREECODE (TEMPLATE_ID_EXPR, "template_id_expr", 'e', 2)
191
192/* An association between name and entity. Parameters are the scope
193   and the (non-type) value.  TREE_TYPE indicates the type bound to
194   the name. */
195DEFTREECODE (CPLUS_BINDING, "binding", 'x', 2)
196
197/* A list-like node for chaining overloading candidates. TREE_TYPE is 
198   the original name, and the parameter is the FUNCTION_DECL.  */
199DEFTREECODE (OVERLOAD, "overload", 'x', 1)
200
201/* A generic wrapper for something not tree that we want to include in
202   tree structure.  */
203DEFTREECODE (WRAPPER, "wrapper", 'x', 1)
204
205/* Used to represent deferred name lookup for dependent names while
206   parsing a template declaration.  The first argument is an
207   IDENTIFIER_NODE for the name in question.  The TREE_TYPE is
208   unused.  */
209DEFTREECODE (LOOKUP_EXPR, "lookup_expr", 'e', 1)
210
211/* A whole bunch of tree codes for the initial, superficial parsing of
212   templates.  */
213DEFTREECODE (MODOP_EXPR, "modop_expr", 'e', 3)
214DEFTREECODE (CAST_EXPR, "cast_expr", '1', 1)
215DEFTREECODE (REINTERPRET_CAST_EXPR, "reinterpret_cast_expr", '1', 1)
216DEFTREECODE (CONST_CAST_EXPR, "const_cast_expr", '1', 1)
217DEFTREECODE (STATIC_CAST_EXPR, "static_cast_expr", '1', 1)
218DEFTREECODE (DYNAMIC_CAST_EXPR, "dynamic_cast_expr", '1', 1)
219DEFTREECODE (DOTSTAR_EXPR, "dotstar_expr", 'e', 2)
220DEFTREECODE (TYPEID_EXPR, "typeid_expr", 'e', 1)
221DEFTREECODE (PSEUDO_DTOR_EXPR, "pseudo_dtor_expr", 'e', 3)
222
223/* A SUBOBJECT statement marks the point at which a sub-object is
224   fully constructed.  After this point, the SUBOBJECT_CLEANUP must be
225   run if an exception is thrown before the end of the enclosing
226   function.  */
227DEFTREECODE (SUBOBJECT, "subobject", 'e', 1)
228/* An CTOR_STMT marks the beginning (if CTOR_BEGIN_P holds) or end of
229   a constructor (if CTOR_END_P) holds.  At the end of a constructor,
230   the cleanups associated with any SUBOBJECT_CLEANUPS need no longer
231   be run.  */
232DEFTREECODE (CTOR_STMT, "ctor_stmt", 'e', 0)
233/* CTOR_INITIALIZER is a placeholder in template code for a call to
234   setup_vtbl_pointer (and appears in all functions, not just ctors).  */
235DEFTREECODE (CTOR_INITIALIZER, "ctor_initializer", 'e', 2)
236DEFTREECODE (RETURN_INIT, "return_init", 'e', 2)
237DEFTREECODE (TRY_BLOCK, "try_block", 'e', 2)
238DEFTREECODE (EH_SPEC_BLOCK, "eh_spec_block", 'e', 2)
239/* A HANDLER wraps a catch handler for the HANDLER_TYPE.  If this is
240   CATCH_ALL_TYPE, then the handler catches all types.  The declaration of
241   the catch variable is in HANDLER_PARMS, and the body block in
242   HANDLER_BODY.  */
243DEFTREECODE (HANDLER, "handler", 'e', 2)
244
245/* A MUST_NOT_THROW_EXPR wraps an expression that may not
246   throw, and must call terminate if it does.  */
247DEFTREECODE (MUST_NOT_THROW_EXPR, "must_not_throw_expr", 'e', 1)
248
249DEFTREECODE (TAG_DEFN, "tag_defn", 'e', 0)
250
251/* And some codes for expressing conversions for overload resolution.  */
252
253DEFTREECODE (IDENTITY_CONV, "identity_conv", 'e', 1)
254DEFTREECODE (LVALUE_CONV, "lvalue_conv", 'e', 1)
255DEFTREECODE (QUAL_CONV, "qual_conv", 'e', 1)
256DEFTREECODE (STD_CONV, "std_conv", 'e', 1)
257DEFTREECODE (PTR_CONV, "ptr_conv", 'e', 1)
258DEFTREECODE (PMEM_CONV, "pmem_conv", 'e', 1)
259DEFTREECODE (BASE_CONV, "base_conv", 'e', 1)
260DEFTREECODE (REF_BIND, "ref_bind", 'e', 1)
261DEFTREECODE (USER_CONV, "user_conv", 'e', 2)
262DEFTREECODE (AMBIG_CONV, "ambig_conv", 'e', 1)
263DEFTREECODE (RVALUE_CONV, "rvalue_conv", 'e', 1)
264
265/*
266Local variables:
267mode:c
268End:
269*/
270