LLVM API Documentation

 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Types | Public Member Functions | Static Public Member Functions | List of all members
llvm::StructType Class Reference

#include <DerivedTypes.h>

Inheritance diagram for llvm::StructType:
Inheritance graph
[legend]
Collaboration diagram for llvm::StructType:
Collaboration graph
[legend]

Public Types

typedef Type::subtype_iterator element_iterator
 
- Public Types inherited from llvm::Type
enum  TypeID {
  VoidTyID = 0, HalfTyID, FloatTyID, DoubleTyID,
  X86_FP80TyID, FP128TyID, PPC_FP128TyID, LabelTyID,
  MetadataTyID, X86_MMXTyID, IntegerTyID, FunctionTyID,
  StructTyID, ArrayTyID, PointerTyID, VectorTyID,
  NumTypeIDs, LastPrimitiveTyID = X86_MMXTyID, FirstDerivedTyID = IntegerTyID
}
 
typedef Type *const * subtype_iterator
 
typedef std::reverse_iterator
< subtype_iterator
subtype_reverse_iterator
 

Public Member Functions

 ~StructType ()
 
bool isPacked () const
 
bool isLiteral () const
 
bool isOpaque () const
 
bool isSized () const
 isSized - Return true if this is a sized type. More...
 
bool hasName () const
 hasName - Return true if this is a named struct that has a non-empty name. More...
 
StringRef getName () const
 
void setName (StringRef Name)
 
void setBody (ArrayRef< Type * > Elements, bool isPacked=false)
 setBody - Specify a body for an opaque identified type. More...
 
void setBody (Type *elt1,...) END_WITH_NULL
 
element_iterator element_begin () const
 
element_iterator element_end () const
 
bool isLayoutIdentical (StructType *Other) const
 
unsigned getNumElements () const
 Random access to the elements. More...
 
TypegetElementType (unsigned N) const
 
- Public Member Functions inherited from llvm::CompositeType
TypegetTypeAtIndex (const Value *V)
 
TypegetTypeAtIndex (unsigned Idx)
 
bool indexValid (const Value *V) const
 
bool indexValid (unsigned Idx) const
 
- Public Member Functions inherited from llvm::Type
void print (raw_ostream &O) const
 
void dump () const
 
LLVMContextgetContext () const
 getContext - Return the LLVMContext in which this type was uniqued. More...
 
TypeID getTypeID () const
 
bool isVoidTy () const
 isVoidTy - Return true if this is 'void'. More...
 
bool isHalfTy () const
 isHalfTy - Return true if this is 'half', a 16-bit IEEE fp type. More...
 
bool isFloatTy () const
 isFloatTy - Return true if this is 'float', a 32-bit IEEE fp type. More...
 
bool isDoubleTy () const
 isDoubleTy - Return true if this is 'double', a 64-bit IEEE fp type. More...
 
bool isX86_FP80Ty () const
 isX86_FP80Ty - Return true if this is x86 long double. More...
 
bool isFP128Ty () const
 isFP128Ty - Return true if this is 'fp128'. More...
 
bool isPPC_FP128Ty () const
 isPPC_FP128Ty - Return true if this is powerpc long double. More...
 
bool isFloatingPointTy () const
 
const fltSemanticsgetFltSemantics () const
 
bool isX86_MMXTy () const
 isX86_MMXTy - Return true if this is X86 MMX. More...
 
bool isFPOrFPVectorTy () const
 
bool isLabelTy () const
 isLabelTy - Return true if this is 'label'. More...
 
bool isMetadataTy () const
 isMetadataTy - Return true if this is 'metadata'. More...
 
bool isIntegerTy () const
 
bool isIntegerTy (unsigned Bitwidth) const
 isIntegerTy - Return true if this is an IntegerType of the given width. More...
 
bool isIntOrIntVectorTy () const
 
bool isFunctionTy () const
 
bool isStructTy () const
 
bool isArrayTy () const
 
bool isPointerTy () const
 
bool isPtrOrPtrVectorTy () const
 
bool isVectorTy () const
 
bool canLosslesslyBitCastTo (Type *Ty) const
 Determine if this type could be losslessly bitcast to Ty. More...
 
bool isEmptyTy () const
 
bool isPrimitiveType () const
 
bool isDerivedType () const
 
bool isFirstClassType () const
 
bool isSingleValueType () const
 
bool isAggregateType () const
 
bool isSized () const
 
unsigned getPrimitiveSizeInBits () const
 
unsigned getScalarSizeInBits ()
 
int getFPMantissaWidth () const
 
const TypegetScalarType () const
 
TypegetScalarType ()
 
subtype_iterator subtype_begin () const
 
subtype_iterator subtype_end () const
 
subtype_reverse_iterator subtype_rbegin () const
 
subtype_reverse_iterator subtype_rend () const
 
TypegetContainedType (unsigned i) const
 
unsigned getNumContainedTypes () const
 
unsigned getIntegerBitWidth () const
 
TypegetFunctionParamType (unsigned i) const
 
unsigned getFunctionNumParams () const
 
bool isFunctionVarArg () const
 
StringRef getStructName () const
 
unsigned getStructNumElements () const
 
TypegetStructElementType (unsigned N) const
 
TypegetSequentialElementType () const
 
uint64_t getArrayNumElements () const
 
TypegetArrayElementType () const
 
unsigned getVectorNumElements () const
 
TypegetVectorElementType () const
 
TypegetPointerElementType () const
 
unsigned getPointerAddressSpace () const
 Get the address space of this pointer or pointer vector type. More...
 
PointerTypegetPointerTo (unsigned AddrSpace=0)
 

Static Public Member Functions

static StructTypecreate (LLVMContext &Context, StringRef Name)
 StructType::create - This creates an identified struct. More...
 
static StructTypecreate (LLVMContext &Context)
 
static StructTypecreate (ArrayRef< Type * > Elements, StringRef Name, bool isPacked=false)
 
static StructTypecreate (ArrayRef< Type * > Elements)
 
static StructTypecreate (LLVMContext &Context, ArrayRef< Type * > Elements, StringRef Name, bool isPacked=false)
 
static StructTypecreate (LLVMContext &Context, ArrayRef< Type * > Elements)
 
static StructTypecreate (StringRef Name, Type *elt1,...) END_WITH_NULL
 
static StructTypeget (LLVMContext &Context, ArrayRef< Type * > Elements, bool isPacked=false)
 
static StructTypeget (LLVMContext &Context, bool isPacked=false)
 
static StructTypeget (Type *elt1,...) END_WITH_NULL
 
static bool isValidElementType (Type *ElemTy)
 
static bool classof (const Type *T)
 Methods for support type inquiry through isa, cast, and dyn_cast. More...
 
- Static Public Member Functions inherited from llvm::CompositeType
static bool classof (const Type *T)
 Methods for support type inquiry through isa, cast, and dyn_cast. More...
 
- Static Public Member Functions inherited from llvm::Type
static TypegetPrimitiveType (LLVMContext &C, TypeID IDNumber)
 getPrimitiveType - Return a type based on an identifier. More...
 
static TypegetVoidTy (LLVMContext &C)
 
static TypegetLabelTy (LLVMContext &C)
 
static TypegetHalfTy (LLVMContext &C)
 
static TypegetFloatTy (LLVMContext &C)
 
static TypegetDoubleTy (LLVMContext &C)
 
static TypegetMetadataTy (LLVMContext &C)
 
static TypegetX86_FP80Ty (LLVMContext &C)
 
static TypegetFP128Ty (LLVMContext &C)
 
static TypegetPPC_FP128Ty (LLVMContext &C)
 
static TypegetX86_MMXTy (LLVMContext &C)
 
static IntegerTypegetIntNTy (LLVMContext &C, unsigned N)
 
static IntegerTypegetInt1Ty (LLVMContext &C)
 
static IntegerTypegetInt8Ty (LLVMContext &C)
 
static IntegerTypegetInt16Ty (LLVMContext &C)
 
static IntegerTypegetInt32Ty (LLVMContext &C)
 
static IntegerTypegetInt64Ty (LLVMContext &C)
 
static PointerTypegetHalfPtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetFloatPtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetDoublePtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetX86_FP80PtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetFP128PtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetPPC_FP128PtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetX86_MMXPtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetIntNPtrTy (LLVMContext &C, unsigned N, unsigned AS=0)
 
static PointerTypegetInt1PtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetInt8PtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetInt16PtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetInt32PtrTy (LLVMContext &C, unsigned AS=0)
 
static PointerTypegetInt64PtrTy (LLVMContext &C, unsigned AS=0)
 

Additional Inherited Members

- Protected Member Functions inherited from llvm::CompositeType
 CompositeType (LLVMContext &C, TypeID tid)
 
- Protected Member Functions inherited from llvm::Type
 Type (LLVMContext &C, TypeID tid)
 
 ~Type ()
 
void setTypeID (TypeID ID)
 
unsigned getSubclassData () const
 
void setSubclassData (unsigned val)
 
- Protected Attributes inherited from llvm::Type
unsigned NumContainedTys
 
Type *const * ContainedTys
 

Detailed Description

StructType - Class to represent struct types. There are two different kinds of struct types: Literal structs and Identified structs.

Literal struct types (e.g. { i32, i32 }) are uniqued structurally, and must always have a body when created. You can get one of these by using one of the StructType::get() forms.

Identified structs (e.g. foo or %42) may optionally have a name and are not uniqued. The names for identified structs are managed at the LLVMContext level, so there can only be a single identified struct with a given name in a particular LLVMContext. Identified structs may also optionally be opaque (have no body specified). You get one of these by using one of the StructType::create() forms.

Independent of what kind of struct you have, the body of a struct type are laid out in memory consequtively with the elements directly one after the other (if the struct is packed) or (if not packed) with padding between the elements as defined by DataLayout (which is required to match what the code generator for a target expects).

Definition at line 187 of file DerivedTypes.h.

Member Typedef Documentation

Definition at line 277 of file DerivedTypes.h.

Constructor & Destructor Documentation

llvm::StructType::~StructType ( )
inline

Definition at line 207 of file DerivedTypes.h.

References llvm::Type::ContainedTys.

Member Function Documentation

static bool llvm::StructType::classof ( const Type T)
inlinestatic

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

Definition at line 293 of file DerivedTypes.h.

References llvm::Type::getTypeID(), and llvm::Type::StructTyID.

StructType * StructType::create ( LLVMContext Context,
StringRef  Name 
)
static

StructType::create - This creates an identified struct.

Definition at line 494 of file Type.cpp.

References llvm::StringRef::empty(), llvm::LLVMContext::pImpl, setName(), llvm::A64DB::ST, and llvm::LLVMContextImpl::TypeAllocator.

Referenced by create(), and LLVMStructCreateNamed().

StructType * StructType::create ( LLVMContext Context)
static

Definition at line 529 of file Type.cpp.

References create().

StructType * StructType::create ( ArrayRef< Type * >  Elements,
StringRef  Name,
bool  isPacked = false 
)
static

Definition at line 533 of file Type.cpp.

References create(), llvm::ArrayRef< T >::empty(), and llvm::Type::getContext().

StructType * StructType::create ( ArrayRef< Type * >  Elements)
static

Definition at line 540 of file Type.cpp.

References create(), llvm::ArrayRef< T >::empty(), and llvm::Type::getContext().

StructType * StructType::create ( LLVMContext Context,
ArrayRef< Type * >  Elements,
StringRef  Name,
bool  isPacked = false 
)
static

Definition at line 518 of file Type.cpp.

References create(), setBody(), and llvm::A64DB::ST.

StructType * StructType::create ( LLVMContext Context,
ArrayRef< Type * >  Elements 
)
static

Definition at line 525 of file Type.cpp.

References create().

StructType * StructType::create ( StringRef  Name,
Type elt1,
  ... 
)
static
element_iterator llvm::StructType::element_begin ( ) const
inline
element_iterator llvm::StructType::element_end ( ) const
inline
StructType * StructType::get ( LLVMContext Context,
ArrayRef< Type * >  Elements,
bool  isPacked = false 
)
static
StructType * StructType::get ( LLVMContext Context,
bool  isPacked = false 
)
static

StructType::get - Create an empty structure type.

Definition at line 501 of file Type.cpp.

References isPacked(), and llvm::None.

StructType * StructType::get ( Type elt1,
  ... 
)
static

StructType::get - This static method is a convenience method for creating structure types by specifying the elements as arguments. Note that this method always returns a non-packed struct, and requires at least one element type.

Definition at line 505 of file Type.cpp.

References get(), llvm::Type::getContext(), and llvm::SmallVectorTemplateBase< T, isPodLike< T >::value >::push_back().

Type* llvm::StructType::getElementType ( unsigned  N) const
inline
StringRef StructType::getName ( ) const

getName - Return the name for this struct type if it has an identity. This may return an empty string for an unnamed struct type. Do not call this on an literal type.

Definition at line 580 of file Type.cpp.

References isLiteral().

Referenced by llvm::TypePrinting::incorporateTypes(), llvm::isImageOrSamplerVal(), LLVMGetStructName(), llvm::TypePrinting::print(), setName(), StripTypeNames(), and WriteTypeTable().

unsigned llvm::StructType::getNumElements ( ) const
inline
bool llvm::StructType::hasName ( ) const
inline

hasName - Return true if this is a named struct that has a non-empty name.

Definition at line 255 of file DerivedTypes.h.

Referenced by LLVMGetStructName().

bool StructType::isLayoutIdentical ( StructType Other) const

isLayoutIdentical - Return true if this is layout identical to the specified struct.

Definition at line 606 of file Type.cpp.

References element_begin(), element_end(), llvm::lltok::equal, getNumElements(), and isPacked().

bool llvm::StructType::isLiteral ( ) const
inline

isLiteral - Return true if this type is uniqued by structural equivalence, false if it is a struct definition.

Definition at line 245 of file DerivedTypes.h.

References llvm::Type::getSubclassData().

Referenced by getName(), llvm::TypePrinting::incorporateTypes(), llvm::isImageOrSamplerVal(), llvm::TypePrinting::print(), StripTypeNames(), and WriteTypeTable().

bool llvm::StructType::isOpaque ( ) const
inline

isOpaque - Return true if this is a type with an identity that has no body specified yet. These prints as 'opaque' in .ll files.

Definition at line 249 of file DerivedTypes.h.

References llvm::Type::getSubclassData().

Referenced by llvm::ConstantStruct::ConstantStruct(), llvm::ConstantStruct::get(), isLeakCheckerRoot(), isSized(), setBody(), and WriteTypeTable().

bool llvm::StructType::isPacked ( ) const
inline

Definition at line 241 of file DerivedTypes.h.

References llvm::Type::getSubclassData().

Referenced by get(), getTypePartition(), isLayoutIdentical(), and WriteTypeTable().

bool StructType::isSized ( ) const

isSized - Return true if this is a sized type.

Definition at line 559 of file Type.cpp.

References element_begin(), element_end(), llvm::Type::getSubclassData(), I, isOpaque(), and llvm::Type::setSubclassData().

bool StructType::isValidElementType ( Type ElemTy)
static

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

Definition at line 599 of file Type.cpp.

References llvm::Type::isFunctionTy(), llvm::Type::isLabelTy(), llvm::Type::isMetadataTy(), and llvm::Type::isVoidTy().

void StructType::setBody ( ArrayRef< Type * >  Elements,
bool  isPacked = false 
)
void StructType::setBody ( Type elt1,
  ... 
)
void StructType::setName ( StringRef  Name)

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