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
5This file is part of GCC.
6
7GCC is free software; you can redistribute it and/or modify it under
8the terms of the GNU General Public License as published by the Free
9Software Foundation; either version 2, or (at your option) any later
10version.
11
12GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13WARRANTY; without even the implied warranty of MERCHANTABILITY or
14FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
15for more details.
16
17You should have received a copy of the GNU General Public License
18along with GCC; see the file COPYING.  If not, write to the Free
19Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
2002110-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
46enum 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,
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  /* APPLE LOCAL radar 4564694 */
97  RID_AT_PACKAGE,  RID_AT_PRIVATE,  RID_AT_PROTECTED, RID_AT_PUBLIC,
98  RID_AT_PROTOCOL, RID_AT_SELECTOR,
99  RID_AT_THROW,	   RID_AT_TRY,       RID_AT_CATCH,
100  RID_AT_FINALLY,  RID_AT_SYNCHRONIZED,
101  RID_AT_INTERFACE,
102  /* APPLE LOCAL C* language */
103  RID_AT_OPTIONAL, RID_AT_REQUIRED,
104  /* APPLE LOCAL C* property (Radar 4436866) */
105  RID_AT_PROPERTY,
106  RID_AT_IMPLEMENTATION,
107  /* APPLE LOCAL C* property (Radar 4436866, 4591909, 4621020) */
108  RID_READONLY, RID_GETTER, RID_SETTER,
109  RID_NONATOMIC,
110
111  RID_MAX,
112
113  RID_FIRST_MODIFIER = RID_STATIC,
114  RID_LAST_MODIFIER = RID_ONEWAY,
115
116  RID_FIRST_AT = RID_AT_ENCODE,
117  RID_LAST_AT = RID_AT_IMPLEMENTATION,
118  RID_FIRST_PQ = RID_IN,
119  RID_LAST_PQ = RID_ONEWAY
120};
121
122#define OBJC_IS_AT_KEYWORD(rid) \
123  ((unsigned int) (rid) >= (unsigned int) RID_FIRST_AT && \
124   (unsigned int) (rid) <= (unsigned int) RID_LAST_AT)
125
126#define OBJC_IS_PQ_KEYWORD(rid) \
127  ((unsigned int) (rid) >= (unsigned int) RID_FIRST_PQ && \
128   (unsigned int) (rid) <= (unsigned int) RID_LAST_PQ)
129
130/* The elements of `ridpointers' are identifier nodes for the reserved
131   type names and storage classes.  It is indexed by a RID_... value.  */
132extern GTY ((length ("(int) RID_MAX"))) tree *ridpointers;
133
134/* Standard named or nameless data types of the C compiler.  */
135
136enum c_tree_index
137{
138    CTI_WCHAR_TYPE,
139    CTI_SIGNED_WCHAR_TYPE,
140    CTI_UNSIGNED_WCHAR_TYPE,
141    CTI_WINT_TYPE,
142    CTI_SIGNED_SIZE_TYPE, /* For format checking only.  */
143    CTI_UNSIGNED_PTRDIFF_TYPE, /* For format checking only.  */
144    CTI_INTMAX_TYPE,
145    CTI_UINTMAX_TYPE,
146    CTI_WIDEST_INT_LIT_TYPE,
147    CTI_WIDEST_UINT_LIT_TYPE,
148
149    CTI_CHAR_ARRAY_TYPE,
150    CTI_WCHAR_ARRAY_TYPE,
151    CTI_INT_ARRAY_TYPE,
152    CTI_STRING_TYPE,
153    CTI_CONST_STRING_TYPE,
154
155    /* Type for boolean expressions (bool in C++, int in C).  */
156    CTI_TRUTHVALUE_TYPE,
157    CTI_TRUTHVALUE_TRUE,
158    CTI_TRUTHVALUE_FALSE,
159
160    CTI_DEFAULT_FUNCTION_TYPE,
161
162    /* These are not types, but we have to look them up all the time.  */
163    CTI_FUNCTION_NAME_DECL,
164    CTI_PRETTY_FUNCTION_NAME_DECL,
165    CTI_C99_FUNCTION_NAME_DECL,
166    CTI_SAVED_FUNCTION_NAME_DECLS,
167
168    CTI_VOID_ZERO,
169
170    CTI_NULL,
171
172    CTI_MAX
173};
174
175#define C_RID_CODE(id)	(((struct c_common_identifier *) (id))->node.rid_code)
176
177/* Identifier part common to the C front ends.  Inherits from
178   tree_identifier, despite appearances.  */
179struct c_common_identifier GTY(())
180{
181  struct tree_common common;
182  struct cpp_hashnode node;
183};
184
185#define wchar_type_node			c_global_trees[CTI_WCHAR_TYPE]
186#define signed_wchar_type_node		c_global_trees[CTI_SIGNED_WCHAR_TYPE]
187#define unsigned_wchar_type_node	c_global_trees[CTI_UNSIGNED_WCHAR_TYPE]
188#define wint_type_node			c_global_trees[CTI_WINT_TYPE]
189#define signed_size_type_node		c_global_trees[CTI_SIGNED_SIZE_TYPE]
190#define unsigned_ptrdiff_type_node	c_global_trees[CTI_UNSIGNED_PTRDIFF_TYPE]
191#define intmax_type_node		c_global_trees[CTI_INTMAX_TYPE]
192#define uintmax_type_node		c_global_trees[CTI_UINTMAX_TYPE]
193#define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
194#define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
195
196#define truthvalue_type_node		c_global_trees[CTI_TRUTHVALUE_TYPE]
197#define truthvalue_true_node		c_global_trees[CTI_TRUTHVALUE_TRUE]
198#define truthvalue_false_node		c_global_trees[CTI_TRUTHVALUE_FALSE]
199
200#define char_array_type_node		c_global_trees[CTI_CHAR_ARRAY_TYPE]
201#define wchar_array_type_node		c_global_trees[CTI_WCHAR_ARRAY_TYPE]
202#define int_array_type_node		c_global_trees[CTI_INT_ARRAY_TYPE]
203#define string_type_node		c_global_trees[CTI_STRING_TYPE]
204#define const_string_type_node		c_global_trees[CTI_CONST_STRING_TYPE]
205
206#define default_function_type		c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
207
208#define function_name_decl_node		c_global_trees[CTI_FUNCTION_NAME_DECL]
209#define pretty_function_name_decl_node	c_global_trees[CTI_PRETTY_FUNCTION_NAME_DECL]
210#define c99_function_name_decl_node		c_global_trees[CTI_C99_FUNCTION_NAME_DECL]
211#define saved_function_name_decls	c_global_trees[CTI_SAVED_FUNCTION_NAME_DECLS]
212
213/* A node for `((void) 0)'.  */
214#define void_zero_node                  c_global_trees[CTI_VOID_ZERO]
215
216/* The node for C++ `__null'.  */
217#define null_node                       c_global_trees[CTI_NULL]
218
219extern GTY(()) tree c_global_trees[CTI_MAX];
220
221/* In a RECORD_TYPE, a sorted array of the fields of the type, not a
222   tree for size reasons.  */
223struct sorted_fields_type GTY(())
224{
225  int len;
226  tree GTY((length ("%h.len"))) elts[1];
227};
228
229/* Mark which labels are explicitly declared.
230   These may be shadowed, and may be referenced from nested functions.  */
231#define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
232
233typedef enum c_language_kind
234{
235  clk_c		= 0,		/* C90, C94 or C99 */
236  clk_objc	= 1,		/* clk_c with ObjC features.  */
237  clk_cxx	= 2,		/* ANSI/ISO C++ */
238  clk_objcxx	= 3		/* clk_cxx with ObjC features.  */
239}
240c_language_kind;
241
242/* To test for a specific language use c_language, defined by each
243   front end.  For "ObjC features" or "not C++" use the macros.  */
244extern c_language_kind c_language;
245
246#define c_dialect_cxx()		(c_language & clk_cxx)
247#define c_dialect_objc()	(c_language & clk_objc)
248
249/* Information about a statement tree.  */
250
251struct stmt_tree_s GTY(()) {
252  /* The current statement list being collected.  */
253  tree x_cur_stmt_list;
254
255  /* In C++, Nonzero if we should treat statements as full
256     expressions.  In particular, this variable is no-zero if at the
257     end of a statement we should destroy any temporaries created
258     during that statement.  Similarly, if, at the end of a block, we
259     should destroy any local variables in this block.  Normally, this
260     variable is nonzero, since those are the normal semantics of
261     C++.
262
263     However, in order to represent aggregate initialization code as
264     tree structure, we use statement-expressions.  The statements
265     within the statement expression should not result in cleanups
266     being run until the entire enclosing statement is complete.
267
268     This flag has no effect in C.  */
269  int stmts_are_full_exprs_p;
270};
271
272typedef struct stmt_tree_s *stmt_tree;
273
274/* Global state pertinent to the current function.  Some C dialects
275   extend this structure with additional fields.  */
276
277struct c_language_function GTY(()) {
278  /* While we are parsing the function, this contains information
279     about the statement-tree that we are building.  */
280  struct stmt_tree_s x_stmt_tree;
281};
282
283/* When building a statement-tree, this is the current statement list
284   being collected.  It's TREE_CHAIN is a back-pointer to the previous
285   statement list.  */
286
287#define cur_stmt_list (current_stmt_tree ()->x_cur_stmt_list)
288
289/* Language-specific hooks.  */
290
291/* Callback that determines if it's ok for a function to have no
292   noreturn attribute.  */
293extern int (*lang_missing_noreturn_ok_p) (tree);
294
295/* If non-NULL, this function is called after a precompile header file
296   is loaded.  */
297extern void (*lang_post_pch_load) (void);
298
299extern void push_file_scope (void);
300extern void pop_file_scope (void);
301extern stmt_tree current_stmt_tree (void);
302extern tree push_stmt_list (void);
303extern tree pop_stmt_list (tree);
304extern tree add_stmt (tree);
305extern void push_cleanup (tree, tree, bool);
306extern tree pushdecl_top_level (tree);
307extern tree pushdecl (tree);
308extern tree build_modify_expr (tree, enum tree_code, tree);
309extern tree build_indirect_ref (tree, const char *);
310
311extern int c_expand_decl (tree);
312
313extern int field_decl_cmp (const void *, const void *);
314extern void resort_sorted_fields (void *, void *, gt_pointer_operator,
315				  void *);
316extern bool has_c_linkage (tree decl);
317
318/* Switches common to the C front ends.  */
319
320/* Nonzero if prepreprocessing only.  */
321
322extern int flag_preprocess_only;
323
324/* Zero means that faster, ...NonNil variants of objc_msgSend...
325   calls will be used in ObjC; passing nil receivers to such calls
326   will most likely result in crashes.  */
327extern int flag_nil_receivers;
328
329/* Nonzero means that we will allow new ObjC exception syntax (@throw,
330   @try, etc.) in source code.  */
331extern int flag_objc_exceptions;
332
333/* Nonzero means that we generate NeXT setjmp based exceptions.  */
334extern int flag_objc_sjlj_exceptions;
335
336/* Nonzero means that code generation will be altered to support
337   "zero-link" execution.  This currently affects ObjC only, but may
338   affect other languages in the future.  */
339extern int flag_zero_link;
340
341/* Nonzero means emit an '__OBJC, __image_info' for the current translation
342   unit.  It will inform the ObjC runtime that class definition(s) herein
343   contained are to replace one(s) previously loaded.  */
344extern int flag_replace_objc_classes;
345
346/* Nonzero means don't output line number information.  */
347
348extern char flag_no_line_commands;
349
350/* Nonzero causes -E output not to be done, but directives such as
351   #define that have side effects are still obeyed.  */
352
353extern char flag_no_output;
354
355/* Nonzero means dump macros in some fashion; contains the 'D', 'M' or
356   'N' of the command line switch.  */
357
358extern char flag_dump_macros;
359
360/* Nonzero means pass #include lines through to the output.  */
361
362extern char flag_dump_includes;
363
364/* Nonzero means process PCH files while preprocessing.  */
365
366extern bool flag_pch_preprocess;
367
368/* The file name to which we should write a precompiled header, or
369   NULL if no header will be written in this compile.  */
370
371extern const char *pch_file;
372
373/* Nonzero if an ISO standard was selected.  It rejects macros in the
374   user's namespace.  */
375
376extern int flag_iso;
377
378/* Nonzero if -undef was given.  It suppresses target built-in macros
379   and assertions.  */
380
381extern int flag_undef;
382
383/* Nonzero means don't recognize the non-ANSI builtin functions.  */
384
385extern int flag_no_builtin;
386
387/* Nonzero means don't recognize the non-ANSI builtin functions.
388   -ansi sets this.  */
389
390extern int flag_no_nonansi_builtin;
391
392/* Nonzero means give `double' the same size as `float'.  */
393
394extern int flag_short_double;
395
396/* Nonzero means give `wchar_t' the same size as `short'.  */
397
398extern int flag_short_wchar;
399
400/* Nonzero means allow implicit conversions between vectors with
401   differing numbers of subparts and/or differing element types.  */
402extern int flag_lax_vector_conversions;
403
404/* Nonzero means allow Microsoft extensions without warnings or errors.  */
405extern int flag_ms_extensions;
406
407/* Nonzero means don't recognize the keyword `asm'.  */
408
409extern int flag_no_asm;
410
411/* Nonzero means give string constants the type `const char *', as mandated
412   by the standard.  */
413
414extern int flag_const_strings;
415
416/* Nonzero means to treat bitfields as signed unless they say `unsigned'.  */
417
418extern int flag_signed_bitfields;
419
420/* Warn about #pragma directives that are not recognized.  */
421
422extern int warn_unknown_pragmas; /* Tri state variable.  */
423
424/* Warn about format/argument anomalies in calls to formatted I/O functions
425   (*printf, *scanf, strftime, strfmon, etc.).  */
426
427extern int warn_format;
428
429
430/* C/ObjC language option variables.  */
431
432
433/* Nonzero means allow type mismatches in conditional expressions;
434   just make their values `void'.  */
435
436extern int flag_cond_mismatch;
437
438/* Nonzero means enable C89 Amendment 1 features.  */
439
440extern int flag_isoc94;
441
442/* Nonzero means use the ISO C99 dialect of C.  */
443
444extern int flag_isoc99;
445
446/* Nonzero means that we have builtin functions, and main is an int.  */
447
448extern int flag_hosted;
449
450/* Warn if main is suspicious.  */
451
452extern int warn_main;
453
454
455/* ObjC language option variables.  */
456
457
458/* Open and close the file for outputting class declarations, if
459   requested (ObjC).  */
460
461extern int flag_gen_declaration;
462
463/* Tells the compiler that this is a special run.  Do not perform any
464   compiling, instead we are to test some platform dependent features
465   and output a C header file with appropriate definitions.  */
466
467extern int print_struct_values;
468
469/* ???.  Undocumented.  */
470
471extern const char *constant_string_class_name;
472
473
474/* C++ language option variables.  */
475
476
477/* Nonzero means don't recognize any extension keywords.  */
478
479extern int flag_no_gnu_keywords;
480
481/* Nonzero means do emit exported implementations of functions even if
482   they can be inlined.  */
483
484extern int flag_implement_inlines;
485
486/* Nonzero means that implicit instantiations will be emitted if needed.  */
487
488extern int flag_implicit_templates;
489
490/* Nonzero means that implicit instantiations of inline templates will be
491   emitted if needed, even if instantiations of non-inline templates
492   aren't.  */
493
494extern int flag_implicit_inline_templates;
495
496/* Nonzero means generate separate instantiation control files and
497   juggle them at link time.  */
498
499extern int flag_use_repository;
500
501/* Nonzero if we want to issue diagnostics that the standard says are not
502   required.  */
503
504extern int flag_optional_diags;
505
506/* Nonzero means we should attempt to elide constructors when possible.  */
507
508extern int flag_elide_constructors;
509
510/* Nonzero means that member functions defined in class scope are
511   inline by default.  */
512
513extern int flag_default_inline;
514
515/* Controls whether compiler generates 'type descriptor' that give
516   run-time type information.  */
517
518extern int flag_rtti;
519
520/* Nonzero if we want to conserve space in the .o files.  We do this
521   by putting uninitialized data and runtime initialized data into
522   .common instead of .data at the expense of not flagging multiple
523   definitions.  */
524
525extern int flag_conserve_space;
526
527/* Nonzero if we want to obey access control semantics.  */
528
529extern int flag_access_control;
530
531/* Nonzero if we want to check the return value of new and avoid calling
532   constructors if it is a null pointer.  */
533
534extern int flag_check_new;
535
536/* Nonzero if we want the new ISO rules for pushing a new scope for `for'
537   initialization variables.
538   0: Old rules, set by -fno-for-scope.
539   2: New ISO rules, set by -ffor-scope.
540   1: Try to implement new ISO rules, but with backup compatibility
541   (and warnings).  This is the default, for now.  */
542
543extern int flag_new_for_scope;
544
545/* Nonzero if we want to emit defined symbols with common-like linkage as
546   weak symbols where possible, in order to conform to C++ semantics.
547   Otherwise, emit them as local symbols.  */
548
549extern int flag_weak;
550
551/* 0 means we want the preprocessor to not emit line directives for
552   the current working directory.  1 means we want it to do it.  -1
553   means we should decide depending on whether debugging information
554   is being emitted or not.  */
555
556extern int flag_working_directory;
557
558/* Nonzero to use __cxa_atexit, rather than atexit, to register
559   destructors for local statics and global objects.  */
560
561extern int flag_use_cxa_atexit;
562
563/* Nonzero to use __cxa_get_exception_ptr in the C++ exception-handling
564   logic.  */
565
566extern int flag_use_cxa_get_exception_ptr;
567
568/* Nonzero means make the default pedwarns warnings instead of errors.
569   The value of this flag is ignored if -pedantic is specified.  */
570
571extern int flag_permissive;
572
573/* Nonzero means to implement standard semantics for exception
574   specifications, calling unexpected if an exception is thrown that
575   doesn't match the specification.  Zero means to treat them as
576   assertions and optimize accordingly, but not check them.  */
577
578extern int flag_enforce_eh_specs;
579
580/* Nonzero (the default) means to generate thread-safe code for
581   initializing local statics.  */
582
583extern int flag_threadsafe_statics;
584
585/* Nonzero means warn about implicit declarations.  */
586
587extern int warn_implicit;
588
589/* Warn about using __null (as NULL in C++) as sentinel.  For code compiled
590   with GCC this doesn't matter as __null is guaranteed to have the right
591   size.  */
592
593extern int warn_strict_null_sentinel;
594
595/* Maximum template instantiation depth.  This limit is rather
596   arbitrary, but it exists to limit the time it takes to notice
597   infinite template instantiations.  */
598
599extern int max_tinst_depth;
600
601/* Nonzero means the expression being parsed will never be evaluated.
602   This is a count, since unevaluated expressions can nest.  */
603
604extern int skip_evaluation;
605
606/* C types are partitioned into three subsets: object, function, and
607   incomplete types.  */
608#define C_TYPE_OBJECT_P(type) \
609  (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
610
611#define C_TYPE_INCOMPLETE_P(type) \
612  (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
613
614#define C_TYPE_FUNCTION_P(type) \
615  (TREE_CODE (type) == FUNCTION_TYPE)
616
617/* For convenience we define a single macro to identify the class of
618   object or incomplete types.  */
619#define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
620  (!C_TYPE_FUNCTION_P (type))
621
622/* Attribute table common to the C front ends.  */
623extern const struct attribute_spec c_common_attribute_table[];
624extern const struct attribute_spec c_common_format_attribute_table[];
625
626/* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
627   ID is the identifier to use, NAME is the string.
628   TYPE_DEP indicates whether it depends on type of the function or not
629   (i.e. __PRETTY_FUNCTION__).  */
630
631extern tree (*make_fname_decl) (tree, int);
632
633extern tree identifier_global_value (tree);
634extern void record_builtin_type (enum rid, const char *, tree);
635extern tree build_void_list_node (void);
636extern void start_fname_decls (void);
637extern void finish_fname_decls (void);
638extern const char *fname_as_string (int);
639extern tree fname_decl (unsigned, tree);
640
641extern void check_function_arguments (tree, tree, tree);
642extern void check_function_arguments_recurse (void (*)
643					      (void *, tree,
644					       unsigned HOST_WIDE_INT),
645					      void *, tree,
646					      unsigned HOST_WIDE_INT);
647extern void check_function_format (tree, tree);
648extern void set_Wformat (int);
649extern tree handle_format_attribute (tree *, tree, tree, int, bool *);
650extern tree handle_format_arg_attribute (tree *, tree, tree, int, bool *);
651extern int c_common_handle_option (size_t code, const char *arg, int value);
652extern bool c_common_missing_argument (const char *opt, size_t code);
653extern tree c_common_type_for_mode (enum machine_mode, int);
654extern tree c_common_type_for_size (unsigned int, int);
655extern tree c_common_unsigned_type (tree);
656extern tree c_common_signed_type (tree);
657extern tree c_common_signed_or_unsigned_type (int, tree);
658extern tree c_build_bitfield_integer_type (unsigned HOST_WIDE_INT, int);
659extern tree c_common_truthvalue_conversion (tree);
660extern void c_apply_type_quals_to_decl (int, tree);
661extern tree c_sizeof_or_alignof_type (tree, bool, int);
662extern tree c_alignof_expr (tree);
663/* Print an error message for invalid operands to arith operation CODE.
664   NOP_EXPR is used as a special case (see truthvalue_conversion).  */
665extern void binary_op_error (enum tree_code, tree, tree);
666extern tree fix_string_type (tree);
667struct varray_head_tag;
668extern void constant_expression_warning (tree);
669extern bool strict_aliasing_warning (tree, tree, tree);
670extern void empty_body_warning (tree, tree);
671extern tree convert_and_check (tree, tree);
672extern void overflow_warning (tree);
673extern bool c_determine_visibility (tree);
674extern bool same_scalar_type_ignoring_signedness (tree, tree);
675
676#define c_sizeof(T)  c_sizeof_or_alignof_type (T, true, 1)
677#define c_alignof(T) c_sizeof_or_alignof_type (T, false, 1)
678
679/* Subroutine of build_binary_op, used for comparison operations.
680   See if the operands have both been converted from subword integer types
681   and, if so, perhaps change them both back to their original type.  */
682extern tree shorten_compare (tree *, tree *, tree *, enum tree_code *);
683
684extern tree pointer_int_sum (enum tree_code, tree, tree);
685extern unsigned int min_precision (tree, int);
686
687/* Add qualifiers to a type, in the fashion for C.  */
688extern tree c_build_qualified_type (tree, int);
689
690/* Build tree nodes and builtin functions common to both C and C++ language
691   frontends.  */
692extern void c_common_nodes_and_builtins (void);
693
694extern void set_builtin_user_assembler_name (tree decl, const char *asmspec);
695
696extern void disable_builtin_function (const char *);
697
698extern void set_compound_literal_name (tree decl);
699
700extern tree build_va_arg (tree, tree);
701
702extern unsigned int c_common_init_options (unsigned int, const char **);
703extern bool c_common_post_options (const char **);
704extern bool c_common_init (void);
705extern void c_common_finish (void);
706extern void c_common_parse_file (int);
707extern HOST_WIDE_INT c_common_get_alias_set (tree);
708extern void c_register_builtin_type (tree, const char*);
709extern bool c_promoting_integer_type_p (tree);
710extern int self_promoting_args_p (tree);
711extern tree strip_array_types (tree);
712extern tree strip_pointer_operator (tree);
713extern HOST_WIDE_INT c_common_to_target_charset (HOST_WIDE_INT);
714
715/* This is the basic parsing function.  */
716extern void c_parse_file (void);
717/* This is misnamed, it actually performs end-of-compilation processing.  */
718extern void finish_file	(void);
719
720
721/* These macros provide convenient access to the various _STMT nodes.  */
722
723/* Nonzero if a given STATEMENT_LIST represents the outermost binding
724   if a statement expression.  */
725#define STATEMENT_LIST_STMT_EXPR(NODE) \
726  TREE_LANG_FLAG_1 (STATEMENT_LIST_CHECK (NODE))
727
728/* Nonzero if a label has been added to the statement list.  */
729#define STATEMENT_LIST_HAS_LABEL(NODE) \
730  TREE_LANG_FLAG_3 (STATEMENT_LIST_CHECK (NODE))
731
732/* COMPOUND_LITERAL_EXPR accessors.  */
733#define COMPOUND_LITERAL_EXPR_DECL_STMT(NODE)		\
734  TREE_OPERAND (COMPOUND_LITERAL_EXPR_CHECK (NODE), 0)
735#define COMPOUND_LITERAL_EXPR_DECL(NODE)			\
736  DECL_EXPR_DECL (COMPOUND_LITERAL_EXPR_DECL_STMT (NODE))
737
738#define DEFTREECODE(SYM, NAME, TYPE, LENGTH) SYM,
739
740enum c_tree_code {
741  C_DUMMY_TREE_CODE = LAST_AND_UNUSED_TREE_CODE,
742#include "c-common.def"
743  LAST_C_TREE_CODE
744};
745
746#undef DEFTREECODE
747
748extern int anon_aggr_type_p (tree);
749
750/* For a VAR_DECL that is an anonymous union, these are the various
751   sub-variables that make up the anonymous union.  */
752#define DECL_ANON_UNION_ELEMS(NODE) DECL_ARGUMENTS ((NODE))
753
754/* In a FIELD_DECL, nonzero if the decl was originally a bitfield.  */
755#define DECL_C_BIT_FIELD(NODE) \
756  (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
757#define SET_DECL_C_BIT_FIELD(NODE) \
758  (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
759#define CLEAR_DECL_C_BIT_FIELD(NODE) \
760  (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
761
762extern void emit_local_var (tree);
763extern tree do_case (tree, tree);
764extern tree build_stmt (enum tree_code, ...);
765extern tree build_case_label (tree, tree, tree);
766
767/* These functions must be defined by each front-end which implements
768   a variant of the C language.  They are used in c-common.c.  */
769
770extern tree build_unary_op (enum tree_code, tree, int);
771extern tree build_binary_op (enum tree_code, tree, tree, int);
772extern tree perform_integral_promotions (tree);
773
774/* These functions must be defined by each front-end which implements
775   a variant of the C language.  They are used by port files.  */
776
777extern tree default_conversion (tree);
778
779/* Given two integer or real types, return the type for their sum.
780   Given two compatible ANSI C types, returns the merged type.  */
781
782extern tree common_type (tree, tree);
783
784extern tree decl_constant_value (tree);
785
786/* Handle increment and decrement of boolean types.  */
787extern tree boolean_increment (enum tree_code, tree);
788
789extern int case_compare (splay_tree_key, splay_tree_key);
790
791extern tree c_add_case_label (splay_tree, tree, tree, tree, tree);
792
793extern void c_do_switch_warnings (splay_tree, location_t, tree, tree);
794
795extern tree build_function_call (tree, tree);
796
797extern tree resolve_overloaded_builtin (tree, tree);
798
799extern tree finish_label_address_expr (tree);
800
801/* Same function prototype, but the C and C++ front ends have
802   different implementations.  Used in c-common.c.  */
803extern tree lookup_label (tree);
804extern tree lookup_name (tree);
805
806extern bool vector_types_convertible_p (tree t1, tree t2, bool emit_lax_note);
807
808extern rtx c_expand_expr (tree, rtx, enum machine_mode, int, rtx *);
809
810extern tree c_staticp (tree);
811
812extern void init_c_lex (void);
813
814extern void c_cpp_builtins (cpp_reader *);
815
816/* Positive if an implicit `extern "C"' scope has just been entered;
817   negative if such a scope has just been exited.  */
818extern GTY(()) int pending_lang_change;
819
820/* Information recorded about each file examined during compilation.  */
821
822struct c_fileinfo
823{
824  int time;	/* Time spent in the file.  */
825
826  /* Flags used only by C++.
827     INTERFACE_ONLY nonzero means that we are in an "interface" section
828     of the compiler.  INTERFACE_UNKNOWN nonzero means we cannot trust
829     the value of INTERFACE_ONLY.  If INTERFACE_UNKNOWN is zero and
830     INTERFACE_ONLY is zero, it means that we are responsible for
831     exporting definitions that others might need.  */
832  short interface_only;
833  short interface_unknown;
834};
835
836struct c_fileinfo *get_fileinfo (const char *);
837extern void dump_time_statistics (void);
838
839extern bool c_dump_tree (void *, tree);
840
841extern void c_warn_unused_result (tree *);
842
843extern void verify_sequence_points (tree);
844
845extern tree fold_offsetof (tree, tree);
846
847/* Places where an lvalue, or modifiable lvalue, may be required.
848   Used to select diagnostic messages in lvalue_error and
849   readonly_error.  */
850enum lvalue_use {
851  lv_assign,
852  lv_increment,
853  lv_decrement,
854  lv_addressof,
855  lv_asm
856};
857
858extern void lvalue_error (enum lvalue_use);
859
860extern int complete_array_type (tree *, tree, bool);
861
862extern tree builtin_type_for_size (int, bool);
863
864extern void warn_array_subscript_with_type_char (tree);
865extern void warn_about_parentheses (enum tree_code, enum tree_code,
866				    enum tree_code);
867
868
869/* In c-gimplify.c  */
870extern void c_genericize (tree);
871extern int c_gimplify_expr (tree *, tree *, tree *);
872extern tree c_build_bind_expr (tree, tree);
873
874/* In c-pch.c  */
875extern void pch_init (void);
876extern int c_common_valid_pch (cpp_reader *pfile, const char *name, int fd);
877extern void c_common_read_pch (cpp_reader *pfile, const char *name, int fd,
878			       const char *orig);
879extern void c_common_write_pch (void);
880extern void c_common_no_more_pch (void);
881extern void c_common_pch_pragma (cpp_reader *pfile, const char *);
882extern void c_common_print_pch_checksum (FILE *f);
883
884/* In *-checksum.c */
885extern const unsigned char executable_checksum[16];
886
887extern void builtin_define_with_value (const char *, const char *, int);
888extern void c_stddef_cpp_builtins (void);
889extern void fe_file_change (const struct line_map *);
890extern void c_parse_error (const char *, enum cpp_ttype, tree);
891
892/* Objective-C / Objective-C++ entry points.  */
893
894/* The following ObjC/ObjC++ functions are called by the C and/or C++
895   front-ends; they all must have corresponding stubs in stub-objc.c.  */
896extern tree objc_is_class_name (tree);
897extern tree objc_is_object_ptr (tree);
898extern void objc_check_decl (tree);
899/* APPLE LOCAL radar 4281748 */
900extern void objc_check_global_decl (tree);
901extern int objc_is_reserved_word (tree);
902/* APPLE LOCAL 4154928 */
903extern tree objc_common_type (tree, tree);
904/* APPLE LOCAL 4330422 */
905extern tree objc_non_volatilized_type (tree);
906/* APPLE LOCAL radar 4697411 */
907extern void objc_volatilize_component_ref (tree, tree);
908/* APPLE LOCAL radar 6231433 */
909extern bool objc_compare_types (tree, tree, int, tree, const char *);
910/* APPLE LOCAL radar 4229905 - radar 6231433 */
911extern bool objc_have_common_type (tree, tree, int, tree, const char *);
912/* APPLE LOCAL radar 4133425 */
913extern bool objc_diagnose_private_ivar (tree);
914/* APPLE LOCAL radar 4507230 */
915bool objc_type_valid_for_messaging (tree);
916extern void objc_volatilize_decl (tree);
917extern bool objc_type_quals_match (tree, tree);
918extern tree objc_rewrite_function_call (tree, tree);
919extern tree objc_message_selector (void);
920extern tree objc_lookup_ivar (tree, tree);
921extern void objc_clear_super_receiver (void);
922extern int objc_is_public (tree, tree);
923extern tree objc_is_id (tree);
924extern void objc_declare_alias (tree, tree);
925extern void objc_declare_class (tree);
926/* APPLE LOCAL radar 4947311 - protocol attributes */
927extern void objc_declare_protocols (tree, tree);
928extern tree objc_build_message_expr (tree);
929extern tree objc_finish_message_expr (tree, tree, tree);
930extern tree objc_build_selector_expr (tree);
931extern tree objc_build_protocol_expr (tree);
932extern tree objc_build_encode_expr (tree);
933extern tree objc_build_string_object (tree);
934extern tree objc_get_protocol_qualified_type (tree, tree);
935extern tree objc_get_class_reference (tree);
936extern tree objc_get_class_ivars (tree);
937/* APPLE LOCAL begin radar 4291785 */
938extern tree objc_get_interface_ivars (tree);
939extern void objc_detect_field_duplicates (tree);
940/* APPLE LOCAL end radar 4291785 */
941/* APPLE LOCAL radar 4548636 */
942extern void objc_start_class_interface (tree, tree, tree, tree);
943extern void objc_start_category_interface (tree, tree, tree);
944/* APPLE LOCAL radar 4947311 - protocol attributes */
945extern void objc_start_protocol (tree, tree, tree);
946extern void objc_continue_interface (void);
947extern void objc_finish_interface (void);
948extern void objc_start_class_implementation (tree, tree);
949extern void objc_start_category_implementation (tree, tree);
950/* APPLE LOCAL radar 4592503 */
951extern void objc_checkon_weak_attribute (tree);
952/* APPLE LOCAL begin radar 5847976 */
953extern tree build_block_object_assign_call_exp (tree, tree, int);
954extern tree build_block_object_dispose_call_exp (tree, int);
955extern int objc_is_gcable_type (tree);
956/* APPLE LOCAL end radar 5847976 */
957extern void objc_continue_implementation (void);
958extern void objc_finish_implementation (void);
959extern void objc_set_visibility (int);
960extern void objc_set_method_type (enum tree_code);
961extern tree objc_build_method_signature (tree, tree, tree, bool);
962/* APPLE LOCAL begin radar 3803157 - objc attribute */
963extern bool objc_method_decl (enum tree_code);
964extern void objc_add_method_declaration (tree, tree);
965extern void objc_start_method_definition (tree, tree);
966/* APPLE LOCAL end radar 3803157 - objc attribute */
967extern void objc_finish_method_definition (tree);
968extern void objc_add_instance_variable (tree);
969/* APPLE LOCAL radar 4157812 */
970extern tree objc_build_keyword_decl (tree, tree, tree, tree);
971extern tree objc_build_throw_stmt (tree);
972extern void objc_begin_try_stmt (location_t, tree);
973extern tree objc_finish_try_stmt (void);
974extern void objc_begin_catch_clause (tree);
975extern void objc_finish_catch_clause (void);
976extern void objc_build_finally_clause (location_t, tree);
977extern tree objc_build_synchronized (location_t, tree, tree);
978extern int objc_static_init_needed_p (void);
979extern tree objc_generate_static_init_call (tree);
980extern tree objc_generate_write_barrier (tree, enum tree_code, tree);
981/* APPLE LOCAL radar 5276085 */
982extern void objc_weak_reference_expr (tree*);
983/* APPLE LOCAL begin 5276085 */
984extern tree objc_build_weak_reference_tree (tree);
985/* APPLE LOCAL end 5276085 */
986
987/* APPLE LOCAL begin C* language */
988extern void objc_set_method_opt (int);
989void objc_finish_foreach_loop (location_t, tree, tree, tree, tree);
990tree objc_build_component_ref (tree, tree);
991tree objc_build_foreach_components (tree, tree*, tree*, tree*,
992				     tree*, tree*, tree*);
993/* APPLE LOCAL end C* language */
994/* APPLE LOCAL begin C* property (Radar 4436866) */
995void objc_set_property_attr (int, tree);
996void objc_add_property_variable (tree);
997/* APPLE LOCAL begin radar 5285911 */
998tree objc_build_property_reference_expr (tree, tree);
999bool objc_property_reference_expr (tree);
1000/* APPLE LOCAL end radar 5285911 */
1001/* APPLE LOCAL radar 5802025 */
1002tree objc_build_property_getter_func_call (tree);
1003tree objc_build_setter_call (tree, tree);
1004/* APPLE LOCAL end C* property (Radar 4436866) */
1005/* APPLE LOCAL radar 4712269 */
1006tree objc_build_incr_decr_setter_call (enum tree_code, tree, tree);
1007
1008/* APPLE LOCAL begin C* warnings to easy porting to new abi */
1009void diagnose_selector_cast (tree cast_type, tree sel_exp);
1010/* APPLE LOCAL end C* warnings to easy porting to new abi */
1011
1012/* APPLE LOCAL begin radar 4441049 */
1013tree objc_v2_component_ref_field_offset (tree);
1014tree objc_v2_bitfield_ivar_bitpos (tree);
1015/* APPLE LOCAL end radar 4441049 */
1016
1017/* APPLE LOCAL begin 4985544 */
1018bool objc_check_format_nsstring (tree, unsigned HOST_WIDE_INT, bool *);
1019/* APPLE LOCAL end 4985544 */
1020
1021/* APPLE LOCAL radar 5202926 */
1022bool objc_anonymous_local_objc_name (const char *);
1023/* APPLE LOCAL begin radar 5195402 */
1024bool objc_check_nsstring_pointer_type (tree);
1025bool objc_check_cfstringref_type (tree);
1026/* APPLE LOCAL end radar 5195402 */
1027
1028/* The following are provided by the C and C++ front-ends, and called by
1029   ObjC/ObjC++.  */
1030extern void *objc_get_current_scope (void);
1031extern void objc_mark_locals_volatile (void *);
1032
1033/* In c-ppoutput.c  */
1034extern void init_pp_output (FILE *);
1035extern void preprocess_file (cpp_reader *);
1036extern void pp_file_change (const struct line_map *);
1037extern void pp_dir_change (cpp_reader *, const char *);
1038extern bool check_missing_format_attribute (tree, tree);
1039
1040
1041/* APPLE LOCAL begin radar 5847976 */
1042/* Runtime support functions used by compiler when generating copy/dispose helpers */
1043enum {
1044    BLOCK_FIELD_IS_OBJECT   =  3,  /* id, NSObject, __attribute__((NSObject)), block, ... */
1045    BLOCK_FIELD_IS_BLOCK    =  7,  /* a block variable */
1046    BLOCK_FIELD_IS_BYREF    =  8,  /* the on stack structure holding the __block variable */
1047    BLOCK_FIELD_IS_WEAK     = 16,  /* declared __weak, only used in byref copy helpers */
1048    BLOCK_BYREF_CALLER      = 128,  /* called from __block (byref) copy/dispose support routines */
1049    BLOCK_BYREF_CURRENT_MAX = 256
1050};
1051/* APPLE LOCAL end radar 5847976 */
1052/* APPLE LOCAL begin radar 5732232 - blocks */
1053enum {
1054     BLOCK_NEEDS_FREE =        (1 << 24),
1055     BLOCK_HAS_COPY_DISPOSE =  (1 << 25),
1056     /* APPLE LOCAL radar 6214617 */
1057     BLOCK_HAS_CXX_OBJ =       (1 << 26),
1058     BLOCK_IS_GC =             (1 << 27),
1059     /* APPLE LOCAL radar 5822844 */
1060     BLOCK_IS_GLOBAL = 	       (1 << 28),
1061     /* APPLE LOCAL radar 7735196 */
1062     BLOCK_USE_STRET =    (1 << 29)
1063};
1064
1065struct block_sema_info {
1066  tree helper_func_decl;
1067  tree copy_helper_func_decl;
1068  tree destroy_helper_func_decl;
1069  tree block_arg_ptr_type;
1070  /* This is for C.  */
1071  struct c_arg_info * arg_info;
1072  tree block_ref_decl_list;
1073  tree block_byref_decl_list;
1074  /* APPLE LOCAL radar 5803600 */
1075  tree block_byref_global_decl_list;
1076  tree block_original_ref_decl_list;
1077  /* APPLE LOCAL radar 5847213 - tree block_original_byref_decl_list is removed. */
1078  tree block_body;
1079  bool BlockHasCopyDispose;
1080  /* APPLE LOCAL radar 6214617 */
1081  bool BlockImportsCxxObjects;
1082  /* APPLE LOCAL radar 6185344 */
1083  bool block_has_return_type; /* When true, block has a declared return type. */
1084
1085  /* the_scope - This is the scope for the block itself, which
1086     contains arguments etc.  Use only for C.  */
1087  struct c_scope *the_scope;
1088  /* Same as the above, only for C++.  */
1089  struct cp_binding_level *cp_the_scope;
1090
1091  /* return_type - This will get set to block result type, by looking
1092     at return types, if any, in the block body. */
1093  tree return_type;
1094
1095  /* prev_block_info - If this is nested inside another block, this points
1096     to the outer block. */
1097  struct block_sema_info *prev_block_info;
1098};
1099
1100extern struct block_sema_info *cur_block;
1101extern tree build_helper_func_decl (tree, tree);
1102extern tree build_block_byref_decl (tree, tree, tree);
1103extern tree build_block_ref_decl (tree, tree);
1104extern tree begin_block (void);
1105extern struct block_sema_info *finish_block (tree);
1106extern bool in_imm_block (void);
1107extern bool lookup_name_in_block (tree, tree*);
1108extern void push_to_top_level (void);
1109extern void pop_from_top_level (void);
1110extern void start_block_helper_function (tree func_decl);
1111extern void block_build_prologue (struct block_sema_info *block_impl);
1112extern tree c_finish_return (tree);
1113extern bool block_requires_copying (tree);
1114/* APPLE LOCAL begin radar 5803600 */
1115extern void add_block_global_byref_list (tree);
1116extern bool in_block_global_byref_list (tree);
1117/* APPLE LOCAL end radar 5803600 */
1118/* APPLE LOCAL end radar 5732232 - blocks */
1119/* APPLE LOCAL begin radar 5932809 - copyable byref blocks */
1120extern tree build_byref_local_var_access (tree, tree);
1121extern tree do_digest_init (tree, tree);
1122/* APPLE LOCAL end radar 5932809 - copyable byref blocks */
1123/* APPLE LOCAL begin radar 6237713 */
1124extern bool any_recognized_block_attribute (tree);
1125/* APPLE LOCAL end radar 6237713 */
1126
1127/* APPLE LOCAL begin radar 5847213 */
1128extern tree build_block_descriptor_type (bool);
1129/* APPLE LOCAL end radar 5847213 */
1130/* APPLE LOCAL begin radar 6083129 - byref escapes */
1131extern tree build_block_byref_release_exp (tree);
1132/* APPLE LOCAL end radar 6083129 - byref escapes */
1133
1134/* APPLE LOCAL radar 6040305 - blocks */
1135extern tree build_indirect_object_id_exp (tree);
1136/* APPLE LOCAL begin radar 6212722 */
1137extern tree array_to_pointer_conversion (tree);
1138extern tree function_to_pointer_conversion (tree);
1139/* APPLE LOCAL end radar 6212722 */
1140
1141/* APPLE LOCAL radar 6160536 */
1142extern tree build_block_helper_name (int);
1143
1144/* APPLE LOCAL radar 6353006  */
1145extern tree c_build_generic_block_struct_type (void);
1146
1147/* APPLE LOCAL radar 7760213 */
1148extern int HasByrefArray(tree);
1149
1150/* In c-omp.c  */
1151extern tree c_finish_omp_master (tree);
1152extern tree c_finish_omp_critical (tree, tree);
1153extern tree c_finish_omp_ordered (tree);
1154extern void c_finish_omp_barrier (void);
1155extern tree c_finish_omp_atomic (enum tree_code, tree, tree);
1156extern void c_finish_omp_flush (void);
1157extern tree c_finish_omp_for (location_t, tree, tree, tree, tree, tree, tree);
1158extern void c_split_parallel_clauses (tree, tree *, tree *);
1159extern enum omp_clause_default_kind c_omp_predetermined_sharing (tree);
1160
1161/* Not in c-omp.c; provided by the front end.  */
1162extern bool c_omp_sharing_predetermined (tree);
1163extern tree c_omp_remap_decl (tree, bool);
1164
1165/* In order for the format checking to accept the C frontend
1166   diagnostic framework extensions, you must include this file before
1167   toplev.h, not after.  The C front end formats are a subset of those
1168   for C++, so they are the appropriate set to use in common code;
1169   cp-tree.h overrides this for C++.  */
1170#ifndef GCC_DIAG_STYLE
1171#define GCC_DIAG_STYLE __gcc_cdiag__
1172#endif
1173
1174#endif /* ! GCC_C_COMMON_H */
1175