gcc/c-family/c-common.h

   1 /* Definitions for c-common.c.
   2    Copyright (C) 1987-2018 Free Software Foundation, Inc.
   3
   4 This file is part of GCC.
   5
   6 GCC is free software; you can redistribute it and/or modify it under
   7 the terms of the GNU General Public License as published by the Free
   8 Software Foundation; either version 3, or (at your option) any later
   9 version.
  10
  11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14 for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GCC; see the file COPYING3.  If not see
  18 <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef GCC_C_COMMON_H
  21 #define GCC_C_COMMON_H
  22
  23 #include "splay-tree.h"
  24 #include "cpplib.h"
  25 #include "alias.h"
  26 #include "tree.h"
  27 #include "fold-const.h"
  28 #include "wide-int-bitmask.h"
  29
  30 /* In order for the format checking to accept the C frontend
  31    diagnostic framework extensions, you must include this file before
  32    diagnostic-core.h, not after.  The C front end formats are a subset of those
  33    for C++, so they are the appropriate set to use in common code;
  34    cp-tree.h overrides this for C++.  */
  35 #if defined(GCC_DIAGNOSTIC_CORE_H)
  36 #error \
  37 In order for the format checking to accept the C front end diagnostic \
  38 framework extensions, you must include this file before diagnostic-core.h \
  39 never after.
  40 #endif
  41 #ifndef GCC_DIAG_STYLE
  42 #define GCC_DIAG_STYLE __gcc_cdiag__
  43 #endif
  44 #include "diagnostic-core.h"
  45
  46 /* Usage of TREE_LANG_FLAG_?:
  47    0: IDENTIFIER_MARKED (used by search routines).
  48       C_MAYBE_CONST_EXPR_INT_OPERANDS (in C_MAYBE_CONST_EXPR, for C)
  49    1: C_DECLARED_LABEL_FLAG (in LABEL_DECL)
  50       STATEMENT_LIST_STMT_EXPR (in STATEMENT_LIST)
  51       C_MAYBE_CONST_EXPR_NON_CONST (in C_MAYBE_CONST_EXPR, for C)
  52    2: unused
  53    3: STATEMENT_LIST_HAS_LABEL (in STATEMENT_LIST)
  54    4: unused
  55 */
  56
  57 /* Reserved identifiers.  This is the union of all the keywords for C,
  58    C++, and Objective-C.  All the type modifiers have to be in one
  59    block at the beginning, because they are used as mask bits.  There
  60    are 28 type modifiers; if we add many more we will have to redesign
  61    the mask mechanism.  */
  62
  63 enum rid
  64 {
  65   /* Modifiers: */
  66   /* C, in empirical order of frequency.  */
  67   RID_STATIC = 0,
  68   RID_UNSIGNED, RID_LONG,    RID_CONST, RID_EXTERN,
  69   RID_REGISTER, RID_TYPEDEF, RID_SHORT, RID_INLINE,
  70   RID_VOLATILE, RID_SIGNED,  RID_AUTO,  RID_RESTRICT,
  71   RID_NORETURN, RID_ATOMIC,
  72
  73   /* C extensions */
  74   RID_COMPLEX, RID_THREAD, RID_SAT,
  75
  76   /* C++ */
  77   RID_FRIEND, RID_VIRTUAL, RID_EXPLICIT, RID_EXPORT, RID_MUTABLE,
  78
  79   /* ObjC ("PQ" reserved words - they do not appear after a '@' and
  80      are keywords only in specific contexts)  */
  81   RID_IN, RID_OUT, RID_INOUT, RID_BYCOPY, RID_BYREF, RID_ONEWAY,
  82
  83   /* ObjC ("PATTR" reserved words - they do not appear after a '@'
  84      and are keywords only as property attributes)  */
  85   RID_GETTER, RID_SETTER,
  86   RID_READONLY, RID_READWRITE,
  87   RID_ASSIGN, RID_RETAIN, RID_COPY,
  88   RID_NONATOMIC,
  89
  90   /* C (reserved and imaginary types not implemented, so any use is a
  91      syntax error) */
  92   RID_IMAGINARY,
  93
  94   /* C */
  95   RID_INT,     RID_CHAR,   RID_FLOAT,    RID_DOUBLE, RID_VOID,
  96   RID_ENUM,    RID_STRUCT, RID_UNION,    RID_IF,     RID_ELSE,
  97   RID_WHILE,   RID_DO,     RID_FOR,      RID_SWITCH, RID_CASE,
  98   RID_DEFAULT, RID_BREAK,  RID_CONTINUE, RID_RETURN, RID_GOTO,
  99   RID_SIZEOF,
 100
 101   /* C extensions */
 102   RID_ASM,       RID_TYPEOF,   RID_ALIGNOF,  RID_ATTRIBUTE,  RID_VA_ARG,
 103   RID_EXTENSION, RID_IMAGPART, RID_REALPART, RID_LABEL,      RID_CHOOSE_EXPR,
 104   RID_TYPES_COMPATIBLE_P,      RID_BUILTIN_COMPLEX,          RID_BUILTIN_SHUFFLE,
 105   RID_BUILTIN_TGMATH,
 106   RID_DFLOAT32, RID_DFLOAT64, RID_DFLOAT128,
 107
 108   /* TS 18661-3 keywords, in the same sequence as the TI_* values.  */
 109   RID_FLOAT16,
 110   RID_FLOATN_NX_FIRST = RID_FLOAT16,
 111   RID_FLOAT32,
 112   RID_FLOAT64,
 113   RID_FLOAT128,
 114   RID_FLOAT32X,
 115   RID_FLOAT64X,
 116   RID_FLOAT128X,
 117 #define CASE_RID_FLOATN_NX                                              \
 118   case RID_FLOAT16: case RID_FLOAT32: case RID_FLOAT64: case RID_FLOAT128: \
 119   case RID_FLOAT32X: case RID_FLOAT64X: case RID_FLOAT128X
 120
 121   RID_FRACT, RID_ACCUM, RID_AUTO_TYPE, RID_BUILTIN_CALL_WITH_STATIC_CHAIN,
 122
 123   /* "__GIMPLE", for the GIMPLE-parsing extension to the C frontend. */
 124   RID_GIMPLE,
 125
 126   /* "__PHI", for parsing PHI function in GIMPLE FE.  */
 127   RID_PHI,
 128
 129   /* "__RTL", for the RTL-parsing extension to the C frontend.  */
 130   RID_RTL,
 131
 132   /* C11 */
 133   RID_ALIGNAS, RID_GENERIC,
 134
 135   /* This means to warn that this is a C++ keyword, and then treat it
 136      as a normal identifier.  */
 137   RID_CXX_COMPAT_WARN,
 138
 139   /* GNU transactional memory extension */
 140   RID_TRANSACTION_ATOMIC, RID_TRANSACTION_RELAXED, RID_TRANSACTION_CANCEL,
 141
 142   /* Too many ways of getting the name of a function as a string */
 143   RID_FUNCTION_NAME, RID_PRETTY_FUNCTION_NAME, RID_C99_FUNCTION_NAME,
 144
 145   /* C++ (some of these are keywords in Objective-C as well, but only
 146      if they appear after a '@') */
 147   RID_BOOL,     RID_WCHAR,    RID_CLASS,
 148   RID_PUBLIC,   RID_PRIVATE,  RID_PROTECTED,
 149   RID_TEMPLATE, RID_NULL,     RID_CATCH,
 150   RID_DELETE,   RID_FALSE,    RID_NAMESPACE,
 151   RID_NEW,      RID_OFFSETOF, RID_OPERATOR,
 152   RID_THIS,     RID_THROW,    RID_TRUE,
 153   RID_TRY,      RID_TYPENAME, RID_TYPEID,
 154   RID_USING,    RID_CHAR16,   RID_CHAR32,
 155
 156   /* casts */
 157   RID_CONSTCAST, RID_DYNCAST, RID_REINTCAST, RID_STATCAST,
 158
 159   /* C++ extensions */
 160   RID_ADDRESSOF,               RID_BASES,
 161   RID_BUILTIN_LAUNDER,         RID_DIRECT_BASES,
 162   RID_HAS_NOTHROW_ASSIGN,      RID_HAS_NOTHROW_CONSTRUCTOR,
 163   RID_HAS_NOTHROW_COPY,        RID_HAS_TRIVIAL_ASSIGN,
 164   RID_HAS_TRIVIAL_CONSTRUCTOR, RID_HAS_TRIVIAL_COPY,
 165   RID_HAS_TRIVIAL_DESTRUCTOR,  RID_HAS_UNIQUE_OBJ_REPRESENTATIONS,
 166   RID_HAS_VIRTUAL_DESTRUCTOR,
 167   RID_IS_ABSTRACT,             RID_IS_AGGREGATE,
 168   RID_IS_BASE_OF,              RID_IS_CLASS,
 169   RID_IS_EMPTY,                RID_IS_ENUM,
 170   RID_IS_FINAL,                RID_IS_LITERAL_TYPE,
 171   RID_IS_POD,                  RID_IS_POLYMORPHIC,
 172   RID_IS_SAME_AS,
 173   RID_IS_STD_LAYOUT,           RID_IS_TRIVIAL,
 174   RID_IS_TRIVIALLY_ASSIGNABLE, RID_IS_TRIVIALLY_CONSTRUCTIBLE,
 175   RID_IS_TRIVIALLY_COPYABLE,
 176   RID_IS_UNION,                RID_UNDERLYING_TYPE,
 177   RID_IS_ASSIGNABLE,           RID_IS_CONSTRUCTIBLE,
 178
 179   /* C++11 */
 180   RID_CONSTEXPR, RID_DECLTYPE, RID_NOEXCEPT, RID_NULLPTR, RID_STATIC_ASSERT,
 181
 182   /* C++ concepts */
 183   RID_CONCEPT, RID_REQUIRES,
 184
 185   /* C++ transactional memory.  */
 186   RID_ATOMIC_NOEXCEPT, RID_ATOMIC_CANCEL, RID_SYNCHRONIZED,
 187
 188   /* Objective-C ("AT" reserved words - they are only keywords when
 189      they follow '@')  */
 190   RID_AT_ENCODE,   RID_AT_END,
 191   RID_AT_CLASS,    RID_AT_ALIAS,     RID_AT_DEFS,
 192   RID_AT_PRIVATE,  RID_AT_PROTECTED, RID_AT_PUBLIC,  RID_AT_PACKAGE,
 193   RID_AT_PROTOCOL, RID_AT_SELECTOR,
 194   RID_AT_THROW,    RID_AT_TRY,       RID_AT_CATCH,
 195   RID_AT_FINALLY,  RID_AT_SYNCHRONIZED,
 196   RID_AT_OPTIONAL, RID_AT_REQUIRED, RID_AT_PROPERTY,
 197   RID_AT_SYNTHESIZE, RID_AT_DYNAMIC,
 198   RID_AT_INTERFACE,
 199   RID_AT_IMPLEMENTATION,
 200
 201   /* Named address support, mapping the keyword to a particular named address
 202      number.  Named address space 0 is reserved for the generic address.  If
 203      there are more than 254 named addresses, the addr_space_t type will need
 204      to be grown from an unsigned char to unsigned short.  */
 205   RID_ADDR_SPACE_0,             /* generic address */
 206   RID_ADDR_SPACE_1,
 207   RID_ADDR_SPACE_2,
 208   RID_ADDR_SPACE_3,
 209   RID_ADDR_SPACE_4,
 210   RID_ADDR_SPACE_5,
 211   RID_ADDR_SPACE_6,
 212   RID_ADDR_SPACE_7,
 213   RID_ADDR_SPACE_8,
 214   RID_ADDR_SPACE_9,
 215   RID_ADDR_SPACE_10,
 216   RID_ADDR_SPACE_11,
 217   RID_ADDR_SPACE_12,
 218   RID_ADDR_SPACE_13,
 219   RID_ADDR_SPACE_14,
 220   RID_ADDR_SPACE_15,
 221
 222   RID_FIRST_ADDR_SPACE = RID_ADDR_SPACE_0,
 223   RID_LAST_ADDR_SPACE = RID_ADDR_SPACE_15,
 224
 225   /* __intN keywords.  The _N_M here doesn't correspond to the intN
 226      in the keyword; use the bitsize in int_n_t_data_t[M] for that.
 227      For example, if int_n_t_data_t[0].bitsize is 13, then RID_INT_N_0
 228      is for __int13.  */
 229
 230   /* Note that the range to use is RID_FIRST_INT_N through
 231      RID_FIRST_INT_N + NUM_INT_N_ENTS - 1 and c-parser.c has a list of
 232      all RID_INT_N_* in a case statement.  */
 233
 234   RID_INT_N_0,
 235   RID_INT_N_1,
 236   RID_INT_N_2,
 237   RID_INT_N_3,
 238
 239   RID_FIRST_INT_N = RID_INT_N_0,
 240   RID_LAST_INT_N = RID_INT_N_3,
 241
 242   RID_MAX,
 243
 244   RID_FIRST_MODIFIER = RID_STATIC,
 245   RID_LAST_MODIFIER = RID_ONEWAY,
 246
 247   RID_FIRST_CXX11 = RID_CONSTEXPR,
 248   RID_LAST_CXX11 = RID_STATIC_ASSERT,
 249   RID_FIRST_AT = RID_AT_ENCODE,
 250   RID_LAST_AT = RID_AT_IMPLEMENTATION,
 251   RID_FIRST_PQ = RID_IN,
 252   RID_LAST_PQ = RID_ONEWAY,
 253   RID_FIRST_PATTR = RID_GETTER,
 254   RID_LAST_PATTR = RID_NONATOMIC
 255 };
 256
 257 #define OBJC_IS_AT_KEYWORD(rid) \
 258   ((unsigned int) (rid) >= (unsigned int) RID_FIRST_AT && \
 259    (unsigned int) (rid) <= (unsigned int) RID_LAST_AT)
 260
 261 #define OBJC_IS_PQ_KEYWORD(rid) \
 262   ((unsigned int) (rid) >= (unsigned int) RID_FIRST_PQ && \
 263    (unsigned int) (rid) <= (unsigned int) RID_LAST_PQ)
 264
 265 #define OBJC_IS_PATTR_KEYWORD(rid) \
 266   ((unsigned int) (rid) >= (unsigned int) RID_FIRST_PATTR && \
 267    (unsigned int) (rid) <= (unsigned int) RID_LAST_PATTR)
 268
 269 /* OBJC_IS_CXX_KEYWORD recognizes the 'CXX_OBJC' keywords (such as
 270    'class') which are shared in a subtle way between Objective-C and
 271    C++.  When the lexer is lexing in Objective-C/Objective-C++, if it
 272    finds '@' followed by one of these identifiers (eg, '@class'), it
 273    recognizes the whole as an Objective-C keyword.  If the identifier
 274    is found elsewhere, it follows the rules of the C/C++ language.
 275  */
 276 #define OBJC_IS_CXX_KEYWORD(rid) \
 277   (rid == RID_CLASS || rid == RID_SYNCHRONIZED                  \
 278    || rid == RID_PUBLIC || rid == RID_PROTECTED || rid == RID_PRIVATE   \
 279    || rid == RID_TRY || rid == RID_THROW || rid == RID_CATCH)
 280
 281 /* The elements of `ridpointers' are identifier nodes for the reserved
 282    type names and storage classes.  It is indexed by a RID_... value.  */
 283 extern GTY ((length ("(int) RID_MAX"))) tree *ridpointers;
 284
 285 /* Standard named or nameless data types of the C compiler.  */
 286
 287 enum c_tree_index
 288 {
 289     CTI_CHAR16_TYPE,
 290     CTI_CHAR32_TYPE,
 291     CTI_WCHAR_TYPE,
 292     CTI_UNDERLYING_WCHAR_TYPE,
 293     CTI_WINT_TYPE,
 294     CTI_SIGNED_SIZE_TYPE, /* For format checking only.  */
 295     CTI_UNSIGNED_PTRDIFF_TYPE, /* For format checking only.  */
 296     CTI_INTMAX_TYPE,
 297     CTI_UINTMAX_TYPE,
 298     CTI_WIDEST_INT_LIT_TYPE,
 299     CTI_WIDEST_UINT_LIT_TYPE,
 300
 301     /* Types for <stdint.h>, that may not be defined on all
 302        targets.  */
 303     CTI_SIG_ATOMIC_TYPE,
 304     CTI_INT8_TYPE,
 305     CTI_INT16_TYPE,
 306     CTI_INT32_TYPE,
 307     CTI_INT64_TYPE,
 308     CTI_UINT8_TYPE,
 309     CTI_UINT16_TYPE,
 310     CTI_UINT32_TYPE,
 311     CTI_UINT64_TYPE,
 312     CTI_INT_LEAST8_TYPE,
 313     CTI_INT_LEAST16_TYPE,
 314     CTI_INT_LEAST32_TYPE,
 315     CTI_INT_LEAST64_TYPE,
 316     CTI_UINT_LEAST8_TYPE,
 317     CTI_UINT_LEAST16_TYPE,
 318     CTI_UINT_LEAST32_TYPE,
 319     CTI_UINT_LEAST64_TYPE,
 320     CTI_INT_FAST8_TYPE,
 321     CTI_INT_FAST16_TYPE,
 322     CTI_INT_FAST32_TYPE,
 323     CTI_INT_FAST64_TYPE,
 324     CTI_UINT_FAST8_TYPE,
 325     CTI_UINT_FAST16_TYPE,
 326     CTI_UINT_FAST32_TYPE,
 327     CTI_UINT_FAST64_TYPE,
 328     CTI_INTPTR_TYPE,
 329     CTI_UINTPTR_TYPE,
 330
 331     CTI_CHAR_ARRAY_TYPE,
 332     CTI_CHAR16_ARRAY_TYPE,
 333     CTI_CHAR32_ARRAY_TYPE,
 334     CTI_WCHAR_ARRAY_TYPE,
 335     CTI_STRING_TYPE,
 336     CTI_CONST_STRING_TYPE,
 337
 338     /* Type for boolean expressions (bool in C++, int in C).  */
 339     CTI_TRUTHVALUE_TYPE,
 340     CTI_TRUTHVALUE_TRUE,
 341     CTI_TRUTHVALUE_FALSE,
 342
 343     CTI_DEFAULT_FUNCTION_TYPE,
 344
 345     /* These are not types, but we have to look them up all the time.  */
 346     CTI_FUNCTION_NAME_DECL,
 347     CTI_PRETTY_FUNCTION_NAME_DECL,
 348     CTI_C99_FUNCTION_NAME_DECL,
 349     CTI_SAVED_FUNCTION_NAME_DECLS,
 350
 351     CTI_NULL,
 352
 353     CTI_MAX
 354 };
 355
 356 #define C_CPP_HASHNODE(id) \
 357   (&(((struct c_common_identifier *) (id))->node))
 358 #define C_RID_CODE(id) \
 359   ((enum rid) (((struct c_common_identifier *) (id))->node.rid_code))
 360 #define C_SET_RID_CODE(id, code) \
 361   (((struct c_common_identifier *) (id))->node.rid_code = (unsigned char) code)
 362
 363 /* Identifier part common to the C front ends.  Inherits from
 364    tree_identifier, despite appearances.  */
 365 struct GTY(()) c_common_identifier {
 366   struct tree_common common;
 367   struct cpp_hashnode node;
 368 };
 369
 370 /* An entry in the reserved keyword table.  */
 371
 372 struct c_common_resword
 373 {
 374   const char *const word;
 375   ENUM_BITFIELD(rid) const rid : 16;
 376   const unsigned int disable   : 16;
 377 };
 378
 379 /* Mode used to build pointers (VOIDmode means ptr_mode).  */
 380
 381 extern machine_mode c_default_pointer_mode;
 382
 383 /* Extra cpp_ttype values for C++.  */
 384
 385 /* A token type for template-ids.  If a template-id is processed while
 386    parsing tentatively, it is replaced with a CPP_TEMPLATE_ID token;
 387    the value of the CPP_TEMPLATE_ID is whatever was returned by
 388    cp_parser_template_id.  */
 389 #define CPP_TEMPLATE_ID ((enum cpp_ttype) (CPP_KEYWORD + 1))
 390
 391 /* A token type for nested-name-specifiers.  If a
 392    nested-name-specifier is processed while parsing tentatively, it is
 393    replaced with a CPP_NESTED_NAME_SPECIFIER token; the value of the
 394    CPP_NESTED_NAME_SPECIFIER is whatever was returned by
 395    cp_parser_nested_name_specifier_opt.  */
 396 #define CPP_NESTED_NAME_SPECIFIER ((enum cpp_ttype) (CPP_TEMPLATE_ID + 1))
 397
 398 /* A token type for pre-parsed C++0x decltype.  */
 399 #define CPP_DECLTYPE ((enum cpp_ttype) (CPP_NESTED_NAME_SPECIFIER + 1))
 400
 401 /* A token type for pre-parsed primary-expression (lambda- or statement-).  */
 402 #define CPP_PREPARSED_EXPR ((enum cpp_ttype) (CPP_DECLTYPE + 1))
 403
 404 /* The number of token types, including C++-specific ones.  */
 405 #define N_CP_TTYPES ((int) (CPP_PREPARSED_EXPR + 1))
 406
 407 /* Disable mask.  Keywords are disabled if (reswords[i].disable &
 408    mask) is _true_.  Thus for keywords which are present in all
 409    languages the disable field is zero.  */
 410
 411 #define D_CONLY         0x001   /* C only (not in C++).  */
 412 #define D_CXXONLY       0x002   /* C++ only (not in C).  */
 413 #define D_C99           0x004   /* In C, C99 only.  */
 414 #define D_CXX11         0x008   /* In C++, C++11 only.  */
 415 #define D_EXT           0x010   /* GCC extension.  */
 416 #define D_EXT89         0x020   /* GCC extension incorporated in C99.  */
 417 #define D_ASM           0x040   /* Disabled by -fno-asm.  */
 418 #define D_OBJC          0x080   /* In Objective C and neither C nor C++.  */
 419 #define D_CXX_OBJC      0x100   /* In Objective C, and C++, but not C.  */
 420 #define D_CXXWARN       0x200   /* In C warn with -Wcxx-compat.  */
 421 #define D_CXX_CONCEPTS  0x400   /* In C++, only with concepts. */
 422 #define D_TRANSMEM      0X800   /* C++ transactional memory TS.  */
 423
 424 #define D_CXX_CONCEPTS_FLAGS D_CXXONLY | D_CXX_CONCEPTS
 425
 426 /* The reserved keyword table.  */
 427 extern const struct c_common_resword c_common_reswords[];
 428
 429 /* The number of items in the reserved keyword table.  */
 430 extern const unsigned int num_c_common_reswords;
 431
 432 #define char16_type_node                c_global_trees[CTI_CHAR16_TYPE]
 433 #define char32_type_node                c_global_trees[CTI_CHAR32_TYPE]
 434 #define wchar_type_node                 c_global_trees[CTI_WCHAR_TYPE]
 435 #define underlying_wchar_type_node      c_global_trees[CTI_UNDERLYING_WCHAR_TYPE]
 436 #define wint_type_node                  c_global_trees[CTI_WINT_TYPE]
 437 #define signed_size_type_node           c_global_trees[CTI_SIGNED_SIZE_TYPE]
 438 #define unsigned_ptrdiff_type_node      c_global_trees[CTI_UNSIGNED_PTRDIFF_TYPE]
 439 #define intmax_type_node                c_global_trees[CTI_INTMAX_TYPE]
 440 #define uintmax_type_node               c_global_trees[CTI_UINTMAX_TYPE]
 441 #define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
 442 #define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
 443
 444 #define sig_atomic_type_node            c_global_trees[CTI_SIG_ATOMIC_TYPE]
 445 #define int8_type_node                  c_global_trees[CTI_INT8_TYPE]
 446 #define int16_type_node                 c_global_trees[CTI_INT16_TYPE]
 447 #define int32_type_node                 c_global_trees[CTI_INT32_TYPE]
 448 #define int64_type_node                 c_global_trees[CTI_INT64_TYPE]
 449 #define uint8_type_node                 c_global_trees[CTI_UINT8_TYPE]
 450 #define c_uint16_type_node              c_global_trees[CTI_UINT16_TYPE]
 451 #define c_uint32_type_node              c_global_trees[CTI_UINT32_TYPE]
 452 #define c_uint64_type_node              c_global_trees[CTI_UINT64_TYPE]
 453 #define int_least8_type_node            c_global_trees[CTI_INT_LEAST8_TYPE]
 454 #define int_least16_type_node           c_global_trees[CTI_INT_LEAST16_TYPE]
 455 #define int_least32_type_node           c_global_trees[CTI_INT_LEAST32_TYPE]
 456 #define int_least64_type_node           c_global_trees[CTI_INT_LEAST64_TYPE]
 457 #define uint_least8_type_node           c_global_trees[CTI_UINT_LEAST8_TYPE]
 458 #define uint_least16_type_node          c_global_trees[CTI_UINT_LEAST16_TYPE]
 459 #define uint_least32_type_node          c_global_trees[CTI_UINT_LEAST32_TYPE]
 460 #define uint_least64_type_node          c_global_trees[CTI_UINT_LEAST64_TYPE]
 461 #define int_fast8_type_node             c_global_trees[CTI_INT_FAST8_TYPE]
 462 #define int_fast16_type_node            c_global_trees[CTI_INT_FAST16_TYPE]
 463 #define int_fast32_type_node            c_global_trees[CTI_INT_FAST32_TYPE]
 464 #define int_fast64_type_node            c_global_trees[CTI_INT_FAST64_TYPE]
 465 #define uint_fast8_type_node            c_global_trees[CTI_UINT_FAST8_TYPE]
 466 #define uint_fast16_type_node           c_global_trees[CTI_UINT_FAST16_TYPE]
 467 #define uint_fast32_type_node           c_global_trees[CTI_UINT_FAST32_TYPE]
 468 #define uint_fast64_type_node           c_global_trees[CTI_UINT_FAST64_TYPE]
 469 #define intptr_type_node                c_global_trees[CTI_INTPTR_TYPE]
 470 #define uintptr_type_node               c_global_trees[CTI_UINTPTR_TYPE]
 471
 472 #define truthvalue_type_node            c_global_trees[CTI_TRUTHVALUE_TYPE]
 473 #define truthvalue_true_node            c_global_trees[CTI_TRUTHVALUE_TRUE]
 474 #define truthvalue_false_node           c_global_trees[CTI_TRUTHVALUE_FALSE]
 475
 476 #define char_array_type_node            c_global_trees[CTI_CHAR_ARRAY_TYPE]
 477 #define char16_array_type_node          c_global_trees[CTI_CHAR16_ARRAY_TYPE]
 478 #define char32_array_type_node          c_global_trees[CTI_CHAR32_ARRAY_TYPE]
 479 #define wchar_array_type_node           c_global_trees[CTI_WCHAR_ARRAY_TYPE]
 480 #define string_type_node                c_global_trees[CTI_STRING_TYPE]
 481 #define const_string_type_node          c_global_trees[CTI_CONST_STRING_TYPE]
 482
 483 #define default_function_type           c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
 484
 485 #define function_name_decl_node         c_global_trees[CTI_FUNCTION_NAME_DECL]
 486 #define pretty_function_name_decl_node  c_global_trees[CTI_PRETTY_FUNCTION_NAME_DECL]
 487 #define c99_function_name_decl_node             c_global_trees[CTI_C99_FUNCTION_NAME_DECL]
 488 #define saved_function_name_decls       c_global_trees[CTI_SAVED_FUNCTION_NAME_DECLS]
 489
 490 /* The node for C++ `__null'.  */
 491 #define null_node                       c_global_trees[CTI_NULL]
 492
 493 extern GTY(()) tree c_global_trees[CTI_MAX];
 494
 495 /* Mark which labels are explicitly declared.
 496    These may be shadowed, and may be referenced from nested functions.  */
 497 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
 498
 499 enum c_language_kind
 500 {
 501   clk_c         = 0,            /* C90, C94, C99 or C11 */
 502   clk_objc      = 1,            /* clk_c with ObjC features.  */
 503   clk_cxx       = 2,            /* ANSI/ISO C++ */
 504   clk_objcxx    = 3             /* clk_cxx with ObjC features.  */
 505 };
 506
 507 /* To test for a specific language use c_language, defined by each
 508    front end.  For "ObjC features" or "not C++" use the macros.  */
 509 extern c_language_kind c_language;
 510
 511 #define c_dialect_cxx()         ((c_language & clk_cxx) != 0)
 512 #define c_dialect_objc()        ((c_language & clk_objc) != 0)
 513
 514 /* The various name of operator that appears in error messages. */
 515 enum ref_operator {
 516   /* NULL */
 517   RO_NULL,
 518   /* array indexing */
 519   RO_ARRAY_INDEXING,
 520   /* unary * */
 521   RO_UNARY_STAR,
 522   /* -> */
 523   RO_ARROW,
 524   /* implicit conversion */
 525   RO_IMPLICIT_CONVERSION,
 526   /* ->* */
 527   RO_ARROW_STAR
 528 };
 529
 530 /* Information about a statement tree.  */
 531
 532 struct GTY(()) stmt_tree_s {
 533   /* A stack of statement lists being collected.  */
 534   vec<tree, va_gc> *x_cur_stmt_list;
 535
 536   /* In C++, Nonzero if we should treat statements as full
 537      expressions.  In particular, this variable is non-zero if at the
 538      end of a statement we should destroy any temporaries created
 539      during that statement.  Similarly, if, at the end of a block, we
 540      should destroy any local variables in this block.  Normally, this
 541      variable is nonzero, since those are the normal semantics of
 542      C++.
 543
 544      This flag has no effect in C.  */
 545   int stmts_are_full_exprs_p;
 546 };
 547
 548 typedef struct stmt_tree_s *stmt_tree;
 549
 550 /* Global state pertinent to the current function.  Some C dialects
 551    extend this structure with additional fields.  */
 552
 553 struct GTY(()) c_language_function {
 554   /* While we are parsing the function, this contains information
 555      about the statement-tree that we are building.  */
 556   struct stmt_tree_s x_stmt_tree;
 557
 558   /* Vector of locally defined typedefs, for
 559      -Wunused-local-typedefs.  */
 560   vec<tree, va_gc> *local_typedefs;
 561 };
 562
 563 #define stmt_list_stack (current_stmt_tree ()->x_cur_stmt_list)
 564
 565 /* When building a statement-tree, this is the current statement list
 566    being collected.  */
 567 #define cur_stmt_list   (stmt_list_stack->last ())
 568
 569 #define building_stmt_list_p() (stmt_list_stack && !stmt_list_stack->is_empty())
 570
 571 /* Language-specific hooks.  */
 572
 573 /* If non-NULL, this function is called after a precompile header file
 574    is loaded.  */
 575 extern void (*lang_post_pch_load) (void);
 576
 577 extern void push_file_scope (void);
 578 extern void pop_file_scope (void);
 579 extern stmt_tree current_stmt_tree (void);
 580 extern tree push_stmt_list (void);
 581 extern tree pop_stmt_list (tree);
 582 extern tree add_stmt (tree);
 583 extern void push_cleanup (tree, tree, bool);
 584
 585 extern tree build_modify_expr (location_t, tree, tree, enum tree_code,
 586                                location_t, tree, tree);
 587 extern tree build_indirect_ref (location_t, tree, ref_operator);
 588
 589 extern bool has_c_linkage (const_tree decl);
 590 extern bool c_decl_implicit (const_tree);
 591 \f
 592 /* Switches common to the C front ends.  */
 593
 594 /* Nonzero means don't output line number information.  */
 595
 596 extern char flag_no_line_commands;
 597
 598 /* Nonzero causes -E output not to be done, but directives such as
 599    #define that have side effects are still obeyed.  */
 600
 601 extern char flag_no_output;
 602
 603 /* Nonzero means dump macros in some fashion; contains the 'D', 'M',
 604    'N' or 'U' of the command line switch.  */
 605
 606 extern char flag_dump_macros;
 607
 608 /* Nonzero means pass #include lines through to the output.  */
 609
 610 extern char flag_dump_includes;
 611
 612 /* Nonzero means process PCH files while preprocessing.  */
 613
 614 extern bool flag_pch_preprocess;
 615
 616 /* The file name to which we should write a precompiled header, or
 617    NULL if no header will be written in this compile.  */
 618
 619 extern const char *pch_file;
 620
 621 /* Nonzero if an ISO standard was selected.  It rejects macros in the
 622    user's namespace.  */
 623
 624 extern int flag_iso;
 625
 626 /* C/ObjC language option variables.  */
 627
 628
 629 /* Nonzero means allow type mismatches in conditional expressions;
 630    just make their values `void'.  */
 631
 632 extern int flag_cond_mismatch;
 633
 634 /* Nonzero means enable C89 Amendment 1 features.  */
 635
 636 extern int flag_isoc94;
 637
 638 /* Nonzero means use the ISO C99 (or C11) dialect of C.  */
 639
 640 extern int flag_isoc99;
 641
 642 /* Nonzero means use the ISO C11 dialect of C.  */
 643
 644 extern int flag_isoc11;
 645
 646 /* Nonzero means that we have builtin functions, and main is an int.  */
 647
 648 extern int flag_hosted;
 649
 650 /* ObjC language option variables.  */
 651
 652
 653 /* Tells the compiler that this is a special run.  Do not perform any
 654    compiling, instead we are to test some platform dependent features
 655    and output a C header file with appropriate definitions.  */
 656
 657 extern int print_struct_values;
 658
 659 /* Tells the compiler what is the constant string class for ObjC.  */
 660
 661 extern const char *constant_string_class_name;
 662
 663
 664 /* C++ language option variables.  */
 665
 666 /* The reference version of the ABI for -Wabi.  */
 667
 668 extern int warn_abi_version;
 669
 670 /* Return TRUE if one of {flag_abi_version,flag_abi_compat_version} is
 671    less than N and the other is at least N.  */
 672 #define abi_compat_version_crosses(N)           \
 673   (abi_version_at_least(N)                      \
 674    != (flag_abi_compat_version == 0             \
 675        || flag_abi_compat_version >= (N)))
 676
 677 /* Return TRUE if one of {flag_abi_version,warn_abi_version} is
 678    less than N and the other is at least N, for use by -Wabi.  */
 679 #define abi_version_crosses(N)                  \
 680   (abi_version_at_least(N)                      \
 681    != (warn_abi_version == 0                    \
 682        || warn_abi_version >= (N)))
 683
 684 /* Nonzero means generate separate instantiation control files and
 685    juggle them at link time.  */
 686
 687 extern int flag_use_repository;
 688
 689 /* The supported C++ dialects.  */
 690
 691 enum cxx_dialect {
 692   cxx_unset,
 693   /* C++98 with TC1  */
 694   cxx98,
 695   cxx03 = cxx98,
 696   /* C++11  */
 697   cxx0x,
 698   cxx11 = cxx0x,
 699   /* C++14 */
 700   cxx14,
 701   /* C++17 */
 702   cxx17,
 703   /* C++2a (C++20?) */
 704   cxx2a
 705 };
 706
 707 /* The C++ dialect being used. C++98 is the default.  */
 708 extern enum cxx_dialect cxx_dialect;
 709
 710 /* Maximum template instantiation depth.  This limit is rather
 711    arbitrary, but it exists to limit the time it takes to notice
 712    excessively recursive template instantiations.  */
 713
 714 extern int max_tinst_depth;
 715
 716 /* Nonzero means that we should not issue warnings about problems that
 717    occur when the code is executed, because the code being processed
 718    is not expected to be executed.  This is set during parsing.  This
 719    is used for cases like sizeof() and "0 ? a : b".  This is a count,
 720    not a bool, because unexecuted expressions can nest.  */
 721
 722 extern int c_inhibit_evaluation_warnings;
 723
 724 /* Whether lexing has been completed, so subsequent preprocessor
 725    errors should use the compiler's input_location.  */
 726
 727 extern bool done_lexing;
 728
 729 /* C types are partitioned into three subsets: object, function, and
 730    incomplete types.  */
 731 #define C_TYPE_OBJECT_P(type) \
 732   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
 733
 734 #define C_TYPE_INCOMPLETE_P(type) \
 735   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
 736
 737 #define C_TYPE_FUNCTION_P(type) \
 738   (TREE_CODE (type) == FUNCTION_TYPE)
 739
 740 /* For convenience we define a single macro to identify the class of
 741    object or incomplete types.  */
 742 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
 743   (!C_TYPE_FUNCTION_P (type))
 744
 745 struct visibility_flags
 746 {
 747   unsigned inpragma : 1;        /* True when in #pragma GCC visibility.  */
 748   unsigned inlines_hidden : 1;  /* True when -finlineshidden in effect.  */
 749 };
 750
 751 /* These enumerators are possible types of unsafe conversions.  */
 752 enum conversion_safety {
 753   /* The conversion is safe.  */
 754   SAFE_CONVERSION = 0,
 755   /* Another type of conversion with problems.  */
 756   UNSAFE_OTHER,
 757   /* Conversion between signed and unsigned integers
 758      which are all warned about immediately, so this is unused.  */
 759   UNSAFE_SIGN,
 760   /* Conversions that reduce the precision of reals including conversions
 761      from reals to integers.  */
 762   UNSAFE_REAL,
 763   /* Conversions from complex to reals or integers, that discard imaginary
 764      component.  */
 765   UNSAFE_IMAGINARY
 766 };
 767
 768 /* Global visibility options.  */
 769 extern struct visibility_flags visibility_options;
 770
 771 /* Attribute table common to the C front ends.  */
 772 extern const struct attribute_spec c_common_attribute_table[];
 773 extern const struct attribute_spec c_common_format_attribute_table[];
 774
 775 /* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
 776    ID is the identifier to use, NAME is the string.
 777    TYPE_DEP indicates whether it depends on type of the function or not
 778    (i.e. __PRETTY_FUNCTION__).  */
 779
 780 extern tree (*make_fname_decl) (location_t, tree, int);
 781
 782 /* In c-decl.c and cp/tree.c.  FIXME.  */
 783 extern void c_register_addr_space (const char *str, addr_space_t as);
 784
 785 /* In c-common.c.  */
 786 extern bool in_late_binary_op;
 787 extern const char *c_addr_space_name (addr_space_t as);
 788 extern tree identifier_global_value (tree);
 789 extern tree c_linkage_bindings (tree);
 790 extern void record_builtin_type (enum rid, const char *, tree);
 791 extern tree build_void_list_node (void);
 792 extern void start_fname_decls (void);
 793 extern void finish_fname_decls (void);
 794 extern const char *fname_as_string (int);
 795 extern tree fname_decl (location_t, unsigned, tree);
 796
 797 extern int check_user_alignment (const_tree, bool);
 798 extern bool check_function_arguments (location_t loc, const_tree, const_tree,
 799                                       int, tree *, vec<location_t> *);
 800 extern void check_function_arguments_recurse (void (*)
 801                                               (void *, tree,
 802                                                unsigned HOST_WIDE_INT),
 803                                               void *, tree,
 804                                               unsigned HOST_WIDE_INT);
 805 extern bool check_builtin_function_arguments (location_t, vec<location_t>,
 806                                               tree, int, tree *);
 807 extern void check_function_format (tree, int, tree *, vec<location_t> *);
 808 extern bool attribute_fallthrough_p (tree);
 809 extern tree handle_format_attribute (tree *, tree, tree, int, bool *);
 810 extern tree handle_format_arg_attribute (tree *, tree, tree, int, bool *);
 811 extern bool c_common_handle_option (size_t, const char *, HOST_WIDE_INT, int,
 812                                     location_t,
 813                                     const struct cl_option_handlers *);
 814 extern bool default_handle_c_option (size_t, const char *, int);
 815 extern tree c_common_type_for_mode (machine_mode, int);
 816 extern tree c_common_type_for_size (unsigned int, int);
 817 extern tree c_common_fixed_point_type_for_size (unsigned int, unsigned int,
 818                                                 int, int);
 819 extern tree c_common_unsigned_type (tree);
 820 extern tree c_common_signed_type (tree);
 821 extern tree c_common_signed_or_unsigned_type (int, tree);
 822 extern void c_common_init_ts (void);
 823 extern tree c_build_bitfield_integer_type (unsigned HOST_WIDE_INT, int);
 824 extern enum conversion_safety unsafe_conversion_p (location_t, tree, tree, tree,
 825                                                    bool);
 826 extern bool decl_with_nonnull_addr_p (const_tree);
 827 extern tree c_fully_fold (tree, bool, bool *, bool = false);
 828 extern tree c_wrap_maybe_const (tree, bool);
 829 extern tree c_common_truthvalue_conversion (location_t, tree);
 830 extern void c_apply_type_quals_to_decl (int, tree);
 831 extern tree c_sizeof_or_alignof_type (location_t, tree, bool, bool, int);
 832 extern tree c_alignof_expr (location_t, tree);
 833 /* Print an error message for invalid operands to arith operation CODE.
 834    NOP_EXPR is used as a special case (see truthvalue_conversion).  */
 835 extern void binary_op_error (rich_location *, enum tree_code, tree, tree);
 836 extern tree fix_string_type (tree);
 837 extern tree convert_and_check (location_t, tree, tree);
 838 extern bool c_determine_visibility (tree);
 839 extern bool vector_types_compatible_elements_p (tree, tree);
 840 extern void mark_valid_location_for_stdc_pragma (bool);
 841 extern bool valid_location_for_stdc_pragma_p (void);
 842 extern void set_float_const_decimal64 (void);
 843 extern void clear_float_const_decimal64 (void);
 844 extern bool float_const_decimal64_p (void);
 845
 846 extern bool keyword_begins_type_specifier (enum rid);
 847 extern bool keyword_is_storage_class_specifier (enum rid);
 848 extern bool keyword_is_type_qualifier (enum rid);
 849 extern bool keyword_is_decl_specifier (enum rid);
 850 extern unsigned max_align_t_align (void);
 851 extern bool cxx_fundamental_alignment_p (unsigned);
 852 extern bool pointer_to_zero_sized_aggr_p (tree);
 853 extern bool bool_promoted_to_int_p (tree);
 854 extern tree fold_for_warn (tree);
 855 extern tree c_common_get_narrower (tree, int *);
 856 extern bool get_nonnull_operand (tree, unsigned HOST_WIDE_INT *);
 857
 858 #define c_sizeof(LOC, T)  c_sizeof_or_alignof_type (LOC, T, true, false, 1)
 859 #define c_alignof(LOC, T) c_sizeof_or_alignof_type (LOC, T, false, false, 1)
 860
 861 /* Subroutine of build_binary_op, used for certain operations.  */
 862 extern tree shorten_binary_op (tree result_type, tree op0, tree op1, bool bitwise);
 863
 864 /* Subroutine of build_binary_op, used for comparison operations.
 865    See if the operands have both been converted from subword integer types
 866    and, if so, perhaps change them both back to their original type.  */
 867 extern tree shorten_compare (location_t, tree *, tree *, tree *,
 868                              enum tree_code *);
 869
 870 extern tree pointer_int_sum (location_t, enum tree_code, tree, tree,
 871                              bool = true);
 872
 873 /* Add qualifiers to a type, in the fashion for C.  */
 874 extern tree c_build_qualified_type (tree, int, tree = NULL_TREE, size_t = 0);
 875
 876 /* Build tree nodes and builtin functions common to both C and C++ language
 877    frontends.  */
 878 extern void c_common_nodes_and_builtins (void);
 879
 880 extern void disable_builtin_function (const char *);
 881
 882 extern void set_compound_literal_name (tree decl);
 883
 884 extern tree build_va_arg (location_t, tree, tree);
 885
 886 extern const unsigned int c_family_lang_mask;
 887 extern unsigned int c_common_option_lang_mask (void);
 888 extern void c_common_diagnostics_set_defaults (diagnostic_context *);
 889 extern bool c_common_complain_wrong_lang_p (const struct cl_option *);
 890 extern void c_common_init_options_struct (struct gcc_options *);
 891 extern void c_common_init_options (unsigned int, struct cl_decoded_option *);
 892 extern bool c_common_post_options (const char **);
 893 extern bool c_common_init (void);
 894 extern void c_common_finish (void);
 895 extern void c_common_parse_file (void);
 896 extern FILE *get_dump_info (int, dump_flags_t *);
 897 extern alias_set_type c_common_get_alias_set (tree);
 898 extern void c_register_builtin_type (tree, const char*);
 899 extern bool c_promoting_integer_type_p (const_tree);
 900 extern bool self_promoting_args_p (const_tree);
 901 extern tree strip_pointer_operator (tree);
 902 extern tree strip_pointer_or_array_types (tree);
 903 extern HOST_WIDE_INT c_common_to_target_charset (HOST_WIDE_INT);
 904
 905 /* This is the basic parsing function.  */
 906 extern void c_parse_file (void);
 907
 908 extern void c_parse_final_cleanups (void);
 909
 910 /* These macros provide convenient access to the various _STMT nodes.  */
 911
 912 /* Nonzero if a given STATEMENT_LIST represents the outermost binding
 913    if a statement expression.  */
 914 #define STATEMENT_LIST_STMT_EXPR(NODE) \
 915   TREE_LANG_FLAG_1 (STATEMENT_LIST_CHECK (NODE))
 916
 917 /* Nonzero if a label has been added to the statement list.  */
 918 #define STATEMENT_LIST_HAS_LABEL(NODE) \
 919   TREE_LANG_FLAG_3 (STATEMENT_LIST_CHECK (NODE))
 920
 921 /* C_MAYBE_CONST_EXPR accessors.  */
 922 #define C_MAYBE_CONST_EXPR_PRE(NODE)                    \
 923   TREE_OPERAND (C_MAYBE_CONST_EXPR_CHECK (NODE), 0)
 924 #define C_MAYBE_CONST_EXPR_EXPR(NODE)                   \
 925   TREE_OPERAND (C_MAYBE_CONST_EXPR_CHECK (NODE), 1)
 926 #define C_MAYBE_CONST_EXPR_INT_OPERANDS(NODE)           \
 927   TREE_LANG_FLAG_0 (C_MAYBE_CONST_EXPR_CHECK (NODE))
 928 #define C_MAYBE_CONST_EXPR_NON_CONST(NODE)              \
 929   TREE_LANG_FLAG_1 (C_MAYBE_CONST_EXPR_CHECK (NODE))
 930 #define EXPR_INT_CONST_OPERANDS(EXPR)                   \
 931   (INTEGRAL_TYPE_P (TREE_TYPE (EXPR))                   \
 932    && (TREE_CODE (EXPR) == INTEGER_CST                  \
 933        || (TREE_CODE (EXPR) == C_MAYBE_CONST_EXPR       \
 934            && C_MAYBE_CONST_EXPR_INT_OPERANDS (EXPR))))
 935
 936 /* In a FIELD_DECL, nonzero if the decl was originally a bitfield.  */
 937 #define DECL_C_BIT_FIELD(NODE) \
 938   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
 939 #define SET_DECL_C_BIT_FIELD(NODE) \
 940   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
 941 #define CLEAR_DECL_C_BIT_FIELD(NODE) \
 942   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
 943
 944 /* True if the decl was an unnamed bitfield.  */
 945 #define DECL_UNNAMED_BIT_FIELD(NODE) \
 946   (DECL_C_BIT_FIELD (NODE) && !DECL_NAME (NODE))
 947
 948 extern tree do_case (location_t, tree, tree);
 949 extern tree build_stmt (location_t, enum tree_code, ...);
 950 extern tree build_real_imag_expr (location_t, enum tree_code, tree);
 951
 952 /* These functions must be defined by each front-end which implements
 953    a variant of the C language.  They are used in c-common.c.  */
 954
 955 extern tree build_unary_op (location_t, enum tree_code, tree, bool);
 956 extern tree build_binary_op (location_t, enum tree_code, tree, tree, bool);
 957 extern tree perform_integral_promotions (tree);
 958
 959 /* These functions must be defined by each front-end which implements
 960    a variant of the C language.  They are used by port files.  */
 961
 962 extern tree default_conversion (tree);
 963
 964 /* Given two integer or real types, return the type for their sum.
 965    Given two compatible ANSI C types, returns the merged type.  */
 966
 967 extern tree common_type (tree, tree);
 968
 969 extern tree decl_constant_value (tree);
 970
 971 /* Handle increment and decrement of boolean types.  */
 972 extern tree boolean_increment (enum tree_code, tree);
 973
 974 extern int case_compare (splay_tree_key, splay_tree_key);
 975
 976 extern tree c_add_case_label (location_t, splay_tree, tree, tree, tree, tree,
 977                               bool *);
 978 extern bool c_switch_covers_all_cases_p (splay_tree, tree);
 979
 980 extern tree build_function_call (location_t, tree, tree);
 981
 982 extern tree build_function_call_vec (location_t, vec<location_t>, tree,
 983                                      vec<tree, va_gc> *, vec<tree, va_gc> *);
 984
 985 extern tree resolve_overloaded_builtin (location_t, tree, vec<tree, va_gc> *);
 986
 987 extern tree finish_label_address_expr (tree, location_t);
 988
 989 /* Same function prototype, but the C and C++ front ends have
 990    different implementations.  Used in c-common.c.  */
 991 extern tree lookup_label (tree);
 992 extern tree lookup_name (tree);
 993 extern bool lvalue_p (const_tree);
 994
 995 extern bool vector_targets_convertible_p (const_tree t1, const_tree t2);
 996 extern bool vector_types_convertible_p (const_tree t1, const_tree t2, bool emit_lax_note);
 997 extern tree c_build_vec_perm_expr (location_t, tree, tree, tree, bool = true);
 998
 999 extern void init_c_lex (void);
1000
1001 extern void c_cpp_builtins (cpp_reader *);
1002 extern void c_cpp_builtins_optimize_pragma (cpp_reader *, tree, tree);
1003 extern bool c_cpp_error (cpp_reader *, int, int, rich_location *,
1004                          const char *, va_list *)
1005      ATTRIBUTE_GCC_DIAG(5,0);
1006 extern int c_common_has_attribute (cpp_reader *);
1007
1008 extern bool parse_optimize_options (tree, bool);
1009
1010 /* Positive if an implicit `extern "C"' scope has just been entered;
1011    negative if such a scope has just been exited.  */
1012 extern GTY(()) int pending_lang_change;
1013
1014 /* Information recorded about each file examined during compilation.  */
1015
1016 struct c_fileinfo
1017 {
1018   int time;     /* Time spent in the file.  */
1019
1020   /* Flags used only by C++.
1021      INTERFACE_ONLY nonzero means that we are in an "interface" section
1022      of the compiler.  INTERFACE_UNKNOWN nonzero means we cannot trust
1023      the value of INTERFACE_ONLY.  If INTERFACE_UNKNOWN is zero and
1024      INTERFACE_ONLY is zero, it means that we are responsible for
1025      exporting definitions that others might need.  */
1026   short interface_only;
1027   short interface_unknown;
1028 };
1029
1030 struct c_fileinfo *get_fileinfo (const char *);
1031 extern void dump_time_statistics (void);
1032
1033 extern bool c_dump_tree (void *, tree);
1034
1035 extern void verify_sequence_points (tree);
1036
1037 extern tree fold_offsetof (tree, tree = size_type_node,
1038                            tree_code ctx = ERROR_MARK);
1039
1040 extern int complete_array_type (tree *, tree, bool);
1041
1042 extern tree builtin_type_for_size (int, bool);
1043
1044 extern void c_common_mark_addressable_vec (tree);
1045
1046 extern void set_underlying_type (tree);
1047 extern void record_types_used_by_current_var_decl (tree);
1048 extern vec<tree, va_gc> *make_tree_vector (void);
1049 extern void release_tree_vector (vec<tree, va_gc> *);
1050 extern vec<tree, va_gc> *make_tree_vector_single (tree);
1051 extern vec<tree, va_gc> *make_tree_vector_from_list (tree);
1052 extern vec<tree, va_gc> *make_tree_vector_from_ctor (tree);
1053 extern vec<tree, va_gc> *make_tree_vector_copy (const vec<tree, va_gc> *);
1054
1055 /* Used for communication between c_common_type_for_mode and
1056    c_register_builtin_type.  */
1057 extern GTY(()) tree registered_builtin_types;
1058
1059 /* Read SOURCE_DATE_EPOCH from environment to have a deterministic
1060    timestamp to replace embedded current dates to get reproducible
1061    results.  Returns -1 if SOURCE_DATE_EPOCH is not defined.  */
1062 extern time_t cb_get_source_date_epoch (cpp_reader *pfile);
1063
1064 /* The value (as a unix timestamp) corresponds to date
1065    "Dec 31 9999 23:59:59 UTC", which is the latest date that __DATE__ and
1066    __TIME__ can store.  */
1067 #define MAX_SOURCE_DATE_EPOCH HOST_WIDE_INT_C (253402300799)
1068
1069 /* Callback for libcpp for offering spelling suggestions for misspelled
1070    directives.  */
1071 extern const char *cb_get_suggestion (cpp_reader *, const char *,
1072                                       const char *const *);
1073
1074 extern GTY(()) string_concat_db *g_string_concat_db;
1075
1076 class substring_loc;
1077 extern const char *c_get_substring_location (const substring_loc &substr_loc,
1078                                              location_t *out_loc);
1079
1080 /* In c-gimplify.c  */
1081 extern void c_genericize (tree);
1082 extern int c_gimplify_expr (tree *, gimple_seq *, gimple_seq *);
1083 extern tree c_build_bind_expr (location_t, tree, tree);
1084
1085 /* In c-lex.c.  */
1086 extern enum cpp_ttype
1087 conflict_marker_get_final_tok_kind (enum cpp_ttype tok1_kind);
1088
1089 /* In c-pch.c  */
1090 extern void pch_init (void);
1091 extern void pch_cpp_save_state (void);
1092 extern int c_common_valid_pch (cpp_reader *pfile, const char *name, int fd);
1093 extern void c_common_read_pch (cpp_reader *pfile, const char *name, int fd,
1094                                const char *orig);
1095 extern void c_common_write_pch (void);
1096 extern void c_common_no_more_pch (void);
1097 extern void c_common_pch_pragma (cpp_reader *pfile, const char *);
1098
1099 /* In *-checksum.c */
1100 extern const unsigned char executable_checksum[16];
1101
1102 /* In c-cppbuiltin.c  */
1103 extern void builtin_define_std (const char *macro);
1104 extern void builtin_define_with_value (const char *, const char *, int);
1105 extern void builtin_define_with_int_value (const char *, HOST_WIDE_INT);
1106 extern void builtin_define_type_sizeof (const char *, tree);
1107 extern void c_stddef_cpp_builtins (void);
1108 extern void fe_file_change (const line_map_ordinary *);
1109 extern void c_parse_error (const char *, enum cpp_ttype, tree, unsigned char,
1110                            rich_location *richloc);
1111
1112 /* In c-ppoutput.c  */
1113 extern void init_pp_output (FILE *);
1114 extern void preprocess_file (cpp_reader *);
1115 extern void pp_file_change (const line_map_ordinary *);
1116 extern void pp_dir_change (cpp_reader *, const char *);
1117 extern bool check_missing_format_attribute (tree, tree);
1118
1119 /* In c-omp.c  */
1120 typedef wide_int_bitmask omp_clause_mask;
1121
1122 #define OMP_CLAUSE_MASK_1 omp_clause_mask (1)
1123
1124 enum c_omp_clause_split
1125 {
1126   C_OMP_CLAUSE_SPLIT_TARGET = 0,
1127   C_OMP_CLAUSE_SPLIT_TEAMS,
1128   C_OMP_CLAUSE_SPLIT_DISTRIBUTE,
1129   C_OMP_CLAUSE_SPLIT_PARALLEL,
1130   C_OMP_CLAUSE_SPLIT_FOR,
1131   C_OMP_CLAUSE_SPLIT_SIMD,
1132   C_OMP_CLAUSE_SPLIT_COUNT,
1133   C_OMP_CLAUSE_SPLIT_SECTIONS = C_OMP_CLAUSE_SPLIT_FOR,
1134   C_OMP_CLAUSE_SPLIT_TASKLOOP = C_OMP_CLAUSE_SPLIT_FOR
1135 };
1136
1137 enum c_omp_region_type
1138 {
1139   C_ORT_OMP                     = 1 << 0,
1140   C_ORT_ACC                     = 1 << 1,
1141   C_ORT_DECLARE_SIMD            = 1 << 2,
1142   C_ORT_OMP_DECLARE_SIMD        = C_ORT_OMP | C_ORT_DECLARE_SIMD
1143 };
1144
1145 extern tree c_finish_omp_master (location_t, tree);
1146 extern tree c_finish_omp_taskgroup (location_t, tree);
1147 extern tree c_finish_omp_critical (location_t, tree, tree, tree);
1148 extern tree c_finish_omp_ordered (location_t, tree, tree);
1149 extern void c_finish_omp_barrier (location_t);
1150 extern tree c_finish_omp_atomic (location_t, enum tree_code, enum tree_code,
1151                                  tree, tree, tree, tree, tree, bool, bool,
1152                                  bool = false);
1153 extern void c_finish_omp_flush (location_t);
1154 extern void c_finish_omp_taskwait (location_t);
1155 extern void c_finish_omp_taskyield (location_t);
1156 extern tree c_finish_omp_for (location_t, enum tree_code, tree, tree, tree,
1157                               tree, tree, tree, tree);
1158 extern bool c_omp_check_loop_iv (tree, tree, walk_tree_lh);
1159 extern bool c_omp_check_loop_iv_exprs (location_t, tree, tree, tree, tree,
1160                                        walk_tree_lh);
1161 extern tree c_finish_oacc_wait (location_t, tree, tree);
1162 extern tree c_oacc_split_loop_clauses (tree, tree *, bool);
1163 extern void c_omp_split_clauses (location_t, enum tree_code, omp_clause_mask,
1164                                  tree, tree *);
1165 extern tree c_omp_declare_simd_clauses_to_numbers (tree, tree);
1166 extern void c_omp_declare_simd_clauses_to_decls (tree, tree);
1167 extern enum omp_clause_default_kind c_omp_predetermined_sharing (tree);
1168
1169 /* Return next tree in the chain for chain_next walking of tree nodes.  */
1170 static inline tree
1171 c_tree_chain_next (tree t)
1172 {
1173   /* TREE_CHAIN of a type is TYPE_STUB_DECL, which is different
1174      kind of object, never a long chain of nodes.  Prefer
1175      TYPE_NEXT_VARIANT for types.  */
1176   if (CODE_CONTAINS_STRUCT (TREE_CODE (t), TS_TYPE_COMMON))
1177     return TYPE_NEXT_VARIANT (t);
1178   /* Otherwise, if there is TREE_CHAIN, return it.  */
1179   if (CODE_CONTAINS_STRUCT (TREE_CODE (t), TS_COMMON))
1180     return TREE_CHAIN (t);
1181   return NULL;
1182 }
1183
1184 /* Mask used by tm_stmt_attr.  */
1185 #define TM_STMT_ATTR_OUTER      2
1186 #define TM_STMT_ATTR_ATOMIC     4
1187 #define TM_STMT_ATTR_RELAXED    8
1188
1189 /* Mask used by tm_attr_to_mask and tm_mask_to_attr.  Note that these
1190    are ordered specifically such that more restrictive attributes are
1191    at lower bit positions.  This fact is known by the C++ tm attribute
1192    inheritance code such that least bit extraction (mask & -mask) results
1193    in the most restrictive attribute.  */
1194 #define TM_ATTR_SAFE                    1
1195 #define TM_ATTR_CALLABLE                2
1196 #define TM_ATTR_PURE                    4
1197 #define TM_ATTR_IRREVOCABLE             8
1198 #define TM_ATTR_MAY_CANCEL_OUTER        16
1199
1200 /* A suffix-identifier value doublet that represents user-defined literals
1201    for C++-0x.  */
1202 enum overflow_type {
1203   OT_UNDERFLOW = -1,
1204   OT_NONE,
1205   OT_OVERFLOW
1206 };
1207
1208 struct GTY(()) tree_userdef_literal {
1209   struct tree_base base;
1210   tree suffix_id;
1211   tree value;
1212   tree num_string;
1213   enum overflow_type overflow;
1214 };
1215
1216 #define USERDEF_LITERAL_SUFFIX_ID(NODE) \
1217   (((struct tree_userdef_literal *)USERDEF_LITERAL_CHECK (NODE))->suffix_id)
1218
1219 #define USERDEF_LITERAL_VALUE(NODE) \
1220   (((struct tree_userdef_literal *)USERDEF_LITERAL_CHECK (NODE))->value)
1221
1222 #define USERDEF_LITERAL_OVERFLOW(NODE) \
1223   (((struct tree_userdef_literal *)USERDEF_LITERAL_CHECK (NODE))->overflow)
1224
1225 #define USERDEF_LITERAL_NUM_STRING(NODE) \
1226   (((struct tree_userdef_literal *)USERDEF_LITERAL_CHECK (NODE))->num_string)
1227
1228 #define USERDEF_LITERAL_TYPE(NODE) \
1229   (TREE_TYPE (USERDEF_LITERAL_VALUE (NODE)))
1230
1231 extern tree build_userdef_literal (tree suffix_id, tree value,
1232                                    enum overflow_type overflow,
1233                                    tree num_string);
1234
1235 extern bool convert_vector_to_array_for_subscript (location_t, tree *, tree);
1236
1237 /* Possibe cases of scalar_to_vector conversion.  */
1238 enum stv_conv {
1239   stv_error,        /* Error occurred.  */
1240   stv_nothing,      /* Nothing happened.  */
1241   stv_firstarg,     /* First argument must be expanded.  */
1242   stv_secondarg     /* Second argument must be expanded.  */
1243 };
1244
1245 extern enum stv_conv scalar_to_vector (location_t loc, enum tree_code code,
1246                                        tree op0, tree op1, bool);
1247
1248 extern tree find_inv_trees (tree *, int *, void *);
1249 extern tree replace_inv_trees (tree *, int *, void *);
1250
1251 extern bool reject_gcc_builtin (const_tree, location_t = UNKNOWN_LOCATION);
1252 extern bool valid_array_size_p (location_t, tree, tree, bool = true);
1253
1254 /* In c-warn.c.  */
1255 extern void constant_expression_warning (tree);
1256 extern void constant_expression_error (tree);
1257 extern void overflow_warning (location_t, tree, tree = NULL_TREE);
1258 extern void warn_logical_operator (location_t, enum tree_code, tree,
1259                                    enum tree_code, tree, enum tree_code, tree);
1260 extern void warn_tautological_cmp (location_t, enum tree_code, tree, tree);
1261 extern void warn_logical_not_parentheses (location_t, enum tree_code, tree,
1262                                           tree);
1263 extern bool warn_if_unused_value (const_tree, location_t);
1264 extern bool strict_aliasing_warning (location_t, tree, tree);
1265 extern void sizeof_pointer_memaccess_warning (location_t *, tree,
1266                                               vec<tree, va_gc> *, tree *,
1267                                               bool (*) (tree, tree));
1268 extern void check_main_parameter_types (tree decl);
1269 extern void warnings_for_convert_and_check (location_t, tree, tree, tree);
1270 extern void c_do_switch_warnings (splay_tree, location_t, tree, tree, bool,
1271                                   bool);
1272 extern void warn_for_omitted_condop (location_t, tree);
1273 extern bool warn_for_restrict (unsigned, tree *, unsigned);
1274
1275 /* Places where an lvalue, or modifiable lvalue, may be required.
1276    Used to select diagnostic messages in lvalue_error and
1277    readonly_error.  */
1278 enum lvalue_use {
1279   lv_assign,
1280   lv_increment,
1281   lv_decrement,
1282   lv_addressof,
1283   lv_asm
1284 };
1285
1286 extern void lvalue_error (location_t, enum lvalue_use);
1287 extern void invalid_indirection_error (location_t, tree, ref_operator);
1288 extern void readonly_error (location_t, tree, enum lvalue_use);
1289 extern void warn_array_subscript_with_type_char (location_t, tree);
1290 extern void warn_about_parentheses (location_t,
1291                                     enum tree_code,
1292                                     enum tree_code, tree,
1293                                     enum tree_code, tree);
1294 extern void warn_for_unused_label (tree label);
1295 extern void warn_for_div_by_zero (location_t, tree divisor);
1296 extern void warn_for_memset (location_t, tree, tree, int);
1297 extern void warn_for_sign_compare (location_t,
1298                                    tree orig_op0, tree orig_op1,
1299                                    tree op0, tree op1,
1300                                    tree result_type,
1301                                    enum tree_code resultcode);
1302 extern void do_warn_double_promotion (tree, tree, tree, const char *,
1303                                       location_t);
1304 extern void do_warn_unused_parameter (tree);
1305 extern void record_locally_defined_typedef (tree);
1306 extern void maybe_record_typedef_use (tree);
1307 extern void maybe_warn_unused_local_typedefs (void);
1308 extern void maybe_warn_bool_compare (location_t, enum tree_code, tree, tree);
1309 extern bool maybe_warn_shift_overflow (location_t, tree, tree);
1310 extern void warn_duplicated_cond_add_or_warn (location_t, tree, vec<tree> **);
1311 extern bool diagnose_mismatched_attributes (tree, tree);
1312 extern tree do_warn_duplicated_branches_r (tree *, int *, void *);
1313 extern void warn_for_multistatement_macros (location_t, location_t,
1314                                             location_t, enum rid);
1315
1316 /* In c-attribs.c.  */
1317 extern bool attribute_takes_identifier_p (const_tree);
1318 extern tree handle_unused_attribute (tree *, tree, tree, int, bool *);
1319 extern int parse_tm_stmt_attr (tree, int);
1320 extern int tm_attr_to_mask (tree);
1321 extern tree tm_mask_to_attr (int);
1322 extern tree find_tm_attribute (tree);
1323
1324 extern enum flt_eval_method
1325 excess_precision_mode_join (enum flt_eval_method, enum flt_eval_method);
1326
1327 extern int c_flt_eval_method (bool ts18661_p);
1328 extern void add_no_sanitize_value (tree node, unsigned int flags);
1329
1330 extern void maybe_add_include_fixit (rich_location *, const char *, bool);
1331 extern void maybe_suggest_missing_token_insertion (rich_location *richloc,
1332                                                    enum cpp_ttype token_type,
1333                                                    location_t prev_token_loc);
1334 extern tree braced_list_to_string (tree, tree, tree (*)(tree, tree) = NULL);
1335
1336 #if CHECKING_P
1337 namespace selftest {
1338   /* Declarations for specific families of tests within c-family,
1339      by source file, in alphabetical order.  */
1340   extern void c_format_c_tests (void);
1341   extern void c_indentation_c_tests (void);
1342   extern void c_pretty_print_c_tests (void);
1343   extern void c_spellcheck_cc_tests (void);
1344
1345   /* The entrypoint for running all of the above tests.  */
1346   extern void c_family_tests (void);
1347 } // namespace selftest
1348 #endif /* #if CHECKING_P */
1349
1350 #endif /* ! GCC_C_COMMON_H */