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