#include <SBFrame.h>

Public Member Functions
	SBFrame ()
	SBFrame (const lldb::SBFrame &rhs)
const lldb::SBFrame &	operator= (const lldb::SBFrame &rhs)
	~SBFrame ()
bool	IsEqual (const lldb::SBFrame &that) const
	operator bool () const
bool	IsValid () const
uint32_t	GetFrameID () const
lldb::addr_t	GetCFA () const
lldb::addr_t	GetPC () const
bool	SetPC (lldb::addr_t new_pc)
lldb::addr_t	GetSP () const
lldb::addr_t	GetFP () const
lldb::SBAddress	GetPCAddress () const
lldb::SBSymbolContext	GetSymbolContext (uint32_t resolve_scope) const
lldb::SBModule	GetModule () const
lldb::SBCompileUnit	GetCompileUnit () const
lldb::SBFunction	GetFunction () const
lldb::SBSymbol	GetSymbol () const
lldb::SBBlock	GetBlock () const
	Gets the deepest block that contains the frame PC.
const char *	GetFunctionName ()
	Get the appropriate function name for this frame.
const char *	GetDisplayFunctionName ()
const char *	GetFunctionName () const
lldb::LanguageType	GuessLanguage () const
bool	IsInlined ()
	Return true if this frame represents an inlined function.
bool	IsInlined () const
bool	IsArtificial ()
bool	IsArtificial () const
bool	IsSynthetic () const
bool	IsHidden () const
	Return whether a frame recognizer decided this frame should not be displayes in backtraces etc.
lldb::SBValue	EvaluateExpression (const char *expr)
	The version that doesn't supply a 'use_dynamic' value will use the target's default.
lldb::SBValue	EvaluateExpression (const char *expr, lldb::DynamicValueType use_dynamic)
lldb::SBValue	EvaluateExpression (const char *expr, lldb::DynamicValueType use_dynamic, bool unwind_on_error)
lldb::SBValue	EvaluateExpression (const char *expr, const SBExpressionOptions &options)
SBStructuredData	GetLanguageSpecificData () const
	Language plugins can use this API to report language-specific runtime information about this compile unit, such as additional language version details or feature flags.
lldb::SBBlock	GetFrameBlock () const
	Gets the lexical block that defines the stack frame.
lldb::SBLineEntry	GetLineEntry () const
lldb::SBThread	GetThread () const
const char *	Disassemble () const
void	Clear ()
bool	operator== (const lldb::SBFrame &rhs) const
bool	operator!= (const lldb::SBFrame &rhs) const
lldb::SBValueList	GetVariables (bool arguments, bool locals, bool statics, bool in_scope_only)
	The version that doesn't supply a 'use_dynamic' value will use the target's default.
lldb::SBValueList	GetVariables (bool arguments, bool locals, bool statics, bool in_scope_only, lldb::DynamicValueType use_dynamic)
lldb::SBValueList	GetVariables (const lldb::SBVariablesOptions &options)
lldb::SBValueList	GetRegisters ()
lldb::SBValue	FindRegister (const char *name)
lldb::SBValue	FindVariable (const char *var_name)
	The version that doesn't supply a 'use_dynamic' value will use the target's default.
lldb::SBValue	FindVariable (const char *var_name, lldb::DynamicValueType use_dynamic)
lldb::SBValue	GetValueForVariablePath (const char *var_path, DynamicValueType use_dynamic)
lldb::SBValue	GetValueForVariablePath (const char *var_path)
	The version that doesn't supply a 'use_dynamic' value will use the target's default.
lldb::SBValue	GetValueForVariablePathWithMode (const char *var_path, lldb::DILMode mode, DynamicValueType use_dynamic)
lldb::SBValue	GetValueForVariablePathWithMode (const char *var_path, lldb::DILMode mode)
lldb::SBValue	FindValue (const char *name, ValueType value_type)
	Find variables, register sets, registers, or persistent variables using the frame as the scope.
lldb::SBValue	FindValue (const char *name, ValueType value_type, lldb::DynamicValueType use_dynamic)
bool	GetDescription (lldb::SBStream &description)
SBError	GetDescriptionWithFormat (const SBFormat &format, SBStream &output)
	Similar to GetDescription() but the format of the description can be configured via the `format` parameter.

Protected Member Functions
	SBFrame (const lldb::StackFrameSP &lldb_object_sp)
lldb::StackFrameSP	GetFrameSP () const
void	SetFrameSP (const lldb::StackFrameSP &lldb_object_sp)

Static Protected Member Functions
static SBValue	CreateProcessIsRunningExprEvalError ()
	Return an SBValue containing an error message that warns the process is not currently stopped.

Protected Attributes
lldb::ExecutionContextRefSP	m_opaque_sp

Friends
class	SBBlock
class	SBExecutionContext
class	SBFrameList
class	SBInstruction
class	SBThread
class	SBValue
class	lldb_private::ScriptInterpreterBridge
class	lldb_private::python::SWIGBridge
class	lldb_private::lua::SWIGBridge

Detailed Description

Definition at line 26 of file SBFrame.h.

Constructor & Destructor Documentation

◆ SBFrame() [1/3]

SBFrame::SBFrame ( )

Definition at line 63 of file SBFrame.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_sp.

Referenced by GetFunctionName(), IsArtificial(), IsEqual(), IsInlined(), lldb_private::lua::SWIGBridge, operator!=(), operator=(), operator==(), and SBFrame().

◆ SBFrame() [2/3]

SBFrame::SBFrame ( const lldb::SBFrame & rhs )

Definition at line 72 of file SBFrame.cpp.

References lldb_private::clone(), LLDB_INSTRUMENT_VA, m_opaque_sp, and SBFrame().

◆ ~SBFrame()

◆ SBFrame() [3/3]

SBFrame::SBFrame ( const lldb::StackFrameSP & lldb_object_sp )

protected

Definition at line 67 of file SBFrame.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_sp.

Member Function Documentation

◆ Clear()

void SBFrame::Clear ( )

Definition at line 368 of file SBFrame.cpp.

References LLDB_INSTRUMENT_VA, and m_opaque_sp.

Referenced by ~SBFrame().

◆ CreateProcessIsRunningExprEvalError()

lldb::SBValue SBFrame::CreateProcessIsRunningExprEvalError ( )

staticprotected

Return an SBValue containing an error message that warns the process is not currently stopped.

Definition at line 1098 of file SBFrame.cpp.

References lldb_private::ValueObjectConstResult::Create(), error(), lldb_private::Status::FromErrorString(), SBValue, and lldb::SBValue::SetSP().

Referenced by EvaluateExpression(), EvaluateExpression(), EvaluateExpression(), EvaluateExpression(), and lldb_private::lua::SWIGBridge.

◆ Disassemble()

const char * SBFrame::Disassemble ( ) const

Definition at line 677 of file SBFrame.cpp.

References lldb_private::API, lldb_private::ConstString::GetCString(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, and m_opaque_sp.

Referenced by ~SBFrame().

◆ EvaluateExpression() [1/4]

SBValue SBFrame::EvaluateExpression ( const char * expr )

The version that doesn't supply a 'use_dynamic' value will use the target's default.

Definition at line 1021 of file SBFrame.cpp.

References lldb_private::API, lldb_private::StackFrame::CalculateTarget(), CreateProcessIsRunningExprEvalError(), EvaluateExpression(), lldb_private::StackFrame::GetLanguage(), lldb_private::TargetProperties::GetLanguage(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, lldb_private::SourceLanguage::name, SBValue, lldb::SBExpressionOptions::SetFetchDynamicValue(), lldb::SBExpressionOptions::SetIgnoreBreakpoints(), lldb::SBExpressionOptions::SetLanguage(), lldb::SBExpressionOptions::SetUnwindOnError(), and lldb_private::SourceLanguage::version.

Referenced by EvaluateExpression(), EvaluateExpression(), and EvaluateExpression().

◆ EvaluateExpression() [2/4]

lldb::SBValue SBFrame::EvaluateExpression	(	const char *	expr,
		const SBExpressionOptions &	options )

Definition at line 1108 of file SBFrame.cpp.

References lldb_private::API, CreateProcessIsRunningExprEvalError(), lldb_private::StackFrame::DumpUsingSettingsFormat(), lldb_private::Target::EvaluateExpression(), lldb_private::Expressions, lldb_private::StreamString::GetData(), lldb_private::TargetProperties::GetDisplayExpressionsInCrashlogs(), lldb::SBExpressionOptions::GetFetchDynamicValue(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, LLDB_LOGF, m_opaque_sp, lldb::SBExpressionOptions::ref(), SBValue, and lldb::SBValue::SetSP().

◆ EvaluateExpression() [3/4]

SBValue SBFrame::EvaluateExpression	(	const char *	expr,
		lldb::DynamicValueType	use_dynamic )

Definition at line 1049 of file SBFrame.cpp.

References lldb_private::API, CreateProcessIsRunningExprEvalError(), EvaluateExpression(), lldb_private::StackFrame::GetLanguage(), lldb_private::TargetProperties::GetLanguage(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, lldb_private::SourceLanguage::name, lldb::SBExpressionOptions::SetFetchDynamicValue(), lldb::SBExpressionOptions::SetIgnoreBreakpoints(), lldb::SBExpressionOptions::SetLanguage(), lldb::SBExpressionOptions::SetUnwindOnError(), and lldb_private::SourceLanguage::version.

◆ EvaluateExpression() [4/4]

SBValue SBFrame::EvaluateExpression	(	const char *	expr,
		lldb::DynamicValueType	use_dynamic,
		bool	unwind_on_error )

Definition at line 1073 of file SBFrame.cpp.

References lldb_private::API, CreateProcessIsRunningExprEvalError(), EvaluateExpression(), lldb_private::StackFrame::GetLanguage(), lldb_private::TargetProperties::GetLanguage(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, lldb_private::SourceLanguage::name, SBValue, lldb::SBExpressionOptions::SetFetchDynamicValue(), lldb::SBExpressionOptions::SetIgnoreBreakpoints(), lldb::SBExpressionOptions::SetLanguage(), lldb::SBExpressionOptions::SetUnwindOnError(), and lldb_private::SourceLanguage::version.

◆ FindRegister()

SBValue SBFrame::FindRegister ( const char * name )

Definition at line 946 of file SBFrame.cpp.

References lldb_private::API, lldb_private::ValueObjectRegister::Create(), lldb_private::GetLog(), lldb_private::StackFrame::GetRegisterContext(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, SBValue, and lldb::SBValue::SetSP().

Referenced by ~SBFrame().

◆ FindValue() [1/2]

SBValue SBFrame::FindValue	(	const char *	name,
		ValueType	value_type )

Find variables, register sets, registers, or persistent variables using the frame as the scope.

NB. This function does not look up ivars in the function object pointer. To do that use GetValueForVariablePath.

The version that doesn't supply a 'use_dynamic' value will use the target's default.

Definition at line 514 of file SBFrame.cpp.

References lldb_private::API, FindValue(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, and SBValue.

Referenced by FindValue(), and ~SBFrame().

◆ FindValue() [2/2]

SBValue SBFrame::FindValue	(	const char *	name,
		ValueType	value_type,
		lldb::DynamicValueType	use_dynamic )

Definition at line 533 of file SBFrame.cpp.

References lldb_private::API, lldb_private::Block::AppendVariables(), lldb_private::VariableList::AppendVariablesIfUnique(), lldb_private::SymbolContext::block, lldb_private::ValueObjectRegister::Create(), lldb_private::ValueObjectRegisterSet::Create(), lldb::eNoDynamicValues, lldb::eValueTypeConstResult, lldb::eValueTypeRegister, lldb::eValueTypeRegisterSet, lldb::eValueTypeVariableArgument, lldb::eValueTypeVariableGlobal, lldb::eValueTypeVariableLocal, lldb::eValueTypeVariableStatic, lldb::eValueTypeVariableThreadLocal, lldb_private::VariableList::FindVariable(), lldb_private::GetBaseValueType(), lldb_private::GetLog(), lldb_private::Target::GetPersistentVariable(), lldb_private::StackFrame::GetRegisterContext(), lldb_private::GetStoppedExecutionContext(), lldb_private::StackFrame::GetSymbolContext(), lldb_private::StackFrame::GetValueObjectForFrameVariable(), lldb_private::StackFrame::GetVariableList(), lldb_private::Variable::IsInScope(), lldb_private::IsSyntheticValueType(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, lldb_private::RegisterSet::name, SBValue, lldb::SBValue::SetSP(), and lldb_private::RegisterSet::short_name.

◆ FindVariable() [1/2]

SBValue SBFrame::FindVariable ( const char * var_name )

The version that doesn't supply a 'use_dynamic' value will use the target's default.

Definition at line 471 of file SBFrame.cpp.

References lldb_private::API, FindVariable(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, and SBValue.

Referenced by FindVariable(), and ~SBFrame().

◆ FindVariable() [2/2]

SBValue SBFrame::FindVariable	(	const char *	var_name,
		lldb::DynamicValueType	use_dynamic )

Definition at line 489 of file SBFrame.cpp.

References lldb_private::API, lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, SBValue, and lldb::SBValue::SetSP().

◆ GetBlock()

SBBlock SBFrame::GetBlock ( ) const

Gets the deepest block that contains the frame PC.

◆ GetCFA()

lldb::addr_t SBFrame::GetCFA ( ) const

Definition at line 261 of file SBFrame.cpp.

References lldb_private::API, lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_INVALID_ADDRESS, LLDB_LOG_ERROR, and m_opaque_sp.

Referenced by ~SBFrame().

◆ GetCompileUnit()

SBCompileUnit SBFrame::GetCompileUnit ( ) const

Definition at line 152 of file SBFrame.cpp.

References lldb_private::API, lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, and lldb::SBCompileUnit.

Referenced by ~SBFrame().

◆ GetDescription()

bool SBFrame::GetDescription ( lldb::SBStream & description )

Definition at line 1002 of file SBFrame.cpp.

References lldb_private::API, lldb_private::StackFrame::DumpUsingSettingsFormat(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, lldb_private::Stream::PutCString(), and lldb::SBStream::ref().

Referenced by ~SBFrame().

◆ GetDescriptionWithFormat()

SBError SBFrame::GetDescriptionWithFormat	(	const SBFormat &	format,
		SBStream &	output )

Similar to GetDescription() but the format of the description can be configured via the format parameter.

See https://lldb.llvm.org/use/formatting.html for more information on format strings.

Parameters

[in]	format	The format to use for generating the description.
[out]	output	The stream where the description will be written to.

Returns: An error object with an error message in case of failures.

Definition at line 976 of file SBFrame.cpp.

References lldb_private::StackFrame::DumpUsingFormat(), error(), lldb_private::Status::FromError(), lldb::SBFormat::GetFormatEntrySP(), lldb_private::GetStoppedExecutionContext(), m_opaque_sp, and lldb::SBStream::ref().

Referenced by ~SBFrame().

◆ GetDisplayFunctionName()

const char * SBFrame::GetDisplayFunctionName ( )

Definition at line 1295 of file SBFrame.cpp.

References lldb_private::API, lldb_private::StackFrame::GetDisplayFunctionName(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, and m_opaque_sp.

Referenced by ~SBFrame().

◆ GetFP()

addr_t SBFrame::GetFP ( ) const

Definition at line 336 of file SBFrame.cpp.

References lldb_private::API, lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_INVALID_ADDRESS, LLDB_LOG_ERROR, and m_opaque_sp.

Referenced by ~SBFrame().

◆ GetFrameBlock()

SBBlock SBFrame::GetFrameBlock ( ) const

Gets the lexical block that defines the stack frame.

Another way to think of this is it will return the block that contains all of the variables for a stack frame. Inlined functions are represented as SBBlock objects that have inlined function information: the name of the inlined function, where it was called from. The block that is returned will be the first block at or above the block for the PC (SBFrame::GetBlock()) that defines the scope of the frame. When a function contains no inlined functions, this will be the top most lexical block that defines the function. When a function has inlined functions and the PC is currently in one of those inlined functions, this method will return the inlined block that defines this frame. If the PC isn't currently in an inlined function, the lexical block that defines the function is returned.

Definition at line 213 of file SBFrame.cpp.

References lldb_private::API, lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, and SBBlock.

Referenced by ~SBFrame().

◆ GetFrameID()

uint32_t SBFrame::GetFrameID ( ) const

Definition at line 244 of file SBFrame.cpp.

References lldb_private::API, lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, and UINT32_MAX.

Referenced by ~SBFrame().

◆ GetFrameSP()

StackFrameSP SBFrame::GetFrameSP ( ) const

protected

Definition at line 88 of file SBFrame.cpp.

References m_opaque_sp.

Referenced by lldb::SBInstruction::EmulateWithFrame(), lldb::SBBlock::GetVariables(), IsEqual(), lldb_private::lua::SWIGBridge, operator bool(), lldb::SBThread::ReturnFromFrame(), lldb::SBExecutionContext::SBExecutionContext(), lldb::SBThread::StepOutOfFrame(), and lldb::SBThread::StepOverUntil().

◆ GetFunction()

SBFunction SBFrame::GetFunction ( ) const

Definition at line 168 of file SBFrame.cpp.

References lldb_private::API, lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, m_opaque_sp, and lldb::SBFunction.

Referenced by ~SBFrame().

◆ GetFunctionName() [1/2]

const char * SBFrame::GetFunctionName ( )

Get the appropriate function name for this frame.

Inlined functions in LLDB are represented by Blocks that have inlined function information, so just looking at the SBFunction or SBSymbol for a frame isn't enough. This function will return the appropriate function, symbol or inlined function name for the frame.

This function returns:

the name of the inlined function (if there is one)
the name of the concrete function (if there is one)
the name of the symbol (if there is one)
NULL

◆ GetFunctionName() [2/2]

const char * SBFrame::GetFunctionName ( ) const

Definition at line 1280 of file SBFrame.cpp.

References lldb_private::API, lldb_private::StackFrame::GetFunctionName(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, and m_opaque_sp.

◆ GetLanguageSpecificData()

SBStructuredData SBFrame::GetLanguageSpecificData ( ) const

Language plugins can use this API to report language-specific runtime information about this compile unit, such as additional language version details or feature flags.

Definition at line 1165 of file SBFrame.cpp.

References lldb_private::API, lldb_private::StackFrame::GetLanguageSpecificData(), lldb_private::GetLog(), lldb_private::GetStoppedExecutionContext(), LLDB_INSTRUMENT_VA, LLDB_LOG_ERROR, lldb::SBStructuredData::m_impl_up, and m_opaque_sp.

Referenced by ~SBFrame().