Base class of all SIMD vector types. More...

#include "llvm/IR/DerivedTypes.h"

Inheritance diagram for llvm::VectorType:

[legend]

Public Member Functions
	VectorType (const VectorType &)=delete

VectorType &	operator= (const VectorType &)=delete

Type *	getElementType () const

ElementCount	getElementCount () const
	Return an ElementCount instance to represent the (possibly scalable) number of elements in the vector.

Public Member Functions inherited from llvm::Type
void	print (raw_ostream &O, bool IsForDebug=false, bool NoDetails=false) const
	Print the current type.

void	dump () const

LLVMContext &	getContext () const
	Return the LLVMContext in which this type was uniqued.

TypeID	getTypeID () const
	Return the type id for the type.

bool	isVoidTy () const
	Return true if this is 'void'.

bool	isHalfTy () const
	Return true if this is 'half', a 16-bit IEEE fp type.

bool	isBFloatTy () const
	Return true if this is 'bfloat', a 16-bit bfloat type.

bool	is16bitFPTy () const
	Return true if this is a 16-bit float type.

bool	isFloatTy () const
	Return true if this is 'float', a 32-bit IEEE fp type.

bool	isDoubleTy () const
	Return true if this is 'double', a 64-bit IEEE fp type.

bool	isX86_FP80Ty () const
	Return true if this is x86 long double.

bool	isFP128Ty () const
	Return true if this is 'fp128'.

bool	isPPC_FP128Ty () const
	Return true if this is powerpc long double.

bool	isIEEELikeFPTy () const
	Return true if this is a well-behaved IEEE-like type, which has a IEEE compatible layout as defined by APFloat::isIEEE(), and does not have non-IEEE values, such as x86_fp80's unnormal values.

bool	isFloatingPointTy () const
	Return true if this is one of the floating-point types.

bool	isMultiUnitFPType () const
	Returns true if this is a floating-point type that is an unevaluated sum of multiple floating-point units.

const fltSemantics &	getFltSemantics () const

bool	isX86_AMXTy () const
	Return true if this is X86 AMX.

bool	isTargetExtTy () const
	Return true if this is a target extension type.

bool	isScalableTargetExtTy () const
	Return true if this is a target extension type with a scalable layout.

bool	isScalableTy () const
	Return true if this is a type whose size is a known multiple of vscale.

bool	isFPOrFPVectorTy () const
	Return true if this is a FP type or a vector of FP.

bool	isLabelTy () const
	Return true if this is 'label'.

bool	isMetadataTy () const
	Return true if this is 'metadata'.

bool	isTokenTy () const
	Return true if this is 'token'.

bool	isIntegerTy () const
	True if this is an instance of IntegerType.

bool	isIntegerTy (unsigned Bitwidth) const
	Return true if this is an IntegerType of the given width.

bool	isIntOrIntVectorTy () const
	Return true if this is an integer type or a vector of integer types.

bool	isIntOrIntVectorTy (unsigned BitWidth) const
	Return true if this is an integer type or a vector of integer types of the given width.

bool	isIntOrPtrTy () const
	Return true if this is an integer type or a pointer type.

bool	isFunctionTy () const
	True if this is an instance of FunctionType.

bool	isStructTy () const
	True if this is an instance of StructType.

bool	isArrayTy () const
	True if this is an instance of ArrayType.

bool	isPointerTy () const
	True if this is an instance of PointerType.

bool	isOpaquePointerTy () const
	True if this is an instance of an opaque PointerType.

bool	isPtrOrPtrVectorTy () const
	Return true if this is a pointer type or a vector of pointer types.

bool	isVectorTy () const
	True if this is an instance of VectorType.

bool	canLosslesslyBitCastTo (Type *Ty) const
	Return true if this type could be converted with a lossless BitCast to type 'Ty'.

bool	isEmptyTy () const
	Return true if this type is empty, that is, it has no elements or all of its elements are empty.

bool	isFirstClassType () const
	Return true if the type is "first class", meaning it is a valid type for a Value.

bool	isSingleValueType () const
	Return true if the type is a valid type for a register in codegen.

bool	isAggregateType () const
	Return true if the type is an aggregate type.

bool	isSized (SmallPtrSetImpl< Type * > *Visited=nullptr) const
	Return true if it makes sense to take the size of this type.

TypeSize	getPrimitiveSizeInBits () const LLVM_READONLY
	Return the basic size of this type if it is a primitive type.

unsigned	getScalarSizeInBits () const LLVM_READONLY
	If this is a vector type, return the getPrimitiveSizeInBits value for the element type.

int	getFPMantissaWidth () const
	Return the width of the mantissa of this type.

bool	isIEEE () const
	Return whether the type is IEEE compatible, as defined by the eponymous method in APFloat.

Type *	getScalarType () const
	If this is a vector type, return the element type, otherwise return 'this'.

subtype_iterator	subtype_begin () const

subtype_iterator	subtype_end () const

ArrayRef< Type * >	subtypes () const

subtype_reverse_iterator	subtype_rbegin () const

subtype_reverse_iterator	subtype_rend () const

Type *	getContainedType (unsigned i) const
	This method is used to implement the type iterator (defined at the end of the file).

unsigned	getNumContainedTypes () const
	Return the number of types in the derived type.

unsigned	getIntegerBitWidth () const

Type *	getFunctionParamType (unsigned i) const

unsigned	getFunctionNumParams () const

bool	isFunctionVarArg () const

StringRef	getStructName () const

unsigned	getStructNumElements () const

Type *	getStructElementType (unsigned N) const

uint64_t	getArrayNumElements () const

Type *	getArrayElementType () const

StringRef	getTargetExtName () const

Type *	getNonOpaquePointerElementType () const
	Only use this method in code that is not reachable with opaque pointers, or part of deprecated methods that will be removed as part of the opaque pointers transition.

Type *	getWithNewType (Type *EltTy) const
	Given vector type, change the element type, whilst keeping the old number of elements.

Type *	getWithNewBitWidth (unsigned NewBitWidth) const
	Given an integer or vector type, change the lane bitwidth to NewBitwidth, whilst keeping the old number of lanes.

Type *	getExtendedType () const
	Given scalar/vector integer type, returns a type with elements twice as wide as in the original type.

unsigned	getPointerAddressSpace () const
	Get the address space of this pointer or pointer vector type.

PointerType *	getPointerTo (unsigned AddrSpace=0) const
	Return a pointer to the current type.

Static Public Member Functions
static VectorType *	get (Type *ElementType, ElementCount EC)
	This static method is the primary way to construct an VectorType.

static VectorType *	get (Type *ElementType, unsigned NumElements, bool Scalable)

static VectorType *	get (Type ElementType, const VectorType Other)

static VectorType *	getInteger (VectorType *VTy)
	This static method gets a VectorType with the same number of elements as the input type, and the element type is an integer type of the same width as the input element type.

static VectorType *	getExtendedElementVectorType (VectorType *VTy)
	This static method is like getInteger except that the element types are twice as wide as the elements in the input type.

static VectorType *	getTruncatedElementVectorType (VectorType *VTy)

static VectorType *	getSubdividedVectorType (VectorType *VTy, int NumSubdivs)

static VectorType *	getHalfElementsVectorType (VectorType *VTy)
	This static method returns a VectorType with half as many elements as the input type and the same element type.

static VectorType *	getDoubleElementsVectorType (VectorType *VTy)
	This static method returns a VectorType with twice as many elements as the input type and the same element type.

static bool	isValidElementType (Type *ElemTy)
	Return true if the specified type is valid as a element type.

static bool	classof (const Type *T)
	Methods for support type inquiry through isa, cast, and dyn_cast.

Static Public Member Functions inherited from llvm::Type
static Type *	getPrimitiveType (LLVMContext &C, TypeID IDNumber)
	Return a type based on an identifier.

static Type *	getVoidTy (LLVMContext &C)

static Type *	getLabelTy (LLVMContext &C)

static Type *	getHalfTy (LLVMContext &C)

static Type *	getBFloatTy (LLVMContext &C)

static Type *	getFloatTy (LLVMContext &C)

static Type *	getDoubleTy (LLVMContext &C)

static Type *	getMetadataTy (LLVMContext &C)

static Type *	getX86_FP80Ty (LLVMContext &C)

static Type *	getFP128Ty (LLVMContext &C)

static Type *	getPPC_FP128Ty (LLVMContext &C)

static Type *	getX86_AMXTy (LLVMContext &C)

static Type *	getTokenTy (LLVMContext &C)

static IntegerType *	getIntNTy (LLVMContext &C, unsigned N)

static IntegerType *	getInt1Ty (LLVMContext &C)

static IntegerType *	getInt8Ty (LLVMContext &C)

static IntegerType *	getInt16Ty (LLVMContext &C)

static IntegerType *	getInt32Ty (LLVMContext &C)

static IntegerType *	getInt64Ty (LLVMContext &C)

static IntegerType *	getInt128Ty (LLVMContext &C)

template<typename ScalarTy >
static Type *	getScalarTy (LLVMContext &C)

static Type *	getFloatingPointTy (LLVMContext &C, const fltSemantics &S)

static Type *	getWasm_ExternrefTy (LLVMContext &C)

static Type *	getWasm_FuncrefTy (LLVMContext &C)

Protected Member Functions
	VectorType (Type *ElType, unsigned EQ, Type::TypeID TID)

Protected Member Functions inherited from llvm::Type
	Type (LLVMContext &C, TypeID tid)

	~Type ()=default

unsigned	getSubclassData () const

void	setSubclassData (unsigned val)

Protected Attributes
const unsigned	ElementQuantity
	The element quantity of this vector.

Protected Attributes inherited from llvm::Type
unsigned	NumContainedTys = 0
	Keeps track of how many Type*'s there are in the ContainedTys list.

Type const	ContainedTys = nullptr
	A pointer to the array of Types contained by this Type.

Additional Inherited Members
Public Types inherited from llvm::Type
enum	TypeID { HalfTyID = 0 , BFloatTyID , FloatTyID , DoubleTyID , X86_FP80TyID , FP128TyID , PPC_FP128TyID , VoidTyID , LabelTyID , MetadataTyID , X86_AMXTyID , TokenTyID , IntegerTyID , FunctionTyID , PointerTyID , StructTyID , ArrayTyID , FixedVectorTyID , ScalableVectorTyID , TypedPointerTyID , TargetExtTyID }
	Definitions of all of the base types for the Type system. More...

using	subtype_iterator = Type const

using	subtype_reverse_iterator = std::reverse_iterator< subtype_iterator >

Detailed Description

Base class of all SIMD vector types.

Definition at line 403 of file DerivedTypes.h.

Constructor & Destructor Documentation

◆ VectorType() [1/2]

VectorType::VectorType	(	Type *	ElType,
		unsigned	EQ,
		Type::TypeID	TID
	)

protected

Definition at line 657 of file Type.cpp.

References llvm::Type::ContainedTys, and llvm::Type::NumContainedTys.

◆ VectorType() [2/2]

llvm::VectorType::VectorType ( const VectorType & )

delete

Member Function Documentation

◆ classof()

static bool llvm::VectorType::classof ( const Type * T )

inlinestatic

Methods for support type inquiry through isa, cast, and dyn_cast.

Definition at line 532 of file DerivedTypes.h.

References llvm::Type::FixedVectorTyID, and llvm::Type::ScalableVectorTyID.

◆ get() [1/3]

static VectorType * llvm::VectorType::get	(	Type *	ElementType,
		const VectorType *	Other
	)

inlinestatic

Definition at line 447 of file DerivedTypes.h.

References get(), and llvm::Other.

◆ get() [2/3]

VectorType * VectorType::get	(	Type *	ElementType,
		ElementCount	EC
	)

static

This static method is the primary way to construct an VectorType.

Definition at line 664 of file Type.cpp.

References llvm::ScalableVectorType::get(), and llvm::FixedVectorType::get().

◆ get() [3/3]

static VectorType * llvm::VectorType::get	(	Type *	ElementType,
		unsigned	NumElements,
		bool	Scalable
	)

inlinestatic

Definition at line 441 of file DerivedTypes.h.

References llvm::ElementCount::get(), and get().

◆ getDoubleElementsVectorType()

static VectorType * llvm::VectorType::getDoubleElementsVectorType ( VectorType * VTy )

inlinestatic

This static method returns a VectorType with twice as many elements as the input type and the same element type.

Definition at line 517 of file DerivedTypes.h.

References assert(), get(), getElementCount(), and getElementType().

Referenced by llvm::FixedVectorType::getDoubleElementsVectorType(), llvm::ScalableVectorType::getDoubleElementsVectorType(), llvm::X86TTIImpl::getShuffleCost(), getSubdividedVectorType(), and interleaveVectors().

◆ getElementCount()

ElementCount VectorType::getElementCount ( ) const

inline

Return an ElementCount instance to represent the (possibly scalable) number of elements in the vector.

Definition at line 641 of file DerivedTypes.h.

References ElementQuantity, and llvm::ElementCount::get().

Referenced by llvm::SelectInst::areInvalidOperands(), llvm::AArch64TargetLowering::createComplexDeinterleavingIR(), llvm::VPReductionRecipe::execute(), llvm::Constant::getAllOnesValue(), llvm::TargetTransformInfo::getArithmeticInstrCost(), getDoubleElementsVectorType(), llvm::EVT::getEVT(), getExtendedElementVectorType(), getHalfElementsVectorType(), getInteger(), llvm::AArch64TargetLowering::getNumInterleavedAccesses(), llvm::SPIRVGlobalRegistry::getOrCreateConsIntVector(), llvm::SPIRVGlobalRegistry::getOrCreateConstVector(), llvm::AArch64TTIImpl::getShuffleCost(), llvm::RISCVTTIImpl::getShuffleCost(), llvm::X86TTIImpl::getShuffleCost(), llvm::AArch64TTIImpl::getSpliceCost(), getTruncatedElementVectorType(), llvm::DataLayout::getTypeSizeInBits(), llvm::MVT::getVT(), llvm::BasicTTIImplBase< T >::improveShuffleKindFromMask(), llvm::AArch64TargetLowering::isLegalInterleavedAccessType(), llvm::AArch64TargetLowering::lowerDeinterleaveIntrinsicToLoad(), llvm::AArch64TargetLowering::lowerInterleaveIntrinsicToStore(), llvm::PatternMatch::ElementWiseBitCast_match< Op_t >::match(), llvm::fuzzerop::matchFirstLengthWAnyType(), promoteAllocaUserToVector(), llvm::InstCombinerImpl::visitCallInst(), and llvm::InstCombinerImpl::visitExtractElementInst().

◆ getElementType()

Type * llvm::VectorType::getElementType ( ) const

inline

Definition at line 436 of file DerivedTypes.h.

Referenced by CheckAndCreateOffsetAdd(), llvm::ConstantFoldCastInstruction(), llvm::AArch64TargetLowering::createComplexDeinterleavingIR(), createTblShuffleForSExt(), createTblShuffleForZExt(), emitGlobalConstantVector(), llvm::VPReductionRecipe::execute(), llvm::findScalarElement(), foldConstantInsEltIntoShuffle(), foldSelectShuffleWith1Binop(), llvm::Constant::getAllOnesValue(), llvm::AArch64TTIImpl::getArithmeticReductionCost(), llvm::RISCVTTIImpl::getArithmeticReductionCost(), llvm::ARMTTIImpl::getArithmeticReductionCost(), getDoubleElementsVectorType(), llvm::EVT::getEVT(), getExtendedElementVectorType(), llvm::BasicTTIImplBase< T >::getExtractWithExtendCost(), llvm::AArch64TTIImpl::getExtractWithExtendCost(), getHalfElementsVectorType(), getInteger(), llvm::X86TTIImpl::getInterleavedMemoryOpCostAVX512(), llvm::HexagonTTIImpl::getMemoryOpCost(), llvm::BasicTTIImplBase< T >::getMinMaxReductionCost(), llvm::ARMTTIImpl::getMinMaxReductionCost(), llvm::RISCVTTIImpl::getMinMaxReductionCost(), llvm::AArch64TargetLowering::getNumInterleavedAccesses(), llvm::SPIRVGlobalRegistry::getOrCreateConsIntVector(), llvm::SPIRVGlobalRegistry::getOrCreateConstVector(), llvm::BasicTTIImplBase< T >::getOrderedReductionCost(), llvm::AArch64TTIImpl::getScalarizationOverhead(), llvm::X86TTIImpl::getScalarizationOverhead(), llvm::AArch64TTIImpl::getShuffleCost(), llvm::GCNTTIImpl::getShuffleCost(), llvm::RISCVTTIImpl::getShuffleCost(), llvm::X86TTIImpl::getShuffleCost(), getSVEContainerIRType(), llvm::BasicTTIImplBase< T >::getTreeReductionCost(), getTruncatedElementVectorType(), llvm::DataLayout::getTypeSizeInBits(), llvm::SelectionDAGBuilder::getValueImpl(), llvm::MVT::getVT(), llvm::BasicTTIImplBase< T >::improveShuffleKindFromMask(), llvm::ARMTargetLowering::isLegalInterleavedAccessType(), llvm::AArch64TargetLowering::isLegalInterleavedAccessType(), isSupportedAccessType(), isV2BF16(), isV2F16(), llvm::AArch64TargetLowering::lowerDeinterleaveIntrinsicToLoad(), lowerFunnelShifts(), llvm::AArch64TargetLowering::lowerInterleavedLoad(), llvm::ARMTargetLowering::lowerInterleavedLoad(), llvm::AArch64TargetLowering::lowerInterleaveIntrinsicToStore(), matchIntrinsicType(), promoteAllocaUserToVector(), llvm::X86TargetLowering::shouldSinkOperands(), llvm::Interpreter::visitInsertElementInst(), and llvm::Interpreter::visitShuffleVectorInst().

◆ getExtendedElementVectorType()

static VectorType * llvm::VectorType::getExtendedElementVectorType ( VectorType * VTy )

inlinestatic

This static method is like getInteger except that the element types are twice as wide as the elements in the input type.

Definition at line 463 of file DerivedTypes.h.

References assert(), get(), getElementCount(), getElementType(), and llvm::Type::isIntOrIntVectorTy().

Referenced by DecodeFixedType(), llvm::X86TTIImpl::getArithmeticInstrCost(), llvm::FixedVectorType::getExtendedElementVectorType(), llvm::ScalableVectorType::getExtendedElementVectorType(), and matchIntrinsicType().

◆ getHalfElementsVectorType()

static VectorType * llvm::VectorType::getHalfElementsVectorType ( VectorType * VTy )

inlinestatic

This static method returns a VectorType with half as many elements as the input type and the same element type.

Definition at line 507 of file DerivedTypes.h.

References assert(), get(), getElementCount(), and getElementType().

Referenced by llvm::AArch64TargetLowering::createComplexDeinterleavingIR(), DecodeFixedType(), llvm::BasicTTIImplBase< T >::getCastInstrCost(), llvm::FixedVectorType::getHalfElementsVectorType(), llvm::ScalableVectorType::getHalfElementsVectorType(), and matchIntrinsicType().

◆ getInteger()

static VectorType * llvm::VectorType::getInteger ( VectorType * VTy )

inlinestatic

This static method gets a VectorType with the same number of elements as the input type, and the element type is an integer type of the same width as the input element type.

Definition at line 454 of file DerivedTypes.h.

References assert(), llvm::IntegerType::get(), get(), llvm::Type::getContext(), getElementCount(), getElementType(), and llvm::Type::getPrimitiveSizeInBits().

Referenced by DecodeFixedType(), llvm::FixedVectorType::getInteger(), llvm::ScalableVectorType::getInteger(), llvm::Constant::isElementWiseEqual(), matchIntrinsicType(), and llvm::AArch64TargetLowering::optimizeExtendOrTruncateConversion().

◆ getSubdividedVectorType()

static VectorType * llvm::VectorType::getSubdividedVectorType	(	VectorType *	VTy,
		int	NumSubdivs
	)

inlinestatic

Definition at line 497 of file DerivedTypes.h.

References getDoubleElementsVectorType(), and getTruncatedElementVectorType().

Referenced by DecodeFixedType(), llvm::FixedVectorType::getSubdividedVectorType(), llvm::ScalableVectorType::getSubdividedVectorType(), and matchIntrinsicType().

◆ getTruncatedElementVectorType()

static VectorType * llvm::VectorType::getTruncatedElementVectorType ( VectorType * VTy )

inlinestatic

◆ isValidElementType()

bool VectorType::isValidElementType ( Type * ElemTy )

static

Return true if the specified type is valid as a element type.

Definition at line 671 of file Type.cpp.

References llvm::Type::getTypeID(), llvm::Type::isFloatingPointTy(), llvm::Type::isIntegerTy(), llvm::Type::isPointerTy(), and llvm::Type::TypedPointerTyID.

Referenced by llvm::LoopVectorizationCostModel::calculateRegisterUsage(), canonicalizeBitCastExtElt(), combineTargetShuffle(), llvm::ScalableVectorType::get(), llvm::FixedVectorType::get(), llvm::fuzzerop::matchFirstLengthWAnyType(), and llvm::InstCombinerImpl::visitShuffleVectorInst().

◆ operator=()

VectorType & llvm::VectorType::operator= ( const VectorType & )

delete

Member Data Documentation

◆ ElementQuantity

const unsigned llvm::VectorType::ElementQuantity

protected

The element quantity of this vector.

The meaning of this value depends on the type of vector:

For FixedVectorType = <ElementQuantity x ty>, there are exactly ElementQuantity elements in this vector.
For ScalableVectorType = <vscale x ElementQuantity x ty>, there are vscale * ElementQuantity elements in this vector, where vscale is a runtime-constant integer greater than 0.

Definition at line 428 of file DerivedTypes.h.

Referenced by getElementCount(), llvm::ScalableVectorType::getMinNumElements(), and llvm::FixedVectorType::getNumElements().

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

include/llvm/IR/DerivedTypes.h
lib/IR/Type.cpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ VectorType() [1/2]

◆ VectorType() [2/2]

Member Function Documentation

◆ classof()

◆ get() [1/3]

◆ get() [2/3]

◆ get() [3/3]

◆ getDoubleElementsVectorType()

◆ getElementCount()

◆ getElementType()

◆ getExtendedElementVectorType()

◆ getHalfElementsVectorType()

◆ getInteger()

◆ getSubdividedVectorType()

◆ getTruncatedElementVectorType()

◆ isValidElementType()

◆ operator=()

Member Data Documentation

◆ ElementQuantity