]>
Commit | Line | Data |
---|---|---|
b0278d39 | 1 | /* The lang_hooks data structure. |
f1717362 | 2 | Copyright (C) 2001-2016 Free Software Foundation, Inc. |
e8602e56 | 3 | |
4642865b | 4 | This file is part of GCC. |
e8602e56 | 5 | |
4642865b | 6 | GCC is free software; you can redistribute it and/or modify |
e8602e56 | 7 | it under the terms of the GNU General Public License as published by |
8c4c00c1 | 8 | the Free Software Foundation; either version 3, or (at your option) |
e8602e56 | 9 | any later version. |
10 | ||
4642865b | 11 | GCC is distributed in the hope that it will be useful, |
e8602e56 | 12 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 | GNU General Public License for more details. | |
15 | ||
16 | You should have received a copy of the GNU General Public License | |
8c4c00c1 | 17 | along with GCC; see the file COPYING3. If not see |
18 | <http://www.gnu.org/licenses/>. */ | |
e8602e56 | 19 | |
20 | #ifndef GCC_LANG_HOOKS_H | |
21 | #define GCC_LANG_HOOKS_H | |
22 | ||
4a020a8c | 23 | /* FIXME: This file should be #include-d after tree.h (for enum tree_code). */ |
b467ecc1 | 24 | |
b8c23db3 | 25 | struct diagnostic_info; |
6c7ff025 | 26 | |
1e8e9920 | 27 | struct gimplify_omp_ctx; |
28 | ||
1c79cc8c | 29 | struct array_descr_info; |
30 | ||
b7fced5e | 31 | /* A print hook for print_tree (). */ |
3ad4992f | 32 | typedef void (*lang_print_tree_hook) (FILE *, tree, int indent); |
b7fced5e | 33 | |
03a61d93 | 34 | enum classify_record |
35 | { RECORD_IS_STRUCT, RECORD_IS_CLASS, RECORD_IS_INTERFACE }; | |
36 | ||
3da97ff7 | 37 | class substring_loc; |
38 | ||
b0278d39 | 39 | /* The following hooks are documented in langhooks.c. Must not be |
40 | NULL. */ | |
41 | ||
42 | struct lang_hooks_for_tree_inlining | |
43 | { | |
1f8a6ff8 | 44 | bool (*var_mod_type_p) (tree, tree); |
b0278d39 | 45 | }; |
46 | ||
3119c950 | 47 | /* The following hooks are used by tree-dump.c. */ |
48 | ||
49 | struct lang_hooks_for_tree_dump | |
50 | { | |
6ef828f9 | 51 | /* Dump language-specific parts of tree nodes. Returns nonzero if it |
3119c950 | 52 | does not want the usual dumping of the second argument. */ |
3ad4992f | 53 | bool (*dump_tree) (void *, tree); |
3119c950 | 54 | |
55 | /* Determine type qualifiers in a language-specific way. */ | |
f8fd23c0 | 56 | int (*type_quals) (const_tree); |
3119c950 | 57 | }; |
58 | ||
a1f71e15 | 59 | /* Hooks related to types. */ |
60 | ||
61 | struct lang_hooks_for_types | |
62 | { | |
771d21fa | 63 | /* Return a new type (with the indicated CODE), doing whatever |
64 | language-specific processing is required. */ | |
3ad4992f | 65 | tree (*make_type) (enum tree_code); |
8851e806 | 66 | |
03a61d93 | 67 | /* Return what kind of RECORD_TYPE this is, mainly for purposes of |
68 | debug information. If not defined, record types are assumed to | |
69 | be structures. */ | |
70 | enum classify_record (*classify_record) (tree); | |
71 | ||
771d21fa | 72 | /* Given MODE and UNSIGNEDP, return a suitable type-tree with that |
73 | mode. */ | |
3754d046 | 74 | tree (*type_for_mode) (machine_mode, int); |
771d21fa | 75 | |
76 | /* Given PRECISION and UNSIGNEDP, return a suitable type-tree for an | |
77 | integer type with at least that precision. */ | |
3ad4992f | 78 | tree (*type_for_size) (unsigned, int); |
4070745f | 79 | |
0e4744ac | 80 | /* True if the type is an instantiation of a generic type, |
81 | e.g. C++ template implicit specializations. */ | |
f8fd23c0 | 82 | bool (*generic_p) (const_tree); |
0e4744ac | 83 | |
7c48f38c | 84 | /* Returns the TREE_VEC of elements of a given generic argument pack. */ |
85 | tree (*get_argument_pack_elems) (const_tree); | |
86 | ||
63c62881 | 87 | /* Given a type, apply default promotions to unnamed function |
88 | arguments and return the new type. Return the same type if no | |
89 | change. Required by any language that supports variadic | |
1fa3a8f6 | 90 | arguments. The default hook dies. */ |
3ad4992f | 91 | tree (*type_promotes_to) (tree); |
63c62881 | 92 | |
b268e47e | 93 | /* Register TYPE as a builtin type with the indicated NAME. The |
94 | TYPE is placed in the outermost lexical scope. The semantics | |
95 | should be analogous to: | |
96 | ||
97 | typedef TYPE NAME; | |
98 | ||
99 | in C. The default hook ignores the declaration. */ | |
100 | void (*register_builtin_type) (tree, const char *); | |
101 | ||
1dd25100 | 102 | /* This routine is called in tree.c to print an error message for |
103 | invalid use of an incomplete type. VALUE is the expression that | |
104 | was used (or 0 if that isn't known) and TYPE is the type that was | |
22a3f7bd | 105 | invalid. LOC is the location of the use. */ |
106 | void (*incomplete_type_error) (location_t loc, const_tree value, | |
107 | const_tree type); | |
a26d3281 | 108 | |
b225134e | 109 | /* Called from assign_temp to return the maximum size, if there is one, |
110 | for a type. */ | |
f8fd23c0 | 111 | tree (*max_size) (const_tree); |
b225134e | 112 | |
1e8e9920 | 113 | /* Register language specific type size variables as potentially OpenMP |
114 | firstprivate variables. */ | |
115 | void (*omp_firstprivatize_type_sizes) (struct gimplify_omp_ctx *, tree); | |
116 | ||
bc7bff74 | 117 | /* Return true if TYPE is a mappable type. */ |
118 | bool (*omp_mappable_type) (tree type); | |
119 | ||
743f8dd1 | 120 | /* Return TRUE if TYPE1 and TYPE2 are identical for type hashing purposes. |
121 | Called only after doing all language independent checks. | |
122 | At present, this function is only called when both TYPE1 and TYPE2 are | |
123 | FUNCTION_TYPEs. */ | |
124 | bool (*type_hash_eq) (const_tree, const_tree); | |
125 | ||
1c79cc8c | 126 | /* Return TRUE if TYPE uses a hidden descriptor and fills in information |
127 | for the debugger about the array bounds, strides, etc. */ | |
128 | bool (*get_array_descr_info) (const_tree, struct array_descr_info *); | |
129 | ||
a9538d68 | 130 | /* Fill in information for the debugger about the bounds of TYPE. */ |
131 | void (*get_subrange_bounds) (const_tree, tree *, tree *); | |
132 | ||
e0501e5f | 133 | /* Called on INTEGER_TYPEs. Return NULL_TREE for non-biased types. For |
134 | biased types, return as an INTEGER_CST node the value that is represented | |
135 | by a physical zero. */ | |
136 | tree (*get_type_bias) (const_tree); | |
137 | ||
818dee1b | 138 | /* A type descriptive of TYPE's complex layout generated to help the |
139 | debugger to decode variable-length or self-referential constructs. | |
140 | This is only used for the AT_GNAT_descriptive_type DWARF attribute. */ | |
141 | tree (*descriptive_type) (const_tree); | |
142 | ||
d991e6e8 | 143 | /* If we requested a pointer to a vector, build up the pointers that |
144 | we stripped off while looking for the inner type. Similarly for | |
145 | return values from functions. The argument TYPE is the top of the | |
146 | chain, and BOTTOM is the new type which we will point to. */ | |
147 | tree (*reconstruct_complex_type) (tree, tree); | |
1b006e46 | 148 | |
149 | /* Returns the tree that represents the underlying data type used to | |
150 | implement the enumeration. The default implementation will just use | |
151 | type_for_size. Used in dwarf2out.c to add a DW_AT_type base type | |
152 | reference to a DW_TAG_enumeration. */ | |
153 | tree (*enum_underlying_base_type) (const_tree); | |
db3c183a | 154 | |
155 | /* Return a type to use in the debug info instead of TYPE, or NULL_TREE to | |
156 | keep TYPE. This is useful to keep a single "source type" when the | |
157 | middle-end uses specialized types, for instance constrained discriminated | |
158 | types in Ada. */ | |
159 | tree (*get_debug_type) (const_tree); | |
6a3b696e | 160 | |
161 | /* Return TRUE if TYPE implements a fixed point type and fills in information | |
162 | for the debugger about scale factor, etc. */ | |
163 | bool (*get_fixed_point_type_info) (const_tree, | |
164 | struct fixed_point_type_info *); | |
a1f71e15 | 165 | }; |
166 | ||
20325f61 | 167 | /* Language hooks related to decls and the symbol table. */ |
168 | ||
169 | struct lang_hooks_for_decls | |
170 | { | |
1d2bb655 | 171 | /* Return true if we are in the global binding level. This hook is really |
172 | needed only if the language supports variable-sized types at the global | |
173 | level, i.e. declared outside subprograms. */ | |
174 | bool (*global_bindings_p) (void); | |
20325f61 | 175 | |
20325f61 | 176 | /* Function to add a decl to the current scope level. Takes one |
177 | argument, a decl to add. Returns that decl, or, if the same | |
178 | symbol is already declared, may return a different decl for that | |
179 | name. */ | |
3ad4992f | 180 | tree (*pushdecl) (tree); |
20325f61 | 181 | |
182 | /* Returns the chain of decls so far in the current scope level. */ | |
3ad4992f | 183 | tree (*getdecls) (void); |
8d58a5a7 | 184 | |
cb3582e7 | 185 | /* Returns true if DECL is explicit member function. */ |
832d369d | 186 | bool (*function_decl_explicit_p) (const_tree); |
cb3582e7 | 187 | |
77cab475 | 188 | /* Returns true if DECL is C++11 deleted special member function. */ |
832d369d | 189 | bool (*function_decl_deleted_p) (const_tree); |
190 | ||
191 | /* Returns 0 if DECL is NOT a C++11 defaulted special member | |
192 | function, 1 if it is explicitly defaulted within the class body, | |
193 | or 2 if it is explicitly defaulted outside the class body. */ | |
194 | int (*function_decl_defaulted) (const_tree); | |
77cab475 | 195 | |
7c48f38c | 196 | /* Returns True if the parameter is a generic parameter decl |
197 | of a generic type, e.g a template template parameter for the C++ FE. */ | |
198 | bool (*generic_generic_parameter_decl_p) (const_tree); | |
199 | ||
5d1e31fa | 200 | /* Determine if a function parameter got expanded from a |
201 | function parameter pack. */ | |
202 | bool (*function_parm_expanded_from_pack_p) (tree, tree); | |
203 | ||
204 | /* Returns the generic declaration of a generic function instantiations. */ | |
205 | tree (*get_generic_function_decl) (const_tree); | |
206 | ||
8d58a5a7 | 207 | /* Returns true when we should warn for an unused global DECL. |
208 | We will already have checked that it has static binding. */ | |
f8fd23c0 | 209 | bool (*warn_unused_global) (const_tree); |
28db4d96 | 210 | |
3a1c9df2 | 211 | /* Perform any post compilation-proper parser cleanups and |
212 | processing. This is currently only needed for the C++ parser, | |
213 | which hopefully can be cleaned up so this hook is no longer | |
214 | necessary. */ | |
215 | void (*post_compilation_parsing_cleanups) (void); | |
e2e9c55b | 216 | |
217 | /* True if this decl may be called via a sibcall. */ | |
9f627b1a | 218 | bool (*ok_for_sibcall) (const_tree); |
537cd941 | 219 | |
1e8e9920 | 220 | /* True if OpenMP should privatize what this DECL points to rather |
221 | than the DECL itself. */ | |
9f627b1a | 222 | bool (*omp_privatize_by_reference) (const_tree); |
1e8e9920 | 223 | |
224 | /* Return sharing kind if OpenMP sharing attribute of DECL is | |
225 | predetermined, OMP_CLAUSE_DEFAULT_UNSPECIFIED otherwise. */ | |
226 | enum omp_clause_default_kind (*omp_predetermined_sharing) (tree); | |
227 | ||
4ad75159 | 228 | /* Return decl that should be reported for DEFAULT(NONE) failure |
229 | diagnostics. Usually the DECL passed in. */ | |
230 | tree (*omp_report_decl) (tree); | |
231 | ||
1e8e9920 | 232 | /* Return true if DECL's DECL_VALUE_EXPR (if any) should be |
233 | disregarded in OpenMP construct, because it is going to be | |
234 | remapped during OpenMP lowering. SHARED is true if DECL | |
235 | is going to be shared, false if it is going to be privatized. */ | |
236 | bool (*omp_disregard_value_expr) (tree, bool); | |
237 | ||
238 | /* Return true if DECL that is shared iff SHARED is true should | |
239 | be put into OMP_CLAUSE_PRIVATE_DEBUG. */ | |
240 | bool (*omp_private_debug_clause) (tree, bool); | |
241 | ||
fd6481cf | 242 | /* Return true if DECL in private clause needs |
243 | OMP_CLAUSE_PRIVATE_OUTER_REF on the private clause. */ | |
244 | bool (*omp_private_outer_ref) (tree); | |
245 | ||
1e8e9920 | 246 | /* Build and return code for a default constructor for DECL in |
fd6481cf | 247 | response to CLAUSE. OUTER is corresponding outer region's |
248 | variable if needed. Return NULL if nothing to be done. */ | |
249 | tree (*omp_clause_default_ctor) (tree clause, tree decl, tree outer); | |
1e8e9920 | 250 | |
251 | /* Build and return code for a copy constructor from SRC to DST. */ | |
252 | tree (*omp_clause_copy_ctor) (tree clause, tree dst, tree src); | |
253 | ||
254 | /* Similarly, except use an assignment operator instead. */ | |
255 | tree (*omp_clause_assign_op) (tree clause, tree dst, tree src); | |
256 | ||
9580cb79 | 257 | /* Build and return code for a constructor of DST that sets it to |
258 | SRC + ADD. */ | |
259 | tree (*omp_clause_linear_ctor) (tree clause, tree dst, tree src, tree add); | |
260 | ||
1e8e9920 | 261 | /* Build and return code destructing DECL. Return NULL if nothing |
262 | to be done. */ | |
263 | tree (*omp_clause_dtor) (tree clause, tree decl); | |
fd6481cf | 264 | |
265 | /* Do language specific checking on an implicitly determined clause. */ | |
691447ab | 266 | void (*omp_finish_clause) (tree clause, gimple_seq *pre_p); |
20325f61 | 267 | }; |
268 | ||
7bfefa9d | 269 | /* Language hooks related to LTO serialization. */ |
270 | ||
271 | struct lang_hooks_for_lto | |
272 | { | |
273 | /* Begin a new LTO section named NAME. */ | |
274 | void (*begin_section) (const char *name); | |
275 | ||
276 | /* Write DATA of length LEN to the currently open LTO section. BLOCK is a | |
277 | pointer to the dynamically allocated memory containing DATA. The | |
278 | append_data function is responsible for freeing it when it is no longer | |
279 | needed. */ | |
280 | void (*append_data) (const void *data, size_t len, void *block); | |
281 | ||
282 | /* End the previously begun LTO section. */ | |
283 | void (*end_section) (void); | |
284 | }; | |
285 | ||
b0278d39 | 286 | /* Language-specific hooks. See langhooks-def.h for defaults. */ |
287 | ||
288 | struct lang_hooks | |
289 | { | |
3a4a2292 | 290 | /* String identifying the front end and optionally language standard |
291 | version, e.g. "GNU C++98" or "GNU Java". */ | |
d19bd1f0 | 292 | const char *name; |
293 | ||
294 | /* sizeof (struct lang_identifier), so make_node () creates | |
295 | identifier nodes long enough for the language-specific slots. */ | |
296 | size_t identifier_size; | |
297 | ||
34e5cced | 298 | /* Remove any parts of the tree that are used only by the FE. */ |
299 | void (*free_lang_data) (tree); | |
300 | ||
ce45a448 | 301 | /* Determines the size of any language-specific tcc_constant or |
302 | tcc_exceptional nodes. Since it is called from make_node, the | |
1fa3a8f6 | 303 | only information available is the tree code. Expected to die |
ce45a448 | 304 | on unrecognized codes. */ |
3ad4992f | 305 | size_t (*tree_size) (enum tree_code); |
295e387a | 306 | |
e88d34f6 | 307 | /* Return the language mask used for converting argv into a sequence |
308 | of options. */ | |
309 | unsigned int (*option_lang_mask) (void); | |
310 | ||
f3f006ad | 311 | /* Initialize variables in an options structure. */ |
312 | void (*init_options_struct) (struct gcc_options *opts); | |
313 | ||
e88d34f6 | 314 | /* After the initialize_diagnostics hook is called, do any simple |
f3f006ad | 315 | initialization needed before any calls to handle_option, other |
316 | than that done by the init_options_struct hook. */ | |
e88d34f6 | 317 | void (*init_options) (unsigned int decoded_options_count, |
318 | struct cl_decoded_option *decoded_options); | |
b0278d39 | 319 | |
f63da8d3 | 320 | /* Callback used to perform language-specific initialization for the |
321 | global diagnostic context structure. */ | |
24ca3b4e | 322 | void (*initialize_diagnostics) (diagnostic_context *); |
f63da8d3 | 323 | |
e88d34f6 | 324 | /* Return true if a warning should be given about option OPTION, |
325 | which is for the wrong language, false if it should be quietly | |
326 | ignored. */ | |
327 | bool (*complain_wrong_lang_p) (const struct cl_option *option); | |
328 | ||
5457b645 | 329 | /* Handle the switch CODE, which has real type enum opt_code from |
330 | options.h. If the switch takes an argument, it is passed in ARG | |
917bbcab | 331 | which points to permanent storage. The handler is responsible for |
5457b645 | 332 | checking whether ARG is NULL, which indicates that no argument |
333 | was in fact supplied. For -f and -W switches, VALUE is 1 or 0 | |
b78351e5 | 334 | for the positive and negative forms respectively. HANDLERS should |
3c6c0e40 | 335 | be passed to any recursive handle_option calls. LOC is the |
336 | location of the option. | |
5457b645 | 337 | |
b78351e5 | 338 | Return true if the switch is valid, false if invalid. */ |
339 | bool (*handle_option) (size_t code, const char *arg, int value, int kind, | |
3c6c0e40 | 340 | location_t loc, |
b78351e5 | 341 | const struct cl_option_handlers *handlers); |
5457b645 | 342 | |
03bde601 | 343 | /* Called when all command line options have been parsed to allow |
344 | further processing and initialization | |
dd436eaf | 345 | |
03bde601 | 346 | Should return true to indicate that a compiler back-end is |
347 | not required, such as with the -E option. | |
3ad4992f | 348 | |
6ef828f9 | 349 | If errorcount is nonzero after this call the compiler exits |
dd436eaf | 350 | immediately and the finish hook is not called. */ |
3ad4992f | 351 | bool (*post_options) (const char **); |
03bde601 | 352 | |
353 | /* Called after post_options to initialize the front end. Return | |
354 | false to indicate that no further compilation be performed, in | |
355 | which case the finish hook is called immediately. */ | |
3ad4992f | 356 | bool (*init) (void); |
435fb09b | 357 | |
358 | /* Called at the end of compilation, as a finalizer. */ | |
3ad4992f | 359 | void (*finish) (void); |
435fb09b | 360 | |
b8ba44e7 | 361 | /* Parses the entire file. */ |
362 | void (*parse_file) (void); | |
b78207a0 | 363 | |
b75409ba | 364 | /* Determines if it's ok for a function to have no noreturn attribute. */ |
365 | bool (*missing_noreturn_ok_p) (tree); | |
366 | ||
b0278d39 | 367 | /* Called to obtain the alias set to be used for an expression or type. |
368 | Returns -1 if the language does nothing special for it. */ | |
32c2fdea | 369 | alias_set_type (*get_alias_set) (tree); |
b0278d39 | 370 | |
ee23fd7b | 371 | /* Function to finish handling an incomplete decl at the end of |
372 | compilation. Default hook is does nothing. */ | |
3ad4992f | 373 | void (*finish_incomplete_decl) (tree); |
ee23fd7b | 374 | |
dbc42b78 | 375 | /* Replace the DECL_LANG_SPECIFIC data, which may be NULL, of the |
376 | DECL_NODE with a newly GC-allocated copy. */ | |
3ad4992f | 377 | void (*dup_lang_specific_decl) (tree); |
dbc42b78 | 378 | |
d1f6c8f2 | 379 | /* Set the DECL_ASSEMBLER_NAME for a node. If it is the sort of |
380 | thing that the assembler should talk about, set | |
381 | DECL_ASSEMBLER_NAME to an appropriate IDENTIFIER_NODE. | |
382 | Otherwise, set it to the ERROR_MARK_NODE to ensure that the | |
383 | assembler does not talk about it. */ | |
3ad4992f | 384 | void (*set_decl_assembler_name) (tree); |
d1f6c8f2 | 385 | |
b7fced5e | 386 | /* The front end can add its own statistics to -fmem-report with |
387 | this hook. It should output to stderr. */ | |
3ad4992f | 388 | void (*print_statistics) (void); |
b7fced5e | 389 | |
ce45a448 | 390 | /* Called by print_tree when there is a tree of class tcc_exceptional |
391 | that it doesn't know how to display. */ | |
b7fced5e | 392 | lang_print_tree_hook print_xnode; |
393 | ||
ce45a448 | 394 | /* Called to print language-dependent parts of tcc_decl, tcc_type, |
395 | and IDENTIFIER_NODE nodes. */ | |
b7fced5e | 396 | lang_print_tree_hook print_decl; |
397 | lang_print_tree_hook print_type; | |
398 | lang_print_tree_hook print_identifier; | |
399 | ||
96554925 | 400 | /* Computes the name to use to print a declaration. DECL is the |
401 | non-NULL declaration in question. VERBOSITY determines what | |
402 | information will be printed: 0: DECL_NAME, demangled as | |
403 | necessary. 1: and scope information. 2: and any other | |
404 | information that might be interesting, such as function parameter | |
abd3e6b5 | 405 | types in C++. The name is in the internal character set and |
406 | needs to be converted to the locale character set of diagnostics, | |
407 | or to the execution character set for strings such as | |
408 | __PRETTY_FUNCTION__. */ | |
3ad4992f | 409 | const char *(*decl_printable_name) (tree decl, int verbosity); |
96554925 | 410 | |
7d709201 | 411 | /* Computes the dwarf-2/3 name for a tree. VERBOSITY determines what |
412 | information will be printed: 0: DECL_NAME, demangled as | |
413 | necessary. 1: and scope information. */ | |
414 | const char *(*dwarf_name) (tree, int verbosity); | |
415 | ||
4ee9c684 | 416 | /* This compares two types for equivalence ("compatible" in C-based languages). |
417 | This routine should only return 1 if it is sure. It should not be used | |
418 | in contexts where erroneously returning 0 causes problems. */ | |
419 | int (*types_compatible_p) (tree x, tree y); | |
420 | ||
6c7ff025 | 421 | /* Called by report_error_function to print out function name. */ |
24ca3b4e | 422 | void (*print_error_function) (diagnostic_context *, const char *, |
b8c23db3 | 423 | struct diagnostic_info *); |
6c7ff025 | 424 | |
624d37a6 | 425 | /* Convert a character from the host's to the target's character |
426 | set. The character should be in what C calls the "basic source | |
427 | character set" (roughly, the set of characters defined by plain | |
428 | old ASCII). The default is to return the character unchanged, | |
429 | which is correct in most circumstances. Note that both argument | |
430 | and result should be sign-extended under -fsigned-char, | |
431 | zero-extended under -fno-signed-char. */ | |
432 | HOST_WIDE_INT (*to_target_charset) (HOST_WIDE_INT); | |
433 | ||
f8e93a2e | 434 | /* Pointers to machine-independent attribute tables, for front ends |
435 | using attribs.c. If one is NULL, it is ignored. Respectively, a | |
436 | table of attributes specific to the language, a table of | |
437 | attributes common to two or more languages (to allow easy | |
438 | sharing), and a table of attributes for checking formats. */ | |
439 | const struct attribute_spec *attribute_table; | |
440 | const struct attribute_spec *common_attribute_table; | |
441 | const struct attribute_spec *format_attribute_table; | |
442 | ||
b0278d39 | 443 | struct lang_hooks_for_tree_inlining tree_inlining; |
8851e806 | 444 | |
3119c950 | 445 | struct lang_hooks_for_tree_dump tree_dump; |
b0278d39 | 446 | |
20325f61 | 447 | struct lang_hooks_for_decls decls; |
448 | ||
a1f71e15 | 449 | struct lang_hooks_for_types types; |
d037099f | 450 | |
7bfefa9d | 451 | struct lang_hooks_for_lto lto; |
452 | ||
48adf3f3 | 453 | /* Returns a TREE_VEC of the generic parameters of an instantiation of |
454 | a generic type or decl, e.g. C++ template instantiation. If | |
455 | TREE_CHAIN of the return value is set, it is an INTEGER_CST | |
456 | indicating how many of the elements are non-default. */ | |
7c48f38c | 457 | tree (*get_innermost_generic_parms) (const_tree); |
458 | ||
459 | /* Returns the TREE_VEC of arguments of an instantiation | |
460 | of a generic type of decl, e.g. C++ template instantiation. */ | |
461 | tree (*get_innermost_generic_args) (const_tree); | |
462 | ||
5d1e31fa | 463 | /* Determine if a tree is a function parameter pack. */ |
464 | bool (*function_parameter_pack_p) (const_tree); | |
465 | ||
4ee9c684 | 466 | /* Perform language-specific gimplification on the argument. Returns an |
467 | enum gimplify_status, though we can't see that type here. */ | |
75a70cf9 | 468 | int (*gimplify_expr) (tree *, gimple_seq *, gimple_seq *); |
4ee9c684 | 469 | |
54be5d7e | 470 | /* Do language specific processing in the builtin function DECL */ |
471 | tree (*builtin_function) (tree decl); | |
e60d3615 | 472 | |
24470055 | 473 | /* Like builtin_function, but make sure the scope is the external scope. |
474 | This is used to delay putting in back end builtin functions until the ISA | |
475 | that defines the builtin is declared via function specific target options, | |
476 | which can save memory for machines like the x86_64 that have multiple | |
477 | ISAs. If this points to the same function as builtin_function, the | |
478 | backend must add all of the builtins at program initialization time. */ | |
479 | tree (*builtin_function_ext_scope) (tree decl); | |
480 | ||
5ded8c6f | 481 | /* Used to set up the tree_contains_structure array for a frontend. */ |
482 | void (*init_ts) (void); | |
483 | ||
750ad201 | 484 | /* Called by recompute_tree_invariant_for_addr_expr to go from EXPR |
c7d4e749 | 485 | to a contained expression or DECL, possibly updating *TC or *SE |
486 | if in the process TREE_CONSTANT or TREE_SIDE_EFFECTS need updating. */ | |
487 | tree (*expr_to_decl) (tree expr, bool *tc, bool *se); | |
54d7165a | 488 | |
58d82cd0 | 489 | /* The EH personality function decl. */ |
490 | tree (*eh_personality) (void); | |
491 | ||
492 | /* Map a type to a runtime object to match type. */ | |
493 | tree (*eh_runtime_type) (tree); | |
494 | ||
596981c8 | 495 | /* If non-NULL, this is a function that returns a function decl to be |
496 | executed if an unhandled exception is propagated out of a cleanup | |
497 | region. For example, in C++, an exception thrown by a destructor | |
498 | during stack unwinding is required to result in a call to | |
499 | `std::terminate', so the C++ version of this function returns a | |
500 | FUNCTION_DECL for `std::terminate'. */ | |
501 | tree (*eh_protect_cleanup_actions) (void); | |
502 | ||
6cb25bec | 503 | /* Return true if a stmt can fallthru. Used by block_may_fallthru |
504 | to possibly handle language trees. */ | |
505 | bool (*block_may_fallthru) (const_tree); | |
506 | ||
471eff36 | 507 | /* True if this language uses __cxa_end_cleanup when the ARM EABI |
508 | is enabled. */ | |
509 | bool eh_use_cxa_end_cleanup; | |
510 | ||
f96dd706 | 511 | /* True if this language requires deep unsharing of tree nodes prior to |
512 | gimplification. */ | |
513 | bool deep_unsharing; | |
514 | ||
7af4d06b | 515 | /* Run all lang-specific selftests. */ |
516 | void (*run_lang_selftests) (void); | |
517 | ||
3da97ff7 | 518 | /* Attempt to determine the source location of the substring. |
519 | If successful, return NULL and write the source location to *OUT_LOC. | |
520 | Otherwise return an error message. Error messages are intended | |
521 | for GCC developers (to help debugging) rather than for end-users. */ | |
522 | const char *(*get_substring_location) (const substring_loc &, | |
523 | location_t *out_loc); | |
524 | ||
3119c950 | 525 | /* Whenever you add entries here, make sure you adjust langhooks-def.h |
b0278d39 | 526 | and langhooks.c accordingly. */ |
527 | }; | |
528 | ||
529 | /* Each front end provides its own. */ | |
34e5cced | 530 | extern struct lang_hooks lang_hooks; |
549aab72 | 531 | |
54be5d7e | 532 | extern tree add_builtin_function (const char *name, tree type, |
533 | int function_code, enum built_in_class cl, | |
534 | const char *library_name, | |
535 | tree attrs); | |
e8602e56 | 536 | |
24470055 | 537 | extern tree add_builtin_function_ext_scope (const char *name, tree type, |
538 | int function_code, | |
539 | enum built_in_class cl, | |
540 | const char *library_name, | |
541 | tree attrs); | |
549aab72 | 542 | extern tree add_builtin_type (const char *name, tree type); |
3a4a2292 | 543 | |
544 | /* Language helper functions. */ | |
545 | ||
546 | extern bool lang_GNU_C (void); | |
547 | extern bool lang_GNU_CXX (void); | |
f36f9b8b | 548 | extern bool lang_GNU_Fortran (void); |
549aab72 | 549 | |
e8602e56 | 550 | #endif /* GCC_LANG_HOOKS_H */ |