Manages the set of modules loaded by an AST reader. More...

#include "clang/Serialization/ModuleManager.h"

Public Types
using	ModuleIterator
using	ModuleConstIterator
using	ModuleReverseIterator
using	ModuleOffset = std::pair<uint32_t, StringRef>
using	ASTFileSignatureReader = ASTFileSignature (*)(StringRef)

Public Member Functions
	ModuleManager (FileManager &FileMgr, ModuleCache &ModCache, const PCHContainerReader &PCHContainerRdr, const HeaderSearch &HeaderSearchInfo)
ModuleIterator	begin ()
	Forward iterator to traverse all loaded modules.
ModuleIterator	end ()
	Forward iterator end-point to traverse all loaded modules.
ModuleConstIterator	begin () const
	Const forward iterator to traverse all loaded modules.
ModuleConstIterator	end () const
	Const forward iterator end-point to traverse all loaded modules.
ModuleReverseIterator	rbegin ()
	Reverse iterator to traverse all loaded modules.
ModuleReverseIterator	rend ()
	Reverse iterator end-point to traverse all loaded modules.
llvm::iterator_range< SmallVectorImpl< ModuleFile * >::const_iterator >	pch_modules () const
	A range covering the PCH and preamble module files loaded.
ModuleFile &	getPrimaryModule ()
	Returns the primary module associated with the manager, that is, the first module loaded.
ModuleFile &	getPrimaryModule () const
	Returns the primary module associated with the manager, that is, the first module loaded.
ModuleFile &	operator[] (unsigned Index) const
	Returns the module associated with the given index.
ModuleFile *	lookupByModuleName (StringRef ModName) const
	Returns the module associated with the given module name.
ModuleFile *	lookupByFileName (ModuleFileName FileName) const
	Returns the module associated with the given module file name.
ModuleFile *	lookup (ModuleFileKey Key) const
	Returns the module associated with the given module file key.
std::unique_ptr< llvm::MemoryBuffer >	lookupBuffer (StringRef Name, off_t &Size, time_t &ModTime)
	Returns the in-memory (virtual file) buffer with the given name.
unsigned	size () const
	Number of modules loaded.
AddModuleResult	addModule (ModuleFileName FileName, ModuleKind Type, SourceLocation ImportLoc, ModuleFile *ImportedBy, unsigned Generation, off_t ExpectedSize, time_t ExpectedModTime, ASTFileSignature ExpectedSignature, ASTFileSignatureReader ReadSignature)
	Attempts to create a new module and add it to the list of known modules.
void	removeModules (ModuleIterator First)
	Remove the modules starting from First (to the end).
void	addInMemoryBuffer (StringRef FileName, std::unique_ptr< llvm::MemoryBuffer > Buffer)
	Add an in-memory buffer the list of known buffers.
void	setGlobalIndex (GlobalModuleIndex *Index)
	Set the global module index.
void	moduleFileAccepted (ModuleFile *MF)
	Notification from the AST reader that the given module file has been "accepted", and will not (can not) be unloaded.
void	visit (llvm::function_ref< bool(ModuleFile &M)> Visitor, llvm::SmallPtrSetImpl< ModuleFile * > *ModuleFilesHit=nullptr)
	Visit each of the modules.
void	viewGraph ()
	View the graphviz representation of the module graph.
ModuleCache &	getModuleCache () const

Detailed Description

Manages the set of modules loaded by an AST reader.

Definition at line 102 of file ModuleManager.h.

Member Typedef Documentation

◆ ASTFileSignatureReader

using clang::serialization::ModuleManager::ASTFileSignatureReader = ASTFileSignature (*)(StringRef)

Definition at line 255 of file ModuleManager.h.

◆ ModuleConstIterator

using clang::serialization::ModuleManager::ModuleConstIterator

Initial value:

llvm::pointee_iterator<

SmallVectorImpl<std::unique_ptr<ModuleFile>>::const_iterator>

llvm::SmallVectorImpl

Definition Randstruct.h:18

Definition at line 194 of file ModuleManager.h.

◆ ModuleIterator

using clang::serialization::ModuleManager::ModuleIterator

Initial value:

llvm::pointee_iterator<

SmallVectorImpl<std::unique_ptr<ModuleFile>>::iterator>

Definition at line 192 of file ModuleManager.h.

◆ ModuleOffset

using clang::serialization::ModuleManager::ModuleOffset = std::pair<uint32_t, StringRef>

Definition at line 198 of file ModuleManager.h.

◆ ModuleReverseIterator

using clang::serialization::ModuleManager::ModuleReverseIterator

Initial value:

llvm::pointee_iterator<

SmallVectorImpl<std::unique_ptr<ModuleFile>>::reverse_iterator>

llvm::reverse_iterator

Definition at line 196 of file ModuleManager.h.

Constructor & Destructor Documentation

◆ ModuleManager()

ModuleManager::ModuleManager	(	FileManager &	FileMgr,
		ModuleCache &	ModCache,
		const PCHContainerReader &	PCHContainerRdr,
		const HeaderSearch &	HeaderSearchInfo )

Definition at line 359 of file ModuleManager.cpp.

Member Function Documentation

◆ addInMemoryBuffer()

void ModuleManager::addInMemoryBuffer	(	StringRef	FileName,
		std::unique_ptr< llvm::MemoryBuffer >	Buffer )

Add an in-memory buffer the list of known buffers.

Definition at line 313 of file ModuleManager.cpp.

References clang::FileName.

◆ addModule()

AddModuleResult ModuleManager::addModule	(	ModuleFileName	FileName,
		ModuleKind	Type,
		SourceLocation	ImportLoc,
		ModuleFile *	ImportedBy,
		unsigned	Generation,
		off_t	ExpectedSize,
		time_t	ExpectedModTime,
		ASTFileSignature	ExpectedSignature,
		ASTFileSignatureReader	ReadSignature )

Attempts to create a new module and add it to the list of known modules.

Parameters

FileName	The file name of the module to be loaded.
Type	The kind of module being loaded.
ImportLoc	The location at which the module is imported.
ImportedBy	The module that is importing this module, or NULL if this module is imported directly by the user.
Generation	The generation in which this module was loaded.
ExpectedSize	The expected size of the module file, used for validation. This will be zero if unknown.
ExpectedModTime	The expected modification time of the module file, used for validation. This will be zero if unknown.
ExpectedSignature	The expected signature of the module file, used for validation. This will be zero if unknown.
ReadSignature	Reads the signature from an AST file without actually loading it.

Returns: The result of attempting to add the module, including a pointer to the module file if successfully loaded.

Definition at line 114 of file ModuleManager.cpp.

◆ begin() [1/2]

ModuleIterator clang::serialization::ModuleManager::begin ( )

inline

Forward iterator to traverse all loaded modules.

Definition at line 205 of file ModuleManager.h.

Referenced by llvm::GraphTraits< ModuleManager >::nodes_begin(), and removeModules().

◆ begin() [2/2]

ModuleConstIterator clang::serialization::ModuleManager::begin ( ) const

inline

Const forward iterator to traverse all loaded modules.

Definition at line 211 of file ModuleManager.h.

◆ end() [1/2]

ModuleIterator clang::serialization::ModuleManager::end ( )

inline

Forward iterator end-point to traverse all loaded modules.

Definition at line 208 of file ModuleManager.h.

Referenced by llvm::GraphTraits< ModuleManager >::nodes_end(), and removeModules().

◆ end() [2/2]

ModuleConstIterator clang::serialization::ModuleManager::end ( ) const

inline

Const forward iterator end-point to traverse all loaded modules.

Definition at line 214 of file ModuleManager.h.

◆ getModuleCache()

ModuleCache & clang::serialization::ModuleManager::getModuleCache ( ) const

inline

Definition at line 331 of file ModuleManager.h.

Referenced by addModule().

◆ getPrimaryModule() [1/2]

ModuleFile & clang::serialization::ModuleManager::getPrimaryModule ( )

inline

Returns the primary module associated with the manager, that is, the first module loaded.

Definition at line 230 of file ModuleManager.h.

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

◆ getPrimaryModule() [2/2]

ModuleFile & clang::serialization::ModuleManager::getPrimaryModule ( ) const

inline

Returns the primary module associated with the manager, that is, the first module loaded.

Definition at line 234 of file ModuleManager.h.

◆ lookup()

ModuleFile * ModuleManager::lookup ( ModuleFileKey Key ) const

Returns the module associated with the given module file key.

Definition at line 57 of file ModuleManager.cpp.

Referenced by addModule(), and lookupByFileName().

◆ lookupBuffer()

std::unique_ptr< llvm::MemoryBuffer > ModuleManager::lookupBuffer	(	StringRef	Name,
		off_t &	Size,
		time_t &	ModTime )

Returns the in-memory (virtual file) buffer with the given name.

Definition at line 62 of file ModuleManager.cpp.

Referenced by addModule().

◆ lookupByFileName()

ModuleFile * ModuleManager::lookupByFileName ( ModuleFileName FileName ) const

Returns the module associated with the given module file name.

Definition at line 52 of file ModuleManager.cpp.

References lookup(), and clang::ModuleFileName::makeKey().

Referenced by lookupByModuleName().

◆ lookupByModuleName()

ModuleFile * ModuleManager::lookupByModuleName ( StringRef ModName ) const

Returns the module associated with the given module name.

Definition at line 44 of file ModuleManager.cpp.

References clang::FileName, and lookupByFileName().

◆ moduleFileAccepted()

void ModuleManager::moduleFileAccepted ( ModuleFile * MF )

Notification from the AST reader that the given module file has been "accepted", and will not (can not) be unloaded.

Definition at line 352 of file ModuleManager.cpp.

◆ operator[]()

ModuleFile & clang::serialization::ModuleManager::operator[] ( unsigned Index ) const

inline

Returns the module associated with the given index.

Definition at line 237 of file ModuleManager.h.

◆ pch_modules()

llvm::iterator_range< SmallVectorImpl< ModuleFile * >::const_iterator > clang::serialization::ModuleManager::pch_modules ( ) const

inline

A range covering the PCH and preamble module files loaded.

Definition at line 224 of file ModuleManager.h.

Referenced by clang::ASTReader::getLocalModuleFile(), and clang::ASTReader::getModuleFileID().

◆ rbegin()

ModuleReverseIterator clang::serialization::ModuleManager::rbegin ( )

inline

Reverse iterator to traverse all loaded modules.

Definition at line 217 of file ModuleManager.h.

Referenced by getTopImportImplicitModule().

◆ removeModules()

void ModuleManager::removeModules ( ModuleIterator First )

Remove the modules starting from First (to the end).

Definition at line 274 of file ModuleManager.cpp.

References begin(), end(), clang::First, and clang::Last.

◆ rend()

ModuleReverseIterator clang::serialization::ModuleManager::rend ( )

inline

Reverse iterator end-point to traverse all loaded modules.

Definition at line 220 of file ModuleManager.h.

◆ setGlobalIndex()

void ModuleManager::setGlobalIndex ( GlobalModuleIndex * Index )

Set the global module index.

Definition at line 338 of file ModuleManager.cpp.

◆ size()

unsigned clang::serialization::ModuleManager::size ( ) const

inline

Number of modules loaded.

Definition at line 253 of file ModuleManager.h.

Referenced by clang::PCHValidator::ReadDiagnosticOptions(), and visit().

◆ viewGraph()

void ModuleManager::viewGraph ( )

View the graphviz representation of the module graph.

Definition at line 506 of file ModuleManager.cpp.

◆ visit()

void ModuleManager::visit	(	llvm::function_ref< bool(ModuleFile &M)>	Visitor,
		llvm::SmallPtrSetImpl< ModuleFile * > *	ModuleFilesHit = nullptr )

Visit each of the modules.

This routine visits each of the modules, starting with the "root" modules that no other loaded modules depend on, and proceeding to the leaf modules, visiting each module only once during the traversal.

This traversal is intended to support various "lookup" operations that can find data in any of the loaded modules.

Parameters

Visitor	A visitor function that will be invoked with each module. The return value must be convertible to bool; when false, the visitation continues to modules that the current module depends on. When true, the visitation skips any modules that the current module depends on.
ModuleFilesHit	If non-NULL, contains the set of module files that we know we need to visit because the global module index told us to. Any module that is known to both the global module index and the module manager that is not in this set can be skipped.

Definition at line 365 of file ModuleManager.cpp.

References clang::serialization::ModuleFile::ImportedBy, clang::serialization::ModuleFile::Imports, clang::serialization::ModuleFile::Index, and size().

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

include/clang/Serialization/ModuleManager.h
lib/Serialization/ModuleManager.cpp

Public Types

Public Member Functions

Detailed Description

Member Typedef Documentation

◆ ASTFileSignatureReader

◆ ModuleConstIterator

◆ ModuleIterator

◆ ModuleOffset

◆ ModuleReverseIterator

Constructor & Destructor Documentation

◆ ModuleManager()

Member Function Documentation

◆ addInMemoryBuffer()

◆ addModule()

◆ begin() [1/2]

◆ begin() [2/2]

◆ end() [1/2]

◆ end() [2/2]

◆ getModuleCache()

◆ getPrimaryModule() [1/2]

◆ getPrimaryModule() [2/2]

◆ lookup()

◆ lookupBuffer()

◆ lookupByFileName()

◆ lookupByModuleName()

◆ moduleFileAccepted()

◆ operator[]()

◆ pch_modules()

◆ rbegin()

◆ removeModules()

◆ rend()

◆ setGlobalIndex()

◆ size()

◆ viewGraph()

◆ visit()