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

#include "/home/buildbot/as-worker-4/publish-doxygen-docs/llvm-project/clang/lib/AST/ByteCode/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.

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

unsigned	createGlobalString (const StringLiteral S, const Expr Base=nullptr)
	Emits a string literal among global data.

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

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

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

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

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

unsigned	getOrCreateDummy (const DeclTy &D)
	Returns or creates a dummy value for unknown declarations.

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

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

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

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

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

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

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.

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.

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

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

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, and clang::interp::Block::isInitialized().

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 388 of file Program.cpp.

References clang::interp::Context::classify(), createDescriptor(), D, clang::interp::Descriptor::getAllocSize(), clang::Type::getAs(), clang::Type::getAsArrayTypeUnsafe(), clang::ArrayType::getElementType(), getOrCreateRecord(), clang::QualType::getTypePtr(), 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 118 of file Program.h.

References D.

Referenced by clang::interp::ByteCodeEmitter::compileFunc(), clang::interp::ByteCodeEmitter::compileObjCBlock(), 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 98 of file Program.h.

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

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

◆ createFunction() [2/2]

template<typename... Ts>

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

inline

Creates an anonymous function.

Definition at line 105 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 230 of file Program.cpp.

References createGlobal(), E, getGlobal(), 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 197 of file Program.cpp.

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

Referenced by createGlobal(), and getOrCreateGlobal().

◆ createGlobalString()

unsigned Program::createGlobalString	(	const StringLiteral *	S,
		const Expr *	Base = `nullptr`
	)

Emits a string literal among global data.

Definition at line 35 of file Program.cpp.

References clang::interp::Pointer::atIndex(), clang::interp::Descriptor::getAllocSize(), clang::interp::Context::getCharBit(), clang::interp::Context::getEvalID(), clang::Global, clang::interp::Descriptor::GlobalMD, clang::interp::Pointer::narrow(), clang::interp::PT_Sint8, clang::interp::PT_Uint16, clang::interp::PT_Uint32, and clang::T.

◆ dump() [1/2]

LLVM_DUMP_METHOD void Program::dump ( ) const

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

Definition at line 102 of file Disasm.cpp.

References dump().

Referenced by dump().

◆ dump() [2/2]

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

Definition at line 142 of file Disasm.cpp.

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

◆ getCurrentDecl()

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

inline

Returns the current declaration ID.

Definition at line 145 of file Program.h.

Referenced by getOrCreateDummy().

◆ getFunction()

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

Returns a function.

Definition at line 273 of file Program.cpp.

References clang::FunctionDecl::getCanonicalDecl().

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

◆ getGlobal() [1/3]

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

Definition at line 131 of file Program.cpp.

References E.

◆ getGlobal() [2/3]

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

Finds a global's index.

Definition at line 111 of file Program.cpp.

References clang::Decl::getPreviousDecl(), and P.

◆ getGlobal() [3/3]

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

inline

Returns the value of a global.

Definition at line 74 of file Program.h.

Referenced by createGlobal(), and getOrCreateGlobal().

◆ getNativePointer()

const void * Program::getNativePointer ( unsigned Idx )

Returns the value of a marshalled native pointer.

Definition at line 31 of file Program.cpp.

◆ getOrCreateDummy()

unsigned Program::getOrCreateDummy ( const DeclTy & D )

Returns or creates a dummy value for unknown declarations.

Definition at line 149 of file Program.cpp.

References clang::interp::Context::classify(), createDescriptor(), D, E, clang::interp::Descriptor::getAllocSize(), clang::Type::getAs(), getCurrentDecl(), clang::interp::Context::getEvalID(), clang::Type::getPointeeType(), clang::ValueDecl::getType(), clang::Expr::getType(), clang::QualType::getTypePtr(), clang::Global, clang::interp::Descriptor::isDummy(), clang::QualType::isNull(), clang::ValueDecl::isWeak(), 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 137 of file Program.cpp.

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

◆ getOrCreateNativePointer()

unsigned Program::getOrCreateNativePointer ( const void * Ptr )

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

Definition at line 20 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 280 of file Program.cpp.

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

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

◆ getPtrGlobal()

Pointer Program::getPtrGlobal ( unsigned Idx ) const

Returns a pointer to a global.

Definition at line 106 of file Program.cpp.

Referenced by dump().

Friends And Related Function Documentation

◆ DeclScope

friend class DeclScope

friend

Definition at line 152 of file Program.h.

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

lib/AST/ByteCode/Program.h
lib/AST/ByteCode/Disasm.cpp
lib/AST/ByteCode/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/3]

◆ getGlobal() [2/3]

◆ getGlobal() [3/3]

◆ getNativePointer()

◆ getOrCreateDummy()

◆ getOrCreateGlobal()

◆ getOrCreateNativePointer()

◆ getOrCreateRecord()

◆ getPtrGlobal()

Friends And Related Function Documentation

◆ DeclScope