This class represents a range of values. More...

#include "llvm/IR/ConstantRange.h"

Public Types
enum	PreferredRangeType { Smallest, Unsigned, Signed }
	If represented precisely, the result of some range operations may consist of multiple disjoint ranges. More...

enum	OverflowResult { OverflowResult::AlwaysOverflowsLow, OverflowResult::AlwaysOverflowsHigh, OverflowResult::MayOverflow, OverflowResult::NeverOverflows }
	Represents whether an operation on the given constant range is known to always or never overflow. More...

Public Member Functions
	ConstantRange (uint32_t BitWidth, bool isFullSet)
	Initialize a full or empty set for the specified bit width. More...

	ConstantRange (APInt Value)
	Initialize a range to hold the single specified value. More...

	ConstantRange (APInt Lower, APInt Upper)
	Initialize a range of values explicitly. More...

bool	icmp (CmpInst::Predicate Pred, const ConstantRange &Other) const
	Does the predicate `Pred` hold between ranges this and `Other`? NOTE: false does not mean that inverse predicate holds! More...

bool	getEquivalentICmp (CmpInst::Predicate &Pred, APInt &RHS) const
	Set up `Pred` and `RHS` such that ConstantRange::makeExactICmpRegion(Pred, RHS) == *this. More...

const APInt &	getLower () const
	Return the lower value for this range. More...

const APInt &	getUpper () const
	Return the upper value for this range. More...

uint32_t	getBitWidth () const
	Get the bit width of this ConstantRange. More...

bool	isFullSet () const
	Return true if this set contains all of the elements possible for this data-type. More...

bool	isEmptySet () const
	Return true if this set contains no members. More...

bool	isWrappedSet () const
	Return true if this set wraps around the unsigned domain. More...

bool	isUpperWrapped () const
	Return true if the exclusive upper bound wraps around the unsigned domain. More...

bool	isSignWrappedSet () const
	Return true if this set wraps around the signed domain. More...

bool	isUpperSignWrapped () const
	Return true if the (exclusive) upper bound wraps around the signed domain. More...

bool	contains (const APInt &Val) const
	Return true if the specified value is in the set. More...

bool	contains (const ConstantRange &CR) const
	Return true if the other range is a subset of this one. More...

const APInt *	getSingleElement () const
	If this set contains a single element, return it, otherwise return null. More...

const APInt *	getSingleMissingElement () const
	If this set contains all but a single element, return it, otherwise return null. More...

bool	isSingleElement () const
	Return true if this set contains exactly one member. More...

bool	isSizeStrictlySmallerThan (const ConstantRange &CR) const
	Compare set size of this range with the range CR. More...

bool	isSizeLargerThan (uint64_t MaxSize) const
	Compare set size of this range with Value. More...

bool	isAllNegative () const
	Return true if all values in this range are negative. More...

bool	isAllNonNegative () const
	Return true if all values in this range are non-negative. More...

APInt	getUnsignedMax () const
	Return the largest unsigned value contained in the ConstantRange. More...

APInt	getUnsignedMin () const
	Return the smallest unsigned value contained in the ConstantRange. More...

APInt	getSignedMax () const
	Return the largest signed value contained in the ConstantRange. More...

APInt	getSignedMin () const
	Return the smallest signed value contained in the ConstantRange. More...

bool	operator== (const ConstantRange &CR) const
	Return true if this range is equal to another range. More...

bool	operator!= (const ConstantRange &CR) const

unsigned	getActiveBits () const
	Compute the maximal number of active bits needed to represent every value in this range. More...

unsigned	getMinSignedBits () const
	Compute the maximal number of bits needed to represent every value in this signed range. More...

ConstantRange	subtract (const APInt &CI) const
	Subtract the specified constant from the endpoints of this constant range. More...

ConstantRange	difference (const ConstantRange &CR) const
	Subtract the specified range from this range (aka relative complement of the sets). More...

ConstantRange	intersectWith (const ConstantRange &CR, PreferredRangeType Type=Smallest) const
	Return the range that results from the intersection of this range with another range. More...

ConstantRange	unionWith (const ConstantRange &CR, PreferredRangeType Type=Smallest) const
	Return the range that results from the union of this range with another range. More...

ConstantRange	castOp (Instruction::CastOps CastOp, uint32_t BitWidth) const
	Return a new range representing the possible values resulting from an application of the specified cast operator to this range. More...

ConstantRange	zeroExtend (uint32_t BitWidth) const
	Return a new range in the specified integer type, which must be strictly larger than the current type. More...

ConstantRange	signExtend (uint32_t BitWidth) const
	Return a new range in the specified integer type, which must be strictly larger than the current type. More...

ConstantRange	truncate (uint32_t BitWidth) const
	Return a new range in the specified integer type, which must be strictly smaller than the current type. More...

ConstantRange	zextOrTrunc (uint32_t BitWidth) const
	Make this range have the bit width given by `BitWidth`. More...

ConstantRange	sextOrTrunc (uint32_t BitWidth) const
	Make this range have the bit width given by `BitWidth`. More...

ConstantRange	binaryOp (Instruction::BinaryOps BinOp, const ConstantRange &Other) const
	Return a new range representing the possible values resulting from an application of the specified binary operator to an left hand side of this range and a right hand side of `Other`. More...

ConstantRange	overflowingBinaryOp (Instruction::BinaryOps BinOp, const ConstantRange &Other, unsigned NoWrapKind) const
	Return a new range representing the possible values resulting from an application of the specified overflowing binary operator to a left hand side of this range and a right hand side of `Other` given the provided knowledge about lack of wrapping `NoWrapKind`. More...

ConstantRange	add (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from an addition of a value in this range and a value in `Other`. More...

ConstantRange	addWithNoWrap (const ConstantRange &Other, unsigned NoWrapKind, PreferredRangeType RangeType=Smallest) const
	Return a new range representing the possible values resulting from an addition with wrap type `NoWrapKind` of a value in this range and a value in `Other`. More...

ConstantRange	sub (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a subtraction of a value in this range and a value in `Other`. More...

ConstantRange	subWithNoWrap (const ConstantRange &Other, unsigned NoWrapKind, PreferredRangeType RangeType=Smallest) const
	Return a new range representing the possible values resulting from an subtraction with wrap type `NoWrapKind` of a value in this range and a value in `Other`. More...

ConstantRange	multiply (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a multiplication of a value in this range and a value in `Other`, treating both this and `Other` as unsigned ranges. More...

ConstantRange	smax (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a signed maximum of a value in this range and a value in `Other`. More...

ConstantRange	umax (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from an unsigned maximum of a value in this range and a value in `Other`. More...

ConstantRange	smin (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a signed minimum of a value in this range and a value in `Other`. More...

ConstantRange	umin (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from an unsigned minimum of a value in this range and a value in `Other`. More...

ConstantRange	udiv (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from an unsigned division of a value in this range and a value in `Other`. More...

ConstantRange	sdiv (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a signed division of a value in this range and a value in `Other`. More...

ConstantRange	urem (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from an unsigned remainder operation of a value in this range and a value in `Other`. More...

ConstantRange	srem (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a signed remainder operation of a value in this range and a value in `Other`. More...

ConstantRange	binaryNot () const
	Return a new range representing the possible values resulting from a binary-xor of a value in this range by an all-one value, aka bitwise complement operation. More...

ConstantRange	binaryAnd (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a binary-and of a value in this range by a value in `Other`. More...

ConstantRange	binaryOr (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a binary-or of a value in this range by a value in `Other`. More...

ConstantRange	binaryXor (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a binary-xor of a value in this range by a value in `Other`. More...

ConstantRange	shl (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a left shift of a value in this range by a value in `Other`. More...

ConstantRange	lshr (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a logical right shift of a value in this range and a value in `Other`. More...

ConstantRange	ashr (const ConstantRange &Other) const
	Return a new range representing the possible values resulting from a arithmetic right shift of a value in this range and a value in `Other`. More...

ConstantRange	uadd_sat (const ConstantRange &Other) const
	Perform an unsigned saturating addition of two constant ranges. More...

ConstantRange	sadd_sat (const ConstantRange &Other) const
	Perform a signed saturating addition of two constant ranges. More...

ConstantRange	usub_sat (const ConstantRange &Other) const
	Perform an unsigned saturating subtraction of two constant ranges. More...

ConstantRange	ssub_sat (const ConstantRange &Other) const
	Perform a signed saturating subtraction of two constant ranges. More...

ConstantRange	umul_sat (const ConstantRange &Other) const
	Perform an unsigned saturating multiplication of two constant ranges. More...

ConstantRange	smul_sat (const ConstantRange &Other) const
	Perform a signed saturating multiplication of two constant ranges. More...

ConstantRange	ushl_sat (const ConstantRange &Other) const
	Perform an unsigned saturating left shift of this constant range by a value in `Other`. More...

ConstantRange	sshl_sat (const ConstantRange &Other) const
	Perform a signed saturating left shift of this constant range by a value in `Other`. More...

ConstantRange	inverse () const
	Return a new range that is the logical not of the current set. More...

ConstantRange	abs (bool IntMinIsPoison=false) const
	Calculate absolute value range. More...

OverflowResult	unsignedAddMayOverflow (const ConstantRange &Other) const
	Return whether unsigned add of the two ranges always/never overflows. More...

OverflowResult	signedAddMayOverflow (const ConstantRange &Other) const
	Return whether signed add of the two ranges always/never overflows. More...

OverflowResult	unsignedSubMayOverflow (const ConstantRange &Other) const
	Return whether unsigned sub of the two ranges always/never overflows. More...

OverflowResult	signedSubMayOverflow (const ConstantRange &Other) const
	Return whether signed sub of the two ranges always/never overflows. More...

OverflowResult	unsignedMulMayOverflow (const ConstantRange &Other) const
	Return whether unsigned mul of the two ranges always/never overflows. More...

void	print (raw_ostream &OS) const
	Print out the bounds to a stream. More...

void	dump () const
	Allow printing from a debugger easily. More...

Static Public Member Functions
static ConstantRange	getEmpty (uint32_t BitWidth)
	Create empty constant range with the given bit width. More...

static ConstantRange	getFull (uint32_t BitWidth)
	Create full constant range with the given bit width. More...

static ConstantRange	getNonEmpty (APInt Lower, APInt Upper)
	Create non-empty constant range with the given bounds. More...

static ConstantRange	fromKnownBits (const KnownBits &Known, bool IsSigned)
	Initialize a range based on a known bits constraint. More...

static ConstantRange	makeAllowedICmpRegion (CmpInst::Predicate Pred, const ConstantRange &Other)
	Produce the smallest range such that all values that may satisfy the given predicate with any value contained within Other is contained in the returned range. More...

static ConstantRange	makeSatisfyingICmpRegion (CmpInst::Predicate Pred, const ConstantRange &Other)
	Produce the largest range such that all values in the returned range satisfy the given predicate with all values contained within Other. More...

static ConstantRange	makeExactICmpRegion (CmpInst::Predicate Pred, const APInt &Other)
	Produce the exact range such that all values in the returned range satisfy the given predicate with any value contained within Other. More...

static ConstantRange	makeGuaranteedNoWrapRegion (Instruction::BinaryOps BinOp, const ConstantRange &Other, unsigned NoWrapKind)
	Produce the largest range containing all X such that "X BinOp Y" is guaranteed not to wrap (overflow) for all Y in Other. More...

static ConstantRange	makeExactNoWrapRegion (Instruction::BinaryOps BinOp, const APInt &Other, unsigned NoWrapKind)
	Produce the range that contains X if and only if "X BinOp Other" does not wrap. More...

static bool	isIntrinsicSupported (Intrinsic::ID IntrinsicID)
	Returns true if ConstantRange calculations are supported for intrinsic with `IntrinsicID`. More...

static ConstantRange	intrinsic (Intrinsic::ID IntrinsicID, ArrayRef< ConstantRange > Ops)
	Compute range of intrinsic result for the given operand ranges. More...

Detailed Description

This class represents a range of values.

Definition at line 47 of file ConstantRange.h.

Member Enumeration Documentation

◆ OverflowResult

enum llvm::ConstantRange::OverflowResult

strong

Represents whether an operation on the given constant range is known to always or never overflow.

Enumerator
AlwaysOverflowsLow	Always overflows in the direction of signed/unsigned min value.
AlwaysOverflowsHigh	Always overflows in the direction of signed/unsigned max value.
MayOverflow	May or may not overflow.
NeverOverflows	Never overflows.

Definition at line 490 of file ConstantRange.h.

◆ PreferredRangeType

enum llvm::ConstantRange::PreferredRangeType

If represented precisely, the result of some range operations may consist of multiple disjoint ranges.

As only a single range may be returned, any range covering these disjoint ranges constitutes a valid result, but some may be more useful than others depending on context. The preferred range type specifies whether a range that is non-wrapping in the unsigned or signed domain, or has the smallest size, is preferred. If a signedness is preferred but all ranges are non-wrapping or all wrapping, then the smallest set size is preferred. If there are multiple smallest sets, any one of them may be returned.

Enumerator
Smallest
Unsigned
Signed

Definition at line 292 of file ConstantRange.h.

Constructor & Destructor Documentation

◆ ConstantRange() [1/3]

ConstantRange::ConstantRange	(	uint32_t	BitWidth,
		bool	isFullSet
	)

explicit

Initialize a full or empty set for the specified bit width.

Definition at line 43 of file ConstantRange.cpp.

References llvm::Upper.

Referenced by abs(), add(), binaryNot(), castOp(), fromKnownBits(), intersectWith(), inverse(), makeAllowedICmpRegion(), makeExactNoWrapRegion(), makeGuaranteedNoWrapRegion(), multiply(), sdiv(), shl(), signExtend(), srem(), sub(), subtract(), truncate(), unionWith(), and zeroExtend().

◆ ConstantRange() [2/3]

ConstantRange::ConstantRange ( APInt Value )

Initialize a range to hold the single specified value.

Definition at line 47 of file ConstantRange.cpp.

References llvm::Upper.

◆ ConstantRange() [3/3]

ConstantRange::ConstantRange	(	APInt	Lower,
		APInt	Upper
	)

Initialize a range of values explicitly.

This will assert out if Lower==Upper and Lower != Min or Max value for its type. It will also assert out if the two APInt's are not the same bit width.

Definition at line 50 of file ConstantRange.cpp.

References assert(), llvm::APInt::getBitWidth(), llvm::LegacyLegalizeActions::Lower, and llvm::Upper.

Member Function Documentation

◆ abs()

ConstantRange ConstantRange::abs ( bool IntMinIsPoison = false ) const

Calculate absolute value range.

If the original range contains signed min, then the resulting range will contain signed min if and only if IntMinIsPoison is false.

Definition at line 1530 of file ConstantRange.cpp.

References ConstantRange(), getBitWidth(), llvm::APInt::getNullValue(), getSignedMax(), getSignedMin(), llvm::APInt::getSignedMinValue(), isEmptySet(), isSignWrappedSet(), llvm::APInt::isStrictlyPositive(), llvm::MipsISD::Lo, llvm::LegacyLegalizeActions::Lower, llvm::SMax, llvm::SMin, llvm::APIntOps::umax(), and llvm::APIntOps::umin().

Referenced by srem().

◆ add()

ConstantRange ConstantRange::add ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from an addition of a value in this range and a value in Other.

Definition at line 908 of file ConstantRange.cpp.

References ConstantRange(), getLower(), getUpper(), isEmptySet(), isFullSet(), move, Other, and X.

Referenced by addWithNoWrap(), binaryOp(), and llvm::JumpThreadingPass::computeValueKnownInPredecessorsImpl().

◆ addWithNoWrap()

ConstantRange ConstantRange::addWithNoWrap	(	const ConstantRange &	Other,
		unsigned	NoWrapKind,
		PreferredRangeType	RangeType = `Smallest`
	)		const

Return a new range representing the possible values resulting from an addition with wrap type NoWrapKind of a value in this range and a value in Other.

If the result range is disjoint, the preferred range is determined by the PreferredRangeType.

Definition at line 927 of file ConstantRange.cpp.

References add(), isEmptySet(), isFullSet(), Other, sadd_sat(), and uadd_sat().

Referenced by overflowingBinaryOp().

◆ ashr()

ConstantRange ConstantRange::ashr ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a arithmetic right shift of a value in this range and a value in Other.

Definition at line 1381 of file ConstantRange.cpp.

References llvm::APInt::ashr(), getNonEmpty(), getSignedMax(), getSignedMin(), isEmptySet(), isNonNegative(), llvm::max(), llvm::min(), move, and Other.

Referenced by binaryOp(), and makeGuaranteedNoWrapRegion().

◆ binaryAnd()

ConstantRange ConstantRange::binaryAnd ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a binary-and of a value in this range by a value in Other.

Definition at line 1298 of file ConstantRange.cpp.

References getBitWidth(), getNonEmpty(), llvm::APInt::getNullValue(), getSingleElement(), getUnsignedMax(), isEmptySet(), isSingleElement(), move, Other, umin(), and llvm::APIntOps::umin().

Referenced by binaryOp().

◆ binaryNot()

ConstantRange ConstantRange::binaryNot ( ) const

Return a new range representing the possible values resulting from a binary-xor of a value in this range by an all-one value, aka bitwise complement operation.

Definition at line 1293 of file ConstantRange.cpp.

References ConstantRange(), llvm::APInt::getAllOnesValue(), and getBitWidth().

Referenced by binaryXor().

◆ binaryOp()

ConstantRange ConstantRange::binaryOp	(	Instruction::BinaryOps	BinOp,
		const ConstantRange &	Other
	)		const

Return a new range representing the possible values resulting from an application of the specified binary operator to an left hand side of this range and a right hand side of Other.

Definition at line 797 of file ConstantRange.cpp.

References llvm::MCID::Add, add(), ashr(), assert(), binaryAnd(), binaryOr(), binaryXor(), llvm::Instruction::isBinaryOp(), lshr(), multiply(), Other, sdiv(), shl(), srem(), sub(), udiv(), and urem().

Referenced by overflowingBinaryOp().

◆ binaryOr()

ConstantRange ConstantRange::binaryOr ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a binary-or of a value in this range by a value in Other.

Definition at line 1313 of file ConstantRange.cpp.

References getBitWidth(), getNonEmpty(), llvm::APInt::getNullValue(), getSingleElement(), getUnsignedMin(), isEmptySet(), isSingleElement(), move, Other, umax(), and llvm::APIntOps::umax().

Referenced by binaryOp().

◆ binaryXor()

ConstantRange ConstantRange::binaryXor ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a binary-xor of a value in this range by a value in Other.

Definition at line 1327 of file ConstantRange.cpp.

References binaryNot(), getSingleElement(), isEmptySet(), isSingleElement(), and Other.

Referenced by binaryOp().

◆ castOp()

ConstantRange ConstantRange::castOp	(	Instruction::CastOps	CastOp,
		uint32_t	BitWidth
	)		const

Return a new range representing the possible values resulting from an application of the specified cast operator to this range.

BitWidth is the target bitwidth of the cast. For casts which don't change bitwidth, it must be the same as the source bitwidth. For casts which do change bitwidth, the bitwidth must be consistent with the requested cast and source bitwidth.

Definition at line 647 of file ConstantRange.cpp.

References ConstantRange(), getBitWidth(), llvm::APInt::getMaxValue(), llvm::APInt::getMinValue(), llvm::APInt::getSignedMaxValue(), llvm::APInt::getSignedMinValue(), llvm_unreachable, move, llvm::APInt::sextOrSelf(), signExtend(), llvm::SMax, llvm::SMin, truncate(), zeroExtend(), and llvm::APInt::zextOrSelf().

◆ contains() [1/2]

bool ConstantRange::contains ( const APInt & Val ) const

Return true if the specified value is in the set.

Definition at line 394 of file ConstantRange.cpp.

References isFullSet(), isUpperWrapped(), llvm::LegacyLegalizeActions::Lower, and llvm::APInt::ult().

Referenced by canScalarizeAccess(), cmpExcludesZero(), llvm::JumpThreadingPass::computeValueKnownInPredecessorsImpl(), llvm::copyRangeMetadata(), llvm::SCEVAddRecExpr::getNumIterationsInRange(), getPredicateResult(), getRangeForAffineARHelper(), llvm::ScalarEvolution::getSignExtendExpr(), llvm::ScalarEvolution::getZeroExtendExpr(), icmp(), llvm::ValueLatticeElement::markConstantRange(), processBinOp(), rangeMetadataExcludesValue(), sdiv(), simplifyICmpWithConstant(), SolveQuadraticAddRecRange(), and willNotOverflow().

◆ contains() [2/2]

bool ConstantRange::contains ( const ConstantRange & CR ) const

Return true if the other range is a subset of this one.

Definition at line 403 of file ConstantRange.cpp.

References isEmptySet(), isFullSet(), isUpperWrapped(), llvm::LegacyLegalizeActions::Lower, and Other.

◆ difference()

ConstantRange ConstantRange::difference ( const ConstantRange & CR ) const

Subtract the specified range from this range (aka relative complement of the sets).

Definition at line 444 of file ConstantRange.cpp.

References intersectWith(), and inverse().

Referenced by llvm::InstCombinerImpl::foldICmpWithDominatingICmp(), getEdgeValueLocal(), and isImpliedCondMatchingImmOperands().

◆ dump()

LLVM_DUMP_METHOD void ConstantRange::dump ( ) const

Allow printing from a debugger easily.

Definition at line 1694 of file ConstantRange.cpp.

References llvm::dbgs(), and print().

◆ fromKnownBits()

ConstantRange ConstantRange::fromKnownBits	(	const KnownBits &	Known,
		bool	IsSigned
	)

static

Initialize a range based on a known bits constraint.

The IsSigned flag indicates whether the constant range should not wrap in the signed or unsigned domain.

Definition at line 58 of file ConstantRange.cpp.

References assert(), llvm::APInt::clearSignBit(), ConstantRange(), llvm::KnownBits::getBitWidth(), llvm::KnownBits::getMaxValue(), llvm::KnownBits::getMinValue(), llvm::KnownBits::hasConflict(), llvm::KnownBits::isNegative(), llvm::KnownBits::isNonNegative(), llvm::KnownBits::isUnknown(), and llvm::LegacyLegalizeActions::Lower.

Referenced by computeConstantRangeIncludingKnownBits(), llvm::computeOverflowForUnsignedMul(), and getValueFromICmpCondition().

◆ getActiveBits()

unsigned ConstantRange::getActiveBits ( ) const

Compute the maximal number of active bits needed to represent every value in this range.

Definition at line 421 of file ConstantRange.cpp.

References llvm::APInt::getActiveBits(), getUnsignedMax(), and isEmptySet().

Referenced by processUDivOrURem().

◆ getBitWidth()

uint32_t llvm::ConstantRange::getBitWidth ( ) const

inline

Get the bit width of this ConstantRange.

Definition at line 177 of file ConstantRange.h.

Referenced by abs(), binaryAnd(), binaryNot(), binaryOr(), castOp(), computeOverflowForSignedAdd(), getEquivalentICmp(), getRangeForAffineARHelper(), getSignedMax(), getSignedMin(), getUnsignedMax(), getUnsignedMin(), intersectWith(), isSizeLargerThan(), isSizeStrictlySmallerThan(), makeAllowedICmpRegion(), multiply(), sdiv(), sextOrTrunc(), signedAddMayOverflow(), signedSubMayOverflow(), signExtend(), smul_sat(), srem(), subtract(), truncate(), unionWith(), urem(), zeroExtend(), and zextOrTrunc().

◆ getEmpty()

static ConstantRange llvm::ConstantRange::getEmpty ( uint32_t BitWidth )

inlinestatic

Create empty constant range with the given bit width.

Definition at line 73 of file ConstantRange.h.

References llvm::BitWidth.

◆ getEquivalentICmp()

bool ConstantRange::getEquivalentICmp	(	CmpInst::Predicate &	Pred,
		APInt &	RHS
	)		const

Set up Pred and RHS such that ConstantRange::makeExactICmpRegion(Pred, RHS) == *this.

Return true if successful.

Definition at line 150 of file ConstantRange.cpp.

References assert(), getBitWidth(), getLower(), getSingleElement(), getSingleMissingElement(), getUpper(), llvm::CmpInst::ICMP_EQ, llvm::CmpInst::ICMP_NE, llvm::CmpInst::ICMP_SGE, llvm::CmpInst::ICMP_SLT, llvm::CmpInst::ICMP_UGE, llvm::CmpInst::ICMP_ULT, isEmptySet(), isFullSet(), llvm::APInt::isMinSignedValue(), makeExactICmpRegion(), and Success.

Referenced by llvm::ScalarEvolution::SimplifyICmpOperands(), and llvm::InstCombinerImpl::visitExtractValueInst().

◆ getFull()

static ConstantRange llvm::ConstantRange::getFull ( uint32_t BitWidth )

inlinestatic

Create full constant range with the given bit width.

Definition at line 78 of file ConstantRange.h.

References llvm::BitWidth.

◆ getLower()

const APInt& llvm::ConstantRange::getLower ( ) const

inline

Return the lower value for this range.

Definition at line 171 of file ConstantRange.h.

Referenced by add(), getEquivalentICmp(), getRangeForAffineARHelper(), getSignedMin(), getUnsignedMin(), makeAllowedICmpRegion(), llvm::operator<<(), SolveQuadraticAddRecRange(), sub(), and udiv().

◆ getMinSignedBits()

unsigned ConstantRange::getMinSignedBits ( ) const

Compute the maximal number of bits needed to represent every value in this signed range.

Definition at line 428 of file ConstantRange.cpp.

References getSignedMax(), getSignedMin(), isEmptySet(), and llvm::max().

◆ getNonEmpty()

static ConstantRange llvm::ConstantRange::getNonEmpty	(	APInt	Lower,
		APInt	Upper
	)

inlinestatic

Create non-empty constant range with the given bounds.

If Lower and Upper are the same, a full range is returned.

Definition at line 84 of file ConstantRange.h.

References move, and llvm::Upper.

Referenced by ashr(), binaryAnd(), binaryOr(), llvm::computeConstantRange(), getRangeForAffineARHelper(), getValueFromICmpCondition(), lshr(), makeAllowedICmpRegion(), makeExactMulNUWRegion(), makeGuaranteedNoWrapRegion(), sadd_sat(), smax(), smin(), smul_sat(), sshl_sat(), ssub_sat(), uadd_sat(), udiv(), umax(), umin(), umul_sat(), urem(), ushl_sat(), and usub_sat().

◆ getSignedMax()

APInt ConstantRange::getSignedMax ( ) const

Return the largest signed value contained in the ConstantRange.

Definition at line 382 of file ConstantRange.cpp.

References getBitWidth(), llvm::APInt::getSignedMaxValue(), getUpper(), isFullSet(), and isUpperSignWrapped().

Referenced by abs(), ashr(), getMinSignedBits(), llvm::ScalarEvolution::getSignedRangeMax(), makeAllowedICmpRegion(), multiply(), sadd_sat(), signedAddMayOverflow(), signedSubMayOverflow(), smax(), smin(), smul_sat(), srem(), sshl_sat(), and ssub_sat().

◆ getSignedMin()

APInt ConstantRange::getSignedMin ( ) const

Return the smallest signed value contained in the ConstantRange.

Definition at line 388 of file ConstantRange.cpp.

References getBitWidth(), getLower(), llvm::APInt::getSignedMinValue(), isFullSet(), and isSignWrappedSet().

Referenced by abs(), ashr(), getMinSignedBits(), llvm::ScalarEvolution::getSignedRangeMin(), makeAllowedICmpRegion(), multiply(), sadd_sat(), signedAddMayOverflow(), signedSubMayOverflow(), smax(), smin(), smul_sat(), srem(), sshl_sat(), ssub_sat(), stripAndAccumulateMinimalOffsets(), and llvm::InstCombinerImpl::visitExtractValueInst().

◆ getSingleElement()

const APInt* llvm::ConstantRange::getSingleElement ( ) const

inline

If this set contains a single element, return it, otherwise return null.

Definition at line 219 of file ConstantRange.h.

References llvm::Upper.

Referenced by llvm::ValueLatticeElement::asConstantInteger(), binaryAnd(), binaryOr(), binaryXor(), llvm::InstCombinerImpl::foldICmpWithDominatingICmp(), llvm::AAValueConstantRange::getAssumedConstantInt(), llvm::LazyValueInfo::getConstant(), llvm::LazyValueInfo::getConstantOnEdge(), getEquivalentICmp(), srem(), and urem().

◆ getSingleMissingElement()

const APInt* llvm::ConstantRange::getSingleMissingElement ( ) const

inline

If this set contains all but a single element, return it, otherwise return null.

Definition at line 227 of file ConstantRange.h.

References llvm::Upper.

Referenced by getEquivalentICmp().

◆ getUnsignedMax()

APInt ConstantRange::getUnsignedMax ( ) const

Return the largest unsigned value contained in the ConstantRange.

Definition at line 370 of file ConstantRange.cpp.

References getBitWidth(), llvm::APInt::getMaxValue(), getUpper(), isFullSet(), and isUpperWrapped().

Referenced by llvm::SCEVAAResult::alias(), binaryAnd(), llvm::computeKnownBitsFromRangeMetadata(), getActiveBits(), llvm::ScalarEvolution::getUnsignedRangeMax(), llvm::SelectionDAGBuilder::lowerRangeToAssertZExt(), lshr(), makeAllowedICmpRegion(), makeGuaranteedNoWrapRegion(), multiply(), mustBeFiniteCountedLoop(), processAnd(), shl(), srem(), subWithNoWrap(), uadd_sat(), udiv(), umax(), umin(), umul_sat(), unsignedAddMayOverflow(), unsignedMulMayOverflow(), unsignedSubMayOverflow(), urem(), ushl_sat(), and usub_sat().

◆ getUnsignedMin()

APInt ConstantRange::getUnsignedMin ( ) const

Return the smallest unsigned value contained in the ConstantRange.

Definition at line 376 of file ConstantRange.cpp.

References getBitWidth(), getLower(), llvm::APInt::getMinValue(), isFullSet(), and isWrappedSet().

Referenced by llvm::SCEVAAResult::alias(), binaryOr(), llvm::computeKnownBitsFromRangeMetadata(), llvm::ScalarEvolution::getUnsignedRangeMin(), llvm::SelectionDAGBuilder::lowerRangeToAssertZExt(), lshr(), makeAllowedICmpRegion(), multiply(), shl(), srem(), uadd_sat(), udiv(), umax(), umin(), umul_sat(), unsignedAddMayOverflow(), unsignedMulMayOverflow(), unsignedSubMayOverflow(), urem(), ushl_sat(), usub_sat(), and llvm::InstCombinerImpl::visitExtractValueInst().

◆ getUpper()

const APInt& llvm::ConstantRange::getUpper ( ) const

inline

Return the upper value for this range.

Definition at line 174 of file ConstantRange.h.

References llvm::Upper.

Referenced by add(), getEquivalentICmp(), getRangeForAffineARHelper(), getSignedMax(), getUnsignedMax(), makeAllowedICmpRegion(), multiply(), llvm::operator<<(), SolveQuadraticAddRecRange(), sub(), and udiv().

◆ icmp()

bool ConstantRange::icmp	(	CmpInst::Predicate	Pred,
		const ConstantRange &	Other
	)		const

Does the predicate Pred hold between ranges this and Other? NOTE: false does not mean that inverse predicate holds!

Definition at line 184 of file ConstantRange.cpp.

References contains(), makeSatisfyingICmpRegion(), and Other.

◆ intersectWith()

ConstantRange ConstantRange::intersectWith	(	const ConstantRange &	CR,
		PreferredRangeType	Type = `Smallest`
	)		const

Return the range that results from the intersection of this range with another range.

If the intersection is disjoint, such that two results are possible, the preferred range is determined by the PreferredRangeType.

Definition at line 468 of file ConstantRange.cpp.

References assert(), ConstantRange(), getBitWidth(), getPreferredRange(), intersectWith(), isEmptySet(), isFullSet(), isUpperWrapped(), llvm::LegacyLegalizeActions::Lower, llvm::APInt::ule(), and llvm::APInt::ult().

Referenced by areNonOverlapSameBaseLoadAndStore(), llvm::computeConstantRange(), computeConstantRangeIncludingKnownBits(), difference(), llvm::InstCombinerImpl::foldICmpWithDominatingICmp(), llvm::IntegerRangeState::intersectKnown(), intersectWith(), isImpliedCondMatchingImmOperands(), makeGuaranteedNoWrapRegion(), sdiv(), smax(), smin(), umax(), umin(), and llvm::IntegerRangeState::unionAssumed().

◆ intrinsic()

ConstantRange ConstantRange::intrinsic	(	Intrinsic::ID	IntrinsicID,
		ArrayRef< ConstantRange >	Ops
	)

static

Compute range of intrinsic result for the given operand ranges.

Definition at line 876 of file ConstantRange.cpp.

References llvm::abs(), assert(), llvm::APInt::getBitWidth(), llvm::APInt::getBoolValue(), isIntrinsicSupported(), llvm_unreachable, llvm::APIntOps::smax(), llvm::APIntOps::smin(), llvm::APIntOps::umax(), and llvm::APIntOps::umin().

◆ inverse()

ConstantRange ConstantRange::inverse ( ) const

Return a new range that is the logical not of the current set.

Definition at line 1522 of file ConstantRange.cpp.

References ConstantRange(), isEmptySet(), isFullSet(), and llvm::LegacyLegalizeActions::Lower.

Referenced by llvm::JumpThreadingPass::computeValueKnownInPredecessorsImpl(), difference(), getPredicateResult(), getValueFromOverflowCondition(), makeSatisfyingICmpRegion(), and simplifyICmpWithConstant().

◆ isAllNegative()

bool ConstantRange::isAllNegative ( ) const

Return true if all values in this range are negative.

Definition at line 355 of file ConstantRange.cpp.

References isEmptySet(), isFullSet(), llvm::APInt::isStrictlyPositive(), and isUpperSignWrapped().

Referenced by computeOverflowForSignedAdd().

◆ isAllNonNegative()

bool ConstantRange::isAllNonNegative ( ) const

Return true if all values in this range are non-negative.

Definition at line 365 of file ConstantRange.cpp.

References isSignWrappedSet(), and llvm::LegacyLegalizeActions::Lower.

Referenced by computeOverflowForSignedAdd(), and simplifyInstsInBlock().

◆ isEmptySet()

bool ConstantRange::isEmptySet ( ) const

Return true if this set contains no members.

Definition at line 314 of file ConstantRange.cpp.

References llvm::LegacyLegalizeActions::Lower.

Referenced by abs(), add(), addWithNoWrap(), areNonOverlapSameBaseLoadAndStore(), ashr(), binaryAnd(), binaryOr(), binaryXor(), contains(), llvm::InstCombinerImpl::foldICmpWithDominatingICmp(), getActiveBits(), llvm::AAValueConstantRange::getAssumedConstantInt(), getEquivalentICmp(), getMinSignedBits(), llvm::ValueLatticeElement::getRange(), intersectWith(), inverse(), isAllNegative(), isImpliedCondMatchingImmOperands(), llvm::SelectionDAGBuilder::lowerRangeToAssertZExt(), lshr(), makeAllowedICmpRegion(), makeGuaranteedNoWrapRegion(), llvm::ValueLatticeElement::markConstantRange(), multiply(), print(), sadd_sat(), sdiv(), shl(), signedAddMayOverflow(), signedSubMayOverflow(), signExtend(), llvm::ScalarEvolution::SimplifyICmpOperands(), simplifyICmpWithConstant(), smax(), smin(), smul_sat(), srem(), sshl_sat(), ssub_sat(), sub(), subWithNoWrap(), truncate(), uadd_sat(), udiv(), umax(), umin(), umul_sat(), unionWith(), unsignedAddMayOverflow(), unsignedMulMayOverflow(), unsignedSubMayOverflow(), urem(), ushl_sat(), usub_sat(), and zeroExtend().

◆ isFullSet()

bool ConstantRange::isFullSet ( ) const

Return true if this set contains all of the elements possible for this data-type.

Definition at line 310 of file ConstantRange.cpp.

References llvm::LegacyLegalizeActions::Lower.

Referenced by add(), addWithNoWrap(), contains(), getEquivalentICmp(), llvm::MDNode::getMostGenericRange(), llvm::SCEVAddRecExpr::getNumIterationsInRange(), llvm::ValueLatticeElement::getRange(), getRangeForAffineARHelper(), getSignedMax(), getSignedMin(), getUnsignedMax(), getUnsignedMin(), intersectWith(), inverse(), isAllNegative(), isSizeLargerThan(), isSizeStrictlySmallerThan(), llvm::IntegerRangeState::isValidState(), llvm::SelectionDAGBuilder::lowerRangeToAssertZExt(), llvm::ValueLatticeElement::markConstantRange(), print(), signExtend(), llvm::ScalarEvolution::SimplifyICmpOperands(), simplifyICmpWithConstant(), sub(), subWithNoWrap(), truncate(), unionWith(), and zeroExtend().

◆ isIntrinsicSupported()

bool ConstantRange::isIntrinsicSupported ( Intrinsic::ID IntrinsicID )

static

Returns true if ConstantRange calculations are supported for intrinsic with IntrinsicID.

Definition at line 859 of file ConstantRange.cpp.

References llvm::abs(), llvm::APIntOps::smax(), llvm::APIntOps::smin(), llvm::APIntOps::umax(), and llvm::APIntOps::umin().

Referenced by intrinsic().

◆ isSignWrappedSet()

bool ConstantRange::isSignWrappedSet ( ) const

Return true if this set wraps around the signed domain.

Special cases:

Empty set: Not wrapped.
Full set: Not wrapped.
[X, SignedMin) == [X, SignedMax]: Not wrapped.

Definition at line 326 of file ConstantRange.cpp.

References llvm::APInt::isMinSignedValue(), and llvm::LegacyLegalizeActions::Lower.

Referenced by abs(), getPreferredRange(), getSignedMin(), isAllNonNegative(), signExtend(), smax(), and smin().

◆ isSingleElement()

bool llvm::ConstantRange::isSingleElement ( ) const

inline

Return true if this set contains exactly one member.

Definition at line 234 of file ConstantRange.h.

Referenced by binaryAnd(), binaryOr(), binaryXor(), getPredicateResult(), hasSingleValue(), isConstant(), llvm::ValueLatticeElement::isConstantRange(), makeAllowedICmpRegion(), and llvm::runIPSCCP().

◆ isSizeLargerThan()

bool ConstantRange::isSizeLargerThan ( uint64_t MaxSize ) const

Compare set size of this range with Value.

Definition at line 345 of file ConstantRange.cpp.

References assert(), getBitWidth(), llvm::APInt::getMaxValue(), isFullSet(), llvm::LegacyLegalizeActions::Lower, and llvm::APInt::ugt().

◆ isSizeStrictlySmallerThan()

bool ConstantRange::isSizeStrictlySmallerThan ( const ConstantRange & CR ) const

Compare set size of this range with the range CR.

Definition at line 335 of file ConstantRange.cpp.

References assert(), getBitWidth(), isFullSet(), llvm::LegacyLegalizeActions::Lower, and Other.

Referenced by getPreferredRange(), and multiply().

◆ isUpperSignWrapped()

bool ConstantRange::isUpperSignWrapped ( ) const

Return true if the (exclusive) upper bound wraps around the signed domain.

Special cases:

Empty set: Not wrapped.
Full set: Not wrapped.
[X, SignedMin): Wrapped.

Definition at line 330 of file ConstantRange.cpp.

References llvm::LegacyLegalizeActions::Lower.

Referenced by getSignedMax(), and isAllNegative().

◆ isUpperWrapped()

bool ConstantRange::isUpperWrapped ( ) const

Return true if the exclusive upper bound wraps around the unsigned domain.

Special cases:

Empty set: Not wrapped.
Full set: Not wrapped.
[X, 0): Wrapped.

Definition at line 322 of file ConstantRange.cpp.

References llvm::LegacyLegalizeActions::Lower.

Referenced by contains(), getUnsignedMax(), intersectWith(), llvm::SelectionDAGBuilder::lowerRangeToAssertZExt(), multiply(), truncate(), unionWith(), and zeroExtend().

◆ isWrappedSet()

bool ConstantRange::isWrappedSet ( ) const

Return true if this set wraps around the unsigned domain.

Special cases:

Empty set: Not wrapped.
Full set: Not wrapped.
[X, 0) == [X, Max]: Not wrapped.

Definition at line 318 of file ConstantRange.cpp.

References llvm::APInt::isNullValue(), and llvm::LegacyLegalizeActions::Lower.

Referenced by getPreferredRange(), getUnsignedMin(), umax(), and umin().

◆ lshr()

ConstantRange ConstantRange::lshr ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a logical right shift of a value in this range and a value in Other.

Definition at line 1371 of file ConstantRange.cpp.

References getNonEmpty(), getUnsignedMax(), getUnsignedMin(), isEmptySet(), llvm::APInt::lshr(), llvm::max(), llvm::min(), move, and Other.

Referenced by binaryOp(), and makeGuaranteedNoWrapRegion().

◆ makeAllowedICmpRegion()

ConstantRange ConstantRange::makeAllowedICmpRegion	(	CmpInst::Predicate	Pred,
		const ConstantRange &	Other
	)

static

Produce the smallest range such that all values that may satisfy the given predicate with any value contained within Other is contained in the returned range.

Formally, this returns a superset of 'union over all y in Other . { x : icmp op x y is true }'. If the exact answer is not representable as a ConstantRange, the return value will be a proper superset of the above.

Example: Pred = ult and Other = i8 [2, 5) returns Result = [0, 4)

Definition at line 78 of file ConstantRange.cpp.

References ConstantRange(), getBitWidth(), getLower(), llvm::APInt::getMinValue(), getNonEmpty(), llvm::APInt::getNullValue(), getSignedMax(), getSignedMin(), llvm::APInt::getSignedMinValue(), getUnsignedMax(), getUnsignedMin(), getUpper(), llvm::CmpInst::ICMP_EQ, llvm::CmpInst::ICMP_NE, llvm::CmpInst::ICMP_SGE, llvm::CmpInst::ICMP_SGT, llvm::CmpInst::ICMP_SLE, llvm::CmpInst::ICMP_SLT, llvm::CmpInst::ICMP_UGE, llvm::CmpInst::ICMP_UGT, llvm::CmpInst::ICMP_ULE, llvm::CmpInst::ICMP_ULT, isEmptySet(), isSingleElement(), llvm_unreachable, move, llvm::SMax, llvm::SMin, llvm::UMax, llvm::UMin, and llvm::RISCVFenceField::W.

Referenced by getValueFromSimpleICmpCondition(), makeExactICmpRegion(), and makeSatisfyingICmpRegion().

◆ makeExactICmpRegion()

ConstantRange ConstantRange::makeExactICmpRegion	(	CmpInst::Predicate	Pred,
		const APInt &	Other
	)

static

Produce the exact range such that all values in the returned range satisfy the given predicate with any value contained within Other.

Formally, this returns the exact answer when the superset of 'union over all y in Other is exactly same as the subset of intersection over all y in Other. { x : icmp op x y is true}'.

Example: Pred = ult and Other = i8 3 returns [0, 3)

Definition at line 138 of file ConstantRange.cpp.

References assert(), makeAllowedICmpRegion(), and makeSatisfyingICmpRegion().

Referenced by llvm::ScalarEvolution::applyLoopGuards(), cmpExcludesZero(), llvm::JumpThreadingPass::computeValueKnownInPredecessorsImpl(), llvm::InstCombinerImpl::foldICmpAddConstant(), llvm::InstCombinerImpl::foldICmpWithDominatingICmp(), getEquivalentICmp(), getPredicateResult(), isImpliedCondMatchingImmOperands(), simplifyAndOrOfICmpsWithConstants(), llvm::ScalarEvolution::SimplifyICmpOperands(), and simplifyICmpWithConstant().

◆ makeExactNoWrapRegion()

ConstantRange ConstantRange::makeExactNoWrapRegion	(	Instruction::BinaryOps	BinOp,
		const APInt &	Other,
		unsigned	NoWrapKind
	)

static

Produce the range that contains X if and only if "X BinOp Other" does not wrap.

Definition at line 302 of file ConstantRange.cpp.

References ConstantRange(), makeGuaranteedNoWrapRegion(), and Other.

Referenced by getValueFromOverflowCondition(), and llvm::InstCombinerImpl::visitExtractValueInst().

◆ makeGuaranteedNoWrapRegion()

ConstantRange ConstantRange::makeGuaranteedNoWrapRegion	(	Instruction::BinaryOps	BinOp,
		const ConstantRange &	Other,
		unsigned	NoWrapKind
	)

static

Produce the largest range containing all X such that "X BinOp Y" is guaranteed not to wrap (overflow) for all Y in Other.

However, there may be some Y in Other for which additional X not contained in the result also do not overflow.

NoWrapKind must be one of OBO::NoUnsignedWrap or OBO::NoSignedWrap.

Examples: typedef OverflowingBinaryOperator OBO; #define MGNR makeGuaranteedNoWrapRegion MGNR(Add, [i8 1, 2), OBO::NoSignedWrap) == [-128, 127) MGNR(Add, [i8 1, 2), OBO::NoUnsignedWrap) == [0, -1) MGNR(Add, [i8 0, 1), OBO::NoUnsignedWrap) == Full Set MGNR(Add, [i8 -1, 6), OBO::NoSignedWrap) == [INT_MIN+1, INT_MAX-4) MGNR(Sub, [i8 1, 2), OBO::NoSignedWrap) == [-127, 128) MGNR(Sub, [i8 1, 2), OBO::NoUnsignedWrap) == [1, 0)

Definition at line 231 of file ConstantRange.cpp.

References llvm::MCID::Add, ashr(), assert(), llvm::BitWidth, ConstantRange(), llvm::APInt::getMaxValue(), llvm::APInt::getMinValue(), getNonEmpty(), llvm::APInt::getNullValue(), llvm::APInt::getSignedMaxValue(), llvm::APInt::getSignedMinValue(), getUnsignedMax(), intersectWith(), llvm::Instruction::isBinaryOp(), isEmptySet(), llvm_unreachable, lshr(), makeExactMulNSWRegion(), makeExactMulNUWRegion(), Other, llvm::SMax, llvm::SMin, and Unsigned.

Referenced by makeExactNoWrapRegion(), processBinOp(), StrengthenNoWrapFlags(), and willNotOverflow().

◆ makeSatisfyingICmpRegion()

ConstantRange ConstantRange::makeSatisfyingICmpRegion	(	CmpInst::Predicate	Pred,
		const ConstantRange &	Other
	)

static

Produce the largest range such that all values in the returned range satisfy the given predicate with all values contained within Other.

Formally, this returns a subset of 'intersection over all y in Other . { x : icmp op x y is true }'. If the exact answer is not representable as a ConstantRange, the return value will be a proper subset of the above.

Example: Pred = ult and Other = i8 [2, 5) returns [0, 2)

Definition at line 128 of file ConstantRange.cpp.

References llvm::CmpInst::getInversePredicate(), inverse(), and makeAllowedICmpRegion().

Referenced by llvm::computeConstantRange(), icmp(), and makeExactICmpRegion().

◆ multiply()

ConstantRange ConstantRange::multiply ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a multiplication of a value in this range and a value in Other, treating both this and Other as unsigned ranges.

Definition at line 1005 of file ConstantRange.cpp.

References A, B, Compare, ConstantRange(), getBitWidth(), getSignedMax(), getSignedMin(), getUnsignedMax(), getUnsignedMin(), getUpper(), isEmptySet(), llvm::APInt::isMinSignedValue(), llvm::APInt::isNonNegative(), isSizeStrictlySmallerThan(), isUpperWrapped(), llvm::max(), llvm::min(), Other, llvm::APInt::sext(), truncate(), and llvm::APInt::zext().

Referenced by binaryOp().

◆ operator!=()

bool llvm::ConstantRange::operator!= ( const ConstantRange & CR ) const

inline

Definition at line 264 of file ConstantRange.h.

References llvm::operator==().

◆ operator==()

bool llvm::ConstantRange::operator== ( const ConstantRange & CR ) const

inline

Return true if this range is equal to another range.

Definition at line 261 of file ConstantRange.h.

References llvm::Upper.

◆ overflowingBinaryOp()

ConstantRange ConstantRange::overflowingBinaryOp	(	Instruction::BinaryOps	BinOp,
		const ConstantRange &	Other,
		unsigned	NoWrapKind
	)		const

Return a new range representing the possible values resulting from an application of the specified overflowing binary operator to a left hand side of this range and a right hand side of Other given the provided knowledge about lack of wrapping NoWrapKind.

Definition at line 842 of file ConstantRange.cpp.

References llvm::MCID::Add, addWithNoWrap(), assert(), binaryOp(), llvm::Instruction::isBinaryOp(), Other, and subWithNoWrap().

◆ print()

void ConstantRange::print ( raw_ostream & OS ) const

Print out the bounds to a stream.

Definition at line 1684 of file ConstantRange.cpp.

References isEmptySet(), isFullSet(), and llvm::LegacyLegalizeActions::Lower.

Referenced by dump(), llvm::operator<<(), and llvm::ScalarEvolution::print().

◆ sadd_sat()

ConstantRange ConstantRange::sadd_sat ( const ConstantRange & Other ) const

Perform a signed saturating addition of two constant ranges.

Definition at line 1440 of file ConstantRange.cpp.

References getNonEmpty(), getSignedMax(), getSignedMin(), isEmptySet(), move, Other, and llvm::APInt::sadd_sat().

Referenced by addWithNoWrap().

◆ sdiv()

ConstantRange ConstantRange::sdiv ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a signed division of a value in this range and a value in Other.

Division by zero and division of SignedMin by -1 are considered undefined behavior, in line with IR, and do not contribute towards the result.

Definition at line 1135 of file ConstantRange.cpp.

References ConstantRange(), contains(), getBitWidth(), llvm::APInt::getNullValue(), llvm::APInt::getSignedMinValue(), intersectWith(), llvm::APInt::isAllOnesValue(), isEmptySet(), llvm::APInt::isMinSignedValue(), llvm::APInt::isNullValue(), llvm::MipsISD::Lo, llvm::LegacyLegalizeActions::Lower, move, llvm::APInt::sdiv(), Signed, and unionWith().

Referenced by binaryOp().

◆ sextOrTrunc()

ConstantRange ConstantRange::sextOrTrunc ( uint32_t BitWidth ) const

Make this range have the bit width given by BitWidth.

The value is sign extended, truncated, or left alone to make it that width.

Definition at line 788 of file ConstantRange.cpp.

References getBitWidth(), signExtend(), and truncate().

Referenced by llvm::ScalarEvolution::getSignExtendExpr().

◆ shl()

ConstantRange ConstantRange::shl ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a left shift of a value in this range by a value in Other.

TODO: This isn't fully implemented yet.

Definition at line 1346 of file ConstantRange.cpp.

References ConstantRange(), getUnsignedMax(), getUnsignedMin(), isEmptySet(), llvm::APInt::isNullValue(), llvm::max(), llvm::min(), move, Other, and llvm::APInt::ugt().

Referenced by binaryOp().

◆ signedAddMayOverflow()

ConstantRange::OverflowResult ConstantRange::signedAddMayOverflow ( const ConstantRange & Other ) const

Return whether signed add of the two ranges always/never overflows.

Definition at line 1588 of file ConstantRange.cpp.

References AlwaysOverflowsHigh, AlwaysOverflowsLow, getBitWidth(), getSignedMax(), llvm::APInt::getSignedMaxValue(), getSignedMin(), llvm::APInt::getSignedMinValue(), isEmptySet(), llvm::APInt::isNegative(), llvm::APInt::isNonNegative(), MayOverflow, NeverOverflows, Other, llvm::APInt::sgt(), and llvm::APInt::slt().

Referenced by computeOverflowForSignedAdd().

◆ signedSubMayOverflow()

ConstantRange::OverflowResult ConstantRange::signedSubMayOverflow ( const ConstantRange & Other ) const

Return whether signed sub of the two ranges always/never overflows.

Definition at line 1634 of file ConstantRange.cpp.

References AlwaysOverflowsHigh, AlwaysOverflowsLow, getBitWidth(), getSignedMax(), llvm::APInt::getSignedMaxValue(), getSignedMin(), llvm::APInt::getSignedMinValue(), isEmptySet(), llvm::APInt::isNegative(), llvm::APInt::isNonNegative(), MayOverflow, NeverOverflows, Other, llvm::APInt::sgt(), and llvm::APInt::slt().

Referenced by llvm::computeOverflowForSignedSub().

◆ signExtend()

ConstantRange ConstantRange::signExtend ( uint32_t BitWidth ) const

Return a new range in the specified integer type, which must be strictly larger than the current type.

The returned range will correspond to the possible range of values if the source range had been sign extended to BitWidth.

Definition at line 707 of file ConstantRange.cpp.

References assert(), ConstantRange(), getBitWidth(), llvm::APInt::getHighBitsSet(), llvm::APInt::getLowBitsSet(), isEmptySet(), isFullSet(), llvm::APInt::isMinSignedValue(), isSignWrappedSet(), llvm::LegacyLegalizeActions::Lower, llvm::APInt::sext(), and llvm::APInt::zext().

Referenced by castOp(), llvm::ScalarEvolution::getSignExtendExpr(), and sextOrTrunc().

◆ smax()

ConstantRange ConstantRange::smax ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a signed maximum of a value in this range and a value in Other.

Definition at line 1059 of file ConstantRange.cpp.

References getNonEmpty(), getSignedMax(), getSignedMin(), intersectWith(), isEmptySet(), isSignWrappedSet(), move, Other, Signed, llvm::APIntOps::smax(), and unionWith().

◆ smin()

ConstantRange ConstantRange::smin ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a signed minimum of a value in this range and a value in Other.

Definition at line 1087 of file ConstantRange.cpp.

References getNonEmpty(), getSignedMax(), getSignedMin(), intersectWith(), isEmptySet(), isSignWrappedSet(), move, Other, Signed, llvm::APIntOps::smin(), and unionWith().

◆ smul_sat()

ConstantRange ConstantRange::smul_sat ( const ConstantRange & Other ) const

Perform a signed saturating multiplication of two constant ranges.

Definition at line 1476 of file ConstantRange.cpp.

References A, B, Compare, getBitWidth(), getNonEmpty(), getSignedMax(), getSignedMin(), isEmptySet(), llvm::max(), llvm::min(), Other, and llvm::APInt::sext().

◆ srem()

ConstantRange ConstantRange::srem ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a signed remainder operation of a value in this range and a value in Other.

Definition at line 1242 of file ConstantRange.cpp.

References abs(), ConstantRange(), getBitWidth(), llvm::APInt::getNullValue(), getSignedMax(), getSignedMin(), getSingleElement(), getUnsignedMax(), getUnsignedMin(), isEmptySet(), llvm::APInt::isNonNegative(), llvm::APInt::isNullValue(), llvm::LegacyLegalizeActions::Lower, move, llvm::APInt::ugt(), llvm::APIntOps::umax(), llvm::APIntOps::umin(), and llvm::Upper.

Referenced by binaryOp().

◆ sshl_sat()

ConstantRange ConstantRange::sshl_sat ( const ConstantRange & Other ) const

Perform a signed saturating left shift of this constant range by a value in Other.

Definition at line 1511 of file ConstantRange.cpp.

References getNonEmpty(), getSignedMax(), getSignedMin(), isEmptySet(), llvm::APInt::isNonNegative(), move, Other, and llvm::APInt::sshl_sat().

◆ ssub_sat()

ConstantRange ConstantRange::ssub_sat ( const ConstantRange & Other ) const

Perform a signed saturating subtraction of two constant ranges.

Definition at line 1458 of file ConstantRange.cpp.

References getNonEmpty(), getSignedMax(), getSignedMin(), isEmptySet(), move, Other, and llvm::APInt::ssub_sat().

Referenced by subWithNoWrap().

◆ sub()

ConstantRange ConstantRange::sub ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from a subtraction of a value in this range and a value in Other.

Definition at line 955 of file ConstantRange.cpp.

References ConstantRange(), getLower(), getUpper(), isEmptySet(), isFullSet(), move, Other, and X.

Referenced by llvm::ScalarEvolution::applyLoopGuards(), binaryOp(), and subWithNoWrap().

◆ subtract()

ConstantRange ConstantRange::subtract ( const APInt & CI ) const

Subtract the specified constant from the endpoints of this constant range.

Definition at line 436 of file ConstantRange.cpp.

References assert(), ConstantRange(), getBitWidth(), llvm::APInt::getBitWidth(), and llvm::LegacyLegalizeActions::Lower.

Referenced by llvm::InstCombinerImpl::foldICmpAddConstant(), llvm::SCEVAddRecExpr::getNumIterationsInRange(), getValueFromSimpleICmpCondition(), and llvm::InstCombinerImpl::visitExtractValueInst().

◆ subWithNoWrap()

ConstantRange ConstantRange::subWithNoWrap	(	const ConstantRange &	Other,
		unsigned	NoWrapKind,
		PreferredRangeType	RangeType = `Smallest`
	)		const

Return a new range representing the possible values resulting from an subtraction with wrap type NoWrapKind of a value in this range and a value in Other.

If the result range is disjoint, the preferred range is determined by the PreferredRangeType.

Definition at line 974 of file ConstantRange.cpp.

References getUnsignedMax(), isEmptySet(), isFullSet(), Other, ssub_sat(), sub(), and usub_sat().

Referenced by overflowingBinaryOp().

◆ truncate()

ConstantRange ConstantRange::truncate ( uint32_t BitWidth ) const

Return a new range in the specified integer type, which must be strictly smaller than the current type.

The returned range will correspond to the possible range of values if the source range had been truncated to the specified type.

Definition at line 725 of file ConstantRange.cpp.

References assert(), llvm::APInt::clearBit(), ConstantRange(), llvm::APInt::countTrailingOnes(), llvm::APInt::getActiveBits(), llvm::APInt::getBitsSetFrom(), getBitWidth(), llvm::APInt::getMaxValue(), isEmptySet(), isFullSet(), isUpperWrapped(), llvm::LegacyLegalizeActions::Lower, llvm::APInt::setAllBits(), llvm::APInt::trunc(), and llvm::APInt::ult().

Referenced by castOp(), llvm::ScalarEvolution::getSignExtendExpr(), llvm::ScalarEvolution::getZeroExtendExpr(), multiply(), sextOrTrunc(), and zextOrTrunc().

◆ uadd_sat()

ConstantRange ConstantRange::uadd_sat ( const ConstantRange & Other ) const

Perform an unsigned saturating addition of two constant ranges.

Definition at line 1431 of file ConstantRange.cpp.

References getNonEmpty(), getUnsignedMax(), getUnsignedMin(), isEmptySet(), move, Other, and llvm::APInt::uadd_sat().

Referenced by addWithNoWrap().

◆ udiv()

ConstantRange ConstantRange::udiv ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from an unsigned division of a value in this range and a value in Other.

Definition at line 1115 of file ConstantRange.cpp.

References getLower(), getNonEmpty(), getUnsignedMax(), getUnsignedMin(), getUpper(), isEmptySet(), llvm::APInt::isNullValue(), llvm::LegacyLegalizeActions::Lower, move, llvm::APInt::udiv(), and llvm::Upper.

Referenced by binaryOp().

◆ umax()

ConstantRange ConstantRange::umax ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from an unsigned maximum of a value in this range and a value in Other.

Definition at line 1073 of file ConstantRange.cpp.

References getNonEmpty(), getUnsignedMax(), getUnsignedMin(), intersectWith(), isEmptySet(), isWrappedSet(), move, Other, llvm::APIntOps::umax(), unionWith(), and Unsigned.

Referenced by binaryOr().

◆ umin()

ConstantRange ConstantRange::umin ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from an unsigned minimum of a value in this range and a value in Other.

Definition at line 1101 of file ConstantRange.cpp.

References getNonEmpty(), getUnsignedMax(), getUnsignedMin(), intersectWith(), isEmptySet(), isWrappedSet(), move, Other, llvm::APIntOps::umin(), unionWith(), and Unsigned.

Referenced by binaryAnd().

◆ umul_sat()

ConstantRange ConstantRange::umul_sat ( const ConstantRange & Other ) const

Perform an unsigned saturating multiplication of two constant ranges.

Definition at line 1467 of file ConstantRange.cpp.

References getNonEmpty(), getUnsignedMax(), getUnsignedMin(), isEmptySet(), move, Other, and llvm::APInt::umul_sat().

◆ unionWith()

ConstantRange ConstantRange::unionWith	(	const ConstantRange &	CR,
		PreferredRangeType	Type = `Smallest`
	)		const

Return the range that results from the union of this range with another range.

The resultant range is guaranteed to include the elements of both sets, but may contain more. For example, [3, 9) union [12,15) is [3, 15), which includes 9, 10, and 11, which were not included in either set before.

Definition at line 574 of file ConstantRange.cpp.

References assert(), ConstantRange(), getBitWidth(), getPreferredRange(), isEmptySet(), isFullSet(), llvm::APInt::isNullValue(), isUpperWrapped(), llvm::LegacyLegalizeActions::Lower, move, llvm::APInt::uge(), llvm::APInt::ugt(), llvm::APInt::ule(), llvm::APInt::ult(), and unionWith().

Referenced by llvm::getConstantRangeFromMetadata(), getEdgeValueLocal(), llvm::ValueLatticeElement::mergeIn(), sdiv(), smax(), smin(), tryMergeRange(), umax(), umin(), llvm::IntegerRangeState::unionAssumed(), llvm::IntegerRangeState::unionKnown(), and unionWith().

◆ unsignedAddMayOverflow()

ConstantRange::OverflowResult ConstantRange::unsignedAddMayOverflow ( const ConstantRange & Other ) const

Return whether unsigned add of the two ranges always/never overflows.

Definition at line 1572 of file ConstantRange.cpp.

References AlwaysOverflowsHigh, getUnsignedMax(), getUnsignedMin(), isEmptySet(), MayOverflow, NeverOverflows, Other, and llvm::APInt::ugt().

Referenced by llvm::computeOverflowForUnsignedAdd().

◆ unsignedMulMayOverflow()

ConstantRange::OverflowResult ConstantRange::unsignedMulMayOverflow ( const ConstantRange & Other ) const

Return whether unsigned mul of the two ranges always/never overflows.

Definition at line 1664 of file ConstantRange.cpp.

References AlwaysOverflowsHigh, getUnsignedMax(), getUnsignedMin(), isEmptySet(), MayOverflow, NeverOverflows, Other, and llvm::APInt::umul_ov().

Referenced by llvm::computeOverflowForUnsignedMul().

◆ unsignedSubMayOverflow()

ConstantRange::OverflowResult ConstantRange::unsignedSubMayOverflow ( const ConstantRange & Other ) const

Return whether unsigned sub of the two ranges always/never overflows.

Definition at line 1618 of file ConstantRange.cpp.

References AlwaysOverflowsLow, getUnsignedMax(), getUnsignedMin(), isEmptySet(), MayOverflow, NeverOverflows, Other, and llvm::APInt::ult().

Referenced by llvm::computeOverflowForUnsignedSub().

◆ urem()

ConstantRange ConstantRange::urem ( const ConstantRange & Other ) const

Return a new range representing the possible values resulting from an unsigned remainder operation of a value in this range and a value in Other.

Definition at line 1220 of file ConstantRange.cpp.

References getBitWidth(), getNonEmpty(), llvm::APInt::getNullValue(), getSingleElement(), getUnsignedMax(), getUnsignedMin(), isEmptySet(), llvm::APInt::isNullValue(), move, llvm::APIntOps::umin(), and llvm::Upper.

Referenced by binaryOp().

◆ ushl_sat()

ConstantRange ConstantRange::ushl_sat ( const ConstantRange & Other ) const

Perform an unsigned saturating left shift of this constant range by a value in Other.

Definition at line 1502 of file ConstantRange.cpp.

References getNonEmpty(), getUnsignedMax(), getUnsignedMin(), isEmptySet(), move, Other, and llvm::APInt::ushl_sat().

◆ usub_sat()

ConstantRange ConstantRange::usub_sat ( const ConstantRange & Other ) const

Perform an unsigned saturating subtraction of two constant ranges.

Definition at line 1449 of file ConstantRange.cpp.

References getNonEmpty(), getUnsignedMax(), getUnsignedMin(), isEmptySet(), move, Other, and llvm::APInt::usub_sat().

Referenced by subWithNoWrap().

◆ zeroExtend()

ConstantRange ConstantRange::zeroExtend ( uint32_t BitWidth ) const

Return a new range in the specified integer type, which must be strictly larger than the current type.

The returned range will correspond to the possible range of values if the source range had been zero extended to BitWidth.

Definition at line 690 of file ConstantRange.cpp.

References assert(), ConstantRange(), getBitWidth(), llvm::APInt::getOneBitSet(), isEmptySet(), isFullSet(), isUpperWrapped(), llvm::LegacyLegalizeActions::Lower, move, and llvm::APInt::zext().

Referenced by castOp(), llvm::ScalarEvolution::getZeroExtendExpr(), and zextOrTrunc().

◆ zextOrTrunc()

ConstantRange ConstantRange::zextOrTrunc ( uint32_t BitWidth ) const

Make this range have the bit width given by BitWidth.

The value is zero extended, truncated, or left alone to make it that width.

Definition at line 779 of file ConstantRange.cpp.

References getBitWidth(), truncate(), and zeroExtend().

Referenced by llvm::ScalarEvolution::getZeroExtendExpr().

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

include/llvm/IR/ConstantRange.h
lib/IR/ConstantRange.cpp

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ OverflowResult

◆ PreferredRangeType

Constructor & Destructor Documentation

◆ ConstantRange() [1/3]

◆ ConstantRange() [2/3]

◆ ConstantRange() [3/3]

Member Function Documentation

◆ abs()

◆ add()

◆ addWithNoWrap()

◆ ashr()

◆ binaryAnd()

◆ binaryNot()

◆ binaryOp()

◆ binaryOr()

◆ binaryXor()

◆ castOp()

◆ contains() [1/2]

◆ contains() [2/2]

◆ difference()

◆ dump()

◆ fromKnownBits()

◆ getActiveBits()

◆ getBitWidth()

◆ getEmpty()

◆ getEquivalentICmp()

◆ getFull()

◆ getLower()

◆ getMinSignedBits()

◆ getNonEmpty()

◆ getSignedMax()

◆ getSignedMin()

◆ getSingleElement()

◆ getSingleMissingElement()

◆ getUnsignedMax()

◆ getUnsignedMin()

◆ getUpper()

◆ icmp()

◆ intersectWith()

◆ intrinsic()

◆ inverse()

◆ isAllNegative()

◆ isAllNonNegative()

◆ isEmptySet()

◆ isFullSet()

◆ isIntrinsicSupported()

◆ isSignWrappedSet()

◆ isSingleElement()

◆ isSizeLargerThan()

◆ isSizeStrictlySmallerThan()

◆ isUpperSignWrapped()

◆ isUpperWrapped()

◆ isWrappedSet()

◆ lshr()

◆ makeAllowedICmpRegion()

◆ makeExactICmpRegion()

◆ makeExactNoWrapRegion()

◆ makeGuaranteedNoWrapRegion()

◆ makeSatisfyingICmpRegion()

◆ multiply()

◆ operator!=()

◆ operator==()

◆ overflowingBinaryOp()

◆ print()

◆ sadd_sat()

◆ sdiv()

◆ sextOrTrunc()

◆ shl()

◆ signedAddMayOverflow()

◆ signedSubMayOverflow()

◆ signExtend()

◆ smax()

◆ smin()

◆ smul_sat()

◆ srem()