clang 24.0.0git
Public Member Functions | Static Public Member Functions | Friends | List of all members
clang::interp::Pointer Class Reference

A pointer to a memory block, live or dead. More...

#include "/work/as-worker-4/publish-doxygen-docs/llvm-project/clang/lib/AST/ByteCode/Pointer.h"

Public Member Functions

 Pointer ()
 Pointer (IntPointer &&IntPtr)
 Pointer (Block *B)
 Pointer (Block *B, uint64_t BaseAndOffset)
 Pointer (const Pointer &P)
 Pointer (Pointer &&P)
 Pointer (uint64_t Address, const Type *Ty, uint64_t Offset=0)
 Pointer (const Function *F, uint64_t Offset=0)
 Pointer (const Type *TypePtr, const Type *TypeInfoType, uint64_t Offset=0)
 Pointer (const Expr *Base, unsigned Id)
 Pointer (StringPointer Str, uint64_t Offset=0)
 Pointer (const ValueDecl *Base, bool ConstexprUnknown=false)
 Pointer (OpaquePointer OP, uint64_t Offset=0)
 Pointer (Block *Pointee, unsigned Base, uint64_t Offset)
 Pointer (PtrView V)
 ~Pointer ()
Pointer & operator= (const Pointer &P)
Pointer & operator= (Pointer &&P)
bool operator== (const Pointer &P) const
bool operator!= (const Pointer &P) const
APValue toAPValue (const ASTContext &ASTCtx) const
 Converts the pointer to an APValue.
std::string toDiagnosticString (const ASTContext &Ctx) const
 Converts the pointer to a string usable in diagnostics.
uint64_t getIntegerRepresentation () const
PtrView view () const
std::optional< APValue > toRValue (const Context &Ctx, QualType ResultType) const
 Converts the pointer to an APValue that is an rvalue.
Pointer atIndex (uint64_t 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.
const Descriptor * getDeclDesc () const
 Accessor for information about the declaration site.
SourceLocation getDeclLoc () const
DeclOrExpr getSource () const
 Returns the expression or declaration the pointer has been created for.
Pointer getBase () const
 Returns a pointer to the object of which this pointer is a field.
Pointer getArray () const
 Returns the parent array.
const Descriptor * getFieldDesc () const
 Accessors for information about the innermost field.
QualType getType () const
 Returns the type of the innermost field.
const VarDecl * getRootVarDecl () const
const Expr * getRootExpr () const
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 inUnion () const
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.
bool canBeInitialized () const
 If this pointer has an InlineDescriptor we can use to initialize.
const BlockPointer & asBlockPointer () const
const IntPointer & asIntPointer () const
const FunctionPointer & asFunctionPointer () const
const TypeidPointer & asTypeidPointer () const
const StringPointer & asStringPointer () const
const OpaquePointer & asOpaquePointer () const
bool isBlockPointer () const
bool isIntegralPointer () const
bool isFunctionPointer () const
bool isTypeidPointer () const
bool isStringPointer () const
bool isOpaquePointer () const
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 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 isDynamic () const
 Checks if the storage has been dynamically allocated.
bool isStaticTemporary () const
 Checks if the storage is a static temporary.
bool isMutable () const
 Checks if the field is mutable.
bool isWeak () const
bool isActive () const
 Checks if the object is active.
bool isBaseClass () const
 Checks if a structure is a base class.
bool isVirtualBaseClass () const
bool isDummy () const
 Checks if the pointer points to a dummy value.
bool isConst () const
 Checks if an object or a subfield is mutable.
bool isConstInMutable () const
bool isVolatile () const
 Checks if an object or a subfield is volatile.
UnsignedOrNone getDeclID () const
 Returns the declaration ID.
uint64_t getByteOffset () const
 Returns the byte offset from the start.
uint64_t getRawOffset () const
unsigned getNumElems () const
 Returns the number of elements.
const Block * block () const
const std::byte * getRawAddress () const
 If backed by actual data (i.e.
int64_t getIndex () const
 Returns the index into an array.
bool isOnePastEnd () const
 Checks if the index is one past end.
bool isPastEnd () const
 Checks if the pointer points past the end of the object.
bool isElementPastEnd () const
 Checks if the pointer is an out-of-bounds element pointer.
bool isZeroSizeArray () const
 Checks if the pointer is pointing to a zero-size array.
bool canDeref (PrimType T) const
 Checks whether the pointer can be dereferenced to the given PrimType.
template<typename T>
T & deref () const
 Dereferences the pointer, if it's live.
template<typename T>
T load () const
template<typename T>
T & elem (unsigned I) const
 Dereferences the element at index I.
template<typename T>
T loadElem (unsigned I) const
bool isConstexprUnknown () const
bool isDereferencable () const
 Whether this block can be read from at all.
bool isReadablePointerType () const
void initialize () const
 Initializes a field.
void initializeElement (unsigned Index) const
 Initialized the given element of a primitive array.
void initializeAllElements () const
 Initialize all elements of a primitive array at once.
bool isInitialized () const
 Checks if an object was initialized.
bool isElementInitialized (unsigned Index) const
 Like isInitialized(), but for primitive arrays.
bool allElementsInitialized () const
bool allElementsAlive () const
bool isElementAlive (unsigned Index) const
void activate () const
 Activates a field.
void deactivate () const
 Deactivates an entire strurcutre.
Lifetime getLifetime () const
void startLifetime () const
 Start the lifetime of this pointer.
void endLifetime () const
 Ends the lifetime of the pointer.
void setLifeState (Lifetime L) const
Pointer stripBaseCasts () const
 Strip base casts from this Pointer.
ComparisonCategoryResult compare (const Pointer &Other) const
 Compare two pointers.
bool pointsToLiteral () const
 Whether this points to a block that's been created for a "literal lvalue", i.e.
bool pointsToLabel () const
 Whether this points to a block created for an AddrLabelExpr.
const AddrLabelExpr * getPointedToLabel () const
 Returns the AddrLabelExpr the Pointer points to, if any.
void print (llvm::raw_ostream &OS) const
 Prints the pointer.
std::optional< size_t > computeOffsetForComparison (const ASTContext &ASTCtx) const
 Compute an integer that can be used to compare this pointer to another one.
std::optional< size_t > computeLayoutOffset (const ASTContext &ASTCtx) const
 Compute the pointer offset as given by the ASTRecordLayout.

Static Public Member Functions

static bool hasSameBase (const Pointer &A, const Pointer &B)
 Checks if two pointers are comparable.
static bool elemsOfSameArray (const Pointer &A, const Pointer &B)
 Checks if two pointers can be subtracted.
static bool pointToSameBlock (const Pointer &A, const Pointer &B)
 Checks if both given pointers point to the same block.
static std::optional< std::pair< PtrView, PtrView > > computeSplitPoint (const Pointer &A, const Pointer &B)

Friends

class Block
class DeadBlock
class MemberPointer
class InterpState
class DynamicAllocator
class Program

Detailed Description

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
///

Definition at line 530 of file Pointer.h.

Constructor & Destructor Documentation

◆ Pointer() [1/15]

clang::interp::Pointer::Pointer ( )
inline

Definition at line 532 of file Pointer.h.

References Int, and clang::nullptr.

Referenced by atField(), atFieldSub(), atIndex(), compare(), computeSplitPoint(), elemsOfSameArray(), expand(), getArray(), getBase(), getDeclPtr(), hasSameBase(), narrow(), operator!=(), operator=(), operator=(), operator==(), Pointer(), Pointer(), Pointer(), Pointer(), Pointer(), pointToSameBlock(), and stripBaseCasts().

◆ Pointer() [2/15]

clang::interp::Pointer::Pointer ( IntPointer && IntPtr)
inline

Definition at line 533 of file Pointer.h.

References Int.

◆ Pointer() [3/15]

Pointer::Pointer ( Block * B)

Definition at line 36 of file Pointer.cpp.

References Block, and Pointer().

◆ Pointer() [4/15]

Pointer::Pointer ( Block * B,
uint64_t BaseAndOffset )

Definition at line 40 of file Pointer.cpp.

References Block, and Pointer().

◆ Pointer() [5/15]

Pointer::Pointer ( const Pointer & P)

Definition at line 53 of file Pointer.cpp.

References clang::interp::Block, BS, Fn, clang::interp::Fn, Int, clang::interp::Int, Opaque, clang::interp::Opaque, Pointer(), Str, clang::interp::String, Typeid, and clang::interp::Typeid.

◆ Pointer() [6/15]

Pointer::Pointer ( Pointer && P)

Definition at line 79 of file Pointer.cpp.

References clang::interp::Block, BS, Fn, clang::interp::Fn, Int, clang::interp::Int, Opaque, clang::interp::Opaque, Pointer(), Str, clang::interp::String, Typeid, and clang::interp::Typeid.

◆ Pointer() [7/15]

clang::interp::Pointer::Pointer ( uint64_t Address,
const Type * Ty,
uint64_t Offset = 0 )
inline

Definition at line 539 of file Pointer.h.

References clang::interp::Address, and Int.

◆ Pointer() [8/15]

clang::interp::Pointer::Pointer ( const Function * F,
uint64_t Offset = 0 )
inline

Definition at line 541 of file Pointer.h.

References Fn.

◆ Pointer() [9/15]

clang::interp::Pointer::Pointer ( const Type * TypePtr,
const Type * TypeInfoType,
uint64_t Offset = 0 )
inline

Definition at line 543 of file Pointer.h.

References Typeid.

◆ Pointer() [10/15]

clang::interp::Pointer::Pointer ( const Expr * Base,
unsigned Id )
inline

Definition at line 548 of file Pointer.h.

References Str, and clang::interp::String.

◆ Pointer() [11/15]

clang::interp::Pointer::Pointer ( StringPointer Str,
uint64_t Offset = 0 )
inline

Definition at line 550 of file Pointer.h.

References Str, and clang::interp::String.

◆ Pointer() [12/15]

clang::interp::Pointer::Pointer ( const ValueDecl * Base,
bool ConstexprUnknown = false )
inline

Definition at line 552 of file Pointer.h.

References Opaque.

◆ Pointer() [13/15]

clang::interp::Pointer::Pointer ( OpaquePointer OP,
uint64_t Offset = 0 )
inline

Definition at line 560 of file Pointer.h.

References Opaque.

◆ Pointer() [14/15]

Pointer::Pointer ( Block * Pointee,
unsigned Base,
uint64_t Offset )

Definition at line 43 of file Pointer.cpp.

References Block, BS, and clang::interp::Block::getMetadataSize().

◆ Pointer() [15/15]

clang::interp::Pointer::Pointer ( PtrView V)
inlineexplicit

Definition at line 564 of file Pointer.h.

References Pointer(), and V.

◆ ~Pointer()

Pointer::~Pointer ( )

Definition at line 104 of file Pointer.cpp.

References Block, BS, and isBlockPointer().

Member Function Documentation

◆ activate()

void clang::interp::Pointer::activate ( ) const
inline

Activates a field.

Definition at line 1216 of file Pointer.h.

References clang::interp::PtrView::activate(), and view().

◆ allElementsAlive()

bool Pointer::allElementsAlive ( ) const

Definition at line 869 of file Pointer.cpp.

References clang::interp::InitMap::allElementsAlive(), clang::interp::InitMapPtr::allInitialized(), block(), BS, clang::interp::Block::getBlockDesc(), getFieldDesc(), clang::interp::InitMapPtr::hasInitMap(), clang::interp::Initialized, clang::interp::GlobalInlineDescriptor::InitState, isArrayRoot(), isRoot(), and isStatic().

◆ allElementsInitialized()

bool clang::interp::Pointer::allElementsInitialized ( ) const
inline

Definition at line 1207 of file Pointer.h.

References clang::interp::PtrView::allElementsInitialized(), getFieldDesc(), isArrayRoot(), and view().

◆ asBlockPointer()

const BlockPointer & clang::interp::Pointer::asBlockPointer ( ) const
inlinenodiscard

Definition at line 816 of file Pointer.h.

References BS, and isBlockPointer().

Referenced by computeSplitPoint(), clang::interp::DeadBlock::DeadBlock(), hasSameBase(), and isInitialized().

◆ asFunctionPointer()

const FunctionPointer & clang::interp::Pointer::asFunctionPointer ( ) const
inlinenodiscard

Definition at line 824 of file Pointer.h.

References Fn, and isFunctionPointer().

Referenced by toAPValue().

◆ asIntPointer()

const IntPointer & clang::interp::Pointer::asIntPointer ( ) const
inlinenodiscard

Definition at line 820 of file Pointer.h.

References Int, and isIntegralPointer().

Referenced by toAPValue(), and toDiagnosticString().

◆ asOpaquePointer()

const OpaquePointer & clang::interp::Pointer::asOpaquePointer ( ) const
inlinenodiscard

Definition at line 836 of file Pointer.h.

References isOpaquePointer(), and Opaque.

Referenced by hasSameBase().

◆ asStringPointer()

const StringPointer & clang::interp::Pointer::asStringPointer ( ) const
inlinenodiscard

Definition at line 832 of file Pointer.h.

References isStringPointer(), and Str.

Referenced by clang::interp::DoMemcpy(), enumeratePointerFields(), clang::interp::getElemType(), clang::interp::interp__builtin_nan(), and clang::interp::interp__builtin_strlen().

◆ asTypeidPointer()

const TypeidPointer & clang::interp::Pointer::asTypeidPointer ( ) const
inlinenodiscard

Definition at line 828 of file Pointer.h.

References isTypeidPointer(), and Typeid.

Referenced by computeLayoutOffset(), computeOffsetForComparison(), hasSameBase(), and print().

◆ atField()

Pointer clang::interp::Pointer::atField ( unsigned Off) const
inlinenodiscard

Creates a pointer to a field.

Definition at line 613 of file Pointer.h.

References atField(), clang::Off, Pointer(), and view().

Referenced by atField(), clang::interp::MemberPointer::getBase(), clang::interp::GetField(), clang::interp::GetFieldPop(), and clang::interp::MemberPointer::toPointer().

◆ atFieldSub()

Pointer clang::interp::Pointer::atFieldSub ( unsigned Off) const
inlinenodiscard

Subtract the given offset from the current Base and Offset of the pointer.

Definition at line 619 of file Pointer.h.

References BS, clang::Off, and Pointer().

Referenced by clang::interp::MemberPointer::getBase().

◆ atIndex()

Pointer clang::interp::Pointer::atIndex ( uint64_t Idx) const
inlinenodiscard

Offsets a pointer inside an array.

Definition at line 597 of file Pointer.h.

References atIndex(), clang::interp::Block, Fn, clang::interp::Fn, Int, clang::interp::Int, Pointer(), Str, clang::interp::String, and view().

Referenced by atIndex(), clang::interp::BitCast(), clang::interp::CopyArray(), clang::interp::interp__builtin_elementwise_countzeroes(), clang::interp::interp__builtin_nan(), and clang::interp::RunDestructors().

◆ block()

const Block * clang::interp::Pointer::block ( ) const
inline

Definition at line 993 of file Pointer.h.

References Block, and BS.

Referenced by allElementsAlive(), clang::interp::collectBlocks(), clang::interp::Program::dump(), hasSameBase(), clang::interp::isConstexprUnknown(), isInitialized(), clang::interp::operator<<(), operator=(), pointsToLiteral(), pointToSameBlock(), toAPValue(), and clang::interp::MemberPointer::toPointer().

◆ canBeInitialized()

bool clang::interp::Pointer::canBeInitialized ( ) const
inline

If this pointer has an InlineDescriptor we can use to initialize.

Definition at line 809 of file Pointer.h.

References BS, and isBlockPointer().

Referenced by clang::interp::interp__builtin_carryop(), and clang::interp::interp__builtin_overflowop().

◆ canDeref()

bool clang::interp::Pointer::canDeref ( PrimType T) const
inline

Checks whether the pointer can be dereferenced to the given PrimType.

Definition at line 1058 of file Pointer.h.

References getFieldDesc(), isBlockPointer(), isStringPointer(), clang::interp::PT_Sint16, clang::interp::PT_Sint32, clang::interp::PT_Sint8, clang::interp::PT_Uint16, clang::interp::PT_Uint32, clang::interp::PT_Uint8, Str, and clang::T.

Referenced by toRValue().

◆ compare()

ComparisonCategoryResult clang::interp::Pointer::compare ( const Pointer & Other) const
inline

Compare two pointers.

Definition at line 1252 of file Pointer.h.

References clang::Equal, clang::Greater, hasSameBase(), clang::Less, clang::Other, Pointer(), and clang::Unordered.

◆ computeLayoutOffset()

std::optional< size_t > Pointer::computeLayoutOffset ( const ASTContext & ASTCtx) const

Compute the pointer offset as given by the ASTRecordLayout.

Returns the result in bytes.

Definition at line 586 of file Pointer.cpp.

References asTypeidPointer(), clang::interp::Block, clang::cast(), clang::interp::PtrView::expand(), clang::interp::Fn, clang::interp::PtrView::getArray(), clang::ASTContext::getASTRecordLayout(), clang::interp::PtrView::getBase(), clang::ASTRecordLayout::getBaseClassOffset(), clang::ASTContext::getCanonicalTagType(), clang::interp::PtrView::getDeclDesc(), clang::interp::Descriptor::getElemQualType(), clang::interp::PtrView::getField(), clang::interp::PtrView::getFieldDesc(), clang::FieldDecl::getFieldIndex(), clang::ASTRecordLayout::getFieldOffset(), clang::interp::PtrView::getIndex(), getIntegerRepresentation(), clang::FieldDecl::getParent(), clang::CharUnits::getQuantity(), getRecordDecl(), clang::interp::Descriptor::getType(), clang::ValueDecl::getType(), clang::ASTContext::getTypeSizeInChars(), clang::ASTRecordLayout::getVBaseClassOffset(), clang::ASTContext::hasLayout(), Int, clang::interp::Int, clang::interp::Descriptor::isArray(), clang::interp::PtrView::isArrayElement(), clang::interp::PtrView::isBaseClass(), clang::interp::PtrView::isOnePastEnd(), clang::interp::PtrView::isPastEnd(), clang::interp::PtrView::isRoot(), clang::interp::PtrView::isVirtualBaseClass(), Opaque, clang::interp::Opaque, clang::Result, Str, clang::interp::String, clang::T, clang::ASTContext::toCharUnitsFromBits(), clang::interp::Typeid, clang::interp::TypeidPointer::TypePtr, clang::interp::validType(), and view().

Referenced by clang::interp::SubPtr().

◆ computeOffsetForComparison()

std::optional< size_t > Pointer::computeOffsetForComparison ( const ASTContext & ASTCtx) const

Compute an integer that can be used to compare this pointer to another one.

Compute an offset that can be used to compare the pointer to another one with the same base.

This is usually NOT the same as the pointer offset regarding the AST record layout.

To get accurate results, we basically have to compute the lvalue offset using the ASTRecordLayout.

This function will fail if we're trying to get the type size of a forward declaration.

Definition at line 503 of file Pointer.cpp.

References asTypeidPointer(), clang::interp::Block, clang::interp::PtrView::elemSize(), clang::interp::PtrView::expand(), clang::interp::Fn, clang::interp::PtrView::getArray(), clang::ASTContext::getASTRecordLayout(), clang::interp::PtrView::getBase(), clang::interp::PtrView::getDeclDesc(), clang::interp::PtrView::getField(), clang::FieldDecl::getFieldIndex(), clang::ASTRecordLayout::getFieldOffset(), clang::interp::PtrView::getIndex(), clang::interp::PtrView::getInlineDesc(), getIntegerRepresentation(), clang::CharUnits::getQuantity(), clang::interp::PtrView::getRecord(), clang::interp::Descriptor::getType(), clang::ValueDecl::getType(), clang::ASTContext::getTypeSizeInChars(), clang::ASTContext::hasLayout(), Int, clang::interp::Int, clang::interp::PtrView::isArrayElement(), clang::interp::PtrView::isBaseClass(), clang::interp::PtrView::isOnePastEnd(), clang::interp::PtrView::isRoot(), clang::interp::PtrView::isVirtualBaseClass(), clang::interp::InlineDescriptor::Offset, Opaque, clang::interp::Opaque, clang::Result, Str, clang::interp::String, clang::T, clang::ASTContext::toCharUnitsFromBits(), clang::interp::Typeid, clang::interp::TypeidPointer::TypePtr, clang::interp::validType(), and view().

Referenced by clang::interp::CmpHelper< Pointer >(), and clang::interp::CmpHelperEQ< Pointer >().

◆ computeSplitPoint()

std::optional< std::pair< PtrView, PtrView > > Pointer::computeSplitPoint ( const Pointer & A,
const Pointer & B )
static

Definition at line 1056 of file Pointer.cpp.

References asBlockPointer(), clang::interp::PtrView::Base, getBase(), clang::interp::PtrView::getFieldDesc(), clang::interp::Descriptor::isArray(), isBlockPointer(), isRoot(), clang::interp::PtrView::isRoot(), clang::interp::BlockPointer::Pointee, Pointer(), and view().

Referenced by clang::interp::CmpHelper< Pointer >().

◆ deactivate()

void clang::interp::Pointer::deactivate ( ) const
inline

Deactivates an entire strurcutre.

Definition at line 1218 of file Pointer.h.

◆ deref()

template<typename T>
T & clang::interp::Pointer::deref ( ) const
inline

Dereferences the pointer, if it's live.

Definition at line 1081 of file Pointer.h.

References BS, clang::interp::PtrView::deref(), isBlockPointer(), isDereferencable(), isLive(), clang::T, and view().

Referenced by clang::interp::assignIntegral(), clang::interp::InitGlobal(), and clang::interp::interp__builtin_elementwise_countzeroes().

◆ elem()

template<typename T>
T & clang::interp::Pointer::elem ( unsigned I) const
inline

Dereferences the element at index I.

This is equivalent to atIndex(I).deref<T>().

Definition at line 1119 of file Pointer.h.

References BS, clang::interp::PtrView::elem(), getFieldDesc(), getNumElems(), isBlockPointer(), isDereferencable(), isLive(), clang::T, and view().

Referenced by clang::interp::convertBoolVectorToInt(), clang::interp::CopyArray(), clang::interp::Divc(), clang::interp::interp__builtin_elementwise_abs(), clang::interp::interp__builtin_elementwise_fp_binop(), clang::interp::interp__builtin_elementwise_int_binop(), clang::interp::interp__builtin_elementwise_int_unaryop(), clang::interp::interp__builtin_elementwise_maxmin(), clang::interp::interp__builtin_elementwise_triop(), clang::interp::interp__builtin_elementwise_triop_fp(), clang::interp::interp__builtin_ia32_addsub(), clang::interp::interp__builtin_ia32_cmp_mask(), clang::interp::interp__builtin_ia32_cvt_mask2vec(), clang::interp::interp__builtin_ia32_cvt_vec2mask(), clang::interp::interp__builtin_ia32_cvtpd2ps(), clang::interp::interp__builtin_ia32_cvtsd2ss(), clang::interp::interp__builtin_ia32_dbpsadbw(), clang::interp::interp__builtin_ia32_extract_vector(), clang::interp::interp__builtin_ia32_extract_vector_masked(), clang::interp::interp__builtin_ia32_gfni_affine(), clang::interp::interp__builtin_ia32_gfni_mul(), clang::interp::interp__builtin_ia32_insert_subvector(), clang::interp::interp__builtin_ia32_mpsadbw(), clang::interp::interp__builtin_ia32_multishiftqb(), clang::interp::interp__builtin_ia32_pack(), clang::interp::interp__builtin_ia32_pclmulqdq(), clang::interp::interp__builtin_ia32_pmul(), clang::interp::interp__builtin_ia32_psadbw(), clang::interp::interp__builtin_ia32_select(), clang::interp::interp__builtin_ia32_select_scalar(), clang::interp::interp__builtin_ia32_shift_with_count(), clang::interp::interp__builtin_ia32_shufbitqmb_mask(), clang::interp::interp__builtin_ia32_shuffle_generic(), clang::interp::interp__builtin_ia32_test_op(), clang::interp::interp__builtin_ia32_vcvtps2ph(), clang::interp::interp__builtin_ia32_vec_ext(), clang::interp::interp__builtin_ia32_vec_set(), clang::interp::interp__builtin_ia32_vpconflict(), clang::interp::interp__builtin_ia32_vpdp(), clang::interp::interp__builtin_nan(), clang::interp::interp__builtin_scalar_fp_round_mask_binop(), clang::interp::interp__builtin_vector_reduce(), clang::interp::interp_builtin_horizontal_fp_binop(), clang::interp::interp_builtin_horizontal_int_binop(), clang::interp::interp_builtin_ia32_cvt_scalar_to_int(), clang::interp::interp_builtin_ia32_cvt_vector_to_int(), and clang::interp::Mulc().

◆ elemSize()

size_t clang::interp::Pointer::elemSize ( ) const
inline

Returns the element size of the innermost field.

Definition at line 737 of file Pointer.h.

References clang::interp::PtrView::elemSize(), isIntegralPointer(), isStringPointer(), Str, and view().

Referenced by getIntegerRepresentation(), and toAPValue().

◆ elemsOfSameArray()

bool Pointer::elemsOfSameArray ( const Pointer & A,
const Pointer & B )
static

Checks if two pointers can be subtracted.

Definition at line 994 of file Pointer.cpp.

References clang::interp::BlockPointer::Base, BS, getField(), hasSameBase(), isBaseClass(), isBlockPointer(), Pointer(), and V.

Referenced by clang::interp::SubPtr().

◆ endLifetime()

void clang::interp::Pointer::endLifetime ( ) const
inline

Ends the lifetime of the pointer.

This works for pointer with an InlineDescriptor as well as primitive array elements. This function is used by std::destroy_at.

Definition at line 1236 of file Pointer.h.

References clang::interp::Ended, and setLifeState().

◆ expand()

Pointer clang::interp::Pointer::expand ( ) const
inlinenodiscard

Expands a pointer to the containing array, undoing narrowing.

Definition at line 633 of file Pointer.h.

References expand(), isBlockPointer(), Pointer(), and view().

Referenced by clang::interp::CheckNewTypeMismatch(), expand(), clang::interp::interp__builtin_memcpy(), clang::interp::operator<<(), and pointsToLastObject().

◆ getArray()

Pointer clang::interp::Pointer::getArray ( ) const
inlinenodiscard

Returns the parent array.

Definition at line 695 of file Pointer.h.

References getArray(), Pointer(), and view().

Referenced by getArray(), clang::interp::operator<<(), and pointsToLastObject().

◆ getBase()

Pointer clang::interp::Pointer::getBase ( ) const
inlinenodiscard

Returns a pointer to the object of which this pointer is a field.

Definition at line 693 of file Pointer.h.

References getBase(), Pointer(), and view().

Referenced by clang::interp::CheckVolatile(), computeSplitPoint(), getBase(), and pointsToLastObject().

◆ getByteOffset()

uint64_t clang::interp::Pointer::getByteOffset ( ) const
inline

Returns the byte offset from the start.

Definition at line 970 of file Pointer.h.

References Int, isIntegralPointer(), isOnePastEnd(), isOpaquePointer(), isTypeidPointer(), clang::interp::PtrView::PastEndMark, and Typeid.

Referenced by clang::interp::interp__builtin_strlen(), and toAPValue().

◆ getDeclDesc()

const Descriptor * clang::interp::Pointer::getDeclDesc ( ) const
inline

Accessor for information about the declaration site.

Definition at line 670 of file Pointer.h.

References BS, and isBlockPointer().

Referenced by clang::interp::CheckLiteralType(), getDeclLoc(), getFieldDesc(), getPointedToLabel(), getRootExpr(), getRootVarDecl(), getSource(), isConstexprUnknown(), isVolatile(), and toAPValue().

◆ getDeclID()

UnsignedOrNone clang::interp::Pointer::getDeclID ( ) const
inline

Returns the declaration ID.

Definition at line 961 of file Pointer.h.

References BS, and isBlockPointer().

◆ getDeclLoc()

SourceLocation clang::interp::Pointer::getDeclLoc ( ) const
inline

Definition at line 678 of file Pointer.h.

References getDeclDesc(), and clang::interp::Descriptor::getLocation().

◆ getDeclPtr()

Pointer clang::interp::Pointer::getDeclPtr ( ) const
inlinenodiscard

Definition at line 734 of file Pointer.h.

References BS, and Pointer().

Referenced by toAPValue().

◆ getElemRecord()

const Record * clang::interp::Pointer::getElemRecord ( ) const
inline

Returns the element record type, if this is a non-primive array.

Definition at line 855 of file Pointer.h.

References clang::interp::PtrView::getElemRecord(), and view().

◆ getField()

const FieldDecl * clang::interp::Pointer::getField ( ) const
inline

Returns the field information.

Definition at line 857 of file Pointer.h.

References getFieldDesc().

Referenced by clang::interp::CheckVolatile(), elemsOfSameArray(), and pointsToLastObject().

◆ getFieldDesc()

const Descriptor * clang::interp::Pointer::getFieldDesc ( ) const
inline

Accessors for information about the innermost field.

Definition at line 698 of file Pointer.h.

References getDeclDesc(), isBlockPointer(), and isRoot().

Referenced by allElementsAlive(), allElementsInitialized(), clang::interp::BitCast(), clang::interp::CallVirt(), canDeref(), clang::interp::checkConstructor(), clang::interp::CheckVolatile(), clang::interp::convertBoolVectorToInt(), clang::interp::CopyArray(), clang::interp::DoBitCastPtr(), clang::interp::DoMemcpy(), elem(), clang::interp::getElemType(), clang::interp::GetField(), getField(), clang::interp::GetFieldPop(), getSize(), initializeAllElements(), clang::interp::interp__builtin_elementwise_abs(), clang::interp::interp__builtin_elementwise_countzeroes(), clang::interp::interp__builtin_elementwise_int_unaryop(), clang::interp::interp__builtin_ia32_cvt_mask2vec(), clang::interp::interp__builtin_ia32_cvt_vec2mask(), clang::interp::interp__builtin_ia32_extract_vector(), clang::interp::interp__builtin_ia32_extract_vector_masked(), clang::interp::interp__builtin_ia32_insert_subvector(), clang::interp::interp__builtin_ia32_select(), clang::interp::interp__builtin_ia32_vcvtps2ph(), clang::interp::interp__builtin_ia32_vec_ext(), clang::interp::interp__builtin_nan(), clang::interp::interp__builtin_strlen(), clang::interp::interp__builtin_vector_reduce(), isElementAlive(), isInitialized(), isUnknownSizeArray(), isZeroSizeArray(), loadElem(), clang::interp::operator<<(), and toAPValue().

◆ getIndex()

int64_t clang::interp::Pointer::getIndex ( ) const
inline

Returns the index into an array.

Definition at line 1008 of file Pointer.h.

References clang::interp::PtrView::getIndex(), getIntegerRepresentation(), isBlockPointer(), isStringPointer(), and view().

Referenced by clang::interp::arePotentiallyOverlappingStringLiterals(), clang::interp::DoMemcpy(), enumeratePointerFields(), clang::interp::interp__builtin_memcpy(), clang::interp::interp__builtin_strcmp(), clang::interp::interp__builtin_strlen(), isInitialized(), and clang::interp::operator<<().

◆ getIntegerRepresentation()

uint64_t clang::interp::Pointer::getIntegerRepresentation ( ) const
inline

Definition at line 579 of file Pointer.h.

References BS, elemSize(), Fn, Int, isFunctionPointer(), and isIntegralPointer().

Referenced by clang::interp::CmpHelperEQ< Pointer >(), computeLayoutOffset(), computeOffsetForComparison(), getIndex(), and clang::interp::interp__builtin_memcpy().

◆ getLifetime()

Lifetime clang::interp::Pointer::getLifetime ( ) const
inline

Definition at line 1222 of file Pointer.h.

References clang::interp::PtrView::getLifetime(), isBlockPointer(), clang::interp::Started, and view().

◆ getNumElems()

unsigned clang::interp::Pointer::getNumElems ( ) const
inline

Returns the number of elements.

Definition at line 985 of file Pointer.h.

References clang::interp::PtrView::getNumElems(), isBlockPointer(), isStringPointer(), Str, and view().

Referenced by clang::interp::arePotentiallyOverlappingStringLiterals(), clang::interp::convertBoolVectorToInt(), elem(), clang::interp::interp__builtin_elementwise_abs(), clang::interp::interp__builtin_elementwise_countzeroes(), clang::interp::interp__builtin_elementwise_int_unaryop(), clang::interp::interp__builtin_ia32_cmp_mask(), clang::interp::interp__builtin_ia32_cvt_mask2vec(), clang::interp::interp__builtin_ia32_cvt_vec2mask(), clang::interp::interp__builtin_ia32_cvtpd2ps(), clang::interp::interp__builtin_ia32_extract_vector(), clang::interp::interp__builtin_ia32_extract_vector_masked(), clang::interp::interp__builtin_ia32_gfni_mul(), clang::interp::interp__builtin_ia32_insert_subvector(), clang::interp::interp__builtin_ia32_movmsk_op(), clang::interp::interp__builtin_ia32_phminposuw(), clang::interp::interp__builtin_ia32_pternlog(), clang::interp::interp__builtin_ia32_select(), clang::interp::interp__builtin_ia32_test_op(), clang::interp::interp__builtin_ia32_vec_ext(), clang::interp::interp__builtin_memcmp(), clang::interp::interp__builtin_memcpy(), clang::interp::interp__builtin_nan(), clang::interp::interp__builtin_strcmp(), clang::interp::interp__builtin_vector_reduce(), clang::interp::interp_builtin_ia32_cvt_vector_to_int(), and loadElem().

◆ getOffset()

unsigned clang::interp::Pointer::getOffset ( ) const
inline

Returns the offset into an array.

Definition at line 754 of file Pointer.h.

References clang::interp::PtrView::getOffset(), clang::interp::PtrView::PastEndMark, and view().

◆ getPointedToLabel()

const AddrLabelExpr * clang::interp::Pointer::getPointedToLabel ( ) const
inline

Returns the AddrLabelExpr the Pointer points to, if any.

Definition at line 1280 of file Pointer.h.

References getDeclDesc().

Referenced by clang::interp::SubPtr().

◆ getRawAddress()

const std::byte * clang::interp::Pointer::getRawAddress ( ) const
inline

If backed by actual data (i.e.

a block or string pointer), return an address to that data.

Definition at line 997 of file Pointer.h.

References BS, clang::StringLiteral::getBytes(), clang::StringLiteral::getCharByteWidth(), isBlockPointer(), isStringPointer(), and Str.

◆ getRawOffset()

uint64_t clang::interp::Pointer::getRawOffset ( ) const
inline

Definition at line 982 of file Pointer.h.

◆ getRecord()

const Record * clang::interp::Pointer::getRecord ( ) const
inline

Returns the record descriptor of a class.

Definition at line 849 of file Pointer.h.

References clang::interp::PtrView::getRecord(), isBlockPointer(), and view().

Referenced by clang::interp::Memcpy(), pointsToLastObject(), and clang::interp::MemberPointer::toPointer().

◆ getRootExpr()

const Expr * Pointer::getRootExpr ( ) const

Definition at line 1311 of file Pointer.cpp.

References clang::interp::Descriptor::asExpr(), getDeclDesc(), isBlockPointer(), isStringPointer(), and Str.

Referenced by clang::interp::arePotentiallyOverlappingStringLiterals().

◆ getRootVarDecl()

const VarDecl * Pointer::getRootVarDecl ( ) const

Definition at line 1303 of file Pointer.cpp.

References clang::interp::Descriptor::asVarDecl(), getDeclDesc(), isBlockPointer(), isOpaquePointer(), and Opaque.

◆ getSize()

size_t clang::interp::Pointer::getSize ( ) const
inline

Returns the total size of the innermost field.

Definition at line 748 of file Pointer.h.

References getFieldDesc(), clang::interp::Descriptor::getSize(), and isBlockPointer().

◆ getSource()

DeclOrExpr clang::interp::Pointer::getSource ( ) const
inline

Returns the expression or declaration the pointer has been created for.

Definition at line 681 of file Pointer.h.

References Fn, clang::interp::Function::getDecl(), getDeclDesc(), clang::interp::Descriptor::getSource(), isBlockPointer(), and isFunctionPointer().

◆ getType()

QualType clang::interp::Pointer::getType ( ) const
inline

Returns the type of the innermost field.

Definition at line 708 of file Pointer.h.

References clang::interp::Block, Fn, clang::interp::Fn, clang::interp::PtrView::getType(), Int, clang::interp::Int, Opaque, clang::interp::Opaque, Str, clang::interp::String, Typeid, clang::interp::Typeid, and view().

Referenced by clang::interp::CheckVolatile(), clang::interp::DoBitCastPtr(), clang::interp::getElemType(), clang::interp::interp__builtin_memcmp(), clang::interp::interp__builtin_memcpy(), clang::interp::SubPtr(), and toDiagnosticString().

◆ hasSameBase()

bool Pointer::hasSameBase ( const Pointer & A,
const Pointer & B )
static

Checks if two pointers are comparable.

Definition at line 946 of file Pointer.cpp.

References asBlockPointer(), asOpaquePointer(), asTypeidPointer(), clang::interp::Descriptor::asVarDecl(), clang::interp::OpaquePointer::Base, clang::interp::Block, block(), clang::interp::Fn, clang::interp::Block::getDescriptor(), clang::interp::StringPointer::getLiteral(), clang::NamedDecl::getMostRecentDecl(), clang::interp::StringPointer::ID, clang::interp::Int, isBlockPointer(), isOpaquePointer(), isZero(), Opaque, clang::interp::Opaque, clang::interp::BlockPointer::Pointee, Pointer(), Str, clang::interp::String, clang::interp::Typeid, and clang::interp::TypeidPointer::TypePtr.

Referenced by clang::interp::CMP3(), clang::interp::CmpHelper< Pointer >(), clang::interp::CmpHelperEQ< Pointer >(), compare(), elemsOfSameArray(), and clang::interp::SubPtr().

◆ inArray()

bool clang::interp::Pointer::inArray ( ) const
inline

Checks if the innermost field is an array.

Definition at line 764 of file Pointer.h.

References clang::interp::PtrView::inArray(), isBlockPointer(), isStringPointer(), and view().

Referenced by clang::interp::interp__builtin_memcpy().

◆ initialize()

void clang::interp::Pointer::initialize ( ) const
inline

Initializes a field.

Definition at line 1185 of file Pointer.h.

References clang::interp::PtrView::initialize(), isBlockPointer(), and view().

Referenced by clang::interp::InitGlobal(), clang::interp::interp__builtin_carryop(), clang::interp::interp__builtin_elementwise_countzeroes(), and clang::interp::interp__builtin_overflowop().

◆ initializeAllElements()

void Pointer::initializeAllElements ( ) const

Initialize all elements of a primitive array at once.

This can be used in situations where we know we have initialized all elements of a primtive array.

Definition at line 846 of file Pointer.cpp.

References getFieldDesc(), and isArrayRoot().

Referenced by clang::interp::interp__builtin_elementwise_abs(), clang::interp::interp__builtin_elementwise_fp_binop(), clang::interp::interp__builtin_elementwise_int_binop(), clang::interp::interp__builtin_elementwise_int_unaryop(), clang::interp::interp__builtin_elementwise_triop(), clang::interp::interp__builtin_elementwise_triop_fp(), clang::interp::interp__builtin_ia32_cvt_mask2vec(), clang::interp::interp__builtin_ia32_cvtpd2ps(), clang::interp::interp__builtin_ia32_cvtsd2ss(), clang::interp::interp__builtin_ia32_extract_vector(), clang::interp::interp__builtin_ia32_extract_vector_masked(), clang::interp::interp__builtin_ia32_insert_subvector(), clang::interp::interp__builtin_ia32_multishiftqb(), clang::interp::interp__builtin_ia32_select(), clang::interp::interp__builtin_ia32_select_scalar(), clang::interp::interp__builtin_ia32_shift_with_count(), clang::interp::interp__builtin_ia32_shuffle_generic(), clang::interp::interp__builtin_ia32_vec_set(), clang::interp::interp__builtin_ia32_vpconflict(), and clang::interp::interp__builtin_ia32_vpdp().

◆ initializeElement()

void clang::interp::Pointer::initializeElement ( unsigned Index) const
inline

Initialized the given element of a primitive array.

Definition at line 1191 of file Pointer.h.

References clang::interp::PtrView::initializeElement(), and view().

Referenced by clang::interp::CopyArray().

◆ inPrimitiveArray()

bool clang::interp::Pointer::inPrimitiveArray ( ) const
inline

Checks if the structure is a primitive array.

Definition at line 778 of file Pointer.h.

References clang::interp::PtrView::inPrimitiveArray(), isBlockPointer(), and view().

◆ inUnion()

bool clang::interp::Pointer::inUnion ( ) const
inline

Definition at line 771 of file Pointer.h.

References BS, clang::interp::PtrView::inUnion(), isBlockPointer(), and view().

◆ isActive()

bool clang::interp::Pointer::isActive ( ) const
inline

Checks if the object is active.

Definition at line 919 of file Pointer.h.

References clang::interp::PtrView::isActive(), isBlockPointer(), and view().

◆ isArrayElement()

bool clang::interp::Pointer::isArrayElement ( ) const
inline

Checks if the pointer points to an array.

Definition at line 792 of file Pointer.h.

References clang::interp::PtrView::isArrayElement(), isBlockPointer(), and view().

Referenced by clang::interp::operator<<(), and pointsToLastObject().

◆ isArrayRoot()

bool clang::interp::Pointer::isArrayRoot ( ) const
inline

Whether this array refers to an array, but not to the first element.

Definition at line 761 of file Pointer.h.

References clang::interp::PtrView::isArrayRoot(), and view().

Referenced by allElementsAlive(), allElementsInitialized(), clang::interp::BitCast(), initializeAllElements(), and clang::interp::operator<<().

◆ isBaseClass()

bool clang::interp::Pointer::isBaseClass ( ) const
inline

Checks if a structure is a base class.

Definition at line 925 of file Pointer.h.

References clang::interp::PtrView::isBaseClass(), and view().

Referenced by elemsOfSameArray(), clang::interp::IsBaseClass(), clang::interp::operator<<(), and pointsToLastObject().

◆ isBlockPointer()

bool clang::interp::Pointer::isBlockPointer ( ) const
inline

Definition at line 841 of file Pointer.h.

References clang::interp::Block.

Referenced by asBlockPointer(), clang::interp::BitCast(), clang::interp::CallVirt(), canBeInitialized(), canDeref(), computeSplitPoint(), clang::interp::CopyArray(), deref(), clang::interp::DoBitCastPtr(), clang::interp::DoMemcpy(), clang::interp::DoMemcpy(), elem(), elemsOfSameArray(), expand(), getDeclDesc(), getDeclID(), clang::interp::GetField(), getFieldDesc(), clang::interp::GetFieldPop(), getIndex(), getLifetime(), getNumElems(), getRawAddress(), getRecord(), getRootExpr(), getRootVarDecl(), getSize(), getSource(), hasSameBase(), inArray(), initialize(), inPrimitiveArray(), clang::interp::interp__builtin_nan(), clang::interp::interp__builtin_overflowop(), clang::interp::interp__builtin_strlen(), inUnion(), isActive(), isArrayElement(), isConst(), clang::interp::isConstexprUnknown(), isConstexprUnknown(), isConstInMutable(), isDereferencable(), isDummy(), isDynamic(), isElementInitialized(), isExtern(), isField(), isInitialized(), isLive(), isMutable(), isOnePastEnd(), isRoot(), isStatic(), isTemporary(), isUnknownSizeArray(), isVolatile(), isWeak(), load(), loadElem(), narrow(), clang::interp::operator<<(), operator=(), operator=(), pointsToLabel(), pointsToLiteral(), pointToSameBlock(), setLifeState(), clang::interp::SubPtr(), toAPValue(), toRValue(), view(), and ~Pointer().

◆ isConst()

bool clang::interp::Pointer::isConst ( ) const
inline

Checks if an object or a subfield is mutable.

Definition at line 938 of file Pointer.h.

References isBlockPointer(), clang::interp::PtrView::isConst(), isIntegralPointer(), isStringPointer(), and view().

◆ isConstexprUnknown()

bool clang::interp::Pointer::isConstexprUnknown ( ) const
inline

Definition at line 1157 of file Pointer.h.

References getDeclDesc(), isBlockPointer(), clang::interp::Descriptor::IsConstexprUnknown, isOpaquePointer(), and Opaque.

Referenced by clang::interp::CmpHelperEQ< Pointer >(), clang::interp::interp__builtin_strlen(), isDereferencable(), and toAPValue().

◆ isConstInMutable()

bool clang::interp::Pointer::isConstInMutable ( ) const
inline

Definition at line 947 of file Pointer.h.

References false, isBlockPointer(), and isRoot().

◆ isDereferencable()

bool clang::interp::Pointer::isDereferencable ( ) const
inline

Whether this block can be read from at all.

This is only true for block pointers that point to a valid location inside that block.

Definition at line 1167 of file Pointer.h.

References isBlockPointer(), isConstexprUnknown(), isDummy(), and isPastEnd().

Referenced by deref(), elem(), load(), and loadElem().

◆ isDummy()

bool clang::interp::Pointer::isDummy ( ) const
inline

Checks if the pointer points to a dummy value.

Definition at line 929 of file Pointer.h.

References isBlockPointer(), clang::interp::PtrView::isDummy(), isOpaquePointer(), and view().

Referenced by clang::interp::Call(), clang::interp::CopyArray(), clang::interp::interp__builtin_overflowop(), clang::interp::interp__builtin_strcmp(), isDereferencable(), clang::interp::isReadable(), and toRValue().

◆ isDynamic()

bool clang::interp::Pointer::isDynamic ( ) const
inline

Checks if the storage has been dynamically allocated.

Definition at line 885 of file Pointer.h.

References BS, and isBlockPointer().

Referenced by pointsToLiteral(), and toAPValue().

◆ isElementAlive()

bool Pointer::isElementAlive ( unsigned Index) const

Definition at line 750 of file Pointer.cpp.

References clang::interp::InitMapPtr::allInitialized(), getFieldDesc(), clang::interp::InitMapPtr::hasInitMap(), and clang::interp::InitMap::isElementAlive().

◆ isElementInitialized()

bool clang::interp::Pointer::isElementInitialized ( unsigned Index) const
inline

Like isInitialized(), but for primitive arrays.

Definition at line 1201 of file Pointer.h.

References isBlockPointer(), clang::interp::PtrView::isElementInitialized(), and view().

Referenced by clang::interp::interp__builtin_nan(), and isInitialized().

◆ isElementPastEnd()

bool clang::interp::Pointer::isElementPastEnd ( ) const
inline

Checks if the pointer is an out-of-bounds element pointer.

Definition at line 1044 of file Pointer.h.

References clang::interp::PtrView::PastEndMark.

Referenced by print().

◆ isExtern()

bool clang::interp::Pointer::isExtern ( ) const
inline

Checks if the storage is extern.

Definition at line 864 of file Pointer.h.

References BS, and isBlockPointer().

◆ isField()

bool clang::interp::Pointer::isField ( ) const
inline

Checks if the item is a field in an object.

Definition at line 662 of file Pointer.h.

References isBlockPointer(), clang::interp::PtrView::isField(), and view().

◆ isFunctionPointer()

bool clang::interp::Pointer::isFunctionPointer ( ) const
inline

Definition at line 843 of file Pointer.h.

References clang::interp::Fn.

Referenced by asFunctionPointer(), clang::interp::CmpHelper< Pointer >(), clang::interp::CmpHelperEQ< Pointer >(), getIntegerRepresentation(), getSource(), isWeak(), and isZeroSizeArray().

◆ isInitialized()

bool Pointer::isInitialized ( ) const

Checks if an object was initialized.

Definition at line 703 of file Pointer.cpp.

References asBlockPointer(), block(), BS, clang::interp::Block::getBlockDesc(), getFieldDesc(), getIndex(), clang::interp::Initialized, clang::interp::GlobalInlineDescriptor::InitState, isBlockPointer(), isElementInitialized(), clang::interp::Descriptor::isPrimitiveArray(), and isRoot().

Referenced by clang::interp::Program::dump(), and clang::interp::Program::isGlobalInitialized().

◆ isIntegralPointer()

bool clang::interp::Pointer::isIntegralPointer ( ) const
inline

Definition at line 842 of file Pointer.h.

References clang::interp::Int.

Referenced by asIntPointer(), elemSize(), getByteOffset(), clang::interp::getElemType(), getIntegerRepresentation(), clang::interp::interp__builtin_memcpy(), isConst(), isPastEnd(), toDiagnosticString(), and toRValue().

◆ isLive()

bool clang::interp::Pointer::isLive ( ) const
inline

Checks if the pointer is live.

Definition at line 656 of file Pointer.h.

References isBlockPointer(), clang::interp::PtrView::isLive(), and view().

Referenced by deref(), clang::interp::DoBitCastPtr(), elem(), clang::interp::isReadable(), load(), loadElem(), clang::interp::operator<<(), and toRValue().

◆ isMutable()

bool clang::interp::Pointer::isMutable ( ) const
inline

Checks if the field is mutable.

Definition at line 896 of file Pointer.h.

References isBlockPointer(), clang::interp::PtrView::isMutable(), and view().

◆ isOnePastEnd()

bool clang::interp::Pointer::isOnePastEnd ( ) const
inline

Checks if the index is one past end.

Definition at line 1018 of file Pointer.h.

References BS, isBlockPointer(), clang::interp::PtrView::isOnePastEnd(), isOpaquePointer(), isStringPointer(), Opaque, Str, and view().

Referenced by clang::interp::arePotentiallyOverlappingStringLiterals(), clang::interp::CmpHelperEQ< Pointer >(), getByteOffset(), clang::interp::interp__builtin_strlen(), clang::interp::isReadable(), clang::interp::operator<<(), toAPValue(), and toRValue().

◆ isOpaquePointer()

bool clang::interp::Pointer::isOpaquePointer ( ) const
inline

Definition at line 846 of file Pointer.h.

References clang::interp::Opaque.

Referenced by asOpaquePointer(), clang::interp::CallVirt(), getByteOffset(), clang::interp::getElemType(), getRootVarDecl(), hasSameBase(), clang::interp::IncDecPtrHelper(), isConstexprUnknown(), isDummy(), isOnePastEnd(), isRoot(), isUnknownSizeArray(), isWeak(), and isZeroSizeArray().

◆ isPastEnd()

bool clang::interp::Pointer::isPastEnd ( ) const
inline

Checks if the pointer points past the end of the object.

Definition at line 1034 of file Pointer.h.

References BS, isIntegralPointer(), isStringPointer(), isZero(), and Str.

Referenced by isDereferencable(), and toRValue().

◆ isReadablePointerType()

bool clang::interp::Pointer::isReadablePointerType ( ) const
inline

Definition at line 1180 of file Pointer.h.

References clang::interp::Block, and clang::interp::String.

Referenced by clang::interp::DoMemcpy(), clang::interp::interp__builtin_memcmp(), clang::interp::interp__builtin_strcmp(), and clang::interp::isReadable().

◆ isRoot()

bool clang::interp::Pointer::isRoot ( ) const
inline

Pointer points directly to a block.

Definition at line 799 of file Pointer.h.

References isBlockPointer(), isOpaquePointer(), clang::interp::PtrView::isRoot(), isZero(), Opaque, and view().

Referenced by allElementsAlive(), clang::interp::CheckVolatile(), computeSplitPoint(), getFieldDesc(), isConstInMutable(), isInitialized(), isVolatile(), pointsToLastObject(), and print().

◆ isStatic()

bool clang::interp::Pointer::isStatic ( ) const
inline

Checks if the storage is static.

Definition at line 870 of file Pointer.h.

References BS, and isBlockPointer().

Referenced by allElementsAlive(), and isStaticTemporary().

◆ isStaticTemporary()

bool clang::interp::Pointer::isStaticTemporary ( ) const
inline

Checks if the storage is a static temporary.

Definition at line 893 of file Pointer.h.

References isStatic(), and isTemporary().

◆ isStringPointer()

bool clang::interp::Pointer::isStringPointer ( ) const
inline

Definition at line 845 of file Pointer.h.

References clang::interp::String.

Referenced by clang::interp::arePotentiallyOverlappingStringLiterals(), asStringPointer(), canDeref(), clang::interp::CmpHelperEQ< Pointer >(), clang::interp::DoMemcpy(), elemSize(), enumeratePointerFields(), clang::interp::getElemType(), getIndex(), getNumElems(), getRawAddress(), getRootExpr(), inArray(), clang::interp::interp__builtin_nan(), clang::interp::interp__builtin_strlen(), isConst(), isOnePastEnd(), isPastEnd(), load(), and loadElem().

◆ isTemporary()

bool clang::interp::Pointer::isTemporary ( ) const
inline

Checks if the storage is temporary.

Definition at line 877 of file Pointer.h.

References BS, and isBlockPointer().

Referenced by isStaticTemporary().

◆ isTypeidPointer()

bool clang::interp::Pointer::isTypeidPointer ( ) const
inline

Definition at line 844 of file Pointer.h.

References clang::interp::Typeid.

Referenced by asTypeidPointer(), clang::interp::CmpHelper< Pointer >(), and getByteOffset().

◆ isUnknownSizeArray()

bool clang::interp::Pointer::isUnknownSizeArray ( ) const
inline

Checks if the structure is an array of unknown size.

Definition at line 784 of file Pointer.h.

References getFieldDesc(), isBlockPointer(), isOpaquePointer(), clang::interp::Descriptor::isUnknownSizeArray(), and Opaque.

Referenced by clang::interp::CmpHelperEQ< Pointer >(), clang::interp::GetField(), clang::interp::GetFieldPop(), clang::interp::interp__builtin_memcpy(), and clang::interp::interp__builtin_strcmp().

◆ isVirtualBaseClass()

bool clang::interp::Pointer::isVirtualBaseClass ( ) const
inline

Definition at line 926 of file Pointer.h.

References clang::interp::PtrView::isVirtualBaseClass(), and view().

◆ isVolatile()

bool clang::interp::Pointer::isVolatile ( ) const
inline

Checks if an object or a subfield is volatile.

Definition at line 954 of file Pointer.h.

References getDeclDesc(), isBlockPointer(), isRoot(), and clang::interp::Descriptor::IsVolatile.

◆ isWeak()

bool clang::interp::Pointer::isWeak ( ) const
inline

Definition at line 902 of file Pointer.h.

References BS, Fn, isBlockPointer(), isFunctionPointer(), isOpaquePointer(), and Opaque.

◆ isZero()

bool clang::interp::Pointer::isZero ( ) const
inline

Checks if the pointer is null.

Definition at line 640 of file Pointer.h.

References clang::interp::Block, BS, Fn, clang::interp::Fn, Int, clang::interp::Int, clang::interp::Opaque, clang::interp::String, and clang::interp::Typeid.

Referenced by clang::interp::Call(), clang::interp::CheckNonNullArgs(), clang::interp::CmpHelperEQ< Pointer >(), hasSameBase(), clang::interp::interp__builtin_memcpy(), clang::interp::isConstexprUnknown(), isPastEnd(), isRoot(), clang::interp::operator<<(), pointsToLabel(), pointsToLiteral(), clang::interp::MemberPointer::takeInstance(), toAPValue(), toDiagnosticString(), and toRValue().

◆ isZeroSizeArray()

bool clang::interp::Pointer::isZeroSizeArray ( ) const
inline

Checks if the pointer is pointing to a zero-size array.

Definition at line 1047 of file Pointer.h.

References getFieldDesc(), isFunctionPointer(), and isOpaquePointer().

Referenced by toAPValue(), and toRValue().

◆ load()

template<typename T>
T clang::interp::Pointer::load ( ) const
inline

Definition at line 1090 of file Pointer.h.

References BS, clang::interp::PtrView::deref(), clang::StringLiteral::getCodeUnit(), clang::StringLiteral::getLength(), isBlockPointer(), isDereferencable(), clang::interp::isFixedSizeIntegralType(), isLive(), isStringPointer(), Str, clang::T, and view().

Referenced by clang::interp::interp__builtin_memchr(), and toRValue().

◆ loadElem()

template<typename T>
T clang::interp::Pointer::loadElem ( unsigned I) const
inline

Definition at line 1130 of file Pointer.h.

References BS, clang::interp::PtrView::elem(), clang::StringLiteral::getCodeUnit(), getFieldDesc(), clang::StringLiteral::getLength(), getNumElems(), isBlockPointer(), isDereferencable(), clang::interp::isFixedSizeIntegralType(), isLive(), isStringPointer(), Str, clang::T, and view().

Referenced by clang::interp::interp__builtin_nan(), and clang::interp::interp__builtin_strcmp().

◆ narrow()

Pointer clang::interp::Pointer::narrow ( ) const
inlinenodiscard

Restricts the scope of an array element pointer.

Definition at line 626 of file Pointer.h.

References isBlockPointer(), narrow(), Pointer(), and view().

Referenced by narrow(), and clang::interp::RunDestructors().

◆ operator!=()

bool clang::interp::Pointer::operator!= ( const Pointer & P) const
inline

Definition at line 571 of file Pointer.h.

References Pointer().

◆ operator=() [1/2]

Pointer & Pointer::operator= ( const Pointer & P)

Definition at line 115 of file Pointer.cpp.

References clang::interp::BlockPointer::Base, Block, clang::interp::Block, block(), BS, Fn, clang::interp::Fn, Int, clang::interp::Int, isBlockPointer(), Opaque, clang::interp::Opaque, Pointer(), Str, clang::interp::String, Typeid, and clang::interp::Typeid.

◆ operator=() [2/2]

Pointer & Pointer::operator= ( Pointer && P)

Definition at line 161 of file Pointer.cpp.

References Block, clang::interp::Block, BS, Fn, clang::interp::Fn, Int, clang::interp::Int, isBlockPointer(), Opaque, clang::interp::Opaque, Pointer(), Str, clang::interp::String, Typeid, and clang::interp::Typeid.

◆ operator==()

bool Pointer::operator== ( const Pointer & P) const

Definition at line 207 of file Pointer.cpp.

References clang::interp::PointerPathEntry::Array, clang::interp::OpaquePointer::Base, clang::interp::PointerPathEntry::Base, clang::interp::StringPointer::Base, clang::interp::Block, clang::interp::PointerPathEntry::FD, clang::interp::PointerPathEntry::Field, Fn, clang::interp::Fn, clang::interp::FunctionPointer::Func, clang::interp::PointerPathEntry::Index, Int, clang::interp::Int, clang::interp::PointerPathEntry::Kind, clang::interp::PointerPathEntry::NegativeArray, Opaque, clang::interp::Opaque, clang::interp::OpaquePointer::Path, clang::interp::OpaquePointer::PathLength, Pointer(), clang::interp::PointerPathEntry::RD, Str, clang::interp::String, clang::interp::IntPointer::Ty, clang::interp::Typeid, clang::interp::IntPointer::Value, and view().

◆ pointsToLabel()

bool Pointer::pointsToLabel ( ) const

Whether this points to a block created for an AddrLabelExpr.

Definition at line 1046 of file Pointer.cpp.

References BS, clang::isa(), isBlockPointer(), and isZero().

Referenced by clang::interp::SubPtr().

◆ pointsToLiteral()

bool Pointer::pointsToLiteral ( ) const

Whether this points to a block that's been created for a "literal lvalue", i.e.

a non-MaterializeTemporaryExpr Expr.

Definition at line 1035 of file Pointer.cpp.

References clang::interp::Descriptor::asExpr(), block(), clang::interp::Block::getDescriptor(), clang::isa(), isBlockPointer(), isDynamic(), and isZero().

◆ pointToSameBlock()

bool Pointer::pointToSameBlock ( const Pointer & A,
const Pointer & B )
static

Checks if both given pointers point to the same block.

Definition at line 988 of file Pointer.cpp.

References block(), isBlockPointer(), and Pointer().

Referenced by clang::interp::interp__builtin_memcpy(), and clang::interp::runRecordDestructor().

◆ print()

void Pointer::print ( llvm::raw_ostream & OS) const

Prints the pointer.

Definition at line 446 of file Pointer.cpp.

References asTypeidPointer(), Block, clang::interp::Block, BS, Fn, clang::interp::Fn, clang::interp::Block::getSize(), Int, clang::interp::Int, isElementPastEnd(), isRoot(), Opaque, clang::interp::Opaque, Str, clang::interp::String, clang::interp::Typeid, clang::interp::TypeidPointer::TypeInfoType, and clang::interp::TypeidPointer::TypePtr.

Referenced by clang::interp::operator<<().

◆ setLifeState()

void clang::interp::Pointer::setLifeState ( Lifetime L) const
inline

Definition at line 1238 of file Pointer.h.

References isBlockPointer(), clang::interp::PtrView::setLifeState(), and view().

Referenced by endLifetime(), and startLifetime().

◆ startLifetime()

void clang::interp::Pointer::startLifetime ( ) const
inline

Start the lifetime of this pointer.

This works for pointer with an InlineDescriptor as well as primitive array elements. Pointers are usually alive by default, unless the underlying object has been allocated with std::allocator. This function is used by std::construct_at.

Definition at line 1232 of file Pointer.h.

References setLifeState(), and clang::interp::Started.

◆ stripBaseCasts()

Pointer clang::interp::Pointer::stripBaseCasts ( ) const
inlinenodiscard

Strip base casts from this Pointer.

The result is either a root pointer or something that isn't a base class anymore.

Definition at line 1247 of file Pointer.h.

References Pointer(), stripBaseCasts(), and view().

Referenced by clang::interp::CallVirt(), clang::interp::interp__builtin_memcpy(), and stripBaseCasts().

◆ toAPValue()

APValue Pointer::toAPValue ( const ASTContext & ASTCtx) const

Converts the pointer to an APValue.

Definition at line 250 of file Pointer.cpp.

References clang::APValue, clang::interp::PointerPathEntry::Array, clang::APValue::LValuePathEntry::ArrayIndex(), clang::interp::Descriptor::asDecl(), clang::interp::Descriptor::asExpr(), asFunctionPointer(), asIntPointer(), clang::interp::Descriptor::asValueDecl(), clang::interp::PointerPathEntry::Base, clang::interp::Block, block(), clang::cast(), elemSize(), clang::interp::PointerPathEntry::Field, clang::interp::Fn, clang::CharUnits::fromQuantity(), clang::interp::FunctionPointer::Func, clang::Type::getAsRecordDecl(), clang::ASTContext::getASTRecordLayout(), clang::ASTRecordLayout::getBaseClassOffset(), getByteOffset(), clang::interp::Descriptor::getDataType(), clang::interp::Function::getDecl(), clang::interp::Record::getDecl(), getDeclDesc(), getDeclPtr(), clang::RecordDecl::getDefinition(), clang::APValue::LValueBase::getDynamicAlloc(), clang::interp::Descriptor::getElemQualType(), clang::interp::Function::getExpr(), getFieldDesc(), clang::ASTRecordLayout::getFieldOffset(), getFieldOffset(), clang::APValue::LValueBase::getTypeInfo(), clang::ASTContext::getTypeSizeInChars(), clang::ASTRecordLayout::getVBaseClassOffset(), clang::ASTContext::hasLayout(), clang::interp::Int, isBlockPointer(), isConstexprUnknown(), isDynamic(), isOnePastEnd(), isZero(), isZeroSizeArray(), clang::interp::PointerPathEntry::NegativeArray, Opaque, clang::interp::Opaque, clang::Result, Str, clang::interp::String, clang::ASTContext::toCharUnitsFromBits(), Typeid, clang::interp::Typeid, view(), and clang::CharUnits::Zero().

Referenced by toDiagnosticString(), and toRValue().

◆ toDiagnosticString()

std::string Pointer::toDiagnosticString ( const ASTContext & Ctx) const

Converts the pointer to a string usable in diagnostics.

Definition at line 690 of file Pointer.cpp.

References asIntPointer(), clang::APValue::getAsString(), clang::Type::getPointeeType(), getType(), isIntegralPointer(), clang::Type::isLValueReferenceType(), isZero(), and toAPValue().

Referenced by clang::interp::CmpHelper< Pointer >(), clang::interp::CmpHelperEQ< Pointer >(), clang::interp::interp__builtin_memcpy(), and clang::interp::SubPtr().

◆ toRValue()

std::optional< APValue > Pointer::toRValue ( const Context & Ctx,
QualType ResultType ) const

Converts the pointer to an APValue that is an rvalue.

Definition at line 1268 of file Pointer.cpp.

References canDeref(), clang::interp::Context::classify(), clang::interp::Context::getASTContext(), isBlockPointer(), isDummy(), clang::Type::isFunctionType(), isIntegralPointer(), isLive(), clang::QualType::isNull(), isOnePastEnd(), isPastEnd(), isZero(), isZeroSizeArray(), load(), clang::Result, clang::T, toAPValue(), toRValue(), TYPE_SWITCH, and view().

Referenced by toRValue().

◆ view()

PtrView clang::interp::Pointer::view ( ) const
inline

Definition at line 587 of file Pointer.h.

References BS, and isBlockPointer().

Referenced by activate(), allElementsInitialized(), atField(), atIndex(), clang::interp::Call(), clang::interp::collectBlocks(), computeLayoutOffset(), computeOffsetForComparison(), computeSplitPoint(), deref(), clang::interp::DoMemcpy(), elem(), elemSize(), enumeratePointerFields(), expand(), getArray(), getBase(), getElemRecord(), getIndex(), getLifetime(), getNumElems(), getOffset(), getRecord(), getType(), inArray(), initialize(), initializeElement(), inPrimitiveArray(), clang::interp::interp__builtin_strlen(), inUnion(), isActive(), isArrayElement(), isArrayRoot(), isBaseClass(), isConst(), isDummy(), isElementInitialized(), isField(), isLive(), isMutable(), isOnePastEnd(), isRoot(), isVirtualBaseClass(), load(), loadElem(), narrow(), operator==(), setLifeState(), stripBaseCasts(), toAPValue(), and toRValue().

◆ Block

friend class Block
friend

Definition at line 1299 of file Pointer.h.

References Block.

Referenced by Block, block(), operator=(), operator=(), Pointer(), Pointer(), Pointer(), print(), and ~Pointer().

◆ DeadBlock

friend class DeadBlock
friend

Definition at line 1300 of file Pointer.h.

References DeadBlock.

Referenced by DeadBlock.

◆ DynamicAllocator

friend class DynamicAllocator
friend

Definition at line 1303 of file Pointer.h.

References DynamicAllocator.

Referenced by DynamicAllocator.

◆ InterpState

friend class InterpState
friend

Definition at line 1302 of file Pointer.h.

References InterpState.

Referenced by InterpState.

◆ MemberPointer

friend class MemberPointer
friend

Definition at line 1301 of file Pointer.h.

References MemberPointer.

Referenced by MemberPointer.

◆ Program

friend class Program
friend

Definition at line 1304 of file Pointer.h.

References BS, and Program.

Referenced by Program.

Member Data Documentation

◆ BS

BlockPointer clang::interp::Pointer::BS

Definition at line 1336 of file Pointer.h.

Referenced by allElementsAlive(), asBlockPointer(), atFieldSub(), block(), canBeInitialized(), clang::interp::DeadBlock::DeadBlock(), deref(), elem(), elemsOfSameArray(), getDeclDesc(), getDeclID(), getDeclPtr(), getIntegerRepresentation(), getRawAddress(), inUnion(), isDynamic(), isExtern(), isInitialized(), isOnePastEnd(), isPastEnd(), isStatic(), isTemporary(), isWeak(), isZero(), load(), loadElem(), clang::interp::Block::movePointersTo(), operator=(), operator=(), Pointer(), Pointer(), Pointer(), pointsToLabel(), print(), Program, clang::interp::Block::removePointers(), view(), and ~Pointer().

◆ Fn

FunctionPointer clang::interp::Pointer::Fn

Definition at line 1337 of file Pointer.h.

Referenced by asFunctionPointer(), atIndex(), getIntegerRepresentation(), getSource(), getType(), isWeak(), isZero(), operator=(), operator=(), operator==(), Pointer(), Pointer(), Pointer(), and print().

◆ Int

IntPointer clang::interp::Pointer::Int

Definition at line 1335 of file Pointer.h.

Referenced by asIntPointer(), atIndex(), computeLayoutOffset(), computeOffsetForComparison(), getByteOffset(), getIntegerRepresentation(), getType(), isZero(), operator=(), operator=(), operator==(), Pointer(), Pointer(), Pointer(), Pointer(), Pointer(), and print().

◆ Opaque

OpaquePointer clang::interp::Pointer::Opaque

Definition at line 1340 of file Pointer.h.

Referenced by asOpaquePointer(), computeLayoutOffset(), computeOffsetForComparison(), getRootVarDecl(), getType(), hasSameBase(), isConstexprUnknown(), isOnePastEnd(), isRoot(), isUnknownSizeArray(), isWeak(), operator=(), operator=(), operator==(), Pointer(), Pointer(), Pointer(), Pointer(), print(), and toAPValue().

◆ Str

StringPointer clang::interp::Pointer::Str

Definition at line 1339 of file Pointer.h.

Referenced by asStringPointer(), atIndex(), canDeref(), computeLayoutOffset(), computeOffsetForComparison(), elemSize(), getNumElems(), getRawAddress(), getRootExpr(), getType(), hasSameBase(), isOnePastEnd(), isPastEnd(), load(), loadElem(), operator=(), operator=(), operator==(), Pointer(), Pointer(), Pointer(), Pointer(), print(), and toAPValue().

◆ Typeid

TypeidPointer clang::interp::Pointer::Typeid

Definition at line 1338 of file Pointer.h.

Referenced by asTypeidPointer(), getByteOffset(), getType(), operator=(), operator=(), Pointer(), Pointer(), Pointer(), and toAPValue().

The documentation for this class was generated from the following files:
Generated on for clang by doxygen 1.14.0