contrib/gcc-4.0/gcc/c-common.h

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