LLDB mainline
|
#include <SBValue.h>
Protected Member Functions | |
SBValue (const lldb::ValueObjectSP &value_sp) | |
lldb::ValueObjectSP | GetSP () const |
Same as the protected version of GetSP that takes a locker, except that we make the locker locally in the function. | |
lldb::ValueObjectSP | GetSP (ValueLocker &value_locker) const |
Get the appropriate ValueObjectSP from this SBValue, consulting the use_dynamic and use_synthetic options passed in to SetSP when the SBValue's contents were set. | |
void | SetSP (const lldb::ValueObjectSP &sp) |
void | SetSP (const lldb::ValueObjectSP &sp, bool use_synthetic) |
void | SetSP (const lldb::ValueObjectSP &sp, lldb::DynamicValueType use_dynamic) |
void | SetSP (const lldb::ValueObjectSP &sp, lldb::DynamicValueType use_dynamic, bool use_synthetic) |
void | SetSP (const lldb::ValueObjectSP &sp, lldb::DynamicValueType use_dynamic, bool use_synthetic, const char *name) |
Private Types | |
typedef std::shared_ptr< ValueImpl > | ValueImplSP |
Private Member Functions | |
void | SetSP (ValueImplSP impl_sp) |
Private Attributes | |
ValueImplSP | m_opaque_sp |
Friends | |
class | SBBlock |
class | SBFrame |
class | SBModule |
class | SBTarget |
class | SBThread |
class | SBTypeStaticField |
class | SBTypeSummary |
class | SBValueList |
class | lldb_private::python::SWIGBridge |
|
private |
SBValue::SBValue | ( | ) |
Definition at line 220 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA.
Referenced by EvaluateExpression().
SBValue::SBValue | ( | const lldb::SBValue & | rhs | ) |
Definition at line 228 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and SetSP().
|
default |
|
protected |
Definition at line 222 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA, and SetSP().
lldb::SBValue SBValue::AddressOf | ( | ) |
Definition at line 1284 of file SBValue.cpp.
References error(), GetPreferDynamicValue(), GetPreferSyntheticValue(), GetSP(), LLDB_INSTRUMENT_VA, and SetSP().
lldb::SBValue SBValue::Cast | ( | lldb::SBType | type | ) |
Definition at line 567 of file SBValue.cpp.
References GetPreferDynamicValue(), GetPreferSyntheticValue(), lldb::SBType::GetSP(), GetSP(), LLDB_INSTRUMENT_VA, and SetSP().
void SBValue::Clear | ( | ) |
Definition at line 259 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
lldb::SBValue SBValue::Clone | ( | const char * | new_name | ) |
Creates a copy of the SBValue with a new name and setting the current SBValue as its parent.
It should be used when we want to change the name of a SBValue without modifying the actual SBValue itself (e.g. sythetic child provider).
Definition at line 1410 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
lldb::SBValue SBValue::CreateChildAtOffset | ( | const char * | name, |
uint32_t | offset, | ||
lldb::SBType | type | ||
) |
Definition at line 548 of file SBValue.cpp.
References GetPreferDynamicValue(), GetPreferSyntheticValue(), lldb::SBType::GetSP(), GetSP(), lldb::SBType::IsValid(), LLDB_INSTRUMENT_VA, and SetSP().
lldb::SBValue SBValue::CreateValueFromAddress | ( | const char * | name, |
lldb::addr_t | address, | ||
lldb::SBType | type | ||
) |
Definition at line 609 of file SBValue.cpp.
References lldb_private::ValueObject::CreateValueObjectFromAddress(), lldb::SBType::GetSP(), GetSP(), LLDB_INSTRUMENT_VA, and SetSP().
lldb::SBValue SBValue::CreateValueFromData | ( | const char * | name, |
lldb::SBData | data, | ||
lldb::SBType | type | ||
) |
Definition at line 629 of file SBValue.cpp.
References lldb_private::ValueObject::CreateValueObjectFromData(), lldb_private::eAddressTypeLoad, lldb::SBType::GetSP(), GetSP(), LLDB_INSTRUMENT_VA, and SetSP().
lldb::SBValue SBValue::CreateValueFromExpression | ( | const char * | name, |
const char * | expression | ||
) |
Definition at line 580 of file SBValue.cpp.
References CreateValueFromExpression(), LLDB_INSTRUMENT_VA, lldb::SBExpressionOptions::ref(), and lldb_private::EvaluateExpressionOptions::SetKeepInMemory().
Referenced by CreateValueFromExpression().
lldb::SBValue SBValue::CreateValueFromExpression | ( | const char * | name, |
const char * | expression, | ||
SBExpressionOptions & | options | ||
) |
Definition at line 589 of file SBValue.cpp.
References lldb_private::ValueObject::CreateValueObjectFromExpression(), GetSP(), LLDB_INSTRUMENT_VA, lldb::SBExpressionOptions::ref(), and SetSP().
SBValue SBValue::Dereference | ( | ) |
Definition at line 992 of file SBValue.cpp.
References Dereference(), error(), GetSP(), and LLDB_INSTRUMENT_VA.
Referenced by Dereference(), and WatchPointee().
lldb::SBValue SBValue::EvaluateExpression | ( | const char * | expr | ) | const |
Definition at line 1174 of file SBValue.cpp.
References EvaluateExpression(), GetSP(), LLDB_INSTRUMENT_VA, SBValue(), lldb::SBExpressionOptions::SetFetchDynamicValue(), lldb::SBExpressionOptions::SetIgnoreBreakpoints(), and lldb::SBExpressionOptions::SetUnwindOnError().
Referenced by EvaluateExpression().
lldb::SBValue SBValue::EvaluateExpression | ( | const char * | expr, |
const SBExpressionOptions & | options | ||
) | const |
Definition at line 1195 of file SBValue.cpp.
References EvaluateExpression(), and LLDB_INSTRUMENT_VA.
lldb::SBValue SBValue::EvaluateExpression | ( | const char * | expr, |
const SBExpressionOptions & | options, | ||
const char * | name | ||
) | const |
Definition at line 1202 of file SBValue.cpp.
References lldb::SBExpressionOptions::GetFetchDynamicValue(), lldb_private::ExecutionContext::GetFramePtr(), GetSP(), LLDB_INSTRUMENT_VA, lldb::SBExpressionOptions::ref(), SBValue(), and SetSP().
lldb::SBAddress SBValue::GetAddress | ( | ) |
Definition at line 1311 of file SBValue.cpp.
References lldb_private::eAddressTypeFile, lldb_private::eAddressTypeLoad, GetSP(), LLDB_INSTRUMENT_VA, LLDB_INVALID_ADDRESS, and lldb_private::Address::SetLoadAddress().
size_t SBValue::GetByteSize | ( | ) |
Definition at line 324 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
Referenced by Watch().
SBValue SBValue::GetChildAtIndex | ( | uint32_t | idx | ) |
Definition at line 648 of file SBValue.cpp.
References lldb::eNoDynamicValues, GetChildAtIndex(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by GetChildAtIndex().
SBValue SBValue::GetChildAtIndex | ( | uint32_t | idx, |
lldb::DynamicValueType | use_dynamic, | ||
bool | can_create_synthetic | ||
) |
Get a child value by index from a value.
Structs, unions, classes, arrays and pointers have child values that can be access by index.
Structs and unions access child members using a zero based index for each child member. For
Classes reserve the first indexes for base classes that have members (empty base classes are omitted), and all members of the current class will then follow the base classes.
Pointers differ depending on what they point to. If the pointer points to a simple type, the child at index zero is the only child value available, unless synthetic_allowed is true, in which case the pointer will be used as an array and can create 'synthetic' child values using positive or negative indexes. If the pointer points to an aggregate type (an array, class, union, struct), then the pointee is transparently skipped and any children are going to be the indexes of the child values within the aggregate type. For example if we have a 'Point' type and we have a SBValue that contains a pointer to a 'Point' type, then the child at index zero will be the 'x' member, and the child at index 1 will be the 'y' member (the child at index zero won't be a 'Point' instance).
If you actually need an SBValue that represents the type pointed to by a SBValue for which GetType().IsPointeeType() returns true, regardless of the pointee type, you can do that with SBValue::Dereference.
Arrays have a preset number of children that can be accessed by index and will returns invalid child values for indexes that are out of bounds unless the synthetic_allowed is true. In this case the array can create 'synthetic' child values for indexes that aren't in the array bounds using positive or negative indexes.
[in] | idx | The index of the child value to get |
[in] | use_dynamic | An enumeration that specifies whether to get dynamic values, and also if the target can be run to figure out the dynamic type of the child value. |
[in] | can_create_synthetic | If true, then allow child values to be created by index for pointers and arrays for indexes that normally wouldn't be allowed. |
Definition at line 663 of file SBValue.cpp.
References GetPreferSyntheticValue(), GetSP(), LLDB_INSTRUMENT_VA, and SetSP().
SBValue SBValue::GetChildMemberWithName | ( | const char * | name | ) |
Definition at line 698 of file SBValue.cpp.
References lldb::eNoDynamicValues, GetChildMemberWithName(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by GetChildMemberWithName().
SBValue SBValue::GetChildMemberWithName | ( | const char * | name, |
lldb::DynamicValueType | use_dynamic | ||
) |
Definition at line 712 of file SBValue.cpp.
References GetPreferSyntheticValue(), GetSP(), LLDB_INSTRUMENT_VA, and SetSP().
lldb::SBData SBValue::GetData | ( | ) |
Get an SBData wrapping the contents of this SBValue.
This method will read the contents of this object in memory and copy them into an SBData for future use.
Definition at line 1359 of file SBValue.cpp.
References error(), GetSP(), and LLDB_INSTRUMENT_VA.
lldb::SBDeclaration SBValue::GetDeclaration | ( | ) |
Definition at line 1422 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBDeclaration::SetDeclaration().
bool SBValue::GetDescription | ( | lldb::SBStream & | description | ) |
Definition at line 1243 of file SBValue.cpp.
References error(), GetSP(), LLDB_INSTRUMENT_VA, m_opaque_sp, lldb_private::Stream::PutCString(), lldb::SBStream::ref(), lldb_private::DumpValueObjectOptions::SetUseDynamicType(), lldb_private::DumpValueObjectOptions::SetUseSyntheticValue(), and lldb_private::toString().
const char * SBValue::GetDisplayTypeName | ( | ) |
Definition at line 313 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
lldb::SBValue SBValue::GetDynamicValue | ( | lldb::DynamicValueType | use_dynamic | ) |
Definition at line 730 of file SBValue.cpp.
References IsValid(), LLDB_INSTRUMENT_VA, m_opaque_sp, and SetSP().
SBError SBValue::GetError | ( | ) |
Definition at line 265 of file SBValue.cpp.
References lldb_private::Status::AsCString(), ValueLocker::GetError(), GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBError::SetError().
Referenced by lldb::SBFrame::EvaluateExpression().
bool SBValue::GetExpressionPath | ( | lldb::SBStream & | description | ) |
Definition at line 1149 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBStream::ref().
bool SBValue::GetExpressionPath | ( | lldb::SBStream & | description, |
bool | qualify_cxx_base_classes | ||
) |
Definition at line 1161 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBStream::ref().
lldb::Format SBValue::GetFormat | ( | ) |
Definition at line 1265 of file SBValue.cpp.
References lldb::eFormatDefault, GetSP(), and LLDB_INSTRUMENT_VA.
lldb::SBFrame SBValue::GetFrame | ( | ) |
Definition at line 1062 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and lldb::SBFrame::SetFrameSP().
user_id_t SBValue::GetID | ( | ) |
Definition at line 281 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and LLDB_INVALID_UID.
uint32_t SBValue::GetIndexOfChildWithName | ( | const char * | name | ) |
Definition at line 686 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and UINT32_MAX.
lldb::addr_t SBValue::GetLoadAddress | ( | ) |
Definition at line 1299 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and LLDB_INVALID_ADDRESS.
Referenced by Watch().
const char * SBValue::GetLocation | ( | ) |
Definition at line 442 of file SBValue.cpp.
References lldb_private::ConstString::GetCString(), GetSP(), and LLDB_INSTRUMENT_VA.
const char * SBValue::GetName | ( | ) |
Definition at line 291 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
lldb::SBValue SBValue::GetNonSyntheticValue | ( | ) |
Definition at line 755 of file SBValue.cpp.
References IsValid(), LLDB_INSTRUMENT_VA, m_opaque_sp, and SetSP().
uint32_t SBValue::GetNumChildren | ( | ) |
Return the number of children of this variable.
Note that for some variables this operation can be expensive. If possible, prefer calling GetNumChildren(max) with the maximum number of children you are interested in.
Definition at line 973 of file SBValue.cpp.
References GetNumChildren(), LLDB_INSTRUMENT_VA, and UINT32_MAX.
Referenced by GetNumChildren().
uint32_t SBValue::GetNumChildren | ( | uint32_t | max | ) |
Return the numer of children of this variable, with a hint that the caller is interested in at most max children.
Use this function to avoid expensive child computations in some cases. For example, if you know you will only ever display 100 elements, calling GetNumChildren(100) can avoid enumerating all the other children. If the returned value is smaller than max, then it represents the true number of children, otherwise it indicates that their number is at least max. Do not assume the returned number will always be less than or equal to max, as the implementation may choose to return a larger (but still smaller than the actual number of children) value.
Definition at line 979 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
const char * SBValue::GetObjectDescription | ( | ) |
Definition at line 374 of file SBValue.cpp.
References lldb_private::ConstString::AsCString(), GetSP(), LLDB_INSTRUMENT_VA, and lldb_private::toString().
void * SBValue::GetOpaqueType | ( | ) |
Definition at line 1013 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
lldb::SBData SBValue::GetPointeeData | ( | uint32_t | item_idx = 0 , |
uint32_t | item_count = 1 |
||
) |
Get an SBData wrapping what this SBValue points to.
This method will dereference the current SBValue, if its data type is a T* or T[], and extract item_count elements of type T from it, copying their contents in an SBData.
[in] | item_idx | The index of the first item to retrieve. For an array this is equivalent to array[item_idx], for a pointer to *(pointer + item_idx). In either case, the measurement unit for item_idx is the sizeof(T) rather than the byte |
[in] | item_count | How many items should be copied into the output. By default only one item is copied, but more can be asked for. |
Definition at line 1340 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
lldb::DynamicValueType SBValue::GetPreferDynamicValue | ( | ) |
Definition at line 782 of file SBValue.cpp.
References lldb::eNoDynamicValues, IsValid(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by AddressOf(), Cast(), CreateChildAtOffset(), and GetValueForExpressionPath().
bool SBValue::GetPreferSyntheticValue | ( | ) |
Definition at line 797 of file SBValue.cpp.
References IsValid(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by AddressOf(), Cast(), CreateChildAtOffset(), GetChildAtIndex(), GetChildMemberWithName(), and GetValueForExpressionPath().
lldb::SBProcess SBValue::GetProcess | ( | ) |
Definition at line 1036 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and lldb::SBProcess::SetSP().
|
protected |
Same as the protected version of GetSP that takes a locker, except that we make the locker locally in the function.
Since the Target API mutex is recursive, and the StopLocker is a read lock, you can call this function even if you are already holding the two above-mentioned locks.
Definition at line 1088 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
Referenced by AddressOf(), Cast(), Clone(), CreateChildAtOffset(), CreateValueFromAddress(), CreateValueFromData(), CreateValueFromExpression(), Dereference(), lldb::SBTypeSummary::DoesPrintValue(), EvaluateExpression(), GetAddress(), GetByteSize(), GetChildAtIndex(), GetChildMemberWithName(), GetData(), GetDeclaration(), GetDescription(), GetDisplayTypeName(), GetError(), GetExpressionPath(), GetFormat(), GetID(), GetIndexOfChildWithName(), GetLoadAddress(), GetLocation(), GetName(), GetNumChildren(), GetObjectDescription(), GetOpaqueType(), GetPointeeData(), GetSP(), GetSummary(), GetType(), GetTypeFilter(), GetTypeFormat(), GetTypeName(), GetTypeSummary(), GetTypeSynthetic(), GetValue(), GetValueAsAddress(), GetValueAsSigned(), GetValueAsUnsigned(), GetValueDidChange(), GetValueForExpressionPath(), GetValueType(), GetVTable(), IsDynamic(), IsInScope(), IsRuntimeSupportValue(), IsSynthetic(), IsSyntheticChildrenGenerated(), MightHaveChildren(), Persist(), lldb::SBThread::ReturnFromFrame(), SetData(), SetFormat(), SetSyntheticChildrenGenerated(), and Watch().
|
protected |
Get the appropriate ValueObjectSP from this SBValue, consulting the use_dynamic and use_synthetic options passed in to SetSP when the SBValue's contents were set.
Since this often requires examining memory, and maybe even running code, it needs to acquire the Target API and Process StopLock. Those are held in an opaque class ValueLocker which is currently local to SBValue.cpp. So you don't have to get these yourself just default construct a ValueLocker, and pass it into this. If we need to make a ValueLocker and use it in some other .cpp file, we'll have to move it to ValueObject.h/cpp or somewhere else convenient. We haven't needed to so far.
[in] | value_locker | An object that will hold the Target API, and Process RunLocks, and auto-destroy them when it goes out of scope. Currently this is only useful in SBValue.cpp. |
Definition at line 1075 of file SBValue.cpp.
References ValueLocker::GetError(), ValueLocker::GetLockedSP(), m_opaque_sp, and lldb_private::Status::SetErrorString().
lldb::SBValue SBValue::GetStaticValue | ( | ) |
Definition at line 742 of file SBValue.cpp.
References lldb::eNoDynamicValues, IsValid(), LLDB_INSTRUMENT_VA, m_opaque_sp, and SetSP().
const char * SBValue::GetSummary | ( | ) |
Definition at line 417 of file SBValue.cpp.
References lldb_private::ConstString::GetCString(), GetSP(), and LLDB_INSTRUMENT_VA.
Referenced by lldb::SBFrame::EvaluateExpression(), and lldb::SBTarget::EvaluateExpression().
const char * SBValue::GetSummary | ( | lldb::SBStream & | stream, |
lldb::SBTypeSummaryOptions & | options | ||
) |
Definition at line 428 of file SBValue.cpp.
References lldb_private::ConstString::GetCString(), lldb::SBStream::GetData(), GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBTypeSummaryOptions::ref().
lldb::SBValue SBValue::GetSyntheticValue | ( | ) |
Definition at line 767 of file SBValue.cpp.
References IsSynthetic(), IsValid(), LLDB_INSTRUMENT_VA, m_opaque_sp, and SetSP().
lldb::SBTarget SBValue::GetTarget | ( | ) |
Definition at line 1023 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and lldb::SBTarget::SetSP().
Referenced by Watch().
lldb::SBThread SBValue::GetThread | ( | ) |
Definition at line 1049 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and lldb::SBThread::SetThread().
SBType SBValue::GetType | ( | ) |
Definition at line 388 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBType::SetSP().
Referenced by WatchPointee().
lldb::SBTypeFilter SBValue::GetTypeFilter | ( | ) |
Definition at line 508 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBTypeFilter::SetSP().
lldb::SBTypeFormat SBValue::GetTypeFormat | ( | ) |
Definition at line 476 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBTypeFormat::SetSP().
const char * SBValue::GetTypeName | ( | ) |
Definition at line 302 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
lldb::SBTypeSummary SBValue::GetTypeSummary | ( | ) |
Definition at line 492 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBTypeSummary::SetSP().
lldb::SBTypeSynthetic SBValue::GetTypeSynthetic | ( | ) |
Definition at line 528 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and lldb::SBTypeSynthetic::SetSP().
const char * SBValue::GetValue | ( | ) |
Definition at line 352 of file SBValue.cpp.
References lldb_private::ConstString::GetCString(), GetSP(), and LLDB_INSTRUMENT_VA.
Referenced by lldb::SBFrame::EvaluateExpression(), and lldb::SBTarget::EvaluateExpression().
lldb::addr_t SBValue::GetValueAsAddress | ( | ) |
Definition at line 930 of file SBValue.cpp.
References GetSP(), LLDB_INVALID_ADDRESS, and m_opaque_sp.
int64_t SBValue::GetValueAsSigned | ( | int64_t | fail_value = 0 | ) |
Definition at line 908 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
int64_t SBValue::GetValueAsSigned | ( | lldb::SBError & | error, |
int64_t | fail_value = 0 |
||
) |
Definition at line 868 of file SBValue.cpp.
References lldb_private::Status::AsCString(), error(), ValueLocker::GetError(), GetSP(), and LLDB_INSTRUMENT_VA.
uint64_t SBValue::GetValueAsUnsigned | ( | lldb::SBError & | error, |
uint64_t | fail_value = 0 |
||
) |
Definition at line 888 of file SBValue.cpp.
References lldb_private::Status::AsCString(), error(), ValueLocker::GetError(), GetSP(), and LLDB_INSTRUMENT_VA.
uint64_t SBValue::GetValueAsUnsigned | ( | uint64_t | fail_value = 0 | ) |
Definition at line 919 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
bool SBValue::GetValueDidChange | ( | ) |
Definition at line 403 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
lldb::SBValue SBValue::GetValueForExpressionPath | ( | const char * | expr_path | ) |
Definition at line 851 of file SBValue.cpp.
References GetPreferDynamicValue(), GetPreferSyntheticValue(), GetSP(), LLDB_INSTRUMENT_VA, and SetSP().
ValueType SBValue::GetValueType | ( | ) |
Definition at line 362 of file SBValue.cpp.
References lldb::eValueTypeInvalid, GetSP(), and LLDB_INSTRUMENT_VA.
lldb::SBValue SBValue::GetVTable | ( | ) |
If this value represents a C++ class that has a vtable, return an value that represents the virtual function table.
SBValue::GetError() will be in the success state if this value represents a C++ class with a vtable, or an appropriate error describing that the object isn't a C++ class with a vtable or not a C++ class.
SBValue::GetName() will be the demangled symbol name for the virtual function table like "vtable for <classname>".
SBValue::GetValue() will be the address of the first vtable entry if the current SBValue is a class with a vtable, or nothing the current SBValue is not a C++ class or not a C++ class that has a vtable.
SBValue::GetValueAtUnsigned(...) will return the address of the first vtable entry.
SBValue::GetLoadAddress() will return the address of the vtable pointer found in the parent SBValue.
SBValue::GetNumChildren() will return the number of virtual function pointers in the vtable, or zero on error.
SBValue::GetChildAtIndex(...) will return each virtual function pointer as a SBValue object.
The child SBValue objects will have the following values:
SBValue::GetError() will indicate success if the vtable entry was successfully read from memory, or an error if not.
SBValue::GetName() will be the vtable function index in the form "[%u]" where u is the index.
SBValue::GetValue() will be the virtual function pointer value as a string.
SBValue::GetValueAtUnsigned(...) will return the virtual function pointer value.
SBValue::GetLoadAddress() will return the address of the virtual function pointer.
SBValue::GetNumChildren() returns 0
Definition at line 1536 of file SBValue.cpp.
bool SBValue::IsDynamic | ( | ) |
Definition at line 812 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
bool SBValue::IsInScope | ( | ) |
Definition at line 338 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
Referenced by Watch(), and WatchPointee().
bool SBValue::IsRuntimeSupportValue | ( | ) |
Definition at line 961 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
bool SBValue::IsSynthetic | ( | ) |
Definition at line 822 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
Referenced by GetSyntheticValue().
bool SBValue::IsSyntheticChildrenGenerated | ( | ) |
Definition at line 832 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
bool SBValue::IsValid | ( | ) |
Definition at line 245 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA.
Referenced by GetDynamicValue(), GetNonSyntheticValue(), GetPreferDynamicValue(), GetPreferSyntheticValue(), GetStaticValue(), GetSyntheticValue(), SetPreferDynamicValue(), and SetPreferSyntheticValue().
lldb::SBValue::LLDB_DEPRECATED | ( | "Use GetType().IsPointerType() instead" | ) |
lldb::SBValue::LLDB_DEPRECATED_FIXME | ( | "Use the variant that takes an SBError &" | , |
"SetValueFromCString(const char *, SBError &)" | |||
) | const |
bool SBValue::MightHaveChildren | ( | ) |
Find out if a SBValue might have children.
This call is much more efficient than GetNumChildren() as it doesn't need to complete the underlying type. This is designed to be used in a UI environment in order to detect if the disclosure triangle should be displayed or not.
This function returns true for class, union, structure, pointers, references, arrays and more. Again, it does so without doing any expensive type completion.
Definition at line 949 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
|
explicit |
Definition at line 249 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA.
SBValue & SBValue::operator= | ( | const lldb::SBValue & | rhs | ) |
Definition at line 234 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and SetSP().
lldb::SBValue SBValue::Persist | ( | ) |
Definition at line 1524 of file SBValue.cpp.
References GetSP(), LLDB_INSTRUMENT_VA, and SetSP().
bool SBValue::SetData | ( | lldb::SBData & | data, |
lldb::SBError & | error | ||
) |
Definition at line 1376 of file SBValue.cpp.
References lldb_private::Status::AsCString(), error(), lldb::SBData::get(), ValueLocker::GetError(), GetSP(), LLDB_INSTRUMENT_VA, and lldb_private::Status::Success().
void SBValue::SetFormat | ( | lldb::Format | format | ) |
Definition at line 1275 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
void SBValue::SetPreferDynamicValue | ( | lldb::DynamicValueType | use_dynamic | ) |
Definition at line 790 of file SBValue.cpp.
References IsValid(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
void SBValue::SetPreferSyntheticValue | ( | bool | use_synthetic | ) |
Definition at line 805 of file SBValue.cpp.
References IsValid(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
|
protected |
Definition at line 1097 of file SBValue.cpp.
References lldb::eNoDynamicValues, m_opaque_sp, and sp.
Referenced by AddressOf(), Cast(), CreateChildAtOffset(), CreateValueFromAddress(), lldb::SBTarget::CreateValueFromAddress(), lldb::SBTarget::CreateValueFromData(), CreateValueFromData(), lldb::SBTarget::CreateValueFromExpression(), CreateValueFromExpression(), lldb::SBFrame::EvaluateExpression(), lldb::SBTarget::EvaluateExpression(), EvaluateExpression(), lldb::SBFrame::FindRegister(), lldb::SBFrame::FindValue(), lldb::SBFrame::FindVariable(), GetChildAtIndex(), GetChildMemberWithName(), GetDynamicValue(), GetNonSyntheticValue(), GetStaticValue(), GetSyntheticValue(), GetValueForExpressionPath(), lldb::SBFrame::GetValueForVariablePath(), lldb::SBFrame::GetVariables(), lldb::SBBlock::GetVariables(), GetVTable(), operator=(), Persist(), SBValue(), and SetSP().
|
protected |
Definition at line 1125 of file SBValue.cpp.
References lldb::eNoDynamicValues, SetSP(), and sp.
|
protected |
Definition at line 1111 of file SBValue.cpp.
|
protected |
Definition at line 1137 of file SBValue.cpp.
References m_opaque_sp, and sp.
|
protected |
Definition at line 1142 of file SBValue.cpp.
References m_opaque_sp, and sp.
|
private |
Definition at line 1095 of file SBValue.cpp.
References m_opaque_sp.
void SBValue::SetSyntheticChildrenGenerated | ( | bool | is | ) |
Definition at line 842 of file SBValue.cpp.
References GetSP(), and LLDB_INSTRUMENT_VA.
bool SBValue::SetValueFromCString | ( | const char * | value_str, |
lldb::SBError & | error | ||
) |
Definition at line 454 of file SBValue.cpp.
References LLDB_INSTRUMENT_VA, and SetValueFromCString().
Referenced by SetValueFromCString().
lldb::SBWatchpoint SBValue::Watch | ( | bool | resolve_location, |
bool | read, | ||
bool | write | ||
) |
Definition at line 1506 of file SBValue.cpp.
References error(), LLDB_INSTRUMENT_VA, and Watch().
lldb::SBWatchpoint SBValue::Watch | ( | bool | resolve_location, |
bool | read, | ||
bool | write, | ||
SBError & | error | ||
) |
Watch this value if it resides in memory.
Sets a watchpoint on the value.
[in] | resolve_location | Resolve the location of this value once and watch its address. This value must currently be set to true as watching all locations of a variable or a variable path is not yet supported, though we plan to support it in the future. |
[in] | read | Stop when this value is accessed. |
[in] | write | Stop when this value is modified |
[out] | error | An error object. Contains the reason if there is some failure. |
Definition at line 1436 of file SBValue.cpp.
References lldb_private::Status::AsCString(), lldb_private::Declaration::DumpStopContext(), error(), GetByteSize(), ValueLocker::GetError(), lldb_private::Declaration::GetFile(), GetLoadAddress(), GetSP(), lldb_private::StreamString::GetString(), GetTarget(), IsInScope(), LLDB_INSTRUMENT_VA, LLDB_INVALID_ADDRESS, LLDB_WATCH_TYPE_MODIFY, LLDB_WATCH_TYPE_READ, LLDB_WATCH_TYPE_WRITE, and lldb::SBWatchpoint::SetSP().
Referenced by Watch(), and WatchPointee().
lldb::SBWatchpoint SBValue::WatchPointee | ( | bool | resolve_location, |
bool | read, | ||
bool | write, | ||
SBError & | error | ||
) |
Watch this value that this value points to in memory.
Sets a watchpoint on the value.
[in] | resolve_location | Resolve the location of this value once and watch its address. This value must currently be set to true as watching all locations of a variable or a variable path is not yet supported, though we plan to support it in the future. |
[in] | read | Stop when this value is accessed. |
[in] | write | Stop when this value is modified |
[out] | error | An error object. Contains the reason if there is some failure. |
Definition at line 1514 of file SBValue.cpp.
References Dereference(), error(), GetType(), IsInScope(), LLDB_INSTRUMENT_VA, and Watch().
|
friend |
|
friend |
|
friend |
|
private |
Definition at line 509 of file SBValue.h.
Referenced by Clear(), GetChildAtIndex(), GetChildMemberWithName(), GetDescription(), GetDynamicValue(), GetFrame(), GetNonSyntheticValue(), GetPreferDynamicValue(), GetPreferSyntheticValue(), GetProcess(), GetSP(), GetStaticValue(), GetSyntheticValue(), GetTarget(), GetThread(), GetValueAsAddress(), operator=(), SBValue(), SetPreferDynamicValue(), SetPreferSyntheticValue(), and SetSP().