llvm::BitcodeModule Class Reference

Represents a module in a bitcode file. More...

#include "llvm/Bitcode/BitcodeReader.h"

Public Member Functions
StringRef	getBuffer () const
StringRef	getStrtab () const
StringRef	getModuleIdentifier () const
Expected< std::unique_ptr< Module > >	getLazyModule (LLVMContext &Context, bool ShouldLazyLoadMetadata, bool IsImporting, ParserCallbacks Callbacks={})
	Read the bitcode module and prepare for lazy deserialization of function bodies.
Expected< std::unique_ptr< Module > >	parseModule (LLVMContext &Context, ParserCallbacks Callbacks={})
	Read the entire bitcode module and return it.
Expected< BitcodeLTOInfo >	getLTOInfo ()
	Returns information about the module to be used for LTO: whether to compile with ThinLTO, and whether it has a summary.
Expected< std::unique_ptr< ModuleSummaryIndex > >	getSummary ()
	Parse the specified bitcode buffer, returning the module summary index.
Error	readSummary (ModuleSummaryIndex &CombinedIndex, StringRef ModulePath, uint64_t ModuleId, std::function< bool(GlobalValue::GUID)> IsPrevailing=nullptr)
	Parse the specified bitcode buffer and merge its module summary index into CombinedIndex.

Friends
Expected< BitcodeFileContents >	getBitcodeFileContents (MemoryBufferRef Buffer)
	Returns the contents of a bitcode file.

Detailed Description

Represents a module in a bitcode file.

Definition at line 100 of file BitcodeReader.h.

Member Function Documentation

getBuffer()

StringRef llvm::BitcodeModule::getBuffer ( ) const

inline

Definition at line 129 of file BitcodeReader.h.

References llvm::ArrayRef< T >::begin(), and llvm::ArrayRef< T >::size().

getLazyModule()

Expected< std::unique_ptr< Module > > BitcodeModule::getLazyModule	(	LLVMContext &	Context,
		bool	ShouldLazyLoadMetadata,
		bool	IsImporting,
		ParserCallbacks	Callbacks = {}
	)

Read the bitcode module and prepare for lazy deserialization of function bodies.

If ShouldLazyLoadMetadata is true, lazily load metadata as well. If IsImporting is true, this module is being parsed for ThinLTO importing into another module.

Definition at line 7997 of file BitcodeReader.cpp.

References Context.

getLTOInfo()

Expected< BitcodeLTOInfo > BitcodeModule::getLTOInfo

(

)

Returns information about the module to be used for LTO: whether to compile with ThinLTO, and whether it has a summary.

Definition at line 8080 of file BitcodeReader.cpp.

References llvm::BitstreamCursor::advance(), E, llvm::BitstreamEntry::EndBlock, llvm::BitstreamCursor::EnterSubBlock(), llvm::BitstreamEntry::Error, error, llvm::bitc::FULL_LTO_GLOBALVAL_SUMMARY_BLOCK_ID, getEnableSplitLTOUnitFlag(), llvm::bitc::GLOBALVAL_SUMMARY_BLOCK_ID, llvm::BitstreamCursor::JumpToBit(), llvm::bitc::MODULE_BLOCK_ID, llvm::BitstreamEntry::Record, llvm::BitstreamCursor::SkipBlock(), llvm::BitstreamCursor::skipRecord(), llvm::BitstreamEntry::SubBlock, and llvm::Expected< T >::takeError().

getModuleIdentifier()

StringRef llvm::BitcodeModule::getModuleIdentifier ( ) const

inline

Definition at line 135 of file BitcodeReader.h.

getStrtab()

StringRef llvm::BitcodeModule::getStrtab ( ) const

inline

Definition at line 133 of file BitcodeReader.h.

getSummary()

Expected< std::unique_ptr< ModuleSummaryIndex > > BitcodeModule::getSummary

(

)

Parse the specified bitcode buffer, returning the module summary index.

Definition at line 8020 of file BitcodeReader.cpp.

References llvm::BitstreamCursor::JumpToBit().

parseModule()

Expected< std::unique_ptr< Module > > BitcodeModule::parseModule	(	LLVMContext &	Context,
		ParserCallbacks	Callbacks = {}
	)

Read the entire bitcode module and return it.

Definition at line 8167 of file BitcodeReader.cpp.

References Context.

readSummary()

Error BitcodeModule::readSummary	(	ModuleSummaryIndex &	CombinedIndex,
		StringRef	ModulePath,
		uint64_t	ModuleId,
		std::function< bool(GlobalValue::GUID)>	IsPrevailing = nullptr
	)

Parse the specified bitcode buffer and merge its module summary index into CombinedIndex.

Definition at line 8007 of file BitcodeReader.cpp.

References llvm::BitstreamCursor::JumpToBit().

Friends And Related Function Documentation

getBitcodeFileContents

Expected< BitcodeFileContents > getBitcodeFileContents ( MemoryBufferRef  Buffer )

friend

Returns the contents of a bitcode file.

This includes the raw contents of the symbol table embedded in the bitcode file. Clients which require a symbol table should prefer to use irsymtab::read instead of this function because it creates a reader for the irsymtab and handles upgrading bitcode files without a symbol table or with an old symbol table.

---

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

• include/llvm/Bitcode/BitcodeReader.h
• lib/Bitcode/Reader/BitcodeReader.cpp