Files
gps/tools/local/circt/include/llvm/Analysis/ScalarEvolutionPatternMatch.h
T
2026-07-12 11:01:51 +03:00

413 lines
13 KiB
C++

//===----------------------------------------------------------------------===//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
//
// This file provides a simple and efficient mechanism for performing general
// tree-based pattern matches on SCEVs, based on LLVM's IR pattern matchers.
//
//===----------------------------------------------------------------------===//
#ifndef LLVM_ANALYSIS_SCALAREVOLUTIONPATTERNMATCH_H
#define LLVM_ANALYSIS_SCALAREVOLUTIONPATTERNMATCH_H
#include "llvm/Analysis/ScalarEvolution.h"
#include "llvm/Analysis/ScalarEvolutionExpressions.h"
#include "llvm/Support/PatternMatchHelpers.h"
using namespace llvm::PatternMatchHelpers;
namespace llvm {
namespace PatternMatchHelpers {
template <typename SCEVPtrT> struct match_bind<SCEVUseT<SCEVPtrT>> {
SCEVUseT<SCEVPtrT> &VR;
match_bind(SCEVUseT<SCEVPtrT> &V) : VR(V) {}
template <typename ITy> bool match(ITy *V) const {
VR = V;
return true;
}
};
} // namespace PatternMatchHelpers
namespace SCEVPatternMatch {
template <typename Pattern> bool match(const SCEV *S, const Pattern &P) {
return P.match(S);
}
template <typename SCEVPtrT, typename Pattern>
bool match(const SCEVUseT<SCEVPtrT> U, const Pattern &P) {
return P.match(U.getPointer());
}
template <typename Predicate> struct cst_pred_ty : public Predicate {
cst_pred_ty() = default;
cst_pred_ty(uint64_t V) : Predicate(V) {}
bool match(const SCEV *S) const {
assert((isa<SCEVCouldNotCompute>(S) || !S->getType()->isVectorTy()) &&
"no vector types expected from SCEVs");
auto *C = dyn_cast<SCEVConstant>(S);
return C && this->isValue(C->getAPInt());
}
};
struct is_zero {
bool isValue(const APInt &C) const { return C.isZero(); }
};
/// Match an integer 0.
inline cst_pred_ty<is_zero> m_scev_Zero() { return cst_pred_ty<is_zero>(); }
struct is_one {
bool isValue(const APInt &C) const { return C.isOne(); }
};
/// Match an integer 1.
inline cst_pred_ty<is_one> m_scev_One() { return cst_pred_ty<is_one>(); }
struct is_all_ones {
bool isValue(const APInt &C) const { return C.isAllOnes(); }
};
/// Match an integer with all bits set.
inline cst_pred_ty<is_all_ones> m_scev_AllOnes() {
return cst_pred_ty<is_all_ones>();
}
inline auto m_SCEV() { return m_Isa<const SCEV>(); }
inline auto m_SCEVConstant() { return m_Isa<const SCEVConstant>(); }
inline auto m_SCEVVScale() { return m_Isa<const SCEVVScale>(); }
/// Match a SCEV, capturing it if we match.
inline match_bind<const SCEV> m_SCEV(const SCEV *&V) { return V; }
template <typename SCEVPtrT>
inline match_bind<SCEVUseT<SCEVPtrT>> m_SCEV(SCEVUseT<SCEVPtrT> &V) {
return V;
}
inline match_bind<const SCEVConstant> m_SCEVConstant(const SCEVConstant *&V) {
return V;
}
inline match_bind<const SCEVUnknown> m_SCEVUnknown(const SCEVUnknown *&V) {
return V;
}
inline match_bind<const SCEVAddExpr> m_scev_Add(const SCEVAddExpr *&V) {
return V;
}
inline match_bind<const SCEVMulExpr> m_scev_Mul(const SCEVMulExpr *&V) {
return V;
}
/// Match a specified const SCEV *.
struct specificscev_ty {
const SCEV *Expr;
specificscev_ty(const SCEV *Expr) : Expr(Expr) {}
template <typename ITy> bool match(ITy *S) const { return S == Expr; }
};
/// Match if we have a specific specified SCEV.
inline specificscev_ty m_scev_Specific(const SCEV *S) { return S; }
struct is_specific_cst {
uint64_t CV;
is_specific_cst(uint64_t C) : CV(C) {}
bool isValue(const APInt &C) const { return C == CV; }
};
/// Match an SCEV constant with a plain unsigned integer.
inline cst_pred_ty<is_specific_cst> m_scev_SpecificInt(uint64_t V) { return V; }
struct is_specific_signed_cst {
int64_t CV;
is_specific_signed_cst(int64_t C) : CV(C) {}
bool isValue(const APInt &C) const { return C.trySExtValue() == CV; }
};
/// Match an SCEV constant with a plain signed integer (sign-extended value will
/// be matched)
inline cst_pred_ty<is_specific_signed_cst> m_scev_SpecificSInt(int64_t V) {
return V;
}
struct bind_cst_ty {
const APInt *&CR;
bind_cst_ty(const APInt *&Op0) : CR(Op0) {}
bool match(const SCEV *S) const {
assert((isa<SCEVCouldNotCompute>(S) || !S->getType()->isVectorTy()) &&
"no vector types expected from SCEVs");
auto *C = dyn_cast<SCEVConstant>(S);
if (!C)
return false;
CR = &C->getAPInt();
return true;
}
};
/// Match an SCEV constant and bind it to an APInt.
inline bind_cst_ty m_scev_APInt(const APInt *&C) { return C; }
/// Match a unary SCEV.
template <typename SCEVTy, typename Op0_t> struct SCEVUnaryExpr_match {
Op0_t Op0;
SCEVUnaryExpr_match(Op0_t Op0) : Op0(Op0) {}
bool match(const SCEV *S) const {
auto *E = dyn_cast<SCEVTy>(S);
return E && E->getNumOperands() == 1 &&
Op0.match(E->getOperand(0).getPointer());
}
};
template <typename SCEVTy, typename Op0_t>
inline SCEVUnaryExpr_match<SCEVTy, Op0_t> m_scev_Unary(const Op0_t &Op0) {
return SCEVUnaryExpr_match<SCEVTy, Op0_t>(Op0);
}
template <typename Op0_t>
inline SCEVUnaryExpr_match<SCEVSignExtendExpr, Op0_t>
m_scev_SExt(const Op0_t &Op0) {
return m_scev_Unary<SCEVSignExtendExpr>(Op0);
}
template <typename Op0_t>
inline SCEVUnaryExpr_match<SCEVZeroExtendExpr, Op0_t>
m_scev_ZExt(const Op0_t &Op0) {
return m_scev_Unary<SCEVZeroExtendExpr>(Op0);
}
template <typename Op0_t>
inline SCEVUnaryExpr_match<SCEVPtrToIntExpr, Op0_t>
m_scev_PtrToInt(const Op0_t &Op0) {
return SCEVUnaryExpr_match<SCEVPtrToIntExpr, Op0_t>(Op0);
}
template <typename Op0_t>
inline SCEVUnaryExpr_match<SCEVPtrToAddrExpr, Op0_t>
m_scev_PtrToAddr(const Op0_t &Op0) {
return SCEVUnaryExpr_match<SCEVPtrToAddrExpr, Op0_t>(Op0);
}
template <typename Op0_t>
inline SCEVUnaryExpr_match<SCEVTruncateExpr, Op0_t>
m_scev_Trunc(const Op0_t &Op0) {
return m_scev_Unary<SCEVTruncateExpr>(Op0);
}
/// Match a binary SCEV.
template <typename SCEVTy, typename Op0_t, typename Op1_t,
SCEV::NoWrapFlags WrapFlags = SCEV::FlagAnyWrap,
bool Commutable = false>
struct SCEVBinaryExpr_match {
Op0_t Op0;
Op1_t Op1;
SCEVBinaryExpr_match(Op0_t Op0, Op1_t Op1) : Op0(Op0), Op1(Op1) {}
bool match(const SCEV *S) const {
if (auto WrappingS = dyn_cast<SCEVNAryExpr>(S))
if (WrappingS->getNoWrapFlags(WrapFlags) != WrapFlags)
return false;
auto *E = dyn_cast<SCEVTy>(S);
return E && E->getNumOperands() == 2 &&
((Op0.match(E->getOperand(0).getPointer()) &&
Op1.match(E->getOperand(1).getPointer())) ||
(Commutable && Op0.match(E->getOperand(1).getPointer()) &&
Op1.match(E->getOperand(0).getPointer())));
}
};
template <typename SCEVTy, typename Op0_t, typename Op1_t,
SCEV::NoWrapFlags WrapFlags = SCEV::FlagAnyWrap,
bool Commutable = false>
inline SCEVBinaryExpr_match<SCEVTy, Op0_t, Op1_t, WrapFlags, Commutable>
m_scev_Binary(const Op0_t &Op0, const Op1_t &Op1) {
return SCEVBinaryExpr_match<SCEVTy, Op0_t, Op1_t, WrapFlags, Commutable>(Op0,
Op1);
}
template <typename Op0_t, typename Op1_t>
inline SCEVBinaryExpr_match<SCEVAddExpr, Op0_t, Op1_t>
m_scev_Add(const Op0_t &Op0, const Op1_t &Op1) {
return m_scev_Binary<SCEVAddExpr>(Op0, Op1);
}
template <typename Op0_t, typename Op1_t>
inline SCEVBinaryExpr_match<SCEVMulExpr, Op0_t, Op1_t>
m_scev_Mul(const Op0_t &Op0, const Op1_t &Op1) {
return m_scev_Binary<SCEVMulExpr>(Op0, Op1);
}
template <typename Op0_t, typename Op1_t>
inline SCEVBinaryExpr_match<SCEVMulExpr, Op0_t, Op1_t, SCEV::FlagAnyWrap, true>
m_scev_c_Mul(const Op0_t &Op0, const Op1_t &Op1) {
return m_scev_Binary<SCEVMulExpr, Op0_t, Op1_t, SCEV::FlagAnyWrap, true>(Op0,
Op1);
}
template <typename Op0_t, typename Op1_t>
inline SCEVBinaryExpr_match<SCEVMulExpr, Op0_t, Op1_t, SCEV::FlagNUW, true>
m_scev_c_NUWMul(const Op0_t &Op0, const Op1_t &Op1) {
return m_scev_Binary<SCEVMulExpr, Op0_t, Op1_t, SCEV::FlagNUW, true>(Op0,
Op1);
}
template <typename Op0_t, typename Op1_t>
inline SCEVBinaryExpr_match<SCEVUDivExpr, Op0_t, Op1_t>
m_scev_UDiv(const Op0_t &Op0, const Op1_t &Op1) {
return m_scev_Binary<SCEVUDivExpr>(Op0, Op1);
}
template <typename Op0_t, typename Op1_t>
inline SCEVBinaryExpr_match<SCEVSMaxExpr, Op0_t, Op1_t>
m_scev_SMax(const Op0_t &Op0, const Op1_t &Op1) {
return m_scev_Binary<SCEVSMaxExpr>(Op0, Op1);
}
template <typename Op0_t, typename Op1_t>
inline SCEVBinaryExpr_match<SCEVMinMaxExpr, Op0_t, Op1_t>
m_scev_MinMax(const Op0_t &Op0, const Op1_t &Op1) {
return m_scev_Binary<SCEVMinMaxExpr>(Op0, Op1);
}
/// Match unsigned remainder pattern.
/// Matches patterns generated by getURemExpr.
template <typename Op0_t, typename Op1_t> struct SCEVURem_match {
Op0_t Op0;
Op1_t Op1;
ScalarEvolution &SE;
SCEVURem_match(Op0_t Op0, Op1_t Op1, ScalarEvolution &SE)
: Op0(Op0), Op1(Op1), SE(SE) {}
bool match(const SCEV *Expr) const {
if (Expr->getType()->isPointerTy())
return false;
// Try to match 'zext (trunc A to iB) to iY', which is used
// for URem with constant power-of-2 second operands. Make sure the size of
// the operand A matches the size of the whole expressions.
const SCEV *LHS;
if (SCEVPatternMatch::match(Expr, m_scev_ZExt(m_scev_Trunc(m_SCEV(LHS))))) {
Type *TruncTy = cast<SCEVZeroExtendExpr>(Expr)->getOperand()->getType();
// Bail out if the type of the LHS is larger than the type of the
// expression for now.
if (SE.getTypeSizeInBits(LHS->getType()) >
SE.getTypeSizeInBits(Expr->getType()))
return false;
if (LHS->getType() != Expr->getType())
LHS = SE.getZeroExtendExpr(LHS, Expr->getType());
const SCEV *RHS =
SE.getConstant(APInt(SE.getTypeSizeInBits(Expr->getType()), 1)
<< SE.getTypeSizeInBits(TruncTy));
return Op0.match(LHS) && Op1.match(RHS);
}
const SCEV *A;
const SCEVMulExpr *Mul;
if (!SCEVPatternMatch::match(Expr, m_scev_Add(m_scev_Mul(Mul), m_SCEV(A))))
return false;
const auto MatchURemWithDivisor = [&](const SCEV *B) {
// (SomeExpr + (-(SomeExpr / B) * B)).
if (Expr == SE.getURemExpr(A, B))
return Op0.match(A) && Op1.match(B);
return false;
};
// (SomeExpr + (-1 * (SomeExpr / B) * B)).
if (Mul->getNumOperands() == 3 && isa<SCEVConstant>(Mul->getOperand(0)))
return MatchURemWithDivisor(Mul->getOperand(1)) ||
MatchURemWithDivisor(Mul->getOperand(2));
// (SomeExpr + ((-SomeExpr / B) * B)) or (SomeExpr + ((SomeExpr / B) * -B)).
if (Mul->getNumOperands() == 2)
return MatchURemWithDivisor(Mul->getOperand(1)) ||
MatchURemWithDivisor(Mul->getOperand(0)) ||
MatchURemWithDivisor(SE.getNegativeSCEV(Mul->getOperand(1))) ||
MatchURemWithDivisor(SE.getNegativeSCEV(Mul->getOperand(0)));
return false;
}
};
/// Match the mathematical pattern A - (A / B) * B, where A and B can be
/// arbitrary expressions. Also match zext (trunc A to iB) to iY, which is used
/// for URem with constant power-of-2 second operands. It's not always easy, as
/// A and B can be folded (imagine A is X / 2, and B is 4, A / B becomes X / 8).
template <typename Op0_t, typename Op1_t>
inline SCEVURem_match<Op0_t, Op1_t> m_scev_URem(Op0_t LHS, Op1_t RHS,
ScalarEvolution &SE) {
return SCEVURem_match<Op0_t, Op1_t>(LHS, RHS, SE);
}
inline auto m_Loop() { return m_Isa<const Loop>(); }
/// Match an affine SCEVAddRecExpr.
template <typename Op0_t, typename Op1_t, typename Loop_t>
struct SCEVAffineAddRec_match {
SCEVBinaryExpr_match<SCEVAddRecExpr, Op0_t, Op1_t> Ops;
Loop_t Loop;
SCEVAffineAddRec_match(Op0_t Op0, Op1_t Op1, Loop_t Loop)
: Ops(Op0, Op1), Loop(Loop) {}
bool match(const SCEV *S) const {
return Ops.match(S) && Loop.match(cast<SCEVAddRecExpr>(S)->getLoop());
}
};
/// Match a specified const Loop*.
struct specificloop_ty {
const Loop *L;
specificloop_ty(const Loop *L) : L(L) {}
bool match(const Loop *L) const { return L == this->L; }
};
inline specificloop_ty m_SpecificLoop(const Loop *L) { return L; }
inline match_bind<const Loop> m_Loop(const Loop *&L) { return L; }
template <typename Op0_t, typename Op1_t>
inline SCEVAffineAddRec_match<Op0_t, Op1_t, match_isa<const Loop>>
m_scev_AffineAddRec(const Op0_t &Op0, const Op1_t &Op1) {
return SCEVAffineAddRec_match<Op0_t, Op1_t, match_isa<const Loop>>(Op0, Op1,
m_Loop());
}
template <typename Op0_t, typename Op1_t, typename Loop_t>
inline SCEVAffineAddRec_match<Op0_t, Op1_t, Loop_t>
m_scev_AffineAddRec(const Op0_t &Op0, const Op1_t &Op1, const Loop_t &L) {
return SCEVAffineAddRec_match<Op0_t, Op1_t, Loop_t>(Op0, Op1, L);
}
struct is_undef_or_poison {
bool match(const SCEV *S) const {
const SCEVUnknown *Unknown;
return SCEVPatternMatch::match(S, m_SCEVUnknown(Unknown)) &&
isa<UndefValue>(Unknown->getValue());
}
};
/// Match an SCEVUnknown wrapping undef or poison.
inline is_undef_or_poison m_scev_UndefOrPoison() {
return is_undef_or_poison();
}
} // namespace SCEVPatternMatch
} // namespace llvm
#endif