OSDN Git Service

In gcc/:
[pf3gnuchains/gcc-fork.git] / gcc / c-family / 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, 2007, 2008, 2009, 2010
4    Free Software Foundation, Inc.
5
6 This file is part of GCC.
7
8 GCC is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 3, or (at your option) any later
11 version.
12
13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
16 for more details.
17
18 You should have received a copy of the GNU General Public License
19 along with GCC; see the file COPYING3.  If not see
20 <http://www.gnu.org/licenses/>.  */
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 /* In order for the format checking to accept the C frontend
30    diagnostic framework extensions, you must include this file before
31    diagnostic-core.h, not after.  The C front end formats are a subset of those
32    for C++, so they are the appropriate set to use in common code;
33    cp-tree.h overrides this for C++.  */
34 #if defined(GCC_DIAGNOSTIC_CORE_H)
35 #error \
36 In order for the format checking to accept the C front end diagnostic \
37 framework extensions, you must include this file before diagnostic-core.h \
38 never after.
39 #endif
40 #ifndef GCC_DIAG_STYLE
41 #define GCC_DIAG_STYLE __gcc_cdiag__
42 #endif
43 #include "diagnostic-core.h"
44
45 /* Usage of TREE_LANG_FLAG_?:
46    0: TREE_NEGATED_INT (in INTEGER_CST).
47       IDENTIFIER_MARKED (used by search routines).
48       DECL_PRETTY_FUNCTION_P (in VAR_DECL)
49       C_MAYBE_CONST_EXPR_INT_OPERANDS (in C_MAYBE_CONST_EXPR, for C)
50    1: C_DECLARED_LABEL_FLAG (in LABEL_DECL)
51       STATEMENT_LIST_STMT_EXPR (in STATEMENT_LIST)
52       C_MAYBE_CONST_EXPR_NON_CONST (in C_MAYBE_CONST_EXPR, for C)
53    2: unused
54    3: STATEMENT_LIST_HAS_LABEL (in STATEMENT_LIST)
55    4: unused
56 */
57
58 /* Reserved identifiers.  This is the union of all the keywords for C,
59    C++, and Objective-C.  All the type modifiers have to be in one
60    block at the beginning, because they are used as mask bits.  There
61    are 27 type modifiers; if we add many more we will have to redesign
62    the mask mechanism.  */
63
64 enum rid
65 {
66   /* Modifiers: */
67   /* C, in empirical order of frequency.  */
68   RID_STATIC = 0,
69   RID_UNSIGNED, RID_LONG,    RID_CONST, RID_EXTERN,
70   RID_REGISTER, RID_TYPEDEF, RID_SHORT, RID_INLINE,
71   RID_VOLATILE, RID_SIGNED,  RID_AUTO,  RID_RESTRICT,
72
73   /* C extensions */
74   RID_COMPLEX, RID_THREAD, RID_SAT,
75
76   /* C++ */
77   RID_FRIEND, RID_VIRTUAL, RID_EXPLICIT, RID_EXPORT, RID_MUTABLE,
78
79   /* ObjC ("PQ" reserved words - they do not appear after a '@' and
80      are keywords only in specific contexts)  */
81   RID_IN, RID_OUT, RID_INOUT, RID_BYCOPY, RID_BYREF, RID_ONEWAY,
82
83   /* C (reserved and imaginary types not implemented, so any use is a
84      syntax error) */
85   RID_IMAGINARY,
86
87   /* C */
88   RID_INT,     RID_CHAR,   RID_FLOAT,    RID_DOUBLE, RID_VOID,
89   RID_INT128,
90   RID_ENUM,    RID_STRUCT, RID_UNION,    RID_IF,     RID_ELSE,
91   RID_WHILE,   RID_DO,     RID_FOR,      RID_SWITCH, RID_CASE,
92   RID_DEFAULT, RID_BREAK,  RID_CONTINUE, RID_RETURN, RID_GOTO,
93   RID_SIZEOF,
94
95   /* C extensions */
96   RID_ASM,       RID_TYPEOF,   RID_ALIGNOF,  RID_ATTRIBUTE,  RID_VA_ARG,
97   RID_EXTENSION, RID_IMAGPART, RID_REALPART, RID_LABEL,      RID_CHOOSE_EXPR,
98   RID_TYPES_COMPATIBLE_P,
99   RID_DFLOAT32, RID_DFLOAT64, RID_DFLOAT128,
100   RID_FRACT, RID_ACCUM,
101
102   /* This means to warn that this is a C++ keyword, and then treat it
103      as a normal identifier.  */
104   RID_CXX_COMPAT_WARN,
105
106   /* Too many ways of getting the name of a function as a string */
107   RID_FUNCTION_NAME, RID_PRETTY_FUNCTION_NAME, RID_C99_FUNCTION_NAME,
108
109   /* C++ (some of these are keywords in Objective-C as well, but only
110      if they appear after a '@') */
111   RID_BOOL,     RID_WCHAR,    RID_CLASS,
112   RID_PUBLIC,   RID_PRIVATE,  RID_PROTECTED,
113   RID_TEMPLATE, RID_NULL,     RID_CATCH,
114   RID_DELETE,   RID_FALSE,    RID_NAMESPACE,
115   RID_NEW,      RID_OFFSETOF, RID_OPERATOR,
116   RID_THIS,     RID_THROW,    RID_TRUE,
117   RID_TRY,      RID_TYPENAME, RID_TYPEID,
118   RID_USING,    RID_CHAR16,   RID_CHAR32,
119
120   /* casts */
121   RID_CONSTCAST, RID_DYNCAST, RID_REINTCAST, RID_STATCAST,
122
123   /* C++ extensions */
124   RID_HAS_NOTHROW_ASSIGN,      RID_HAS_NOTHROW_CONSTRUCTOR,
125   RID_HAS_NOTHROW_COPY,        RID_HAS_TRIVIAL_ASSIGN,
126   RID_HAS_TRIVIAL_CONSTRUCTOR, RID_HAS_TRIVIAL_COPY,
127   RID_HAS_TRIVIAL_DESTRUCTOR,  RID_HAS_VIRTUAL_DESTRUCTOR,
128   RID_IS_ABSTRACT,             RID_IS_BASE_OF,
129   RID_IS_CONVERTIBLE_TO,       RID_IS_CLASS,
130   RID_IS_EMPTY,                RID_IS_ENUM,
131   RID_IS_POD,                  RID_IS_POLYMORPHIC,
132   RID_IS_STD_LAYOUT,           RID_IS_TRIVIAL,
133   RID_IS_UNION,
134
135   /* C++0x */
136   RID_CONSTEXPR, RID_DECLTYPE, RID_NOEXCEPT, RID_NULLPTR, RID_STATIC_ASSERT,
137
138   /* Objective-C ("AT" reserved words - they are only keywords when
139      they follow '@')  */
140   RID_AT_ENCODE,   RID_AT_END,
141   RID_AT_CLASS,    RID_AT_ALIAS,     RID_AT_DEFS,
142   RID_AT_PRIVATE,  RID_AT_PROTECTED, RID_AT_PUBLIC,
143   RID_AT_PROTOCOL, RID_AT_SELECTOR,
144   RID_AT_THROW,    RID_AT_TRY,       RID_AT_CATCH,
145   RID_AT_FINALLY,  RID_AT_SYNCHRONIZED,
146   RID_AT_INTERFACE,
147   RID_AT_IMPLEMENTATION,
148
149   /* Named address support, mapping the keyword to a particular named address
150      number.  Named address space 0 is reserved for the generic address.  If
151      there are more than 254 named addresses, the addr_space_t type will need
152      to be grown from an unsigned char to unsigned short.  */
153   RID_ADDR_SPACE_0,             /* generic address */
154   RID_ADDR_SPACE_1,
155   RID_ADDR_SPACE_2,
156   RID_ADDR_SPACE_3,
157   RID_ADDR_SPACE_4,
158   RID_ADDR_SPACE_5,
159   RID_ADDR_SPACE_6,
160   RID_ADDR_SPACE_7,
161   RID_ADDR_SPACE_8,
162   RID_ADDR_SPACE_9,
163   RID_ADDR_SPACE_10,
164   RID_ADDR_SPACE_11,
165   RID_ADDR_SPACE_12,
166   RID_ADDR_SPACE_13,
167   RID_ADDR_SPACE_14,
168   RID_ADDR_SPACE_15,
169
170   RID_FIRST_ADDR_SPACE = RID_ADDR_SPACE_0,
171   RID_LAST_ADDR_SPACE = RID_ADDR_SPACE_15,
172
173   RID_MAX,
174
175   RID_FIRST_MODIFIER = RID_STATIC,
176   RID_LAST_MODIFIER = RID_ONEWAY,
177
178   RID_FIRST_CXX0X = RID_CONSTEXPR,
179   RID_LAST_CXX0X = RID_STATIC_ASSERT,
180   RID_FIRST_AT = RID_AT_ENCODE,
181   RID_LAST_AT = RID_AT_IMPLEMENTATION,
182   RID_FIRST_PQ = RID_IN,
183   RID_LAST_PQ = RID_ONEWAY
184 };
185
186 #define OBJC_IS_AT_KEYWORD(rid) \
187   ((unsigned int) (rid) >= (unsigned int) RID_FIRST_AT && \
188    (unsigned int) (rid) <= (unsigned int) RID_LAST_AT)
189
190 #define OBJC_IS_PQ_KEYWORD(rid) \
191   ((unsigned int) (rid) >= (unsigned int) RID_FIRST_PQ && \
192    (unsigned int) (rid) <= (unsigned int) RID_LAST_PQ)
193
194 /* OBJC_IS_CXX_KEYWORD recognizes the 'CXX_OBJC' keywords (such as
195    'class') which are shared in a subtle way between Objective-C and
196    C++.  When the lexer is lexing in Objective-C/Objective-C++, if it
197    finds '@' followed by one of these identifiers (eg, '@class'), it
198    recognizes the whole as an Objective-C keyword.  If the identifier
199    is found elsewhere, it follows the rules of the C/C++ language.
200  */
201 #define OBJC_IS_CXX_KEYWORD(rid) \
202   (rid == RID_CLASS                                                     \
203    || rid == RID_PUBLIC || rid == RID_PROTECTED || rid == RID_PRIVATE   \
204    || rid == RID_TRY || rid == RID_THROW || rid == RID_CATCH)
205
206 /* The elements of `ridpointers' are identifier nodes for the reserved
207    type names and storage classes.  It is indexed by a RID_... value.  */
208 extern GTY ((length ("(int) RID_MAX"))) tree *ridpointers;
209
210 /* Standard named or nameless data types of the C compiler.  */
211
212 enum c_tree_index
213 {
214     CTI_CHAR16_TYPE,
215     CTI_CHAR32_TYPE,
216     CTI_WCHAR_TYPE,
217     CTI_UNDERLYING_WCHAR_TYPE,
218     CTI_WINT_TYPE,
219     CTI_SIGNED_SIZE_TYPE, /* For format checking only.  */
220     CTI_UNSIGNED_PTRDIFF_TYPE, /* For format checking only.  */
221     CTI_INTMAX_TYPE,
222     CTI_UINTMAX_TYPE,
223     CTI_WIDEST_INT_LIT_TYPE,
224     CTI_WIDEST_UINT_LIT_TYPE,
225
226     /* Types for <stdint.h>, that may not be defined on all
227        targets.  */
228     CTI_SIG_ATOMIC_TYPE,
229     CTI_INT8_TYPE,
230     CTI_INT16_TYPE,
231     CTI_INT32_TYPE,
232     CTI_INT64_TYPE,
233     CTI_UINT8_TYPE,
234     CTI_UINT16_TYPE,
235     CTI_UINT32_TYPE,
236     CTI_UINT64_TYPE,
237     CTI_INT_LEAST8_TYPE,
238     CTI_INT_LEAST16_TYPE,
239     CTI_INT_LEAST32_TYPE,
240     CTI_INT_LEAST64_TYPE,
241     CTI_UINT_LEAST8_TYPE,
242     CTI_UINT_LEAST16_TYPE,
243     CTI_UINT_LEAST32_TYPE,
244     CTI_UINT_LEAST64_TYPE,
245     CTI_INT_FAST8_TYPE,
246     CTI_INT_FAST16_TYPE,
247     CTI_INT_FAST32_TYPE,
248     CTI_INT_FAST64_TYPE,
249     CTI_UINT_FAST8_TYPE,
250     CTI_UINT_FAST16_TYPE,
251     CTI_UINT_FAST32_TYPE,
252     CTI_UINT_FAST64_TYPE,
253     CTI_INTPTR_TYPE,
254     CTI_UINTPTR_TYPE,
255
256     CTI_CHAR_ARRAY_TYPE,
257     CTI_CHAR16_ARRAY_TYPE,
258     CTI_CHAR32_ARRAY_TYPE,
259     CTI_WCHAR_ARRAY_TYPE,
260     CTI_INT_ARRAY_TYPE,
261     CTI_STRING_TYPE,
262     CTI_CONST_STRING_TYPE,
263
264     /* Type for boolean expressions (bool in C++, int in C).  */
265     CTI_TRUTHVALUE_TYPE,
266     CTI_TRUTHVALUE_TRUE,
267     CTI_TRUTHVALUE_FALSE,
268
269     CTI_DEFAULT_FUNCTION_TYPE,
270
271     /* These are not types, but we have to look them up all the time.  */
272     CTI_FUNCTION_NAME_DECL,
273     CTI_PRETTY_FUNCTION_NAME_DECL,
274     CTI_C99_FUNCTION_NAME_DECL,
275     CTI_SAVED_FUNCTION_NAME_DECLS,
276
277     CTI_VOID_ZERO,
278
279     CTI_NULL,
280
281     CTI_MAX
282 };
283
284 #define C_CPP_HASHNODE(id) \
285   (&(((struct c_common_identifier *) (id))->node))
286 #define C_RID_CODE(id) \
287   ((enum rid) (((struct c_common_identifier *) (id))->node.rid_code))
288 #define C_SET_RID_CODE(id, code) \
289   (((struct c_common_identifier *) (id))->node.rid_code = (unsigned char) code)
290
291 /* Identifier part common to the C front ends.  Inherits from
292    tree_identifier, despite appearances.  */
293 struct GTY(()) c_common_identifier {
294   struct tree_common common;
295   struct cpp_hashnode node;
296 };
297
298 /* An entry in the reserved keyword table.  */
299
300 struct c_common_resword
301 {
302   const char *const word;
303   ENUM_BITFIELD(rid) const rid : 16;
304   const unsigned int disable   : 16;
305 };
306
307 /* Disable mask.  Keywords are disabled if (reswords[i].disable &
308    mask) is _true_.  Thus for keywords which are present in all
309    languages the disable field is zero.  */
310
311 #define D_CONLY         0x001   /* C only (not in C++).  */
312 #define D_CXXONLY       0x002   /* C++ only (not in C).  */
313 #define D_C99           0x004   /* In C, C99 only.  */
314 #define D_CXX0X         0x008   /* In C++, C++0X only.  */
315 #define D_EXT           0x010   /* GCC extension.  */
316 #define D_EXT89         0x020   /* GCC extension incorporated in C99.  */
317 #define D_ASM           0x040   /* Disabled by -fno-asm.  */
318 #define D_OBJC          0x080   /* In Objective C and neither C nor C++.  */
319 #define D_CXX_OBJC      0x100   /* In Objective C, and C++, but not C.  */
320 #define D_CXXWARN       0x200   /* In C warn with -Wcxx-compat.  */
321
322 /* The reserved keyword table.  */
323 extern const struct c_common_resword c_common_reswords[];
324
325 /* The number of items in the reserved keyword table.  */
326 extern const unsigned int num_c_common_reswords;
327
328 #define char16_type_node                c_global_trees[CTI_CHAR16_TYPE]
329 #define char32_type_node                c_global_trees[CTI_CHAR32_TYPE]
330 #define wchar_type_node                 c_global_trees[CTI_WCHAR_TYPE]
331 #define underlying_wchar_type_node      c_global_trees[CTI_UNDERLYING_WCHAR_TYPE]
332 #define wint_type_node                  c_global_trees[CTI_WINT_TYPE]
333 #define signed_size_type_node           c_global_trees[CTI_SIGNED_SIZE_TYPE]
334 #define unsigned_ptrdiff_type_node      c_global_trees[CTI_UNSIGNED_PTRDIFF_TYPE]
335 #define intmax_type_node                c_global_trees[CTI_INTMAX_TYPE]
336 #define uintmax_type_node               c_global_trees[CTI_UINTMAX_TYPE]
337 #define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
338 #define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
339
340 #define sig_atomic_type_node            c_global_trees[CTI_SIG_ATOMIC_TYPE]
341 #define int8_type_node                  c_global_trees[CTI_INT8_TYPE]
342 #define int16_type_node                 c_global_trees[CTI_INT16_TYPE]
343 #define int32_type_node                 c_global_trees[CTI_INT32_TYPE]
344 #define int64_type_node                 c_global_trees[CTI_INT64_TYPE]
345 #define uint8_type_node                 c_global_trees[CTI_UINT8_TYPE]
346 #define uint16_type_node                c_global_trees[CTI_UINT16_TYPE]
347 #define c_uint32_type_node              c_global_trees[CTI_UINT32_TYPE]
348 #define c_uint64_type_node              c_global_trees[CTI_UINT64_TYPE]
349 #define int_least8_type_node            c_global_trees[CTI_INT_LEAST8_TYPE]
350 #define int_least16_type_node           c_global_trees[CTI_INT_LEAST16_TYPE]
351 #define int_least32_type_node           c_global_trees[CTI_INT_LEAST32_TYPE]
352 #define int_least64_type_node           c_global_trees[CTI_INT_LEAST64_TYPE]
353 #define uint_least8_type_node           c_global_trees[CTI_UINT_LEAST8_TYPE]
354 #define uint_least16_type_node          c_global_trees[CTI_UINT_LEAST16_TYPE]
355 #define uint_least32_type_node          c_global_trees[CTI_UINT_LEAST32_TYPE]
356 #define uint_least64_type_node          c_global_trees[CTI_UINT_LEAST64_TYPE]
357 #define int_fast8_type_node             c_global_trees[CTI_INT_FAST8_TYPE]
358 #define int_fast16_type_node            c_global_trees[CTI_INT_FAST16_TYPE]
359 #define int_fast32_type_node            c_global_trees[CTI_INT_FAST32_TYPE]
360 #define int_fast64_type_node            c_global_trees[CTI_INT_FAST64_TYPE]
361 #define uint_fast8_type_node            c_global_trees[CTI_UINT_FAST8_TYPE]
362 #define uint_fast16_type_node           c_global_trees[CTI_UINT_FAST16_TYPE]
363 #define uint_fast32_type_node           c_global_trees[CTI_UINT_FAST32_TYPE]
364 #define uint_fast64_type_node           c_global_trees[CTI_UINT_FAST64_TYPE]
365 #define intptr_type_node                c_global_trees[CTI_INTPTR_TYPE]
366 #define uintptr_type_node               c_global_trees[CTI_UINTPTR_TYPE]
367
368 #define truthvalue_type_node            c_global_trees[CTI_TRUTHVALUE_TYPE]
369 #define truthvalue_true_node            c_global_trees[CTI_TRUTHVALUE_TRUE]
370 #define truthvalue_false_node           c_global_trees[CTI_TRUTHVALUE_FALSE]
371
372 #define char_array_type_node            c_global_trees[CTI_CHAR_ARRAY_TYPE]
373 #define char16_array_type_node          c_global_trees[CTI_CHAR16_ARRAY_TYPE]
374 #define char32_array_type_node          c_global_trees[CTI_CHAR32_ARRAY_TYPE]
375 #define wchar_array_type_node           c_global_trees[CTI_WCHAR_ARRAY_TYPE]
376 #define int_array_type_node             c_global_trees[CTI_INT_ARRAY_TYPE]
377 #define string_type_node                c_global_trees[CTI_STRING_TYPE]
378 #define const_string_type_node          c_global_trees[CTI_CONST_STRING_TYPE]
379
380 #define default_function_type           c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
381
382 #define function_name_decl_node         c_global_trees[CTI_FUNCTION_NAME_DECL]
383 #define pretty_function_name_decl_node  c_global_trees[CTI_PRETTY_FUNCTION_NAME_DECL]
384 #define c99_function_name_decl_node             c_global_trees[CTI_C99_FUNCTION_NAME_DECL]
385 #define saved_function_name_decls       c_global_trees[CTI_SAVED_FUNCTION_NAME_DECLS]
386
387 /* A node for `((void) 0)'.  */
388 #define void_zero_node                  c_global_trees[CTI_VOID_ZERO]
389
390 /* The node for C++ `__null'.  */
391 #define null_node                       c_global_trees[CTI_NULL]
392
393 extern GTY(()) tree c_global_trees[CTI_MAX];
394
395 /* In a RECORD_TYPE, a sorted array of the fields of the type, not a
396    tree for size reasons.  */
397 struct GTY((variable_size)) sorted_fields_type {
398   int len;
399   tree GTY((length ("%h.len"))) elts[1];
400 };
401
402 /* Mark which labels are explicitly declared.
403    These may be shadowed, and may be referenced from nested functions.  */
404 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
405
406 typedef enum c_language_kind
407 {
408   clk_c         = 0,            /* C90, C94 or C99 */
409   clk_objc      = 1,            /* clk_c with ObjC features.  */
410   clk_cxx       = 2,            /* ANSI/ISO C++ */
411   clk_objcxx    = 3             /* clk_cxx with ObjC features.  */
412 }
413 c_language_kind;
414
415 /* To test for a specific language use c_language, defined by each
416    front end.  For "ObjC features" or "not C++" use the macros.  */
417 extern c_language_kind c_language;
418
419 #define c_dialect_cxx()         ((c_language & clk_cxx) != 0)
420 #define c_dialect_objc()        ((c_language & clk_objc) != 0)
421
422 /* The various name of operator that appears in error messages. */
423 typedef enum ref_operator {
424   /* NULL */
425   RO_NULL,
426   /* array indexing */
427   RO_ARRAY_INDEXING,
428   /* unary * */
429   RO_UNARY_STAR,
430   /* -> */
431   RO_ARROW,
432   /* implicit conversion */
433   RO_IMPLICIT_CONVERSION
434 } ref_operator;
435
436 /* Information about a statement tree.  */
437
438 struct GTY(()) stmt_tree_s {
439   /* The current statement list being collected.  */
440   tree x_cur_stmt_list;
441
442   /* In C++, Nonzero if we should treat statements as full
443      expressions.  In particular, this variable is no-zero if at the
444      end of a statement we should destroy any temporaries created
445      during that statement.  Similarly, if, at the end of a block, we
446      should destroy any local variables in this block.  Normally, this
447      variable is nonzero, since those are the normal semantics of
448      C++.
449
450      However, in order to represent aggregate initialization code as
451      tree structure, we use statement-expressions.  The statements
452      within the statement expression should not result in cleanups
453      being run until the entire enclosing statement is complete.
454
455      This flag has no effect in C.  */
456   int stmts_are_full_exprs_p;
457 };
458
459 typedef struct stmt_tree_s *stmt_tree;
460
461 /* Global state pertinent to the current function.  Some C dialects
462    extend this structure with additional fields.  */
463
464 struct GTY(()) c_language_function {
465   /* While we are parsing the function, this contains information
466      about the statement-tree that we are building.  */
467   struct stmt_tree_s x_stmt_tree;
468 };
469
470 /* When building a statement-tree, this is the current statement list
471    being collected.  It's TREE_CHAIN is a back-pointer to the previous
472    statement list.  */
473
474 #define cur_stmt_list (current_stmt_tree ()->x_cur_stmt_list)
475
476 /* Language-specific hooks.  */
477
478 /* If non-NULL, this function is called after a precompile header file
479    is loaded.  */
480 extern void (*lang_post_pch_load) (void);
481
482 extern void push_file_scope (void);
483 extern void pop_file_scope (void);
484 extern stmt_tree current_stmt_tree (void);
485 extern tree push_stmt_list (void);
486 extern tree pop_stmt_list (tree);
487 extern tree add_stmt (tree);
488 extern void push_cleanup (tree, tree, bool);
489 extern tree pushdecl_top_level (tree);
490 extern tree pushdecl (tree);
491 extern tree build_modify_expr (location_t, tree, tree, enum tree_code,
492                                location_t, tree, tree);
493 extern tree build_indirect_ref (location_t, tree, ref_operator);
494
495 extern int c_expand_decl (tree);
496
497 extern int field_decl_cmp (const void *, const void *);
498 extern void resort_sorted_fields (void *, void *, gt_pointer_operator,
499                                   void *);
500 extern bool has_c_linkage (const_tree decl);
501 \f
502 /* Switches common to the C front ends.  */
503
504 /* Nonzero means don't output line number information.  */
505
506 extern char flag_no_line_commands;
507
508 /* Nonzero causes -E output not to be done, but directives such as
509    #define that have side effects are still obeyed.  */
510
511 extern char flag_no_output;
512
513 /* Nonzero means dump macros in some fashion; contains the 'D', 'M',
514    'N' or 'U' of the command line switch.  */
515
516 extern char flag_dump_macros;
517
518 /* Nonzero means pass #include lines through to the output.  */
519
520 extern char flag_dump_includes;
521
522 /* Nonzero means process PCH files while preprocessing.  */
523
524 extern bool flag_pch_preprocess;
525
526 /* The file name to which we should write a precompiled header, or
527    NULL if no header will be written in this compile.  */
528
529 extern const char *pch_file;
530
531 /* Nonzero if an ISO standard was selected.  It rejects macros in the
532    user's namespace.  */
533
534 extern int flag_iso;
535
536 /* Warn about #pragma directives that are not recognized.  */
537
538 extern int warn_unknown_pragmas; /* Tri state variable.  */
539
540 /* Warn about format/argument anomalies in calls to formatted I/O functions
541    (*printf, *scanf, strftime, strfmon, etc.).  */
542
543 extern int warn_format;
544
545
546 /* C/ObjC language option variables.  */
547
548
549 /* Nonzero means allow type mismatches in conditional expressions;
550    just make their values `void'.  */
551
552 extern int flag_cond_mismatch;
553
554 /* Nonzero means enable C89 Amendment 1 features.  */
555
556 extern int flag_isoc94;
557
558 /* Nonzero means use the ISO C99 (or C1X) dialect of C.  */
559
560 extern int flag_isoc99;
561
562 /* Nonzero means use the ISO C1X dialect of C.  */
563
564 extern int flag_isoc1x;
565
566 /* Nonzero means that we have builtin functions, and main is an int.  */
567
568 extern int flag_hosted;
569
570 /* ObjC language option variables.  */
571
572
573 /* Tells the compiler that this is a special run.  Do not perform any
574    compiling, instead we are to test some platform dependent features
575    and output a C header file with appropriate definitions.  */
576
577 extern int print_struct_values;
578
579 /* Tells the compiler what is the constant string class for ObjC.  */
580
581 extern const char *constant_string_class_name;
582
583
584 /* C++ language option variables.  */
585
586
587 /* Nonzero means generate separate instantiation control files and
588    juggle them at link time.  */
589
590 extern int flag_use_repository;
591
592 /* The supported C++ dialects.  */
593
594 enum cxx_dialect {
595   /* C++98  */
596   cxx98,
597   /* Experimental features that are likely to become part of
598      C++0x.  */
599   cxx0x
600 };
601
602 /* The C++ dialect being used. C++98 is the default.  */
603 extern enum cxx_dialect cxx_dialect;
604
605 /* Maximum template instantiation depth.  This limit is rather
606    arbitrary, but it exists to limit the time it takes to notice
607    infinite template instantiations.  */
608
609 extern int max_tinst_depth;
610
611 /* Nonzero means that we should not issue warnings about problems that
612    occur when the code is executed, because the code being processed
613    is not expected to be executed.  This is set during parsing.  This
614    is used for cases like sizeof() and "0 ? a : b".  This is a count,
615    not a bool, because unexecuted expressions can nest.  */
616
617 extern int c_inhibit_evaluation_warnings;
618
619 /* Whether lexing has been completed, so subsequent preprocessor
620    errors should use the compiler's input_location.  */
621
622 extern bool done_lexing;
623
624 /* C types are partitioned into three subsets: object, function, and
625    incomplete types.  */
626 #define C_TYPE_OBJECT_P(type) \
627   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
628
629 #define C_TYPE_INCOMPLETE_P(type) \
630   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
631
632 #define C_TYPE_FUNCTION_P(type) \
633   (TREE_CODE (type) == FUNCTION_TYPE)
634
635 /* For convenience we define a single macro to identify the class of
636    object or incomplete types.  */
637 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
638   (!C_TYPE_FUNCTION_P (type))
639
640 /* Attribute table common to the C front ends.  */
641 extern const struct attribute_spec c_common_attribute_table[];
642 extern const struct attribute_spec c_common_format_attribute_table[];
643
644 /* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
645    ID is the identifier to use, NAME is the string.
646    TYPE_DEP indicates whether it depends on type of the function or not
647    (i.e. __PRETTY_FUNCTION__).  */
648
649 extern tree (*make_fname_decl) (location_t, tree, int);
650
651 /* In c-decl.c and cp/tree.c.  FIXME.  */
652 extern void c_register_addr_space (const char *str, addr_space_t as);
653
654 /* In c-common.c.  */
655 extern const char *c_addr_space_name (addr_space_t as);
656 extern tree identifier_global_value (tree);
657 extern void record_builtin_type (enum rid, const char *, tree);
658 extern tree build_void_list_node (void);
659 extern void start_fname_decls (void);
660 extern void finish_fname_decls (void);
661 extern const char *fname_as_string (int);
662 extern tree fname_decl (location_t, unsigned, tree);
663
664 extern void check_function_arguments (tree, int, tree *, tree);
665 extern void check_function_arguments_recurse (void (*)
666                                               (void *, tree,
667                                                unsigned HOST_WIDE_INT),
668                                               void *, tree,
669                                               unsigned HOST_WIDE_INT);
670 extern bool check_builtin_function_arguments (tree, int, tree *);
671 extern void check_function_format (tree, int, tree *);
672 extern void set_Wformat (int);
673 extern tree handle_format_attribute (tree *, tree, tree, int, bool *);
674 extern tree handle_format_arg_attribute (tree *, tree, tree, int, bool *);
675 extern bool attribute_takes_identifier_p (const_tree);
676 extern bool c_common_handle_option (size_t, const char *, int, int,
677                                     const struct cl_option_handlers *);
678 extern tree c_common_type_for_mode (enum machine_mode, int);
679 extern tree c_common_type_for_size (unsigned int, int);
680 extern tree c_common_fixed_point_type_for_size (unsigned int, unsigned int,
681                                                 int, int);
682 extern tree c_common_unsigned_type (tree);
683 extern tree c_common_signed_type (tree);
684 extern tree c_common_signed_or_unsigned_type (int, tree);
685 extern tree c_build_bitfield_integer_type (unsigned HOST_WIDE_INT, int);
686 extern bool decl_with_nonnull_addr_p (const_tree);
687 extern tree c_fully_fold (tree, bool, bool *);
688 extern tree decl_constant_value_for_optimization (tree);
689 extern tree c_wrap_maybe_const (tree, bool);
690 extern tree c_save_expr (tree);
691 extern tree c_common_truthvalue_conversion (location_t, tree);
692 extern void c_apply_type_quals_to_decl (int, tree);
693 extern tree c_sizeof_or_alignof_type (location_t, tree, bool, int);
694 extern tree c_alignof_expr (location_t, tree);
695 /* Print an error message for invalid operands to arith operation CODE.
696    NOP_EXPR is used as a special case (see truthvalue_conversion).  */
697 extern void binary_op_error (location_t, enum tree_code, tree, tree);
698 extern tree fix_string_type (tree);
699 extern void constant_expression_warning (tree);
700 extern void constant_expression_error (tree);
701 extern bool strict_aliasing_warning (tree, tree, tree);
702 extern void warnings_for_convert_and_check (tree, tree, tree);
703 extern tree convert_and_check (tree, tree);
704 extern void overflow_warning (location_t, tree);
705 extern void warn_logical_operator (location_t, enum tree_code, tree,
706                                    enum tree_code, tree, enum tree_code, tree);
707 extern void check_main_parameter_types (tree decl);
708 extern bool c_determine_visibility (tree);
709 extern bool same_scalar_type_ignoring_signedness (tree, tree);
710 extern void mark_valid_location_for_stdc_pragma (bool);
711 extern bool valid_location_for_stdc_pragma_p (void);
712 extern void set_float_const_decimal64 (void);
713 extern void clear_float_const_decimal64 (void);
714 extern bool float_const_decimal64_p (void);
715
716 #define c_sizeof(LOC, T)  c_sizeof_or_alignof_type (LOC, T, true, 1)
717 #define c_alignof(LOC, T) c_sizeof_or_alignof_type (LOC, T, false, 1)
718
719 /* Subroutine of build_binary_op, used for certain operations.  */
720 extern tree shorten_binary_op (tree result_type, tree op0, tree op1, bool bitwise);
721
722 /* Subroutine of build_binary_op, used for comparison operations.
723    See if the operands have both been converted from subword integer types
724    and, if so, perhaps change them both back to their original type.  */
725 extern tree shorten_compare (tree *, tree *, tree *, enum tree_code *);
726
727 extern tree pointer_int_sum (location_t, enum tree_code, tree, tree);
728
729 /* Add qualifiers to a type, in the fashion for C.  */
730 extern tree c_build_qualified_type (tree, int);
731
732 /* Build tree nodes and builtin functions common to both C and C++ language
733    frontends.  */
734 extern void c_common_nodes_and_builtins (void);
735
736 extern void disable_builtin_function (const char *);
737
738 extern void set_compound_literal_name (tree decl);
739
740 extern tree build_va_arg (location_t, tree, tree);
741
742 struct diagnostic_context;
743
744 extern unsigned int c_common_option_lang_mask (void);
745 extern void c_common_initialize_diagnostics (struct diagnostic_context *);
746 extern bool c_common_complain_wrong_lang_p (const struct cl_option *);
747 extern void c_common_init_options (unsigned int, struct cl_decoded_option *);
748 extern bool c_common_post_options (const char **);
749 extern bool c_common_init (void);
750 extern void c_common_finish (void);
751 extern void c_common_parse_file (int);
752 extern alias_set_type c_common_get_alias_set (tree);
753 extern void c_register_builtin_type (tree, const char*);
754 extern bool c_promoting_integer_type_p (const_tree);
755 extern int self_promoting_args_p (const_tree);
756 extern tree strip_pointer_operator (tree);
757 extern tree strip_pointer_or_array_types (tree);
758 extern HOST_WIDE_INT c_common_to_target_charset (HOST_WIDE_INT);
759
760 /* This is the basic parsing function.  */
761 extern void c_parse_file (void);
762 /* This is misnamed, it actually performs end-of-compilation processing.  */
763 extern void finish_file (void);
764
765 extern void warn_for_omitted_condop (location_t, tree);
766
767 /* These macros provide convenient access to the various _STMT nodes.  */
768
769 /* Nonzero if a given STATEMENT_LIST represents the outermost binding
770    if a statement expression.  */
771 #define STATEMENT_LIST_STMT_EXPR(NODE) \
772   TREE_LANG_FLAG_1 (STATEMENT_LIST_CHECK (NODE))
773
774 /* Nonzero if a label has been added to the statement list.  */
775 #define STATEMENT_LIST_HAS_LABEL(NODE) \
776   TREE_LANG_FLAG_3 (STATEMENT_LIST_CHECK (NODE))
777
778 /* C_MAYBE_CONST_EXPR accessors.  */
779 #define C_MAYBE_CONST_EXPR_PRE(NODE)                    \
780   TREE_OPERAND (C_MAYBE_CONST_EXPR_CHECK (NODE), 0)
781 #define C_MAYBE_CONST_EXPR_EXPR(NODE)                   \
782   TREE_OPERAND (C_MAYBE_CONST_EXPR_CHECK (NODE), 1)
783 #define C_MAYBE_CONST_EXPR_INT_OPERANDS(NODE)           \
784   TREE_LANG_FLAG_0 (C_MAYBE_CONST_EXPR_CHECK (NODE))
785 #define C_MAYBE_CONST_EXPR_NON_CONST(NODE)              \
786   TREE_LANG_FLAG_1 (C_MAYBE_CONST_EXPR_CHECK (NODE))
787 #define EXPR_INT_CONST_OPERANDS(EXPR)                   \
788   (INTEGRAL_TYPE_P (TREE_TYPE (EXPR))                   \
789    && (TREE_CODE (EXPR) == INTEGER_CST                  \
790        || (TREE_CODE (EXPR) == C_MAYBE_CONST_EXPR       \
791            && C_MAYBE_CONST_EXPR_INT_OPERANDS (EXPR))))
792
793 /* In a FIELD_DECL, nonzero if the decl was originally a bitfield.  */
794 #define DECL_C_BIT_FIELD(NODE) \
795   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
796 #define SET_DECL_C_BIT_FIELD(NODE) \
797   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
798 #define CLEAR_DECL_C_BIT_FIELD(NODE) \
799   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
800
801 extern tree do_case (location_t, tree, tree);
802 extern tree build_stmt (location_t, enum tree_code, ...);
803 extern tree build_case_label (location_t, tree, tree, tree);
804
805 /* These functions must be defined by each front-end which implements
806    a variant of the C language.  They are used in c-common.c.  */
807
808 extern tree build_unary_op (location_t, enum tree_code, tree, int);
809 extern tree build_binary_op (location_t, enum tree_code, tree, tree, int);
810 extern tree perform_integral_promotions (tree);
811
812 /* These functions must be defined by each front-end which implements
813    a variant of the C language.  They are used by port files.  */
814
815 extern tree default_conversion (tree);
816
817 /* Given two integer or real types, return the type for their sum.
818    Given two compatible ANSI C types, returns the merged type.  */
819
820 extern tree common_type (tree, tree);
821
822 extern tree decl_constant_value (tree);
823
824 /* Handle increment and decrement of boolean types.  */
825 extern tree boolean_increment (enum tree_code, tree);
826
827 extern int case_compare (splay_tree_key, splay_tree_key);
828
829 extern tree c_add_case_label (location_t, splay_tree, tree, tree, tree, tree);
830
831 extern void c_do_switch_warnings (splay_tree, location_t, tree, tree);
832
833 extern tree build_function_call (location_t, tree, tree);
834
835 extern tree build_function_call_vec (location_t, tree,
836                                      VEC(tree,gc) *, VEC(tree,gc) *);
837
838 extern tree resolve_overloaded_builtin (location_t, tree, VEC(tree,gc) *);
839
840 extern tree finish_label_address_expr (tree, location_t);
841
842 /* Same function prototype, but the C and C++ front ends have
843    different implementations.  Used in c-common.c.  */
844 extern tree lookup_label (tree);
845 extern tree lookup_name (tree);
846 extern bool lvalue_p (const_tree);
847
848 extern bool vector_targets_convertible_p (const_tree t1, const_tree t2);
849 extern bool vector_types_convertible_p (const_tree t1, const_tree t2, bool emit_lax_note);
850
851 extern rtx c_expand_expr (tree, rtx, enum machine_mode, int, rtx *);
852
853 extern void init_c_lex (void);
854
855 extern void c_cpp_builtins (cpp_reader *);
856 extern void c_cpp_builtins_optimize_pragma (cpp_reader *, tree, tree);
857 extern bool c_cpp_error (cpp_reader *, int, int, location_t, unsigned int,
858                          const char *, va_list *)
859      ATTRIBUTE_GCC_DIAG(6,0);
860
861 /* Positive if an implicit `extern "C"' scope has just been entered;
862    negative if such a scope has just been exited.  */
863 extern GTY(()) int pending_lang_change;
864
865 /* Information recorded about each file examined during compilation.  */
866
867 struct c_fileinfo
868 {
869   int time;     /* Time spent in the file.  */
870
871   /* Flags used only by C++.
872      INTERFACE_ONLY nonzero means that we are in an "interface" section
873      of the compiler.  INTERFACE_UNKNOWN nonzero means we cannot trust
874      the value of INTERFACE_ONLY.  If INTERFACE_UNKNOWN is zero and
875      INTERFACE_ONLY is zero, it means that we are responsible for
876      exporting definitions that others might need.  */
877   short interface_only;
878   short interface_unknown;
879 };
880
881 struct c_fileinfo *get_fileinfo (const char *);
882 extern void dump_time_statistics (void);
883
884 extern bool c_dump_tree (void *, tree);
885
886 extern void verify_sequence_points (tree);
887
888 extern tree fold_offsetof (tree, tree);
889
890 /* Places where an lvalue, or modifiable lvalue, may be required.
891    Used to select diagnostic messages in lvalue_error and
892    readonly_error.  */
893 enum lvalue_use {
894   lv_assign,
895   lv_increment,
896   lv_decrement,
897   lv_addressof,
898   lv_asm
899 };
900
901 extern void lvalue_error (enum lvalue_use);
902
903 extern int complete_array_type (tree *, tree, bool);
904
905 extern tree builtin_type_for_size (int, bool);
906
907 extern void warn_array_subscript_with_type_char (tree);
908 extern void warn_about_parentheses (enum tree_code,
909                                     enum tree_code, tree,
910                                     enum tree_code, tree);
911 extern void warn_for_unused_label (tree label);
912 extern void warn_for_div_by_zero (location_t, tree divisor);
913 extern void warn_for_sign_compare (location_t,
914                                    tree orig_op0, tree orig_op1,
915                                    tree op0, tree op1,
916                                    tree result_type,
917                                    enum tree_code resultcode);
918 extern void do_warn_double_promotion (tree, tree, tree, const char *, 
919                                       location_t);
920 extern void set_underlying_type (tree x);
921 extern VEC(tree,gc) *make_tree_vector (void);
922 extern void release_tree_vector (VEC(tree,gc) *);
923 extern VEC(tree,gc) *make_tree_vector_single (tree);
924 extern VEC(tree,gc) *make_tree_vector_copy (const VEC(tree,gc) *);
925
926 /* In c-gimplify.c  */
927 extern void c_genericize (tree);
928 extern int c_gimplify_expr (tree *, gimple_seq *, gimple_seq *);
929 extern tree c_build_bind_expr (location_t, tree, tree);
930
931 /* In c-pch.c  */
932 extern void pch_init (void);
933 extern int c_common_valid_pch (cpp_reader *pfile, const char *name, int fd);
934 extern void c_common_read_pch (cpp_reader *pfile, const char *name, int fd,
935                                const char *orig);
936 extern void c_common_write_pch (void);
937 extern void c_common_no_more_pch (void);
938 extern void c_common_pch_pragma (cpp_reader *pfile, const char *);
939 extern void c_common_print_pch_checksum (FILE *f);
940
941 /* In *-checksum.c */
942 extern const unsigned char executable_checksum[16];
943
944 /* In c-cppbuiltin.c  */
945 extern void builtin_define_std (const char *macro);
946 extern void builtin_define_with_value (const char *, const char *, int);
947 extern void c_stddef_cpp_builtins (void);
948 extern void fe_file_change (const struct line_map *);
949 extern void c_parse_error (const char *, enum cpp_ttype, tree, unsigned char);
950
951 /* Objective-C / Objective-C++ entry points.  */
952
953 /* The following ObjC/ObjC++ functions are called by the C and/or C++
954    front-ends; they all must have corresponding stubs in stub-objc.c.  */
955 extern tree objc_is_class_name (tree);
956 extern tree objc_is_object_ptr (tree);
957 extern void objc_check_decl (tree);
958 extern void objc_check_global_decl (tree);
959 extern tree objc_common_type (tree, tree);
960 extern bool objc_compare_types (tree, tree, int, tree);
961 extern bool objc_have_common_type (tree, tree, int, tree);
962 extern void objc_volatilize_decl (tree);
963 extern bool objc_type_quals_match (tree, tree);
964 extern tree objc_rewrite_function_call (tree, tree);
965 extern tree objc_message_selector (void);
966 extern tree objc_lookup_ivar (tree, tree);
967 extern void objc_clear_super_receiver (void);
968 extern int objc_is_public (tree, tree);
969 extern tree objc_is_id (tree);
970 extern void objc_declare_alias (tree, tree);
971 extern void objc_declare_class (tree);
972 extern void objc_declare_protocols (tree);
973 extern tree objc_build_message_expr (tree);
974 extern tree objc_finish_message_expr (tree, tree, tree);
975 extern tree objc_build_selector_expr (location_t, tree);
976 extern tree objc_build_protocol_expr (tree);
977 extern tree objc_build_encode_expr (tree);
978 extern tree objc_build_string_object (tree);
979 extern tree objc_get_protocol_qualified_type (tree, tree);
980 extern tree objc_get_class_reference (tree);
981 extern tree objc_get_class_ivars (tree);
982 extern tree objc_get_interface_ivars (tree);
983 extern void objc_start_class_interface (tree, tree, tree, tree);
984 extern void objc_start_category_interface (tree, tree, tree, tree);
985 extern void objc_start_protocol (tree, tree, tree);
986 extern void objc_continue_interface (void);
987 extern void objc_finish_interface (void);
988 extern void objc_start_class_implementation (tree, tree);
989 extern void objc_start_category_implementation (tree, tree);
990 extern void objc_continue_implementation (void);
991 extern void objc_finish_implementation (void);
992 extern void objc_set_visibility (int);
993 extern void objc_set_method_type (enum tree_code);
994 extern tree objc_build_method_signature (tree, tree, tree, bool);
995 extern void objc_add_method_declaration (tree, tree);
996 extern bool objc_start_method_definition (tree, tree);
997 extern void objc_finish_method_definition (tree);
998 extern void objc_add_instance_variable (tree);
999 extern tree objc_build_keyword_decl (tree, tree, tree, tree);
1000 extern tree objc_build_throw_stmt (location_t, tree);
1001 extern void objc_begin_try_stmt (location_t, tree);
1002 extern tree objc_finish_try_stmt (void);
1003 extern void objc_begin_catch_clause (tree);
1004 extern void objc_finish_catch_clause (void);
1005 extern void objc_build_finally_clause (location_t, tree);
1006 extern tree objc_build_synchronized (location_t, tree, tree);
1007 extern int objc_static_init_needed_p (void);
1008 extern tree objc_generate_static_init_call (tree);
1009 extern tree objc_generate_write_barrier (tree, enum tree_code, tree);
1010
1011 /* The following are provided by the C and C++ front-ends, and called by
1012    ObjC/ObjC++.  */
1013 extern void *objc_get_current_scope (void);
1014 extern void objc_mark_locals_volatile (void *);
1015
1016 /* In c-ppoutput.c  */
1017 extern void init_pp_output (FILE *);
1018 extern void preprocess_file (cpp_reader *);
1019 extern void pp_file_change (const struct line_map *);
1020 extern void pp_dir_change (cpp_reader *, const char *);
1021 extern bool check_missing_format_attribute (tree, tree);
1022
1023 /* In c-omp.c  */
1024 extern tree c_finish_omp_master (location_t, tree);
1025 extern tree c_finish_omp_critical (location_t, tree, tree);
1026 extern tree c_finish_omp_ordered (location_t, tree);
1027 extern void c_finish_omp_barrier (location_t);
1028 extern tree c_finish_omp_atomic (location_t, enum tree_code, tree, tree);
1029 extern void c_finish_omp_flush (location_t);
1030 extern void c_finish_omp_taskwait (location_t);
1031 extern tree c_finish_omp_for (location_t, tree, tree, tree, tree, tree, tree);
1032 extern void c_split_parallel_clauses (location_t, tree, tree *, tree *);
1033 extern enum omp_clause_default_kind c_omp_predetermined_sharing (tree);
1034
1035 /* Not in c-omp.c; provided by the front end.  */
1036 extern bool c_omp_sharing_predetermined (tree);
1037 extern tree c_omp_remap_decl (tree, bool);
1038 extern void record_types_used_by_current_var_decl (tree);
1039
1040 #endif /* ! GCC_C_COMMON_H */