The program contains and links the bytecode for all functions. More...

#include "/home/runner/work/llvm/llvm/repo/clang/lib/AST/Interp/Program.h"

Classes
class	DeclScope
	Context to manage declaration lifetimes. More...

Public Member Functions
	Program (Context &Ctx)

	~Program ()

unsigned	getOrCreateNativePointer (const void *Ptr)
	Marshals a native pointer to an ID for embedding in bytecode. More...

const void *	getNativePointer (unsigned Idx)
	Returns the value of a marshalled native pointer. More...

unsigned	createGlobalString (const StringLiteral *S)
	Emits a string literal among global data. More...

Pointer	getPtrGlobal (unsigned Idx) const
	Returns a pointer to a global. More...

Block *	getGlobal (unsigned Idx)
	Returns the value of a global. More...

std::optional< unsigned >	getGlobal (const ValueDecl *VD)
	Finds a global's index. More...

std::optional< unsigned >	getOrCreateGlobal (const ValueDecl VD, const Expr Init=nullptr)
	Returns or creates a global an creates an index to it. More...

std::optional< unsigned >	getOrCreateDummy (const ValueDecl *VD)
	Returns or creates a dummy value for unknown declarations. More...

std::optional< unsigned >	createGlobal (const ValueDecl VD, const Expr Init)
	Creates a global and returns its index. More...

std::optional< unsigned >	createGlobal (const Expr *E)
	Creates a global from a lifetime-extended temporary. More...

template<typename... Ts>
Function *	createFunction (const FunctionDecl *Def, Ts &&... Args)
	Creates a new function from a code range. More...

template<typename... Ts>
Function *	createFunction (Ts &&... Args)
	Creates an anonymous function. More...

Function *	getFunction (const FunctionDecl *F)
	Returns a function. More...

Record *	getOrCreateRecord (const RecordDecl *RD)
	Returns a record or creates one if it does not exist. More...

Descriptor *	createDescriptor (const DeclTy &D, PrimType Type, Descriptor::MetadataSize MDSize=std::nullopt, bool IsConst=false, bool IsTemporary=false, bool IsMutable=false)
	Creates a descriptor for a primitive type. More...

Descriptor *	createDescriptor (const DeclTy &D, const Type Ty, Descriptor::MetadataSize MDSize=std::nullopt, bool IsConst=false, bool IsTemporary=false, bool IsMutable=false, const Expr Init=nullptr)
	Creates a descriptor for a composite type. More...

std::optional< unsigned >	getCurrentDecl () const
	Returns the current declaration ID. More...

void	dump () const
	Dumps the disassembled bytecode to `llvm::errs()`. More...

void	dump (llvm::raw_ostream &OS) const

Friends
class	DeclScope

Detailed Description

The program contains and links the bytecode for all functions.

Definition at line 39 of file Program.h.

Constructor & Destructor Documentation

◆ Program()

clang::interp::Program::Program ( Context & Ctx )

inline

Definition at line 41 of file Program.h.

◆ ~Program()

clang::interp::Program::~Program ( )

inline

Definition at line 43 of file Program.h.

References clang::Global.

Member Function Documentation

◆ createDescriptor() [1/2]

Descriptor * Program::createDescriptor	(	const DeclTy &	D,
		const Type *	Ty,
		Descriptor::MetadataSize	MDSize = `std::nullopt`,
		bool	IsConst = `false`,
		bool	IsTemporary = `false`,
		bool	IsMutable = `false`,
		const Expr *	Init = `nullptr`
	)

Creates a descriptor for a composite type.

Definition at line 348 of file Program.cpp.

References clang::interp::Context::classify(), createDescriptor(), clang::interp::Descriptor::getAllocSize(), clang::Type::getAs(), clang::Type::getAsArrayTypeUnsafe(), clang::ArrayType::getElementType(), getOrCreateRecord(), clang::QualType::getTypePtr(), max(), clang::interp::primSize(), and clang::T.

◆ createDescriptor() [2/2]

Descriptor* clang::interp::Program::createDescriptor	(	const DeclTy &	D,
		PrimType	Type,
		Descriptor::MetadataSize	MDSize = `std::nullopt`,
		bool	IsConst = `false`,
		bool	IsTemporary = `false`,
		bool	IsMutable = `false`
	)

inline

Creates a descriptor for a primitive type.

Definition at line 116 of file Program.h.

Referenced by clang::interp::ByteCodeEmitter::compileFunc(), createDescriptor(), getOrCreateDummy(), and getOrCreateRecord().

◆ createFunction() [1/2]

template<typename... Ts>

Function* clang::interp::Program::createFunction	(	const FunctionDecl *	Def,
		Ts &&...	Args
	)

inline

Creates a new function from a code range.

Definition at line 95 of file Program.h.

References clang::Func, and clang::FunctionDecl::getCanonicalDecl().

Referenced by clang::interp::ByteCodeEmitter::compileFunc().

◆ createFunction() [2/2]

template<typename... Ts>

Function* clang::interp::Program::createFunction ( Ts &&... Args )

inline

Creates an anonymous function.

Definition at line 103 of file Program.h.

References clang::Func.

◆ createGlobal() [1/2]

std::optional< unsigned > Program::createGlobal ( const Expr * E )

Creates a global from a lifetime-extended temporary.

Definition at line 198 of file Program.cpp.

References createGlobal(), and clang::Expr::getType().

◆ createGlobal() [2/2]

std::optional< unsigned > Program::createGlobal	(	const ValueDecl *	VD,
		const Expr *	Init
	)

Creates a global and returns its index.

Definition at line 176 of file Program.cpp.

References clang::ValueDecl::getType(), clang::interp::Init(), clang::isa(), IsStatic, P, and clang::interp::Context::shouldBeGloballyIndexed().

Referenced by createGlobal(), and getOrCreateGlobal().

◆ createGlobalString()

unsigned Program::createGlobalString ( const StringLiteral * S )

Emits a string literal among global data.

Definition at line 37 of file Program.cpp.

◆ dump() [1/2]

LLVM_DUMP_METHOD void Program::dump ( ) const

Dumps the disassembled bytecode to llvm::errs().

Definition at line 91 of file Disasm.cpp.

◆ dump() [2/2]

LLVM_DUMP_METHOD void Program::dump ( llvm::raw_ostream & OS ) const

Definition at line 127 of file Disasm.cpp.

References clang::interp::Descriptor::dump(), clang::Func, clang::interp::Descriptor::getPrimType(), getPtrGlobal(), clang::Global, clang::interp::Descriptor::isDummy(), clang::interp::Pointer::isInitialized(), clang::interp::Descriptor::isPrimitive(), primTypeToString(), and TYPE_SWITCH.

◆ getCurrentDecl()

std::optional<unsigned> clang::interp::Program::getCurrentDecl ( ) const

inline

Returns the current declaration ID.

Definition at line 143 of file Program.h.

Referenced by getOrCreateDummy().

◆ getFunction()

Function * Program::getFunction ( const FunctionDecl * F )

Returns a function.

Definition at line 233 of file Program.cpp.

References clang::FunctionDecl::getCanonicalDecl().

Referenced by clang::interp::ByteCodeEmitter::compileFunc().

◆ getGlobal() [1/2]

std::optional< unsigned > Program::getGlobal ( const ValueDecl * VD )

Finds a global's index.

Definition at line 110 of file Program.cpp.

◆ getGlobal() [2/2]

Block* clang::interp::Program::getGlobal ( unsigned Idx )

inline

Returns the value of a global.

Definition at line 72 of file Program.h.

Referenced by getOrCreateGlobal().

◆ getNativePointer()

const void * Program::getNativePointer ( unsigned Idx )

Returns the value of a marshalled native pointer.

Definition at line 33 of file Program.cpp.

◆ getOrCreateDummy()

std::optional< unsigned > Program::getOrCreateDummy ( const ValueDecl * VD )

Returns or creates a dummy value for unknown declarations.

Definition at line 142 of file Program.cpp.

References clang::interp::Context::classify(), createDescriptor(), clang::interp::Descriptor::getAllocSize(), clang::Type::getAs(), getCurrentDecl(), clang::Type::getPointeeType(), clang::ValueDecl::getType(), clang::QualType::getTypePtr(), clang::Global, clang::interp::Descriptor::isDummy(), clang::interp::Descriptor::makeDummy(), and clang::T.

◆ getOrCreateGlobal()

std::optional< unsigned > Program::getOrCreateGlobal	(	const ValueDecl *	VD,
		const Expr *	Init = `nullptr`
	)

Returns or creates a global an creates an index to it.

Definition at line 130 of file Program.cpp.

References createGlobal(), getGlobal(), and clang::interp::Init().

◆ getOrCreateNativePointer()

unsigned Program::getOrCreateNativePointer ( const void * Ptr )

Marshals a native pointer to an ID for embedding in bytecode.

Definition at line 22 of file Program.cpp.

◆ getOrCreateRecord()

Record * Program::getOrCreateRecord ( const RecordDecl * RD )

Returns a record or creates one if it does not exist.

Definition at line 240 of file Program.cpp.

References clang::interp::align(), clang::interp::Context::classify(), createDescriptor(), clang::RecordDecl::fields(), clang::interp::Descriptor::getAllocSize(), clang::RecordDecl::getDefinition(), clang::interp::Record::getSize(), clang::QualType::getTypePtr(), clang::TagDecl::isCompleteDefinition(), clang::QualType::isConstQualified(), and clang::T.

Referenced by clang::interp::ByteCodeEmitter::compileFunc(), and createDescriptor().

◆ getPtrGlobal()

Pointer Program::getPtrGlobal ( unsigned Idx ) const

Returns a pointer to a global.

Definition at line 105 of file Program.cpp.

Referenced by dump().

Friends And Related Function Documentation

◆ DeclScope

friend class DeclScope

friend

Definition at line 150 of file Program.h.

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

lib/AST/Interp/Program.h
lib/AST/Interp/Disasm.cpp
lib/AST/Interp/Program.cpp

Classes

Public Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ Program()

◆ ~Program()

Member Function Documentation

◆ createDescriptor() [1/2]

◆ createDescriptor() [2/2]

◆ createFunction() [1/2]

◆ createFunction() [2/2]

◆ createGlobal() [1/2]

◆ createGlobal() [2/2]

◆ createGlobalString()

◆ dump() [1/2]

◆ dump() [2/2]

◆ getCurrentDecl()

◆ getFunction()

◆ getGlobal() [1/2]

◆ getGlobal() [2/2]

◆ getNativePointer()

◆ getOrCreateDummy()

◆ getOrCreateGlobal()

◆ getOrCreateNativePointer()

◆ getOrCreateRecord()

◆ getPtrGlobal()

Friends And Related Function Documentation

◆ DeclScope