clang 23.0.0git
ASTBitCodes.h
Go to the documentation of this file.
1//===- ASTBitCodes.h - Enum values for the PCH bitcode format ---*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This header defines Bitcode enum values for Clang serialized AST files.
10//
11// The enum values defined in this file should be considered permanent. If
12// new features are added, they should have values added at the end of the
13// respective lists.
14//
15//===----------------------------------------------------------------------===//
16
17#ifndef LLVM_CLANG_SERIALIZATION_ASTBITCODES_H
18#define LLVM_CLANG_SERIALIZATION_ASTBITCODES_H
19
20#include "clang/AST/DeclID.h"
22#include "clang/AST/Type.h"
27#include "llvm/ADT/DenseMapInfo.h"
28#include "llvm/Bitstream/BitCodes.h"
29#include "llvm/Support/MathExtras.h"
30#include <cassert>
31#include <cstdint>
32
33namespace clang {
34namespace serialization {
35
36/// AST file major version number supported by this version of
37/// Clang.
38///
39/// Whenever the AST file format changes in a way that makes it
40/// incompatible with previous versions (such that a reader
41/// designed for the previous version could not support reading
42/// the new version), this number should be increased.
43///
44/// Version 4 of AST files also requires that the version control branch and
45/// revision match exactly, since there is no backward compatibility of
46/// AST files at this time.
47const unsigned VERSION_MAJOR = 38;
48
49/// AST file minor version number supported by this version of
50/// Clang.
51///
52/// Whenever the AST format changes in a way that is still
53/// compatible with previous versions (such that a reader designed
54/// for the previous version could still support reading the new
55/// version by ignoring new kinds of subblocks), this number
56/// should be increased.
57const unsigned VERSION_MINOR = 0;
58
59/// An ID number that refers to an identifier in an AST file.
60///
61/// The ID numbers of identifiers are consecutive (in order of discovery)
62/// and start at 1. 0 is reserved for NULL.
63using IdentifierID = uint64_t;
64
65/// The number of predefined identifier IDs.
66const unsigned int NUM_PREDEF_IDENT_IDS = 1;
67
68/// An ID number that refers to a declaration in an AST file. See the comments
69/// in DeclIDBase for details.
71
72/// An ID number that refers to a type in an AST file.
73///
74/// The ID of a type is partitioned into three parts:
75/// - the lower three bits are used to store the const/volatile/restrict
76/// qualifiers (as with QualType).
77/// - the next 29 bits provide a type index in the corresponding
78/// module file.
79/// - the upper 32 bits provide a module file index.
80///
81/// The type index values are partitioned into two
82/// sets. The values below NUM_PREDEF_TYPE_IDs are predefined type
83/// IDs (based on the PREDEF_TYPE_*_ID constants), with 0 as a
84/// placeholder for "no type". The module file index for predefined
85/// types are always 0 since they don't belong to any modules.
86/// Values from NUM_PREDEF_TYPE_IDs are other types that have
87/// serialized representations.
88using TypeID = uint64_t;
89/// Same with TypeID except that the LocalTypeID is only meaningful
90/// with the corresponding ModuleFile.
91///
92/// FIXME: Make TypeID and LocalTypeID a class to improve the type
93/// safety.
95
96/// A type index; the type ID with the qualifier bits removed.
97/// Keep structure alignment 32-bit since the blob is assumed as 32-bit
98/// aligned.
99class TypeIdx {
100 uint32_t ModuleFileIndex = 0;
101 uint32_t Idx = 0;
102
103public:
104 TypeIdx() = default;
105
106 explicit TypeIdx(uint32_t ModuleFileIdx, uint32_t Idx)
107 : ModuleFileIndex(ModuleFileIdx), Idx(Idx) {}
108
109 uint32_t getModuleFileIndex() const { return ModuleFileIndex; }
110
111 uint64_t getValue() const { return ((uint64_t)ModuleFileIndex << 32) | Idx; }
112
113 TypeID asTypeID(unsigned FastQuals) const {
114 if (Idx == uint32_t(-1))
115 return TypeID(-1);
116
117 unsigned Index = (Idx << Qualifiers::FastWidth) | FastQuals;
118 return ((uint64_t)ModuleFileIndex << 32) | Index;
119 }
120
122 if (ID == TypeID(-1))
123 return TypeIdx(0, -1);
124
125 return TypeIdx(ID >> 32, (ID & llvm::maskTrailingOnes<TypeID>(32)) >>
127 }
128};
129
130static_assert(alignof(TypeIdx) == 4);
131
132/// A structure for putting "fast"-unqualified QualTypes into a
133/// DenseMap. This uses the standard pointer hash function.
135 static bool isEqual(QualType A, QualType B) { return A == B; }
136
138 return QualType::getFromOpaquePtr((void *)1);
139 }
140
141 static unsigned getHashValue(QualType T) {
142 assert(!T.getLocalFastQualifiers() &&
143 "hash invalid for types with fast quals");
144 uintptr_t v = reinterpret_cast<uintptr_t>(T.getAsOpaquePtr());
145 return (unsigned(v) >> 4) ^ (unsigned(v) >> 9);
146 }
147};
148
149/// An ID number that refers to a macro in an AST file.
150using MacroID = uint64_t;
151
152/// A global ID number that refers to a macro in an AST file.
153using GlobalMacroID = uint64_t;
154
155/// A local to a module ID number that refers to a macro in an
156/// AST file.
157using LocalMacroID = uint64_t;
158
159/// The number of predefined macro IDs.
160const unsigned int NUM_PREDEF_MACRO_IDS = 1;
161
162/// An ID number that refers to an ObjC selector in an AST file.
163using SelectorID = uint32_t;
164
165/// The number of predefined selector IDs.
166const unsigned int NUM_PREDEF_SELECTOR_IDS = 1;
167
168/// An ID number that refers to a set of CXXBaseSpecifiers in an
169/// AST file.
170using CXXBaseSpecifiersID = uint32_t;
171
172/// An ID number that refers to a list of CXXCtorInitializers in an
173/// AST file.
174using CXXCtorInitializersID = uint32_t;
175
176/// An ID number that refers to an entity in the detailed
177/// preprocessing record.
178using PreprocessedEntityID = uint64_t;
179
180/// An ID number that refers to a submodule in a module file.
181using SubmoduleID = uint32_t;
182
183/// The number of predefined submodule IDs.
184const unsigned int NUM_PREDEF_SUBMODULE_IDS = 1;
185
186/// 32 aligned uint64_t in the AST file. Use splitted 64-bit integer into
187/// low/high parts to keep structure alignment 32-bit (it is important
188/// because blobs in bitstream are 32-bit aligned). This structure is
189/// serialized "as is" to the AST file.
191 uint32_t BitLow = 0;
192 uint32_t BitHigh = 0;
193
194public:
195 UnalignedUInt64() = default;
196 UnalignedUInt64(uint64_t BitOffset) { set(BitOffset); }
197
198 void set(uint64_t Offset) {
199 BitLow = Offset;
200 BitHigh = Offset >> 32;
201 }
202
203 uint64_t get() const { return BitLow | (uint64_t(BitHigh) << 32); }
204};
205
206/// Source range/offset of a preprocessed entity.
208 using RawLocEncoding = SourceLocationEncoding::RawLocEncoding;
209
210 /// Raw source location of beginning of range.
211 UnalignedUInt64 Begin;
212
213 /// Raw source location of end of range.
214 UnalignedUInt64 End;
215
216 /// Offset in the AST file relative to ModuleFile::MacroOffsetsBase.
217 uint32_t BitOffset;
218
219public:
220 PPEntityOffset(RawLocEncoding Begin, RawLocEncoding End, uint32_t BitOffset)
221 : Begin(Begin), End(End), BitOffset(BitOffset) {}
222
223 RawLocEncoding getBegin() const { return Begin.get(); }
224 RawLocEncoding getEnd() const { return End.get(); }
225
226 uint32_t getOffset() const { return BitOffset; }
227};
228
229/// Source range of a skipped preprocessor region
231 using RawLocEncoding = SourceLocationEncoding::RawLocEncoding;
232
233 /// Raw source location of beginning of range.
234 UnalignedUInt64 Begin;
235 /// Raw source location of end of range.
236 UnalignedUInt64 End;
237
238public:
239 PPSkippedRange(RawLocEncoding Begin, RawLocEncoding End)
240 : Begin(Begin), End(End) {}
241
242 RawLocEncoding getBegin() const { return Begin.get(); }
243 RawLocEncoding getEnd() const { return End.get(); }
244};
245
246/// Source location and bit offset of a declaration. Keep
247/// structure alignment 32-bit since the blob is assumed as 32-bit aligned.
249 using RawLocEncoding = SourceLocationEncoding::RawLocEncoding;
250
251 /// Raw source location.
252 UnalignedUInt64 RawLoc;
253
254 /// Offset relative to the start of the DECLTYPES_BLOCK block.
255 UnalignedUInt64 BitOffset;
256
257public:
258 DeclOffset() = default;
259 DeclOffset(RawLocEncoding RawLoc, uint64_t BitOffset,
260 uint64_t DeclTypesBlockStartOffset)
261 : RawLoc(RawLoc) {
262 setBitOffset(BitOffset, DeclTypesBlockStartOffset);
263 }
264
265 void setRawLoc(RawLocEncoding Loc) { RawLoc = Loc; }
266
267 RawLocEncoding getRawLoc() const { return RawLoc.get(); }
268
269 void setBitOffset(uint64_t Offset, const uint64_t DeclTypesBlockStartOffset) {
270 BitOffset.set(Offset - DeclTypesBlockStartOffset);
271 }
272
273 uint64_t getBitOffset(const uint64_t DeclTypesBlockStartOffset) const {
274 return BitOffset.get() + DeclTypesBlockStartOffset;
275 }
276};
277
278// The unaligned decl ID used in the Blobs of bistreams.
280 llvm::support::detail::packed_endian_specific_integral<
281 serialization::DeclID, llvm::endianness::native,
282 llvm::support::unaligned>;
283
284/// The number of predefined preprocessed entity IDs.
285const unsigned int NUM_PREDEF_PP_ENTITY_IDS = 1;
286
287/// Describes the various kinds of blocks that occur within
288/// an AST file.
290 /// The AST block, which acts as a container around the
291 /// full AST block.
292 AST_BLOCK_ID = llvm::bitc::FIRST_APPLICATION_BLOCKID,
293
294 /// The block containing information about the source
295 /// manager.
297
298 /// The block containing information about the
299 /// preprocessor.
301
302 /// The block containing the definitions of all of the
303 /// types and decls used within the AST file.
305
306 /// The block containing the detailed preprocessing record.
308
309 /// The block containing the submodule structure.
311
312 /// The block containing comments.
314
315 /// The control block, which contains all of the
316 /// information that needs to be validated prior to committing
317 /// to loading the AST file.
319
320 /// The block of input files, which were used as inputs
321 /// to create this AST file.
322 ///
323 /// This block is part of the control block.
325
326 /// The block of configuration options, used to check that
327 /// a module is being used in a configuration compatible with the
328 /// configuration in which it was built.
329 ///
330 /// This block is part of the control block.
332
333 /// A block containing a module file extension.
335
336 /// A block with unhashed content.
337 ///
338 /// These records should not change the \a ASTFileSignature. See \a
339 /// UnhashedControlBlockRecordTypes for the list of records.
341};
342
343/// Record types that occur within the control block.
345 /// AST file metadata, including the AST file version number
346 /// and information about the compiler used to build this AST file.
348
349 /// Record code for another AST file imported by this AST file.
351
352 /// Record code for the original file that was used to
353 /// generate the AST file, including both its file ID and its
354 /// name.
356
357 /// Record code for file ID of the file or buffer that was used to
358 /// generate the AST file.
360
361 /// Offsets into the input-files block where input files
362 /// reside.
364
365 /// Record code for the module name.
367
368 /// Record code for the module map file that was used to build this
369 /// AST file.
371
372 /// Record code for the module build directory.
374};
375
376/// Record types that occur within the options block inside
377/// the control block.
379 /// Record code for the language options table.
380 ///
381 /// The record with this code contains the contents of the
382 /// LangOptions structure. We serialize the entire contents of
383 /// the structure, and let the reader decide which options are
384 /// actually important to check.
386
387 /// Record code for the target options table.
389
390 /// Record code for the filesystem options table.
392
393 /// Record code for the headers search options table.
395
396 /// Record code for the preprocessor options table.
398
399 /// Record code for the codegen options table.
401};
402
403/// Record codes for the unhashed control block.
405 /// Record code for the signature that identifiers this AST file.
407
408 /// Record code for the content hash of the AST block.
410
411 /// Record code for the diagnostic options table.
413
414 /// Record code for the headers search paths.
416
417 /// Record code for \#pragma diagnostic mappings.
419
420 /// Record code for the indices of used header search entries.
422
423 /// Record code for the indices of used VFSs.
425};
426
427/// Record code for extension blocks.
429 /// Metadata describing this particular extension.
431
432 /// The first record ID allocated to the extensions themselves.
434};
435
436/// Record types that occur within the input-files block
437/// inside the control block.
439 /// An input file.
441
442 /// The input file content hash
444};
445
446/// Record types that occur within the AST block itself.
448 /// Record code for the offsets of each type.
449 ///
450 /// The TYPE_OFFSET constant describes the record that occurs
451 /// within the AST block. The record itself is an array of offsets that
452 /// point into the declarations and types block (identified by
453 /// DECLTYPES_BLOCK_ID). The index into the array is based on the ID
454 /// of a type. For a given type ID @c T, the lower three bits of
455 /// @c T are its qualifiers (const, volatile, restrict), as in
456 /// the QualType class. The upper bits, after being shifted and
457 /// subtracting NUM_PREDEF_TYPE_IDS, are used to index into the
458 /// TYPE_OFFSET block to determine the offset of that type's
459 /// corresponding record within the DECLTYPES_BLOCK_ID block.
461
462 /// Record code for the offsets of each decl.
463 ///
464 /// The DECL_OFFSET constant describes the record that occurs
465 /// within the block identified by DECL_OFFSETS_BLOCK_ID within
466 /// the AST block. The record itself is an array of offsets that
467 /// point into the declarations and types block (identified by
468 /// DECLTYPES_BLOCK_ID). The declaration ID is an index into this
469 /// record, after subtracting one to account for the use of
470 /// declaration ID 0 for a NULL declaration pointer. Index 0 is
471 /// reserved for the translation unit declaration.
473
474 /// Record code for the table of offsets of each
475 /// identifier ID.
476 ///
477 /// The offset table contains offsets into the blob stored in
478 /// the IDENTIFIER_TABLE record. Each offset points to the
479 /// NULL-terminated string that corresponds to that identifier.
481
482 /// This is so that older clang versions, before the introduction
483 /// of the control block, can read and reject the newer PCH format.
484 /// *DON'T CHANGE THIS NUMBER*.
486
487 /// Record code for the identifier table.
488 ///
489 /// The identifier table is a simple blob that contains
490 /// NULL-terminated strings for all of the identifiers
491 /// referenced by the AST file. The IDENTIFIER_OFFSET table
492 /// contains the mapping from identifier IDs to the characters
493 /// in this blob. Note that the starting offsets of all of the
494 /// identifiers are odd, so that, when the identifier offset
495 /// table is loaded in, we can use the low bit to distinguish
496 /// between offsets (for unresolved identifier IDs) and
497 /// IdentifierInfo pointers (for already-resolved identifier
498 /// IDs).
500
501 /// Record code for the array of eagerly deserialized decls.
502 ///
503 /// The AST file contains a list of all of the declarations that should be
504 /// eagerly deserialized present within the parsed headers, stored as an
505 /// array of declaration IDs. These declarations will be
506 /// reported to the AST consumer after the AST file has been
507 /// read, since their presence can affect the semantics of the
508 /// program (e.g., for code generation).
510
511 /// Record code for the set of non-builtin, special
512 /// types.
513 ///
514 /// This record contains the type IDs for the various type nodes
515 /// that are constructed during semantic analysis (e.g.,
516 /// __builtin_va_list). The SPECIAL_TYPE_* constants provide
517 /// offsets into this record.
519
520 /// Record code for the extra statistics we gather while
521 /// generating an AST file.
523
524 /// Record code for the array of tentative definitions.
526
527 // ID 10 used to be for a list of extern "C" declarations.
528
529 /// Record code for the table of offsets into the
530 /// Objective-C method pool.
532
533 /// Record code for the Objective-C method pool,
535
536 /// The value of the next __COUNTER__ to dispense.
537 /// [PP_COUNTER_VALUE, Val]
539
540 /// Record code for the table of offsets into the block
541 /// of source-location information.
543
544 // ID 15 used to be for source location entry preloads.
545
546 /// Record code for the set of ext_vector type names.
548
549 /// Record code for the array of unused file scoped decls.
551
552 /// Record code for the table of offsets to entries in the
553 /// preprocessing record.
555
556 /// Record code for the array of VTable uses.
558
559 // ID 20 used to be for a list of dynamic classes.
560
561 /// Record code for referenced selector pool.
563
564 /// Record code for an update to the TU's lexically contained
565 /// declarations.
567
568 // ID 23 used to be for a list of local redeclarations.
569
570 /// Record code for declarations that Sema keeps references of.
572
573 /// Record code for weak undeclared identifiers.
575
576 /// Record code for pending implicit instantiations.
578
579 // ID 27 used to be for a list of replacement decls.
580
581 /// Record code for an update to a decl context's lookup table.
582 ///
583 /// In practice, this should only be used for the TU and namespaces.
585
586 /// Record for offsets of DECL_UPDATES records for declarations
587 /// that were modified after being deserialized and need updates.
589
590 // ID 30 used to be a decl update record. These are now in the DECLTYPES
591 // block.
592
593 // ID 31 used to be a list of offsets to DECL_CXX_BASE_SPECIFIERS records.
594
595 // ID 32 used to be the code for \#pragma diagnostic mappings.
596
597 /// Record code for special CUDA declarations.
599
600 /// Record code for header search information.
602
603 /// Record code for floating point \#pragma options.
605
606 /// Record code for enabled OpenCL extensions.
608
609 /// The list of delegating constructor declarations.
611
612 /// Record code for the set of known namespaces, which are used
613 /// for typo correction.
615
616 /// Record code for the remapping information used to relate
617 /// loaded modules to the various offsets and IDs(e.g., source location
618 /// offests, declaration and type IDs) that are used in that module to
619 /// refer to other modules.
621
622 /// Record code for the source manager line table information,
623 /// which stores information about \#line directives.
625
626 /// Record code for map of Objective-C class definition IDs to the
627 /// ObjC categories in a module that are attached to that class.
629
630 /// Record code for a file sorted array of DeclIDs in a module.
632
633 /// Record code for an array of all of the (sub)modules that were
634 /// imported by the AST file.
636
637 // ID 44 used to be a table of merged canonical declarations.
638 // ID 45 used to be a list of declaration IDs of local redeclarations.
639
640 /// Record code for the array of Objective-C categories (including
641 /// extensions).
642 ///
643 /// This array can only be interpreted properly using the Objective-C
644 /// categories map.
646
647 /// Record code for the table of offsets of each macro ID.
648 ///
649 /// The offset table contains offsets into the blob stored in
650 /// the preprocessor block. Each offset points to the corresponding
651 /// macro definition.
653
654 /// A list of "interesting" identifiers. Only used in C++ (where we
655 /// don't normally do lookups into the serialized identifier table). These
656 /// are eagerly deserialized.
658
659 /// Record code for undefined but used functions and variables that
660 /// need a definition in this TU.
662
663 /// Record code for late parsed template functions.
665
666 /// Record code for \#pragma optimize options.
668
669 /// Record code for potentially unused local typedef names.
671
672 // ID 53 used to be a table of constructor initializer records.
673
674 /// Delete expressions that will be analyzed later.
676
677 /// Record code for \#pragma ms_struct options.
679
680 /// Record code for \#pragma ms_struct options.
682
683 /// Number of unmatched #pragma clang cuda_force_host_device begin
684 /// directives we've seen.
686
687 /// Record code for types associated with OpenCL extensions.
689
690 /// Record code for declarations associated with OpenCL extensions.
692
694
695 /// Record code for \#pragma align/pack options.
697
698 /// The stack of open #ifs/#ifdefs recorded in a preamble.
700
701 /// A table of skipped ranges within the preprocessing record.
703
704 /// Record code for the Decls to be checked for deferred diags.
706
707 /// Record code for \#pragma float_control options.
709
710 /// ID 66 used to be the list of included files.
711
712 /// Record code for an unterminated \#pragma clang assume_nonnull begin
713 /// recorded in a preamble.
715
716 /// Record code for lexical and visible block for delayed namespace in
717 /// reduced BMI.
719
720 /// Record code for \#pragma clang unsafe_buffer_usage begin/end
722
723 /// Record code for vtables to emit.
725
726 /// Record code for related declarations that have to be deserialized together
727 /// from the same module.
729
730 /// Record code for Sema's vector of functions/blocks with effects to
731 /// be verified.
733
734 /// Record code for updated specialization
736
738
740
742
744
745 /// Record code for #pragma clang riscv intrinsic vector.
747
748 /// Record code for extname-redefined undeclared identifiers.
750
751 /// Record that encodes the number of submodules, their base ID in the AST
752 /// file, and for each module the relative bit offset into the stream.
754};
755
756/// Record types used within a source manager block.
758 /// Describes a source location entry (SLocEntry) for a
759 /// file.
761
762 /// Describes a source location entry (SLocEntry) for a
763 /// buffer.
765
766 /// Describes a blob that contains the data for a buffer
767 /// entry. This kind of record always directly follows a
768 /// SM_SLOC_BUFFER_ENTRY record or a SM_SLOC_FILE_ENTRY with an
769 /// overridden buffer.
771
772 /// Describes a zlib-compressed blob that contains the data for
773 /// a buffer entry.
775
776 /// Describes a source location entry (SLocEntry) for a
777 /// macro expansion.
779};
780
781/// Record types used within a preprocessor block.
783 // The macros in the PP section are a PP_MACRO_* instance followed by a
784 // list of PP_TOKEN instances for each token in the definition.
785
786 /// An object-like macro definition.
787 /// [PP_MACRO_OBJECT_LIKE, IdentInfoID, SLoc, IsUsed]
789
790 /// A function-like macro definition.
791 /// [PP_MACRO_FUNCTION_LIKE, <ObjectLikeStuff>, IsC99Varargs,
792 /// IsGNUVarars, NumArgs, ArgIdentInfoID* ]
794
795 /// Describes one token.
796 /// [PP_TOKEN, SLoc, Length, IdentInfoID, Kind, Flags]
798
799 /// The macro directives history for a particular identifier.
801
802 /// A macro directive exported by a module.
803 /// [PP_MODULE_MACRO, SubmoduleID, MacroID, (Overridden SubmoduleID)*]
805};
806
807/// Record types used within a preprocessor detail block.
809 /// Describes a macro expansion within the preprocessing record.
811
812 /// Describes a macro definition within the preprocessing record.
814
815 /// Describes an inclusion directive within the preprocessing
816 /// record.
818};
819
820/// Record types used within a submodule description block.
822 /// Defines the end of a single submodule. Sentinel record without any data.
824
825 /// Defines the major attributes of a submodule, including its
826 /// name and parent.
828
829 /// Specifies the umbrella header used to create this module,
830 /// if any.
832
833 /// Specifies a header that falls into this (sub)module.
835
836 /// Specifies a top-level header that falls into this (sub)module.
838
839 /// Specifies an umbrella directory.
841
842 /// Specifies the submodules that are imported by this
843 /// submodule.
845
846 /// Specifies the submodules that are re-exported from this
847 /// submodule.
849
850 /// Specifies a required feature.
852
853 /// Specifies a header that has been explicitly excluded
854 /// from this submodule.
856
857 /// Specifies a library or framework to link against.
859
860 /// Specifies a configuration macro for this module.
862
863 /// Specifies a conflict with another module.
865
866 /// Specifies a header that is private to this submodule.
868
869 /// Specifies a header that is part of the module but must be
870 /// textually included.
872
873 /// Specifies a header that is private to this submodule but
874 /// must be textually included.
876
877 /// Specifies some declarations with initializers that must be
878 /// emitted to initialize the module.
880
881 /// Specifies the name of the module that will eventually
882 /// re-export the entities in this module.
884
885 /// Specifies affecting modules that were not imported.
887
888 /// Specifies a direct submodule by name and ID, enabling on-demand
889 /// deserialization of children without loading the entire submodule block.
891};
892
893/// Record types used within a comments block.
895
896/// \defgroup ASTAST AST file AST constants
897///
898/// The constants in this group describe various components of the
899/// abstract syntax tree within an AST file.
900///
901/// @{
902
903/// Predefined type IDs.
904///
905/// These type IDs correspond to predefined types in the AST
906/// context, such as built-in types (int) and special place-holder
907/// types (the <overload> and <dependent> type markers). Such
908/// types are never actually serialized, since they will be built
909/// by the AST context when it is created.
911 /// The NULL type.
913
914 /// The void type.
916
917 /// The 'bool' or '_Bool' type.
919
920 /// The 'char' type, when it is unsigned.
922
923 /// The 'unsigned char' type.
925
926 /// The 'unsigned short' type.
928
929 /// The 'unsigned int' type.
931
932 /// The 'unsigned long' type.
934
935 /// The 'unsigned long long' type.
937
938 /// The 'char' type, when it is signed.
940
941 /// The 'signed char' type.
943
944 /// The C++ 'wchar_t' type.
946
947 /// The (signed) 'short' type.
949
950 /// The (signed) 'int' type.
952
953 /// The (signed) 'long' type.
955
956 /// The (signed) 'long long' type.
958
959 /// The 'float' type.
961
962 /// The 'double' type.
964
965 /// The 'long double' type.
967
968 /// The placeholder type for overloaded function sets.
970
971 /// The placeholder type for dependent types.
973
974 /// The '__uint128_t' type.
976
977 /// The '__int128_t' type.
979
980 /// The type of 'nullptr'.
982
983 /// The C++ 'char16_t' type.
985
986 /// The C++ 'char32_t' type.
988
989 /// The ObjC 'id' type.
991
992 /// The ObjC 'Class' type.
994
995 /// The ObjC 'SEL' type.
997
998 /// The 'unknown any' placeholder type.
1000
1001 /// The placeholder type for bound member functions.
1003
1004 /// The "auto" deduction type.
1006
1007 /// The "auto &&" deduction type.
1009
1010 /// The OpenCL 'half' / ARM NEON __fp16 type.
1012
1013 /// ARC's unbridged-cast placeholder type.
1015
1016 /// The pseudo-object placeholder type.
1018
1019 /// The placeholder type for builtin functions.
1021
1022 /// OpenCL event type.
1024
1025 /// OpenCL clk event type.
1027
1028 /// OpenCL sampler type.
1030
1031 /// OpenCL queue type.
1033
1034 /// OpenCL reserve_id type.
1036
1037 /// The placeholder type for an array section.
1039
1040 /// The '__float128' type
1042
1043 /// The '_Float16' type
1045
1046 /// The C++ 'char8_t' type.
1048
1049 /// \brief The 'short _Accum' type
1051
1052 /// \brief The '_Accum' type
1054
1055 /// \brief The 'long _Accum' type
1057
1058 /// \brief The 'unsigned short _Accum' type
1060
1061 /// \brief The 'unsigned _Accum' type
1063
1064 /// \brief The 'unsigned long _Accum' type
1066
1067 /// \brief The 'short _Fract' type
1069
1070 /// \brief The '_Fract' type
1072
1073 /// \brief The 'long _Fract' type
1075
1076 /// \brief The 'unsigned short _Fract' type
1078
1079 /// \brief The 'unsigned _Fract' type
1081
1082 /// \brief The 'unsigned long _Fract' type
1084
1085 /// \brief The '_Sat short _Accum' type
1087
1088 /// \brief The '_Sat _Accum' type
1090
1091 /// \brief The '_Sat long _Accum' type
1093
1094 /// \brief The '_Sat unsigned short _Accum' type
1096
1097 /// \brief The '_Sat unsigned _Accum' type
1099
1100 /// \brief The '_Sat unsigned long _Accum' type
1102
1103 /// \brief The '_Sat short _Fract' type
1105
1106 /// \brief The '_Sat _Fract' type
1108
1109 /// \brief The '_Sat long _Fract' type
1111
1112 /// \brief The '_Sat unsigned short _Fract' type
1114
1115 /// \brief The '_Sat unsigned _Fract' type
1117
1118 /// \brief The '_Sat unsigned long _Fract' type
1120
1121 /// The placeholder type for OpenMP array shaping operation.
1123
1124 /// The placeholder type for OpenMP iterator expression.
1126
1127 /// A placeholder type for incomplete matrix index operations.
1129
1130 /// \brief The '__bf16' type
1132
1133 /// \brief The '__ibm128' type
1135
1136/// OpenCL image types with auto numeration
1137#define IMAGE_TYPE(ImgType, Id, SingletonId, Access, Suffix) \
1138 PREDEF_TYPE_##Id##_ID,
1139#include "clang/Basic/OpenCLImageTypes.def"
1140/// \brief OpenCL extension types with auto numeration
1141#define EXT_OPAQUE_TYPE(ExtType, Id, Ext) PREDEF_TYPE_##Id##_ID,
1142#include "clang/Basic/OpenCLExtensionTypes.def"
1143// \brief SVE types with auto numeration
1144#define SVE_TYPE(Name, Id, SingletonId) PREDEF_TYPE_##Id##_ID,
1145#include "clang/Basic/AArch64ACLETypes.def"
1146// \brief PowerPC MMA types with auto numeration
1147#define PPC_VECTOR_TYPE(Name, Id, Size) PREDEF_TYPE_##Id##_ID,
1148#include "clang/Basic/PPCTypes.def"
1149// \brief RISC-V V types with auto numeration
1150#define RVV_TYPE(Name, Id, SingletonId) PREDEF_TYPE_##Id##_ID,
1151#include "clang/Basic/RISCVVTypes.def"
1152// \brief WebAssembly reference types with auto numeration
1153#define WASM_TYPE(Name, Id, SingletonId) PREDEF_TYPE_##Id##_ID,
1154#include "clang/Basic/WebAssemblyReferenceTypes.def"
1155// \brief AMDGPU types with auto numeration
1156#define AMDGPU_TYPE(Name, Id, SingletonId, Width, Align) PREDEF_TYPE_##Id##_ID,
1157#include "clang/Basic/AMDGPUTypes.def"
1158// \brief HLSL intangible types with auto numeration
1159#define HLSL_INTANGIBLE_TYPE(Name, Id, SingletonId) PREDEF_TYPE_##Id##_ID,
1160#include "clang/Basic/HLSLIntangibleTypes.def"
1161
1162 /// The placeholder type for unresolved templates.
1164 // Sentinel value. Considered a predefined type but not useable as one.
1166};
1167
1168/// The number of predefined type IDs that are reserved for
1169/// the PREDEF_TYPE_* constants.
1170///
1171/// Type IDs for non-predefined types will start at
1172/// NUM_PREDEF_TYPE_IDs.
1173const unsigned NUM_PREDEF_TYPE_IDS = 529;
1174
1175// Ensure we do not overrun the predefined types we reserved
1176// in the enum PredefinedTypeIDs above.
1178 "Too many enumerators in PredefinedTypeIDs. Review the value of "
1179 "NUM_PREDEF_TYPE_IDS");
1180
1181/// Record codes for each kind of type.
1182///
1183/// These constants describe the type records that can occur within a
1184/// block identified by DECLTYPES_BLOCK_ID in the AST file. Each
1185/// constant describes a record for a specific type class in the
1186/// AST. Note that DeclCode values share this code space.
1188#define TYPE_BIT_CODE(CLASS_ID, CODE_ID, CODE_VALUE) \
1189 TYPE_##CODE_ID = CODE_VALUE,
1190#include "clang/Serialization/TypeBitCodes.def"
1191
1192 /// An ExtQualType record.
1194};
1195
1196/// The type IDs for special types constructed by semantic
1197/// analysis.
1198///
1199/// The constants in this enumeration are indices into the
1200/// SPECIAL_TYPES record.
1202 /// CFConstantString type
1204
1205 /// C FILE typedef type
1207
1208 /// C jmp_buf typedef type
1210
1211 /// C sigjmp_buf typedef type
1213
1214 /// Objective-C "id" redefinition type
1216
1217 /// Objective-C "Class" redefinition type
1219
1220 /// Objective-C "SEL" redefinition type
1222
1223 /// C ucontext_t typedef type
1225};
1226
1227/// The number of special type IDs.
1228const unsigned NumSpecialTypeIDs = 8;
1229
1230/// Record of updates for a declaration that was modified after
1231/// being deserialized. This can occur within DECLTYPES_BLOCK_ID.
1232const unsigned int DECL_UPDATES = 49;
1233
1234/// Record code for a list of local redeclarations of a declaration.
1235/// This can occur within DECLTYPES_BLOCK_ID.
1236const unsigned int LOCAL_REDECLARATIONS = 50;
1237
1238/// Record codes for each kind of declaration.
1239///
1240/// These constants describe the declaration records that can occur within
1241/// a declarations block (identified by DECLTYPES_BLOCK_ID). Each
1242/// constant describes a record for a specific declaration class
1243/// in the AST. Note that TypeCode values share this code space.
1245 /// A TypedefDecl record.
1247 /// A TypeAliasDecl record.
1248
1250
1251 /// An EnumDecl record.
1253
1254 /// A RecordDecl record.
1256
1257 /// An EnumConstantDecl record.
1259
1260 /// A FunctionDecl record.
1262
1263 /// A ObjCMethodDecl record.
1265
1266 /// A ObjCInterfaceDecl record.
1268
1269 /// A ObjCProtocolDecl record.
1271
1272 /// A ObjCIvarDecl record.
1274
1275 /// A ObjCAtDefsFieldDecl record.
1277
1278 /// A ObjCCategoryDecl record.
1280
1281 /// A ObjCCategoryImplDecl record.
1283
1284 /// A ObjCImplementationDecl record.
1286
1287 /// A ObjCCompatibleAliasDecl record.
1289
1290 /// A ObjCPropertyDecl record.
1292
1293 /// A ObjCPropertyImplDecl record.
1295
1296 /// A FieldDecl record.
1298
1299 /// A MSPropertyDecl record.
1301
1302 /// A MSGuidDecl record.
1304
1305 /// A TemplateParamObjectDecl record.
1307
1308 /// A VarDecl record.
1310
1311 /// An ImplicitParamDecl record.
1313
1314 /// A ParmVarDecl record.
1316
1317 /// A DecompositionDecl record.
1319
1320 /// A BindingDecl record.
1322
1323 /// A FileScopeAsmDecl record.
1325
1326 /// A TopLevelStmtDecl record.
1328
1329 /// A BlockDecl record.
1331
1332 /// A OutlinedFunctionDecl record.
1334
1335 /// A CapturedDecl record.
1337
1338 /// A record that stores the set of declarations that are
1339 /// lexically stored within a given DeclContext.
1340 ///
1341 /// The record itself is a blob that is an array of declaration IDs,
1342 /// in the order in which those declarations were added to the
1343 /// declaration context. This data is used when iterating over
1344 /// the contents of a DeclContext, e.g., via
1345 /// DeclContext::decls_begin() and DeclContext::decls_end().
1347
1348 /// A record that stores the set of declarations that are
1349 /// visible from a given DeclContext.
1350 ///
1351 /// The record itself stores a set of mappings, each of which
1352 /// associates a declaration name with one or more declaration
1353 /// IDs. This data is used when performing qualified name lookup
1354 /// into a DeclContext via DeclContext::lookup.
1356
1357 /// A record containing the set of declarations that are
1358 /// only visible from DeclContext in the same module.
1360
1361 /// A record that stores the set of declarations that are only visible
1362 /// to the TU.
1364
1365 /// A LabelDecl record.
1367
1368 /// A NamespaceDecl record.
1370
1371 /// A NamespaceAliasDecl record.
1373
1374 /// A UsingDecl record.
1376
1377 /// A UsingEnumDecl record.
1379
1380 /// A UsingPackDecl record.
1382
1383 /// A UsingShadowDecl record.
1385
1386 /// A ConstructorUsingShadowDecl record.
1388
1389 /// A UsingDirecitveDecl record.
1391
1392 /// An UnresolvedUsingValueDecl record.
1394
1395 /// An UnresolvedUsingTypenameDecl record.
1397
1398 /// A LinkageSpecDecl record.
1400
1401 /// An ExportDecl record.
1403
1404 /// A CXXRecordDecl record.
1406
1407 /// A CXXDeductionGuideDecl record.
1409
1410 /// A CXXMethodDecl record.
1412
1413 /// A CXXConstructorDecl record.
1415
1416 /// A CXXDestructorDecl record.
1418
1419 /// A CXXConversionDecl record.
1421
1422 /// An AccessSpecDecl record.
1424
1425 /// A FriendDecl record.
1427
1428 /// A FriendTemplateDecl record.
1430
1431 /// A ClassTemplateDecl record.
1433
1434 /// A ClassTemplateSpecializationDecl record.
1436
1437 /// A ClassTemplatePartialSpecializationDecl record.
1439
1440 /// A VarTemplateDecl record.
1442
1443 /// A VarTemplateSpecializationDecl record.
1445
1446 /// A VarTemplatePartialSpecializationDecl record.
1448
1449 /// A FunctionTemplateDecl record.
1451
1452 /// A TemplateTypeParmDecl record.
1454
1455 /// A NonTypeTemplateParmDecl record.
1457
1458 /// A TemplateTemplateParmDecl record.
1460
1461 /// A TypeAliasTemplateDecl record.
1463
1464 /// \brief A ConceptDecl record.
1466
1467 /// An UnresolvedUsingIfExistsDecl record.
1469
1470 /// \brief A StaticAssertDecl record.
1472
1473 /// A record containing CXXBaseSpecifiers.
1475
1476 /// A record containing CXXCtorInitializers.
1478
1479 /// A IndirectFieldDecl record.
1481
1482 /// A NonTypeTemplateParmDecl record that stores an expanded
1483 /// non-type template parameter pack.
1485
1486 /// A TemplateTemplateParmDecl record that stores an expanded
1487 /// template template parameter pack.
1489
1490 /// An ImportDecl recording a module import.
1492
1493 /// An OMPThreadPrivateDecl record.
1495
1496 /// An OMPRequiresDecl record.
1498
1499 /// An OMPAllocateDcl record.
1501
1502 /// An EmptyDecl record.
1504
1505 /// An LifetimeExtendedTemporaryDecl record.
1507
1508 /// A RequiresExprBodyDecl record.
1510
1511 /// An ObjCTypeParamDecl record.
1513
1514 /// An OMPCapturedExprDecl record.
1516
1517 /// A PragmaCommentDecl record.
1519
1520 /// A PragmaDetectMismatchDecl record.
1522
1523 /// An OMPDeclareMapperDecl record.
1525
1526 /// An OMPDeclareReductionDecl record.
1528
1529 /// A UnnamedGlobalConstantDecl record.
1531
1532 /// A HLSLBufferDecl record.
1534
1535 /// An ImplicitConceptSpecializationDecl record.
1537
1538 // A decls specialization record.
1540
1541 // A decls specialization record.
1543
1544 // An OpenACCDeclareDecl record.
1546
1547 // An OpenACCRoutineDecl record.
1549
1550 /// An ExplicitInstantiationDecl record.
1552
1554};
1555
1556/// Record codes for each kind of statement or expression.
1557///
1558/// These constants describe the records that describe statements
1559/// or expressions. These records occur within type and declarations
1560/// block, so they begin with record values of 128. Each constant
1561/// describes a record for a specific statement or expression class in the
1562/// AST.
1564 /// A marker record that indicates that we are at the end
1565 /// of an expression.
1567
1568 /// A NULL expression.
1570
1571 /// A reference to a previously [de]serialized Stmt record.
1573
1574 /// A NullStmt record.
1576
1577 /// A CompoundStmt record.
1579
1580 /// A CaseStmt record.
1582
1583 /// A DefaultStmt record.
1585
1586 /// A LabelStmt record.
1588
1589 /// An AttributedStmt record.
1591
1592 /// An IfStmt record.
1594
1595 /// A SwitchStmt record.
1597
1598 /// A WhileStmt record.
1600
1601 /// A DoStmt record.
1603
1604 /// A ForStmt record.
1606
1607 /// A GotoStmt record.
1609
1610 /// An IndirectGotoStmt record.
1612
1613 /// A ContinueStmt record.
1615
1616 /// A BreakStmt record.
1618
1619 /// A ReturnStmt record.
1621
1622 /// A DeclStmt record.
1624
1625 /// A CapturedStmt record.
1627
1628 /// A SYCLKernelCallStmt record.
1630
1631 /// An UnresolvedSYCLKernelCallStmt record.
1633
1634 /// A GCC-style AsmStmt record.
1636
1637 /// A MS-style AsmStmt record.
1639
1640 /// A constant expression context.
1642
1643 /// A PredefinedExpr record.
1645
1646 /// A DeclRefExpr record.
1648
1649 /// An IntegerLiteral record.
1651
1652 /// A FloatingLiteral record.
1654
1655 /// An ImaginaryLiteral record.
1657
1658 /// A StringLiteral record.
1660
1661 /// A CharacterLiteral record.
1663
1664 /// A ParenExpr record.
1666
1667 /// A ParenListExpr record.
1669
1670 /// A UnaryOperator record.
1672
1673 /// An OffsetOfExpr record.
1675
1676 /// A SizefAlignOfExpr record.
1678
1679 /// An ArraySubscriptExpr record.
1681
1682 /// An MatrixSubscriptExpr record.
1684
1685 /// A CallExpr record.
1687
1688 /// A MemberExpr record.
1690
1691 /// A BinaryOperator record.
1693
1694 /// A CompoundAssignOperator record.
1696
1697 /// A ConditionOperator record.
1699
1700 /// An ImplicitCastExpr record.
1702
1703 /// A CStyleCastExpr record.
1705
1706 /// A CompoundLiteralExpr record.
1708
1709 /// An ExtVectorElementExpr record.
1711
1712 /// A MatrixElementExpr record.
1714
1715 /// An InitListExpr record.
1717
1718 /// A DesignatedInitExpr record.
1720
1721 /// A DesignatedInitUpdateExpr record.
1723
1724 /// An NoInitExpr record.
1726
1727 /// An ArrayInitLoopExpr record.
1729
1730 /// An ArrayInitIndexExpr record.
1732
1733 /// An ImplicitValueInitExpr record.
1735
1736 /// A VAArgExpr record.
1738
1739 /// An AddrLabelExpr record.
1741
1742 /// A StmtExpr record.
1744
1745 /// A ChooseExpr record.
1747
1748 /// A GNUNullExpr record.
1750
1751 /// A SourceLocExpr record.
1753
1754 /// A EmbedExpr record.
1756
1757 /// A ShuffleVectorExpr record.
1759
1760 /// A ConvertVectorExpr record.
1762
1763 /// BlockExpr
1765
1766 /// A GenericSelectionExpr record.
1768
1769 /// A PseudoObjectExpr record.
1771
1772 /// An AtomicExpr record.
1774
1775 /// A RecoveryExpr record.
1777
1778 // Objective-C
1779
1780 /// An ObjCStringLiteral record.
1782
1786
1787 /// An ObjCEncodeExpr record.
1789
1790 /// An ObjCSelectorExpr record.
1792
1793 /// An ObjCProtocolExpr record.
1795
1796 /// An ObjCIvarRefExpr record.
1798
1799 /// An ObjCPropertyRefExpr record.
1801
1802 /// An ObjCSubscriptRefExpr record.
1804
1805 /// UNUSED
1807
1808 /// An ObjCMessageExpr record.
1810
1811 /// An ObjCIsa Expr record.
1813
1814 /// An ObjCIndirectCopyRestoreExpr record.
1816
1817 /// An ObjCForCollectionStmt record.
1819
1820 /// An ObjCAtCatchStmt record.
1822
1823 /// An ObjCAtFinallyStmt record.
1825
1826 /// An ObjCAtTryStmt record.
1828
1829 /// An ObjCAtSynchronizedStmt record.
1831
1832 /// An ObjCAtThrowStmt record.
1834
1835 /// An ObjCAutoreleasePoolStmt record.
1837
1838 /// An ObjCBoolLiteralExpr record.
1840
1841 /// An ObjCAvailabilityCheckExpr record.
1843
1844 // C++
1845
1846 /// A CXXCatchStmt record.
1848
1849 /// A CXXTryStmt record.
1851 /// A CXXForRangeStmt record.
1852
1854
1855 /// A CXXOperatorCallExpr record.
1857
1858 /// A CXXMemberCallExpr record.
1860
1861 /// A CXXRewrittenBinaryOperator record.
1863
1864 /// A CXXConstructExpr record.
1866
1867 /// A CXXInheritedCtorInitExpr record.
1869
1870 /// A CXXTemporaryObjectExpr record.
1872
1873 /// A CXXStaticCastExpr record.
1875
1876 /// A CXXDynamicCastExpr record.
1878
1879 /// A CXXReinterpretCastExpr record.
1881
1882 /// A CXXConstCastExpr record.
1884
1885 /// A CXXAddrspaceCastExpr record.
1887
1888 /// A CXXFunctionalCastExpr record.
1890
1891 /// A BuiltinBitCastExpr record.
1893
1894 /// A UserDefinedLiteral record.
1896
1897 /// A CXXStdInitializerListExpr record.
1899
1900 /// A CXXBoolLiteralExpr record.
1902
1903 /// A CXXParenListInitExpr record.
1905
1906 EXPR_CXX_NULL_PTR_LITERAL, // CXXNullPtrLiteralExpr
1907 EXPR_CXX_TYPEID_EXPR, // CXXTypeidExpr (of expr).
1908 EXPR_CXX_TYPEID_TYPE, // CXXTypeidExpr (of type).
1909 EXPR_CXX_THIS, // CXXThisExpr
1910 EXPR_CXX_THROW, // CXXThrowExpr
1911 EXPR_CXX_DEFAULT_ARG, // CXXDefaultArgExpr
1912 EXPR_CXX_DEFAULT_INIT, // CXXDefaultInitExpr
1913 EXPR_CXX_BIND_TEMPORARY, // CXXBindTemporaryExpr
1914
1915 EXPR_CXX_SCALAR_VALUE_INIT, // CXXScalarValueInitExpr
1916 EXPR_CXX_NEW, // CXXNewExpr
1917 EXPR_CXX_DELETE, // CXXDeleteExpr
1918 EXPR_CXX_PSEUDO_DESTRUCTOR, // CXXPseudoDestructorExpr
1919
1920 EXPR_EXPR_WITH_CLEANUPS, // ExprWithCleanups
1921
1922 EXPR_CXX_DEPENDENT_SCOPE_MEMBER, // CXXDependentScopeMemberExpr
1923 EXPR_CXX_DEPENDENT_SCOPE_DECL_REF, // DependentScopeDeclRefExpr
1924 EXPR_CXX_UNRESOLVED_CONSTRUCT, // CXXUnresolvedConstructExpr
1925 EXPR_CXX_UNRESOLVED_MEMBER, // UnresolvedMemberExpr
1926 EXPR_CXX_UNRESOLVED_LOOKUP, // UnresolvedLookupExpr
1927
1928 EXPR_CXX_EXPRESSION_TRAIT, // ExpressionTraitExpr
1929 EXPR_CXX_NOEXCEPT, // CXXNoexceptExpr
1930
1931 EXPR_OPAQUE_VALUE, // OpaqueValueExpr
1932 EXPR_BINARY_CONDITIONAL_OPERATOR, // BinaryConditionalOperator
1933 EXPR_TYPE_TRAIT, // TypeTraitExpr
1934 EXPR_ARRAY_TYPE_TRAIT, // ArrayTypeTraitIntExpr
1935
1936 EXPR_PACK_EXPANSION, // PackExpansionExpr
1937 EXPR_PACK_INDEXING, // PackIndexingExpr
1938 EXPR_SIZEOF_PACK, // SizeOfPackExpr
1939 EXPR_SUBST_NON_TYPE_TEMPLATE_PARM, // SubstNonTypeTemplateParmExpr
1940 EXPR_SUBST_NON_TYPE_TEMPLATE_PARM_PACK, // SubstNonTypeTemplateParmPackExpr
1941 EXPR_FUNCTION_PARM_PACK, // FunctionParmPackExpr
1942 EXPR_MATERIALIZE_TEMPORARY, // MaterializeTemporaryExpr
1943 EXPR_CXX_FOLD, // CXXFoldExpr
1944 EXPR_CONCEPT_SPECIALIZATION, // ConceptSpecializationExpr
1945 EXPR_REQUIRES, // RequiresExpr
1946
1947 // Reflection
1949
1950 // CUDA
1951 EXPR_CUDA_KERNEL_CALL, // CUDAKernelCallExpr
1952
1953 // OpenCL
1954 EXPR_ASTYPE, // AsTypeExpr
1955
1956 // Microsoft
1957 EXPR_CXX_PROPERTY_REF_EXPR, // MSPropertyRefExpr
1958 EXPR_CXX_PROPERTY_SUBSCRIPT_EXPR, // MSPropertySubscriptExpr
1959 EXPR_CXX_UUIDOF_EXPR, // CXXUuidofExpr (of expr).
1960 EXPR_CXX_UUIDOF_TYPE, // CXXUuidofExpr (of type).
1961 STMT_SEH_LEAVE, // SEHLeaveStmt
1962 STMT_SEH_EXCEPT, // SEHExceptStmt
1963 STMT_SEH_FINALLY, // SEHFinallyStmt
1964 STMT_SEH_TRY, // SEHTryStmt
1965
1966 // OpenMP directives
2049
2050 // ARC
2051 EXPR_OBJC_BRIDGED_CAST, // ObjCBridgedCastExpr
2052
2053 STMT_MS_DEPENDENT_EXISTS, // MSDependentExistsStmt
2054 EXPR_LAMBDA, // LambdaExpr
2060
2061 // FixedPointLiteral
2063
2064 // SYCLUniqueStableNameExpr
2066
2067 // OpenACC Constructs/Exprs
2083
2084 // HLSL Constructs
2086
2088};
2089
2090/// The kinds of designators that can occur in a
2091/// DesignatedInitExpr.
2093 /// Field designator where only the field name is known.
2095
2096 /// Field designator where the field has been resolved to
2097 /// a declaration.
2099
2100 /// Array designator.
2102
2103 /// GNU array range designator.
2105};
2106
2107/// The different kinds of data that can occur in a
2108/// CtorInitializer.
2115
2116/// Kinds of cleanup objects owned by ExprWithCleanups.
2118
2119/// Describes the categories of an Objective-C class.
2121 // The ID of the definition. Use unaligned_decl_id_t to keep
2122 // ObjCCategoriesInfo 32-bit aligned.
2124
2125 // Offset into the array of category lists.
2126 unsigned Offset;
2127
2130 : DefinitionID(ID.getRawValue()), Offset(Offset) {}
2131
2133
2134 friend bool operator<(const ObjCCategoriesInfo &X,
2135 const ObjCCategoriesInfo &Y) {
2136 return X.getDefinitionID() < Y.getDefinitionID();
2137 }
2138
2139 friend bool operator>(const ObjCCategoriesInfo &X,
2140 const ObjCCategoriesInfo &Y) {
2141 return X.getDefinitionID() > Y.getDefinitionID();
2142 }
2143
2144 friend bool operator<=(const ObjCCategoriesInfo &X,
2145 const ObjCCategoriesInfo &Y) {
2146 return X.getDefinitionID() <= Y.getDefinitionID();
2147 }
2148
2149 friend bool operator>=(const ObjCCategoriesInfo &X,
2150 const ObjCCategoriesInfo &Y) {
2151 return X.getDefinitionID() >= Y.getDefinitionID();
2152 }
2153};
2154
2155static_assert(alignof(ObjCCategoriesInfo) <= 4);
2156static_assert(std::is_standard_layout_v<ObjCCategoriesInfo> &&
2157 std::is_trivial_v<ObjCCategoriesInfo>);
2158
2159/// A key used when looking up entities by \ref DeclarationName.
2160///
2161/// Different \ref DeclarationNames are mapped to different keys, but the
2162/// same key can occasionally represent multiple names (for names that
2163/// contain types, in particular).
2165 using NameKind = unsigned;
2166
2167 NameKind Kind = 0;
2168 uint64_t Data = 0;
2169
2170public:
2173 DeclarationNameKey(NameKind Kind, uint64_t Data) : Kind(Kind), Data(Data) {}
2174
2175 NameKind getKind() const { return Kind; }
2176
2178 assert(Kind == DeclarationName::Identifier ||
2181 return (IdentifierInfo *)Data;
2182 }
2183
2185 assert(Kind == DeclarationName::ObjCZeroArgSelector ||
2188 return Selector(Data);
2189 }
2190
2195
2196 /// Compute a fingerprint of this key for use in on-disk hash table.
2197 unsigned getHash() const;
2198
2199 friend bool operator==(const DeclarationNameKey &A,
2200 const DeclarationNameKey &B) {
2201 return A.Kind == B.Kind && A.Data == B.Data;
2202 }
2203};
2204
2205/// @}
2206
2207} // namespace serialization
2208} // namespace clang
2209
2210namespace llvm {
2211
2212template <> struct DenseMapInfo<clang::serialization::DeclarationNameKey> {
2216
2217 static unsigned
2219 return Key.getHash();
2220 }
2221
2224 return L == R;
2225 }
2226};
2227
2228} // namespace llvm
2229
2230#endif // LLVM_CLANG_SERIALIZATION_ASTBITCODES_H
Defines the clang::IdentifierInfo, clang::IdentifierTable, and clang::Selector interfaces.
#define X(type, name)
Definition Value.h:97
Defines an enumeration for C++ overloaded operators.
Defines the clang::SourceLocation class and associated facilities.
C Language Family Type Representation.
uint64_t DeclID
An ID number that refers to a declaration in an AST file.
Definition DeclID.h:108
The name of a declaration.
One of these records is kept for each identifier that is lexed.
A (possibly-)qualified type.
Definition TypeBase.h:937
static QualType getFromOpaquePtr(const void *Ptr)
Definition TypeBase.h:986
@ FastWidth
The width of the "fast" qualifier mask.
Definition TypeBase.h:376
Smart pointer class that efficiently represents Objective-C method names.
DeclOffset(RawLocEncoding RawLoc, uint64_t BitOffset, uint64_t DeclTypesBlockStartOffset)
RawLocEncoding getRawLoc() const
void setBitOffset(uint64_t Offset, const uint64_t DeclTypesBlockStartOffset)
uint64_t getBitOffset(const uint64_t DeclTypesBlockStartOffset) const
void setRawLoc(RawLocEncoding Loc)
A key used when looking up entities by DeclarationName.
unsigned getHash() const
Compute a fingerprint of this key for use in on-disk hash table.
friend bool operator==(const DeclarationNameKey &A, const DeclarationNameKey &B)
OverloadedOperatorKind getOperatorKind() const
DeclarationNameKey(NameKind Kind, uint64_t Data)
IdentifierInfo * getIdentifier() const
RawLocEncoding getBegin() const
PPEntityOffset(RawLocEncoding Begin, RawLocEncoding End, uint32_t BitOffset)
PPSkippedRange(RawLocEncoding Begin, RawLocEncoding End)
RawLocEncoding getBegin() const
uint32_t getModuleFileIndex() const
TypeIdx(uint32_t ModuleFileIdx, uint32_t Idx)
static TypeIdx fromTypeID(TypeID ID)
TypeID asTypeID(unsigned FastQuals) const
32 aligned uint64_t in the AST file.
PredefinedTypeIDs
Predefined type IDs.
CtorInitializerType
The different kinds of data that can occur in a CtorInitializer.
const unsigned int LOCAL_REDECLARATIONS
Record code for a list of local redeclarations of a declaration.
CleanupObjectKind
Kinds of cleanup objects owned by ExprWithCleanups.
const unsigned NUM_PREDEF_TYPE_IDS
The number of predefined type IDs that are reserved for the PREDEF_TYPE_* constants.
DeclCode
Record codes for each kind of declaration.
const unsigned NumSpecialTypeIDs
The number of special type IDs.
TypeCode
Record codes for each kind of type.
SpecialTypeIDs
The type IDs for special types constructed by semantic analysis.
StmtCode
Record codes for each kind of statement or expression.
DesignatorTypes
The kinds of designators that can occur in a DesignatedInitExpr.
const unsigned int DECL_UPDATES
Record of updates for a declaration that was modified after being deserialized.
@ PREDEF_TYPE_LONG_ACCUM_ID
The 'long _Accum' type.
@ PREDEF_TYPE_SAMPLER_ID
OpenCL sampler type.
@ PREDEF_TYPE_INT128_ID
The '__int128_t' type.
@ PREDEF_TYPE_CHAR32_ID
The C++ 'char32_t' type.
@ PREDEF_TYPE_SAT_SHORT_ACCUM_ID
The '_Sat short _Accum' type.
@ PREDEF_TYPE_IBM128_ID
The '__ibm128' type.
@ PREDEF_TYPE_SHORT_FRACT_ID
The 'short _Fract' type.
@ PREDEF_TYPE_AUTO_RREF_DEDUCT
The "auto &&" deduction type.
@ PREDEF_TYPE_BOUND_MEMBER
The placeholder type for bound member functions.
@ PREDEF_TYPE_LONGLONG_ID
The (signed) 'long long' type.
@ PREDEF_TYPE_FRACT_ID
The '_Fract' type.
@ PREDEF_TYPE_ARC_UNBRIDGED_CAST
ARC's unbridged-cast placeholder type.
@ PREDEF_TYPE_USHORT_FRACT_ID
The 'unsigned short _Fract' type.
@ PREDEF_TYPE_SAT_ULONG_FRACT_ID
The '_Sat unsigned long _Fract' type.
@ PREDEF_TYPE_BOOL_ID
The 'bool' or '_Bool' type.
@ PREDEF_TYPE_SAT_LONG_ACCUM_ID
The '_Sat long _Accum' type.
@ PREDEF_TYPE_SAT_LONG_FRACT_ID
The '_Sat long _Fract' type.
@ PREDEF_TYPE_SAT_SHORT_FRACT_ID
The '_Sat short _Fract' type.
@ PREDEF_TYPE_CHAR_U_ID
The 'char' type, when it is unsigned.
@ PREDEF_TYPE_RESERVE_ID_ID
OpenCL reserve_id type.
@ PREDEF_TYPE_SAT_ACCUM_ID
The '_Sat _Accum' type.
@ PREDEF_TYPE_BUILTIN_FN
The placeholder type for builtin functions.
@ PREDEF_TYPE_SHORT_ACCUM_ID
The 'short _Accum' type.
@ PREDEF_TYPE_FLOAT_ID
The 'float' type.
@ PREDEF_TYPE_QUEUE_ID
OpenCL queue type.
@ PREDEF_TYPE_INT_ID
The (signed) 'int' type.
@ PREDEF_TYPE_OBJC_SEL
The ObjC 'SEL' type.
@ PREDEF_TYPE_BFLOAT16_ID
The '__bf16' type.
@ PREDEF_TYPE_WCHAR_ID
The C++ 'wchar_t' type.
@ PREDEF_TYPE_UCHAR_ID
The 'unsigned char' type.
@ PREDEF_TYPE_UACCUM_ID
The 'unsigned _Accum' type.
@ PREDEF_TYPE_SCHAR_ID
The 'signed char' type.
@ PREDEF_TYPE_CHAR_S_ID
The 'char' type, when it is signed.
@ PREDEF_TYPE_NULLPTR_ID
The type of 'nullptr'.
@ PREDEF_TYPE_ULONG_FRACT_ID
The 'unsigned long _Fract' type.
@ PREDEF_TYPE_FLOAT16_ID
The '_Float16' type.
@ PREDEF_TYPE_UINT_ID
The 'unsigned int' type.
@ PREDEF_TYPE_FLOAT128_ID
The '__float128' type.
@ PREDEF_TYPE_OBJC_ID
The ObjC 'id' type.
@ PREDEF_TYPE_CHAR16_ID
The C++ 'char16_t' type.
@ PREDEF_TYPE_ARRAY_SECTION
The placeholder type for an array section.
@ PREDEF_TYPE_ULONGLONG_ID
The 'unsigned long long' type.
@ PREDEF_TYPE_SAT_UFRACT_ID
The '_Sat unsigned _Fract' type.
@ PREDEF_TYPE_USHORT_ID
The 'unsigned short' type.
@ PREDEF_TYPE_SHORT_ID
The (signed) 'short' type.
@ PREDEF_TYPE_OMP_ARRAY_SHAPING
The placeholder type for OpenMP array shaping operation.
@ PREDEF_TYPE_DEPENDENT_ID
The placeholder type for dependent types.
@ PREDEF_TYPE_LONGDOUBLE_ID
The 'long double' type.
@ PREDEF_TYPE_DOUBLE_ID
The 'double' type.
@ PREDEF_TYPE_UINT128_ID
The '__uint128_t' type.
@ PREDEF_TYPE_HALF_ID
The OpenCL 'half' / ARM NEON __fp16 type.
@ PREDEF_TYPE_VOID_ID
The void type.
@ PREDEF_TYPE_SAT_USHORT_FRACT_ID
The '_Sat unsigned short _Fract' type.
@ PREDEF_TYPE_ACCUM_ID
The '_Accum' type.
@ PREDEF_TYPE_SAT_FRACT_ID
The '_Sat _Fract' type.
@ PREDEF_TYPE_NULL_ID
The NULL type.
@ PREDEF_TYPE_USHORT_ACCUM_ID
The 'unsigned short _Accum' type.
@ PREDEF_TYPE_CHAR8_ID
The C++ 'char8_t' type.
@ PREDEF_TYPE_UFRACT_ID
The 'unsigned _Fract' type.
@ PREDEF_TYPE_OVERLOAD_ID
The placeholder type for overloaded function sets.
@ PREDEF_TYPE_INCOMPLETE_MATRIX_IDX
A placeholder type for incomplete matrix index operations.
@ PREDEF_TYPE_UNRESOLVED_TEMPLATE
The placeholder type for unresolved templates.
@ PREDEF_TYPE_SAT_USHORT_ACCUM_ID
The '_Sat unsigned short _Accum' type.
@ PREDEF_TYPE_LONG_ID
The (signed) 'long' type.
@ PREDEF_TYPE_SAT_ULONG_ACCUM_ID
The '_Sat unsigned long _Accum' type.
@ PREDEF_TYPE_LONG_FRACT_ID
The 'long _Fract' type.
@ PREDEF_TYPE_UNKNOWN_ANY
The 'unknown any' placeholder type.
@ PREDEF_TYPE_OMP_ITERATOR
The placeholder type for OpenMP iterator expression.
@ PREDEF_TYPE_PSEUDO_OBJECT
The pseudo-object placeholder type.
@ PREDEF_TYPE_OBJC_CLASS
The ObjC 'Class' type.
@ PREDEF_TYPE_ULONG_ID
The 'unsigned long' type.
@ PREDEF_TYPE_SAT_UACCUM_ID
The '_Sat unsigned _Accum' type.
@ PREDEF_TYPE_CLK_EVENT_ID
OpenCL clk event type.
@ PREDEF_TYPE_EVENT_ID
OpenCL event type.
@ PREDEF_TYPE_ULONG_ACCUM_ID
The 'unsigned long _Accum' type.
@ PREDEF_TYPE_AUTO_DEDUCT
The "auto" deduction type.
@ DECL_EMPTY
An EmptyDecl record.
@ DECL_CAPTURED
A CapturedDecl record.
@ DECL_CXX_BASE_SPECIFIERS
A record containing CXXBaseSpecifiers.
@ DECL_CXX_RECORD
A CXXRecordDecl record.
@ DECL_VAR_TEMPLATE_PARTIAL_SPECIALIZATION
A VarTemplatePartialSpecializationDecl record.
@ DECL_OMP_ALLOCATE
An OMPAllocateDcl record.
@ DECL_MS_PROPERTY
A MSPropertyDecl record.
@ DECL_OMP_DECLARE_MAPPER
An OMPDeclareMapperDecl record.
@ DECL_TOP_LEVEL_STMT_DECL
A TopLevelStmtDecl record.
@ DECL_REQUIRES_EXPR_BODY
A RequiresExprBodyDecl record.
@ DECL_STATIC_ASSERT
A StaticAssertDecl record.
@ DECL_INDIRECTFIELD
A IndirectFieldDecl record.
@ DECL_TEMPLATE_TEMPLATE_PARM
A TemplateTemplateParmDecl record.
@ DECL_IMPORT
An ImportDecl recording a module import.
@ DECL_UNNAMED_GLOBAL_CONSTANT
A UnnamedGlobalConstantDecl record.
@ DECL_ACCESS_SPEC
An AccessSpecDecl record.
@ DECL_OBJC_TYPE_PARAM
An ObjCTypeParamDecl record.
@ DECL_OBJC_CATEGORY_IMPL
A ObjCCategoryImplDecl record.
@ DECL_ENUM_CONSTANT
An EnumConstantDecl record.
@ DECL_PARM_VAR
A ParmVarDecl record.
@ DECL_TYPEDEF
A TypedefDecl record.
@ DECL_EXPANDED_TEMPLATE_TEMPLATE_PARM_PACK
A TemplateTemplateParmDecl record that stores an expanded template template parameter pack.
@ DECL_HLSL_BUFFER
A HLSLBufferDecl record.
@ DECL_NAMESPACE_ALIAS
A NamespaceAliasDecl record.
@ DECL_TYPEALIAS
A TypeAliasDecl record.
@ DECL_FUNCTION_TEMPLATE
A FunctionTemplateDecl record.
@ DECL_MS_GUID
A MSGuidDecl record.
@ DECL_UNRESOLVED_USING_TYPENAME
An UnresolvedUsingTypenameDecl record.
@ DECL_CLASS_TEMPLATE_SPECIALIZATION
A ClassTemplateSpecializationDecl record.
@ DECL_FILE_SCOPE_ASM
A FileScopeAsmDecl record.
@ DECL_CXX_CONSTRUCTOR
A CXXConstructorDecl record.
@ DECL_CXX_CONVERSION
A CXXConversionDecl record.
@ DECL_FIELD
A FieldDecl record.
@ DECL_LINKAGE_SPEC
A LinkageSpecDecl record.
@ DECL_CONTEXT_TU_LOCAL_VISIBLE
A record that stores the set of declarations that are only visible to the TU.
@ DECL_NAMESPACE
A NamespaceDecl record.
@ DECL_NON_TYPE_TEMPLATE_PARM
A NonTypeTemplateParmDecl record.
@ DECL_USING_PACK
A UsingPackDecl record.
@ DECL_FUNCTION
A FunctionDecl record.
@ DECL_USING_DIRECTIVE
A UsingDirecitveDecl record.
@ DECL_RECORD
A RecordDecl record.
@ DECL_CONTEXT_LEXICAL
A record that stores the set of declarations that are lexically stored within a given DeclContext.
@ DECL_OUTLINEDFUNCTION
A OutlinedFunctionDecl record.
@ DECL_BLOCK
A BlockDecl record.
@ DECL_UNRESOLVED_USING_VALUE
An UnresolvedUsingValueDecl record.
@ DECL_TYPE_ALIAS_TEMPLATE
A TypeAliasTemplateDecl record.
@ DECL_CXX_CTOR_INITIALIZERS
A record containing CXXCtorInitializers.
@ DECL_OBJC_CATEGORY
A ObjCCategoryDecl record.
@ DECL_VAR
A VarDecl record.
@ DECL_UNRESOLVED_USING_IF_EXISTS
An UnresolvedUsingIfExistsDecl record.
@ DECL_USING
A UsingDecl record.
@ DECL_OBJC_PROTOCOL
A ObjCProtocolDecl record.
@ DECL_TEMPLATE_TYPE_PARM
A TemplateTypeParmDecl record.
@ DECL_VAR_TEMPLATE_SPECIALIZATION
A VarTemplateSpecializationDecl record.
@ DECL_OBJC_IMPLEMENTATION
A ObjCImplementationDecl record.
@ DECL_LABEL
A LabelDecl record.
@ DECL_OBJC_COMPATIBLE_ALIAS
A ObjCCompatibleAliasDecl record.
@ DECL_CONSTRUCTOR_USING_SHADOW
A ConstructorUsingShadowDecl record.
@ DECL_USING_ENUM
A UsingEnumDecl record.
@ DECL_FRIEND_TEMPLATE
A FriendTemplateDecl record.
@ DECL_PRAGMA_DETECT_MISMATCH
A PragmaDetectMismatchDecl record.
@ DECL_EXPANDED_NON_TYPE_TEMPLATE_PARM_PACK
A NonTypeTemplateParmDecl record that stores an expanded non-type template parameter pack.
@ DECL_OBJC_AT_DEFS_FIELD
A ObjCAtDefsFieldDecl record.
@ DECL_IMPLICIT_PARAM
An ImplicitParamDecl record.
@ DECL_FRIEND
A FriendDecl record.
@ DECL_CXX_METHOD
A CXXMethodDecl record.
@ DECL_EXPORT
An ExportDecl record.
@ DECL_BINDING
A BindingDecl record.
@ DECL_PRAGMA_COMMENT
A PragmaCommentDecl record.
@ DECL_ENUM
An EnumDecl record.
@ DECL_CONTEXT_MODULE_LOCAL_VISIBLE
A record containing the set of declarations that are only visible from DeclContext in the same module...
@ DECL_DECOMPOSITION
A DecompositionDecl record.
@ DECL_OMP_DECLARE_REDUCTION
An OMPDeclareReductionDecl record.
@ DECL_OMP_THREADPRIVATE
An OMPThreadPrivateDecl record.
@ DECL_OBJC_METHOD
A ObjCMethodDecl record.
@ DECL_CXX_DESTRUCTOR
A CXXDestructorDecl record.
@ DECL_EXPLICIT_INSTANTIATION
An ExplicitInstantiationDecl record.
@ DECL_OMP_CAPTUREDEXPR
An OMPCapturedExprDecl record.
@ DECL_CLASS_TEMPLATE
A ClassTemplateDecl record.
@ DECL_USING_SHADOW
A UsingShadowDecl record.
@ DECL_CONCEPT
A ConceptDecl record.
@ DECL_CXX_DEDUCTION_GUIDE
A CXXDeductionGuideDecl record.
@ DECL_OMP_REQUIRES
An OMPRequiresDecl record.
@ DECL_OBJC_IVAR
A ObjCIvarDecl record.
@ DECL_OBJC_PROPERTY
A ObjCPropertyDecl record.
@ DECL_TEMPLATE_PARAM_OBJECT
A TemplateParamObjectDecl record.
@ DECL_OBJC_INTERFACE
A ObjCInterfaceDecl record.
@ DECL_VAR_TEMPLATE
A VarTemplateDecl record.
@ DECL_LIFETIME_EXTENDED_TEMPORARY
An LifetimeExtendedTemporaryDecl record.
@ DECL_CLASS_TEMPLATE_PARTIAL_SPECIALIZATION
A ClassTemplatePartialSpecializationDecl record.
@ DECL_IMPLICIT_CONCEPT_SPECIALIZATION
An ImplicitConceptSpecializationDecl record.
@ DECL_CONTEXT_VISIBLE
A record that stores the set of declarations that are visible from a given DeclContext.
@ DECL_OBJC_PROPERTY_IMPL
A ObjCPropertyImplDecl record.
@ TYPE_EXT_QUAL
An ExtQualType record.
@ SPECIAL_TYPE_OBJC_SEL_REDEFINITION
Objective-C "SEL" redefinition type.
@ SPECIAL_TYPE_UCONTEXT_T
C ucontext_t typedef type.
@ SPECIAL_TYPE_JMP_BUF
C jmp_buf typedef type.
@ SPECIAL_TYPE_FILE
C FILE typedef type.
@ SPECIAL_TYPE_SIGJMP_BUF
C sigjmp_buf typedef type.
@ SPECIAL_TYPE_OBJC_CLASS_REDEFINITION
Objective-C "Class" redefinition type.
@ SPECIAL_TYPE_CF_CONSTANT_STRING
CFConstantString type.
@ SPECIAL_TYPE_OBJC_ID_REDEFINITION
Objective-C "id" redefinition type.
@ EXPR_DESIGNATED_INIT
A DesignatedInitExpr record.
@ EXPR_COMPOUND_LITERAL
A CompoundLiteralExpr record.
@ STMT_OMP_DISTRIBUTE_PARALLEL_FOR_SIMD_DIRECTIVE
@ EXPR_OBJC_IVAR_REF_EXPR
An ObjCIvarRefExpr record.
@ EXPR_MEMBER
A MemberExpr record.
@ EXPR_CXX_TEMPORARY_OBJECT
A CXXTemporaryObjectExpr record.
@ STMT_OMP_TARGET_TEAMS_DISTRIBUTE_PARALLEL_FOR_SIMD_DIRECTIVE
@ EXPR_COMPOUND_ASSIGN_OPERATOR
A CompoundAssignOperator record.
@ EXPR_CXX_STATIC_CAST
A CXXStaticCastExpr record.
@ EXPR_OBJC_STRING_LITERAL
An ObjCStringLiteral record.
@ EXPR_VA_ARG
A VAArgExpr record.
@ EXPR_OBJC_ISA
An ObjCIsa Expr record.
@ EXPR_CXX_OPERATOR_CALL
A CXXOperatorCallExpr record.
@ STMT_OBJC_AT_TRY
An ObjCAtTryStmt record.
@ STMT_DO
A DoStmt record.
@ STMT_OBJC_CATCH
An ObjCAtCatchStmt record.
@ STMT_IF
An IfStmt record.
@ EXPR_STRING_LITERAL
A StringLiteral record.
@ EXPR_OBJC_AVAILABILITY_CHECK
An ObjCAvailabilityCheckExpr record.
@ STMT_OMP_PARALLEL_MASKED_TASKLOOP_DIRECTIVE
@ EXPR_MATRIX_SUBSCRIPT
An MatrixSubscriptExpr record.
@ EXPR_PSEUDO_OBJECT
A PseudoObjectExpr record.
@ STMT_OMP_TARGET_TEAMS_DISTRIBUTE_PARALLEL_FOR_DIRECTIVE
@ EXPR_IMPLICIT_CAST
An ImplicitCastExpr record.
@ STMT_CAPTURED
A CapturedStmt record.
@ STMT_OMP_TARGET_PARALLEL_FOR_SIMD_DIRECTIVE
@ STMT_GCCASM
A GCC-style AsmStmt record.
@ EXPR_IMAGINARY_LITERAL
An ImaginaryLiteral record.
@ STMT_WHILE
A WhileStmt record.
@ EXPR_CONVERT_VECTOR
A ConvertVectorExpr record.
@ EXPR_OBJC_SUBSCRIPT_REF_EXPR
An ObjCSubscriptRefExpr record.
@ EXPR_STMT
A StmtExpr record.
@ EXPR_CXX_REINTERPRET_CAST
A CXXReinterpretCastExpr record.
@ EXPR_DESIGNATED_INIT_UPDATE
A DesignatedInitUpdateExpr record.
@ STMT_OBJC_AT_SYNCHRONIZED
An ObjCAtSynchronizedStmt record.
@ STMT_OMP_DISTRIBUTE_PARALLEL_FOR_DIRECTIVE
@ EXPR_BUILTIN_BIT_CAST
A BuiltinBitCastExpr record.
@ STMT_OMP_TARGET_TEAMS_DISTRIBUTE_SIMD_DIRECTIVE
@ STMT_SYCLKERNELCALL
A SYCLKernelCallStmt record.
@ EXPR_CHARACTER_LITERAL
A CharacterLiteral record.
@ EXPR_OBJC_ENCODE
An ObjCEncodeExpr record.
@ EXPR_CSTYLE_CAST
A CStyleCastExpr record.
@ EXPR_OBJC_BOOL_LITERAL
An ObjCBoolLiteralExpr record.
@ EXPR_EXT_VECTOR_ELEMENT
An ExtVectorElementExpr record.
@ EXPR_ATOMIC
An AtomicExpr record.
@ EXPR_OFFSETOF
An OffsetOfExpr record.
@ STMT_RETURN
A ReturnStmt record.
@ STMT_OBJC_FOR_COLLECTION
An ObjCForCollectionStmt record.
@ STMT_OMP_TARGET_TEAMS_DISTRIBUTE_DIRECTIVE
@ EXPR_ARRAY_INIT_LOOP
An ArrayInitLoopExpr record.
@ STMT_OMP_PARALLEL_MASTER_TASKLOOP_DIRECTIVE
@ STMT_OMP_PARALLEL_MASKED_TASKLOOP_SIMD_DIRECTIVE
@ STMT_CONTINUE
A ContinueStmt record.
@ EXPR_PREDEFINED
A PredefinedExpr record.
@ EXPR_CXX_BOOL_LITERAL
A CXXBoolLiteralExpr record.
@ EXPR_PAREN_LIST
A ParenListExpr record.
@ EXPR_CXX_PAREN_LIST_INIT
A CXXParenListInitExpr record.
@ STMT_COMPOUND
A CompoundStmt record.
@ STMT_FOR
A ForStmt record.
@ STMT_ATTRIBUTED
An AttributedStmt record.
@ STMT_UNRESOLVED_SYCL_KERNEL_CALL
An UnresolvedSYCLKernelCallStmt record.
@ STMT_OMP_TARGET_TEAMS_GENERIC_LOOP_DIRECTIVE
@ EXPR_CXX_REWRITTEN_BINARY_OPERATOR
A CXXRewrittenBinaryOperator record.
@ STMT_GOTO
A GotoStmt record.
@ EXPR_NO_INIT
An NoInitExpr record.
@ EXPR_OBJC_PROTOCOL_EXPR
An ObjCProtocolExpr record.
@ EXPR_ARRAY_INIT_INDEX
An ArrayInitIndexExpr record.
@ EXPR_CXX_CONSTRUCT
A CXXConstructExpr record.
@ STMT_OMP_TEAMS_DISTRIBUTE_PARALLEL_FOR_DIRECTIVE
@ STMT_OMP_PARALLEL_MASTER_TASKLOOP_SIMD_DIRECTIVE
@ STMT_OMP_TEAMS_DISTRIBUTE_PARALLEL_FOR_SIMD_DIRECTIVE
@ EXPR_CXX_DYNAMIC_CAST
A CXXDynamicCastExpr record.
@ STMT_CXX_TRY
A CXXTryStmt record.
@ EXPR_GENERIC_SELECTION
A GenericSelectionExpr record.
@ EXPR_OBJC_INDIRECT_COPY_RESTORE
An ObjCIndirectCopyRestoreExpr record.
@ EXPR_CXX_INHERITED_CTOR_INIT
A CXXInheritedCtorInitExpr record.
@ EXPR_CALL
A CallExpr record.
@ EXPR_GNU_NULL
A GNUNullExpr record.
@ EXPR_OBJC_PROPERTY_REF_EXPR
An ObjCPropertyRefExpr record.
@ EXPR_CXX_CONST_CAST
A CXXConstCastExpr record.
@ STMT_REF_PTR
A reference to a previously [de]serialized Stmt record.
@ EXPR_OBJC_MESSAGE_EXPR
An ObjCMessageExpr record.
@ STMT_CASE
A CaseStmt record.
@ EXPR_CONSTANT
A constant expression context.
@ STMT_STOP
A marker record that indicates that we are at the end of an expression.
@ STMT_MSASM
A MS-style AsmStmt record.
@ EXPR_CONDITIONAL_OPERATOR
A ConditionOperator record.
@ EXPR_BINARY_OPERATOR
A BinaryOperator record.
@ EXPR_CXX_STD_INITIALIZER_LIST
A CXXStdInitializerListExpr record.
@ EXPR_SHUFFLE_VECTOR
A ShuffleVectorExpr record.
@ STMT_OBJC_FINALLY
An ObjCAtFinallyStmt record.
@ EXPR_OBJC_SELECTOR_EXPR
An ObjCSelectorExpr record.
@ EXPR_FLOATING_LITERAL
A FloatingLiteral record.
@ STMT_NULL_PTR
A NULL expression.
@ STMT_DEFAULT
A DefaultStmt record.
@ EXPR_CHOOSE
A ChooseExpr record.
@ STMT_NULL
A NullStmt record.
@ EXPR_DECL_REF
A DeclRefExpr record.
@ EXPR_INIT_LIST
An InitListExpr record.
@ EXPR_IMPLICIT_VALUE_INIT
An ImplicitValueInitExpr record.
@ STMT_OBJC_AUTORELEASE_POOL
An ObjCAutoreleasePoolStmt record.
@ EXPR_RECOVERY
A RecoveryExpr record.
@ EXPR_PAREN
A ParenExpr record.
@ STMT_OMP_TARGET_PARALLEL_GENERIC_LOOP_DIRECTIVE
@ STMT_LABEL
A LabelStmt record.
@ EXPR_CXX_FUNCTIONAL_CAST
A CXXFunctionalCastExpr record.
@ EXPR_USER_DEFINED_LITERAL
A UserDefinedLiteral record.
@ EXPR_INTEGER_LITERAL
An IntegerLiteral record.
@ EXPR_SOURCE_LOC
A SourceLocExpr record.
@ EXPR_CXX_MEMBER_CALL
A CXXMemberCallExpr record.
@ STMT_SWITCH
A SwitchStmt record.
@ STMT_DECL
A DeclStmt record.
@ EXPR_OBJC_KVC_REF_EXPR
UNUSED.
@ EXPR_SIZEOF_ALIGN_OF
A SizefAlignOfExpr record.
@ STMT_BREAK
A BreakStmt record.
@ STMT_OBJC_AT_THROW
An ObjCAtThrowStmt record.
@ EXPR_ADDR_LABEL
An AddrLabelExpr record.
@ EXPR_MATRIX_ELEMENT
A MatrixElementExpr record.
@ STMT_CXX_FOR_RANGE
A CXXForRangeStmt record.
@ EXPR_CXX_ADDRSPACE_CAST
A CXXAddrspaceCastExpr record.
@ EXPR_ARRAY_SUBSCRIPT
An ArraySubscriptExpr record.
@ EXPR_UNARY_OPERATOR
A UnaryOperator record.
@ STMT_CXX_CATCH
A CXXCatchStmt record.
@ EXPR_BUILTIN_PP_EMBED
A EmbedExpr record.
@ STMT_INDIRECT_GOTO
An IndirectGotoStmt record.
@ DESIG_ARRAY_RANGE
GNU array range designator.
@ DESIG_FIELD_NAME
Field designator where only the field name is known.
@ DESIG_FIELD_DECL
Field designator where the field has been resolved to a declaration.
@ DESIG_ARRAY
Array designator.
ExtensionBlockRecordTypes
Record code for extension blocks.
@ EXTENSION_METADATA
Metadata describing this particular extension.
@ FIRST_EXTENSION_RECORD_ID
The first record ID allocated to the extensions themselves.
uint32_t CXXCtorInitializersID
An ID number that refers to a list of CXXCtorInitializers in an AST file.
SubmoduleRecordTypes
Record types used within a submodule description block.
@ SUBMODULE_EXCLUDED_HEADER
Specifies a header that has been explicitly excluded from this submodule.
@ SUBMODULE_TOPHEADER
Specifies a top-level header that falls into this (sub)module.
@ SUBMODULE_PRIVATE_TEXTUAL_HEADER
Specifies a header that is private to this submodule but must be textually included.
@ SUBMODULE_HEADER
Specifies a header that falls into this (sub)module.
@ SUBMODULE_EXPORT_AS
Specifies the name of the module that will eventually re-export the entities in this module.
@ SUBMODULE_UMBRELLA_DIR
Specifies an umbrella directory.
@ SUBMODULE_UMBRELLA_HEADER
Specifies the umbrella header used to create this module, if any.
@ SUBMODULE_REQUIRES
Specifies a required feature.
@ SUBMODULE_PRIVATE_HEADER
Specifies a header that is private to this submodule.
@ SUBMODULE_IMPORTS
Specifies the submodules that are imported by this submodule.
@ SUBMODULE_CONFLICT
Specifies a conflict with another module.
@ SUBMODULE_CHILD
Specifies a direct submodule by name and ID, enabling on-demand deserialization of children without l...
@ SUBMODULE_INITIALIZERS
Specifies some declarations with initializers that must be emitted to initialize the module.
@ SUBMODULE_END
Defines the end of a single submodule. Sentinel record without any data.
@ SUBMODULE_DEFINITION
Defines the major attributes of a submodule, including its name and parent.
@ SUBMODULE_LINK_LIBRARY
Specifies a library or framework to link against.
@ SUBMODULE_CONFIG_MACRO
Specifies a configuration macro for this module.
@ SUBMODULE_EXPORTS
Specifies the submodules that are re-exported from this submodule.
@ SUBMODULE_TEXTUAL_HEADER
Specifies a header that is part of the module but must be textually included.
@ SUBMODULE_AFFECTING_MODULES
Specifies affecting modules that were not imported.
uint32_t SelectorID
An ID number that refers to an ObjC selector in an AST file.
const unsigned int NUM_PREDEF_IDENT_IDS
The number of predefined identifier IDs.
Definition ASTBitCodes.h:66
OptionsRecordTypes
Record types that occur within the options block inside the control block.
@ FILE_SYSTEM_OPTIONS
Record code for the filesystem options table.
@ TARGET_OPTIONS
Record code for the target options table.
@ PREPROCESSOR_OPTIONS
Record code for the preprocessor options table.
@ HEADER_SEARCH_OPTIONS
Record code for the headers search options table.
@ CODEGEN_OPTIONS
Record code for the codegen options table.
@ LANGUAGE_OPTIONS
Record code for the language options table.
const unsigned int NUM_PREDEF_PP_ENTITY_IDS
The number of predefined preprocessed entity IDs.
const unsigned int NUM_PREDEF_SUBMODULE_IDS
The number of predefined submodule IDs.
BlockIDs
Describes the various kinds of blocks that occur within an AST file.
@ SUBMODULE_BLOCK_ID
The block containing the submodule structure.
@ PREPROCESSOR_DETAIL_BLOCK_ID
The block containing the detailed preprocessing record.
@ AST_BLOCK_ID
The AST block, which acts as a container around the full AST block.
@ SOURCE_MANAGER_BLOCK_ID
The block containing information about the source manager.
@ CONTROL_BLOCK_ID
The control block, which contains all of the information that needs to be validated prior to committi...
@ DECLTYPES_BLOCK_ID
The block containing the definitions of all of the types and decls used within the AST file.
@ PREPROCESSOR_BLOCK_ID
The block containing information about the preprocessor.
@ COMMENTS_BLOCK_ID
The block containing comments.
@ UNHASHED_CONTROL_BLOCK_ID
A block with unhashed content.
@ EXTENSION_BLOCK_ID
A block containing a module file extension.
@ OPTIONS_BLOCK_ID
The block of configuration options, used to check that a module is being used in a configuration comp...
@ INPUT_FILES_BLOCK_ID
The block of input files, which were used as inputs to create this AST file.
uint32_t CXXBaseSpecifiersID
An ID number that refers to a set of CXXBaseSpecifiers in an AST file.
CommentRecordTypes
Record types used within a comments block.
DeclIDBase::DeclID DeclID
An ID number that refers to a declaration in an AST file.
Definition ASTBitCodes.h:70
const unsigned VERSION_MINOR
AST file minor version number supported by this version of Clang.
Definition ASTBitCodes.h:57
SourceManagerRecordTypes
Record types used within a source manager block.
@ SM_SLOC_FILE_ENTRY
Describes a source location entry (SLocEntry) for a file.
@ SM_SLOC_BUFFER_BLOB_COMPRESSED
Describes a zlib-compressed blob that contains the data for a buffer entry.
@ SM_SLOC_BUFFER_ENTRY
Describes a source location entry (SLocEntry) for a buffer.
@ SM_SLOC_BUFFER_BLOB
Describes a blob that contains the data for a buffer entry.
@ SM_SLOC_EXPANSION_ENTRY
Describes a source location entry (SLocEntry) for a macro expansion.
const unsigned int NUM_PREDEF_SELECTOR_IDS
The number of predefined selector IDs.
const unsigned VERSION_MAJOR
AST file major version number supported by this version of Clang.
Definition ASTBitCodes.h:47
uint64_t PreprocessedEntityID
An ID number that refers to an entity in the detailed preprocessing record.
llvm::support::detail::packed_endian_specific_integral< serialization::DeclID, llvm::endianness::native, llvm::support::unaligned > unaligned_decl_id_t
PreprocessorRecordTypes
Record types used within a preprocessor block.
@ PP_TOKEN
Describes one token.
@ PP_MACRO_FUNCTION_LIKE
A function-like macro definition.
@ PP_MACRO_OBJECT_LIKE
An object-like macro definition.
@ PP_MACRO_DIRECTIVE_HISTORY
The macro directives history for a particular identifier.
@ PP_MODULE_MACRO
A macro directive exported by a module.
ControlRecordTypes
Record types that occur within the control block.
@ MODULE_MAP_FILE
Record code for the module map file that was used to build this AST file.
@ MODULE_DIRECTORY
Record code for the module build directory.
@ ORIGINAL_FILE_ID
Record code for file ID of the file or buffer that was used to generate the AST file.
@ MODULE_NAME
Record code for the module name.
@ ORIGINAL_FILE
Record code for the original file that was used to generate the AST file, including both its file ID ...
@ IMPORT
Record code for another AST file imported by this AST file.
@ INPUT_FILE_OFFSETS
Offsets into the input-files block where input files reside.
@ METADATA
AST file metadata, including the AST file version number and information about the compiler used to b...
UnhashedControlBlockRecordTypes
Record codes for the unhashed control block.
@ DIAGNOSTIC_OPTIONS
Record code for the diagnostic options table.
@ HEADER_SEARCH_ENTRY_USAGE
Record code for the indices of used header search entries.
@ AST_BLOCK_HASH
Record code for the content hash of the AST block.
@ DIAG_PRAGMA_MAPPINGS
Record code for #pragma diagnostic mappings.
@ SIGNATURE
Record code for the signature that identifiers this AST file.
@ HEADER_SEARCH_PATHS
Record code for the headers search paths.
@ VFS_USAGE
Record code for the indices of used VFSs.
uint64_t MacroID
An ID number that refers to a macro in an AST file.
uint64_t GlobalMacroID
A global ID number that refers to a macro in an AST file.
InputFileRecordTypes
Record types that occur within the input-files block inside the control block.
@ INPUT_FILE_HASH
The input file content hash.
@ INPUT_FILE
An input file.
uint64_t TypeID
An ID number that refers to a type in an AST file.
Definition ASTBitCodes.h:88
PreprocessorDetailRecordTypes
Record types used within a preprocessor detail block.
@ PPD_INCLUSION_DIRECTIVE
Describes an inclusion directive within the preprocessing record.
@ PPD_MACRO_EXPANSION
Describes a macro expansion within the preprocessing record.
@ PPD_MACRO_DEFINITION
Describes a macro definition within the preprocessing record.
uint32_t SubmoduleID
An ID number that refers to a submodule in a module file.
const unsigned int NUM_PREDEF_MACRO_IDS
The number of predefined macro IDs.
ASTRecordTypes
Record types that occur within the AST block itself.
@ DECL_UPDATE_OFFSETS
Record for offsets of DECL_UPDATES records for declarations that were modified after being deserializ...
@ STATISTICS
Record code for the extra statistics we gather while generating an AST file.
@ FLOAT_CONTROL_PRAGMA_OPTIONS
Record code for #pragma float_control options.
@ KNOWN_NAMESPACES
Record code for the set of known namespaces, which are used for typo correction.
@ SPECIAL_TYPES
Record code for the set of non-builtin, special types.
@ PENDING_IMPLICIT_INSTANTIATIONS
Record code for pending implicit instantiations.
@ TYPE_OFFSET
Record code for the offsets of each type.
@ DELEGATING_CTORS
The list of delegating constructor declarations.
@ PP_ASSUME_NONNULL_LOC
ID 66 used to be the list of included files.
@ EXT_VECTOR_DECLS
Record code for the set of ext_vector type names.
@ OPENCL_EXTENSIONS
Record code for enabled OpenCL extensions.
@ UPDATE_SPECIALIZATION
Record code for updated specialization.
@ FP_PRAGMA_OPTIONS
Record code for floating point #pragma options.
@ PP_UNSAFE_BUFFER_USAGE
Record code for #pragma clang unsafe_buffer_usage begin/end.
@ CXX_ADDED_TEMPLATE_PARTIAL_SPECIALIZATION
@ DECLS_WITH_EFFECTS_TO_VERIFY
Record code for Sema's vector of functions/blocks with effects to be verified.
@ VTABLE_USES
Record code for the array of VTable uses.
@ LATE_PARSED_TEMPLATE
Record code for late parsed template functions.
@ DECLS_TO_CHECK_FOR_DEFERRED_DIAGS
Record code for the Decls to be checked for deferred diags.
@ SUBMODULE_METADATA
Record that encodes the number of submodules, their base ID in the AST file, and for each module the ...
@ DECL_OFFSET
Record code for the offsets of each decl.
@ SOURCE_MANAGER_LINE_TABLE
Record code for the source manager line table information, which stores information about #line direc...
@ PP_COUNTER_VALUE
The value of the next COUNTER to dispense.
@ DELETE_EXPRS_TO_ANALYZE
Delete expressions that will be analyzed later.
@ EXTNAME_UNDECLARED_IDENTIFIERS
Record code for extname-redefined undeclared identifiers.
@ RELATED_DECLS_MAP
Record code for related declarations that have to be deserialized together from the same module.
@ UPDATE_VISIBLE
Record code for an update to a decl context's lookup table.
@ CUDA_PRAGMA_FORCE_HOST_DEVICE_DEPTH
Number of unmatched pragma clang cuda_force_host_device begin directives we've seen.
@ MACRO_OFFSET
Record code for the table of offsets of each macro ID.
@ PPD_ENTITIES_OFFSETS
Record code for the table of offsets to entries in the preprocessing record.
@ RISCV_VECTOR_INTRINSICS_PRAGMA
Record code for pragma clang riscv intrinsic vector.
@ OPENCL_EXTENSION_DECLS
Record code for declarations associated with OpenCL extensions.
@ VTABLES_TO_EMIT
Record code for vtables to emit.
@ IDENTIFIER_OFFSET
Record code for the table of offsets of each identifier ID.
@ OBJC_CATEGORIES
Record code for the array of Objective-C categories (including extensions).
@ METHOD_POOL
Record code for the Objective-C method pool,.
@ DELAYED_NAMESPACE_LEXICAL_VISIBLE_RECORD
Record code for lexical and visible block for delayed namespace in reduced BMI.
@ PP_CONDITIONAL_STACK
The stack of open ifs/ifdefs recorded in a preamble.
@ REFERENCED_SELECTOR_POOL
Record code for referenced selector pool.
@ SOURCE_LOCATION_OFFSETS
Record code for the table of offsets into the block of source-location information.
@ WEAK_UNDECLARED_IDENTIFIERS
Record code for weak undeclared identifiers.
@ UNDEFINED_BUT_USED
Record code for undefined but used functions and variables that need a definition in this TU.
@ FILE_SORTED_DECLS
Record code for a file sorted array of DeclIDs in a module.
@ MSSTRUCT_PRAGMA_OPTIONS
Record code for #pragma ms_struct options.
@ TENTATIVE_DEFINITIONS
Record code for the array of tentative definitions.
@ UNUSED_FILESCOPED_DECLS
Record code for the array of unused file scoped decls.
@ ALIGN_PACK_PRAGMA_OPTIONS
Record code for #pragma align/pack options.
@ IMPORTED_MODULES
Record code for an array of all of the (sub)modules that were imported by the AST file.
@ SELECTOR_OFFSETS
Record code for the table of offsets into the Objective-C method pool.
@ UNUSED_LOCAL_TYPEDEF_NAME_CANDIDATES
Record code for potentially unused local typedef names.
@ OPENCL_EXTENSION_TYPES
Record code for types associated with OpenCL extensions.
@ EAGERLY_DESERIALIZED_DECLS
Record code for the array of eagerly deserialized decls.
@ INTERESTING_IDENTIFIERS
A list of "interesting" identifiers.
@ HEADER_SEARCH_TABLE
Record code for header search information.
@ OBJC_CATEGORIES_MAP
Record code for map of Objective-C class definition IDs to the ObjC categories in a module that are a...
@ METADATA_OLD_FORMAT
This is so that older clang versions, before the introduction of the control block,...
@ CUDA_SPECIAL_DECL_REFS
Record code for special CUDA declarations.
@ TU_UPDATE_LEXICAL
Record code for an update to the TU's lexically contained declarations.
@ PPD_SKIPPED_RANGES
A table of skipped ranges within the preprocessing record.
@ IDENTIFIER_TABLE
Record code for the identifier table.
@ SEMA_DECL_REFS
Record code for declarations that Sema keeps references of.
@ OPTIMIZE_PRAGMA_OPTIONS
Record code for #pragma optimize options.
@ MODULE_OFFSET_MAP
Record code for the remapping information used to relate loaded modules to the various offsets and ID...
@ POINTERS_TO_MEMBERS_PRAGMA_OPTIONS
Record code for #pragma ms_struct options.
TypeID LocalTypeID
Same with TypeID except that the LocalTypeID is only meaningful with the corresponding ModuleFile.
Definition ASTBitCodes.h:94
uint64_t IdentifierID
An ID number that refers to an identifier in an AST file.
Definition ASTBitCodes.h:63
uint64_t LocalMacroID
A local to a module ID number that refers to a macro in an AST file.
The JSON file list parser is used to communicate input to InstallAPI.
OverloadedOperatorKind
Enumeration specifying the different kinds of C++ overloaded operators.
Diagnostic wrappers for TextAPI types for error reporting.
Definition Dominators.h:30
__UINTPTR_TYPE__ uintptr_t
An unsigned integer type with the property that any valid pointer to void can be converted to this ty...
friend bool operator<(const ObjCCategoriesInfo &X, const ObjCCategoriesInfo &Y)
friend bool operator>=(const ObjCCategoriesInfo &X, const ObjCCategoriesInfo &Y)
friend bool operator>(const ObjCCategoriesInfo &X, const ObjCCategoriesInfo &Y)
friend bool operator<=(const ObjCCategoriesInfo &X, const ObjCCategoriesInfo &Y)
ObjCCategoriesInfo(LocalDeclID ID, unsigned Offset)
A structure for putting "fast"-unqualified QualTypes into a DenseMap.
static bool isEqual(QualType A, QualType B)
static bool isEqual(const clang::serialization::DeclarationNameKey &L, const clang::serialization::DeclarationNameKey &R)
static clang::serialization::DeclarationNameKey getEmptyKey()
static unsigned getHashValue(const clang::serialization::DeclarationNameKey &Key)