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 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: unused
  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_PTRBASE,
  76   RID_PTREXTENT, RID_PTRVALUE, RID_CHOOSE_EXPR, 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_ID,          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_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 extern GTY(()) tree c_global_trees[CTI_MAX];
 208
 209 /* In a RECORD_TYPE, a sorted array of the fields of the type, not a
 210    tree for size reasons.  */
 211 struct sorted_fields_type GTY(())
 212 {
 213   int len;
 214   tree GTY((length ("%h.len"))) elts[1];
 215 };
 216
 217 /* Mark which labels are explicitly declared.
 218    These may be shadowed, and may be referenced from nested functions.  */
 219 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
 220
 221 /* Flag strings given by __FUNCTION__ and __PRETTY_FUNCTION__ for a
 222    warning if they undergo concatenation.  */
 223 #define C_ARTIFICIAL_STRING_P(NODE) TREE_LANG_FLAG_0 (NODE)
 224
 225 typedef enum c_language_kind
 226 {
 227   clk_c         = 0,            /* C90, C94 or C99 */
 228   clk_objc      = 1,            /* clk_c with ObjC features.  */
 229   clk_cxx       = 2,            /* ANSI/ISO C++ */
 230   clk_objcxx    = 3             /* clk_cxx with ObjC features.  */
 231 }
 232 c_language_kind;
 233
 234 /* To test for a specific language use c_language, defined by each
 235    front end.  For "ObjC features" or "not C++" use the macros.  */
 236 extern c_language_kind c_language;
 237
 238 #define c_dialect_cxx()         (c_language & clk_cxx)
 239 #define c_dialect_objc()        (c_language & clk_objc)
 240
 241 /* Information about a statement tree.  */
 242
 243 struct stmt_tree_s GTY(()) {
 244   /* The current statment list being collected.  */
 245   tree x_cur_stmt_list;
 246
 247   /* In C++, Nonzero if we should treat statements as full
 248      expressions.  In particular, this variable is no-zero if at the
 249      end of a statement we should destroy any temporaries created
 250      during that statement.  Similarly, if, at the end of a block, we
 251      should destroy any local variables in this block.  Normally, this
 252      variable is nonzero, since those are the normal semantics of
 253      C++.
 254
 255      However, in order to represent aggregate initialization code as
 256      tree structure, we use statement-expressions.  The statements
 257      within the statement expression should not result in cleanups
 258      being run until the entire enclosing statement is complete.
 259
 260      This flag has no effect in C.  */
 261   int stmts_are_full_exprs_p;
 262 };
 263
 264 typedef struct stmt_tree_s *stmt_tree;
 265
 266 /* Global state pertinent to the current function.  Some C dialects
 267    extend this structure with additional fields.  */
 268
 269 struct c_language_function GTY(()) {
 270   /* While we are parsing the function, this contains information
 271      about the statement-tree that we are building.  */
 272   struct stmt_tree_s x_stmt_tree;
 273 };
 274
 275 /* When building a statement-tree, this is the current statment list
 276    being collected.  It's TREE_CHAIN is a back-pointer to the previous
 277    statment list.  */
 278
 279 #define cur_stmt_list (current_stmt_tree ()->x_cur_stmt_list)
 280
 281 /* Language-specific hooks.  */
 282
 283 extern int (*lang_gimplify_stmt) (tree *);
 284 extern void (*lang_expand_function_end) (void);
 285
 286 /* Callback that determines if it's ok for a function to have no
 287    noreturn attribute.  */
 288 extern int (*lang_missing_noreturn_ok_p) (tree);
 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 re_push_stmt_list (tree);
 296 extern tree pop_stmt_list (tree);
 297 extern tree add_stmt (tree);
 298 extern void add_decl_stmt (tree);
 299 extern void push_cleanup (tree, tree, bool);
 300
 301 extern tree walk_stmt_tree (tree *, walk_tree_fn, void *);
 302 extern void prep_stmt (tree);
 303 extern int c_expand_decl (tree);
 304
 305 extern int field_decl_cmp (const void *, const void *);
 306 extern void resort_sorted_fields (void *, void *, gt_pointer_operator,
 307                                   void *);
 308 \f
 309 /* Switches common to the C front ends.  */
 310
 311 /* Nonzero if prepreprocessing only.  */
 312
 313 extern int flag_preprocess_only;
 314
 315 /* Zero means that faster, ...NonNil variants of objc_msgSend...
 316    calls will be used in ObjC; passing nil receivers to such calls
 317    will most likely result in crashes.  */
 318 extern int flag_nil_receivers;
 319
 320 /* Nonzero means that we will allow new ObjC exception syntax (@throw,
 321    @try, etc.) in source code.  */
 322 extern int flag_objc_exceptions;
 323
 324 /* Nonzero means that we generate NeXT setjmp based exceptions.  */
 325 extern int flag_objc_sjlj_exceptions;
 326
 327 /* Nonzero means that code generation will be altered to support
 328    "zero-link" execution.  This currently affects ObjC only, but may
 329    affect other languages in the future.  */
 330 extern int flag_zero_link;
 331
 332 /* Nonzero means emit an '__OBJC, __image_info' for the current translation
 333    unit.  It will inform the ObjC runtime that class definition(s) herein
 334    contained are to replace one(s) previously loaded.  */
 335 extern int flag_replace_objc_classes;
 336
 337 /* Nonzero means don't output line number information.  */
 338
 339 extern char flag_no_line_commands;
 340
 341 /* Nonzero causes -E output not to be done, but directives such as
 342    #define that have side effects are still obeyed.  */
 343
 344 extern char flag_no_output;
 345
 346 /* Nonzero means dump macros in some fashion; contains the 'D', 'M' or
 347    'N' of the command line switch.  */
 348
 349 extern char flag_dump_macros;
 350
 351 /* Nonzero means pass #include lines through to the output.  */
 352
 353 extern char flag_dump_includes;
 354
 355 /* The file name to which we should write a precompiled header, or
 356    NULL if no header will be written in this compile.  */
 357
 358 extern const char *pch_file;
 359
 360 /* Nonzero if an ISO standard was selected.  It rejects macros in the
 361    user's namespace.  */
 362
 363 extern int flag_iso;
 364
 365 /* Nonzero if -undef was given.  It suppresses target built-in macros
 366    and assertions.  */
 367
 368 extern int flag_undef;
 369
 370 /* Nonzero means don't recognize the non-ANSI builtin functions.  */
 371
 372 extern int flag_no_builtin;
 373
 374 /* Nonzero means don't recognize the non-ANSI builtin functions.
 375    -ansi sets this.  */
 376
 377 extern int flag_no_nonansi_builtin;
 378
 379 /* Nonzero means give `double' the same size as `float'.  */
 380
 381 extern int flag_short_double;
 382
 383 /* Nonzero means give `wchar_t' the same size as `short'.  */
 384
 385 extern int flag_short_wchar;
 386
 387 /* Nonzero means allow Microsoft extensions without warnings or errors.  */
 388 extern int flag_ms_extensions;
 389
 390 /* Nonzero means don't recognize the keyword `asm'.  */
 391
 392 extern int flag_no_asm;
 393
 394 /* Nonzero means give string constants the type `const char *', as mandated
 395    by the standard.  */
 396
 397 extern int flag_const_strings;
 398
 399 /* Nonzero means to treat bitfields as signed unless they say `unsigned'.  */
 400
 401 extern int flag_signed_bitfields;
 402 extern int explicit_flag_signed_bitfields;
 403
 404 /* Nonzero means warn about pointer casts that can drop a type qualifier
 405    from the pointer target type.  */
 406
 407 extern int warn_cast_qual;
 408
 409 /* Warn about functions which might be candidates for format attributes.  */
 410
 411 extern int warn_missing_format_attribute;
 412
 413 /* Nonzero means warn about sizeof(function) or addition/subtraction
 414    of function pointers.  */
 415
 416 extern int warn_pointer_arith;
 417
 418 /* Nonzero means warn for any global function def
 419    without separate previous prototype decl.  */
 420
 421 extern int warn_missing_prototypes;
 422
 423 /* Warn if adding () is suggested.  */
 424
 425 extern int warn_parentheses;
 426
 427 /* Warn if initializer is not completely bracketed.  */
 428
 429 extern int warn_missing_braces;
 430
 431 /* Warn about comparison of signed and unsigned values.
 432    If -1, neither -Wsign-compare nor -Wno-sign-compare has been specified.  */
 433
 434 extern int warn_sign_compare;
 435
 436 /* Nonzero means warn about usage of long long when `-pedantic'.  */
 437
 438 extern int warn_long_long;
 439
 440 /* Nonzero means warn about deprecated conversion from string constant to
 441    `char *'.  */
 442
 443 extern int warn_write_strings;
 444
 445 /* Nonzero means warn about multiple (redundant) decls for the same single
 446    variable or function.  */
 447
 448 extern int warn_redundant_decls;
 449
 450 /* Warn about testing equality of floating point numbers.  */
 451
 452 extern int warn_float_equal;
 453
 454 /* Warn about a subscript that has type char.  */
 455
 456 extern int warn_char_subscripts;
 457
 458 /* Warn if a type conversion is done that might have confusing results.  */
 459
 460 extern int warn_conversion;
 461
 462 /* Warn about #pragma directives that are not recognized.  */
 463
 464 extern int warn_unknown_pragmas; /* Tri state variable.  */
 465
 466 /* Warn about format/argument anomalies in calls to formatted I/O functions
 467    (*printf, *scanf, strftime, strfmon, etc.).  */
 468
 469 extern int warn_format;
 470
 471 /* Warn about Y2K problems with strftime formats.  */
 472
 473 extern int warn_format_y2k;
 474
 475 /* Warn about excess arguments to formats.  */
 476
 477 extern int warn_format_extra_args;
 478
 479 /* Warn about zero-length formats.  */
 480
 481 extern int warn_format_zero_length;
 482
 483 /* Warn about non-literal format arguments.  */
 484
 485 extern int warn_format_nonliteral;
 486
 487 /* Warn about possible security problems with calls to format functions.  */
 488
 489 extern int warn_format_security;
 490
 491
 492 /* C/ObjC language option variables.  */
 493
 494
 495 /* Nonzero means message about use of implicit function declarations;
 496  1 means warning; 2 means error.  */
 497
 498 extern int mesg_implicit_function_declaration;
 499
 500 /* Nonzero means allow type mismatches in conditional expressions;
 501    just make their values `void'.  */
 502
 503 extern int flag_cond_mismatch;
 504
 505 /* Nonzero means enable C89 Amendment 1 features.  */
 506
 507 extern int flag_isoc94;
 508
 509 /* Nonzero means use the ISO C99 dialect of C.  */
 510
 511 extern int flag_isoc99;
 512
 513 /* Nonzero means that we have builtin functions, and main is an int.  */
 514
 515 extern int flag_hosted;
 516
 517 /* Nonzero means warn when casting a function call to a type that does
 518    not match the return type (e.g. (float)sqrt() or (anything*)malloc()
 519    when there is no previous declaration of sqrt or malloc.  */
 520
 521 extern int warn_bad_function_cast;
 522
 523 /* Warn about traditional constructs whose meanings changed in ANSI C.  */
 524
 525 extern int warn_traditional;
 526
 527 /* Nonzero means warn for a declaration found after a statement.  */
 528
 529 extern int warn_declaration_after_statement;
 530
 531 /* Nonzero means warn for non-prototype function decls
 532    or non-prototyped defs without previous prototype.  */
 533
 534 extern int warn_strict_prototypes;
 535
 536 /* Nonzero means warn for any global function def
 537    without separate previous decl.  */
 538
 539 extern int warn_missing_declarations;
 540
 541 /* Nonzero means warn about extern declarations of objects not at
 542    file-scope level and about *all* declarations of functions (whether
 543    extern or static) not at file-scope level.  Note that we exclude
 544    implicit function declarations.  To get warnings about those, use
 545    -Wimplicit.  */
 546
 547 extern int warn_nested_externs;
 548
 549 /* Warn if main is suspicious.  */
 550
 551 extern int warn_main;
 552
 553 /* Nonzero means warn about possible violations of sequence point rules.  */
 554
 555 extern int warn_sequence_point;
 556
 557 /* Nonzero means warn about uninitialized variable when it is initialized with itself.
 558    For example: int i = i;, GCC will not warn about this when warn_init_self is nonzero.  */
 559
 560 extern int warn_init_self;
 561
 562
 563 /* Nonzero means to warn about compile-time division by zero.  */
 564 extern int warn_div_by_zero;
 565
 566 /* Nonzero means warn about use of implicit int.  */
 567
 568 extern int warn_implicit_int;
 569
 570 /* Warn about NULL being passed to argument slots marked as requiring
 571    non-NULL.  */
 572
 573 extern int warn_nonnull;
 574
 575 /* Warn about old-style parameter declaration.  */
 576
 577 extern int warn_old_style_definition;
 578
 579
 580 /* ObjC language option variables.  */
 581
 582
 583 /* Open and close the file for outputting class declarations, if
 584    requested (ObjC).  */
 585
 586 extern int flag_gen_declaration;
 587
 588 /* Generate code for GNU or NeXT runtime environment.  */
 589
 590 extern int flag_next_runtime;
 591
 592 /* Tells the compiler that this is a special run.  Do not perform any
 593    compiling, instead we are to test some platform dependent features
 594    and output a C header file with appropriate definitions.  */
 595
 596 extern int print_struct_values;
 597
 598 /* ???.  Undocumented.  */
 599
 600 extern const char *constant_string_class_name;
 601
 602 /* Warn if multiple methods are seen for the same selector, but with
 603    different argument types.  Performs the check on the whole selector
 604    table at the end of compilation.  */
 605
 606 extern int warn_selector;
 607
 608 /* Warn if a @selector() is found, and no method with that selector
 609    has been previously declared.  The check is done on each
 610    @selector() as soon as it is found - so it warns about forward
 611    declarations.  */
 612
 613 extern int warn_undeclared_selector;
 614
 615 /* Warn if methods required by a protocol are not implemented in the
 616    class adopting it.  When turned off, methods inherited to that
 617    class are also considered implemented.  */
 618
 619 extern int warn_protocol;
 620
 621
 622 /* C++ language option variables.  */
 623
 624
 625 /* Nonzero means don't recognize any extension keywords.  */
 626
 627 extern int flag_no_gnu_keywords;
 628
 629 /* Nonzero means do emit exported implementations of functions even if
 630    they can be inlined.  */
 631
 632 extern int flag_implement_inlines;
 633
 634 /* Nonzero means that implicit instantiations will be emitted if needed.  */
 635
 636 extern int flag_implicit_templates;
 637
 638 /* Nonzero means that implicit instantiations of inline templates will be
 639    emitted if needed, even if instantiations of non-inline templates
 640    aren't.  */
 641
 642 extern int flag_implicit_inline_templates;
 643
 644 /* Nonzero means generate separate instantiation control files and
 645    juggle them at link time.  */
 646
 647 extern int flag_use_repository;
 648
 649 /* Nonzero if we want to issue diagnostics that the standard says are not
 650    required.  */
 651
 652 extern int flag_optional_diags;
 653
 654 /* Nonzero means we should attempt to elide constructors when possible.  */
 655
 656 extern int flag_elide_constructors;
 657
 658 /* Nonzero means that member functions defined in class scope are
 659    inline by default.  */
 660
 661 extern int flag_default_inline;
 662
 663 /* Controls whether compiler generates 'type descriptor' that give
 664    run-time type information.  */
 665
 666 extern int flag_rtti;
 667
 668 /* Nonzero if we want to conserve space in the .o files.  We do this
 669    by putting uninitialized data and runtime initialized data into
 670    .common instead of .data at the expense of not flagging multiple
 671    definitions.  */
 672
 673 extern int flag_conserve_space;
 674
 675 /* Nonzero if we want to obey access control semantics.  */
 676
 677 extern int flag_access_control;
 678
 679 /* Nonzero if we want to check the return value of new and avoid calling
 680    constructors if it is a null pointer.  */
 681
 682 extern int flag_check_new;
 683
 684 /* Nonzero if we want the new ISO rules for pushing a new scope for `for'
 685    initialization variables.
 686    0: Old rules, set by -fno-for-scope.
 687    2: New ISO rules, set by -ffor-scope.
 688    1: Try to implement new ISO rules, but with backup compatibility
 689    (and warnings).  This is the default, for now.  */
 690
 691 extern int flag_new_for_scope;
 692
 693 /* Nonzero if we want to emit defined symbols with common-like linkage as
 694    weak symbols where possible, in order to conform to C++ semantics.
 695    Otherwise, emit them as local symbols.  */
 696
 697 extern int flag_weak;
 698
 699 /* 0 means we want the preprocessor to not emit line directives for
 700    the current working directory.  1 means we want it to do it.  -1
 701    means we should decide depending on whether debugging information
 702    is being emitted or not.  */
 703
 704 extern int flag_working_directory;
 705
 706 /* Nonzero to use __cxa_atexit, rather than atexit, to register
 707    destructors for local statics and global objects.  */
 708
 709 extern int flag_use_cxa_atexit;
 710
 711 /* Nonzero means make the default pedwarns warnings instead of errors.
 712    The value of this flag is ignored if -pedantic is specified.  */
 713
 714 extern int flag_permissive;
 715
 716 /* Nonzero means to implement standard semantics for exception
 717    specifications, calling unexpected if an exception is thrown that
 718    doesn't match the specification.  Zero means to treat them as
 719    assertions and optimize accordingly, but not check them.  */
 720
 721 extern int flag_enforce_eh_specs;
 722
 723 /* Nonzero means warn about things that will change when compiling
 724    with an ABI-compliant compiler.  */
 725
 726 extern int warn_abi;
 727
 728 /* Nonzero means warn about invalid uses of offsetof.  */
 729
 730 extern int warn_invalid_offsetof;
 731
 732 /* Nonzero means warn about implicit declarations.  */
 733
 734 extern int warn_implicit;
 735
 736 /* Nonzero means warn when all ctors or dtors are private, and the class
 737    has no friends.  */
 738
 739 extern int warn_ctor_dtor_privacy;
 740
 741 /* Nonzero means warn in function declared in derived class has the
 742    same name as a virtual in the base class, but fails to match the
 743    type signature of any virtual function in the base class.  */
 744
 745 extern int warn_overloaded_virtual;
 746
 747 /* Nonzero means warn when declaring a class that has a non virtual
 748    destructor, when it really ought to have a virtual one.  */
 749
 750 extern int warn_nonvdtor;
 751
 752 /* Nonzero means warn when the compiler will reorder code.  */
 753
 754 extern int warn_reorder;
 755
 756 /* Nonzero means warn when synthesis behavior differs from Cfront's.  */
 757
 758 extern int warn_synth;
 759
 760 /* Nonzero means warn when we convert a pointer to member function
 761    into a pointer to (void or function).  */
 762
 763 extern int warn_pmf2ptr;
 764
 765 /* Nonzero means warn about violation of some Effective C++ style rules.  */
 766
 767 extern int warn_ecpp;
 768
 769 /* Nonzero means warn where overload resolution chooses a promotion from
 770    unsigned to signed over a conversion to an unsigned of the same size.  */
 771
 772 extern int warn_sign_promo;
 773
 774 /* Nonzero means warn when an old-style cast is used.  */
 775
 776 extern int warn_old_style_cast;
 777
 778 /* Nonzero means warn when non-templatized friend functions are
 779    declared within a template */
 780
 781 extern int warn_nontemplate_friend;
 782
 783 /* Nonzero means complain about deprecated features.  */
 784
 785 extern int warn_deprecated;
 786
 787 /* Maximum template instantiation depth.  This limit is rather
 788    arbitrary, but it exists to limit the time it takes to notice
 789    infinite template instantiations.  */
 790
 791 extern int max_tinst_depth;
 792
 793 /* Nonzero means the expression being parsed will never be evaluated.
 794    This is a count, since unevaluated expressions can nest.  */
 795
 796 extern int skip_evaluation;
 797
 798 /* C types are partitioned into three subsets: object, function, and
 799    incomplete types.  */
 800 #define C_TYPE_OBJECT_P(type) \
 801   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
 802
 803 #define C_TYPE_INCOMPLETE_P(type) \
 804   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
 805
 806 #define C_TYPE_FUNCTION_P(type) \
 807   (TREE_CODE (type) == FUNCTION_TYPE)
 808
 809 /* For convenience we define a single macro to identify the class of
 810    object or incomplete types.  */
 811 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
 812   (!C_TYPE_FUNCTION_P (type))
 813
 814 /* Record in each node resulting from a binary operator
 815    what operator was specified for it.  */
 816 #define C_EXP_ORIGINAL_CODE(exp) ((enum tree_code) TREE_COMPLEXITY (exp))
 817
 818 /* Attribute table common to the C front ends.  */
 819 extern const struct attribute_spec c_common_attribute_table[];
 820 extern const struct attribute_spec c_common_format_attribute_table[];
 821
 822 /* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
 823    ID is the identifier to use, NAME is the string.
 824    TYPE_DEP indicates whether it depends on type of the function or not
 825    (i.e. __PRETTY_FUNCTION__).  */
 826
 827 extern tree (*make_fname_decl) (tree, int);
 828
 829 extern tree identifier_global_value (tree);
 830 extern void record_builtin_type (enum rid, const char *, tree);
 831 extern tree build_void_list_node (void);
 832 extern void start_fname_decls (void);
 833 extern void finish_fname_decls (void);
 834 extern const char *fname_as_string (int);
 835 extern tree fname_decl (unsigned, tree);
 836
 837 extern void check_function_arguments (tree, tree);
 838 extern void check_function_arguments_recurse (void (*)
 839                                               (void *, tree,
 840                                                unsigned HOST_WIDE_INT),
 841                                               void *, tree,
 842                                               unsigned HOST_WIDE_INT);
 843 extern void check_function_format (int *, tree, tree);
 844 extern void set_Wformat (int);
 845 extern tree handle_format_attribute (tree *, tree, tree, int, bool *);
 846 extern tree handle_format_arg_attribute (tree *, tree, tree, int, bool *);
 847 extern int c_common_handle_option (size_t code, const char *arg, int value);
 848 extern bool c_common_missing_argument (const char *opt, size_t code);
 849 extern tree c_common_type_for_mode (enum machine_mode, int);
 850 extern tree c_common_type_for_size (unsigned int, int);
 851 extern tree c_common_unsigned_type (tree);
 852 extern tree c_common_signed_type (tree);
 853 extern tree c_common_signed_or_unsigned_type (int, tree);
 854 extern tree c_common_truthvalue_conversion (tree);
 855 extern void c_apply_type_quals_to_decl (int, tree);
 856 extern tree c_sizeof_or_alignof_type (tree, enum tree_code, int);
 857 extern tree c_alignof_expr (tree);
 858 /* Print an error message for invalid operands to arith operation CODE.
 859    NOP_EXPR is used as a special case (see truthvalue_conversion).  */
 860 extern void binary_op_error (enum tree_code);
 861 #define my_friendly_assert(EXP, N) (void) \
 862  (((EXP) == 0) ? (fancy_abort (__FILE__, __LINE__, __FUNCTION__), 0) : 0)
 863
 864 extern tree c_expand_expr_stmt (tree);
 865 /* Validate the expression after `case' and apply default promotions.  */
 866 extern tree check_case_value (tree);
 867 extern tree fix_string_type (tree);
 868 struct varray_head_tag;
 869 extern void constant_expression_warning (tree);
 870 extern tree convert_and_check (tree, tree);
 871 extern void overflow_warning (tree);
 872 extern void unsigned_conversion_warning (tree, tree);
 873
 874 #define c_sizeof(T)  c_sizeof_or_alignof_type (T, SIZEOF_EXPR, 1)
 875 #define c_alignof(T) c_sizeof_or_alignof_type (T, ALIGNOF_EXPR, 1)
 876
 877 /* Subroutine of build_binary_op, used for comparison operations.
 878    See if the operands have both been converted from subword integer types
 879    and, if so, perhaps change them both back to their original type.  */
 880 extern tree shorten_compare (tree *, tree *, tree *, enum tree_code *);
 881
 882 extern tree pointer_int_sum (enum tree_code, tree, tree);
 883 extern unsigned int min_precision (tree, int);
 884
 885 /* Add qualifiers to a type, in the fashion for C.  */
 886 extern tree c_build_qualified_type (tree, int);
 887
 888 /* Build tree nodes and builtin functions common to both C and C++ language
 889    frontends.  */
 890 extern void c_common_nodes_and_builtins (void);
 891
 892 extern void disable_builtin_function (const char *);
 893
 894 extern tree build_va_arg (tree, tree);
 895
 896 extern unsigned int c_common_init_options (unsigned int, const char **);
 897 extern bool c_common_post_options (const char **);
 898 extern bool c_common_init (void);
 899 extern void c_common_finish (void);
 900 extern void c_common_parse_file (int);
 901 extern HOST_WIDE_INT c_common_get_alias_set (tree);
 902 extern void c_register_builtin_type (tree, const char*);
 903 extern bool c_promoting_integer_type_p (tree);
 904 extern int self_promoting_args_p (tree);
 905 extern tree strip_array_types (tree);
 906 extern tree strip_pointer_operator (tree);
 907
 908 /* This is the basic parsing function.  */
 909 extern void c_parse_file (void);
 910 /* This is misnamed, it actually performs end-of-compilation processing.  */
 911 extern void finish_file (void);
 912
 913 /* These macros provide convenient access to the various _STMT nodes.  */
 914
 915 /* Nonzero if this statement should be considered a full-expression,
 916    i.e., if temporaries created during this statement should have
 917    their destructors run at the end of this statement.  (In C, this
 918    will always be false, since there are no destructors.)  */
 919 #define STMT_IS_FULL_EXPR_P(NODE) TREE_LANG_FLAG_1 ((NODE))
 920
 921 /* Nonzero if a given STATEMENT_LIST represents the outermost binding
 922    if a statement expression.  */
 923 #define STATEMENT_LIST_STMT_EXPR(NODE) \
 924   TREE_LANG_FLAG_1 (STATEMENT_LIST_CHECK (NODE))
 925
 926 /* IF_STMT accessors. These give access to the condition of the if
 927    statement, the then block of the if statement, and the else block
 928    of the if statement if it exists.  */
 929 #define IF_COND(NODE)           TREE_OPERAND (IF_STMT_CHECK (NODE), 0)
 930 #define THEN_CLAUSE(NODE)       TREE_OPERAND (IF_STMT_CHECK (NODE), 1)
 931 #define ELSE_CLAUSE(NODE)       TREE_OPERAND (IF_STMT_CHECK (NODE), 2)
 932
 933 /* WHILE_STMT accessors. These give access to the condition of the
 934    while statement and the body of the while statement, respectively.  */
 935 #define WHILE_COND(NODE)        TREE_OPERAND (WHILE_STMT_CHECK (NODE), 0)
 936 #define WHILE_BODY(NODE)        TREE_OPERAND (WHILE_STMT_CHECK (NODE), 1)
 937
 938 /* DO_STMT accessors. These give access to the condition of the do
 939    statement and the body of the do statement, respectively.  */
 940 #define DO_COND(NODE)           TREE_OPERAND (DO_STMT_CHECK (NODE), 0)
 941 #define DO_BODY(NODE)           TREE_OPERAND (DO_STMT_CHECK (NODE), 1)
 942
 943 /* RETURN_STMT accessors. These give the expression associated with a
 944    return statement, and whether it should be ignored when expanding
 945    (as opposed to inlining).  */
 946 #define RETURN_STMT_EXPR(NODE)  TREE_OPERAND (RETURN_STMT_CHECK (NODE), 0)
 947
 948 /* EXPR_STMT accessor. This gives the expression associated with an
 949    expression statement.  */
 950 #define EXPR_STMT_EXPR(NODE)    TREE_OPERAND (EXPR_STMT_CHECK (NODE), 0)
 951
 952 /* FOR_STMT accessors. These give access to the init statement,
 953    condition, update expression, and body of the for statement,
 954    respectively.  */
 955 #define FOR_INIT_STMT(NODE)     TREE_OPERAND (FOR_STMT_CHECK (NODE), 0)
 956 #define FOR_COND(NODE)          TREE_OPERAND (FOR_STMT_CHECK (NODE), 1)
 957 #define FOR_EXPR(NODE)          TREE_OPERAND (FOR_STMT_CHECK (NODE), 2)
 958 #define FOR_BODY(NODE)          TREE_OPERAND (FOR_STMT_CHECK (NODE), 3)
 959
 960 #define SWITCH_TYPE(NODE)       TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 2)
 961
 962 /* DECL_STMT accessor. This gives access to the DECL associated with
 963    the given declaration statement.  */
 964 #define DECL_STMT_DECL(NODE)    TREE_OPERAND (DECL_STMT_CHECK (NODE), 0)
 965
 966 /* STMT_EXPR accessor.  */
 967 #define STMT_EXPR_STMT(NODE)    TREE_OPERAND (STMT_EXPR_CHECK (NODE), 0)
 968
 969 /* Nonzero if this statement-expression does not have an associated scope.  */
 970 #define STMT_EXPR_NO_SCOPE(NODE) \
 971    TREE_LANG_FLAG_0 (STMT_EXPR_CHECK (NODE))
 972
 973 /* COMPOUND_LITERAL_EXPR accessors.  */
 974 #define COMPOUND_LITERAL_EXPR_DECL_STMT(NODE)           \
 975   TREE_OPERAND (COMPOUND_LITERAL_EXPR_CHECK (NODE), 0)
 976 #define COMPOUND_LITERAL_EXPR_DECL(NODE)                        \
 977   DECL_STMT_DECL (COMPOUND_LITERAL_EXPR_DECL_STMT (NODE))
 978
 979 /* The body of the CLEANUP_STMT.  */
 980 #define CLEANUP_BODY(NODE) \
 981   TREE_OPERAND (CLEANUP_STMT_CHECK (NODE), 0)
 982 /* The cleanup to run in a CLEANUP_STMT.  */
 983 #define CLEANUP_EXPR(NODE) \
 984   TREE_OPERAND (CLEANUP_STMT_CHECK (NODE), 1)
 985 /* The VAR_DECL to clean up in a CLEANUP_STMT.  */
 986 #define CLEANUP_DECL(NODE) \
 987   TREE_OPERAND (CLEANUP_STMT_CHECK (NODE), 2)
 988
 989 #define DEFTREECODE(SYM, NAME, TYPE, LENGTH) SYM,
 990
 991 enum c_tree_code {
 992   C_DUMMY_TREE_CODE = LAST_AND_UNUSED_TREE_CODE,
 993 #include "c-common.def"
 994   LAST_C_TREE_CODE
 995 };
 996
 997 #undef DEFTREECODE
 998
 999 #define c_common_stmt_codes                             \
1000    CLEANUP_STMT,        EXPR_STMT,                      \
1001    DECL_STMT,           IF_STMT,        FOR_STMT,       \
1002    WHILE_STMT,          DO_STMT,        RETURN_STMT,    \
1003    BREAK_STMT,          CONTINUE_STMT,  SWITCH_STMT
1004
1005 /* TRUE if a code represents a statement.  The front end init
1006    langhook should take care of initialization of this array.  */
1007 extern bool statement_code_p[MAX_TREE_CODES];
1008
1009 #define STATEMENT_CODE_P(CODE) statement_code_p[(int) (CODE)]
1010
1011 #define INIT_STATEMENT_CODES(STMT_CODES)                        \
1012   do {                                                          \
1013     unsigned int i;                                             \
1014     memset (&statement_code_p, 0, sizeof (statement_code_p));   \
1015     for (i = 0; i < ARRAY_SIZE (STMT_CODES); i++)               \
1016       statement_code_p[STMT_CODES[i]] = true;                   \
1017   } while (0)
1018
1019 extern int stmts_are_full_exprs_p (void);
1020 extern int anon_aggr_type_p (tree);
1021
1022 /* For a VAR_DECL that is an anonymous union, these are the various
1023    sub-variables that make up the anonymous union.  */
1024 #define DECL_ANON_UNION_ELEMS(NODE) DECL_ARGUMENTS ((NODE))
1025
1026 /* In a FIELD_DECL, nonzero if the decl was originally a bitfield.  */
1027 #define DECL_C_BIT_FIELD(NODE) \
1028   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
1029 #define SET_DECL_C_BIT_FIELD(NODE) \
1030   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
1031 #define CLEAR_DECL_C_BIT_FIELD(NODE) \
1032   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
1033
1034 extern void emit_local_var (tree);
1035 extern void make_rtl_for_local_static (tree);
1036 extern tree c_expand_return (tree);
1037 extern tree do_case (tree, tree);
1038 extern tree build_stmt (enum tree_code, ...);
1039 extern tree build_case_label (tree, tree, tree);
1040 extern tree build_continue_stmt (void);
1041 extern tree build_break_stmt (void);
1042 extern tree build_return_stmt (tree);
1043
1044 extern void c_expand_asm_operands (tree, tree, tree, tree, int, location_t);
1045
1046 /* These functions must be defined by each front-end which implements
1047    a variant of the C language.  They are used in c-common.c.  */
1048
1049 extern tree build_unary_op (enum tree_code, tree, int);
1050 extern tree build_binary_op (enum tree_code, tree, tree, int);
1051 extern int lvalue_p (tree);
1052 extern tree default_conversion (tree);
1053
1054 /* Given two integer or real types, return the type for their sum.
1055    Given two compatible ANSI C types, returns the merged type.  */
1056
1057 extern tree common_type (tree, tree);
1058
1059 extern tree expand_tree_builtin (tree, tree, tree);
1060
1061 extern tree decl_constant_value (tree);
1062
1063 /* Handle increment and decrement of boolean types.  */
1064 extern tree boolean_increment (enum tree_code, tree);
1065
1066 /* Hook currently used only by the C++ front end to reset internal state
1067    after entering or leaving a header file.  */
1068 extern void extract_interface_info (void);
1069
1070 extern int case_compare (splay_tree_key, splay_tree_key);
1071
1072 extern tree c_add_case_label (splay_tree, tree, tree, tree);
1073
1074 extern void c_do_switch_warnings (splay_tree, tree);
1075
1076 extern tree build_function_call (tree, tree);
1077
1078 extern tree finish_label_address_expr (tree);
1079
1080 /* Same function prototype, but the C and C++ front ends have
1081    different implementations.  Used in c-common.c.  */
1082 extern tree lookup_label (tree);
1083
1084 extern int vector_types_convertible_p (tree t1, tree t2);
1085
1086 extern rtx c_expand_expr (tree, rtx, enum machine_mode, int, rtx *);
1087
1088 extern int c_safe_from_p (rtx, tree);
1089
1090 extern int c_staticp (tree);
1091
1092 extern int c_common_unsafe_for_reeval (tree);
1093
1094 extern void init_c_lex (void);
1095
1096 extern void c_cpp_builtins (cpp_reader *);
1097
1098 /* Positive if an implicit `extern "C"' scope has just been entered;
1099    negative if such a scope has just been exited.  */
1100 extern GTY(()) int pending_lang_change;
1101
1102 /* Information recorded about each file examined during compilation.  */
1103
1104 struct c_fileinfo
1105 {
1106   int time;     /* Time spent in the file.  */
1107   short interface_only;         /* Flags - used only by C++ */
1108   short interface_unknown;
1109 };
1110
1111 struct c_fileinfo *get_fileinfo (const char *);
1112 extern void dump_time_statistics (void);
1113
1114 extern bool c_dump_tree (void *, tree);
1115
1116 extern int c_gimplify_expr (tree *, tree *, tree *);
1117 extern tree c_walk_subtrees (tree*, int*, walk_tree_fn, void*, void*);
1118
1119 extern void c_warn_unused_result (tree *);
1120
1121 /* In c-simplify.c  */
1122 extern void c_genericize (tree);
1123 extern int c_gimplify_stmt (tree *);
1124 extern tree c_build_bind_expr (tree, tree);
1125
1126 extern void pch_init (void);
1127 extern int c_common_valid_pch (cpp_reader *pfile, const char *name, int fd);
1128 extern void c_common_read_pch (cpp_reader *pfile, const char *name, int fd,
1129                                const char *orig);
1130 extern void c_common_write_pch (void);
1131 extern void c_common_no_more_pch (void);
1132 extern void builtin_define_with_value (const char *, const char *, int);
1133 extern void c_stddef_cpp_builtins (void);
1134 extern void fe_file_change (const struct line_map *);
1135 extern void c_parse_error (const char *, enum cpp_ttype, tree);
1136
1137 /* The following have been moved here from c-tree.h, since they're needed
1138    in the ObjC++ world, too.  What is more, stub-objc.c could use a few
1139    prototypes.  */
1140 extern tree lookup_interface (tree);
1141 extern tree is_class_name (tree);
1142 extern tree objc_is_object_ptr (tree);
1143 extern void objc_check_decl (tree);
1144 extern int objc_comptypes (tree, tree, int);
1145 extern tree objc_message_selector (void);
1146 extern tree lookup_objc_ivar (tree);
1147 extern void *get_current_scope (void);
1148 extern void objc_mark_locals_volatile (void *);
1149 extern void objc_clear_super_receiver (void);
1150 extern int objc_is_public (tree, tree);
1151
1152 /* In c-ppoutput.c  */
1153 extern void init_pp_output (FILE *);
1154 extern void preprocess_file (cpp_reader *);
1155 extern void pp_file_change (const struct line_map *);
1156 extern void pp_dir_change (cpp_reader *, const char *);
1157
1158 #endif /* ! GCC_C_COMMON_H */