LLVM 22.0.0git
llvm::sandboxir::ConstantDataSequential Class Reference

ConstantDataSequential - A vector or array constant whose element type is a simple 1/2/4/8-byte integer or half/bfloat/float/double, and whose elements are just simple data values (i.e. More...

#include "llvm/SandboxIR/Constant.h"

Inheritance diagram for llvm::sandboxir::ConstantDataSequential:
[legend]

Public Member Functions

uint64_t getElementAsInteger (unsigned ElmIdx) const
 If this is a sequential container of integers (of any size), return the specified element in the low bits of a uint64_t.
APInt getElementAsAPInt (unsigned ElmIdx) const
 If this is a sequential container of integers (of any size), return the specified element as an APInt.
APFloat getElementAsAPFloat (unsigned ElmIdx) const
 If this is a sequential container of floating point type, return the specified element as an APFloat.
float getElementAsFloat (unsigned ElmIdx) const
 If this is an sequential container of floats, return the specified element as a float.
double getElementAsDouble (unsigned ElmIdx) const
 If this is an sequential container of doubles, return the specified element as a double.
ConstantgetElementAsConstant (unsigned ElmIdx) const
 Return a Constant for a specified index's element.
TypegetElementType () const
 Return the element type of the array/vector.
unsigned getNumElements () const
 Return the number of elements in the array or vector.
uint64_t getElementByteSize () const
 Return the size (in bytes) of each element in the array/vector.
bool isString (unsigned CharSize=8) const
 This method returns true if this is an array of CharSize integers.
bool isCString () const
 This method returns true if the array "isString", ends with a null byte, and does not contains any other null bytes.
StringRef getAsString () const
 If this array is isString(), then this method returns the array as a StringRef.
StringRef getAsCString () const
 If this array is isCString(), then this method returns the array (without the trailing null byte) as a StringRef.
StringRef getRawDataValues () const
 Return the raw, underlying, bytes of this data.
Public Member Functions inherited from llvm::sandboxir::Constant
sandboxir::ContextgetParent () const
unsigned getUseOperandNo (const Use &Use) const override
 \Returns the operand index of Use.
void verify () const override
 Should crash if there is something wrong with the instruction.
void dumpOS (raw_ostream &OS) const override
Public Member Functions inherited from llvm::sandboxir::User
virtual op_iterator op_begin ()
virtual op_iterator op_end ()
virtual const_op_iterator op_begin () const
virtual const_op_iterator op_end () const
op_range operands ()
const_op_range operands () const
ValuegetOperand (unsigned OpIdx) const
Use getOperandUse (unsigned OpIdx) const
 \Returns the operand edge for OpIdx.
virtual unsigned getNumOperands () const
virtual void setOperand (unsigned OperandIdx, Value *Operand)
bool replaceUsesOfWith (Value *FromV, Value *ToV)
 Replaces any operands that match FromV with ToV.
void verify () const override
 Should crash if there is something wrong with the instruction.
void dumpCommonHeader (raw_ostream &OS) const final
void dumpOS (raw_ostream &OS) const override
Public Member Functions inherited from llvm::sandboxir::Value
virtual ~Value ()=default
ClassID getSubclassID () const
LLVM_ABI use_iterator use_begin ()
const_use_iterator use_begin () const
use_iterator use_end ()
const_use_iterator use_end () const
iterator_range< use_iteratoruses ()
iterator_range< const_use_iteratoruses () const
LLVM_ABI user_iterator user_begin ()
user_iterator user_end ()
const_user_iterator user_begin () const
const_user_iterator user_end () const
iterator_range< user_iteratorusers ()
iterator_range< const_user_iteratorusers () const
LLVM_ABI unsigned getNumUses () const
 \Returns the number of user edges (not necessarily to unique users).
bool hasNUsesOrMore (unsigned Num) const
 Return true if this value has N uses or more.
bool hasNUses (unsigned Num) const
 Return true if this Value has exactly N uses.
LLVM_ABI TypegetType () const
ContextgetContext () const
LLVM_ABI void replaceUsesWithIf (Value *OtherV, llvm::function_ref< bool(const Use &)> ShouldReplace)
LLVM_ABI void replaceAllUsesWith (Value *Other)
StringRef getName () const
 \Returns the LLVM IR name of the bottom-most LLVM value.
std::string getUid () const
 Returns the unique id in the form 'SB<number>.' like 'SB1.'.
void dumpCommonFooter (raw_ostream &OS) const
void dumpCommonPrefix (raw_ostream &OS) const
void dumpCommonSuffix (raw_ostream &OS) const
void printAsOperandCommon (raw_ostream &OS) const
LLVM_DUMP_METHOD void dump () const

Static Public Member Functions

static bool isElementTypeCompatible (Type *Ty)
 Return true if a ConstantDataSequential can be formed with a vector or array of the specified element type.
static bool classof (const Value *From)
Static Public Member Functions inherited from llvm::sandboxir::Constant
static bool classof (const sandboxir::Value *From)
 For isa/dyn_cast.
Static Public Member Functions inherited from llvm::sandboxir::User
static bool classof (const Value *From)
 For isa/dyn_cast.

Protected Member Functions

 ConstantDataSequential (ClassID ID, llvm::ConstantDataSequential *C, Context &Ctx)
Protected Member Functions inherited from llvm::sandboxir::Constant
 Constant (llvm::Constant *C, sandboxir::Context &SBCtx)
 Constant (ClassID ID, llvm::Constant *C, sandboxir::Context &SBCtx)
Use getOperandUseInternal (unsigned OpIdx, bool Verify) const override
 \Returns the Use for the OpIdx'th operand.
Protected Member Functions inherited from llvm::sandboxir::User
 User (ClassID ID, llvm::Value *V, Context &Ctx)
Use getOperandUseDefault (unsigned OpIdx, bool Verify) const
 \Returns the Use edge that corresponds to OpIdx.
unsigned getUseOperandNoDefault (const Use &Use) const
 The default implementation works only for single-LLVMIR-instruction Users and only if they match exactly the LLVM instruction.
void swapOperandsInternal (unsigned OpIdxA, unsigned OpIdxB)
void verifyUserOfLLVMUse (const llvm::Use &Use) const
Protected Member Functions inherited from llvm::sandboxir::Value
void clearValue ()
LLVM_ABI Value (ClassID SubclassID, llvm::Value *Val, Context &Ctx)
 Value (const Value &)=delete
 Disable copies.
Valueoperator= (const Value &)=delete

Additional Inherited Members

Public Types inherited from llvm::sandboxir::User
using op_iterator = OperandUseIterator
using const_op_iterator = OperandUseIterator
using op_range = iterator_range<op_iterator>
using const_op_range = iterator_range<const_op_iterator>
Public Types inherited from llvm::sandboxir::Value
enum class  ClassID : unsigned
using use_iterator = UserUseIterator
using const_use_iterator = UserUseIterator
using user_iterator = mapped_iterator<sandboxir::UserUseIterator, UseToUser>
using const_user_iterator = user_iterator
Static Protected Member Functions inherited from llvm::sandboxir::Value
static const chargetSubclassIDStr (ClassID ID)
Protected Attributes inherited from llvm::sandboxir::Value
ClassID SubclassID
 For isa/dyn_cast.
unsigned UID
 A unique ID used for forming the name (used for debugging).
llvm::ValueVal = nullptr
 The LLVM Value that corresponds to this SandboxIR Value.
ContextCtx
 All values point to the context.

Detailed Description

ConstantDataSequential - A vector or array constant whose element type is a simple 1/2/4/8-byte integer or half/bfloat/float/double, and whose elements are just simple data values (i.e.

ConstantInt/ConstantFP). This Constant node has no operands because it stores all of the elements of the constant as densely packed data, instead of as Value*'s.

This is the common base class of ConstantDataArray and ConstantDataVector.

Definition at line 498 of file Constant.h.

Constructor & Destructor Documentation

◆ ConstantDataSequential()

llvm::sandboxir::ConstantDataSequential::ConstantDataSequential ( ClassID ID,
llvm::ConstantDataSequential * C,
Context & Ctx )
inlineprotected

Member Function Documentation

◆ classof()

bool llvm::sandboxir::ConstantDataSequential::classof ( const Value * From)
inlinestatic

Definition at line 584 of file Constant.h.

References llvm::sandboxir::Value::getSubclassID().

◆ getAsCString()

StringRef llvm::sandboxir::ConstantDataSequential::getAsCString ( ) const
inline

If this array is isCString(), then this method returns the array (without the trailing null byte) as a StringRef.

Otherwise, it asserts out.

Definition at line 574 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ getAsString()

StringRef llvm::sandboxir::ConstantDataSequential::getAsString ( ) const
inline

If this array is isString(), then this method returns the array as a StringRef.

Otherwise, it asserts out.

Definition at line 569 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ getElementAsAPFloat()

APFloat llvm::sandboxir::ConstantDataSequential::getElementAsAPFloat ( unsigned ElmIdx) const
inline

If this is a sequential container of floating point type, return the specified element as an APFloat.

Definition at line 524 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ getElementAsAPInt()

APInt llvm::sandboxir::ConstantDataSequential::getElementAsAPInt ( unsigned ElmIdx) const
inline

If this is a sequential container of integers (of any size), return the specified element as an APInt.

Definition at line 519 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ getElementAsConstant()

Constant * llvm::sandboxir::ConstantDataSequential::getElementAsConstant ( unsigned ElmIdx) const
inline

Return a Constant for a specified index's element.

Note that this has to compute a new constant to return, so it isn't as efficient as getElementAsInteger/Float/Double.

Definition at line 540 of file Constant.h.

References llvm::cast(), llvm::sandboxir::Constant::Constant(), llvm::sandboxir::Value::Ctx, getElementAsConstant(), and llvm::sandboxir::Value::Val.

Referenced by getElementAsConstant().

◆ getElementAsDouble()

double llvm::sandboxir::ConstantDataSequential::getElementAsDouble ( unsigned ElmIdx) const
inline

If this is an sequential container of doubles, return the specified element as a double.

Definition at line 534 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ getElementAsFloat()

float llvm::sandboxir::ConstantDataSequential::getElementAsFloat ( unsigned ElmIdx) const
inline

If this is an sequential container of floats, return the specified element as a float.

Definition at line 529 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ getElementAsInteger()

uint64_t llvm::sandboxir::ConstantDataSequential::getElementAsInteger ( unsigned ElmIdx) const
inline

If this is a sequential container of integers (of any size), return the specified element in the low bits of a uint64_t.

Definition at line 514 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ getElementByteSize()

uint64_t llvm::sandboxir::ConstantDataSequential::getElementByteSize ( ) const
inline

Return the size (in bytes) of each element in the array/vector.

The size of the elements is known to be a multiple of one byte.

Definition at line 555 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ getElementType()

Type * llvm::sandboxir::ConstantDataSequential::getElementType ( ) const
inline

Return the element type of the array/vector.

Definition at line 545 of file Constant.h.

References llvm::cast(), llvm::sandboxir::Value::Ctx, getElementType(), and llvm::sandboxir::Value::Val.

Referenced by getElementType().

◆ getNumElements()

unsigned llvm::sandboxir::ConstantDataSequential::getNumElements ( ) const
inline

Return the number of elements in the array or vector.

Definition at line 550 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ getRawDataValues()

StringRef llvm::sandboxir::ConstantDataSequential::getRawDataValues ( ) const
inline

Return the raw, underlying, bytes of this data.

Note that this is an extremely tricky thing to work with, as it exposes the host endianness of the data elements.

Definition at line 580 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ isCString()

bool llvm::sandboxir::ConstantDataSequential::isCString ( ) const
inline

This method returns true if the array "isString", ends with a null byte, and does not contains any other null bytes.

Definition at line 564 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.

◆ isElementTypeCompatible()

bool llvm::sandboxir::ConstantDataSequential::isElementTypeCompatible ( Type * Ty)
inlinestatic

Return true if a ConstantDataSequential can be formed with a vector or array of the specified element type.

ConstantDataArray only works with normal float and int types that are stored densely in memory, not with things like i42 or x86_f80.

Definition at line 509 of file Constant.h.

References llvm::ConstantDataSequential::isElementTypeCompatible().

◆ isString()

bool llvm::sandboxir::ConstantDataSequential::isString ( unsigned CharSize = 8) const
inline

This method returns true if this is an array of CharSize integers.

Definition at line 559 of file Constant.h.

References llvm::cast(), and llvm::sandboxir::Value::Val.


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