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 791 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 945 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 948 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 815 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 833 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 851 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 895 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 909 of file Instructions.h.

References llvm::User::getNumOperands().

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

Returns the address space of the pointer operand.

Definition at line 889 of file Instructions.h.

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

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

Definition at line 875 of file Instructions.h.

References llvm::User::getOperand().

Definition at line 878 of file Instructions.h.

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

Definition at line 884 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 846 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 913 of file Instructions.h.

References llvm::User::getNumOperands().

Definition at line 867 of file Instructions.h.

References llvm::User::op_begin().

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

Definition at line 868 of file Instructions.h.

References llvm::User::op_begin().

Definition at line 869 of file Instructions.h.

References llvm::User::op_end().

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

Definition at line 870 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: