xref: /openbsd/gnu/gcc/gcc/c-common.h (revision cf913138)
1 /* Definitions for c-common.c.
2    Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
3    1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
4 
5 This file is part of GCC.
6 
7 GCC is free software; you can redistribute it and/or modify it under
8 the terms of the GNU General Public License as published by the Free
9 Software Foundation; either version 2, or (at your option) any later
10 version.
11 
12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
15 for more details.
16 
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING.  If not, write to the Free
19 Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
20 02110-1301, USA.  */
21 
22 #ifndef GCC_C_COMMON_H
23 #define GCC_C_COMMON_H
24 
25 #include "splay-tree.h"
26 #include "cpplib.h"
27 #include "ggc.h"
28 
29 /* Usage of TREE_LANG_FLAG_?:
30    0: TREE_NEGATED_INT (in INTEGER_CST).
31       IDENTIFIER_MARKED (used by search routines).
32       DECL_PRETTY_FUNCTION_P (in VAR_DECL)
33    1: C_DECLARED_LABEL_FLAG (in LABEL_DECL)
34       STATEMENT_LIST_STMT_EXPR (in STATEMENT_LIST)
35    2: unused
36    3: STATEMENT_LIST_HAS_LABEL (in STATEMENT_LIST)
37    4: unused
38 */
39 
40 /* Reserved identifiers.  This is the union of all the keywords for C,
41    C++, and Objective-C.  All the type modifiers have to be in one
42    block at the beginning, because they are used as mask bits.  There
43    are 27 type modifiers; if we add many more we will have to redesign
44    the mask mechanism.  */
45 
46 enum rid
47 {
48   /* Modifiers: */
49   /* C, in empirical order of frequency.  */
50   RID_STATIC = 0,
51   RID_UNSIGNED, RID_LONG,    RID_CONST, RID_EXTERN,
52   RID_REGISTER, RID_TYPEDEF, RID_SHORT, RID_INLINE,
53   RID_VOLATILE, RID_SIGNED,  RID_AUTO,  RID_RESTRICT,
54 
55   /* C extensions */
56   RID_COMPLEX, RID_THREAD,
57 
58   /* C++ */
59   RID_FRIEND, RID_VIRTUAL, RID_EXPLICIT, RID_EXPORT, RID_MUTABLE,
60 
61   /* ObjC */
62   RID_IN, RID_OUT, RID_INOUT, RID_BYCOPY, RID_BYREF, RID_ONEWAY,
63 
64   /* C */
65   RID_INT,     RID_CHAR,   RID_FLOAT,    RID_DOUBLE, RID_VOID,
66   RID_ENUM,    RID_STRUCT, RID_UNION,    RID_IF,     RID_ELSE,
67   RID_WHILE,   RID_DO,     RID_FOR,      RID_SWITCH, RID_CASE,
68   RID_DEFAULT, RID_BREAK,  RID_CONTINUE, RID_RETURN, RID_GOTO,
69   RID_SIZEOF,
70 
71   /* C extensions */
72   RID_ASM,       RID_TYPEOF,   RID_ALIGNOF,  RID_ATTRIBUTE,  RID_VA_ARG,
73   RID_EXTENSION, RID_IMAGPART, RID_REALPART, RID_LABEL,      RID_CHOOSE_EXPR,
74   RID_TYPES_COMPATIBLE_P,      RID_BUILTIN_COMPLEX,
75   RID_DFLOAT32, RID_DFLOAT64, RID_DFLOAT128,
76 
77   /* Too many ways of getting the name of a function as a string */
78   RID_FUNCTION_NAME, RID_PRETTY_FUNCTION_NAME, RID_C99_FUNCTION_NAME,
79 
80   /* C++ */
81   RID_BOOL,     RID_WCHAR,    RID_CLASS,
82   RID_PUBLIC,   RID_PRIVATE,  RID_PROTECTED,
83   RID_TEMPLATE, RID_NULL,     RID_CATCH,
84   RID_DELETE,   RID_FALSE,    RID_NAMESPACE,
85   RID_NEW,      RID_OFFSETOF, RID_OPERATOR,
86   RID_THIS,     RID_THROW,    RID_TRUE,
87   RID_TRY,      RID_TYPENAME, RID_TYPEID,
88   RID_USING,
89 
90   /* casts */
91   RID_CONSTCAST, RID_DYNCAST, RID_REINTCAST, RID_STATCAST,
92 
93   /* Objective-C */
94   RID_AT_ENCODE,   RID_AT_END,
95   RID_AT_CLASS,    RID_AT_ALIAS,     RID_AT_DEFS,
96   RID_AT_PRIVATE,  RID_AT_PROTECTED, RID_AT_PUBLIC,
97   RID_AT_PROTOCOL, RID_AT_SELECTOR,
98   RID_AT_THROW,	   RID_AT_TRY,       RID_AT_CATCH,
99   RID_AT_FINALLY,  RID_AT_SYNCHRONIZED,
100   RID_AT_INTERFACE,
101   RID_AT_IMPLEMENTATION,
102 
103   RID_MAX,
104 
105   RID_FIRST_MODIFIER = RID_STATIC,
106   RID_LAST_MODIFIER = RID_ONEWAY,
107 
108   RID_FIRST_AT = RID_AT_ENCODE,
109   RID_LAST_AT = RID_AT_IMPLEMENTATION,
110   RID_FIRST_PQ = RID_IN,
111   RID_LAST_PQ = RID_ONEWAY
112 };
113 
114 #define OBJC_IS_AT_KEYWORD(rid) \
115   ((unsigned int) (rid) >= (unsigned int) RID_FIRST_AT && \
116    (unsigned int) (rid) <= (unsigned int) RID_LAST_AT)
117 
118 #define OBJC_IS_PQ_KEYWORD(rid) \
119   ((unsigned int) (rid) >= (unsigned int) RID_FIRST_PQ && \
120    (unsigned int) (rid) <= (unsigned int) RID_LAST_PQ)
121 
122 /* The elements of `ridpointers' are identifier nodes for the reserved
123    type names and storage classes.  It is indexed by a RID_... value.  */
124 extern GTY ((length ("(int) RID_MAX"))) tree *ridpointers;
125 
126 /* Standard named or nameless data types of the C compiler.  */
127 
128 enum c_tree_index
129 {
130     CTI_WCHAR_TYPE,
131     CTI_SIGNED_WCHAR_TYPE,
132     CTI_UNSIGNED_WCHAR_TYPE,
133     CTI_WINT_TYPE,
134     CTI_SIGNED_SIZE_TYPE, /* For format checking only.  */
135     CTI_UNSIGNED_PTRDIFF_TYPE, /* For format checking only.  */
136     CTI_INTMAX_TYPE,
137     CTI_UINTMAX_TYPE,
138     CTI_WIDEST_INT_LIT_TYPE,
139     CTI_WIDEST_UINT_LIT_TYPE,
140 
141     CTI_CHAR_ARRAY_TYPE,
142     CTI_WCHAR_ARRAY_TYPE,
143     CTI_INT_ARRAY_TYPE,
144     CTI_STRING_TYPE,
145     CTI_CONST_STRING_TYPE,
146 
147     /* Type for boolean expressions (bool in C++, int in C).  */
148     CTI_TRUTHVALUE_TYPE,
149     CTI_TRUTHVALUE_TRUE,
150     CTI_TRUTHVALUE_FALSE,
151 
152     CTI_DEFAULT_FUNCTION_TYPE,
153 
154     /* These are not types, but we have to look them up all the time.  */
155     CTI_FUNCTION_NAME_DECL,
156     CTI_PRETTY_FUNCTION_NAME_DECL,
157     CTI_C99_FUNCTION_NAME_DECL,
158     CTI_SAVED_FUNCTION_NAME_DECLS,
159 
160     CTI_VOID_ZERO,
161 
162     CTI_NULL,
163 
164     CTI_MAX
165 };
166 
167 #define C_RID_CODE(id)	(((struct c_common_identifier *) (id))->node.rid_code)
168 
169 /* Identifier part common to the C front ends.  Inherits from
170    tree_identifier, despite appearances.  */
171 struct c_common_identifier GTY(())
172 {
173   struct tree_common common;
174   struct cpp_hashnode node;
175 };
176 
177 #define wchar_type_node			c_global_trees[CTI_WCHAR_TYPE]
178 #define signed_wchar_type_node		c_global_trees[CTI_SIGNED_WCHAR_TYPE]
179 #define unsigned_wchar_type_node	c_global_trees[CTI_UNSIGNED_WCHAR_TYPE]
180 #define wint_type_node			c_global_trees[CTI_WINT_TYPE]
181 #define signed_size_type_node		c_global_trees[CTI_SIGNED_SIZE_TYPE]
182 #define unsigned_ptrdiff_type_node	c_global_trees[CTI_UNSIGNED_PTRDIFF_TYPE]
183 #define intmax_type_node		c_global_trees[CTI_INTMAX_TYPE]
184 #define uintmax_type_node		c_global_trees[CTI_UINTMAX_TYPE]
185 #define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
186 #define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
187 
188 #define truthvalue_type_node		c_global_trees[CTI_TRUTHVALUE_TYPE]
189 #define truthvalue_true_node		c_global_trees[CTI_TRUTHVALUE_TRUE]
190 #define truthvalue_false_node		c_global_trees[CTI_TRUTHVALUE_FALSE]
191 
192 #define char_array_type_node		c_global_trees[CTI_CHAR_ARRAY_TYPE]
193 #define wchar_array_type_node		c_global_trees[CTI_WCHAR_ARRAY_TYPE]
194 #define int_array_type_node		c_global_trees[CTI_INT_ARRAY_TYPE]
195 #define string_type_node		c_global_trees[CTI_STRING_TYPE]
196 #define const_string_type_node		c_global_trees[CTI_CONST_STRING_TYPE]
197 
198 #define default_function_type		c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
199 
200 #define function_name_decl_node		c_global_trees[CTI_FUNCTION_NAME_DECL]
201 #define pretty_function_name_decl_node	c_global_trees[CTI_PRETTY_FUNCTION_NAME_DECL]
202 #define c99_function_name_decl_node		c_global_trees[CTI_C99_FUNCTION_NAME_DECL]
203 #define saved_function_name_decls	c_global_trees[CTI_SAVED_FUNCTION_NAME_DECLS]
204 
205 /* A node for `((void) 0)'.  */
206 #define void_zero_node                  c_global_trees[CTI_VOID_ZERO]
207 
208 /* The node for C++ `__null'.  */
209 #define null_node                       c_global_trees[CTI_NULL]
210 
211 extern GTY(()) tree c_global_trees[CTI_MAX];
212 
213 /* In a RECORD_TYPE, a sorted array of the fields of the type, not a
214    tree for size reasons.  */
215 struct sorted_fields_type GTY(())
216 {
217   int len;
218   tree GTY((length ("%h.len"))) elts[1];
219 };
220 
221 /* Mark which labels are explicitly declared.
222    These may be shadowed, and may be referenced from nested functions.  */
223 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
224 
225 typedef enum c_language_kind
226 {
227   clk_c		= 0,		/* C90, C94 or C99 */
228   clk_objc	= 1,		/* clk_c with ObjC features.  */
229   clk_cxx	= 2,		/* ANSI/ISO C++ */
230   clk_objcxx	= 3		/* clk_cxx with ObjC features.  */
231 }
232 c_language_kind;
233 
234 /* To test for a specific language use c_language, defined by each
235    front end.  For "ObjC features" or "not C++" use the macros.  */
236 extern c_language_kind c_language;
237 
238 #define c_dialect_cxx()		(c_language & clk_cxx)
239 #define c_dialect_objc()	(c_language & clk_objc)
240 
241 /* Information about a statement tree.  */
242 
243 struct stmt_tree_s GTY(()) {
244   /* The current statement list being collected.  */
245   tree x_cur_stmt_list;
246 
247   /* In C++, Nonzero if we should treat statements as full
248      expressions.  In particular, this variable is no-zero if at the
249      end of a statement we should destroy any temporaries created
250      during that statement.  Similarly, if, at the end of a block, we
251      should destroy any local variables in this block.  Normally, this
252      variable is nonzero, since those are the normal semantics of
253      C++.
254 
255      However, in order to represent aggregate initialization code as
256      tree structure, we use statement-expressions.  The statements
257      within the statement expression should not result in cleanups
258      being run until the entire enclosing statement is complete.
259 
260      This flag has no effect in C.  */
261   int stmts_are_full_exprs_p;
262 };
263 
264 typedef struct stmt_tree_s *stmt_tree;
265 
266 /* Global state pertinent to the current function.  Some C dialects
267    extend this structure with additional fields.  */
268 
269 struct c_language_function GTY(()) {
270   /* While we are parsing the function, this contains information
271      about the statement-tree that we are building.  */
272   struct stmt_tree_s x_stmt_tree;
273 };
274 
275 /* When building a statement-tree, this is the current statement list
276    being collected.  It's TREE_CHAIN is a back-pointer to the previous
277    statement list.  */
278 
279 #define cur_stmt_list (current_stmt_tree ()->x_cur_stmt_list)
280 
281 /* Language-specific hooks.  */
282 
283 /* Callback that determines if it's ok for a function to have no
284    noreturn attribute.  */
285 extern int (*lang_missing_noreturn_ok_p) (tree);
286 
287 /* If non-NULL, this function is called after a precompile header file
288    is loaded.  */
289 extern void (*lang_post_pch_load) (void);
290 
291 extern void push_file_scope (void);
292 extern void pop_file_scope (void);
293 extern stmt_tree current_stmt_tree (void);
294 extern tree push_stmt_list (void);
295 extern tree pop_stmt_list (tree);
296 extern tree add_stmt (tree);
297 extern void push_cleanup (tree, tree, bool);
298 extern tree pushdecl_top_level (tree);
299 extern tree pushdecl (tree);
300 extern tree build_modify_expr (tree, enum tree_code, tree);
301 extern tree build_indirect_ref (tree, const char *);
302 
303 extern int c_expand_decl (tree);
304 
305 extern int field_decl_cmp (const void *, const void *);
306 extern void resort_sorted_fields (void *, void *, gt_pointer_operator,
307 				  void *);
308 extern bool has_c_linkage (tree decl);
309 
310 /* Switches common to the C front ends.  */
311 
312 /* Nonzero if prepreprocessing only.  */
313 
314 extern int flag_preprocess_only;
315 
316 /* Zero means that faster, ...NonNil variants of objc_msgSend...
317    calls will be used in ObjC; passing nil receivers to such calls
318    will most likely result in crashes.  */
319 extern int flag_nil_receivers;
320 
321 /* Nonzero means that we will allow new ObjC exception syntax (@throw,
322    @try, etc.) in source code.  */
323 extern int flag_objc_exceptions;
324 
325 /* Nonzero means that we generate NeXT setjmp based exceptions.  */
326 extern int flag_objc_sjlj_exceptions;
327 
328 /* Nonzero means that code generation will be altered to support
329    "zero-link" execution.  This currently affects ObjC only, but may
330    affect other languages in the future.  */
331 extern int flag_zero_link;
332 
333 /* Nonzero means emit an '__OBJC, __image_info' for the current translation
334    unit.  It will inform the ObjC runtime that class definition(s) herein
335    contained are to replace one(s) previously loaded.  */
336 extern int flag_replace_objc_classes;
337 
338 /* Nonzero means don't output line number information.  */
339 
340 extern char flag_no_line_commands;
341 
342 /* Nonzero causes -E output not to be done, but directives such as
343    #define that have side effects are still obeyed.  */
344 
345 extern char flag_no_output;
346 
347 /* Nonzero means dump macros in some fashion; contains the 'D', 'M' or
348    'N' of the command line switch.  */
349 
350 extern char flag_dump_macros;
351 
352 /* Nonzero means pass #include lines through to the output.  */
353 
354 extern char flag_dump_includes;
355 
356 /* Nonzero means process PCH files while preprocessing.  */
357 
358 extern bool flag_pch_preprocess;
359 
360 /* The file name to which we should write a precompiled header, or
361    NULL if no header will be written in this compile.  */
362 
363 extern const char *pch_file;
364 
365 /* Nonzero if an ISO standard was selected.  It rejects macros in the
366    user's namespace.  */
367 
368 extern int flag_iso;
369 
370 /* Nonzero if -undef was given.  It suppresses target built-in macros
371    and assertions.  */
372 
373 extern int flag_undef;
374 
375 /* Nonzero means don't recognize the non-ANSI builtin functions.  */
376 
377 extern int flag_no_builtin;
378 
379 /* Nonzero means don't recognize the non-ANSI builtin functions.
380    -ansi sets this.  */
381 
382 extern int flag_no_nonansi_builtin;
383 
384 /* Nonzero means give `double' the same size as `float'.  */
385 
386 extern int flag_short_double;
387 
388 /* Nonzero means give `wchar_t' the same size as `short'.  */
389 
390 extern int flag_short_wchar;
391 
392 /* Nonzero means allow Microsoft extensions without warnings or errors.  */
393 extern int flag_ms_extensions;
394 
395 /* Nonzero means don't recognize the keyword `asm'.  */
396 
397 extern int flag_no_asm;
398 
399 /* Nonzero means give string constants the type `const char *', as mandated
400    by the standard.  */
401 
402 extern int flag_const_strings;
403 
404 /* Nonzero means to treat bitfields as signed unless they say `unsigned'.  */
405 
406 extern int flag_signed_bitfields;
407 
408 /* Warn about #pragma directives that are not recognized.  */
409 
410 extern int warn_unknown_pragmas; /* Tri state variable.  */
411 
412 /* Warn about format/argument anomalies in calls to formatted I/O functions
413    (*printf, *scanf, strftime, strfmon, etc.).  */
414 
415 extern int warn_format;
416 
417 /* C/ObjC language option variables.  */
418 
419 
420 /* Nonzero means allow type mismatches in conditional expressions;
421    just make their values `void'.  */
422 
423 extern int flag_cond_mismatch;
424 
425 /* Nonzero means enable C89 Amendment 1 features.  */
426 
427 extern int flag_isoc94;
428 
429 /* Nonzero means use the ISO C99 dialect of C.  */
430 
431 extern int flag_isoc99;
432 
433 /* Nonzero means that we have builtin functions, and main is an int.  */
434 
435 extern int flag_hosted;
436 
437 /* Warn if main is suspicious.  */
438 
439 extern int warn_main;
440 
441 
442 /* ObjC language option variables.  */
443 
444 
445 /* Open and close the file for outputting class declarations, if
446    requested (ObjC).  */
447 
448 extern int flag_gen_declaration;
449 
450 /* Tells the compiler that this is a special run.  Do not perform any
451    compiling, instead we are to test some platform dependent features
452    and output a C header file with appropriate definitions.  */
453 
454 extern int print_struct_values;
455 
456 /* ???.  Undocumented.  */
457 
458 extern const char *constant_string_class_name;
459 
460 
461 /* C++ language option variables.  */
462 
463 
464 /* Nonzero means don't recognize any extension keywords.  */
465 
466 extern int flag_no_gnu_keywords;
467 
468 /* Nonzero means do emit exported implementations of functions even if
469    they can be inlined.  */
470 
471 extern int flag_implement_inlines;
472 
473 /* Nonzero means that implicit instantiations will be emitted if needed.  */
474 
475 extern int flag_implicit_templates;
476 
477 /* Nonzero means that implicit instantiations of inline templates will be
478    emitted if needed, even if instantiations of non-inline templates
479    aren't.  */
480 
481 extern int flag_implicit_inline_templates;
482 
483 /* Nonzero means generate separate instantiation control files and
484    juggle them at link time.  */
485 
486 extern int flag_use_repository;
487 
488 /* Nonzero if we want to issue diagnostics that the standard says are not
489    required.  */
490 
491 extern int flag_optional_diags;
492 
493 /* Nonzero means we should attempt to elide constructors when possible.  */
494 
495 extern int flag_elide_constructors;
496 
497 /* Nonzero means that member functions defined in class scope are
498    inline by default.  */
499 
500 extern int flag_default_inline;
501 
502 /* Controls whether compiler generates 'type descriptor' that give
503    run-time type information.  */
504 
505 extern int flag_rtti;
506 
507 /* Nonzero if we want to conserve space in the .o files.  We do this
508    by putting uninitialized data and runtime initialized data into
509    .common instead of .data at the expense of not flagging multiple
510    definitions.  */
511 
512 extern int flag_conserve_space;
513 
514 /* Nonzero if we want to obey access control semantics.  */
515 
516 extern int flag_access_control;
517 
518 /* Nonzero if we want to check the return value of new and avoid calling
519    constructors if it is a null pointer.  */
520 
521 extern int flag_check_new;
522 
523 /* Nonzero if we want the new ISO rules for pushing a new scope for `for'
524    initialization variables.
525    0: Old rules, set by -fno-for-scope.
526    2: New ISO rules, set by -ffor-scope.
527    1: Try to implement new ISO rules, but with backup compatibility
528    (and warnings).  This is the default, for now.  */
529 
530 extern int flag_new_for_scope;
531 
532 /* Nonzero if we want to emit defined symbols with common-like linkage as
533    weak symbols where possible, in order to conform to C++ semantics.
534    Otherwise, emit them as local symbols.  */
535 
536 extern int flag_weak;
537 
538 /* 0 means we want the preprocessor to not emit line directives for
539    the current working directory.  1 means we want it to do it.  -1
540    means we should decide depending on whether debugging information
541    is being emitted or not.  */
542 
543 extern int flag_working_directory;
544 
545 /* Nonzero to use __cxa_atexit, rather than atexit, to register
546    destructors for local statics and global objects.  */
547 
548 extern int flag_use_cxa_atexit;
549 
550 /* Nonzero to use __cxa_get_exception_ptr in the C++ exception-handling
551    logic.  */
552 
553 extern int flag_use_cxa_get_exception_ptr;
554 
555 /* Nonzero means make the default pedwarns warnings instead of errors.
556    The value of this flag is ignored if -pedantic is specified.  */
557 
558 extern int flag_permissive;
559 
560 /* Nonzero means to implement standard semantics for exception
561    specifications, calling unexpected if an exception is thrown that
562    doesn't match the specification.  Zero means to treat them as
563    assertions and optimize accordingly, but not check them.  */
564 
565 extern int flag_enforce_eh_specs;
566 
567 /* Nonzero (the default) means to generate thread-safe code for
568    initializing local statics.  */
569 
570 extern int flag_threadsafe_statics;
571 
572 /* Nonzero means warn about implicit declarations.  */
573 
574 extern int warn_implicit;
575 
576 /* Warn about using __null (as NULL in C++) as sentinel.  For code compiled
577    with GCC this doesn't matter as __null is guaranteed to have the right
578    size.  */
579 
580 extern int warn_strict_null_sentinel;
581 
582 /* Maximum template instantiation depth.  This limit is rather
583    arbitrary, but it exists to limit the time it takes to notice
584    infinite template instantiations.  */
585 
586 extern int max_tinst_depth;
587 
588 /* Nonzero means the expression being parsed will never be evaluated.
589    This is a count, since unevaluated expressions can nest.  */
590 
591 extern int skip_evaluation;
592 
593 /* C types are partitioned into three subsets: object, function, and
594    incomplete types.  */
595 #define C_TYPE_OBJECT_P(type) \
596   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
597 
598 #define C_TYPE_INCOMPLETE_P(type) \
599   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
600 
601 #define C_TYPE_FUNCTION_P(type) \
602   (TREE_CODE (type) == FUNCTION_TYPE)
603 
604 /* For convenience we define a single macro to identify the class of
605    object or incomplete types.  */
606 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
607   (!C_TYPE_FUNCTION_P (type))
608 
609 /* Attribute table common to the C front ends.  */
610 extern const struct attribute_spec c_common_attribute_table[];
611 extern const struct attribute_spec c_common_format_attribute_table[];
612 
613 /* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
614    ID is the identifier to use, NAME is the string.
615    TYPE_DEP indicates whether it depends on type of the function or not
616    (i.e. __PRETTY_FUNCTION__).  */
617 
618 extern tree (*make_fname_decl) (tree, int);
619 
620 extern tree identifier_global_value (tree);
621 extern void record_builtin_type (enum rid, const char *, tree);
622 extern tree build_void_list_node (void);
623 extern void start_fname_decls (void);
624 extern void finish_fname_decls (void);
625 extern const char *fname_as_string (int);
626 extern tree fname_decl (unsigned, tree);
627 
628 extern void check_function_arguments (tree, tree, tree);
629 extern void check_function_arguments_recurse (void (*)
630 					      (void *, tree,
631 					       unsigned HOST_WIDE_INT),
632 					      void *, tree,
633 					      unsigned HOST_WIDE_INT);
634 extern void check_function_format (tree, tree);
635 extern void check_function_bounded (int *, tree, tree);
636 extern void set_Wformat (int);
637 extern tree handle_bounded_attribute (tree *, tree, tree, int, bool *);
638 extern tree handle_format_attribute (tree *, tree, tree, int, bool *);
639 extern tree handle_format_arg_attribute (tree *, tree, tree, int, bool *);
640 extern int c_common_handle_option (size_t code, const char *arg, int value);
641 extern bool c_common_missing_argument (const char *opt, size_t code);
642 extern tree c_common_type_for_mode (enum machine_mode, int);
643 extern tree c_common_type_for_size (unsigned int, int);
644 extern tree c_common_unsigned_type (tree);
645 extern tree c_common_signed_type (tree);
646 extern tree c_common_signed_or_unsigned_type (int, tree);
647 extern tree c_build_bitfield_integer_type (unsigned HOST_WIDE_INT, int);
648 extern tree c_common_truthvalue_conversion (tree);
649 extern void c_apply_type_quals_to_decl (int, tree);
650 extern tree c_sizeof_or_alignof_type (tree, bool, int);
651 extern tree c_alignof_expr (tree);
652 /* Print an error message for invalid operands to arith operation CODE.
653    NOP_EXPR is used as a special case (see truthvalue_conversion).  */
654 extern void binary_op_error (enum tree_code);
655 extern tree fix_string_type (tree);
656 struct varray_head_tag;
657 extern void constant_expression_warning (tree);
658 extern void strict_aliasing_warning(tree, tree, tree);
659 extern void empty_body_warning (tree, tree);
660 extern tree convert_and_check (tree, tree);
661 extern void overflow_warning (tree);
662 extern bool c_determine_visibility (tree);
663 extern bool same_scalar_type_ignoring_signedness (tree, tree);
664 
665 #define c_sizeof(T)  c_sizeof_or_alignof_type (T, true, 1)
666 #define c_alignof(T) c_sizeof_or_alignof_type (T, false, 1)
667 
668 /* Subroutine of build_binary_op, used for comparison operations.
669    See if the operands have both been converted from subword integer types
670    and, if so, perhaps change them both back to their original type.  */
671 extern tree shorten_compare (tree *, tree *, tree *, enum tree_code *);
672 
673 extern tree pointer_int_sum (enum tree_code, tree, tree);
674 extern unsigned int min_precision (tree, int);
675 
676 /* Add qualifiers to a type, in the fashion for C.  */
677 extern tree c_build_qualified_type (tree, int);
678 
679 /* Build tree nodes and builtin functions common to both C and C++ language
680    frontends.  */
681 extern void c_common_nodes_and_builtins (void);
682 
683 extern void set_builtin_user_assembler_name (tree decl, const char *asmspec);
684 
685 extern void disable_builtin_function (const char *);
686 
687 extern void set_compound_literal_name (tree decl);
688 
689 extern tree build_va_arg (tree, tree);
690 
691 extern unsigned int c_common_init_options (unsigned int, const char **);
692 extern bool c_common_post_options (const char **);
693 extern bool c_common_init (void);
694 extern void c_common_finish (void);
695 extern void c_common_parse_file (int);
696 extern HOST_WIDE_INT c_common_get_alias_set (tree);
697 extern void c_register_builtin_type (tree, const char*);
698 extern bool c_promoting_integer_type_p (tree);
699 extern int self_promoting_args_p (tree);
700 extern tree strip_array_types (tree);
701 extern tree strip_pointer_operator (tree);
702 extern HOST_WIDE_INT c_common_to_target_charset (HOST_WIDE_INT);
703 
704 /* This is the basic parsing function.  */
705 extern void c_parse_file (void);
706 /* This is misnamed, it actually performs end-of-compilation processing.  */
707 extern void finish_file	(void);
708 
709 
710 /* These macros provide convenient access to the various _STMT nodes.  */
711 
712 /* Nonzero if a given STATEMENT_LIST represents the outermost binding
713    if a statement expression.  */
714 #define STATEMENT_LIST_STMT_EXPR(NODE) \
715   TREE_LANG_FLAG_1 (STATEMENT_LIST_CHECK (NODE))
716 
717 /* Nonzero if a label has been added to the statement list.  */
718 #define STATEMENT_LIST_HAS_LABEL(NODE) \
719   TREE_LANG_FLAG_3 (STATEMENT_LIST_CHECK (NODE))
720 
721 /* COMPOUND_LITERAL_EXPR accessors.  */
722 #define COMPOUND_LITERAL_EXPR_DECL_STMT(NODE)		\
723   TREE_OPERAND (COMPOUND_LITERAL_EXPR_CHECK (NODE), 0)
724 #define COMPOUND_LITERAL_EXPR_DECL(NODE)			\
725   DECL_EXPR_DECL (COMPOUND_LITERAL_EXPR_DECL_STMT (NODE))
726 
727 #define DEFTREECODE(SYM, NAME, TYPE, LENGTH) SYM,
728 
729 enum c_tree_code {
730   C_DUMMY_TREE_CODE = LAST_AND_UNUSED_TREE_CODE,
731 #include "c-common.def"
732   LAST_C_TREE_CODE
733 };
734 
735 #undef DEFTREECODE
736 
737 extern int anon_aggr_type_p (tree);
738 
739 /* For a VAR_DECL that is an anonymous union, these are the various
740    sub-variables that make up the anonymous union.  */
741 #define DECL_ANON_UNION_ELEMS(NODE) DECL_ARGUMENTS ((NODE))
742 
743 /* In a FIELD_DECL, nonzero if the decl was originally a bitfield.  */
744 #define DECL_C_BIT_FIELD(NODE) \
745   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
746 #define SET_DECL_C_BIT_FIELD(NODE) \
747   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
748 #define CLEAR_DECL_C_BIT_FIELD(NODE) \
749   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
750 
751 extern void emit_local_var (tree);
752 extern tree do_case (tree, tree);
753 extern tree build_stmt (enum tree_code, ...);
754 extern tree build_case_label (tree, tree, tree);
755 
756 /* These functions must be defined by each front-end which implements
757    a variant of the C language.  They are used in c-common.c.  */
758 
759 extern tree build_unary_op (enum tree_code, tree, int);
760 extern tree build_binary_op (enum tree_code, tree, tree, int);
761 extern tree perform_integral_promotions (tree);
762 
763 /* These functions must be defined by each front-end which implements
764    a variant of the C language.  They are used by port files.  */
765 
766 extern tree default_conversion (tree);
767 
768 /* Given two integer or real types, return the type for their sum.
769    Given two compatible ANSI C types, returns the merged type.  */
770 
771 extern tree common_type (tree, tree);
772 
773 extern tree decl_constant_value (tree);
774 
775 /* Handle increment and decrement of boolean types.  */
776 extern tree boolean_increment (enum tree_code, tree);
777 
778 extern int case_compare (splay_tree_key, splay_tree_key);
779 
780 extern tree c_add_case_label (splay_tree, tree, tree, tree, tree);
781 
782 extern void c_do_switch_warnings (splay_tree, location_t, tree, tree);
783 
784 extern tree build_function_call (tree, tree);
785 
786 extern tree resolve_overloaded_builtin (tree, tree);
787 
788 extern tree finish_label_address_expr (tree);
789 
790 /* Same function prototype, but the C and C++ front ends have
791    different implementations.  Used in c-common.c.  */
792 extern tree lookup_label (tree);
793 extern tree lookup_name (tree);
794 
795 extern int vector_types_convertible_p (tree t1, tree t2);
796 
797 extern rtx c_expand_expr (tree, rtx, enum machine_mode, int, rtx *);
798 
799 extern tree c_staticp (tree);
800 
801 extern void init_c_lex (void);
802 
803 extern void c_cpp_builtins (cpp_reader *);
804 
805 /* Positive if an implicit `extern "C"' scope has just been entered;
806    negative if such a scope has just been exited.  */
807 extern GTY(()) int pending_lang_change;
808 
809 /* Information recorded about each file examined during compilation.  */
810 
811 struct c_fileinfo
812 {
813   int time;	/* Time spent in the file.  */
814 
815   /* Flags used only by C++.
816      INTERFACE_ONLY nonzero means that we are in an "interface" section
817      of the compiler.  INTERFACE_UNKNOWN nonzero means we cannot trust
818      the value of INTERFACE_ONLY.  If INTERFACE_UNKNOWN is zero and
819      INTERFACE_ONLY is zero, it means that we are responsible for
820      exporting definitions that others might need.  */
821   short interface_only;
822   short interface_unknown;
823 };
824 
825 struct c_fileinfo *get_fileinfo (const char *);
826 extern void dump_time_statistics (void);
827 
828 extern bool c_dump_tree (void *, tree);
829 
830 extern void c_warn_unused_result (tree *);
831 
832 extern void verify_sequence_points (tree);
833 
834 extern tree fold_offsetof (tree, tree);
835 
836 /* Places where an lvalue, or modifiable lvalue, may be required.
837    Used to select diagnostic messages in lvalue_error and
838    readonly_error.  */
839 enum lvalue_use {
840   lv_assign,
841   lv_increment,
842   lv_decrement,
843   lv_addressof,
844   lv_asm
845 };
846 
847 extern void lvalue_error (enum lvalue_use);
848 
849 extern int complete_array_type (tree *, tree, bool);
850 
851 extern tree builtin_type_for_size (int, bool);
852 
853 extern void warn_array_subscript_with_type_char (tree);
854 
855 /* In c-gimplify.c  */
856 extern void c_genericize (tree);
857 extern int c_gimplify_expr (tree *, tree *, tree *);
858 extern tree c_build_bind_expr (tree, tree);
859 
860 /* In c-pch.c  */
861 extern void pch_init (void);
862 extern int c_common_valid_pch (cpp_reader *pfile, const char *name, int fd);
863 extern void c_common_read_pch (cpp_reader *pfile, const char *name, int fd,
864 			       const char *orig);
865 extern void c_common_write_pch (void);
866 extern void c_common_no_more_pch (void);
867 extern void c_common_pch_pragma (cpp_reader *pfile, const char *);
868 extern void c_common_print_pch_checksum (FILE *f);
869 
870 /* In *-checksum.c */
871 extern const unsigned char executable_checksum[16];
872 
873 extern void builtin_define_with_value (const char *, const char *, int);
874 extern void c_stddef_cpp_builtins (void);
875 extern void fe_file_change (const struct line_map *);
876 extern void c_parse_error (const char *, enum cpp_ttype, tree);
877 
878 /* Objective-C / Objective-C++ entry points.  */
879 
880 /* The following ObjC/ObjC++ functions are called by the C and/or C++
881    front-ends; they all must have corresponding stubs in stub-objc.c.  */
882 extern tree objc_is_class_name (tree);
883 extern tree objc_is_object_ptr (tree);
884 extern void objc_check_decl (tree);
885 extern int objc_is_reserved_word (tree);
886 extern bool objc_compare_types (tree, tree, int, tree);
887 extern void objc_volatilize_decl (tree);
888 extern bool objc_type_quals_match (tree, tree);
889 extern tree objc_rewrite_function_call (tree, tree);
890 extern tree objc_message_selector (void);
891 extern tree objc_lookup_ivar (tree, tree);
892 extern void objc_clear_super_receiver (void);
893 extern int objc_is_public (tree, tree);
894 extern tree objc_is_id (tree);
895 extern void objc_declare_alias (tree, tree);
896 extern void objc_declare_class (tree);
897 extern void objc_declare_protocols (tree);
898 extern tree objc_build_message_expr (tree);
899 extern tree objc_finish_message_expr (tree, tree, tree);
900 extern tree objc_build_selector_expr (tree);
901 extern tree objc_build_protocol_expr (tree);
902 extern tree objc_build_encode_expr (tree);
903 extern tree objc_build_string_object (tree);
904 extern tree objc_get_protocol_qualified_type (tree, tree);
905 extern tree objc_get_class_reference (tree);
906 extern tree objc_get_class_ivars (tree);
907 extern void objc_start_class_interface (tree, tree, tree);
908 extern void objc_start_category_interface (tree, tree, tree);
909 extern void objc_start_protocol (tree, tree);
910 extern void objc_continue_interface (void);
911 extern void objc_finish_interface (void);
912 extern void objc_start_class_implementation (tree, tree);
913 extern void objc_start_category_implementation (tree, tree);
914 extern void objc_continue_implementation (void);
915 extern void objc_finish_implementation (void);
916 extern void objc_set_visibility (int);
917 extern void objc_set_method_type (enum tree_code);
918 extern tree objc_build_method_signature (tree, tree, tree, bool);
919 extern void objc_add_method_declaration (tree);
920 extern void objc_start_method_definition (tree);
921 extern void objc_finish_method_definition (tree);
922 extern void objc_add_instance_variable (tree);
923 extern tree objc_build_keyword_decl (tree, tree, tree);
924 extern tree objc_build_throw_stmt (tree);
925 extern void objc_begin_try_stmt (location_t, tree);
926 extern tree objc_finish_try_stmt (void);
927 extern void objc_begin_catch_clause (tree);
928 extern void objc_finish_catch_clause (void);
929 extern void objc_build_finally_clause (location_t, tree);
930 extern tree objc_build_synchronized (location_t, tree, tree);
931 extern int objc_static_init_needed_p (void);
932 extern tree objc_generate_static_init_call (tree);
933 extern tree objc_generate_write_barrier (tree, enum tree_code, tree);
934 
935 /* The following are provided by the C and C++ front-ends, and called by
936    ObjC/ObjC++.  */
937 extern void *objc_get_current_scope (void);
938 extern void objc_mark_locals_volatile (void *);
939 
940 /* In c-ppoutput.c  */
941 extern void init_pp_output (FILE *);
942 extern void preprocess_file (cpp_reader *);
943 extern void pp_file_change (const struct line_map *);
944 extern void pp_dir_change (cpp_reader *, const char *);
945 extern bool check_missing_format_attribute (tree, tree);
946 
947 /* In c-omp.c  */
948 extern tree c_finish_omp_master (tree);
949 extern tree c_finish_omp_critical (tree, tree);
950 extern tree c_finish_omp_ordered (tree);
951 extern void c_finish_omp_barrier (void);
952 extern tree c_finish_omp_atomic (enum tree_code, tree, tree);
953 extern void c_finish_omp_flush (void);
954 extern tree c_finish_omp_for (location_t, tree, tree, tree, tree, tree, tree);
955 extern void c_split_parallel_clauses (tree, tree *, tree *);
956 extern enum omp_clause_default_kind c_omp_predetermined_sharing (tree);
957 
958 /* Not in c-omp.c; provided by the front end.  */
959 extern bool c_omp_sharing_predetermined (tree);
960 extern tree c_omp_remap_decl (tree, bool);
961 
962 /* In order for the format checking to accept the C frontend
963    diagnostic framework extensions, you must include this file before
964    toplev.h, not after.  The C front end formats are a subset of those
965    for C++, so they are the appropriate set to use in common code;
966    cp-tree.h overrides this for C++.  */
967 #ifndef GCC_DIAG_STYLE
968 #define GCC_DIAG_STYLE __gcc_cdiag__
969 #endif
970 
971 #endif /* ! GCC_C_COMMON_H */
972