LLVM API Documentation

Public Member Functions | Static Public Member Functions | Protected Member Functions
llvm::GetElementPtrInst Class Reference

#include <Instructions.h>

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

List of all members.

Public Member Functions

 DECLARE_TRANSPARENT_OPERAND_ACCESSORS (Value)
 Transparently provide more efficient getOperand methods.
SequentialTypegetType () const
unsigned getAddressSpace () const
 Returns the address space of this instruction's pointer type.
op_iterator idx_begin ()
const_op_iterator idx_begin () const
op_iterator idx_end ()
const_op_iterator idx_end () const
ValuegetPointerOperand ()
const ValuegetPointerOperand () const
TypegetPointerOperandType () const
unsigned getPointerAddressSpace () const
 Returns the address space of the pointer operand.
unsigned getNumIndices () const
bool hasIndices () const
bool hasAllZeroIndices () const
bool hasAllConstantIndices () const
void setIsInBounds (bool b=true)
bool isInBounds () const
 isInBounds - Determine whether the GEP has the inbounds flag.
bool accumulateConstantOffset (const DataLayout &DL, APInt &Offset) const
 Accumulate the constant address offset of this GEP if possible.

Static Public Member Functions

static GetElementPtrInstCreate (Value *Ptr, ArrayRef< Value * > IdxList, const Twine &NameStr="", Instruction *InsertBefore=nullptr)
static GetElementPtrInstCreate (Value *Ptr, ArrayRef< Value * > IdxList, const Twine &NameStr, BasicBlock *InsertAtEnd)
static GetElementPtrInstCreateInBounds (Value *Ptr, ArrayRef< Value * > IdxList, const Twine &NameStr="", Instruction *InsertBefore=nullptr)
static GetElementPtrInstCreateInBounds (Value *Ptr, ArrayRef< Value * > IdxList, const Twine &NameStr, BasicBlock *InsertAtEnd)
static TypegetIndexedType (Type *Ptr, ArrayRef< Value * > IdxList)
static TypegetIndexedType (Type *Ptr, ArrayRef< Constant * > IdxList)
static TypegetIndexedType (Type *Ptr, ArrayRef< uint64_t > IdxList)
static unsigned getPointerOperandIndex ()
static TypegetGEPReturnType (Value *Ptr, ArrayRef< Value * > IdxList)
static bool classof (const Instruction *I)
static bool classof (const Value *V)
 Methods for support type inquiry through isa, cast, and dyn_cast:

Protected Member Functions

GetElementPtrInstclone_impl () const override

Detailed Description

GetElementPtrInst - an instruction for type-safe pointer arithmetic to access elements of arrays and structs

Definition at line 775 of file Instructions.h.


Member Function Documentation

Accumulate the constant address offset of this GEP if possible.

This routine accepts an APInt into which it will accumulate the constant offset of this GEP if the GEP is in fact constant. If the GEP is not all-constant, it returns false and the value of the offset APInt is undefined (it is *not* preserved!). The APInt passed into this routine must be at least as wide as the IntPtr type for the address space of the base GEP pointer.

Definition at line 1443 of file Instructions.cpp.

Referenced by llvm::detail::PtrUseVisitorBase::adjustOffsetForGEP(), and llvm::InstCombiner::visitGetElementPtrInst().

static bool llvm::GetElementPtrInst::classof ( const Instruction I) [inline, static]

Definition at line 929 of file Instructions.h.

References llvm::Instruction::getOpcode().

Referenced by classof().

static bool llvm::GetElementPtrInst::classof ( const Value V) [inline, static]

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

Reimplemented from llvm::Instruction.

Definition at line 932 of file Instructions.h.

References classof().

GetElementPtrInst * GetElementPtrInst::clone_impl ( ) const [override, protected, virtual]

Implements llvm::Instruction.

Definition at line 3579 of file Instructions.cpp.

References llvm::User::getNumOperands().

static GetElementPtrInst* llvm::GetElementPtrInst::Create ( Value Ptr,
ArrayRef< Value * >  IdxList,
const Twine NameStr = "",
Instruction InsertBefore = nullptr 
) [inline, static]
static GetElementPtrInst* llvm::GetElementPtrInst::Create ( Value Ptr,
ArrayRef< Value * >  IdxList,
const Twine NameStr,
BasicBlock InsertAtEnd 
) [inline, static]

Definition at line 799 of file Instructions.h.

References llvm::ArrayRef< T >::size().

static GetElementPtrInst* llvm::GetElementPtrInst::CreateInBounds ( Value Ptr,
ArrayRef< Value * >  IdxList,
const Twine NameStr = "",
Instruction InsertBefore = nullptr 
) [inline, static]
static GetElementPtrInst* llvm::GetElementPtrInst::CreateInBounds ( Value Ptr,
ArrayRef< Value * >  IdxList,
const Twine NameStr,
BasicBlock InsertAtEnd 
) [inline, static]

Definition at line 817 of file Instructions.h.

References Create(), and setIsInBounds().

Transparently provide more efficient getOperand methods.

Returns the address space of this instruction's pointer type.

Definition at line 835 of file Instructions.h.

References getPointerAddressSpace().

Referenced by llvm::InstCombiner::visitGetElementPtrInst().

static Type* llvm::GetElementPtrInst::getGEPReturnType ( Value Ptr,
ArrayRef< Value * >  IdxList 
) [inline, static]

GetGEPReturnType - Returns the pointer type returned by the GEP instruction, which may be a vector of pointers.

Definition at line 879 of file Instructions.h.

References llvm::checkGEPType(), llvm::VectorType::get(), llvm::PointerType::get(), getIndexedType(), llvm::Type::getPointerAddressSpace(), llvm::Value::getType(), and llvm::Type::isVectorTy().

Type * GetElementPtrInst::getIndexedType ( Type Ptr,
ArrayRef< Value * >  IdxList 
) [static]

getIndexedType - Returns the type of the element that would be loaded with a load instruction with the specified parameters.

Null is returned if the indices are invalid for the specified pointer type.

Definition at line 1397 of file Instructions.cpp.

References getIndexedTypeInternal().

Referenced by CastGEPIndices(), ConstantFoldGetElementPtrImpl(), getGEPReturnType(), llvm::ConstantExpr::getGetElementPtr(), and SimplifyGEPInst().

Type * GetElementPtrInst::getIndexedType ( Type Ptr,
ArrayRef< Constant * >  IdxList 
) [static]

Definition at line 1401 of file Instructions.cpp.

References getIndexedTypeInternal().

Type * GetElementPtrInst::getIndexedType ( Type Ptr,
ArrayRef< uint64_t >  IdxList 
) [static]

Definition at line 1406 of file Instructions.cpp.

References getIndexedTypeInternal().

Definition at line 893 of file Instructions.h.

References llvm::User::getNumOperands().

Referenced by llvm::InstCombiner::visitGetElementPtrInst().

Returns the address space of the pointer operand.

Definition at line 873 of file Instructions.h.

References llvm::Type::getPointerAddressSpace(), and getPointerOperandType().

Referenced by getAddressSpace(), and llvm::InstCombiner::visitGetElementPtrInst().

Definition at line 859 of file Instructions.h.

References llvm::User::getOperand().

Definition at line 862 of file Instructions.h.

getPointerOperandType - Method to return the pointer operand as a PointerType.

Definition at line 868 of file Instructions.h.

References getPointerOperand(), and llvm::Value::getType().

Referenced by getPointerAddressSpace(), and llvm::InstCombiner::visitGetElementPtrInst().

All values are typed, get the type of this value.

Reimplemented from llvm::Value.

Definition at line 830 of file Instructions.h.

Referenced by llvm::InstCombiner::FoldCmpLoadFromIndexedGlobal(), getGEPInductionOperand(), and llvm::InstCombiner::visitGetElementPtrInst().

hasAllConstantIndices - Return true if all of the indices of this GEP are constant integers. If so, the result pointer and the first operand have a constant offset between them.

Definition at line 1427 of file Instructions.cpp.

References llvm::User::getNumOperands(), and llvm::User::getOperand().

Referenced by isSafeAndProfitableToSinkLoad().

hasAllZeroIndices - Return true if all of the indices of this GEP are zeros. If so, the result pointer and the first operand have the same value, just potentially different types.

Definition at line 1413 of file Instructions.cpp.

References llvm::User::getNumOperands(), and llvm::User::getOperand().

Definition at line 897 of file Instructions.h.

References llvm::User::getNumOperands().

Definition at line 851 of file Instructions.h.

References llvm::User::op_begin().

Referenced by llvm::InstCombiner::visitGetElementPtrInst().

Definition at line 852 of file Instructions.h.

References llvm::User::op_begin().

Definition at line 853 of file Instructions.h.

References llvm::User::op_end().

Referenced by llvm::InstCombiner::visitGetElementPtrInst().

Definition at line 854 of file Instructions.h.

References llvm::User::op_end().

isInBounds - Determine whether the GEP has the inbounds flag.

Definition at line 1439 of file Instructions.cpp.

Referenced by llvm::InstCombiner::FoldCmpLoadFromIndexedGlobal(), and llvm::InstCombiner::visitGetElementPtrInst().

setIsInBounds - Set or clear the inbounds flag on this GEP instruction. See LangRef.html for the meaning of inbounds on a getelementptr.

Definition at line 1435 of file Instructions.cpp.

Referenced by BuildNew(), and CreateInBounds().


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