Frame storing local variables. More...

#include "/home/buildbot/as-worker-4/publish-doxygen-docs/llvm-project/clang/lib/AST/ByteCode/InterpFrame.h"

Inheritance diagram for clang::interp::InterpFrame:

Public Member Functions
	InterpFrame (InterpState &S)
	Bottom Frame.

	InterpFrame (InterpState &S, const Function Func, InterpFrame Caller, CodePtr RetPC, unsigned ArgSize)
	Creates a new frame for a method call.

	InterpFrame (InterpState &S, const Function *Func, CodePtr RetPC, unsigned VarArgSize=0)
	Creates a new frame with the values that make sense.

	~InterpFrame ()
	Destroys the frame, killing all live pointers to stack slots.

void	destroy (unsigned Idx)
	Invokes the destructors for a scope.

void	initScope (unsigned Idx)

void	destroyScopes ()

void	describe (llvm::raw_ostream &OS) const override
	Describes the frame with arguments for diagnostic purposes.

Frame *	getCaller () const override
	Returns the parent frame object.

SourceRange	getCallRange () const override
	Returns the location of the call to the frame.

const FunctionDecl *	getCallee () const override
	Returns the caller.

const Function *	getFunction () const
	Returns the current function.

size_t	getFrameOffset () const
	Returns the offset on the stack at which the frame starts.

template<typename T >
const T &	getLocal (unsigned Offset) const
	Returns the value of a local variable.

template<typename T >
void	setLocal (unsigned Offset, const T &Value)
	Mutates a local variable.

Pointer	getLocalPointer (unsigned Offset) const
	Returns a pointer to a local variables.

template<typename T >
const T &	getParam (unsigned Offset) const
	Returns the value of an argument.

template<typename T >
void	setParam (unsigned Offset, const T &Value)
	Mutates a local copy of a parameter.

Pointer	getParamPointer (unsigned Offset)
	Returns a pointer to an argument - lazily creates a block.

const Pointer &	getThis () const
	Returns the 'this' pointer.

const Pointer &	getRVOPtr () const
	Returns the RVO pointer, if the Function has one.

bool	isRoot () const
	Checks if the frame is a root frame - return should quit the interpreter.

CodePtr	getPC () const
	Returns the PC of the frame's code start.

CodePtr	getRetPC () const
	Returns the return address of the frame.

virtual SourceInfo	getSource (CodePtr PC) const
	Map a location to a source.

const Expr *	getExpr (CodePtr PC) const

SourceLocation	getLocation (CodePtr PC) const

SourceRange	getRange (CodePtr PC) const

unsigned	getDepth () const

bool	isStdFunction () const

bool	isBottomFrame () const

void	dump () const

void	dump (llvm::raw_ostream &OS, unsigned Indent=0) const

Public Member Functions inherited from clang::interp::Frame
virtual	~Frame ()

virtual void	describe (llvm::raw_ostream &OS) const =0
	Generates a human-readable description of the call site.

virtual Frame *	getCaller () const =0
	Returns a pointer to the caller frame.

virtual SourceRange	getCallRange () const =0
	Returns the location of the call site.

virtual const FunctionDecl *	getCallee () const =0
	Returns the called function's declaration.

Static Public Member Functions
static void	free (InterpFrame *F)

Public Attributes
InterpFrame *	Caller
	The frame of the previous function.

Detailed Description

Frame storing local variables.

Definition at line 26 of file InterpFrame.h.

Constructor & Destructor Documentation

◆ InterpFrame() [1/3]

InterpFrame::InterpFrame ( InterpState & S )

Bottom Frame.

Definition at line 26 of file InterpFrame.cpp.

◆ InterpFrame() [2/3]

InterpFrame::InterpFrame	(	InterpState &	S,
		const Function *	Func,
		InterpFrame *	Caller,
		CodePtr	RetPC,
		unsigned	ArgSize
	)

Creates a new frame for a method call.

Definition at line 30 of file InterpFrame.cpp.

References clang::Func, and clang::interp::Scope::locals().

◆ InterpFrame() [3/3]

InterpFrame::InterpFrame	(	InterpState &	S,
		const Function *	Func,
		CodePtr	RetPC,
		unsigned	VarArgSize = `0`
	)

Creates a new frame with the values that make sense.

I.e., the caller is the current frame of S, the This() pointer is the current Pointer on the top of S's stack, and the RVO pointer is before that.

Definition at line 53 of file InterpFrame.cpp.

References clang::Func.

◆ ~InterpFrame()

InterpFrame::~InterpFrame ( )

Destroys the frame, killing all live pointers to stack slots.

Definition at line 73 of file InterpFrame.cpp.

References clang::interp::InterpState::deallocate(), and destroyScopes().

Member Function Documentation

◆ describe()

void InterpFrame::describe ( llvm::raw_ostream & OS ) const

overridevirtual

Describes the frame with arguments for diagnostic purposes.

Implements clang::interp::Frame.

Definition at line 126 of file InterpFrame.cpp.

References clang::interp::align(), Caller, clang::interp::Context::classify(), clang::interp::InterpState::Ctx, clang::interp::InterpState::getASTContext(), getCallee(), getExpr(), getFunction(), clang::ASTContext::getLValueReferenceType(), clang::FunctionDecl::getNameForDiagnostic(), clang::FunctionDecl::getNumParams(), clang::FunctionDecl::getParamDecl(), clang::ASTContext::getPrintingPolicy(), clang::ASTContext::getRecordType(), getRetPC(), clang::ValueDecl::getType(), clang::interp::Function::hasRVO(), clang::interp::Function::hasThisPointer(), clang::interp::primSize(), print(), clang::interp::PT_Ptr, shouldSkipInBacktrace(), and TYPE_SWITCH.

Referenced by dump().

◆ destroy()

void InterpFrame::destroy ( unsigned Idx )

Invokes the destructors for a scope.

Definition at line 101 of file InterpFrame.cpp.

References clang::interp::InterpState::deallocate(), clang::interp::Function::getScope(), and clang::interp::Scope::locals().

◆ destroyScopes()

void InterpFrame::destroyScopes ( )

Definition at line 83 of file InterpFrame.cpp.

References clang::interp::InterpState::deallocate(), clang::interp::Scope::locals(), and clang::interp::Function::scopes().

Referenced by ~InterpFrame(), and clang::interp::InterpState::~InterpState().

◆ dump() [1/2]

void clang::interp::InterpFrame::dump ( ) const

inline

Definition at line 133 of file InterpFrame.h.

References dump().

Referenced by dump().

◆ dump() [2/2]

LLVM_DUMP_METHOD void InterpFrame::dump	(	llvm::raw_ostream &	OS,
		unsigned	Indent = `0`
	)		const

Definition at line 274 of file Disasm.cpp.

References Caller, describe(), getCallee(), getDepth(), clang::interp::Function::getFrameSize(), getFunction(), getRVOPtr(), and getThis().

◆ free()

static void clang::interp::InterpFrame::free ( InterpFrame * F )

inlinestatic

Definition at line 48 of file InterpFrame.h.

References isBottomFrame().

Referenced by clang::interp::Ret(), and clang::interp::RetVoid().

◆ getCallee()

const FunctionDecl * InterpFrame::getCallee ( ) const

overridevirtual

Returns the caller.

Implements clang::interp::Frame.

Definition at line 199 of file InterpFrame.cpp.

References clang::interp::Function::getDecl().

Referenced by describe(), dump(), and clang::interp::interp__builtin_is_constant_evaluated().

◆ getCaller()

Frame * InterpFrame::getCaller ( ) const

overridevirtual

Returns the parent frame object.

Implements clang::interp::Frame.

Definition at line 184 of file InterpFrame.cpp.

References Caller, and clang::interp::InterpState::getSplitFrame().

◆ getCallRange()

SourceRange InterpFrame::getCallRange ( ) const

overridevirtual

Returns the location of the call to the frame.

Implements clang::interp::Frame.

Definition at line 190 of file InterpFrame.cpp.

References Caller, clang::interp::InterpState::EvalLocation, clang::interp::SourceMapper::getRange(), and clang::SourceRange::isValid().

◆ getDepth()

unsigned clang::interp::InterpFrame::getDepth ( ) const

inline

Definition at line 127 of file InterpFrame.h.

Referenced by dump(), and clang::interp::InterpState::getCallStackDepth().

◆ getExpr()

const Expr * InterpFrame::getExpr ( CodePtr PC ) const

Definition at line 253 of file InterpFrame.cpp.

References Caller, funcHasUsableBody(), getExpr(), and clang::interp::SourceMapper::getExpr().

Referenced by describe(), getExpr(), and clang::interp::interp__builtin_is_constant_evaluated().

◆ getFrameOffset()

size_t clang::interp::InterpFrame::getFrameOffset ( ) const

inline

Returns the offset on the stack at which the frame starts.

Definition at line 74 of file InterpFrame.h.

◆ getFunction()

const Function * clang::interp::InterpFrame::getFunction ( ) const

inline

Returns the current function.

Definition at line 71 of file InterpFrame.h.

Referenced by describe(), and dump().

◆ getLocal()

template<typename T >

const T & clang::interp::InterpFrame::getLocal ( unsigned Offset ) const

inline

Returns the value of a local variable.

Definition at line 77 of file InterpFrame.h.

◆ getLocalPointer()

Pointer InterpFrame::getLocalPointer ( unsigned Offset ) const

Returns a pointer to a local variables.

Definition at line 205 of file InterpFrame.cpp.

◆ getLocation()

SourceLocation InterpFrame::getLocation ( CodePtr PC ) const

Definition at line 260 of file InterpFrame.cpp.

References Caller, funcHasUsableBody(), getLocation(), and clang::interp::SourceMapper::getLocation().

Referenced by getLocation().

◆ getParam()

template<typename T >

const T & clang::interp::InterpFrame::getParam ( unsigned Offset ) const

inline

Returns the value of an argument.

Definition at line 91 of file InterpFrame.h.

References clang::interp::Pointer::deref(), and clang::T.

◆ getParamPointer()

Pointer InterpFrame::getParamPointer ( unsigned Offset )

Returns a pointer to an argument - lazily creates a block.

Definition at line 210 of file InterpFrame.cpp.

References clang::interp::InterpState::Ctx, clang::interp::Context::getEvalID(), clang::interp::Function::getParamDescriptor(), clang::interp::Block::invokeCtor(), clang::T, and TYPE_SWITCH.

Referenced by setParam().

◆ getPC()

CodePtr clang::interp::InterpFrame::getPC ( ) const

inline

Returns the PC of the frame's code start.

Definition at line 116 of file InterpFrame.h.

References clang::interp::Function::getCodeBegin().

◆ getRange()

SourceRange InterpFrame::getRange ( CodePtr PC ) const

Definition at line 267 of file InterpFrame.cpp.

References Caller, funcHasUsableBody(), getRange(), and clang::interp::SourceMapper::getRange().

Referenced by getRange().

◆ getRetPC()

CodePtr clang::interp::InterpFrame::getRetPC ( ) const

inline

Returns the return address of the frame.

Definition at line 119 of file InterpFrame.h.

Referenced by describe(), and clang::interp::interp__builtin_is_constant_evaluated().

◆ getRVOPtr()

const Pointer & clang::interp::InterpFrame::getRVOPtr ( ) const

inline

Returns the RVO pointer, if the Function has one.

Definition at line 110 of file InterpFrame.h.

Referenced by dump().

◆ getSource()

SourceInfo InterpFrame::getSource ( CodePtr PC ) const

virtual

Map a location to a source.

Definition at line 239 of file InterpFrame.cpp.

References Caller, funcHasUsableBody(), getSource(), clang::interp::InterpState::getSource(), and clang::Result.

Referenced by getSource().

◆ getThis()

const Pointer & clang::interp::InterpFrame::getThis ( ) const

inline

Returns the 'this' pointer.

Definition at line 107 of file InterpFrame.h.

Referenced by dump().

◆ initScope()

void InterpFrame::initScope ( unsigned Idx )

Definition at line 93 of file InterpFrame.cpp.

References clang::interp::Function::getScope(), clang::interp::Block::invokeCtor(), and clang::interp::Scope::locals().

◆ isBottomFrame()

bool clang::interp::InterpFrame::isBottomFrame ( ) const

inline

Definition at line 131 of file InterpFrame.h.

Referenced by free(), and clang::interp::InterpState::~InterpState().

◆ isRoot()

bool clang::interp::InterpFrame::isRoot ( ) const

inline

Checks if the frame is a root frame - return should quit the interpreter.

Definition at line 113 of file InterpFrame.h.

◆ isStdFunction()

bool InterpFrame::isStdFunction ( ) const

Definition at line 274 of file InterpFrame.cpp.

References clang::interp::Function::getDecl(), and clang::DeclContext::getParent().

◆ setLocal()

template<typename T >

void clang::interp::InterpFrame::setLocal	(	unsigned	Offset,
		const T &	Value
	)

inline

Mutates a local variable.

Definition at line 82 of file InterpFrame.h.

References clang::interp::InlineDescriptor::IsInitialized.

◆ setParam()

template<typename T >

void clang::interp::InterpFrame::setParam	(	unsigned	Offset,
		const T &	Value
	)

inline

Mutates a local copy of a parameter.

Definition at line 99 of file InterpFrame.h.

References clang::interp::Pointer::deref(), getParamPointer(), and clang::T.

Member Data Documentation

◆ Caller

InterpFrame* clang::interp::InterpFrame::Caller

The frame of the previous function.

Definition at line 29 of file InterpFrame.h.

Referenced by describe(), dump(), getCaller(), getCallRange(), clang::interp::InterpState::getCurrentFrame(), getExpr(), getLocation(), getRange(), getSource(), clang::interp::interp__builtin_is_constant_evaluated(), and clang::interp::InterpState::~InterpState().

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

lib/AST/ByteCode/InterpFrame.h
lib/AST/ByteCode/Disasm.cpp
lib/AST/ByteCode/InterpFrame.cpp

Public Member Functions

Static Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ InterpFrame() [1/3]

◆ InterpFrame() [2/3]

◆ InterpFrame() [3/3]

◆ ~InterpFrame()

Member Function Documentation

◆ describe()

◆ destroy()

◆ destroyScopes()

◆ dump() [1/2]

◆ dump() [2/2]

◆ free()

◆ getCallee()

◆ getCaller()

◆ getCallRange()

◆ getDepth()

◆ getExpr()

◆ getFrameOffset()

◆ getFunction()

◆ getLocal()

◆ getLocalPointer()

◆ getLocation()

◆ getParam()

◆ getParamPointer()

◆ getPC()

◆ getRange()

◆ getRetPC()

◆ getRVOPtr()

◆ getSource()

◆ getThis()

◆ initScope()

◆ isBottomFrame()

◆ isRoot()

◆ isStdFunction()

◆ setLocal()

◆ setParam()

Member Data Documentation

◆ Caller