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