]>
Commit | Line | Data |
---|---|---|
8d08fdba MS |
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). | |
d6a8bdff | 4 | Copyright (C) 1987, 1988, 1990, 1993, 1997, 1998, |
bfa2cb33 | 5 | 1999, 2000, 2001 Free Software Foundation, Inc. |
8d08fdba MS |
6 | Hacked by Michael Tiemann (tiemann@cygnus.com) |
7 | ||
8 | This file is part of GNU CC. | |
9 | ||
10 | GNU CC is free software; you can redistribute it and/or modify | |
11 | it under the terms of the GNU General Public License as published by | |
12 | the Free Software Foundation; either version 2, or (at your option) | |
13 | any later version. | |
14 | ||
15 | GNU CC is distributed in the hope that it will be useful, | |
16 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 | GNU General Public License for more details. | |
19 | ||
20 | You should have received a copy of the GNU General Public License | |
21 | along with GNU CC; see the file COPYING. If not, write to | |
e9fa0c7c | 22 | the Free Software Foundation, 59 Temple Place - Suite 330, |
9efb75d6 | 23 | Boston, MA 02111-1307, USA. */ |
8d08fdba MS |
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. */ | |
0a6969ad | 31 | DEFTREECODE (OFFSET_REF, "offset_ref", 'r', 2) |
8d08fdba | 32 | |
61a127b3 MM |
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'. */ | |
87e3dbc9 | 36 | DEFTREECODE (PTRMEM_CST, "ptrmem_cst", 'c', 2) |
61a127b3 | 37 | |
02531345 JM |
38 | /* For NEW_EXPR, operand 0 is the placement list. |
39 | Operand 1 is the new-declarator. | |
40 | Operand 2 is the initializer. */ | |
41 | DEFTREECODE (NEW_EXPR, "nw_expr", 'e', 3) | |
42 | DEFTREECODE (VEC_NEW_EXPR, "vec_nw_expr", 'e', 3) | |
43 | ||
8d08fdba MS |
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. */ | |
0a6969ad JC |
47 | DEFTREECODE (DELETE_EXPR, "dl_expr", 'e', 2) |
48 | DEFTREECODE (VEC_DELETE_EXPR, "vec_dl_expr", 'e', 2) | |
8d08fdba MS |
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). */ | |
0a6969ad | 54 | DEFTREECODE (SCOPE_REF, "scope_ref", 'r', 2) |
8d08fdba MS |
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). */ | |
0a6969ad | 59 | DEFTREECODE (MEMBER_REF, "member_ref", 'r', 2) |
8d08fdba MS |
60 | |
61 | /* Type conversion operator in C++. TREE_TYPE is type that this | |
62 | operator converts to. Operand is expression to be converted. */ | |
0a6969ad | 63 | DEFTREECODE (TYPE_EXPR, "type_expr", 'e', 1) |
8d08fdba | 64 | |
02531345 | 65 | /* For AGGR_INIT_EXPR, operand 0 is function which performs initialization, |
8d08fdba MS |
66 | operand 1 is argument list to initialization function, |
67 | and operand 2 is the slot which was allocated for this expression. */ | |
213ea7a6 | 68 | DEFTREECODE (AGGR_INIT_EXPR, "aggr_init_expr", 'e', 3) |
8d08fdba | 69 | |
8d2733ca MS |
70 | /* A throw expression. operand 0 is the expression, if there was one, |
71 | else it is NULL_TREE. */ | |
0a6969ad | 72 | DEFTREECODE (THROW_EXPR, "throw_expr", 'e', 1) |
8d08fdba | 73 | |
699ed0ce MM |
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. */ | |
76 | DEFTREECODE (EMPTY_CLASS_EXPR, "empty_class_expr", 'e', 0) | |
77 | ||
8d08fdba MS |
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) | |
c80106a4 | 87 | DECL_TEMPLATE_RESULT null |
8d08fdba MS |
88 | For non-class templates: |
89 | TREE_TYPE type of object to be constructed | |
c80106a4 | 90 | DECL_TEMPLATE_RESULT decl for object to be created |
8d08fdba MS |
91 | (e.g., FUNCTION_DECL with tmpl parms used) |
92 | */ | |
0a6969ad | 93 | DEFTREECODE (TEMPLATE_DECL, "template_decl", 'd', 0) |
8d08fdba | 94 | |
f84b4be9 JM |
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. */ | |
f94ae2f5 | 128 | DEFTREECODE (TEMPLATE_PARM_INDEX, "template_parm_index", 'x', |
04a2ecf7 JM |
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)) | |
f84b4be9 | 138 | |
8d08fdba | 139 | /* Index into a template parameter list. This parameter must be a type. |
f84b4be9 | 140 | The TYPE_FIELDS value will be a TEMPLATE_PARM_INDEX. */ |
0a6969ad | 141 | DEFTREECODE (TEMPLATE_TYPE_PARM, "template_type_parm", 't', 0) |
8d08fdba | 142 | |
1899c3a4 KL |
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 | ||
a1281f45 | 147 | It is used without template arguments like TT in C<TT>, |
1899c3a4 | 148 | TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO is NULL_TREE |
a1281f45 KL |
149 | and TYPE_NAME is a TEMPLATE_DECL. */ |
150 | DEFTREECODE (TEMPLATE_TEMPLATE_PARM, "template_template_parm", 't', 0) | |
1899c3a4 | 151 | |
a1281f45 KL |
152 | /* Like TEMPLATE_TEMPLATE_PARM it is used with bound template arguments |
153 | like TT<int>. | |
babdef36 JM |
154 | In this case, TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO contains the |
155 | template name and its bound arguments. TYPE_NAME is a TYPE_DECL. */ | |
a1281f45 | 156 | DEFTREECODE (BOUND_TEMPLATE_TEMPLATE_PARM, "bound_template_template_parm", 't', 0) |
73b0fce8 | 157 | |
45869a6c | 158 | /* A type designated by `typename T::t'. TYPE_CONTEXT is `T', |
78638e24 MM |
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'. */ | |
0a6969ad | 164 | DEFTREECODE (TYPENAME_TYPE, "typename_type", 't', 0) |
5566b478 | 165 | |
b8c6534b KL |
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. */ | |
169 | DEFTREECODE (UNBOUND_CLASS_TEMPLATE, "unbound_class_template", 't', 0) | |
170 | ||
b894fc05 JM |
171 | /* A type designated by `__typeof (expr)'. TYPE_FIELDS is the |
172 | expression in question. */ | |
173 | DEFTREECODE (TYPEOF_TYPE, "typeof_type", 't', 0) | |
174 | ||
cffa8729 MS |
175 | /* A using declaration. DECL_INITIAL contains the specified scope. |
176 | This is not an alias, but is later expanded into multiple aliases. */ | |
0a6969ad | 177 | DEFTREECODE (USING_DECL, "using_decl", 'd', 0) |
5566b478 | 178 | |
9da99f7d NS |
179 | /* A using directive. The operand is USING_STMT_NAMESPACE. */ |
180 | DEFTREECODE (USING_STMT, "using_directive", 'e', 1) | |
181 | ||
42976354 | 182 | /* An un-parsed default argument. Looks like an IDENTIFIER_NODE. */ |
bfa2cb33 | 183 | DEFTREECODE (DEFAULT_ARG, "default_arg", 'x', 2) |
42976354 | 184 | |
8f032717 | 185 | /* A template-id, like foo<int>. The first operand is the template. |
856216bb MM |
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. */ | |
0a6969ad | 190 | DEFTREECODE (TEMPLATE_ID_EXPR, "template_id_expr", 'e', 2) |
386b8a85 | 191 | |
f181d4ae MM |
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. */ | |
30394414 JM |
195 | DEFTREECODE (CPLUS_BINDING, "binding", 'x', 2) |
196 | ||
2c73f9f5 ML |
197 | /* A list-like node for chaining overloading candidates. TREE_TYPE is |
198 | the original name, and the parameter is the FUNCTION_DECL. */ | |
199 | DEFTREECODE (OVERLOAD, "overload", 'x', 1) | |
200 | ||
5ffe581d JM |
201 | /* A generic wrapper for something not tree that we want to include in |
202 | tree structure. */ | |
203 | DEFTREECODE (WRAPPER, "wrapper", 'x', 1) | |
204 | ||
672476cb MM |
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. */ | |
209 | DEFTREECODE (LOOKUP_EXPR, "lookup_expr", 'e', 1) | |
210 | ||
42976354 BK |
211 | /* A whole bunch of tree codes for the initial, superficial parsing of |
212 | templates. */ | |
0a6969ad JC |
213 | DEFTREECODE (MODOP_EXPR, "modop_expr", 'e', 3) |
214 | DEFTREECODE (CAST_EXPR, "cast_expr", '1', 1) | |
215 | DEFTREECODE (REINTERPRET_CAST_EXPR, "reinterpret_cast_expr", '1', 1) | |
216 | DEFTREECODE (CONST_CAST_EXPR, "const_cast_expr", '1', 1) | |
217 | DEFTREECODE (STATIC_CAST_EXPR, "static_cast_expr", '1', 1) | |
218 | DEFTREECODE (DYNAMIC_CAST_EXPR, "dynamic_cast_expr", '1', 1) | |
0a6969ad JC |
219 | DEFTREECODE (DOTSTAR_EXPR, "dotstar_expr", 'e', 2) |
220 | DEFTREECODE (TYPEID_EXPR, "typeid_expr", 'e', 1) | |
40242ccf | 221 | DEFTREECODE (PSEUDO_DTOR_EXPR, "pseudo_dtor_expr", 'e', 3) |
0a6969ad | 222 | |
ade3dc07 JM |
223 | /* CTOR_INITIALIZER is a placeholder in template code for a call to |
224 | setup_vtbl_pointer (and appears in all functions, not just ctors). */ | |
0a6969ad | 225 | DEFTREECODE (CTOR_INITIALIZER, "ctor_initializer", 'e', 2) |
0a6969ad | 226 | DEFTREECODE (RETURN_INIT, "return_init", 'e', 2) |
59026e79 | 227 | DEFTREECODE (TRY_BLOCK, "try_block", 'e', 2) |
52a11cbf | 228 | DEFTREECODE (EH_SPEC_BLOCK, "eh_spec_block", 'e', 2) |
1a6025b4 JM |
229 | /* A HANDLER wraps a catch handler for the HANDLER_TYPE. If this is |
230 | CATCH_ALL_TYPE, then the handler catches all types. The declaration of | |
231 | the catch variable is in HANDLER_PARMS, and the body block in | |
232 | HANDLER_BODY. */ | |
59026e79 | 233 | DEFTREECODE (HANDLER, "handler", 'e', 2) |
0a6969ad | 234 | |
52a11cbf RH |
235 | /* A MUST_NOT_THROW_EXPR wraps an expression that may not |
236 | throw, and must call terminate if it does. */ | |
237 | DEFTREECODE (MUST_NOT_THROW_EXPR, "must_not_throw_expr", 'e', 1) | |
238 | ||
5ffe581d JM |
239 | DEFTREECODE (TAG_DEFN, "tag_defn", 'e', 0) |
240 | ||
241 | /* And some codes for expressing conversions for overload resolution. */ | |
242 | ||
0a6969ad JC |
243 | DEFTREECODE (IDENTITY_CONV, "identity_conv", 'e', 1) |
244 | DEFTREECODE (LVALUE_CONV, "lvalue_conv", 'e', 1) | |
245 | DEFTREECODE (QUAL_CONV, "qual_conv", 'e', 1) | |
246 | DEFTREECODE (STD_CONV, "std_conv", 'e', 1) | |
247 | DEFTREECODE (PTR_CONV, "ptr_conv", 'e', 1) | |
248 | DEFTREECODE (PMEM_CONV, "pmem_conv", 'e', 1) | |
249 | DEFTREECODE (BASE_CONV, "base_conv", 'e', 1) | |
250 | DEFTREECODE (REF_BIND, "ref_bind", 'e', 1) | |
5ffe581d | 251 | DEFTREECODE (USER_CONV, "user_conv", 'e', 2) |
0a6969ad JC |
252 | DEFTREECODE (AMBIG_CONV, "ambig_conv", 'e', 1) |
253 | DEFTREECODE (RVALUE_CONV, "rvalue_conv", 'e', 1) | |
254 | ||
f84b4be9 JM |
255 | /* |
256 | Local variables: | |
257 | mode:c | |
258 | End: | |
259 | */ |