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
 All values are typed, get the type of this value.
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 789 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 1441 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 943 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 946 of file Instructions.h.

References classof().

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

Implements llvm::Instruction.

Definition at line 3633 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 813 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 831 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 849 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 893 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 1395 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 1399 of file Instructions.cpp.

References getIndexedTypeInternal().

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

Definition at line 1404 of file Instructions.cpp.

References getIndexedTypeInternal().

Definition at line 907 of file Instructions.h.

References llvm::User::getNumOperands().

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

Returns the address space of the pointer operand.

Definition at line 887 of file Instructions.h.

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

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

Definition at line 873 of file Instructions.h.

References llvm::User::getOperand().

Definition at line 876 of file Instructions.h.

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

Definition at line 882 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 844 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 1425 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 1411 of file Instructions.cpp.

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

Definition at line 911 of file Instructions.h.

References llvm::User::getNumOperands().

Definition at line 865 of file Instructions.h.

References llvm::User::op_begin().

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

Definition at line 866 of file Instructions.h.

References llvm::User::op_begin().

Definition at line 867 of file Instructions.h.

References llvm::User::op_end().

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

Definition at line 868 of file Instructions.h.

References llvm::User::op_end().

isInBounds - Determine whether the GEP has the inbounds flag.

Definition at line 1437 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 1433 of file Instructions.cpp.

Referenced by BuildNew(), and CreateInBounds().


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