c-common.h revision 260074 
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  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.  */
124extern GTY ((length ("(int) RID_MAX"))) tree *ridpointers;
125
126/* Standard named or nameless data types of the C compiler.  */
127
128enum 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.  */
171struct 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
211extern 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.  */
215struct 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
225typedef 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}
232c_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.  */
236extern 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
243struct 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
264typedef 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
269struct 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.  */
285extern int (*lang_missing_noreturn_ok_p) (tree);
286
287/* If non-NULL, this function is called after a precompile header file
288   is loaded.  */
289extern void (*lang_post_pch_load) (void);
290
291extern void push_file_scope (void);
292extern void pop_file_scope (void);
293extern stmt_tree current_stmt_tree (void);
294extern tree push_stmt_list (void);
295extern tree pop_stmt_list (tree);
296extern tree add_stmt (tree);
297extern void push_cleanup (tree, tree, bool);
298extern tree pushdecl_top_level (tree);
299extern tree pushdecl (tree);
300extern tree build_modify_expr (tree, enum tree_code, tree);
301extern tree build_indirect_ref (tree, const char *);
302
303extern int c_expand_decl (tree);
304
305extern int field_decl_cmp (const void *, const void *);
306extern void resort_sorted_fields (void *, void *, gt_pointer_operator,
307				  void *);
308extern bool has_c_linkage (tree decl);
309
310/* Switches common to the C front ends.  */
311
312/* Nonzero if prepreprocessing only.  */
313
314extern 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.  */
319extern int flag_nil_receivers;
320
321/* Nonzero means that we will allow new ObjC exception syntax (@throw,
322   @try, etc.) in source code.  */
323extern int flag_objc_exceptions;
324
325/* Nonzero means that we generate NeXT setjmp based exceptions.  */
326extern 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.  */
331extern 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.  */
336extern int flag_replace_objc_classes;
337
338/* Nonzero means don't output line number information.  */
339
340extern 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
345extern 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
350extern char flag_dump_macros;
351
352/* Nonzero means pass #include lines through to the output.  */
353
354extern char flag_dump_includes;
355
356/* Nonzero means process PCH files while preprocessing.  */
357
358extern 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
363extern const char *pch_file;
364
365/* Nonzero if an ISO standard was selected.  It rejects macros in the
366   user's namespace.  */
367
368extern int flag_iso;
369
370/* Nonzero if -undef was given.  It suppresses target built-in macros
371   and assertions.  */
372
373extern int flag_undef;
374
375/* Nonzero means don't recognize the non-ANSI builtin functions.  */
376
377extern int flag_no_builtin;
378
379/* Nonzero means don't recognize the non-ANSI builtin functions.
380   -ansi sets this.  */
381
382extern int flag_no_nonansi_builtin;
383
384/* Nonzero means give `double' the same size as `float'.  */
385
386extern int flag_short_double;
387
388/* Nonzero means give `wchar_t' the same size as `short'.  */
389
390extern int flag_short_wchar;
391
392/* Nonzero means allow implicit conversions between vectors with
393   differing numbers of subparts and/or differing element types.  */
394extern int flag_lax_vector_conversions;
395
396/* Nonzero means allow Microsoft extensions without warnings or errors.  */
397extern int flag_ms_extensions;
398
399/* Nonzero means don't recognize the keyword `asm'.  */
400
401extern int flag_no_asm;
402
403/* Nonzero means give string constants the type `const char *', as mandated
404   by the standard.  */
405
406extern int flag_const_strings;
407
408/* Nonzero means to treat bitfields as signed unless they say `unsigned'.  */
409
410extern int flag_signed_bitfields;
411
412/* Warn about #pragma directives that are not recognized.  */
413
414extern int warn_unknown_pragmas; /* Tri state variable.  */
415
416/* Warn about format/argument anomalies in calls to formatted I/O functions
417   (*printf, *scanf, strftime, strfmon, etc.).  */
418
419extern int warn_format;
420
421
422/* C/ObjC language option variables.  */
423
424
425/* Nonzero means allow type mismatches in conditional expressions;
426   just make their values `void'.  */
427
428extern int flag_cond_mismatch;
429
430/* Nonzero means enable C89 Amendment 1 features.  */
431
432extern int flag_isoc94;
433
434/* Nonzero means use the ISO C99 dialect of C.  */
435
436extern int flag_isoc99;
437
438/* Nonzero means that we have builtin functions, and main is an int.  */
439
440extern int flag_hosted;
441
442/* Warn if main is suspicious.  */
443
444extern int warn_main;
445
446
447/* ObjC language option variables.  */
448
449
450/* Open and close the file for outputting class declarations, if
451   requested (ObjC).  */
452
453extern int flag_gen_declaration;
454
455/* Tells the compiler that this is a special run.  Do not perform any
456   compiling, instead we are to test some platform dependent features
457   and output a C header file with appropriate definitions.  */
458
459extern int print_struct_values;
460
461/* ???.  Undocumented.  */
462
463extern const char *constant_string_class_name;
464
465
466/* C++ language option variables.  */
467
468
469/* Nonzero means don't recognize any extension keywords.  */
470
471extern int flag_no_gnu_keywords;
472
473/* Nonzero means do emit exported implementations of functions even if
474   they can be inlined.  */
475
476extern int flag_implement_inlines;
477
478/* Nonzero means that implicit instantiations will be emitted if needed.  */
479
480extern int flag_implicit_templates;
481
482/* Nonzero means that implicit instantiations of inline templates will be
483   emitted if needed, even if instantiations of non-inline templates
484   aren't.  */
485
486extern int flag_implicit_inline_templates;
487
488/* Nonzero means generate separate instantiation control files and
489   juggle them at link time.  */
490
491extern int flag_use_repository;
492
493/* Nonzero if we want to issue diagnostics that the standard says are not
494   required.  */
495
496extern int flag_optional_diags;
497
498/* Nonzero means we should attempt to elide constructors when possible.  */
499
500extern int flag_elide_constructors;
501
502/* Nonzero means that member functions defined in class scope are
503   inline by default.  */
504
505extern int flag_default_inline;
506
507/* Controls whether compiler generates 'type descriptor' that give
508   run-time type information.  */
509
510extern int flag_rtti;
511
512/* Nonzero if we want to conserve space in the .o files.  We do this
513   by putting uninitialized data and runtime initialized data into
514   .common instead of .data at the expense of not flagging multiple
515   definitions.  */
516
517extern int flag_conserve_space;
518
519/* Nonzero if we want to obey access control semantics.  */
520
521extern int flag_access_control;
522
523/* Nonzero if we want to check the return value of new and avoid calling
524   constructors if it is a null pointer.  */
525
526extern int flag_check_new;
527
528/* Nonzero if we want the new ISO rules for pushing a new scope for `for'
529   initialization variables.
530   0: Old rules, set by -fno-for-scope.
531   2: New ISO rules, set by -ffor-scope.
532   1: Try to implement new ISO rules, but with backup compatibility
533   (and warnings).  This is the default, for now.  */
534
535extern int flag_new_for_scope;
536
537/* Nonzero if we want to emit defined symbols with common-like linkage as
538   weak symbols where possible, in order to conform to C++ semantics.
539   Otherwise, emit them as local symbols.  */
540
541extern int flag_weak;
542
543/* 0 means we want the preprocessor to not emit line directives for
544   the current working directory.  1 means we want it to do it.  -1
545   means we should decide depending on whether debugging information
546   is being emitted or not.  */
547
548extern int flag_working_directory;
549
550/* Nonzero to use __cxa_atexit, rather than atexit, to register
551   destructors for local statics and global objects.  */
552
553extern int flag_use_cxa_atexit;
554
555/* Nonzero to use __cxa_get_exception_ptr in the C++ exception-handling
556   logic.  */
557
558extern int flag_use_cxa_get_exception_ptr;
559
560/* Nonzero means make the default pedwarns warnings instead of errors.
561   The value of this flag is ignored if -pedantic is specified.  */
562
563extern int flag_permissive;
564
565/* Nonzero means to implement standard semantics for exception
566   specifications, calling unexpected if an exception is thrown that
567   doesn't match the specification.  Zero means to treat them as
568   assertions and optimize accordingly, but not check them.  */
569
570extern int flag_enforce_eh_specs;
571
572/* Nonzero (the default) means to generate thread-safe code for
573   initializing local statics.  */
574
575extern int flag_threadsafe_statics;
576
577/* Nonzero means warn about implicit declarations.  */
578
579extern int warn_implicit;
580
581/* Warn about using __null (as NULL in C++) as sentinel.  For code compiled
582   with GCC this doesn't matter as __null is guaranteed to have the right
583   size.  */
584
585extern int warn_strict_null_sentinel;
586
587/* Maximum template instantiation depth.  This limit is rather
588   arbitrary, but it exists to limit the time it takes to notice
589   infinite template instantiations.  */
590
591extern int max_tinst_depth;
592
593/* Nonzero means the expression being parsed will never be evaluated.
594   This is a count, since unevaluated expressions can nest.  */
595
596extern int skip_evaluation;
597
598/* C types are partitioned into three subsets: object, function, and
599   incomplete types.  */
600#define C_TYPE_OBJECT_P(type) \
601  (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
602
603#define C_TYPE_INCOMPLETE_P(type) \
604  (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
605
606#define C_TYPE_FUNCTION_P(type) \
607  (TREE_CODE (type) == FUNCTION_TYPE)
608
609/* For convenience we define a single macro to identify the class of
610   object or incomplete types.  */
611#define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
612  (!C_TYPE_FUNCTION_P (type))
613
614/* Attribute table common to the C front ends.  */
615extern const struct attribute_spec c_common_attribute_table[];
616extern const struct attribute_spec c_common_format_attribute_table[];
617
618/* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
619   ID is the identifier to use, NAME is the string.
620   TYPE_DEP indicates whether it depends on type of the function or not
621   (i.e. __PRETTY_FUNCTION__).  */
622
623extern tree (*make_fname_decl) (tree, int);
624
625extern tree identifier_global_value (tree);
626extern void record_builtin_type (enum rid, const char *, tree);
627extern tree build_void_list_node (void);
628extern void start_fname_decls (void);
629extern void finish_fname_decls (void);
630extern const char *fname_as_string (int);
631extern tree fname_decl (unsigned, tree);
632
633extern void check_function_arguments (tree, tree, tree);
634extern void check_function_arguments_recurse (void (*)
635					      (void *, tree,
636					       unsigned HOST_WIDE_INT),
637					      void *, tree,
638					      unsigned HOST_WIDE_INT);
639extern void check_function_format (tree, tree);
640extern void set_Wformat (int);
641extern tree handle_format_attribute (tree *, tree, tree, int, bool *);
642extern tree handle_format_arg_attribute (tree *, tree, tree, int, bool *);
643extern int c_common_handle_option (size_t code, const char *arg, int value);
644extern bool c_common_missing_argument (const char *opt, size_t code);
645extern tree c_common_type_for_mode (enum machine_mode, int);
646extern tree c_common_type_for_size (unsigned int, int);
647extern tree c_common_unsigned_type (tree);
648extern tree c_common_signed_type (tree);
649extern tree c_common_signed_or_unsigned_type (int, tree);
650extern tree c_build_bitfield_integer_type (unsigned HOST_WIDE_INT, int);
651extern tree c_common_truthvalue_conversion (tree);
652extern void c_apply_type_quals_to_decl (int, tree);
653extern tree c_sizeof_or_alignof_type (tree, bool, int);
654extern tree c_alignof_expr (tree);
655/* Print an error message for invalid operands to arith operation CODE.
656   NOP_EXPR is used as a special case (see truthvalue_conversion).  */
657extern void binary_op_error (enum tree_code, tree, tree);
658extern tree fix_string_type (tree);
659struct varray_head_tag;
660extern void constant_expression_warning (tree);
661extern bool strict_aliasing_warning (tree, tree, tree);
662extern void empty_body_warning (tree, tree);
663extern tree convert_and_check (tree, tree);
664extern void overflow_warning (tree);
665extern bool c_determine_visibility (tree);
666extern bool same_scalar_type_ignoring_signedness (tree, tree);
667
668#define c_sizeof(T)  c_sizeof_or_alignof_type (T, true, 1)
669#define c_alignof(T) c_sizeof_or_alignof_type (T, false, 1)
670
671/* Subroutine of build_binary_op, used for comparison operations.
672   See if the operands have both been converted from subword integer types
673   and, if so, perhaps change them both back to their original type.  */
674extern tree shorten_compare (tree *, tree *, tree *, enum tree_code *);
675
676extern tree pointer_int_sum (enum tree_code, tree, tree);
677extern unsigned int min_precision (tree, int);
678
679/* Add qualifiers to a type, in the fashion for C.  */
680extern tree c_build_qualified_type (tree, int);
681
682/* Build tree nodes and builtin functions common to both C and C++ language
683   frontends.  */
684extern void c_common_nodes_and_builtins (void);
685
686extern void set_builtin_user_assembler_name (tree decl, const char *asmspec);
687
688extern void disable_builtin_function (const char *);
689
690extern void set_compound_literal_name (tree decl);
691
692extern tree build_va_arg (tree, tree);
693
694extern unsigned int c_common_init_options (unsigned int, const char **);
695extern bool c_common_post_options (const char **);
696extern bool c_common_init (void);
697extern void c_common_finish (void);
698extern void c_common_parse_file (int);
699extern HOST_WIDE_INT c_common_get_alias_set (tree);
700extern void c_register_builtin_type (tree, const char*);
701extern bool c_promoting_integer_type_p (tree);
702extern int self_promoting_args_p (tree);
703extern tree strip_array_types (tree);
704extern tree strip_pointer_operator (tree);
705extern HOST_WIDE_INT c_common_to_target_charset (HOST_WIDE_INT);
706
707/* This is the basic parsing function.  */
708extern void c_parse_file (void);
709/* This is misnamed, it actually performs end-of-compilation processing.  */
710extern void finish_file	(void);
711
712
713/* These macros provide convenient access to the various _STMT nodes.  */
714
715/* Nonzero if a given STATEMENT_LIST represents the outermost binding
716   if a statement expression.  */
717#define STATEMENT_LIST_STMT_EXPR(NODE) \
718  TREE_LANG_FLAG_1 (STATEMENT_LIST_CHECK (NODE))
719
720/* Nonzero if a label has been added to the statement list.  */
721#define STATEMENT_LIST_HAS_LABEL(NODE) \
722  TREE_LANG_FLAG_3 (STATEMENT_LIST_CHECK (NODE))
723
724/* COMPOUND_LITERAL_EXPR accessors.  */
725#define COMPOUND_LITERAL_EXPR_DECL_STMT(NODE)		\
726  TREE_OPERAND (COMPOUND_LITERAL_EXPR_CHECK (NODE), 0)
727#define COMPOUND_LITERAL_EXPR_DECL(NODE)			\
728  DECL_EXPR_DECL (COMPOUND_LITERAL_EXPR_DECL_STMT (NODE))
729
730#define DEFTREECODE(SYM, NAME, TYPE, LENGTH) SYM,
731
732enum c_tree_code {
733  C_DUMMY_TREE_CODE = LAST_AND_UNUSED_TREE_CODE,
734#include "c-common.def"
735  LAST_C_TREE_CODE
736};
737
738#undef DEFTREECODE
739
740extern int anon_aggr_type_p (tree);
741
742/* For a VAR_DECL that is an anonymous union, these are the various
743   sub-variables that make up the anonymous union.  */
744#define DECL_ANON_UNION_ELEMS(NODE) DECL_ARGUMENTS ((NODE))
745
746/* In a FIELD_DECL, nonzero if the decl was originally a bitfield.  */
747#define DECL_C_BIT_FIELD(NODE) \
748  (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
749#define SET_DECL_C_BIT_FIELD(NODE) \
750  (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
751#define CLEAR_DECL_C_BIT_FIELD(NODE) \
752  (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
753
754extern void emit_local_var (tree);
755extern tree do_case (tree, tree);
756extern tree build_stmt (enum tree_code, ...);
757extern tree build_case_label (tree, tree, tree);
758
759/* These functions must be defined by each front-end which implements
760   a variant of the C language.  They are used in c-common.c.  */
761
762extern tree build_unary_op (enum tree_code, tree, int);
763extern tree build_binary_op (enum tree_code, tree, tree, int);
764extern tree perform_integral_promotions (tree);
765
766/* These functions must be defined by each front-end which implements
767   a variant of the C language.  They are used by port files.  */
768
769extern tree default_conversion (tree);
770
771/* Given two integer or real types, return the type for their sum.
772   Given two compatible ANSI C types, returns the merged type.  */
773
774extern tree common_type (tree, tree);
775
776extern tree decl_constant_value (tree);
777
778/* Handle increment and decrement of boolean types.  */
779extern tree boolean_increment (enum tree_code, tree);
780
781extern int case_compare (splay_tree_key, splay_tree_key);
782
783extern tree c_add_case_label (splay_tree, tree, tree, tree, tree);
784
785extern void c_do_switch_warnings (splay_tree, location_t, tree, tree);
786
787extern tree build_function_call (tree, tree);
788
789extern tree resolve_overloaded_builtin (tree, tree);
790
791extern tree finish_label_address_expr (tree);
792
793/* Same function prototype, but the C and C++ front ends have
794   different implementations.  Used in c-common.c.  */
795extern tree lookup_label (tree);
796extern tree lookup_name (tree);
797
798extern bool vector_types_convertible_p (tree t1, tree t2, bool emit_lax_note);
799
800extern rtx c_expand_expr (tree, rtx, enum machine_mode, int, rtx *);
801
802extern tree c_staticp (tree);
803
804extern void init_c_lex (void);
805
806extern void c_cpp_builtins (cpp_reader *);
807
808/* Positive if an implicit `extern "C"' scope has just been entered;
809   negative if such a scope has just been exited.  */
810extern GTY(()) int pending_lang_change;
811
812/* Information recorded about each file examined during compilation.  */
813
814struct c_fileinfo
815{
816  int time;	/* Time spent in the file.  */
817
818  /* Flags used only by C++.
819     INTERFACE_ONLY nonzero means that we are in an "interface" section
820     of the compiler.  INTERFACE_UNKNOWN nonzero means we cannot trust
821     the value of INTERFACE_ONLY.  If INTERFACE_UNKNOWN is zero and
822     INTERFACE_ONLY is zero, it means that we are responsible for
823     exporting definitions that others might need.  */
824  short interface_only;
825  short interface_unknown;
826};
827
828struct c_fileinfo *get_fileinfo (const char *);
829extern void dump_time_statistics (void);
830
831extern bool c_dump_tree (void *, tree);
832
833extern void c_warn_unused_result (tree *);
834
835extern void verify_sequence_points (tree);
836
837extern tree fold_offsetof (tree, tree);
838
839/* Places where an lvalue, or modifiable lvalue, may be required.
840   Used to select diagnostic messages in lvalue_error and
841   readonly_error.  */
842enum lvalue_use {
843  lv_assign,
844  lv_increment,
845  lv_decrement,
846  lv_addressof,
847  lv_asm
848};
849
850extern void lvalue_error (enum lvalue_use);
851
852extern int complete_array_type (tree *, tree, bool);
853
854extern tree builtin_type_for_size (int, bool);
855
856extern void warn_array_subscript_with_type_char (tree);
857extern void warn_about_parentheses (enum tree_code, enum tree_code,
858				    enum tree_code);
859
860
861/* In c-gimplify.c  */
862extern void c_genericize (tree);
863extern int c_gimplify_expr (tree *, tree *, tree *);
864extern tree c_build_bind_expr (tree, tree);
865
866/* In c-pch.c  */
867extern void pch_init (void);
868extern int c_common_valid_pch (cpp_reader *pfile, const char *name, int fd);
869extern void c_common_read_pch (cpp_reader *pfile, const char *name, int fd,
870			       const char *orig);
871extern void c_common_write_pch (void);
872extern void c_common_no_more_pch (void);
873extern void c_common_pch_pragma (cpp_reader *pfile, const char *);
874extern void c_common_print_pch_checksum (FILE *f);
875
876/* In *-checksum.c */
877extern const unsigned char executable_checksum[16];
878
879extern void builtin_define_with_value (const char *, const char *, int);
880extern void c_stddef_cpp_builtins (void);
881extern void fe_file_change (const struct line_map *);
882extern void c_parse_error (const char *, enum cpp_ttype, tree);
883
884/* Objective-C / Objective-C++ entry points.  */
885
886/* The following ObjC/ObjC++ functions are called by the C and/or C++
887   front-ends; they all must have corresponding stubs in stub-objc.c.  */
888extern tree objc_is_class_name (tree);
889extern tree objc_is_object_ptr (tree);
890extern void objc_check_decl (tree);
891extern int objc_is_reserved_word (tree);
892extern bool objc_compare_types (tree, tree, int, tree);
893extern void objc_volatilize_decl (tree);
894extern bool objc_type_quals_match (tree, tree);
895extern tree objc_rewrite_function_call (tree, tree);
896extern tree objc_message_selector (void);
897extern tree objc_lookup_ivar (tree, tree);
898extern void objc_clear_super_receiver (void);
899extern int objc_is_public (tree, tree);
900extern tree objc_is_id (tree);
901extern void objc_declare_alias (tree, tree);
902extern void objc_declare_class (tree);
903extern void objc_declare_protocols (tree);
904extern tree objc_build_message_expr (tree);
905extern tree objc_finish_message_expr (tree, tree, tree);
906extern tree objc_build_selector_expr (tree);
907extern tree objc_build_protocol_expr (tree);
908extern tree objc_build_encode_expr (tree);
909extern tree objc_build_string_object (tree);
910extern tree objc_get_protocol_qualified_type (tree, tree);
911extern tree objc_get_class_reference (tree);
912extern tree objc_get_class_ivars (tree);
913extern void objc_start_class_interface (tree, tree, tree);
914extern void objc_start_category_interface (tree, tree, tree);
915extern void objc_start_protocol (tree, tree);
916extern void objc_continue_interface (void);
917extern void objc_finish_interface (void);
918extern void objc_start_class_implementation (tree, tree);
919extern void objc_start_category_implementation (tree, tree);
920extern void objc_continue_implementation (void);
921extern void objc_finish_implementation (void);
922extern void objc_set_visibility (int);
923extern void objc_set_method_type (enum tree_code);
924extern tree objc_build_method_signature (tree, tree, tree, bool);
925extern void objc_add_method_declaration (tree);
926extern void objc_start_method_definition (tree);
927extern void objc_finish_method_definition (tree);
928extern void objc_add_instance_variable (tree);
929extern tree objc_build_keyword_decl (tree, tree, tree);
930extern tree objc_build_throw_stmt (tree);
931extern void objc_begin_try_stmt (location_t, tree);
932extern tree objc_finish_try_stmt (void);
933extern void objc_begin_catch_clause (tree);
934extern void objc_finish_catch_clause (void);
935extern void objc_build_finally_clause (location_t, tree);
936extern tree objc_build_synchronized (location_t, tree, tree);
937extern int objc_static_init_needed_p (void);
938extern tree objc_generate_static_init_call (tree);
939extern tree objc_generate_write_barrier (tree, enum tree_code, tree);
940
941/* The following are provided by the C and C++ front-ends, and called by
942   ObjC/ObjC++.  */
943extern void *objc_get_current_scope (void);
944extern void objc_mark_locals_volatile (void *);
945
946/* In c-ppoutput.c  */
947extern void init_pp_output (FILE *);
948extern void preprocess_file (cpp_reader *);
949extern void pp_file_change (const struct line_map *);
950extern void pp_dir_change (cpp_reader *, const char *);
951extern bool check_missing_format_attribute (tree, tree);
952
953/* In c-omp.c  */
954extern tree c_finish_omp_master (tree);
955extern tree c_finish_omp_critical (tree, tree);
956extern tree c_finish_omp_ordered (tree);
957extern void c_finish_omp_barrier (void);
958extern tree c_finish_omp_atomic (enum tree_code, tree, tree);
959extern void c_finish_omp_flush (void);
960extern tree c_finish_omp_for (location_t, tree, tree, tree, tree, tree, tree);
961extern void c_split_parallel_clauses (tree, tree *, tree *);
962extern enum omp_clause_default_kind c_omp_predetermined_sharing (tree);
963
964/* Not in c-omp.c; provided by the front end.  */
965extern bool c_omp_sharing_predetermined (tree);
966extern tree c_omp_remap_decl (tree, bool);
967
968/* In order for the format checking to accept the C frontend
969   diagnostic framework extensions, you must include this file before
970   toplev.h, not after.  The C front end formats are a subset of those
971   for C++, so they are the appropriate set to use in common code;
972   cp-tree.h overrides this for C++.  */
973#ifndef GCC_DIAG_STYLE
974#define GCC_DIAG_STYLE __gcc_cdiag__
975#endif
976
977#endif /* ! GCC_C_COMMON_H */
978