OSDN Git Service

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