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