Reads an AST files chain containing the contents of a translation unit. More...

#include "clang/Serialization/ASTReader.h"

Inheritance diagram for clang::ASTReader:

[legend]

Classes
class	ListenerScope
	RAII object to temporarily add an AST callback listener. More...

class	ModuleDeclIterator

Public Types
enum	ASTReadResult { Success , Failure , Missing , OutOfDate , VersionMismatch , ConfigurationMismatch , HadErrors }
	The result of reading the control block of an AST file, which can fail for various reasons. More...

using	RecordData = SmallVector< uint64_t, 64 >

using	RecordDataImpl = SmallVectorImpl< uint64_t >

using	ModuleFile = serialization::ModuleFile

using	ModuleKind = serialization::ModuleKind

using	ModuleManager = serialization::ModuleManager

using	ModuleIterator = ModuleManager::ModuleIterator

using	ModuleConstIterator = ModuleManager::ModuleConstIterator

using	ModuleReverseIterator = ModuleManager::ModuleReverseIterator

Public Types inherited from clang::ExternalASTSource
enum	ExtKind { EK_Always , EK_Never , EK_ReplyHazy }

Friends
class	ASTDeclMerger
	Types of AST files.

class	ASTDeclReader

class	ASTIdentifierIterator

class	ASTRecordReader

class	ASTUnit

class	ASTWriter

class	PCHValidator

class	serialization::reader::ASTIdentifierLookupTrait

class	serialization::ReadMethodPoolVisitor

class	TypeLocReader

class	LocalDeclID

Sema-relevant special data
Fields containing data that is used for semantic analysis
enum	LoadFailureCapabilities { ARR_None = 0 , ARR_Missing = 0x1 , ARR_OutOfDate = 0x2 , ARR_VersionMismatch = 0x4 , ARR_ConfigurationMismatch = 0x8 , ARR_TreatModuleWithErrorsAsOutOfDate = 0x10 }
	Flags that indicate what kind of AST loading failures the client of the AST reader can directly handle. More...

using	RawLocEncoding = SourceLocationEncoding::RawLocEncoding

SmallVector< GlobalDeclID, 16 >	PreloadedDeclIDs

SmallVector< std::pair< llvm::BitstreamCursor, serialization::ModuleFile * >, 8 >	CommentsCursors
	Cursors for comments blocks.

void	ResolveImportedPath (ModuleFile &M, std::string &Filename)
	If we are loading a relocatable PCH or module file, and the filename is not an absolute path, add the system or module root to the beginning of the file name.

Decl *	getKeyDeclaration (Decl *D)
	Returns the first key declaration for the given declaration.

const Decl *	getKeyDeclaration (const Decl *D)

template<typename Fn >
void	forEachImportedKeyDecl (const Decl *D, Fn Visit)
	Run a callback on each imported key declaration of `D`.

const serialization::reader::DeclContextLookupTable *	getLoadedLookupTables (DeclContext *Primary) const
	Get the loaded lookup tables for `Primary`, if any.

llvm::iterator_range< ModuleDeclIterator >	getModuleFileLevelDecls (ModuleFile &Mod)

	ASTReader (Preprocessor &PP, InMemoryModuleCache &ModuleCache, ASTContext *Context, const PCHContainerReader &PCHContainerRdr, ArrayRef< std::shared_ptr< ModuleFileExtension > > Extensions, StringRef isysroot="", DisableValidationForModuleKind DisableValidationKind=DisableValidationForModuleKind::None, bool AllowASTWithCompilerErrors=false, bool AllowConfigurationMismatch=false, bool ValidateSystemInputs=false, bool ValidateASTInputFilesContent=false, bool UseGlobalIndex=true, std::unique_ptr< llvm::Timer > ReadTimer={})
	Load the AST file and validate its contents against the given Preprocessor.

	ASTReader (const ASTReader &)=delete

ASTReader &	operator= (const ASTReader &)=delete

	~ASTReader () override

SourceManager &	getSourceManager () const

FileManager &	getFileManager () const

DiagnosticsEngine &	getDiags () const

ASTReadResult	ReadAST (StringRef FileName, ModuleKind Type, SourceLocation ImportLoc, unsigned ClientLoadCapabilities, ModuleFile **NewLoadedModuleFile=nullptr)
	Load the AST file designated by the given file name.

void	makeModuleVisible (Module *Mod, Module::NameVisibilityKind NameVisibility, SourceLocation ImportLoc)
	Make the entities in the given module and any of its (non-explicit) submodules visible to name lookup.

void	makeNamesVisible (const HiddenNames &Names, Module *Owner)
	Make the names within this set of hidden names visible.

void	mergeDefinitionVisibility (NamedDecl Def, NamedDecl MergedDef)
	Note that MergedDef is a redefinition of the canonical definition Def, so Def should be visible whenever MergedDef is.

std::unique_ptr< ASTReaderListener >	takeListener ()
	Take the AST callbacks listener.

void	setListener (std::unique_ptr< ASTReaderListener > Listener)
	Set the AST callbacks listener.

void	addListener (std::unique_ptr< ASTReaderListener > L)
	Add an AST callback listener.

void	setDeserializationListener (ASTDeserializationListener *Listener, bool TakeOwnership=false)
	Set the AST deserialization listener.

ASTDeserializationListener *	getDeserializationListener ()
	Get the AST deserialization listener.

bool	hasGlobalIndex () const
	Determine whether this AST reader has a global index.

GlobalModuleIndex *	getGlobalIndex ()
	Return global module index.

void	resetForReload ()
	Reset reader for a reload try.

bool	loadGlobalIndex ()
	Attempts to load the global index.

bool	isGlobalIndexUnavailable () const
	Determine whether we tried to load the global index, but failed, e.g., because it is out-of-date or does not exist.

void	InitializeContext ()
	Initializes the ASTContext.

void	UpdateSema ()
	Update the state of Sema after loading some additional modules.

void	addInMemoryBuffer (StringRef &FileName, std::unique_ptr< llvm::MemoryBuffer > Buffer)
	Add in-memory (virtual file) buffer.

void	finalizeForWriting ()
	Finalizes the AST reader's state before writing an AST file to disk.

ModuleManager &	getModuleManager ()
	Retrieve the module manager.

const ModuleManager &	getModuleManager () const

Preprocessor &	getPreprocessor () const
	Retrieve the preprocessor.

StringRef	getOriginalSourceFile ()
	Retrieve the name of the original source file name for the primary module file.

const std::string &	getSuggestedPredefines ()
	Returns the suggested contents of the predefines buffer, which contains a (typically-empty) subset of the predefines build prior to including the precompiled header.

PreprocessedEntity *	ReadPreprocessedEntity (unsigned Index) override
	Read a preallocated preprocessed entity from the external source.

std::pair< unsigned, unsigned >	findPreprocessedEntitiesInRange (SourceRange Range) override
	Returns a pair of [Begin, End) indices of preallocated preprocessed entities that `Range` encompasses.

std::optional< bool >	isPreprocessedEntityInFileID (unsigned Index, FileID FID) override
	Optionally returns true or false if the preallocated preprocessed entity with index `Index` came from file `FID`.

SourceRange	ReadSkippedRange (unsigned Index) override
	Read a preallocated skipped range from the external source.

HeaderFileInfo	GetHeaderFileInfo (FileEntryRef FE) override
	Read the header file information for the given file entry.

void	ReadPragmaDiagnosticMappings (DiagnosticsEngine &Diag)

unsigned	getTotalNumSLocs () const
	Returns the number of source locations found in the chain.

unsigned	getTotalNumIdentifiers () const
	Returns the number of identifiers found in the chain.

unsigned	getTotalNumMacros () const
	Returns the number of macros found in the chain.

unsigned	getTotalNumTypes () const
	Returns the number of types found in the chain.

unsigned	getTotalNumDecls () const
	Returns the number of declarations found in the chain.

unsigned	getTotalNumSubmodules () const
	Returns the number of submodules known.

unsigned	getTotalNumSelectors () const
	Returns the number of selectors found in the chain.

unsigned	getTotalNumPreprocessedEntities () const
	Returns the number of preprocessed entities known to the AST reader.

QualType	GetType (serialization::TypeID ID)
	Resolve a type ID into a type, potentially building a new type.

QualType	getLocalType (ModuleFile &F, serialization::LocalTypeID LocalID)
	Resolve a local type ID within a given AST file into a type.

serialization::TypeID	getGlobalTypeID (ModuleFile &F, serialization::LocalTypeID LocalID) const
	Map a local type ID within a given AST file into a global type ID.

QualType	readType (ModuleFile &F, const RecordData &Record, unsigned &Idx)
	Read a type from the current position in the given record, which was read from the given AST file.

GlobalDeclID	getGlobalDeclID (ModuleFile &F, LocalDeclID LocalID) const
	Map from a local declaration ID within a given module to a global declaration ID.

bool	isDeclIDFromModule (GlobalDeclID ID, ModuleFile &M) const
	Returns true if global DeclID `ID` originated from module `M`.

ModuleFile *	getOwningModuleFile (const Decl *D) const
	Retrieve the module file that owns the given declaration, or NULL if the declaration is not from a module file.

ModuleFile *	getOwningModuleFile (GlobalDeclID ID) const

SourceLocation	getSourceLocationForDeclID (GlobalDeclID ID)
	Returns the source location for the decl `ID`.

Decl *	GetDecl (GlobalDeclID ID)
	Resolve a declaration ID into a declaration, potentially building a new declaration.

Decl *	GetExternalDecl (GlobalDeclID ID) override
	Resolve a declaration ID into a declaration, potentially building a new declaration.

Decl *	GetExistingDecl (GlobalDeclID ID)
	Resolve a declaration ID into a declaration.

Decl *	GetLocalDecl (ModuleFile &F, LocalDeclID LocalID)
	Reads a declaration with the given local ID in the given module.

template<typename T >
T *	GetLocalDeclAs (ModuleFile &F, LocalDeclID LocalID)
	Reads a declaration with the given local ID in the given module.

LocalDeclID	mapGlobalIDToModuleFileGlobalID (ModuleFile &M, GlobalDeclID GlobalID)
	Map a global declaration ID into the declaration ID used to refer to this declaration within the given module fule.

GlobalDeclID	ReadDeclID (ModuleFile &F, const RecordDataImpl &Record, unsigned &Idx)
	Reads a declaration ID from the given position in a record in the given module.

Decl *	ReadDecl (ModuleFile &F, const RecordDataImpl &R, unsigned &I)
	Reads a declaration from the given position in a record in the given module.

template<typename T >
T *	ReadDeclAs (ModuleFile &F, const RecordDataImpl &R, unsigned &I)
	Reads a declaration from the given position in a record in the given module.

void	CompleteRedeclChain (const Decl *D) override
	If any redeclarations of `D` have been imported since it was last checked, this digs out those redeclarations and adds them to the redeclaration chain for `D`.

CXXBaseSpecifier *	GetExternalCXXBaseSpecifiers (uint64_t Offset) override
	Resolve the offset of a set of C++ base specifiers in the decl stream into an array of specifiers.

Stmt *	GetExternalDeclStmt (uint64_t Offset) override
	Resolve the offset of a statement into a statement.

bool	FindExternalVisibleDeclsByName (const DeclContext *DC, DeclarationName Name) override
	Finds all the visible declarations with a given name.

void	FindExternalLexicalDecls (const DeclContext DC, llvm::function_ref< bool(Decl::Kind)> IsKindWeWant, SmallVectorImpl< Decl > &Decls) override
	Read all of the declarations lexically stored in a declaration context.

void	FindFileRegionDecls (FileID File, unsigned Offset, unsigned Length, SmallVectorImpl< Decl * > &Decls) override
	Get the decls that are contained in a file in the Offset/Length range.

void	StartedDeserializing () override
	Notify ASTReader that we started deserialization of a decl or type so until FinishedDeserializing is called there may be decls that are initializing.

void	FinishedDeserializing () override
	Notify ASTReader that we finished the deserialization of a decl or type.

void	StartTranslationUnit (ASTConsumer *Consumer) override
	Function that will be invoked when we begin parsing a new translation unit involving this external AST source.

void	PrintStats () override
	Print some statistics about AST usage.

void	dump ()
	Dump information about the AST reader to standard error.

void	getMemoryBufferSizes (MemoryBufferSizes &sizes) const override
	Return the amount of memory used by memory buffers, breaking down by heap-backed versus mmap'ed memory.

void	InitializeSema (Sema &S) override
	Initialize the semantic source with the Sema instance being used to perform semantic analysis on the abstract syntax tree.

void	ForgetSema () override
	Inform the semantic consumer that Sema is no longer available.

IdentifierInfo *	get (StringRef Name) override
	Retrieve the IdentifierInfo for the named identifier.

IdentifierIterator *	getIdentifiers () override
	Retrieve an iterator into the set of all identifiers in all loaded AST files.

void	ReadMethodPool (Selector Sel) override
	Load the contents of the global method pool for a given selector.

void	updateOutOfDateSelector (Selector Sel) override
	Load the contents of the global method pool for a given selector if necessary.

void	ReadKnownNamespaces (SmallVectorImpl< NamespaceDecl * > &Namespaces) override
	Load the set of namespaces that are known to the external source, which will be used during typo correction.

void	ReadUndefinedButUsed (llvm::MapVector< NamedDecl *, SourceLocation > &Undefined) override
	Load the set of used but not defined functions or variables with internal linkage, or used but not defined internal functions.

void	ReadMismatchingDeleteExpressions (llvm::MapVector< FieldDecl *, llvm::SmallVector< std::pair< SourceLocation, bool >, 4 > > &Exprs) override

void	ReadTentativeDefinitions (SmallVectorImpl< VarDecl * > &TentativeDefs) override
	Read the set of tentative definitions known to the external Sema source.

void	ReadUnusedFileScopedDecls (SmallVectorImpl< const DeclaratorDecl * > &Decls) override
	Read the set of unused file-scope declarations known to the external Sema source.

void	ReadDelegatingConstructors (SmallVectorImpl< CXXConstructorDecl * > &Decls) override
	Read the set of delegating constructors known to the external Sema source.

void	ReadExtVectorDecls (SmallVectorImpl< TypedefNameDecl * > &Decls) override
	Read the set of ext_vector type declarations known to the external Sema source.

void	ReadUnusedLocalTypedefNameCandidates (llvm::SmallSetVector< const TypedefNameDecl *, 4 > &Decls) override
	Read the set of potentially unused typedefs known to the source.

void	ReadDeclsToCheckForDeferredDiags (llvm::SmallSetVector< Decl *, 4 > &Decls) override
	Read the set of decls to be checked for deferred diags.

void	ReadReferencedSelectors (SmallVectorImpl< std::pair< Selector, SourceLocation > > &Sels) override
	Read the set of referenced selectors known to the external Sema source.

void	ReadWeakUndeclaredIdentifiers (SmallVectorImpl< std::pair< IdentifierInfo *, WeakInfo > > &WeakIDs) override
	Read the set of weak, undeclared identifiers known to the external Sema source.

void	ReadUsedVTables (SmallVectorImpl< ExternalVTableUse > &VTables) override
	Read the set of used vtables known to the external Sema source.

void	ReadPendingInstantiations (SmallVectorImpl< std::pair< ValueDecl *, SourceLocation > > &Pending) override
	Read the set of pending instantiations known to the external Sema source.

void	ReadLateParsedTemplates (llvm::MapVector< const FunctionDecl *, std::unique_ptr< LateParsedTemplate > > &LPTMap) override
	Read the set of late parsed template functions for this source.

void	AssignedLambdaNumbering (const CXXRecordDecl *Lambda) override
	Notify the external source that a lambda was assigned a mangling number.

void	LoadSelector (Selector Sel)
	Load a selector from disk, registering its ID if it exists.

void	SetIdentifierInfo (serialization::IdentifierID ID, IdentifierInfo *II)

void	SetGloballyVisibleDecls (IdentifierInfo II, const SmallVectorImpl< GlobalDeclID > &DeclIDs, SmallVectorImpl< Decl > *Decls=nullptr)
	Set the globally-visible declarations associated with the given identifier.

DiagnosticBuilder	Diag (unsigned DiagID) const
	Report a diagnostic.

DiagnosticBuilder	Diag (SourceLocation Loc, unsigned DiagID) const
	Report a diagnostic.

void	warnStackExhausted (SourceLocation Loc)

IdentifierInfo *	DecodeIdentifierInfo (serialization::IdentifierID ID)

IdentifierInfo *	readIdentifier (ModuleFile &M, const RecordData &Record, unsigned &Idx)

IdentifierInfo *	GetIdentifier (serialization::IdentifierID ID) override
	Return the identifier associated with the given ID number.

IdentifierInfo *	getLocalIdentifier (ModuleFile &M, uint64_t LocalID)

serialization::IdentifierID	getGlobalIdentifierID (ModuleFile &M, uint64_t LocalID)

void	resolvePendingMacro (IdentifierInfo *II, const PendingMacroInfo &PMInfo)

MacroInfo *	getMacro (serialization::MacroID ID)
	Retrieve the macro with the given ID.

serialization::MacroID	getGlobalMacroID (ModuleFile &M, unsigned LocalID)
	Retrieve the global macro ID corresponding to the given local ID within the given module file.

bool	ReadSLocEntry (int ID) override
	Read the source location entry with index ID.

int	getSLocEntryID (SourceLocation::UIntTy SLocOffset) override
	Get the index ID for the loaded SourceLocation offset.

llvm::Expected< SourceLocation::UIntTy >	readSLocOffset (ModuleFile *F, unsigned Index)
	Try to read the offset of the SLocEntry at the given index in the given module file.

std::pair< SourceLocation, StringRef >	getModuleImportLoc (int ID) override
	Retrieve the module import location and module name for the given source manager entry ID.

serialization::SubmoduleID	getGlobalSubmoduleID (ModuleFile &M, unsigned LocalID) const
	Retrieve the global submodule ID given a module and its local ID number.

Module *	getSubmodule (serialization::SubmoduleID GlobalID)
	Retrieve the submodule that corresponds to a global submodule ID.

Module *	getModule (unsigned ID) override
	Retrieve the module that corresponds to the given module ID.

ModuleFile *	getLocalModuleFile (ModuleFile &M, unsigned ID) const
	Retrieve the module file with a given local ID within the specified ModuleFile.

unsigned	getModuleFileID (ModuleFile *M)
	Get an ID for the given module file.

std::optional< ASTSourceDescriptor >	getSourceDescriptor (unsigned ID) override
	Return a descriptor for the corresponding module.

ExtKind	hasExternalDefinitions (const Decl *D) override

Selector	getLocalSelector (ModuleFile &M, unsigned LocalID)
	Retrieve a selector from the given module with its local ID number.

Selector	DecodeSelector (serialization::SelectorID Idx)

Selector	GetExternalSelector (serialization::SelectorID ID) override
	Resolve a selector ID into a selector.

uint32_t	GetNumExternalSelectors () override
	Returns the number of selectors known to the external AST source.

Selector	ReadSelector (ModuleFile &M, const RecordData &Record, unsigned &Idx)

serialization::SelectorID	getGlobalSelectorID (ModuleFile &M, unsigned LocalID) const
	Retrieve the global selector ID that corresponds to this the local selector ID in a given module.

CXXCtorInitializer **	GetExternalCXXCtorInitializers (uint64_t Offset) override
	Read the contents of a CXXCtorInitializer array.

Sema::AlignPackInfo	ReadAlignPackInfo (uint32_t Raw) const
	Read a AlignPackInfo from raw form.

std::pair< SourceLocation, unsigned >	ReadUntranslatedSourceLocation (RawLocEncoding Raw, LocSeq *Seq=nullptr) const
	Read a source location from raw form and return it in its originating module file's source location space.

SourceLocation	ReadSourceLocation (ModuleFile &MF, RawLocEncoding Raw, LocSeq *Seq=nullptr) const
	Read a source location from raw form.

SourceLocation	TranslateSourceLocation (ModuleFile &ModuleFile, SourceLocation Loc) const
	Translate a source location from another module file's source location space into ours.

SourceLocation	ReadSourceLocation (ModuleFile &ModuleFile, const RecordDataImpl &Record, unsigned &Idx, LocSeq *Seq=nullptr)
	Read a source location.

FileID	ReadFileID (ModuleFile &F, const RecordDataImpl &Record, unsigned &Idx) const
	Read a FileID.

FileID	TranslateFileID (ModuleFile &F, FileID FID) const
	Translate a FileID from another module file's FileID space into ours.

SourceRange	ReadSourceRange (ModuleFile &F, const RecordData &Record, unsigned &Idx, LocSeq *Seq=nullptr)
	Read a source range.

std::string	ReadPath (ModuleFile &F, const RecordData &Record, unsigned &Idx)

std::string	ReadPath (StringRef BaseDirectory, const RecordData &Record, unsigned &Idx)

CXXTemporary *	ReadCXXTemporary (ModuleFile &F, const RecordData &Record, unsigned &Idx)

Stmt *	ReadStmt (ModuleFile &F)
	Reads a statement.

Expr *	ReadExpr (ModuleFile &F)
	Reads an expression.

Stmt *	ReadSubStmt ()
	Reads a sub-statement operand during statement reading.

Expr *	ReadSubExpr ()
	Reads a sub-expression operand during statement reading.

Token	ReadToken (ModuleFile &M, const RecordDataImpl &Record, unsigned &Idx)
	Reads a token out of a record.

MacroInfo *	ReadMacroRecord (ModuleFile &F, uint64_t Offset)
	Reads the macro record located at the given offset.

serialization::PreprocessedEntityID	getGlobalPreprocessedEntityID (ModuleFile &M, unsigned LocalID) const
	Determine the global preprocessed entity ID that corresponds to the given local ID within the given module.

void	addPendingMacro (IdentifierInfo II, ModuleFile M, uint32_t MacroDirectivesOffset)
	Add a macro to deserialize its macro directive history.

void	ReadDefinedMacros () override
	Read the set of macros defined by this external macro source.

void	updateOutOfDateIdentifier (const IdentifierInfo &II) override
	Update an out-of-date identifier.

void	markIdentifierUpToDate (const IdentifierInfo *II)
	Note that this identifier is up-to-date.

void	completeVisibleDeclsMap (const DeclContext *DC) override
	Load all external visible decls in the given DeclContext.

ASTContext &	getContext ()
	Retrieve the AST context that this AST reader supplements.

Sema *	getSema ()
	Retrieve the semantic analysis object used to analyze the translation unit in which the precompiled header is being imported.

IdentifierResolver &	getIdResolver ()
	Get the identifier resolver used for name lookup / updates in the translation unit scope.

IdentifierTable &	getIdentifierTable ()
	Retrieve the identifier table associated with the preprocessor.

void	RecordSwitchCaseID (SwitchCase *SC, unsigned ID)
	Record that the given ID maps to the given switch-case statement.

SwitchCase *	getSwitchCaseWithID (unsigned ID)
	Retrieve the switch-case statement with the given ID.

void	ClearSwitchCaseIDs ()

void	ReadComments () override
	Loads comments ranges.

void	visitInputFileInfos (serialization::ModuleFile &MF, bool IncludeSystem, llvm::function_ref< void(const serialization::InputFileInfo &IFI, bool IsSystem)> Visitor)
	Visit all the input file infos of the given module file.

void	visitInputFiles (serialization::ModuleFile &MF, bool IncludeSystem, bool Complain, llvm::function_ref< void(const serialization::InputFile &IF, bool isSystem)> Visitor)
	Visit all the input files of the given module file.

void	visitTopLevelModuleMaps (serialization::ModuleFile &MF, llvm::function_ref< void(FileEntryRef)> Visitor)
	Visit all the top-level module maps loaded when building the given module file.

bool	isProcessingUpdateRecords ()

static void	ResolveImportedPath (std::string &Filename, StringRef Prefix)

static std::string	getOriginalSourceFile (const std::string &ASTFileName, FileManager &FileMgr, const PCHContainerReader &PCHContainerRdr, DiagnosticsEngine &Diags)
	Retrieve the name of the original source file name directly from the AST file, without actually loading the AST file.

static bool	readASTFileControlBlock (StringRef Filename, FileManager &FileMgr, const InMemoryModuleCache &ModuleCache, const PCHContainerReader &PCHContainerRdr, bool FindModuleFileExtensions, ASTReaderListener &Listener, bool ValidateDiagnosticOptions, unsigned ClientLoadCapabilities=ARR_ConfigurationMismatch\|ARR_OutOfDate)
	Read the control block for the named AST file.

static bool	isAcceptableASTFile (StringRef Filename, FileManager &FileMgr, const InMemoryModuleCache &ModuleCache, const PCHContainerReader &PCHContainerRdr, const LangOptions &LangOpts, const TargetOptions &TargetOpts, const PreprocessorOptions &PPOpts, StringRef ExistingModuleCachePath, bool RequireStrictOptionMatches=false)
	Determine whether the given AST file is acceptable to load into a translation unit with the given language and target options.

static llvm::Error	ReadBlockAbbrevs (llvm::BitstreamCursor &Cursor, unsigned BlockID, uint64_t *StartOfBlockOffset=nullptr)
	ReadBlockAbbrevs - Enter a subblock of the specified BlockID with the specified cursor.

static llvm::BitVector	ReadBitVector (const RecordData &Record, const StringRef Blob)

static std::string	ReadString (const RecordDataImpl &Record, unsigned &Idx)

static void	SkipString (const RecordData &Record, unsigned &Idx)

static void	SkipPath (const RecordData &Record, unsigned &Idx)

static VersionTuple	ReadVersionTuple (const RecordData &Record, unsigned &Idx)
	Read a version tuple.

Additional Inherited Members
Public Member Functions inherited from clang::ExternalPreprocessorSource
virtual	~ExternalPreprocessorSource ()

virtual void	ReadDefinedMacros ()=0
	Read the set of macros defined by this external macro source.

virtual void	updateOutOfDateIdentifier (const IdentifierInfo &II)=0
	Update an out-of-date identifier.

virtual IdentifierInfo *	GetIdentifier (uint64_t ID)=0
	Return the identifier associated with the given ID number.

virtual Module *	getModule (unsigned ModuleID)=0
	Map a module ID to a module.

Public Member Functions inherited from clang::ExternalPreprocessingRecordSource
virtual	~ExternalPreprocessingRecordSource ()

virtual PreprocessedEntity *	ReadPreprocessedEntity (unsigned Index)=0
	Read a preallocated preprocessed entity from the external source.

virtual std::pair< unsigned, unsigned >	findPreprocessedEntitiesInRange (SourceRange Range)=0
	Returns a pair of [Begin, End) indices of preallocated preprocessed entities that `Range` encompasses.

virtual std::optional< bool >	isPreprocessedEntityInFileID (unsigned Index, FileID FID)
	Optionally returns true or false if the preallocated preprocessed entity with index `Index` came from file `FID`.

virtual SourceRange	ReadSkippedRange (unsigned Index)=0
	Read a preallocated skipped range from the external source.

Public Member Functions inherited from clang::ExternalHeaderFileInfoSource
virtual	~ExternalHeaderFileInfoSource ()

virtual HeaderFileInfo	GetHeaderFileInfo (FileEntryRef FE)=0
	Retrieve the header file information for the given file entry.

Public Member Functions inherited from clang::ExternalSemaSource
	ExternalSemaSource ()=default

	~ExternalSemaSource () override

virtual void	InitializeSema (Sema &S)
	Initialize the semantic source with the Sema instance being used to perform semantic analysis on the abstract syntax tree.

virtual void	ForgetSema ()
	Inform the semantic consumer that Sema is no longer available.

virtual void	ReadMethodPool (Selector Sel)
	Load the contents of the global method pool for a given selector.

virtual void	updateOutOfDateSelector (Selector Sel)
	Load the contents of the global method pool for a given selector if necessary.

virtual void	ReadKnownNamespaces (SmallVectorImpl< NamespaceDecl * > &Namespaces)
	Load the set of namespaces that are known to the external source, which will be used during typo correction.

virtual void	ReadUndefinedButUsed (llvm::MapVector< NamedDecl *, SourceLocation > &Undefined)
	Load the set of used but not defined functions or variables with internal linkage, or used but not defined internal functions.

virtual void	ReadMismatchingDeleteExpressions (llvm::MapVector< FieldDecl *, llvm::SmallVector< std::pair< SourceLocation, bool >, 4 > > &)

virtual bool	LookupUnqualified (LookupResult &R, Scope *S)
	Do last resort, unqualified lookup on a LookupResult that Sema cannot find.

virtual void	ReadTentativeDefinitions (SmallVectorImpl< VarDecl * > &TentativeDefs)
	Read the set of tentative definitions known to the external Sema source.

virtual void	ReadUnusedFileScopedDecls (SmallVectorImpl< const DeclaratorDecl * > &Decls)
	Read the set of unused file-scope declarations known to the external Sema source.

virtual void	ReadDelegatingConstructors (SmallVectorImpl< CXXConstructorDecl * > &Decls)
	Read the set of delegating constructors known to the external Sema source.

virtual void	ReadExtVectorDecls (SmallVectorImpl< TypedefNameDecl * > &Decls)
	Read the set of ext_vector type declarations known to the external Sema source.

virtual void	ReadUnusedLocalTypedefNameCandidates (llvm::SmallSetVector< const TypedefNameDecl *, 4 > &Decls)
	Read the set of potentially unused typedefs known to the source.

virtual void	ReadReferencedSelectors (SmallVectorImpl< std::pair< Selector, SourceLocation > > &Sels)
	Read the set of referenced selectors known to the external Sema source.

virtual void	ReadWeakUndeclaredIdentifiers (SmallVectorImpl< std::pair< IdentifierInfo *, WeakInfo > > &WI)
	Read the set of weak, undeclared identifiers known to the external Sema source.

virtual void	ReadUsedVTables (SmallVectorImpl< ExternalVTableUse > &VTables)
	Read the set of used vtables known to the external Sema source.

virtual void	ReadPendingInstantiations (SmallVectorImpl< std::pair< ValueDecl *, SourceLocation > > &Pending)
	Read the set of pending instantiations known to the external Sema source.

virtual void	ReadLateParsedTemplates (llvm::MapVector< const FunctionDecl *, std::unique_ptr< LateParsedTemplate > > &LPTMap)
	Read the set of late parsed template functions for this source.

virtual void	ReadDeclsToCheckForDeferredDiags (llvm::SmallSetVector< Decl *, 4 > &Decls)
	Read the set of decls to be checked for deferred diags.

virtual TypoCorrection	CorrectTypo (const DeclarationNameInfo &Typo, int LookupKind, Scope S, CXXScopeSpec SS, CorrectionCandidateCallback &CCC, DeclContext MemberContext, bool EnteringContext, const ObjCObjectPointerType OPT)
	Try to "correct" a typo in the source code by finding visible declarations whose names are similar to the name that was present in the source code.

virtual bool	MaybeDiagnoseMissingCompleteType (SourceLocation Loc, QualType T)
	Produces a diagnostic note if the external source contains a complete definition for `T`.

virtual void	AssignedLambdaNumbering (const CXXRecordDecl *Lambda)
	Notify the external source that a lambda was assigned a mangling number.

bool	isA (const void *ClassID) const override
	LLVM-style RTTI.

Public Member Functions inherited from clang::ExternalASTSource
	ExternalASTSource ()=default

virtual	~ExternalASTSource ()

uint32_t	getGeneration () const
	Get the current generation of this AST source.

virtual Decl *	GetExternalDecl (GlobalDeclID ID)
	Resolve a declaration ID into a declaration, potentially building a new declaration.

virtual Selector	GetExternalSelector (uint32_t ID)
	Resolve a selector ID into a selector.

virtual uint32_t	GetNumExternalSelectors ()
	Returns the number of selectors known to the external AST source.

virtual Stmt *	GetExternalDeclStmt (uint64_t Offset)
	Resolve the offset of a statement in the decl stream into a statement.

virtual CXXCtorInitializer **	GetExternalCXXCtorInitializers (uint64_t Offset)
	Resolve the offset of a set of C++ constructor initializers in the decl stream into an array of initializers.

virtual CXXBaseSpecifier *	GetExternalCXXBaseSpecifiers (uint64_t Offset)
	Resolve the offset of a set of C++ base specifiers in the decl stream into an array of specifiers.

virtual void	updateOutOfDateIdentifier (const IdentifierInfo &II)
	Update an out-of-date identifier.

virtual bool	FindExternalVisibleDeclsByName (const DeclContext *DC, DeclarationName Name)
	Find all declarations with the given name in the given context, and add them to the context by calling SetExternalVisibleDeclsForName or SetNoExternalVisibleDeclsForName.

virtual void	completeVisibleDeclsMap (const DeclContext *DC)
	Ensures that the table of all visible declarations inside this context is up to date.

virtual Module *	getModule (unsigned ID)
	Retrieve the module that corresponds to the given module ID.

virtual std::optional< ASTSourceDescriptor >	getSourceDescriptor (unsigned ID)
	Return a descriptor for the corresponding module, if one exists.

virtual ExtKind	hasExternalDefinitions (const Decl *D)

virtual void	FindExternalLexicalDecls (const DeclContext DC, llvm::function_ref< bool(Decl::Kind)> IsKindWeWant, SmallVectorImpl< Decl > &Result)
	Finds all declarations lexically contained within the given DeclContext, after applying an optional filter predicate.

void	FindExternalLexicalDecls (const DeclContext DC, SmallVectorImpl< Decl > &Result)
	Finds all declarations lexically contained within the given DeclContext.

virtual void	FindFileRegionDecls (FileID File, unsigned Offset, unsigned Length, SmallVectorImpl< Decl * > &Decls)
	Get the decls that are contained in a file in the Offset/Length range.

virtual void	CompleteRedeclChain (const Decl *D)
	Gives the external AST source an opportunity to complete the redeclaration chain for a declaration.

virtual void	CompleteType (TagDecl *Tag)
	Gives the external AST source an opportunity to complete an incomplete type.

virtual void	CompleteType (ObjCInterfaceDecl *Class)
	Gives the external AST source an opportunity to complete an incomplete Objective-C class.

virtual void	ReadComments ()
	Loads comment ranges.

virtual void	StartedDeserializing ()
	Notify ExternalASTSource that we started deserialization of a decl or type so until FinishedDeserializing is called there may be decls that are initializing.

virtual void	FinishedDeserializing ()
	Notify ExternalASTSource that we finished the deserialization of a decl or type.

virtual void	StartTranslationUnit (ASTConsumer *Consumer)
	Function that will be invoked when we begin parsing a new translation unit involving this external AST source.

virtual void	PrintStats ()
	Print any statistics that have been gathered regarding the external AST source.

virtual bool	layoutRecordType (const RecordDecl Record, uint64_t &Size, uint64_t &Alignment, llvm::DenseMap< const FieldDecl , uint64_t > &FieldOffsets, llvm::DenseMap< const CXXRecordDecl , CharUnits > &BaseOffsets, llvm::DenseMap< const CXXRecordDecl , CharUnits > &VirtualBaseOffsets)
	Perform layout on the given record.

MemoryBufferSizes	getMemoryBufferSizes () const
	Return the amount of memory used by memory buffers, breaking down by heap-backed versus mmap'ed memory.

virtual void	getMemoryBufferSizes (MemoryBufferSizes &sizes) const

Public Member Functions inherited from clang::IdentifierInfoLookup
virtual	~IdentifierInfoLookup ()

virtual IdentifierInfo *	get (StringRef Name)=0
	Return the IdentifierInfo for the specified named identifier.

virtual IdentifierIterator *	getIdentifiers ()
	Retrieve an iterator into the set of all identifiers known to this identifier lookup source.

Public Member Functions inherited from clang::ExternalSLocEntrySource
virtual	~ExternalSLocEntrySource ()

virtual bool	ReadSLocEntry (int ID)=0
	Read the source location entry with index ID, which will always be less than -1.

virtual int	getSLocEntryID (SourceLocation::UIntTy SLocOffset)=0
	Get the index ID for the loaded SourceLocation offset.

virtual std::pair< SourceLocation, StringRef >	getModuleImportLoc (int ID)=0
	Retrieve the module import location and name for the given ID, if in fact it was loaded from a module (rather than, say, a precompiled header).

Static Public Member Functions inherited from clang::ExternalSemaSource
static bool	classof (const ExternalASTSource *S)

Static Public Member Functions inherited from clang::ExternalASTSource
static bool	classof (const ExternalASTSource *S)

Protected Member Functions inherited from clang::ExternalASTSource
uint32_t	incrementGeneration (ASTContext &C)
	Increment the current generation.

Static Protected Member Functions inherited from clang::ExternalASTSource
static DeclContextLookupResult	SetExternalVisibleDeclsForName (const DeclContext DC, DeclarationName Name, ArrayRef< NamedDecl > Decls)

static DeclContextLookupResult	SetNoExternalVisibleDeclsForName (const DeclContext *DC, DeclarationName Name)

Detailed Description

Reads an AST files chain containing the contents of a translation unit.

The ASTReader class reads bitstreams (produced by the ASTWriter class) containing the serialized representation of a given abstract syntax tree and its supporting data structures. An instance of the ASTReader can be attached to an ASTContext object, which will provide access to the contents of the AST files.

The AST reader provides lazy de-serialization of declarations, as required when traversing the AST. Only those AST nodes that are actually required will be de-serialized.

Definition at line 371 of file ASTReader.h.

Member Typedef Documentation

◆ ModuleConstIterator

using clang::ASTReader::ModuleConstIterator = ModuleManager::ModuleConstIterator

Definition at line 428 of file ASTReader.h.

◆ ModuleFile

using clang::ASTReader::ModuleFile = serialization::ModuleFile

Definition at line 424 of file ASTReader.h.

◆ ModuleIterator

using clang::ASTReader::ModuleIterator = ModuleManager::ModuleIterator

Definition at line 427 of file ASTReader.h.

◆ ModuleKind

using clang::ASTReader::ModuleKind = serialization::ModuleKind

Definition at line 425 of file ASTReader.h.

◆ ModuleManager

using clang::ASTReader::ModuleManager = serialization::ModuleManager

Definition at line 426 of file ASTReader.h.

◆ ModuleReverseIterator

using clang::ASTReader::ModuleReverseIterator = ModuleManager::ModuleReverseIterator

Definition at line 429 of file ASTReader.h.

◆ RawLocEncoding

using clang::ASTReader::RawLocEncoding = SourceLocationEncoding::RawLocEncoding

Definition at line 2257 of file ASTReader.h.

◆ RecordData

using clang::ASTReader::RecordData = SmallVector<uint64_t, 64>

Definition at line 393 of file ASTReader.h.

◆ RecordDataImpl

using clang::ASTReader::RecordDataImpl = SmallVectorImpl<uint64_t>

Definition at line 394 of file ASTReader.h.

Member Enumeration Documentation

◆ ASTReadResult

enum clang::ASTReader::ASTReadResult

The result of reading the control block of an AST file, which can fail for various reasons.

Enumerator
Success	The control block was read successfully. Aside from failures, the AST file is safe to read into the current context.
Failure	The AST file itself appears corrupted.
Missing	The AST file was missing.
OutOfDate	The AST file is out-of-date relative to its input files, and needs to be regenerated.
VersionMismatch	The AST file was written by a different version of Clang.
ConfigurationMismatch	The AST file was written with a different language/target configuration.
HadErrors	The AST file has errors.

Definition at line 398 of file ASTReader.h.

◆ LoadFailureCapabilities

enum clang::ASTReader::LoadFailureCapabilities

Flags that indicate what kind of AST loading failures the client of the AST reader can directly handle.

When a client states that it can handle a particular kind of failure, the AST reader will not emit errors when producing that kind of failure.

Enumerator
ARR_None	The client can't handle any AST loading failures.
ARR_Missing	The client can handle an AST file that cannot load because it is missing.
ARR_OutOfDate	The client can handle an AST file that cannot load because it is out-of-date relative to its input files.
ARR_VersionMismatch	The client can handle an AST file that cannot load because it was built with a different version of Clang.
ARR_ConfigurationMismatch	The client can handle an AST file that cannot load because it's compiled configuration doesn't match that of the context it was loaded into.
ARR_TreatModuleWithErrorsAsOutOfDate	If a module file is marked with errors treat it as out-of-date so the caller can rebuild it.

Definition at line 1631 of file ASTReader.h.

Constructor & Destructor Documentation

◆ ASTReader() [1/2]

ASTReader::ASTReader	(	Preprocessor &	PP,
		InMemoryModuleCache &	ModuleCache,
		ASTContext *	Context,
		const PCHContainerReader &	PCHContainerRdr,
		ArrayRef< std::shared_ptr< ModuleFileExtension > >	Extensions,
		StringRef	isysroot = `""`,
		DisableValidationForModuleKind	DisableValidationKind = `DisableValidationForModuleKind::None`,
		bool	AllowASTWithCompilerErrors = `false`,
		bool	AllowConfigurationMismatch = `false`,
		bool	ValidateSystemInputs = `false`,
		bool	ValidateASTInputFilesContent = `false`,
		bool	UseGlobalIndex = `true`,
		std::unique_ptr< llvm::Timer >	ReadTimer = `{}`
	)

Load the AST file and validate its contents against the given Preprocessor.

Parameters

PP	the preprocessor associated with the context in which this precompiled header will be loaded.
Context	the AST context that this precompiled header will be loaded into, if any.
PCHContainerRdr	the PCHContainerOperations to use for loading and creating modules.
Extensions	the list of module file extensions that can be loaded from the AST files.
isysroot	If non-NULL, the system include path specified by the user. This is only used with relocatable PCH files. If non-NULL, a relocatable PCH file will use the default path "/".
DisableValidationKind	If set, the AST reader will suppress most of its regular consistency checking, allowing the use of precompiled headers and module files that cannot be determined to be compatible.
AllowASTWithCompilerErrors	If true, the AST reader will accept an AST file the was created out of an AST with compiler errors, otherwise it will reject it.
AllowConfigurationMismatch	If true, the AST reader will not check for configuration differences between the AST file and the invocation.
ValidateSystemInputs	If true, the AST reader will validate system input files in addition to user input files. This is only meaningful if `DisableValidation` is false.
UseGlobalIndex	If true, the AST reader will try to load and use the global module index.
ReadTimer	If non-null, a timer used to track the time spent deserializing.

Definition at line 10410 of file ASTReader.cpp.

References bool, clang::cast(), clang::DiagnosticsEngine::Report(), and clang::SourceManager::setExternalSLocEntrySource().

◆ ASTReader() [2/2]

clang::ASTReader::ASTReader ( const ASTReader & )

delete

◆ ~ASTReader()

ASTReader::~ASTReader ( )

override

Definition at line 10449 of file ASTReader.cpp.

Member Function Documentation

◆ addInMemoryBuffer()

void clang::ASTReader::addInMemoryBuffer	(	StringRef &	FileName,
		std::unique_ptr< llvm::MemoryBuffer >	Buffer
	)

inline

Add in-memory (virtual file) buffer.

Definition at line 1782 of file ASTReader.h.

References clang::serialization::ModuleManager::addInMemoryBuffer(), and clang::FileName.

◆ addListener()

void clang::ASTReader::addListener ( std::unique_ptr< ASTReaderListener > L )

inline

Add an AST callback listener.

Takes ownership of L.

Definition at line 1716 of file ASTReader.h.

Referenced by clang::DependencyCollector::attachToASTReader(), and clang::ModuleDependencyCollector::attachToASTReader().

◆ addPendingMacro()

void ASTReader::addPendingMacro	(	IdentifierInfo *	II,
		ModuleFile *	M,
		uint32_t	MacroDirectivesOffset
	)

Add a macro to deserialize its macro directive history.

Parameters

II	The name of the macro.
M	The module file.
MacroDirectivesOffset	Offset of the serialized macro directive history.

Definition at line 2172 of file ASTReader.cpp.

◆ AssignedLambdaNumbering()

void ASTReader::AssignedLambdaNumbering ( const CXXRecordDecl * Lambda )

overridevirtual

Notify the external source that a lambda was assigned a mangling number.

This enables the external source to track the correspondence between lambdas and mangling numbers if necessary.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8966 of file ASTReader.cpp.

References getCanonicalDecl(), clang::CXXRecordDecl::getLambdaContextDecl(), and clang::CXXRecordDecl::getLambdaIndexInContext().

◆ ClearSwitchCaseIDs()

void ASTReader::ClearSwitchCaseIDs ( )

Definition at line 9633 of file ASTReader.cpp.

◆ CompleteRedeclChain()

void ASTReader::CompleteRedeclChain ( const Decl * D )

overridevirtual

If any redeclarations of D have been imported since it was last checked, this digs out those redeclarations and adds them to the redeclaration chain for D.

Reimplemented from clang::ExternalASTSource.

Definition at line 7598 of file ASTReader.cpp.

References clang::CPlusPlus, D, clang::Decl::getDeclContext(), clang::Decl::getKind(), clang::Decl::getLexicalDeclContext(), clang::DeclContext::getRedeclContext(), clang::DeclContext::lookup(), and clang::serialization::needsAnonymousDeclarationNumber().

◆ completeVisibleDeclsMap()

void ASTReader::completeVisibleDeclsMap ( const DeclContext * DC )

overridevirtual

Load all external visible decls in the given DeclContext.

Reimplemented from clang::ExternalASTSource.

Definition at line 8172 of file ASTReader.cpp.

References E, clang::NamedDecl::getDeclName(), and clang::DeclContext::hasExternalVisibleStorage().

◆ DecodeIdentifierInfo()

IdentifierInfo * ASTReader::DecodeIdentifierInfo ( serialization::IdentifierID ID )

Definition at line 9055 of file ASTReader.cpp.

References clang::serialization::ModuleFile::BaseIdentifierID, clang::Data, clang::IdentifierTable::get(), clang::Preprocessor::getCurrentModule(), clang::Preprocessor::getIdentifierTable(), getPreprocessor(), clang::serialization::ModuleFile::IdentifierOffsets, clang::ASTDeserializationListener::IdentifierRead(), clang::serialization::ModuleFile::IdentifierTableData, markIdentifierFromAST(), clang::serialization::reader::ASTIdentifierLookupTraitBase::ReadKey(), and clang::serialization::reader::ASTIdentifierLookupTraitBase::ReadKeyDataLength().

Referenced by GetIdentifier(), getLocalIdentifier(), readIdentifier(), and ReadWeakUndeclaredIdentifiers().

◆ DecodeSelector()

Selector ASTReader::DecodeSelector ( serialization::SelectorID Idx )

Definition at line 9243 of file ASTReader.cpp.

References clang::serialization::ModuleFile::BaseSelectorID, clang::ContinuousRangeMap< Int, V, InitialCapacity >::end(), clang::ContinuousRangeMap< Int, V, InitialCapacity >::find(), clang::serialization::NUM_PREDEF_SELECTOR_IDS, clang::serialization::reader::ASTSelectorLookupTrait::ReadKey(), clang::serialization::ModuleFile::SelectorLookupTableData, clang::serialization::ModuleFile::SelectorOffsets, and clang::ASTDeserializationListener::SelectorRead().

Referenced by GetExternalSelector(), getLocalSelector(), and ReadReferencedSelectors().

◆ Diag() [1/2]

DiagnosticBuilder ASTReader::Diag	(	SourceLocation	Loc,
		unsigned	DiagID
	)		const

Report a diagnostic.

Definition at line 9595 of file ASTReader.cpp.

References Loc, and clang::DiagnosticsEngine::Report().

◆ Diag() [2/2]

DiagnosticBuilder ASTReader::Diag ( unsigned DiagID ) const

Report a diagnostic.

Definition at line 9591 of file ASTReader.cpp.

References Diag().

Referenced by checkMultipleDefinitionInNamedModules(), Diag(), clang::ASTDeclReader::VisitObjCIvarDecl(), and warnStackExhausted().

◆ dump()

LLVM_DUMP_METHOD void ASTReader::dump ( )

Dump information about the AST reader to standard error.

Definition at line 8341 of file ASTReader.cpp.

References clang::serialization::ModuleFile::dump(), and dumpModuleIDMap().

◆ finalizeForWriting()

void ASTReader::finalizeForWriting ( )

Finalizes the AST reader's state before writing an AST file to disk.

This operation may undo temporary state in the AST that should not be emitted.

Definition at line 5267 of file ASTReader.cpp.

◆ FindExternalLexicalDecls()

void ASTReader::FindExternalLexicalDecls	(	const DeclContext *	DC,
		llvm::function_ref< bool(Decl::Kind)>	IsKindWeWant,
		SmallVectorImpl< Decl * > &	Decls
	)

overridevirtual

Read all of the declarations lexically stored in a declaration context.

Parameters

DC	The declaration context whose declarations will be read.
IsKindWeWant	A predicate indicating which declaration kinds we are interested in.
Decls	Vector that will contain the declarations loaded from the external source. The caller is responsible for merging these declarations with any declarations already stored in the declaration context.

Reimplemented from clang::ExternalASTSource.

Definition at line 8022 of file ASTReader.cpp.

References D, clang::LocalDeclID::get(), clang::Decl::getKind(), clang::DeclContext::isDeclInLexicalTraversal(), and clang::NUM_PREDEF_DECL_IDS.

◆ FindExternalVisibleDeclsByName()

bool ASTReader::FindExternalVisibleDeclsByName	(	const DeclContext *	DC,
		DeclarationName	Name
	)

overridevirtual

Finds all the visible declarations with a given name.

The current implementation of this method just loads the entire lookup table as unmaterialized references.

Reimplemented from clang::ExternalASTSource.

Definition at line 8144 of file ASTReader.cpp.

References clang::Found, clang::NamedDecl::getDeclName(), clang::DeclContext::getPrimaryContext(), and clang::DeclContext::hasExternalVisibleStorage().

◆ FindFileRegionDecls()

void ASTReader::FindFileRegionDecls	(	FileID	File,
		unsigned	Offset,
		unsigned	Length,
		SmallVectorImpl< Decl * > &	Decls
	)

overridevirtual

Get the decls that are contained in a file in the Offset/Length range.

Length can be 0 to indicate a point at Offset instead of a range.

Reimplemented from clang::ExternalASTSource.

Definition at line 8100 of file ASTReader.cpp.

References clang::File, clang::LocalDeclID::get(), clang::SourceLocation::getLocWithOffset(), and SM.

◆ findPreprocessedEntitiesInRange()

std::pair< unsigned, unsigned > ASTReader::findPreprocessedEntitiesInRange ( SourceRange Range )

overridevirtual

Returns a pair of [Begin, End) indices of preallocated preprocessed entities that Range encompasses.

Returns a pair of [Begin, End) indices of preallocated preprocessed entities that.

Range encompasses.

Implements clang::ExternalPreprocessingRecordSource.

Definition at line 6505 of file ASTReader.cpp.

References clang::SourceRange::getBegin(), clang::SourceRange::getEnd(), clang::SourceRange::isInvalid(), and Range.

◆ FinishedDeserializing()

void ASTReader::FinishedDeserializing ( )

overridevirtual

Notify ASTReader that we finished the deserialization of a decl or type.

Must be paired with StartedDeserializing.

Reimplemented from clang::ExternalASTSource.

Definition at line 10326 of file ASTReader.cpp.

References clang::ASTContext::adjustDeducedFunctionResultType(), clang::ASTContext::adjustExceptionSpec(), clang::FunctionProtoType::ExtProtoInfo::ExceptionSpec, clang::ASTContext::getASTMutationListener(), getContext(), clang::FunctionProtoType::getExtProtoInfo(), and clang::Update.

◆ forEachImportedKeyDecl()

template<typename Fn >

void clang::ASTReader::forEachImportedKeyDecl	(	const Decl *	D,
		Fn	Visit
	)

inline

Run a callback on each imported key declaration of D.

Definition at line 1345 of file ASTReader.h.

References D, and GetExistingDecl().

◆ ForgetSema()

void clang::ASTReader::ForgetSema ( )

inlineoverridevirtual

Inform the semantic consumer that Sema is no longer available.

Reimplemented from clang::ExternalSemaSource.

Definition at line 2079 of file ASTReader.h.

◆ get()

IdentifierInfo * ASTReader::get ( StringRef Name )

overridevirtual

Retrieve the IdentifierInfo for the named identifier.

This routine builds a new IdentifierInfo for the given identifier. If any declarations with this name are visible from translation unit scope, their declarations will be deserialized and introduced into the declaration chain of the identifier.

Implements clang::IdentifierInfoLookup.

Definition at line 8505 of file ASTReader.cpp.

◆ getContext()

ASTContext & clang::ASTReader::getContext ( )

inline

Retrieve the AST context that this AST reader supplements.

Definition at line 2403 of file ASTReader.h.

◆ GetDecl()

Decl * ASTReader::GetDecl ( GlobalDeclID ID )

Resolve a declaration ID into a declaration, potentially building a new declaration.

Definition at line 7941 of file ASTReader.cpp.

References clang::NUM_PREDEF_DECL_IDS.

Referenced by GetLocalDecl(), clang::ASTReader::ModuleDeclIterator::operator*(), ReadDecl(), ReadDeclAs(), ReadDeclsToCheckForDeferredDiags(), ReadDelegatingConstructors(), ReadExtVectorDecls(), ReadKnownNamespaces(), ReadMismatchingDeleteExpressions(), ReadPendingInstantiations(), ReadTentativeDefinitions(), ReadUndefinedButUsed(), ReadUnusedFileScopedDecls(), ReadUnusedLocalTypedefNameCandidates(), ReadUsedVTables(), SetGloballyVisibleDecls(), clang::ASTDeclReader::Visit(), clang::ASTDeclReader::VisitNamespaceDecl(), and clang::ASTDeclReader::VisitRedeclarable().

◆ getDeserializationListener()

ASTDeserializationListener * clang::ASTReader::getDeserializationListener ( )

inline

Get the AST deserialization listener.

Definition at line 1753 of file ASTReader.h.

◆ getDiags()

DiagnosticsEngine & clang::ASTReader::getDiags ( ) const

inline

Definition at line 1624 of file ASTReader.h.

Referenced by clang::TestModuleFileExtension::createExtensionReader().

◆ GetExistingDecl()

Decl * ASTReader::GetExistingDecl ( GlobalDeclID ID )

Resolve a declaration ID into a declaration.

Return 0 if it's not been loaded yet.

Definition at line 7915 of file ASTReader.cpp.

References D, clang::Decl::getCanonicalDecl(), and clang::NUM_PREDEF_DECL_IDS.

Referenced by forEachImportedKeyDecl(), and getKeyDeclaration().

◆ GetExternalCXXBaseSpecifiers()

CXXBaseSpecifier * ASTReader::GetExternalCXXBaseSpecifiers ( uint64_t Offset )

overridevirtual

Resolve the offset of a set of C++ base specifiers in the decl stream into an array of specifiers.

The default implementation of this method is a no-op.

Reimplemented from clang::ExternalASTSource.

Definition at line 7687 of file ASTReader.cpp.

References clang::ASTContext::Allocate(), D, clang::serialization::DECL_CXX_BASE_SPECIFIERS, and Loc.

◆ GetExternalCXXCtorInitializers()

CXXCtorInitializer ** ASTReader::GetExternalCXXCtorInitializers ( uint64_t Offset )

overridevirtual

Read the contents of a CXXCtorInitializer array.

Reimplemented from clang::ExternalASTSource.

Definition at line 7655 of file ASTReader.cpp.

References D, clang::serialization::DECL_CXX_CTOR_INITIALIZERS, and Loc.

◆ GetExternalDecl()

Decl * ASTReader::GetExternalDecl ( GlobalDeclID ID )

overridevirtual

Resolve a declaration ID into a declaration, potentially building a new declaration.

This method only needs to be implemented if the AST source ever passes back decl sets as VisibleDeclaration objects.

The default implementation of this method is a no-op.

Reimplemented from clang::ExternalASTSource.

Definition at line 7596 of file ASTReader.cpp.

◆ GetExternalDeclStmt()

Stmt * ASTReader::GetExternalDeclStmt ( uint64_t Offset )

overridevirtual

Resolve the offset of a statement into a statement.

This operation will read a new statement from the external source each time it is called, and is meant to be used via a LazyOffsetPtr (which is used by Decls for the body of functions, etc).

Reimplemented from clang::ExternalASTSource.

Definition at line 8006 of file ASTReader.cpp.

References D, and Loc.

◆ GetExternalSelector()

Selector ASTReader::GetExternalSelector ( serialization::SelectorID ID )

overridevirtual

Resolve a selector ID into a selector.

This operation only needs to be implemented if the AST source returns non-zero for GetNumKnownSelectors().

The default implementation of this method is a no-op.

Reimplemented from clang::ExternalASTSource.

Definition at line 9268 of file ASTReader.cpp.

References DecodeSelector().

◆ getFileManager()

FileManager & clang::ASTReader::getFileManager ( ) const

inline

Definition at line 1623 of file ASTReader.h.

Referenced by clang::DependencyCollector::attachToASTReader(), clang::ModuleDependencyCollector::attachToASTReader(), and clang::PCHValidator::ReadHeaderSearchOptions().

◆ getGlobalDeclID()

GlobalDeclID ASTReader::getGlobalDeclID	(	ModuleFile &	F,
		LocalDeclID	LocalID
	)		const

Map from a local declaration ID within a given module to a global declaration ID.

Definition at line 7729 of file ASTReader.cpp.

References clang::DeclIDBase::getLocalDeclIndex(), clang::DeclIDBase::getModuleFileIndex(), clang::DeclIDBase::getRawValue(), clang::serialization::ModuleFile::Index, clang::serialization::ModuleFile::ModuleOffsetMap, clang::NUM_PREDEF_DECL_IDS, and clang::serialization::ModuleFile::TransitiveImports.

Referenced by GetLocalDecl(), and clang::ASTReader::ModuleDeclIterator::operator*().

◆ getGlobalIdentifierID()

IdentifierID ASTReader::getGlobalIdentifierID	(	ModuleFile &	M,
		uint64_t	LocalID
	)

Definition at line 9090 of file ASTReader.cpp.

References clang::serialization::ModuleFile::Index, clang::serialization::ModuleFile::ModuleOffsetMap, clang::serialization::NUM_PREDEF_IDENT_IDS, and clang::serialization::ModuleFile::TransitiveImports.

Referenced by getLocalIdentifier(), and readIdentifier().

◆ getGlobalIndex()

GlobalModuleIndex * clang::ASTReader::getGlobalIndex ( )

inline

Return global module index.

Definition at line 1761 of file ASTReader.h.

◆ getGlobalMacroID()

MacroID ASTReader::getGlobalMacroID	(	ModuleFile &	M,
		unsigned	LocalID
	)

Retrieve the global macro ID corresponding to the given local ID within the given module file.

Definition at line 9136 of file ASTReader.cpp.

References clang::ContinuousRangeMap< Int, V, InitialCapacity >::end(), clang::ContinuousRangeMap< Int, V, InitialCapacity >::find(), clang::serialization::ModuleFile::MacroRemap, clang::serialization::ModuleFile::ModuleOffsetMap, and clang::serialization::NUM_PREDEF_MACRO_IDS.

◆ getGlobalPreprocessedEntityID()

PreprocessedEntityID ASTReader::getGlobalPreprocessedEntityID	(	ModuleFile &	M,
		unsigned	LocalID
	)		const

Determine the global preprocessed entity ID that corresponds to the given local ID within the given module.

Definition at line 2034 of file ASTReader.cpp.

References clang::ContinuousRangeMap< Int, V, InitialCapacity >::end(), clang::ContinuousRangeMap< Int, V, InitialCapacity >::find(), clang::serialization::ModuleFile::ModuleOffsetMap, clang::serialization::NUM_PREDEF_PP_ENTITY_IDS, and clang::serialization::ModuleFile::PreprocessedEntityRemap.

◆ getGlobalSelectorID()

serialization::SelectorID ASTReader::getGlobalSelectorID	(	ModuleFile &	M,
		unsigned	LocalID
	)		const

Retrieve the global selector ID that corresponds to this the local selector ID in a given module.

Definition at line 9278 of file ASTReader.cpp.

References clang::ContinuousRangeMap< Int, V, InitialCapacity >::end(), clang::ContinuousRangeMap< Int, V, InitialCapacity >::find(), clang::serialization::ModuleFile::ModuleOffsetMap, clang::serialization::NUM_PREDEF_SELECTOR_IDS, and clang::serialization::ModuleFile::SelectorRemap.

Referenced by getLocalSelector().

◆ getGlobalSubmoduleID()

serialization::SubmoduleID ASTReader::getGlobalSubmoduleID	(	ModuleFile &	M,
		unsigned	LocalID
	)		const

Retrieve the global submodule ID given a module and its local ID number.

Definition at line 9151 of file ASTReader.cpp.

References clang::ContinuousRangeMap< Int, V, InitialCapacity >::end(), clang::ContinuousRangeMap< Int, V, InitialCapacity >::find(), clang::serialization::ModuleFile::ModuleOffsetMap, clang::serialization::NUM_PREDEF_SUBMODULE_IDS, and clang::serialization::ModuleFile::SubmoduleRemap.

Referenced by clang::ASTRecordReader::getGlobalSubmoduleID(), and getLocalModuleFile().

◆ getGlobalTypeID()

serialization::TypeID ASTReader::getGlobalTypeID	(	ModuleFile &	F,
		serialization::LocalTypeID	LocalID
	)		const

Map a local type ID within a given AST file into a global type ID.

Definition at line 7517 of file ASTReader.cpp.

References clang::Qualifiers::FastWidth, getModuleFileIndexForTypeID(), clang::serialization::ModuleFile::Index, isPredefinedType(), clang::serialization::ModuleFile::ModuleOffsetMap, clang::serialization::NUM_PREDEF_TYPE_IDS, and clang::serialization::ModuleFile::TransitiveImports.

Referenced by clang::ASTRecordReader::getGlobalTypeID().

◆ GetHeaderFileInfo()

HeaderFileInfo ASTReader::GetHeaderFileInfo ( FileEntryRef FE )

overridevirtual

Read the header file information for the given file entry.

Implements clang::ExternalHeaderFileInfoSource.

Definition at line 6568 of file ASTReader.cpp.

◆ GetIdentifier()

IdentifierInfo * clang::ASTReader::GetIdentifier ( serialization::IdentifierID ID )

inlineoverridevirtual

Return the identifier associated with the given ID number.

The ID 0 is associated with the NULL identifier.

Implements clang::ExternalPreprocessorSource.

Definition at line 2171 of file ASTReader.h.

References DecodeIdentifierInfo().

◆ getIdentifiers()

IdentifierIterator * ASTReader::getIdentifiers ( )

overridevirtual

Retrieve an iterator into the set of all identifiers in all loaded AST files.

Reimplemented from clang::IdentifierInfoLookup.

Definition at line 8630 of file ASTReader.cpp.

References ASTIdentifierIterator, and loadGlobalIndex().

◆ getIdentifierTable()

IdentifierTable & ASTReader::getIdentifierTable ( )

Retrieve the identifier table associated with the preprocessor.

Definition at line 9615 of file ASTReader.cpp.

References clang::Preprocessor::getIdentifierTable().

◆ getIdResolver()

IdentifierResolver & ASTReader::getIdResolver ( )

Get the identifier resolver used for name lookup / updates in the translation unit scope.

We have one of these even if we don't have a Sema object.

Definition at line 10454 of file ASTReader.cpp.

References clang::Sema::IdResolver.

◆ getKeyDeclaration() [1/2]

const Decl * clang::ASTReader::getKeyDeclaration ( const Decl * D )

inline

Definition at line 1339 of file ASTReader.h.

References D, and getKeyDeclaration().

◆ getKeyDeclaration() [2/2]

Decl * clang::ASTReader::getKeyDeclaration ( Decl * D )

inline

Returns the first key declaration for the given declaration.

This is one that is formerly-canonical (or still canonical) and whose module did not import any other key declaration of the entity.

Definition at line 1329 of file ASTReader.h.

References D, and GetExistingDecl().

Referenced by getKeyDeclaration().

◆ getLoadedLookupTables()

const serialization::reader::DeclContextLookupTable * ASTReader::getLoadedLookupTables ( DeclContext * Primary ) const

Get the loaded lookup tables for Primary, if any.

Definition at line 8196 of file ASTReader.cpp.

◆ GetLocalDecl()

Decl * clang::ASTReader::GetLocalDecl	(	ModuleFile &	F,
		LocalDeclID	LocalID
	)

inline

Reads a declaration with the given local ID in the given module.

Definition at line 1954 of file ASTReader.h.

References GetDecl(), and getGlobalDeclID().

Referenced by clang::ASTRecordReader::GetLocalDeclAs(), and GetLocalDeclAs().

◆ GetLocalDeclAs()

template<typename T >

T * clang::ASTReader::GetLocalDeclAs	(	ModuleFile &	F,
		LocalDeclID	LocalID
	)

inline

Reads a declaration with the given local ID in the given module.

Returns: The requested declaration, casted to the given return type.

Definition at line 1961 of file ASTReader.h.

References GetLocalDecl().

◆ getLocalIdentifier()

IdentifierInfo * ASTReader::getLocalIdentifier	(	ModuleFile &	M,
		uint64_t	LocalID
	)

Definition at line 9086 of file ASTReader.cpp.

References DecodeIdentifierInfo(), and getGlobalIdentifierID().

◆ getLocalModuleFile()

ModuleFile * ASTReader::getLocalModuleFile	(	ModuleFile &	M,
		unsigned	ID
	)		const

Retrieve the module file with a given local ID within the specified ModuleFile.

Definition at line 9184 of file ASTReader.cpp.

References clang::ContinuousRangeMap< Int, V, InitialCapacity >::end(), clang::ContinuousRangeMap< Int, V, InitialCapacity >::find(), getGlobalSubmoduleID(), getModuleManager(), and clang::serialization::ModuleManager::pch_modules().

◆ getLocalSelector()

Selector ASTReader::getLocalSelector	(	ModuleFile &	M,
		unsigned	LocalID
	)

Retrieve a selector from the given module with its local ID number.

Definition at line 9239 of file ASTReader.cpp.

References DecodeSelector(), and getGlobalSelectorID().

Referenced by ReadSelector().

◆ getLocalType()

QualType ASTReader::getLocalType	(	ModuleFile &	F,
		serialization::LocalTypeID	LocalID
	)

Resolve a local type ID within a given AST file into a type.

Definition at line 7513 of file ASTReader.cpp.

Referenced by readType().

◆ getMacro()

MacroInfo * ASTReader::getMacro ( serialization::MacroID ID )

Retrieve the macro with the given ID.

Definition at line 9109 of file ASTReader.cpp.

References clang::serialization::ModuleFile::BaseMacroID, clang::ContinuousRangeMap< Int, V, InitialCapacity >::end(), clang::ContinuousRangeMap< Int, V, InitialCapacity >::find(), clang::serialization::ModuleFile::MacroOffsets, clang::serialization::ModuleFile::MacroOffsetsBase, clang::ASTDeserializationListener::MacroRead(), clang::serialization::NUM_PREDEF_MACRO_IDS, and ReadMacroRecord().

◆ getMemoryBufferSizes()

void ASTReader::getMemoryBufferSizes ( MemoryBufferSizes & sizes ) const

overridevirtual

Return the amount of memory used by memory buffers, breaking down by heap-backed versus mmap'ed memory.

Reimplemented from clang::ExternalASTSource.

Definition at line 8358 of file ASTReader.cpp.

References bytes(), clang::ExternalASTSource::MemoryBufferSizes::malloc_bytes, and clang::ExternalASTSource::MemoryBufferSizes::mmap_bytes.

◆ getModule()

Module * ASTReader::getModule ( unsigned ID )

overridevirtual

Retrieve the module that corresponds to the given module ID.

Note: overrides method in ExternalASTSource

Implements clang::ExternalPreprocessorSource.

Definition at line 9180 of file ASTReader.cpp.

References getSubmodule().

Referenced by clang::DumpModuleInfoAction::ExecuteAction().

◆ getModuleFileID()

unsigned ASTReader::getModuleFileID ( ModuleFile * M )

Get an ID for the given module file.

Definition at line 9197 of file ASTReader.cpp.

References clang::serialization::ModuleFile::BaseSubmoduleID, getModuleManager(), clang::serialization::ModuleFile::isModule(), clang::serialization::NUM_PREDEF_SUBMODULE_IDS, and clang::serialization::ModuleManager::pch_modules().

◆ getModuleFileLevelDecls()

llvm::iterator_range< ASTReader::ModuleDeclIterator > ASTReader::getModuleFileLevelDecls ( ModuleFile & Mod )

Definition at line 6278 of file ASTReader.cpp.

References clang::serialization::ModuleFile::FileSortedDecls, and clang::serialization::ModuleFile::NumFileSortedDecls.

Referenced by clang::index::indexModuleFile().

◆ getModuleImportLoc()

std::pair< SourceLocation, StringRef > ASTReader::getModuleImportLoc ( int ID )

overridevirtual

Retrieve the module import location and module name for the given source manager entry ID.

Implements clang::ExternalSLocEntrySource.

Definition at line 1786 of file ASTReader.cpp.

References clang::serialization::ModuleFile::ImportLoc, clang::serialization::ModuleFile::isModule(), and clang::serialization::ModuleFile::ModuleName.

◆ getModuleManager() [1/2]

ModuleManager & clang::ASTReader::getModuleManager ( )

inline

Retrieve the module manager.

Definition at line 1795 of file ASTReader.h.

Referenced by clang::FrontendAction::BeginSourceFile(), clang::DumpModuleInfoAction::ExecuteAction(), getLocalModuleFile(), getModuleFileID(), and clang::PCHValidator::ReadDiagnosticOptions().

◆ getModuleManager() [2/2]

const ModuleManager & clang::ASTReader::getModuleManager ( ) const

inline

Definition at line 1796 of file ASTReader.h.

◆ GetNumExternalSelectors()

uint32_t ASTReader::GetNumExternalSelectors ( )

overridevirtual

Returns the number of selectors known to the external AST source.

The default implementation of this method is a no-op.

Reimplemented from clang::ExternalASTSource.

Definition at line 9272 of file ASTReader.cpp.

References getTotalNumSelectors().

◆ getOriginalSourceFile() [1/2]

StringRef clang::ASTReader::getOriginalSourceFile ( )

inline

Retrieve the name of the original source file name for the primary module file.

Definition at line 1803 of file ASTReader.h.

References clang::serialization::ModuleManager::getPrimaryModule(), and clang::serialization::ModuleFile::OriginalSourceFileName.

Referenced by AddImplicitIncludePCH(), and createInvocationForMigration().

◆ getOriginalSourceFile() [2/2]

std::string ASTReader::getOriginalSourceFile	(	const std::string &	ASTFileName,
		FileManager &	FileMgr,
		const PCHContainerReader &	PCHContainerRdr,
		DiagnosticsEngine &	Diags
	)

static

Retrieve the name of the original source file name directly from the AST file, without actually loading the AST file.

Definition at line 5320 of file ASTReader.cpp.

References clang::serialization::CONTROL_BLOCK_ID, doesntStartWithASTFileMagic(), clang::PCHContainerReader::ExtractPCH(), clang::FileManager::getBufferForFile(), clang::serialization::ORIGINAL_FILE, clang::DiagnosticsEngine::Report(), and SkipCursorToBlock().

◆ getOwningModuleFile() [1/2]

ModuleFile * ASTReader::getOwningModuleFile ( const Decl * D ) const

Retrieve the module file that owns the given declaration, or NULL if the declaration is not from a module file.

Definition at line 7772 of file ASTReader.cpp.

References D, clang::Decl::getGlobalID(), and clang::Decl::isFromASTFile().

Referenced by clang::ASTDeclWriter::AddFirstDeclFromEachModule(), and ReadLateParsedTemplates().

◆ getOwningModuleFile() [2/2]

ModuleFile * ASTReader::getOwningModuleFile ( GlobalDeclID ID ) const

Definition at line 7761 of file ASTReader.cpp.

References clang::NUM_PREDEF_DECL_IDS.

◆ getPreprocessor()

Preprocessor & clang::ASTReader::getPreprocessor ( ) const

inline

Retrieve the preprocessor.

Definition at line 1799 of file ASTReader.h.

Referenced by DecodeIdentifierInfo(), clang::DumpModuleInfoAction::ExecuteAction(), clang::index::indexModuleFile(), and isInterestingIdentifier().

◆ getSema()

Sema * clang::ASTReader::getSema ( )

inline

Retrieve the semantic analysis object used to analyze the translation unit in which the precompiled header is being imported.

Definition at line 2415 of file ASTReader.h.

Referenced by ReadMethodPool().

◆ getSLocEntryID()

int ASTReader::getSLocEntryID ( SourceLocation::UIntTy SLocOffset )

overridevirtual

Get the index ID for the loaded SourceLocation offset.

Implements clang::ExternalSLocEntrySource.

Definition at line 1566 of file ASTReader.cpp.

References clang::Invalid, and clang::serialization::ModuleFile::LocalNumSLocEntries.

◆ getSourceDescriptor()

std::optional< ASTSourceDescriptor > ASTReader::getSourceDescriptor ( unsigned ID )

overridevirtual

Return a descriptor for the corresponding module.

Reimplemented from clang::ExternalASTSource.

Definition at line 9214 of file ASTReader.cpp.

References clang::FileName, clang::serialization::ModuleFile::FileName, clang::serialization::ModuleManager::getPrimaryModule(), getSubmodule(), clang::serialization::ModuleFile::OriginalSourceFileName, clang::serialization::ModuleManager::pch_modules(), and clang::serialization::ModuleFile::Signature.

◆ getSourceLocationForDeclID()

SourceLocation ASTReader::getSourceLocationForDeclID ( GlobalDeclID ID )

Returns the source location for the decl ID.

Definition at line 7779 of file ASTReader.cpp.

References D, clang::Decl::getLocation(), Loc, and clang::NUM_PREDEF_DECL_IDS.

◆ getSourceManager()

SourceManager & clang::ASTReader::getSourceManager ( ) const

inline

Definition at line 1622 of file ASTReader.h.

◆ getSubmodule()

Module * ASTReader::getSubmodule ( serialization::SubmoduleID GlobalID )

Retrieve the submodule that corresponds to a global submodule ID.

Definition at line 9166 of file ASTReader.cpp.

References clang::serialization::NUM_PREDEF_SUBMODULE_IDS.

Referenced by getModule(), getSourceDescriptor(), clang::ASTRecordReader::getSubmodule(), clang::ASTDeclReader::UpdateDecl(), and clang::ASTDeclReader::VisitDecl().

◆ getSuggestedPredefines()

const std::string & clang::ASTReader::getSuggestedPredefines ( )

inline

Returns the suggested contents of the predefines buffer, which contains a (typically-empty) subset of the predefines build prior to including the precompiled header.

Definition at line 1839 of file ASTReader.h.

◆ getSwitchCaseWithID()

SwitchCase * ASTReader::getSwitchCaseWithID ( unsigned ID )

Retrieve the switch-case statement with the given ID.

Definition at line 9628 of file ASTReader.cpp.

Referenced by clang::ASTRecordReader::getSwitchCaseWithID().

◆ getTotalNumDecls()

unsigned clang::ASTReader::getTotalNumDecls ( ) const

inline

Returns the number of declarations found in the chain.

Definition at line 1886 of file ASTReader.h.

◆ getTotalNumIdentifiers()

unsigned clang::ASTReader::getTotalNumIdentifiers ( ) const

inline

Returns the number of identifiers found in the chain.

Definition at line 1871 of file ASTReader.h.

◆ getTotalNumMacros()

unsigned clang::ASTReader::getTotalNumMacros ( ) const

inline

Returns the number of macros found in the chain.

Definition at line 1876 of file ASTReader.h.

◆ getTotalNumPreprocessedEntities()

unsigned clang::ASTReader::getTotalNumPreprocessedEntities ( ) const

inline

Returns the number of preprocessed entities known to the AST reader.

Definition at line 1902 of file ASTReader.h.

References clang::Result.

◆ getTotalNumSelectors()

unsigned clang::ASTReader::getTotalNumSelectors ( ) const

inline

Returns the number of selectors found in the chain.

Definition at line 1896 of file ASTReader.h.

Referenced by GetNumExternalSelectors().

◆ getTotalNumSLocs()

unsigned clang::ASTReader::getTotalNumSLocs ( ) const

inline

Returns the number of source locations found in the chain.

Definition at line 1866 of file ASTReader.h.

◆ getTotalNumSubmodules()

unsigned clang::ASTReader::getTotalNumSubmodules ( ) const

inline

Returns the number of submodules known.

Definition at line 1891 of file ASTReader.h.

Referenced by clang::DumpModuleInfoAction::ExecuteAction().

◆ getTotalNumTypes()

unsigned clang::ASTReader::getTotalNumTypes ( ) const

inline

Returns the number of types found in the chain.

Definition at line 1881 of file ASTReader.h.

◆ GetType()

QualType ASTReader::GetType ( serialization::TypeID ID )

Resolve a type ID into a type, potentially building a new type.

Definition at line 7210 of file ASTReader.cpp.

Referenced by clang::ASTDeclReader::Visit(), clang::ASTDeclReader::VisitFunctionDecl(), and clang::ASTDeclReader::VisitVarDeclImpl().

◆ hasExternalDefinitions()

ExternalASTSource::ExtKind ASTReader::hasExternalDefinitions ( const Decl * D )

overridevirtual

Reimplemented from clang::ExternalASTSource.

Definition at line 9232 of file ASTReader.cpp.

References clang::ExternalASTSource::EK_Always, clang::ExternalASTSource::EK_Never, and clang::ExternalASTSource::EK_ReplyHazy.

◆ hasGlobalIndex()

bool clang::ASTReader::hasGlobalIndex ( ) const

inline

Determine whether this AST reader has a global index.

Definition at line 1758 of file ASTReader.h.

◆ InitializeContext()

void ASTReader::InitializeContext ( )

Initializes the ASTContext.

Definition at line 5124 of file ASTReader.cpp.

◆ InitializeSema()

void ASTReader::InitializeSema ( Sema & S )

overridevirtual

Initialize the semantic source with the Sema instance being used to perform semantic analysis on the abstract syntax tree.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8374 of file ASTReader.cpp.

References clang::Sema::addExternalSource(), clang::FPOptionsOverride::applyOverrides(), D, and clang::FPOptionsOverride::getFromOpaqueInt().

◆ isAcceptableASTFile()

bool ASTReader::isAcceptableASTFile	(	StringRef	Filename,
		FileManager &	FileMgr,
		const InMemoryModuleCache &	ModuleCache,
		const PCHContainerReader &	PCHContainerRdr,
		const LangOptions &	LangOpts,
		const TargetOptions &	TargetOpts,
		const PreprocessorOptions &	PPOpts,
		StringRef	ExistingModuleCachePath,
		bool	RequireStrictOptionMatches = `false`
	)

static

Determine whether the given AST file is acceptable to load into a translation unit with the given language and target options.

Definition at line 5734 of file ASTReader.cpp.

References Filename.

Referenced by clang::FrontendAction::BeginSourceFile().

◆ isDeclIDFromModule()

bool ASTReader::isDeclIDFromModule	(	GlobalDeclID	ID,
		ModuleFile &	M
	)		const

Returns true if global DeclID ID originated from module M.

Definition at line 7752 of file ASTReader.cpp.

References clang::serialization::ModuleFile::Index, and clang::NUM_PREDEF_DECL_IDS.

◆ isGlobalIndexUnavailable()

bool ASTReader::isGlobalIndexUnavailable ( ) const

Determine whether we tried to load the global index, but failed, e.g., because it is out-of-date or does not exist.

Definition at line 4402 of file ASTReader.cpp.

◆ isPreprocessedEntityInFileID()

std::optional< bool > ASTReader::isPreprocessedEntityInFileID	(	unsigned	Index,
		FileID	FID
	)

overridevirtual

Optionally returns true or false if the preallocated preprocessed entity with index Index came from file FID.

Optionally returns true or false if the preallocated preprocessed entity with index.

Index came from file
FID.

Reimplemented from clang::ExternalPreprocessingRecordSource.

Definition at line 6518 of file ASTReader.cpp.

References clang::serialization::PPEntityOffset::getBegin(), clang::FileID::isInvalid(), clang::SourceLocation::isInvalid(), Loc, and clang::serialization::ModuleFile::PreprocessedEntityOffsets.

◆ isProcessingUpdateRecords()

bool clang::ASTReader::isProcessingUpdateRecords ( )

inline

Definition at line 2460 of file ASTReader.h.

◆ loadGlobalIndex()

bool ASTReader::loadGlobalIndex ( )

Attempts to load the global index.

Returns: true if loading the global index has failed for any reason.

Definition at line 4377 of file ASTReader.cpp.

References clang::GlobalModuleIndex::readIndex(), and clang::Result.

Referenced by getIdentifiers().

◆ LoadSelector()

void ASTReader::LoadSelector ( Selector Sel )

Load a selector from disk, registering its ID if it exists.

Definition at line 8977 of file ASTReader.cpp.

References ReadMethodPool().

Referenced by clang::ASTWriter::getSelectorRef().

◆ makeModuleVisible()

void ASTReader::makeModuleVisible	(	Module *	Mod,
		Module::NameVisibilityKind	NameVisibility,
		SourceLocation	ImportLoc
	)

Make the entities in the given module and any of its (non-explicit) submodules visible to name lookup.

Parameters

Mod	The module whose names should be made visible.
NameVisibility	The level of visibility to give the names in the module. Visibility can only be increased over time.
ImportLoc	The location at which the import occurs.

Definition at line 4313 of file ASTReader.cpp.

References E, clang::Module::getExportedModules(), clang::Module::isUnimportable(), clang::Module::NameVisibility, and Visited.

◆ makeNamesVisible()

void ASTReader::makeNamesVisible	(	const HiddenNames &	Names,
		Module *	Owner
	)

Make the names within this set of hidden names visible.

Definition at line 4299 of file ASTReader.cpp.

References D, clang::Module::Hidden, clang::Decl::isUnconditionallyVisible(), moveMethodToBackOfGlobalList(), clang::Module::NameVisibility, and clang::Decl::setVisibleDespiteOwningModule().

◆ mapGlobalIDToModuleFileGlobalID()

LocalDeclID ASTReader::mapGlobalIDToModuleFileGlobalID	(	ModuleFile &	M,
		GlobalDeclID	GlobalID
	)

Map a global declaration ID into the declaration ID used to refer to this declaration within the given module fule.

Returns: the global ID of the given declaration as known in the given module file.

Definition at line 7962 of file ASTReader.cpp.

References clang::LocalDeclID::get(), clang::DeclIDBase::getLocalDeclIndex(), clang::DeclIDBase::getRawValue(), clang::serialization::ModuleFile::ModuleOffsetMap, clang::NUM_PREDEF_DECL_IDS, and clang::serialization::ModuleFile::TransitiveImports.

◆ markIdentifierUpToDate()

void ASTReader::markIdentifierUpToDate ( const IdentifierInfo * II )

Note that this identifier is up-to-date.

Definition at line 2321 of file ASTReader.cpp.

◆ mergeDefinitionVisibility()

void ASTReader::mergeDefinitionVisibility	(	NamedDecl *	Def,
		NamedDecl *	MergedDef
	)

Note that MergedDef is a redefinition of the canonical definition Def, so Def should be visible whenever MergedDef is.

We've merged the definition MergedDef into the existing definition Def.

Ensure that Def is made visible whenever MergedDef is made visible.

Definition at line 4362 of file ASTReader.cpp.

References clang::Decl::getImportedOwningModule(), clang::Decl::isUnconditionallyVisible(), and clang::Decl::setVisibleDespiteOwningModule().

Referenced by clang::ASTDeclReader::attachPreviousDeclImpl(), clang::ASTDeclMerger::MergeDefinitionData(), clang::ASTDeclReader::VisitEnumDecl(), and clang::ASTDeclReader::VisitRecordDecl().

◆ operator=()

ASTReader & clang::ASTReader::operator= ( const ASTReader & )

delete

◆ PrintStats()

void ASTReader::PrintStats ( )

overridevirtual

Print some statistics about AST usage.

Reimplemented from clang::ExternalASTSource.

Definition at line 8236 of file ASTReader.cpp.

References dump().

◆ ReadAlignPackInfo()

Sema::AlignPackInfo clang::ASTReader::ReadAlignPackInfo ( uint32_t Raw ) const

inline

Read a AlignPackInfo from raw form.

Definition at line 2253 of file ASTReader.h.

References clang::Sema::AlignPackInfo::getFromRawEncoding().

◆ ReadAST()

ASTReader::ASTReadResult ASTReader::ReadAST	(	StringRef	FileName,
		ModuleKind	Type,
		SourceLocation	ImportLoc,
		unsigned	ClientLoadCapabilities,
		ModuleFile **	NewLoadedModuleFile = `nullptr`
	)

Load the AST file designated by the given file name.

Parameters

FileName	The name of the AST file to load.
Type	The kind of AST being loaded, e.g., PCH, module, main file, or preamble.
ImportLoc	the location where the module file will be considered as imported from. For non-module AST types it should be invalid.
ClientLoadCapabilities	The set of client load-failure capabilities, represented as a bitset of the enumerators of LoadFailureCapabilities.
LoadedModuleFile	The optional out-parameter refers to the new loaded modules. In case the module specified by FileName is already loaded, the module file pointer referred by NewLoadedModuleFile wouldn't change. Otherwise if the AST file get loaded successfully, NewLoadedModuleFile would refer to the address of the new loaded top level module. The state of NewLoadedModuleFile is unspecified if the AST file isn't loaded successfully.

Definition at line 4468 of file ASTReader.cpp.

◆ readASTFileControlBlock()

bool ASTReader::readASTFileControlBlock	(	StringRef	Filename,
		FileManager &	FileMgr,
		const InMemoryModuleCache &	ModuleCache,
		const PCHContainerReader &	PCHContainerRdr,
		bool	FindModuleFileExtensions,
		ASTReaderListener &	Listener,
		bool	ValidateDiagnosticOptions,
		unsigned	ClientLoadCapabilities = `ARR_ConfigurationMismatch \| ARR_OutOfDate`
	)

static

Read the control block for the named AST file.

Returns: true if an error occurred, false otherwise.

Definition at line 5440 of file ASTReader.cpp.

Referenced by collectIncludePCH(), and clang::DumpModuleInfoAction::ExecuteAction().

◆ ReadBitVector()

llvm::BitVector ASTReader::ReadBitVector	(	const RecordData &	Record,
		const StringRef	Blob
	)

static

Definition at line 9532 of file ASTReader.cpp.

◆ ReadBlockAbbrevs()

llvm::Error ASTReader::ReadBlockAbbrevs	(	llvm::BitstreamCursor &	Cursor,
		unsigned	BlockID,
		uint64_t *	StartOfBlockOffset = `nullptr`
	)

static

ReadBlockAbbrevs - Enter a subblock of the specified BlockID with the specified cursor.

Enter a subblock of the specified BlockID with the specified cursor.

Read the abbreviations that are at the top of the block and then leave the cursor pointing into the block.

Definition at line 1823 of file ASTReader.cpp.

◆ ReadComments()

void ASTReader::ReadComments ( )

overridevirtual

Loads comments ranges.

Reimplemented from clang::ExternalASTSource.

Definition at line 9637 of file ASTReader.cpp.

References clang::C, clang::ASTContext::Comments, clang::serialization::COMMENTS_RAW_COMMENT, CommentsCursors, E, getContext(), clang::SourceManager::getDecomposedLoc(), clang::SourceLocation::isValid(), Loc, and ReadSourceRange().

◆ ReadCXXTemporary()

CXXTemporary * ASTReader::ReadCXXTemporary	(	ModuleFile &	F,
		const RecordData &	Record,
		unsigned &	Idx
	)

Definition at line 9584 of file ASTReader.cpp.

References clang::CXXTemporary::Create(), and getContext().

Referenced by clang::ASTRecordReader::readCXXTemporary().

◆ ReadDecl()

Decl * clang::ASTReader::ReadDecl	(	ModuleFile &	F,
		const RecordDataImpl &	R,
		unsigned &	I
	)

inline

Reads a declaration from the given position in a record in the given module.

Definition at line 1982 of file ASTReader.h.

References GetDecl(), and ReadDeclID().

Referenced by clang::ASTRecordReader::readDecl(), and ReadLateParsedTemplates().

◆ ReadDeclAs()

template<typename T >

T * clang::ASTReader::ReadDeclAs	(	ModuleFile &	F,
		const RecordDataImpl &	R,
		unsigned &	I
	)

inline

Reads a declaration from the given position in a record in the given module.

Returns: The declaration read from this location, casted to the given result type.

Definition at line 1992 of file ASTReader.h.

References GetDecl(), and ReadDeclID().

Referenced by clang::ASTRecordReader::readDeclAs().

◆ ReadDeclID()

GlobalDeclID ASTReader::ReadDeclID	(	ModuleFile &	F,
		const RecordDataImpl &	Record,
		unsigned &	Idx
	)

Reads a declaration ID from the given position in a record in the given module.

Returns: The declaration ID read from the record, adjusted to a global ID.

Definition at line 7991 of file ASTReader.cpp.

References clang::LocalDeclID::get().

Referenced by ReadDecl(), ReadDeclAs(), and clang::ASTRecordReader::readDeclID().

◆ ReadDeclsToCheckForDeferredDiags()

void ASTReader::ReadDeclsToCheckForDeferredDiags ( llvm::SmallSetVector< Decl *, 4 > & Decls )

overridevirtual

Read the set of decls to be checked for deferred diags.

The external source should append its own potentially emitted function and variable decls which may cause deferred diags. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same declarations repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8866 of file ASTReader.cpp.

References D, and GetDecl().

◆ ReadDefinedMacros()

void ASTReader::ReadDefinedMacros ( )

overridevirtual

Read the set of macros defined by this external macro source.

Implements clang::ExternalPreprocessorSource.

Definition at line 2178 of file ASTReader.cpp.

References E, clang::IdentifierInfo::isOutOfDate(), clang::serialization::PP_MACRO_FUNCTION_LIKE, clang::serialization::PP_MACRO_OBJECT_LIKE, and clang::serialization::PP_TOKEN.

◆ ReadDelegatingConstructors()

void ASTReader::ReadDelegatingConstructors ( SmallVectorImpl< CXXConstructorDecl * > & Decls )

overridevirtual

Read the set of delegating constructors known to the external Sema source.

The external source should append its own delegating constructors to the given vector of declarations. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same declarations repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8833 of file ASTReader.cpp.

References D, and GetDecl().

◆ ReadExpr()

Expr * ASTReader::ReadExpr ( ModuleFile & F )

Reads an expression.

Definition at line 2859 of file ASTReaderStmt.cpp.

References ReadStmt().

Referenced by clang::ASTRecordReader::readExpr().

◆ ReadExtVectorDecls()

void ASTReader::ReadExtVectorDecls ( SmallVectorImpl< TypedefNameDecl * > & Decls )

overridevirtual

Read the set of ext_vector type declarations known to the external Sema source.

The external source should append its own ext_vector type declarations to the given vector of declarations. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same declarations repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8844 of file ASTReader.cpp.

References D, and GetDecl().

◆ ReadFileID()

FileID clang::ASTReader::ReadFileID	(	ModuleFile &	F,
		const RecordDataImpl &	Record,
		unsigned &	Idx
	)		const

inline

Read a FileID.

Definition at line 2307 of file ASTReader.h.

References TranslateFileID().

◆ readIdentifier()

IdentifierInfo * clang::ASTReader::readIdentifier	(	ModuleFile &	M,
		const RecordData &	Record,
		unsigned &	Idx
	)

inline

Definition at line 2166 of file ASTReader.h.

References DecodeIdentifierInfo(), and getGlobalIdentifierID().

Referenced by clang::ASTRecordReader::readIdentifier().

◆ ReadKnownNamespaces()

void ASTReader::ReadKnownNamespaces ( SmallVectorImpl< NamespaceDecl * > & Namespaces )

overridevirtual

Load the set of namespaces that are known to the external source, which will be used during typo correction.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8774 of file ASTReader.cpp.

References GetDecl().

◆ ReadLateParsedTemplates()

void ASTReader::ReadLateParsedTemplates ( llvm::MapVector< const FunctionDecl *, std::unique_ptr< LateParsedTemplate > > & LPTMap )

overridevirtual

Read the set of late parsed template functions for this source.

The external source should insert its own late parsed template functions into the map. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same map entries repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8937 of file ASTReader.cpp.

References clang::FPOptions::getFromOpaqueInt(), getOwningModuleFile(), LT, ReadDecl(), ReadToken(), and clang::T.

◆ ReadMacroRecord()

MacroInfo * ASTReader::ReadMacroRecord	(	ModuleFile &	F,
		uint64_t	Offset
	)

Reads the macro record located at the given offset.

Definition at line 1903 of file ASTReader.cpp.

References clang::MacroInfo::allocateTokens(), Loc, clang::serialization::ModuleFile::MacroCursor, clang::serialization::PP_MACRO_DIRECTIVE_HISTORY, clang::serialization::PP_MACRO_FUNCTION_LIKE, clang::serialization::PP_MACRO_OBJECT_LIKE, clang::serialization::PP_MODULE_MACRO, clang::serialization::PP_TOKEN, clang::MacroInfo::setDefinitionEndLoc(), clang::MacroInfo::setHasCommaPasting(), clang::MacroInfo::setIsC99Varargs(), clang::MacroInfo::setIsFunctionLike(), clang::MacroInfo::setIsGNUVarargs(), clang::MacroInfo::setIsUsed(), clang::MacroInfo::setParameterList(), and clang::MacroInfo::setUsedForHeaderGuard().

Referenced by getMacro().

◆ ReadMethodPool()

void ASTReader::ReadMethodPool ( Selector Sel )

overridevirtual

Load the contents of the global method pool for a given selector.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8729 of file ASTReader.cpp.

References addMethodsToPool(), clang::serialization::ReadMethodPoolVisitor::factoryHasMoreThanOneDecl(), clang::serialization::ReadMethodPoolVisitor::getFactoryBits(), clang::serialization::ReadMethodPoolVisitor::getFactoryMethods(), clang::ExternalASTSource::getGeneration(), clang::serialization::ReadMethodPoolVisitor::getInstanceBits(), clang::serialization::ReadMethodPoolVisitor::getInstanceMethods(), getSema(), clang::SemaObjC::GlobalMethodPool::insert(), clang::serialization::ReadMethodPoolVisitor::instanceHasMoreThanOneDecl(), clang::SemaObjC::MethodPool, clang::Sema::ObjC(), and clang::serialization::ModuleManager::visit().

Referenced by LoadSelector(), and updateOutOfDateSelector().

◆ ReadMismatchingDeleteExpressions()

void ASTReader::ReadMismatchingDeleteExpressions ( llvm::MapVector< FieldDecl *, llvm::SmallVector< std::pair< SourceLocation, bool >, 4 > > & Exprs )

overridevirtual

Reimplemented from clang::ExternalSemaSource.

Definition at line 8796 of file ASTReader.cpp.

References clang::C, GetDecl(), and clang::SourceLocation::getFromRawEncoding().

◆ ReadPath() [1/2]

std::string ASTReader::ReadPath	(	ModuleFile &	F,
		const RecordData &	Record,
		unsigned &	Idx
	)

Definition at line 9557 of file ASTReader.cpp.

References Filename, ReadString(), and ResolveImportedPath().

Referenced by clang::ASTRecordReader::readPath().

◆ ReadPath() [2/2]

std::string ASTReader::ReadPath	(	StringRef	BaseDirectory,
		const RecordData &	Record,
		unsigned &	Idx
	)

Definition at line 9564 of file ASTReader.cpp.

References Filename, ReadString(), and ResolveImportedPath().

◆ ReadPendingInstantiations()

void ASTReader::ReadPendingInstantiations ( SmallVectorImpl< std::pair< ValueDecl *, SourceLocation > > & Pending )

overridevirtual

Read the set of pending instantiations known to the external Sema source.

The external source should append its own pending instantiations to the given vector. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same instantiations repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8925 of file ASTReader.cpp.

References D, GetDecl(), clang::SourceLocation::getFromRawEncoding(), and Loc.

◆ ReadPragmaDiagnosticMappings()

void ASTReader::ReadPragmaDiagnosticMappings ( DiagnosticsEngine & Diag )

Definition at line 6577 of file ASTReader.cpp.

References clang::DiagnosticMapping::deserialize(), Diag(), clang::DiagnosticMapping::isErrorOrFatal(), clang::serialization::ModuleFile::isModule(), clang::DiagnosticMapping::isPragma(), clang::FileID::isValid(), clang::serialization::ModuleFile::Kind, clang::serialization::MK_ImplicitModule, clang::serialization::ModuleFile::OriginalSourceFileID, clang::serialization::ModuleFile::PragmaDiagMappings, clang::DiagnosticMapping::setSeverity(), clang::DiagnosticMapping::setUpgradedFromWarning(), clang::T, clang::diag::Warning, and clang::DiagnosticMapping::wasUpgradedFromWarning().

◆ ReadPreprocessedEntity()

PreprocessedEntity * ASTReader::ReadPreprocessedEntity ( unsigned Index )

overridevirtual

Read a preallocated preprocessed entity from the external source.

Returns: null if an error occurred that prevented the preprocessed entity from being loaded.

Implements clang::ExternalPreprocessingRecordSource.

Definition at line 6299 of file ASTReader.cpp.

References clang::File, clang::serialization::PPEntityOffset::getBegin(), clang::serialization::PPEntityOffset::getEnd(), clang::serialization::PPEntityOffset::getOffset(), clang::serialization::ModuleFile::MacroOffsetsBase, clang::serialization::PPD_INCLUSION_DIRECTIVE, clang::serialization::PPD_MACRO_DEFINITION, clang::serialization::PPD_MACRO_EXPANSION, clang::serialization::ModuleFile::PreprocessedEntityOffsets, clang::serialization::ModuleFile::PreprocessorDetailCursor, and Range.

◆ ReadReferencedSelectors()

void ASTReader::ReadReferencedSelectors ( SmallVectorImpl< std::pair< Selector, SourceLocation > > & Sels )

overridevirtual

Read the set of referenced selectors known to the external Sema source.

The external source should append its own referenced selectors to the given vector of selectors. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same selectors repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8876 of file ASTReader.cpp.

References DecodeSelector(), and clang::SourceLocation::getFromRawEncoding().

◆ ReadSelector()

Selector clang::ASTReader::ReadSelector	(	ModuleFile &	M,
		const RecordData &	Record,
		unsigned &	Idx
	)

inline

Definition at line 2240 of file ASTReader.h.

References getLocalSelector().

Referenced by clang::ASTRecordReader::readSelector().

◆ ReadSkippedRange()

SourceRange ASTReader::ReadSkippedRange ( unsigned Index )

overridevirtual

Read a preallocated skipped range from the external source.

Implements clang::ExternalPreprocessingRecordSource.

Definition at line 6285 of file ASTReader.cpp.

References clang::serialization::ModuleFile::BasePreprocessedSkippedRangeID, clang::serialization::PPSkippedRange::getBegin(), clang::serialization::PPSkippedRange::getEnd(), clang::SourceRange::isValid(), clang::serialization::ModuleFile::PreprocessedSkippedRangeOffsets, and Range.

◆ ReadSLocEntry()

bool ASTReader::ReadSLocEntry ( int ID )

overridevirtual

Read the source location entry with index ID.

Implements clang::ExternalSLocEntrySource.

Definition at line 1603 of file ASTReader.cpp.

◆ readSLocOffset()

llvm::Expected< SourceLocation::UIntTy > ASTReader::readSLocOffset	(	ModuleFile *	F,
		unsigned	Index
	)

Try to read the offset of the SLocEntry at the given index in the given module file.

Definition at line 1531 of file ASTReader.cpp.

References clang::serialization::ModuleFile::SLocEntryBaseOffset, clang::serialization::ModuleFile::SLocEntryCursor, clang::serialization::ModuleFile::SLocEntryOffsets, clang::serialization::ModuleFile::SLocEntryOffsetsBase, clang::serialization::SM_SLOC_BUFFER_ENTRY, clang::serialization::SM_SLOC_EXPANSION_ENTRY, and clang::serialization::SM_SLOC_FILE_ENTRY.

◆ ReadSourceLocation() [1/2]

SourceLocation clang::ASTReader::ReadSourceLocation	(	ModuleFile &	MF,
		RawLocEncoding	Raw,
		LocSeq *	Seq = `nullptr`
	)		const

inline

Read a source location from raw form.

Definition at line 2268 of file ASTReader.h.

References clang::SourceManager::isLoadedSourceLocation(), Loc, clang::serialization::ModuleFile::ModuleOffsetMap, ReadUntranslatedSourceLocation(), clang::Seq, clang::serialization::ModuleFile::TransitiveImports, and TranslateSourceLocation().

Referenced by clang::ASTRecordReader::readSourceLocation(), ReadSourceLocation(), and ReadSourceRange().

◆ ReadSourceLocation() [2/2]

SourceLocation clang::ASTReader::ReadSourceLocation	(	ModuleFile &	ModuleFile,
		const RecordDataImpl &	Record,
		unsigned &	Idx,
		LocSeq *	Seq = `nullptr`
	)

inline

Read a source location.

Definition at line 2300 of file ASTReader.h.

References ReadSourceLocation(), and clang::Seq.

◆ ReadSourceRange()

SourceRange ASTReader::ReadSourceRange	(	ModuleFile &	F,
		const RecordData &	Record,
		unsigned &	Idx,
		LocSeq *	Seq = `nullptr`
	)

Read a source range.

Definition at line 9525 of file ASTReader.cpp.

References ReadSourceLocation(), and clang::Seq.

Referenced by ReadComments(), and clang::ASTRecordReader::readSourceRange().

◆ ReadStmt()

Stmt * ASTReader::ReadStmt ( ModuleFile & F )

Reads a statement.

Definition at line 2845 of file ASTReaderStmt.cpp.

References ReadSubStmt().

Referenced by ReadExpr(), and clang::ASTRecordReader::readStmt().

◆ ReadString()

std::string ASTReader::ReadString	(	const RecordDataImpl &	Record,
		unsigned &	Idx
	)

static

Definition at line 9550 of file ASTReader.cpp.

References clang::Result.

Referenced by ReadPath(), and clang::ASTRecordReader::readString().

◆ ReadSubExpr()

Expr * ASTReader::ReadSubExpr ( )

Reads a sub-expression operand during statement reading.

Definition at line 2863 of file ASTReaderStmt.cpp.

References ReadSubStmt().

Referenced by clang::ASTRecordReader::readSubExpr().

◆ ReadSubStmt()

Stmt * clang::ASTReader::ReadSubStmt ( )

inline

Reads a sub-statement operand during statement reading.

Definition at line 2358 of file ASTReader.h.

Referenced by ReadStmt(), ReadSubExpr(), and clang::ASTRecordReader::readSubStmt().

◆ ReadTentativeDefinitions()

void ASTReader::ReadTentativeDefinitions ( SmallVectorImpl< VarDecl * > & TentativeDefs )

overridevirtual

Read the set of tentative definitions known to the external Sema source.

The external source should append its own tentative definitions to the given vector of tentative definitions. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same declarations repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8812 of file ASTReader.cpp.

References GetDecl().

◆ ReadToken()

Token ASTReader::ReadToken	(	ModuleFile &	M,
		const RecordDataImpl &	Record,
		unsigned &	Idx
	)

Reads a token out of a record.

Definition at line 1850 of file ASTReader.cpp.

References clang::Sema::PragmaPackInfo::Action, clang::Token::getKind(), clang::Token::isAnnotation(), clang::PragmaLoopHintInfo::PragmaName, clang::Token::setAnnotationEndLoc(), clang::Token::setAnnotationValue(), clang::Token::setFlag(), clang::Token::setIdentifierInfo(), clang::Token::setKind(), clang::Token::setLength(), clang::Token::setLocation(), and clang::Token::startToken().

Referenced by ReadLateParsedTemplates(), and clang::ASTRecordReader::readToken().

◆ readType()

QualType clang::ASTReader::readType	(	ModuleFile &	F,
		const RecordData &	Record,
		unsigned &	Idx
	)

inline

Read a type from the current position in the given record, which was read from the given AST file.

Definition at line 1922 of file ASTReader.h.

References getLocalType().

Referenced by clang::ASTRecordReader::readType().

◆ ReadUndefinedButUsed()

void ASTReader::ReadUndefinedButUsed ( llvm::MapVector< NamedDecl *, SourceLocation > & Undefined )

overridevirtual

Load the set of used but not defined functions or variables with internal linkage, or used but not defined internal functions.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8785 of file ASTReader.cpp.

References D, GetDecl(), clang::SourceLocation::getFromRawEncoding(), and Loc.

◆ ReadUntranslatedSourceLocation()

std::pair< SourceLocation, unsigned > clang::ASTReader::ReadUntranslatedSourceLocation	(	RawLocEncoding	Raw,
		LocSeq *	Seq = `nullptr`
	)		const

inline

Read a source location from raw form and return it in its originating module file's source location space.

Definition at line 2262 of file ASTReader.h.

References clang::SourceLocationEncoding::decode(), and clang::Seq.

Referenced by ReadSourceLocation().

◆ ReadUnusedFileScopedDecls()

void ASTReader::ReadUnusedFileScopedDecls ( SmallVectorImpl< const DeclaratorDecl * > & Decls )

overridevirtual

Read the set of unused file-scope declarations known to the external Sema source.

The external source should append its own unused, filed-scope to the given vector of declarations. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same declarations repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8822 of file ASTReader.cpp.

References D, and GetDecl().

◆ ReadUnusedLocalTypedefNameCandidates()

void ASTReader::ReadUnusedLocalTypedefNameCandidates ( llvm::SmallSetVector< const TypedefNameDecl *, 4 > & Decls )

overridevirtual

Read the set of potentially unused typedefs known to the source.

The external source should append its own potentially unused local typedefs to the given vector of declarations. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same declarations repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8854 of file ASTReader.cpp.

References D, and GetDecl().

◆ ReadUsedVTables()

void ASTReader::ReadUsedVTables ( SmallVectorImpl< ExternalVTableUse > & VTables )

overridevirtual

Read the set of used vtables known to the external Sema source.

The external source should append its own used vtables to the given vector. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same vtables repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8912 of file ASTReader.cpp.

References clang::ExternalVTableUse::DefinitionRequired, GetDecl(), clang::SourceLocation::getFromRawEncoding(), clang::ExternalVTableUse::Location, and clang::ExternalVTableUse::Record.

◆ ReadVersionTuple()

VersionTuple ASTReader::ReadVersionTuple	(	const RecordData &	Record,
		unsigned &	Idx
	)

static

Read a version tuple.

Definition at line 9572 of file ASTReader.cpp.

Referenced by clang::ASTRecordReader::readVersionTuple().

◆ ReadWeakUndeclaredIdentifiers()

void ASTReader::ReadWeakUndeclaredIdentifiers ( SmallVectorImpl< std::pair< IdentifierInfo *, WeakInfo > > & WI )

overridevirtual

Read the set of weak, undeclared identifiers known to the external Sema source.

The external source should append its own weak, undeclared identifiers to the given vector. Note that this routine may be invoked multiple times; the external source should take care not to introduce the same identifiers repeatedly.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8894 of file ASTReader.cpp.

References DecodeIdentifierInfo(), clang::SourceLocation::getFromRawEncoding(), and Loc.

◆ RecordSwitchCaseID()

void ASTReader::RecordSwitchCaseID	(	SwitchCase *	SC,
		unsigned	ID
	)

Record that the given ID maps to the given switch-case statement.

Definition at line 9621 of file ASTReader.cpp.

Referenced by clang::ASTRecordReader::recordSwitchCaseID().

◆ resetForReload()

void clang::ASTReader::resetForReload ( )

inline

Reset reader for a reload try.

Definition at line 1764 of file ASTReader.h.

◆ ResolveImportedPath() [1/2]

void ASTReader::ResolveImportedPath	(	ModuleFile &	M,
		std::string &	Filename
	)

If we are loading a relocatable PCH or module file, and the filename is not an absolute path, add the system or module root to the beginning of the file name.

Definition at line 2758 of file ASTReader.cpp.

References clang::serialization::ModuleFile::BaseDirectory, and Filename.

Referenced by ReadPath().

◆ ResolveImportedPath() [2/2]

void ASTReader::ResolveImportedPath	(	std::string &	Filename,
		StringRef	Prefix
	)

static

Definition at line 2764 of file ASTReader.cpp.

References Filename.

◆ resolvePendingMacro()

void ASTReader::resolvePendingMacro	(	IdentifierInfo *	II,
		const PendingMacroInfo &	PMInfo
	)

Definition at line 2332 of file ASTReader.cpp.

References clang::serialization::ModuleFile::isModule(), Loc, clang::serialization::ModuleFile::MacroCursor, clang::serialization::ModuleFile::MacroOffsetsBase, clang::MacroDirective::MD_Define, clang::MacroDirective::MD_Undefine, clang::MacroDirective::MD_Visibility, clang::serialization::PP_MACRO_DIRECTIVE_HISTORY, clang::serialization::PP_MODULE_MACRO, and clang::MacroDirective::setPrevious().

◆ setDeserializationListener()

void ASTReader::setDeserializationListener	(	ASTDeserializationListener *	Listener,
		bool	TakeOwnership = `false`
	)

Set the AST deserialization listener.

Definition at line 927 of file ASTReader.cpp.

◆ SetGloballyVisibleDecls()

void ASTReader::SetGloballyVisibleDecls	(	IdentifierInfo *	II,
		const SmallVectorImpl< GlobalDeclID > &	DeclIDs,
		SmallVectorImpl< Decl * > *	Decls = `nullptr`
	)

Set the globally-visible declarations associated with the given identifier.

If the AST reader is currently in a state where the given declaration IDs cannot safely be resolved, they are queued until it is safe to resolve them.

Parameters

II	an IdentifierInfo that refers to one or more globally-visible declarations.
DeclIDs	the set of declaration IDs with the name `II` that are visible at global scope.
Decls	if non-null, this vector will be populated with the set of deserialized declarations. These declarations will not be pushed into scope.

Definition at line 9007 of file ASTReader.cpp.

References D, GetDecl(), and PreloadedDeclIDs.

◆ SetIdentifierInfo()

void ASTReader::SetIdentifierInfo	(	serialization::IdentifierID	ID,
		IdentifierInfo *	II
	)

Definition at line 8982 of file ASTReader.cpp.

References clang::ASTDeserializationListener::IdentifierRead().

◆ setListener()

void clang::ASTReader::setListener ( std::unique_ptr< ASTReaderListener > Listener )

inline

Set the AST callbacks listener.

Definition at line 1709 of file ASTReader.h.

Referenced by clang::ASTReader::ListenerScope::ListenerScope(), and clang::ASTReader::ListenerScope::~ListenerScope().

◆ SkipPath()

static void clang::ASTReader::SkipPath	(	const RecordData &	Record,
		unsigned &	Idx
	)

inlinestatic

Definition at line 2341 of file ASTReader.h.

References SkipString().

◆ SkipString()

static void clang::ASTReader::SkipString	(	const RecordData &	Record,
		unsigned &	Idx
	)

inlinestatic

Definition at line 2329 of file ASTReader.h.

Referenced by SkipPath().

◆ StartedDeserializing()

void ASTReader::StartedDeserializing ( )

overridevirtual

Notify ASTReader that we started deserialization of a decl or type so until FinishedDeserializing is called there may be decls that are initializing.

Must be paired with FinishedDeserializing.

Reimplemented from clang::ExternalASTSource.

Definition at line 10321 of file ASTReader.cpp.

◆ StartTranslationUnit()

void ASTReader::StartTranslationUnit ( ASTConsumer * Consumer )

overridevirtual

Function that will be invoked when we begin parsing a new translation unit involving this external AST source.

This function will provide all of the external definitions to the ASTConsumer.

Reimplemented from clang::ExternalASTSource.

Definition at line 8226 of file ASTReader.cpp.

◆ takeListener()

std::unique_ptr< ASTReaderListener > clang::ASTReader::takeListener ( )

inline

Take the AST callbacks listener.

Definition at line 1704 of file ASTReader.h.

Referenced by clang::ASTReader::ListenerScope::ListenerScope(), and clang::ASTReader::ListenerScope::~ListenerScope().

◆ TranslateFileID()

FileID clang::ASTReader::TranslateFileID	(	ModuleFile &	F,
		FileID	FID
	)		const

inline

Translate a FileID from another module file's FileID space into ours.

Definition at line 2313 of file ASTReader.h.

References clang::serialization::ModuleFile::SLocEntryBaseID.

Referenced by ReadFileID().

◆ TranslateSourceLocation()

SourceLocation clang::ASTReader::TranslateSourceLocation	(	ModuleFile &	ModuleFile,
		SourceLocation	Loc
	)		const

inline

Translate a source location from another module file's source location space into ours.

Definition at line 2285 of file ASTReader.h.

References Loc, and clang::serialization::ModuleFile::SLocEntryBaseOffset.

Referenced by ReadSourceLocation().

◆ updateOutOfDateIdentifier()

void ASTReader::updateOutOfDateIdentifier ( const IdentifierInfo & II )

overridevirtual

Update an out-of-date identifier.

Implements clang::ExternalPreprocessorSource.

Definition at line 2296 of file ASTReader.cpp.

References clang::IdentifierInfo::getName().

◆ updateOutOfDateSelector()

void ASTReader::updateOutOfDateSelector ( Selector Sel )

overridevirtual

Load the contents of the global method pool for a given selector if necessary.

Reimplemented from clang::ExternalSemaSource.

Definition at line 8769 of file ASTReader.cpp.

References ReadMethodPool().

◆ UpdateSema()

void ASTReader::UpdateSema ( )

Update the state of Sema after loading some additional modules.

Definition at line 8400 of file ASTReader.cpp.

◆ visitInputFileInfos()

void ASTReader::visitInputFileInfos	(	serialization::ModuleFile &	MF,
		bool	IncludeSystem,
		llvm::function_ref< void(const serialization::InputFileInfo &IFI, bool IsSystem)>	Visitor
	)

Visit all the input file infos of the given module file.

Definition at line 9709 of file ASTReader.cpp.

References clang::serialization::ModuleFile::InputFilesLoaded, and clang::serialization::ModuleFile::NumUserInputFiles.

◆ visitInputFiles()

void ASTReader::visitInputFiles	(	serialization::ModuleFile &	MF,
		bool	IncludeSystem,
		bool	Complain,
		llvm::function_ref< void(const serialization::InputFile &IF, bool isSystem)>	Visitor
	)

Visit all the input files of the given module file.

Definition at line 9725 of file ASTReader.cpp.

References clang::serialization::ModuleFile::InputFilesLoaded, and clang::serialization::ModuleFile::NumUserInputFiles.

◆ visitTopLevelModuleMaps()

void ASTReader::visitTopLevelModuleMaps	(	serialization::ModuleFile &	MF,
		llvm::function_ref< void(FileEntryRef)>	Visitor
	)

Visit all the top-level module maps loaded when building the given module file.

Definition at line 9740 of file ASTReader.cpp.

References clang::serialization::ModuleFile::InputFilesLoaded, clang::serialization::InputFileInfo::ModuleMap, and clang::serialization::InputFileInfo::TopLevel.

Referenced by clang::FrontendAction::BeginSourceFile().

◆ warnStackExhausted()

void ASTReader::warnStackExhausted ( SourceLocation Loc )

Definition at line 9599 of file ASTReader.cpp.

References Diag(), Loc, and clang::Sema::warnStackExhausted().

Friends And Related Function Documentation

◆ ASTDeclMerger

friend class ASTDeclMerger

friend

Types of AST files.

Definition at line 381 of file ASTReader.h.

◆ ASTDeclReader

friend class ASTDeclReader

friend

Definition at line 382 of file ASTReader.h.

◆ ASTIdentifierIterator

friend class ASTIdentifierIterator

friend

Definition at line 383 of file ASTReader.h.

Referenced by getIdentifiers().

◆ ASTRecordReader

friend class ASTRecordReader

friend

Definition at line 384 of file ASTReader.h.

◆ ASTUnit

friend class ASTUnit

friend

Definition at line 385 of file ASTReader.h.

◆ ASTWriter

friend class ASTWriter

friend

Definition at line 386 of file ASTReader.h.

◆ LocalDeclID

friend class LocalDeclID

friend

Definition at line 391 of file ASTReader.h.

◆ PCHValidator

friend class PCHValidator

friend

Definition at line 387 of file ASTReader.h.

◆ serialization::reader::ASTIdentifierLookupTrait

friend class serialization::reader::ASTIdentifierLookupTrait

friend

Definition at line 388 of file ASTReader.h.

◆ serialization::ReadMethodPoolVisitor

friend class serialization::ReadMethodPoolVisitor

friend

Definition at line 389 of file ASTReader.h.

◆ TypeLocReader

friend class TypeLocReader

friend

Definition at line 390 of file ASTReader.h.

Member Data Documentation

◆ CommentsCursors

SmallVector<std::pair<llvm::BitstreamCursor, serialization::ModuleFile *>, 8> clang::ASTReader::CommentsCursors

Cursors for comments blocks.

Definition at line 2437 of file ASTReader.h.

Referenced by ReadComments().

◆ PreloadedDeclIDs

SmallVector<GlobalDeclID, 16> clang::ASTReader::PreloadedDeclIDs

Definition at line 2410 of file ASTReader.h.

Referenced by SetGloballyVisibleDecls().

The documentation for this class was generated from the following files:

include/clang/Serialization/ASTReader.h
lib/Serialization/ASTReader.cpp
lib/Serialization/ASTReaderDecl.cpp
lib/Serialization/ASTReaderStmt.cpp

Classes

Public Types

Friends

Sema-relevant special data

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ ModuleConstIterator

◆ ModuleFile

◆ ModuleIterator

◆ ModuleKind

◆ ModuleManager

◆ ModuleReverseIterator

◆ RawLocEncoding

◆ RecordData

◆ RecordDataImpl

Member Enumeration Documentation

◆ ASTReadResult

◆ LoadFailureCapabilities

Constructor & Destructor Documentation

◆ ASTReader() [1/2]

◆ ASTReader() [2/2]

◆ ~ASTReader()

Member Function Documentation

◆ addInMemoryBuffer()

◆ addListener()

◆ addPendingMacro()

◆ AssignedLambdaNumbering()

◆ ClearSwitchCaseIDs()

◆ CompleteRedeclChain()

◆ completeVisibleDeclsMap()

◆ DecodeIdentifierInfo()

◆ DecodeSelector()

◆ Diag() [1/2]

◆ Diag() [2/2]

◆ dump()

◆ finalizeForWriting()

◆ FindExternalLexicalDecls()

◆ FindExternalVisibleDeclsByName()

◆ FindFileRegionDecls()

◆ findPreprocessedEntitiesInRange()

◆ FinishedDeserializing()

◆ forEachImportedKeyDecl()

◆ ForgetSema()

◆ get()

◆ getContext()

◆ GetDecl()

◆ getDeserializationListener()

◆ getDiags()

◆ GetExistingDecl()

◆ GetExternalCXXBaseSpecifiers()

◆ GetExternalCXXCtorInitializers()

◆ GetExternalDecl()

◆ GetExternalDeclStmt()

◆ GetExternalSelector()

◆ getFileManager()

◆ getGlobalDeclID()

◆ getGlobalIdentifierID()

◆ getGlobalIndex()

◆ getGlobalMacroID()

◆ getGlobalPreprocessedEntityID()

◆ getGlobalSelectorID()

◆ getGlobalSubmoduleID()

◆ getGlobalTypeID()

◆ GetHeaderFileInfo()

◆ GetIdentifier()

◆ getIdentifiers()

◆ getIdentifierTable()

◆ getIdResolver()

◆ getKeyDeclaration() [1/2]

◆ getKeyDeclaration() [2/2]

◆ getLoadedLookupTables()

◆ GetLocalDecl()

◆ GetLocalDeclAs()

◆ getLocalIdentifier()

◆ getLocalModuleFile()

◆ getLocalSelector()

◆ getLocalType()

◆ getMacro()

◆ getMemoryBufferSizes()