clang 18.0.0git
|
A pointer to a memory block, live or dead. More...
#include "/home/buildbot/as-worker-4/publish-doxygen-docs/llvm-project/clang/lib/AST/Interp/Pointer.h"
Public Member Functions | |
Pointer () | |
Pointer (Block *B) | |
Pointer (Block *B, unsigned BaseAndOffset) | |
Pointer (const Pointer &P) | |
Pointer (Pointer &&P) | |
~Pointer () | |
void | operator= (const Pointer &P) |
void | operator= (Pointer &&P) |
APValue | toAPValue () const |
Converts the pointer to an APValue. | |
std::string | toDiagnosticString (const ASTContext &Ctx) const |
Converts the pointer to a string usable in diagnostics. | |
unsigned | getIntegerRepresentation () const |
APValue | toRValue (const Context &Ctx) const |
Converts the pointer to an APValue that is an rvalue. | |
Pointer | atIndex (unsigned Idx) const |
Offsets a pointer inside an array. | |
Pointer | atField (unsigned Off) const |
Creates a pointer to a field. | |
Pointer | atFieldSub (unsigned Off) const |
Subtract the given offset from the current Base and Offset of the pointer. | |
Pointer | narrow () const |
Restricts the scope of an array element pointer. | |
Pointer | expand () const |
Expands a pointer to the containing array, undoing narrowing. | |
bool | isZero () const |
Checks if the pointer is null. | |
bool | isLive () const |
Checks if the pointer is live. | |
bool | isField () const |
Checks if the item is a field in an object. | |
Descriptor * | getDeclDesc () const |
Accessor for information about the declaration site. | |
SourceLocation | getDeclLoc () const |
Pointer | getBase () const |
Returns a pointer to the object of which this pointer is a field. | |
Pointer | getArray () const |
Returns the parent array. | |
Descriptor * | getFieldDesc () const |
Accessors for information about the innermost field. | |
QualType | getType () const |
Returns the type of the innermost field. | |
Pointer | getDeclPtr () const |
size_t | elemSize () const |
Returns the element size of the innermost field. | |
size_t | getSize () const |
Returns the total size of the innermost field. | |
unsigned | getOffset () const |
Returns the offset into an array. | |
bool | isArrayRoot () const |
Whether this array refers to an array, but not to the first element. | |
bool | inArray () const |
Checks if the innermost field is an array. | |
bool | inPrimitiveArray () const |
Checks if the structure is a primitive array. | |
bool | isUnknownSizeArray () const |
Checks if the structure is an array of unknown size. | |
bool | isArrayElement () const |
Checks if the pointer points to an array. | |
bool | isRoot () const |
Pointer points directly to a block. | |
const Record * | getRecord () const |
Returns the record descriptor of a class. | |
const Record * | getElemRecord () const |
Returns the element record type, if this is a non-primive array. | |
const FieldDecl * | getField () const |
Returns the field information. | |
bool | isUnion () const |
Checks if the object is a union. | |
bool | isExtern () const |
Checks if the storage is extern. | |
bool | isStatic () const |
Checks if the storage is static. | |
bool | isTemporary () const |
Checks if the storage is temporary. | |
bool | isStaticTemporary () const |
Checks if the storage is a static temporary. | |
bool | isMutable () const |
Checks if the field is mutable. | |
bool | isInitialized () const |
Checks if an object was initialized. | |
bool | isActive () const |
Checks if the object is active. | |
bool | isBaseClass () const |
Checks if a structure is a base class. | |
bool | isConst () const |
Checks if an object or a subfield is mutable. | |
std::optional< unsigned > | getDeclID () const |
Returns the declaration ID. | |
unsigned | getByteOffset () const |
Returns the byte offset from the start. | |
unsigned | getNumElems () const |
Returns the number of elements. | |
const Block * | block () const |
int64_t | getIndex () const |
Returns the index into an array. | |
bool | isOnePastEnd () const |
Checks if the index is one past end. | |
bool | isElementPastEnd () const |
Checks if the pointer is an out-of-bounds element pointer. | |
template<typename T > | |
T & | deref () const |
Dereferences the pointer, if it's live. | |
template<typename T > | |
T & | elem (unsigned I) const |
Dereferences a primitive element. | |
void | initialize () const |
Initializes a field. | |
void | activate () const |
Activats a field. | |
void | deactivate () const |
Deactivates an entire strurcutre. | |
ComparisonCategoryResult | compare (const Pointer &Other) const |
Compare two pointers. | |
void | print (llvm::raw_ostream &OS) const |
Prints the pointer. | |
Static Public Member Functions | |
static bool | hasSameBase (const Pointer &A, const Pointer &B) |
Checks if two pointers are comparable. | |
static bool | hasSameArray (const Pointer &A, const Pointer &B) |
Checks if two pointers can be subtracted. | |
Friends | |
class | Block |
class | DeadBlock |
A pointer to a memory block, live or dead.
This object can be allocated into interpreter stack frames. If pointing to a live block, it is a link in the chain of pointers pointing to the block.
In the simplest form, a Pointer has a Block* (the pointee) and both Base and Offset are 0, which means it will point to raw data.
The Base field is used to access metadata about the data. For primitive arrays, the Base is followed by an InitMap. In a variety of cases, the Base is preceded by an InlineDescriptor, which is used to track the initialization state, among other things.
The Offset field is used to access the actual data. In other words, the data the pointer decribes can be found at Pointee->rawData() + Pointer.Offset.
Pointee Offset │ │ │ │ ▼ ▼ ┌───────┬────────────┬─────────┬────────────────────────────┐ │ Block │ InlineDesc │ InitMap │ Actual Data │ └───────┴────────────┴─────────┴────────────────────────────┘ ▲ │ │ Base
|
inline |
Definition at line 71 of file Pointer.h.
Referenced by atField(), atFieldSub(), atIndex(), expand(), getArray(), getBase(), getDeclPtr(), and narrow().
Pointer::Pointer | ( | Block * | B | ) |
Definition at line 22 of file Pointer.cpp.
Definition at line 24 of file Pointer.cpp.
Pointer::Pointer | ( | const Pointer & | P | ) |
Definition at line 27 of file Pointer.cpp.
Pointer::Pointer | ( | Pointer && | P | ) |
Definition at line 29 of file Pointer.cpp.
References P, and clang::interp::Block::replacePointer().
Pointer::~Pointer | ( | ) |
Definition at line 42 of file Pointer.cpp.
References clang::interp::Block::cleanup(), and clang::interp::Block::removePointer().
void Pointer::activate | ( | ) | const |
Activats a field.
Definition at line 208 of file Pointer.cpp.
References clang::interp::InlineDescriptor::IsActive.
Creates a pointer to a field.
Definition at line 107 of file Pointer.h.
References Pointer().
Referenced by clang::interp::CheckFieldsInitialized(), clang::interp::GetField(), clang::interp::GetFieldPop(), clang::interp::GetPtrActiveField(), clang::interp::GetPtrBase(), clang::interp::GetPtrBasePop(), clang::interp::GetPtrField(), clang::interp::SetThreeWayComparisonField(), and toRValue().
Subtract the given offset from the current Base and Offset of the pointer.
Definition at line 114 of file Pointer.h.
References Pointer().
Referenced by clang::interp::GetPtrDerivedPop().
Offsets a pointer inside an array.
Definition at line 95 of file Pointer.h.
References elemSize(), getDeclDesc(), getFieldDesc(), getSize(), and Pointer().
Referenced by clang::interp::CheckArrayInitialized(), clang::interp::CmpHelperEQ< Pointer >(), clang::interp::Program::createGlobalString(), clang::interp::interp__builtin_nan(), clang::interp::interp__builtin_strcmp(), clang::interp::interp__builtin_strlen(), and clang::interp::OffsetHelper().
|
inline |
Definition at line 323 of file Pointer.h.
Referenced by clang::interp::CheckConst().
|
inline |
Compare two pointers.
Definition at line 366 of file Pointer.h.
References clang::Equal, clang::Greater, hasSameBase(), clang::Less, and clang::Unordered.
Referenced by clang::interp::CMP3().
void Pointer::deactivate | ( | ) | const |
Deactivates an entire strurcutre.
Definition at line 214 of file Pointer.cpp.
Referenced by clang::interp::GetPtrActiveField().
|
inline |
Dereferences the pointer, if it's live.
Definition at line 343 of file Pointer.h.
References isArrayRoot(), isLive(), and clang::interp::Block::rawData().
Referenced by clang::interp::GetLocal(), clang::interp::InterpFrame::getParam(), clang::interp::IncDecFloatHelper(), clang::interp::IncDecHelper(), clang::interp::IncDecPtrHelper(), clang::interp::interp__builtin_nan(), clang::interp::interp__builtin_strcmp(), clang::interp::interp__builtin_strlen(), clang::interp::Load(), clang::interp::LoadPop(), clang::interp::InterpFrame::setParam(), and clang::interp::SetThreeWayComparisonField().
|
inline |
Dereferences a primitive element.
Definition at line 353 of file Pointer.h.
References clang::interp::Block::data(), and getNumElems().
|
inline |
Returns the element size of the innermost field.
Definition at line 232 of file Pointer.h.
References getDeclDesc(), clang::interp::Descriptor::getElemSize(), getFieldDesc(), and clang::interp::Descriptor::getSize().
Referenced by atIndex(), getIndex(), and getNumElems().
|
inline |
Expands a pointer to the containing array, undoing narrowing.
Definition at line 157 of file Pointer.h.
References clang::interp::InlineDescriptor::Desc, getDeclDesc(), getSize(), inPrimitiveArray(), clang::interp::Descriptor::IsArray, isElementPastEnd(), clang::interp::InlineDescriptor::Offset, and Pointer().
Referenced by clang::interp::ExpandPtr().
|
inline |
Returns the parent array.
Definition at line 206 of file Pointer.h.
References Pointer().
Referenced by toAPValue().
|
inline |
Returns a pointer to the object of which this pointer is a field.
Definition at line 196 of file Pointer.h.
References clang::interp::InlineDescriptor::Offset, and Pointer().
Referenced by CheckActive(), and toAPValue().
|
inline |
Returns the byte offset from the start.
Definition at line 316 of file Pointer.h.
Referenced by clang::interp::CmpHelper< Pointer >(), and clang::interp::CmpHelperEQ< Pointer >().
|
inline |
Accessor for information about the declaration site.
Definition at line 192 of file Pointer.h.
References clang::interp::Block::Desc.
Referenced by atIndex(), clang::interp::CallVirt(), clang::interp::CheckExtern(), CheckTemporary(), elemSize(), expand(), getDeclLoc(), getFieldDesc(), isConst(), and toAPValue().
|
inline |
Returns the declaration ID.
Definition at line 313 of file Pointer.h.
References clang::interp::Block::getDeclID().
Referenced by CheckGlobal(), and CheckTemporary().
|
inline |
Definition at line 193 of file Pointer.h.
References getDeclDesc(), and clang::interp::Descriptor::getLocation().
Referenced by clang::interp::CheckLive(), and CheckTemporary().
|
inline |
Definition at line 229 of file Pointer.h.
References Pointer().
Referenced by clang::interp::CallVirt().
|
inline |
Returns the element record type, if this is a non-primive array.
Definition at line 278 of file Pointer.h.
References clang::interp::Descriptor::ElemDesc, clang::interp::Descriptor::ElemRecord, and getFieldDesc().
Referenced by clang::interp::CheckArrayInitialized().
|
inline |
Returns the field information.
Definition at line 282 of file Pointer.h.
References clang::interp::Descriptor::asFieldDecl(), and getFieldDesc().
Referenced by CheckActive(), clang::interp::CheckArrayInitialized(), and clang::interp::CheckMutable().
|
inline |
Accessors for information about the innermost field.
Definition at line 216 of file Pointer.h.
References clang::interp::InlineDescriptor::Desc, and getDeclDesc().
Referenced by atIndex(), clang::interp::CallVirt(), elemSize(), getElemRecord(), getField(), getOffset(), getRecord(), getSize(), getType(), hasSameArray(), inArray(), initialize(), inPrimitiveArray(), clang::interp::interp__builtin_nan(), clang::interp::interp__builtin_strcmp(), clang::interp::interp__builtin_strlen(), isInitialized(), isUnknownSizeArray(), narrow(), toAPValue(), and toRValue().
|
inline |
Returns the index into an array.
Definition at line 326 of file Pointer.h.
References elemSize(), getOffset(), and isElementPastEnd().
Referenced by initialize(), clang::interp::interp__builtin_strcmp(), clang::interp::interp__builtin_strlen(), isInitialized(), clang::interp::OffsetHelper(), clang::interp::SubPtr(), and toAPValue().
|
inline |
Definition at line 87 of file Pointer.h.
Referenced by clang::interp::CastPointerIntegral().
|
inline |
Returns the number of elements.
Definition at line 321 of file Pointer.h.
References elemSize(), and getSize().
Referenced by elem(), clang::interp::interp__builtin_nan(), and clang::interp::OffsetHelper().
|
inline |
Returns the offset into an array.
Definition at line 241 of file Pointer.h.
References getFieldDesc().
Referenced by getIndex(), and isOnePastEnd().
|
inline |
Returns the record descriptor of a class.
Definition at line 276 of file Pointer.h.
References clang::interp::Descriptor::ElemRecord, and getFieldDesc().
Referenced by clang::interp::CheckFieldsInitialized(), clang::interp::SetThreeWayComparisonField(), and toRValue().
|
inline |
Returns the total size of the innermost field.
Definition at line 238 of file Pointer.h.
References getFieldDesc(), and clang::interp::Descriptor::getSize().
Referenced by atIndex(), expand(), getNumElems(), and isOnePastEnd().
|
inline |
Returns the type of the innermost field.
Definition at line 223 of file Pointer.h.
References clang::Type::getAsArrayTypeUnsafe(), clang::ArrayType::getElementType(), getFieldDesc(), clang::interp::Descriptor::getType(), and inPrimitiveArray().
Referenced by clang::interp::CheckConst(), clang::interp::SetThreeWayComparisonField(), toDiagnosticString(), and toRValue().
Checks if two pointers can be subtracted.
Definition at line 222 of file Pointer.cpp.
References getFieldDesc(), hasSameBase(), and clang::interp::Descriptor::IsArray.
Referenced by clang::interp::SubPtr().
Checks if two pointers are comparable.
Definition at line 218 of file Pointer.cpp.
Referenced by clang::interp::CmpHelper< Pointer >(), clang::interp::CmpHelperEQ< Pointer >(), compare(), and hasSameArray().
|
inline |
Checks if the innermost field is an array.
Definition at line 261 of file Pointer.h.
References getFieldDesc(), and clang::interp::Descriptor::IsArray.
Referenced by clang::interp::CmpHelperEQ< Pointer >(), isArrayRoot(), and clang::interp::OffsetHelper().
void Pointer::initialize | ( | ) | const |
Initializes a field.
Definition at line 180 of file Pointer.cpp.
References clang::interp::InitMap::allocate(), getFieldDesc(), getIndex(), clang::interp::Descriptor::getNumElems(), clang::interp::InitMap::initialize(), clang::interp::InlineDescriptor::IsInitialized, clang::interp::Descriptor::isPrimitiveArray(), and isStatic().
Referenced by clang::interp::InitPop(), clang::interp::SetThreeWayComparisonField(), clang::interp::Store(), clang::interp::StoreBitField(), clang::interp::StoreBitFieldPop(), and clang::interp::StorePop().
|
inline |
Checks if the structure is a primitive array.
Definition at line 263 of file Pointer.h.
References getFieldDesc(), and clang::interp::Descriptor::isPrimitiveArray().
|
inline |
Checks if the object is active.
Definition at line 303 of file Pointer.h.
References clang::interp::InlineDescriptor::IsActive.
Referenced by CheckActive().
|
inline |
Checks if the pointer points to an array.
Definition at line 269 of file Pointer.h.
Referenced by toAPValue().
|
inline |
|
inline |
Checks if a structure is a base class.
Definition at line 305 of file Pointer.h.
References clang::interp::InlineDescriptor::IsBase, and isField().
|
inline |
Checks if an object or a subfield is mutable.
Definition at line 308 of file Pointer.h.
References getDeclDesc(), clang::interp::InlineDescriptor::IsConst, and clang::interp::Descriptor::IsConst.
Referenced by clang::interp::CheckConst().
|
inline |
Checks if the pointer is an out-of-bounds element pointer.
Definition at line 340 of file Pointer.h.
Referenced by clang::interp::CheckRange(), expand(), getIndex(), and isOnePastEnd().
|
inline |
Checks if the storage is extern.
Definition at line 288 of file Pointer.h.
References clang::interp::Block::isExtern().
Referenced by clang::interp::CheckExtern().
|
inline |
Checks if the item is a field in an object.
Definition at line 189 of file Pointer.h.
Referenced by clang::interp::CheckLive(), isBaseClass(), and toAPValue().
bool Pointer::isInitialized | ( | ) | const |
Checks if an object was initialized.
Definition at line 160 of file Pointer.cpp.
References getFieldDesc(), getIndex(), clang::interp::InlineDescriptor::IsInitialized, clang::interp::InitMap::isInitialized(), clang::interp::Descriptor::isPrimitiveArray(), and isStatic().
Referenced by clang::interp::CheckArrayInitialized(), clang::interp::CheckFieldsInitialized(), and clang::interp::CheckInitialized().
|
inline |
Checks if the pointer is live.
Definition at line 187 of file Pointer.h.
References clang::interp::Block::IsDead.
Referenced by clang::interp::CheckConst(), clang::interp::CheckLive(), clang::interp::CheckMutable(), and deref().
|
inline |
Checks if the field is mutable.
Definition at line 297 of file Pointer.h.
References clang::interp::InlineDescriptor::IsFieldMutable.
Referenced by clang::interp::CheckMutable().
|
inline |
Checks if the index is one past end.
Definition at line 335 of file Pointer.h.
References getOffset(), getSize(), and isElementPastEnd().
Referenced by clang::interp::CheckRange(), clang::interp::CheckSubobject(), narrow(), and toAPValue().
|
inline |
Pointer points directly to a block.
Definition at line 271 of file Pointer.h.
Referenced by clang::interp::CmpHelperEQ< Pointer >().
|
inline |
Checks if the storage is static.
Definition at line 290 of file Pointer.h.
References clang::interp::Block::isStatic().
Referenced by CheckGlobal(), initialize(), isInitialized(), and isStaticTemporary().
|
inline |
Checks if the storage is a static temporary.
Definition at line 294 of file Pointer.h.
References isStatic(), and isTemporary().
Referenced by CheckTemporary().
|
inline |
Checks if the storage is temporary.
Definition at line 292 of file Pointer.h.
References clang::interp::Block::isTemporary().
Referenced by clang::interp::CheckLive(), and isStaticTemporary().
bool clang::interp::Pointer::isUnion | ( | ) | const |
Checks if the object is a union.
|
inline |
Checks if the structure is an array of unknown size.
Definition at line 265 of file Pointer.h.
References getFieldDesc(), and clang::interp::Descriptor::isUnknownSizeArray().
Referenced by clang::interp::CheckArray(), narrow(), and toAPValue().
|
inline |
Checks if the pointer is null.
Definition at line 185 of file Pointer.h.
Referenced by clang::interp::CheckLive(), clang::interp::CheckNull(), clang::interp::CmpHelperEQ< Pointer >(), narrow(), and toAPValue().
|
inline |
Restricts the scope of an array element pointer.
Definition at line 121 of file Pointer.h.
References getFieldDesc(), inPrimitiveArray(), isOnePastEnd(), isUnknownSizeArray(), isZero(), and Pointer().
Referenced by clang::interp::CheckArrayInitialized(), clang::interp::Program::createGlobalString(), and clang::interp::NarrowPtr().
void Pointer::operator= | ( | const Pointer & | P | ) |
Definition at line 49 of file Pointer.cpp.
References clang::interp::Block::addPointer(), clang::interp::Block::cleanup(), P, and clang::interp::Block::removePointer().
void Pointer::operator= | ( | Pointer && | P | ) |
Definition at line 66 of file Pointer.cpp.
References clang::interp::Block::cleanup(), P, clang::interp::Block::removePointer(), and clang::interp::Block::replacePointer().
|
inline |
APValue Pointer::toAPValue | ( | ) | const |
Converts the pointer to an APValue.
Definition at line 83 of file Pointer.cpp.
References clang::APValue::LValuePathEntry::ArrayIndex(), clang::interp::Descriptor::asDecl(), clang::interp::Descriptor::asExpr(), clang::interp::Descriptor::asValueDecl(), getArray(), getBase(), getDeclDesc(), getFieldDesc(), getIndex(), isArrayElement(), isField(), isOnePastEnd(), isUnknownSizeArray(), isZero(), and clang::CharUnits::Zero().
Referenced by toDiagnosticString(), and toRValue().
std::string Pointer::toDiagnosticString | ( | const ASTContext & | Ctx | ) | const |
Converts the pointer to a string usable in diagnostics.
Definition at line 153 of file Pointer.cpp.
References clang::APValue::getAsString(), getType(), and toAPValue().
Referenced by clang::interp::CmpHelper< Pointer >().
Converts the pointer to an APValue that is an rvalue.
Definition at line 226 of file Pointer.cpp.
References atField(), clang::interp::Context::classify(), clang::interp::Record::getBase(), clang::interp::Record::getField(), getFieldDesc(), clang::interp::Record::getNumBases(), clang::interp::Record::getNumFields(), getRecord(), getType(), clang::interp::Record::Field::Offset, clang::interp::Record::Base::Offset, clang::Result, toAPValue(), toRValue(), and TYPE_SWITCH.
Referenced by toRValue().