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