Clean up some minor white space issues in trans-decl.c and trans-expr.c
[official-gcc.git] / gcc / langhooks.c
blob7c07175d8101806a3b76f40041b5937ecba5bd7c
1 /* Default language-specific hooks.
2 Copyright (C) 2001-2016 Free Software Foundation, Inc.
3 Contributed by Alexandre Oliva <aoliva@redhat.com>
5 This file is part of GCC.
7 GCC 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 3, or (at your option)
10 any later version.
12 GCC 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.
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING3. If not see
19 <http://www.gnu.org/licenses/>. */
21 #include "config.h"
22 #include "system.h"
23 #include "coretypes.h"
24 #include "target.h"
25 #include "rtl.h"
26 #include "tree.h"
27 #include "timevar.h"
28 #include "stringpool.h"
29 #include "diagnostic.h"
30 #include "intl.h"
31 #include "toplev.h"
32 #include "attribs.h"
33 #include "gimplify.h"
34 #include "langhooks.h"
35 #include "tree-diagnostic.h"
36 #include "output.h"
37 #include "timevar.h"
39 /* Do nothing; in many cases the default hook. */
41 void
42 lhd_do_nothing (void)
46 /* Do nothing (tree). */
48 void
49 lhd_do_nothing_t (tree ARG_UNUSED (t))
53 /* Pass through (tree). */
54 tree
55 lhd_pass_through_t (tree t)
57 return t;
60 /* Do nothing (int, int, int). Return NULL_TREE. */
62 tree
63 lhd_do_nothing_iii_return_null_tree (int ARG_UNUSED (i),
64 int ARG_UNUSED (j),
65 int ARG_UNUSED (k))
67 return NULL_TREE;
70 /* Do nothing (function). */
72 void
73 lhd_do_nothing_f (struct function * ARG_UNUSED (f))
77 /* Do nothing (return NULL_TREE). */
79 tree
80 lhd_return_null_tree_v (void)
82 return NULL_TREE;
85 /* Do nothing (return NULL_TREE). */
87 tree
88 lhd_return_null_tree (tree ARG_UNUSED (t))
90 return NULL_TREE;
93 /* Do nothing (return NULL_TREE). */
95 tree
96 lhd_return_null_const_tree (const_tree ARG_UNUSED (t))
98 return NULL_TREE;
101 /* The default post options hook. */
103 bool
104 lhd_post_options (const char ** ARG_UNUSED (pfilename))
106 /* Excess precision other than "fast" requires front-end
107 support. */
108 flag_excess_precision_cmdline = EXCESS_PRECISION_FAST;
109 return false;
112 /* Called from by print-tree.c. */
114 void
115 lhd_print_tree_nothing (FILE * ARG_UNUSED (file),
116 tree ARG_UNUSED (node),
117 int ARG_UNUSED (indent))
121 /* Called from check_global_declaration. */
123 bool
124 lhd_warn_unused_global_decl (const_tree decl)
126 /* This is what used to exist in check_global_declaration. Probably
127 not many of these actually apply to non-C languages. */
129 if (TREE_CODE (decl) == FUNCTION_DECL && DECL_DECLARED_INLINE_P (decl))
130 return false;
131 if (TREE_CODE (decl) == VAR_DECL && TREE_READONLY (decl))
132 return false;
133 if (DECL_IN_SYSTEM_HEADER (decl))
134 return false;
136 return true;
139 /* Set the DECL_ASSEMBLER_NAME for DECL. */
140 void
141 lhd_set_decl_assembler_name (tree decl)
143 tree id;
145 /* set_decl_assembler_name may be called on TYPE_DECL to record ODR
146 name for C++ types. By default types have no ODR names. */
147 if (TREE_CODE (decl) == TYPE_DECL)
148 return;
150 /* The language-independent code should never use the
151 DECL_ASSEMBLER_NAME for lots of DECLs. Only FUNCTION_DECLs and
152 VAR_DECLs for variables with static storage duration need a real
153 DECL_ASSEMBLER_NAME. */
154 gcc_assert (TREE_CODE (decl) == FUNCTION_DECL
155 || (TREE_CODE (decl) == VAR_DECL
156 && (TREE_STATIC (decl)
157 || DECL_EXTERNAL (decl)
158 || TREE_PUBLIC (decl))));
160 /* By default, assume the name to use in assembly code is the same
161 as that used in the source language. (That's correct for C, and
162 GCC used to set DECL_ASSEMBLER_NAME to the same value as
163 DECL_NAME in build_decl, so this choice provides backwards
164 compatibility with existing front-ends. This assumption is wrapped
165 in a target hook, to allow for target-specific modification of the
166 identifier.
168 Can't use just the variable's own name for a variable whose scope
169 is less than the whole compilation. Concatenate a distinguishing
170 number - we use the DECL_UID. */
172 if (TREE_PUBLIC (decl) || DECL_FILE_SCOPE_P (decl))
173 id = targetm.mangle_decl_assembler_name (decl, DECL_NAME (decl));
174 else
176 const char *name = IDENTIFIER_POINTER (DECL_NAME (decl));
177 char *label;
179 ASM_FORMAT_PRIVATE_NAME (label, name, DECL_UID (decl));
180 id = get_identifier (label);
182 SET_DECL_ASSEMBLER_NAME (decl, id);
186 /* Type promotion for variable arguments. */
187 tree
188 lhd_type_promotes_to (tree ARG_UNUSED (type))
190 gcc_unreachable ();
193 /* Registration of machine- or os-specific builtin types. */
194 void
195 lhd_register_builtin_type (tree ARG_UNUSED (type),
196 const char * ARG_UNUSED (name))
200 /* Invalid use of an incomplete type. */
201 void
202 lhd_incomplete_type_error (const_tree ARG_UNUSED (value), const_tree type)
204 gcc_assert (TREE_CODE (type) == ERROR_MARK);
205 return;
208 /* Provide a default routine for alias sets that always returns -1. This
209 is used by languages that don't need to do anything special. */
211 alias_set_type
212 lhd_get_alias_set (tree ARG_UNUSED (t))
214 return -1;
217 /* This is the default decl_printable_name function. */
219 const char *
220 lhd_decl_printable_name (tree decl, int ARG_UNUSED (verbosity))
222 gcc_assert (decl && DECL_NAME (decl));
223 return IDENTIFIER_POINTER (DECL_NAME (decl));
226 /* This is the default dwarf_name function. */
228 const char *
229 lhd_dwarf_name (tree t, int verbosity)
231 gcc_assert (DECL_P (t));
233 return lang_hooks.decl_printable_name (t, verbosity);
236 /* This compares two types for equivalence ("compatible" in C-based languages).
237 This routine should only return 1 if it is sure. It should not be used
238 in contexts where erroneously returning 0 causes problems. */
241 lhd_types_compatible_p (tree x, tree y)
243 return TYPE_MAIN_VARIANT (x) == TYPE_MAIN_VARIANT (y);
246 /* lang_hooks.tree_dump.dump_tree: Dump language-specific parts of tree
247 nodes. Returns nonzero if it does not want the usual dumping of the
248 second argument. */
250 bool
251 lhd_tree_dump_dump_tree (void *di ATTRIBUTE_UNUSED, tree t ATTRIBUTE_UNUSED)
253 return false;
256 /* lang_hooks.tree_dump.type_qual: Determine type qualifiers in a
257 language-specific way. */
260 lhd_tree_dump_type_quals (const_tree t)
262 return TYPE_QUALS (t);
265 /* lang_hooks.gimplify_expr re-writes *EXPR_P into GIMPLE form. */
268 lhd_gimplify_expr (tree *expr_p ATTRIBUTE_UNUSED,
269 gimple_seq *pre_p ATTRIBUTE_UNUSED,
270 gimple_seq *post_p ATTRIBUTE_UNUSED)
272 return GS_UNHANDLED;
275 /* lang_hooks.tree_size: Determine the size of a tree with code C,
276 which is a language-specific tree code in category tcc_constant or
277 tcc_exceptional. The default expects never to be called. */
278 size_t
279 lhd_tree_size (enum tree_code c ATTRIBUTE_UNUSED)
281 gcc_unreachable ();
284 /* Return true if decl, which is a function decl, may be called by a
285 sibcall. */
287 bool
288 lhd_decl_ok_for_sibcall (const_tree decl ATTRIBUTE_UNUSED)
290 return true;
293 /* Generic global declaration processing. This is meant to be called
294 by the front-ends at the end of parsing. C/C++ do their own thing,
295 but other front-ends may call this. */
297 void
298 global_decl_processing (void)
300 tree globals, decl, *vec;
301 int len, i;
303 timevar_stop (TV_PHASE_PARSING);
304 timevar_start (TV_PHASE_DEFERRED);
305 /* Really define vars that have had only a tentative definition.
306 Really output inline functions that must actually be callable
307 and have not been output so far. */
309 globals = lang_hooks.decls.getdecls ();
310 len = list_length (globals);
311 vec = XNEWVEC (tree, len);
313 /* Process the decls in reverse order--earliest first.
314 Put them into VEC from back to front, then take out from front. */
316 for (i = 0, decl = globals; i < len; i++, decl = DECL_CHAIN (decl))
317 vec[len - i - 1] = decl;
319 wrapup_global_declarations (vec, len);
320 timevar_stop (TV_PHASE_DEFERRED);
322 timevar_start (TV_PHASE_PARSING);
323 free (vec);
326 /* Called to perform language-specific initialization of CTX. */
327 void
328 lhd_initialize_diagnostics (diagnostic_context *ctx ATTRIBUTE_UNUSED)
332 /* Called to perform language-specific options initialization. */
333 void
334 lhd_init_options (unsigned int decoded_options_count ATTRIBUTE_UNUSED,
335 struct cl_decoded_option *decoded_options ATTRIBUTE_UNUSED)
339 /* By default, always complain about options for the wrong language. */
340 bool
341 lhd_complain_wrong_lang_p (const struct cl_option *option ATTRIBUTE_UNUSED)
343 return true;
346 /* By default, no language-specific options are valid. */
347 bool
348 lhd_handle_option (size_t code ATTRIBUTE_UNUSED,
349 const char *arg ATTRIBUTE_UNUSED,
350 int value ATTRIBUTE_UNUSED, int kind ATTRIBUTE_UNUSED,
351 location_t loc ATTRIBUTE_UNUSED,
352 const struct cl_option_handlers *handlers ATTRIBUTE_UNUSED)
354 return false;
357 /* The default function to print out name of current function that caused
358 an error. */
359 void
360 lhd_print_error_function (diagnostic_context *context, const char *file,
361 diagnostic_info *diagnostic)
363 if (diagnostic_last_function_changed (context, diagnostic))
365 const char *old_prefix = context->printer->prefix;
366 tree abstract_origin = diagnostic_abstract_origin (diagnostic);
367 char *new_prefix = (file && abstract_origin == NULL)
368 ? file_name_as_prefix (context, file) : NULL;
370 pp_set_prefix (context->printer, new_prefix);
372 if (current_function_decl == NULL)
373 pp_printf (context->printer, _("At top level:"));
374 else
376 tree fndecl, ao;
378 if (abstract_origin)
380 ao = BLOCK_ABSTRACT_ORIGIN (abstract_origin);
381 while (TREE_CODE (ao) == BLOCK
382 && BLOCK_ABSTRACT_ORIGIN (ao)
383 && BLOCK_ABSTRACT_ORIGIN (ao) != ao)
384 ao = BLOCK_ABSTRACT_ORIGIN (ao);
385 gcc_assert (TREE_CODE (ao) == FUNCTION_DECL);
386 fndecl = ao;
388 else
389 fndecl = current_function_decl;
391 if (TREE_CODE (TREE_TYPE (fndecl)) == METHOD_TYPE)
392 pp_printf
393 (context->printer, _("In member function %qs"),
394 identifier_to_locale (lang_hooks.decl_printable_name (fndecl, 2)));
395 else
396 pp_printf
397 (context->printer, _("In function %qs"),
398 identifier_to_locale (lang_hooks.decl_printable_name (fndecl, 2)));
400 while (abstract_origin)
402 location_t *locus;
403 tree block = abstract_origin;
405 locus = &BLOCK_SOURCE_LOCATION (block);
406 fndecl = NULL;
407 block = BLOCK_SUPERCONTEXT (block);
408 while (block && TREE_CODE (block) == BLOCK
409 && BLOCK_ABSTRACT_ORIGIN (block))
411 ao = BLOCK_ABSTRACT_ORIGIN (block);
413 while (TREE_CODE (ao) == BLOCK
414 && BLOCK_ABSTRACT_ORIGIN (ao)
415 && BLOCK_ABSTRACT_ORIGIN (ao) != ao)
416 ao = BLOCK_ABSTRACT_ORIGIN (ao);
418 if (TREE_CODE (ao) == FUNCTION_DECL)
420 fndecl = ao;
421 break;
423 else if (TREE_CODE (ao) != BLOCK)
424 break;
426 block = BLOCK_SUPERCONTEXT (block);
428 if (fndecl)
429 abstract_origin = block;
430 else
432 while (block && TREE_CODE (block) == BLOCK)
433 block = BLOCK_SUPERCONTEXT (block);
435 if (block && TREE_CODE (block) == FUNCTION_DECL)
436 fndecl = block;
437 abstract_origin = NULL;
439 if (fndecl)
441 expanded_location s = expand_location (*locus);
442 pp_comma (context->printer);
443 pp_newline (context->printer);
444 if (s.file != NULL)
446 if (context->show_column)
447 pp_printf (context->printer,
448 _(" inlined from %qs at %r%s:%d:%d%R"),
449 identifier_to_locale (lang_hooks.decl_printable_name (fndecl, 2)),
450 "locus", s.file, s.line, s.column);
451 else
452 pp_printf (context->printer,
453 _(" inlined from %qs at %r%s:%d%R"),
454 identifier_to_locale (lang_hooks.decl_printable_name (fndecl, 2)),
455 "locus", s.file, s.line);
458 else
459 pp_printf (context->printer, _(" inlined from %qs"),
460 identifier_to_locale (lang_hooks.decl_printable_name (fndecl, 2)));
463 pp_colon (context->printer);
466 diagnostic_set_last_function (context, diagnostic);
467 pp_newline_and_flush (context->printer);
468 context->printer->prefix = old_prefix;
469 free ((char*) new_prefix);
473 tree
474 lhd_make_node (enum tree_code code)
476 return make_node (code);
479 HOST_WIDE_INT
480 lhd_to_target_charset (HOST_WIDE_INT c)
482 return c;
485 tree
486 lhd_expr_to_decl (tree expr, bool *tc ATTRIBUTE_UNUSED, bool *se ATTRIBUTE_UNUSED)
488 return expr;
491 /* Return sharing kind if OpenMP sharing attribute of DECL is
492 predetermined, OMP_CLAUSE_DEFAULT_UNSPECIFIED otherwise. */
494 enum omp_clause_default_kind
495 lhd_omp_predetermined_sharing (tree decl ATTRIBUTE_UNUSED)
497 if (DECL_ARTIFICIAL (decl))
498 return OMP_CLAUSE_DEFAULT_SHARED;
499 return OMP_CLAUSE_DEFAULT_UNSPECIFIED;
502 /* Generate code to copy SRC to DST. */
504 tree
505 lhd_omp_assignment (tree clause ATTRIBUTE_UNUSED, tree dst, tree src)
507 return build2 (MODIFY_EXPR, TREE_TYPE (dst), dst, src);
510 /* Finalize clause C. */
512 void
513 lhd_omp_finish_clause (tree, gimple_seq *)
517 /* Register language specific type size variables as potentially OpenMP
518 firstprivate variables. */
520 void
521 lhd_omp_firstprivatize_type_sizes (struct gimplify_omp_ctx *c ATTRIBUTE_UNUSED,
522 tree t ATTRIBUTE_UNUSED)
526 /* Return true if TYPE is an OpenMP mappable type. */
528 bool
529 lhd_omp_mappable_type (tree type)
531 /* Mappable type has to be complete. */
532 if (type == error_mark_node || !COMPLETE_TYPE_P (type))
533 return false;
534 return true;
537 /* Common function for add_builtin_function and
538 add_builtin_function_ext_scope. */
539 static tree
540 add_builtin_function_common (const char *name,
541 tree type,
542 int function_code,
543 enum built_in_class cl,
544 const char *library_name,
545 tree attrs,
546 tree (*hook) (tree))
548 tree id = get_identifier (name);
549 tree decl = build_decl (BUILTINS_LOCATION, FUNCTION_DECL, id, type);
551 TREE_PUBLIC (decl) = 1;
552 DECL_EXTERNAL (decl) = 1;
553 DECL_BUILT_IN_CLASS (decl) = cl;
555 DECL_FUNCTION_CODE (decl) = (enum built_in_function) function_code;
557 /* DECL_FUNCTION_CODE is a bitfield; verify that the value fits. */
558 gcc_assert (DECL_FUNCTION_CODE (decl) == function_code);
560 if (library_name)
562 tree libname = get_identifier (library_name);
563 SET_DECL_ASSEMBLER_NAME (decl, libname);
566 /* Possibly apply some default attributes to this built-in function. */
567 if (attrs)
568 decl_attributes (&decl, attrs, ATTR_FLAG_BUILT_IN);
569 else
570 decl_attributes (&decl, NULL_TREE, 0);
572 return hook (decl);
576 /* Create a builtin function. */
578 tree
579 add_builtin_function (const char *name,
580 tree type,
581 int function_code,
582 enum built_in_class cl,
583 const char *library_name,
584 tree attrs)
586 return add_builtin_function_common (name, type, function_code, cl,
587 library_name, attrs,
588 lang_hooks.builtin_function);
591 /* Like add_builtin_function, but make sure the scope is the external scope.
592 This is used to delay putting in back end builtin functions until the ISA
593 that defines the builtin is declared via function specific target options,
594 which can save memory for machines like the x86_64 that have multiple ISAs.
595 If this points to the same function as builtin_function, the backend must
596 add all of the builtins at program initialization time. */
598 tree
599 add_builtin_function_ext_scope (const char *name,
600 tree type,
601 int function_code,
602 enum built_in_class cl,
603 const char *library_name,
604 tree attrs)
606 return add_builtin_function_common (name, type, function_code, cl,
607 library_name, attrs,
608 lang_hooks.builtin_function_ext_scope);
611 tree
612 lhd_builtin_function (tree decl)
614 lang_hooks.decls.pushdecl (decl);
615 return decl;
618 /* Create a builtin type. */
620 tree
621 add_builtin_type (const char *name, tree type)
623 tree id = get_identifier (name);
624 tree decl = build_decl (BUILTINS_LOCATION, TYPE_DECL, id, type);
625 return lang_hooks.decls.pushdecl (decl);
628 /* LTO hooks. */
630 /* Used to save and restore any previously active section. */
631 static section *saved_section;
634 /* Begin a new LTO output section named NAME. This default implementation
635 saves the old section and emits assembly code to switch to the new
636 section. */
638 void
639 lhd_begin_section (const char *name)
641 section *section;
643 /* Save the old section so we can restore it in lto_end_asm_section. */
644 gcc_assert (!saved_section);
645 saved_section = in_section;
646 if (!saved_section)
647 saved_section = text_section;
649 /* Create a new section and switch to it. */
650 section = get_section (name, SECTION_DEBUG | SECTION_EXCLUDE, NULL);
651 switch_to_section (section);
655 /* Write DATA of length LEN to the current LTO output section. This default
656 implementation just calls assemble_string. */
658 void
659 lhd_append_data (const void *data, size_t len, void *)
661 if (data)
663 timevar_push (TV_IPA_LTO_OUTPUT);
664 assemble_string ((const char *)data, len);
665 timevar_pop (TV_IPA_LTO_OUTPUT);
670 /* Finish the current LTO output section. This default implementation emits
671 assembly code to switch to any section previously saved by
672 lhd_begin_section. */
674 void
675 lhd_end_section (void)
677 if (saved_section)
679 switch_to_section (saved_section);
680 saved_section = NULL;
684 /* Default implementation of enum_underlying_base_type using type_for_size. */
686 tree
687 lhd_enum_underlying_base_type (const_tree enum_type)
689 return lang_hooks.types.type_for_size (TYPE_PRECISION (enum_type),
690 TYPE_UNSIGNED (enum_type));
693 /* Returns true if the current lang_hooks represents the GNU C frontend. */
695 bool
696 lang_GNU_C (void)
698 return (strncmp (lang_hooks.name, "GNU C", 5) == 0
699 && (lang_hooks.name[5] == '\0' || ISDIGIT (lang_hooks.name[5])));
702 /* Returns true if the current lang_hooks represents the GNU C++ frontend. */
704 bool
705 lang_GNU_CXX (void)
707 return strncmp (lang_hooks.name, "GNU C++", 7) == 0;
710 /* Returns true if the current lang_hooks represents the GNU Fortran frontend. */
712 bool
713 lang_GNU_Fortran (void)
715 return strncmp (lang_hooks.name, "GNU Fortran", 11) == 0;