Bug Summary

File:llvm/lib/Transforms/InstCombine/InstCombineMulDivRem.cpp
Warning:line 687, column 24
Called C++ object pointer is null

Annotated Source Code

Press '?' to see keyboard shortcuts

clang -cc1 -cc1 -triple x86_64-pc-linux-gnu -analyze -disable-free -clear-ast-before-backend -disable-llvm-verifier -discard-value-names -main-file-name InstCombineMulDivRem.cpp -analyzer-store=region -analyzer-opt-analyze-nested-blocks -analyzer-checker=core -analyzer-checker=apiModeling -analyzer-checker=unix -analyzer-checker=deadcode -analyzer-checker=cplusplus -analyzer-checker=security.insecureAPI.UncheckedReturn -analyzer-checker=security.insecureAPI.getpw -analyzer-checker=security.insecureAPI.gets -analyzer-checker=security.insecureAPI.mktemp -analyzer-checker=security.insecureAPI.mkstemp -analyzer-checker=security.insecureAPI.vfork -analyzer-checker=nullability.NullPassedToNonnull -analyzer-checker=nullability.NullReturnedFromNonnull -analyzer-output plist -w -setup-static-analyzer -analyzer-config-compatibility-mode=true -mrelocation-model pic -pic-level 2 -mframe-pointer=none -fmath-errno -ffp-contract=on -fno-rounding-math -mconstructor-aliases -funwind-tables=2 -target-cpu x86-64 -tune-cpu generic -debugger-tuning=gdb -ffunction-sections -fdata-sections -fcoverage-compilation-dir=/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/build-llvm -resource-dir /usr/lib/llvm-14/lib/clang/14.0.0 -D _DEBUG -D _GNU_SOURCE -D __STDC_CONSTANT_MACROS -D __STDC_FORMAT_MACROS -D __STDC_LIMIT_MACROS -I lib/Transforms/InstCombine -I /build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/llvm/lib/Transforms/InstCombine -I include -I /build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/llvm/include -D _FORTIFY_SOURCE=2 -D NDEBUG -U NDEBUG -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/10/../../../../include/c++/10 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/10/../../../../include/x86_64-linux-gnu/c++/10 -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/10/../../../../include/c++/10/backward -internal-isystem /usr/lib/llvm-14/lib/clang/14.0.0/include -internal-isystem /usr/local/include -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/10/../../../../x86_64-linux-gnu/include -internal-externc-isystem /usr/include/x86_64-linux-gnu -internal-externc-isystem /include -internal-externc-isystem /usr/include -fmacro-prefix-map=/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/build-llvm=build-llvm -fmacro-prefix-map=/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/= -fcoverage-prefix-map=/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/build-llvm=build-llvm -fcoverage-prefix-map=/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/= -O3 -Wno-unused-command-line-argument -Wno-unused-parameter -Wwrite-strings -Wno-missing-field-initializers -Wno-long-long -Wno-maybe-uninitialized -Wno-class-memaccess -Wno-redundant-move -Wno-pessimizing-move -Wno-noexcept-type -Wno-comment -std=c++14 -fdeprecated-macro -fdebug-compilation-dir=/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/build-llvm -fdebug-prefix-map=/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/build-llvm=build-llvm -fdebug-prefix-map=/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/= -ferror-limit 19 -fvisibility-inlines-hidden -stack-protector 2 -fgnuc-version=4.2.1 -fcolor-diagnostics -vectorize-loops -vectorize-slp -analyzer-output=html -analyzer-config stable-report-filename=true -faddrsig -D__GCC_HAVE_DWARF2_CFI_ASM=1 -o /tmp/scan-build-2022-01-19-134126-35450-1 -x c++ /build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/llvm/lib/Transforms/InstCombine/InstCombineMulDivRem.cpp

/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/llvm/lib/Transforms/InstCombine/InstCombineMulDivRem.cpp

1//===- InstCombineMulDivRem.cpp -------------------------------------------===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file implements the visit functions for mul, fmul, sdiv, udiv, fdiv,
10// srem, urem, frem.
11//
12//===----------------------------------------------------------------------===//
13
14#include "InstCombineInternal.h"
15#include "llvm/ADT/APFloat.h"
16#include "llvm/ADT/APInt.h"
17#include "llvm/ADT/SmallVector.h"
18#include "llvm/Analysis/InstructionSimplify.h"
19#include "llvm/IR/BasicBlock.h"
20#include "llvm/IR/Constant.h"
21#include "llvm/IR/Constants.h"
22#include "llvm/IR/InstrTypes.h"
23#include "llvm/IR/Instruction.h"
24#include "llvm/IR/Instructions.h"
25#include "llvm/IR/IntrinsicInst.h"
26#include "llvm/IR/Intrinsics.h"
27#include "llvm/IR/Operator.h"
28#include "llvm/IR/PatternMatch.h"
29#include "llvm/IR/Type.h"
30#include "llvm/IR/Value.h"
31#include "llvm/Support/Casting.h"
32#include "llvm/Support/ErrorHandling.h"
33#include "llvm/Support/KnownBits.h"
34#include "llvm/Transforms/InstCombine/InstCombiner.h"
35#include "llvm/Transforms/Utils/BuildLibCalls.h"
36#include <cassert>
37#include <cstddef>
38#include <cstdint>
39#include <utility>
40
41#define DEBUG_TYPE"instcombine" "instcombine"
42#include "llvm/Transforms/Utils/InstructionWorklist.h"
43
44using namespace llvm;
45using namespace PatternMatch;
46
47/// The specific integer value is used in a context where it is known to be
48/// non-zero. If this allows us to simplify the computation, do so and return
49/// the new operand, otherwise return null.
50static Value *simplifyValueKnownNonZero(Value *V, InstCombinerImpl &IC,
51 Instruction &CxtI) {
52 // If V has multiple uses, then we would have to do more analysis to determine
53 // if this is safe. For example, the use could be in dynamically unreached
54 // code.
55 if (!V->hasOneUse()) return nullptr;
56
57 bool MadeChange = false;
58
59 // ((1 << A) >>u B) --> (1 << (A-B))
60 // Because V cannot be zero, we know that B is less than A.
61 Value *A = nullptr, *B = nullptr, *One = nullptr;
62 if (match(V, m_LShr(m_OneUse(m_Shl(m_Value(One), m_Value(A))), m_Value(B))) &&
63 match(One, m_One())) {
64 A = IC.Builder.CreateSub(A, B);
65 return IC.Builder.CreateShl(One, A);
66 }
67
68 // (PowerOfTwo >>u B) --> isExact since shifting out the result would make it
69 // inexact. Similarly for <<.
70 BinaryOperator *I = dyn_cast<BinaryOperator>(V);
71 if (I && I->isLogicalShift() &&
72 IC.isKnownToBeAPowerOfTwo(I->getOperand(0), false, 0, &CxtI)) {
73 // We know that this is an exact/nuw shift and that the input is a
74 // non-zero context as well.
75 if (Value *V2 = simplifyValueKnownNonZero(I->getOperand(0), IC, CxtI)) {
76 IC.replaceOperand(*I, 0, V2);
77 MadeChange = true;
78 }
79
80 if (I->getOpcode() == Instruction::LShr && !I->isExact()) {
81 I->setIsExact();
82 MadeChange = true;
83 }
84
85 if (I->getOpcode() == Instruction::Shl && !I->hasNoUnsignedWrap()) {
86 I->setHasNoUnsignedWrap();
87 MadeChange = true;
88 }
89 }
90
91 // TODO: Lots more we could do here:
92 // If V is a phi node, we can call this on each of its operands.
93 // "select cond, X, 0" can simplify to "X".
94
95 return MadeChange ? V : nullptr;
96}
97
98// TODO: This is a specific form of a much more general pattern.
99// We could detect a select with any binop identity constant, or we
100// could use SimplifyBinOp to see if either arm of the select reduces.
101// But that needs to be done carefully and/or while removing potential
102// reverse canonicalizations as in InstCombiner::foldSelectIntoOp().
103static Value *foldMulSelectToNegate(BinaryOperator &I,
104 InstCombiner::BuilderTy &Builder) {
105 Value *Cond, *OtherOp;
106
107 // mul (select Cond, 1, -1), OtherOp --> select Cond, OtherOp, -OtherOp
108 // mul OtherOp, (select Cond, 1, -1) --> select Cond, OtherOp, -OtherOp
109 if (match(&I, m_c_Mul(m_OneUse(m_Select(m_Value(Cond), m_One(), m_AllOnes())),
110 m_Value(OtherOp)))) {
111 bool HasAnyNoWrap = I.hasNoSignedWrap() || I.hasNoUnsignedWrap();
112 Value *Neg = Builder.CreateNeg(OtherOp, "", false, HasAnyNoWrap);
113 return Builder.CreateSelect(Cond, OtherOp, Neg);
114 }
115 // mul (select Cond, -1, 1), OtherOp --> select Cond, -OtherOp, OtherOp
116 // mul OtherOp, (select Cond, -1, 1) --> select Cond, -OtherOp, OtherOp
117 if (match(&I, m_c_Mul(m_OneUse(m_Select(m_Value(Cond), m_AllOnes(), m_One())),
118 m_Value(OtherOp)))) {
119 bool HasAnyNoWrap = I.hasNoSignedWrap() || I.hasNoUnsignedWrap();
120 Value *Neg = Builder.CreateNeg(OtherOp, "", false, HasAnyNoWrap);
121 return Builder.CreateSelect(Cond, Neg, OtherOp);
122 }
123
124 // fmul (select Cond, 1.0, -1.0), OtherOp --> select Cond, OtherOp, -OtherOp
125 // fmul OtherOp, (select Cond, 1.0, -1.0) --> select Cond, OtherOp, -OtherOp
126 if (match(&I, m_c_FMul(m_OneUse(m_Select(m_Value(Cond), m_SpecificFP(1.0),
127 m_SpecificFP(-1.0))),
128 m_Value(OtherOp)))) {
129 IRBuilder<>::FastMathFlagGuard FMFGuard(Builder);
130 Builder.setFastMathFlags(I.getFastMathFlags());
131 return Builder.CreateSelect(Cond, OtherOp, Builder.CreateFNeg(OtherOp));
132 }
133
134 // fmul (select Cond, -1.0, 1.0), OtherOp --> select Cond, -OtherOp, OtherOp
135 // fmul OtherOp, (select Cond, -1.0, 1.0) --> select Cond, -OtherOp, OtherOp
136 if (match(&I, m_c_FMul(m_OneUse(m_Select(m_Value(Cond), m_SpecificFP(-1.0),
137 m_SpecificFP(1.0))),
138 m_Value(OtherOp)))) {
139 IRBuilder<>::FastMathFlagGuard FMFGuard(Builder);
140 Builder.setFastMathFlags(I.getFastMathFlags());
141 return Builder.CreateSelect(Cond, Builder.CreateFNeg(OtherOp), OtherOp);
142 }
143
144 return nullptr;
145}
146
147Instruction *InstCombinerImpl::visitMul(BinaryOperator &I) {
148 if (Value *V = SimplifyMulInst(I.getOperand(0), I.getOperand(1),
149 SQ.getWithInstruction(&I)))
150 return replaceInstUsesWith(I, V);
151
152 if (SimplifyAssociativeOrCommutative(I))
153 return &I;
154
155 if (Instruction *X = foldVectorBinop(I))
156 return X;
157
158 if (Value *V = SimplifyUsingDistributiveLaws(I))
159 return replaceInstUsesWith(I, V);
160
161 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
162 unsigned BitWidth = I.getType()->getScalarSizeInBits();
163
164 // X * -1 == 0 - X
165 if (match(Op1, m_AllOnes())) {
166 BinaryOperator *BO = BinaryOperator::CreateNeg(Op0, I.getName());
167 if (I.hasNoSignedWrap())
168 BO->setHasNoSignedWrap();
169 return BO;
170 }
171
172 // Also allow combining multiply instructions on vectors.
173 {
174 Value *NewOp;
175 Constant *C1, *C2;
176 const APInt *IVal;
177 if (match(&I, m_Mul(m_Shl(m_Value(NewOp), m_Constant(C2)),
178 m_Constant(C1))) &&
179 match(C1, m_APInt(IVal))) {
180 // ((X << C2)*C1) == (X * (C1 << C2))
181 Constant *Shl = ConstantExpr::getShl(C1, C2);
182 BinaryOperator *Mul = cast<BinaryOperator>(I.getOperand(0));
183 BinaryOperator *BO = BinaryOperator::CreateMul(NewOp, Shl);
184 if (I.hasNoUnsignedWrap() && Mul->hasNoUnsignedWrap())
185 BO->setHasNoUnsignedWrap();
186 if (I.hasNoSignedWrap() && Mul->hasNoSignedWrap() &&
187 Shl->isNotMinSignedValue())
188 BO->setHasNoSignedWrap();
189 return BO;
190 }
191
192 if (match(&I, m_Mul(m_Value(NewOp), m_Constant(C1)))) {
193 // Replace X*(2^C) with X << C, where C is either a scalar or a vector.
194 if (Constant *NewCst = ConstantExpr::getExactLogBase2(C1)) {
195 BinaryOperator *Shl = BinaryOperator::CreateShl(NewOp, NewCst);
196
197 if (I.hasNoUnsignedWrap())
198 Shl->setHasNoUnsignedWrap();
199 if (I.hasNoSignedWrap()) {
200 const APInt *V;
201 if (match(NewCst, m_APInt(V)) && *V != V->getBitWidth() - 1)
202 Shl->setHasNoSignedWrap();
203 }
204
205 return Shl;
206 }
207 }
208 }
209
210 if (Op0->hasOneUse() && match(Op1, m_NegatedPower2())) {
211 // Interpret X * (-1<<C) as (-X) * (1<<C) and try to sink the negation.
212 // The "* (1<<C)" thus becomes a potential shifting opportunity.
213 if (Value *NegOp0 = Negator::Negate(/*IsNegation*/ true, Op0, *this))
214 return BinaryOperator::CreateMul(
215 NegOp0, ConstantExpr::getNeg(cast<Constant>(Op1)), I.getName());
216 }
217
218 if (Instruction *FoldedMul = foldBinOpIntoSelectOrPhi(I))
219 return FoldedMul;
220
221 if (Value *FoldedMul = foldMulSelectToNegate(I, Builder))
222 return replaceInstUsesWith(I, FoldedMul);
223
224 // Simplify mul instructions with a constant RHS.
225 if (isa<Constant>(Op1)) {
226 // Canonicalize (X+C1)*CI -> X*CI+C1*CI.
227 Value *X;
228 Constant *C1;
229 if (match(Op0, m_OneUse(m_Add(m_Value(X), m_Constant(C1))))) {
230 Value *Mul = Builder.CreateMul(C1, Op1);
231 // Only go forward with the transform if C1*CI simplifies to a tidier
232 // constant.
233 if (!match(Mul, m_Mul(m_Value(), m_Value())))
234 return BinaryOperator::CreateAdd(Builder.CreateMul(X, Op1), Mul);
235 }
236 }
237
238 // abs(X) * abs(X) -> X * X
239 // nabs(X) * nabs(X) -> X * X
240 if (Op0 == Op1) {
241 Value *X, *Y;
242 SelectPatternFlavor SPF = matchSelectPattern(Op0, X, Y).Flavor;
243 if (SPF == SPF_ABS || SPF == SPF_NABS)
244 return BinaryOperator::CreateMul(X, X);
245
246 if (match(Op0, m_Intrinsic<Intrinsic::abs>(m_Value(X))))
247 return BinaryOperator::CreateMul(X, X);
248 }
249
250 // -X * C --> X * -C
251 Value *X, *Y;
252 Constant *Op1C;
253 if (match(Op0, m_Neg(m_Value(X))) && match(Op1, m_Constant(Op1C)))
254 return BinaryOperator::CreateMul(X, ConstantExpr::getNeg(Op1C));
255
256 // -X * -Y --> X * Y
257 if (match(Op0, m_Neg(m_Value(X))) && match(Op1, m_Neg(m_Value(Y)))) {
258 auto *NewMul = BinaryOperator::CreateMul(X, Y);
259 if (I.hasNoSignedWrap() &&
260 cast<OverflowingBinaryOperator>(Op0)->hasNoSignedWrap() &&
261 cast<OverflowingBinaryOperator>(Op1)->hasNoSignedWrap())
262 NewMul->setHasNoSignedWrap();
263 return NewMul;
264 }
265
266 // -X * Y --> -(X * Y)
267 // X * -Y --> -(X * Y)
268 if (match(&I, m_c_Mul(m_OneUse(m_Neg(m_Value(X))), m_Value(Y))))
269 return BinaryOperator::CreateNeg(Builder.CreateMul(X, Y));
270
271 // (X / Y) * Y = X - (X % Y)
272 // (X / Y) * -Y = (X % Y) - X
273 {
274 Value *Y = Op1;
275 BinaryOperator *Div = dyn_cast<BinaryOperator>(Op0);
276 if (!Div || (Div->getOpcode() != Instruction::UDiv &&
277 Div->getOpcode() != Instruction::SDiv)) {
278 Y = Op0;
279 Div = dyn_cast<BinaryOperator>(Op1);
280 }
281 Value *Neg = dyn_castNegVal(Y);
282 if (Div && Div->hasOneUse() &&
283 (Div->getOperand(1) == Y || Div->getOperand(1) == Neg) &&
284 (Div->getOpcode() == Instruction::UDiv ||
285 Div->getOpcode() == Instruction::SDiv)) {
286 Value *X = Div->getOperand(0), *DivOp1 = Div->getOperand(1);
287
288 // If the division is exact, X % Y is zero, so we end up with X or -X.
289 if (Div->isExact()) {
290 if (DivOp1 == Y)
291 return replaceInstUsesWith(I, X);
292 return BinaryOperator::CreateNeg(X);
293 }
294
295 auto RemOpc = Div->getOpcode() == Instruction::UDiv ? Instruction::URem
296 : Instruction::SRem;
297 Value *Rem = Builder.CreateBinOp(RemOpc, X, DivOp1);
298 if (DivOp1 == Y)
299 return BinaryOperator::CreateSub(X, Rem);
300 return BinaryOperator::CreateSub(Rem, X);
301 }
302 }
303
304 /// i1 mul -> i1 and.
305 if (I.getType()->isIntOrIntVectorTy(1))
306 return BinaryOperator::CreateAnd(Op0, Op1);
307
308 // X*(1 << Y) --> X << Y
309 // (1 << Y)*X --> X << Y
310 {
311 Value *Y;
312 BinaryOperator *BO = nullptr;
313 bool ShlNSW = false;
314 if (match(Op0, m_Shl(m_One(), m_Value(Y)))) {
315 BO = BinaryOperator::CreateShl(Op1, Y);
316 ShlNSW = cast<ShlOperator>(Op0)->hasNoSignedWrap();
317 } else if (match(Op1, m_Shl(m_One(), m_Value(Y)))) {
318 BO = BinaryOperator::CreateShl(Op0, Y);
319 ShlNSW = cast<ShlOperator>(Op1)->hasNoSignedWrap();
320 }
321 if (BO) {
322 if (I.hasNoUnsignedWrap())
323 BO->setHasNoUnsignedWrap();
324 if (I.hasNoSignedWrap() && ShlNSW)
325 BO->setHasNoSignedWrap();
326 return BO;
327 }
328 }
329
330 // (zext bool X) * (zext bool Y) --> zext (and X, Y)
331 // (sext bool X) * (sext bool Y) --> zext (and X, Y)
332 // Note: -1 * -1 == 1 * 1 == 1 (if the extends match, the result is the same)
333 if (((match(Op0, m_ZExt(m_Value(X))) && match(Op1, m_ZExt(m_Value(Y)))) ||
334 (match(Op0, m_SExt(m_Value(X))) && match(Op1, m_SExt(m_Value(Y))))) &&
335 X->getType()->isIntOrIntVectorTy(1) && X->getType() == Y->getType() &&
336 (Op0->hasOneUse() || Op1->hasOneUse() || X == Y)) {
337 Value *And = Builder.CreateAnd(X, Y, "mulbool");
338 return CastInst::Create(Instruction::ZExt, And, I.getType());
339 }
340 // (sext bool X) * (zext bool Y) --> sext (and X, Y)
341 // (zext bool X) * (sext bool Y) --> sext (and X, Y)
342 // Note: -1 * 1 == 1 * -1 == -1
343 if (((match(Op0, m_SExt(m_Value(X))) && match(Op1, m_ZExt(m_Value(Y)))) ||
344 (match(Op0, m_ZExt(m_Value(X))) && match(Op1, m_SExt(m_Value(Y))))) &&
345 X->getType()->isIntOrIntVectorTy(1) && X->getType() == Y->getType() &&
346 (Op0->hasOneUse() || Op1->hasOneUse())) {
347 Value *And = Builder.CreateAnd(X, Y, "mulbool");
348 return CastInst::Create(Instruction::SExt, And, I.getType());
349 }
350
351 // (bool X) * Y --> X ? Y : 0
352 // Y * (bool X) --> X ? Y : 0
353 if (match(Op0, m_ZExt(m_Value(X))) && X->getType()->isIntOrIntVectorTy(1))
354 return SelectInst::Create(X, Op1, ConstantInt::get(I.getType(), 0));
355 if (match(Op1, m_ZExt(m_Value(X))) && X->getType()->isIntOrIntVectorTy(1))
356 return SelectInst::Create(X, Op0, ConstantInt::get(I.getType(), 0));
357
358 // (lshr X, 31) * Y --> (ashr X, 31) & Y
359 // Y * (lshr X, 31) --> (ashr X, 31) & Y
360 // TODO: We are not checking one-use because the elimination of the multiply
361 // is better for analysis?
362 // TODO: Should we canonicalize to '(X < 0) ? Y : 0' instead? That would be
363 // more similar to what we're doing above.
364 const APInt *C;
365 if (match(Op0, m_LShr(m_Value(X), m_APInt(C))) && *C == C->getBitWidth() - 1)
366 return BinaryOperator::CreateAnd(Builder.CreateAShr(X, *C), Op1);
367 if (match(Op1, m_LShr(m_Value(X), m_APInt(C))) && *C == C->getBitWidth() - 1)
368 return BinaryOperator::CreateAnd(Builder.CreateAShr(X, *C), Op0);
369
370 // ((ashr X, 31) | 1) * X --> abs(X)
371 // X * ((ashr X, 31) | 1) --> abs(X)
372 if (match(&I, m_c_BinOp(m_Or(m_AShr(m_Value(X),
373 m_SpecificIntAllowUndef(BitWidth - 1)),
374 m_One()),
375 m_Deferred(X)))) {
376 Value *Abs = Builder.CreateBinaryIntrinsic(
377 Intrinsic::abs, X,
378 ConstantInt::getBool(I.getContext(), I.hasNoSignedWrap()));
379 Abs->takeName(&I);
380 return replaceInstUsesWith(I, Abs);
381 }
382
383 if (Instruction *Ext = narrowMathIfNoOverflow(I))
384 return Ext;
385
386 bool Changed = false;
387 if (!I.hasNoSignedWrap() && willNotOverflowSignedMul(Op0, Op1, I)) {
388 Changed = true;
389 I.setHasNoSignedWrap(true);
390 }
391
392 if (!I.hasNoUnsignedWrap() && willNotOverflowUnsignedMul(Op0, Op1, I)) {
393 Changed = true;
394 I.setHasNoUnsignedWrap(true);
395 }
396
397 return Changed ? &I : nullptr;
398}
399
400Instruction *InstCombinerImpl::foldFPSignBitOps(BinaryOperator &I) {
401 BinaryOperator::BinaryOps Opcode = I.getOpcode();
402 assert((Opcode == Instruction::FMul || Opcode == Instruction::FDiv) &&(static_cast <bool> ((Opcode == Instruction::FMul || Opcode
== Instruction::FDiv) && "Expected fmul or fdiv") ? void
(0) : __assert_fail ("(Opcode == Instruction::FMul || Opcode == Instruction::FDiv) && \"Expected fmul or fdiv\""
, "llvm/lib/Transforms/InstCombine/InstCombineMulDivRem.cpp",
403, __extension__ __PRETTY_FUNCTION__))
403 "Expected fmul or fdiv")(static_cast <bool> ((Opcode == Instruction::FMul || Opcode
== Instruction::FDiv) && "Expected fmul or fdiv") ? void
(0) : __assert_fail ("(Opcode == Instruction::FMul || Opcode == Instruction::FDiv) && \"Expected fmul or fdiv\""
, "llvm/lib/Transforms/InstCombine/InstCombineMulDivRem.cpp",
403, __extension__ __PRETTY_FUNCTION__))
;
404
405 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
406 Value *X, *Y;
407
408 // -X * -Y --> X * Y
409 // -X / -Y --> X / Y
410 if (match(Op0, m_FNeg(m_Value(X))) && match(Op1, m_FNeg(m_Value(Y))))
411 return BinaryOperator::CreateWithCopiedFlags(Opcode, X, Y, &I);
412
413 // fabs(X) * fabs(X) -> X * X
414 // fabs(X) / fabs(X) -> X / X
415 if (Op0 == Op1 && match(Op0, m_FAbs(m_Value(X))))
416 return BinaryOperator::CreateWithCopiedFlags(Opcode, X, X, &I);
417
418 // fabs(X) * fabs(Y) --> fabs(X * Y)
419 // fabs(X) / fabs(Y) --> fabs(X / Y)
420 if (match(Op0, m_FAbs(m_Value(X))) && match(Op1, m_FAbs(m_Value(Y))) &&
421 (Op0->hasOneUse() || Op1->hasOneUse())) {
422 IRBuilder<>::FastMathFlagGuard FMFGuard(Builder);
423 Builder.setFastMathFlags(I.getFastMathFlags());
424 Value *XY = Builder.CreateBinOp(Opcode, X, Y);
425 Value *Fabs = Builder.CreateUnaryIntrinsic(Intrinsic::fabs, XY);
426 Fabs->takeName(&I);
427 return replaceInstUsesWith(I, Fabs);
428 }
429
430 return nullptr;
431}
432
433Instruction *InstCombinerImpl::visitFMul(BinaryOperator &I) {
434 if (Value *V = SimplifyFMulInst(I.getOperand(0), I.getOperand(1),
435 I.getFastMathFlags(),
436 SQ.getWithInstruction(&I)))
437 return replaceInstUsesWith(I, V);
438
439 if (SimplifyAssociativeOrCommutative(I))
440 return &I;
441
442 if (Instruction *X = foldVectorBinop(I))
443 return X;
444
445 if (Instruction *FoldedMul = foldBinOpIntoSelectOrPhi(I))
446 return FoldedMul;
447
448 if (Value *FoldedMul = foldMulSelectToNegate(I, Builder))
449 return replaceInstUsesWith(I, FoldedMul);
450
451 if (Instruction *R = foldFPSignBitOps(I))
452 return R;
453
454 // X * -1.0 --> -X
455 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
456 if (match(Op1, m_SpecificFP(-1.0)))
457 return UnaryOperator::CreateFNegFMF(Op0, &I);
458
459 // -X * C --> X * -C
460 Value *X, *Y;
461 Constant *C;
462 if (match(Op0, m_FNeg(m_Value(X))) && match(Op1, m_Constant(C)))
463 return BinaryOperator::CreateFMulFMF(X, ConstantExpr::getFNeg(C), &I);
464
465 // (select A, B, C) * (select A, D, E) --> select A, (B*D), (C*E)
466 if (Value *V = SimplifySelectsFeedingBinaryOp(I, Op0, Op1))
467 return replaceInstUsesWith(I, V);
468
469 if (I.hasAllowReassoc()) {
470 // Reassociate constant RHS with another constant to form constant
471 // expression.
472 if (match(Op1, m_Constant(C)) && C->isFiniteNonZeroFP()) {
473 Constant *C1;
474 if (match(Op0, m_OneUse(m_FDiv(m_Constant(C1), m_Value(X))))) {
475 // (C1 / X) * C --> (C * C1) / X
476 Constant *CC1 = ConstantExpr::getFMul(C, C1);
477 if (CC1->isNormalFP())
478 return BinaryOperator::CreateFDivFMF(CC1, X, &I);
479 }
480 if (match(Op0, m_FDiv(m_Value(X), m_Constant(C1)))) {
481 // (X / C1) * C --> X * (C / C1)
482 Constant *CDivC1 = ConstantExpr::getFDiv(C, C1);
483 if (CDivC1->isNormalFP())
484 return BinaryOperator::CreateFMulFMF(X, CDivC1, &I);
485
486 // If the constant was a denormal, try reassociating differently.
487 // (X / C1) * C --> X / (C1 / C)
488 Constant *C1DivC = ConstantExpr::getFDiv(C1, C);
489 if (Op0->hasOneUse() && C1DivC->isNormalFP())
490 return BinaryOperator::CreateFDivFMF(X, C1DivC, &I);
491 }
492
493 // We do not need to match 'fadd C, X' and 'fsub X, C' because they are
494 // canonicalized to 'fadd X, C'. Distributing the multiply may allow
495 // further folds and (X * C) + C2 is 'fma'.
496 if (match(Op0, m_OneUse(m_FAdd(m_Value(X), m_Constant(C1))))) {
497 // (X + C1) * C --> (X * C) + (C * C1)
498 Constant *CC1 = ConstantExpr::getFMul(C, C1);
499 Value *XC = Builder.CreateFMulFMF(X, C, &I);
500 return BinaryOperator::CreateFAddFMF(XC, CC1, &I);
501 }
502 if (match(Op0, m_OneUse(m_FSub(m_Constant(C1), m_Value(X))))) {
503 // (C1 - X) * C --> (C * C1) - (X * C)
504 Constant *CC1 = ConstantExpr::getFMul(C, C1);
505 Value *XC = Builder.CreateFMulFMF(X, C, &I);
506 return BinaryOperator::CreateFSubFMF(CC1, XC, &I);
507 }
508 }
509
510 Value *Z;
511 if (match(&I, m_c_FMul(m_OneUse(m_FDiv(m_Value(X), m_Value(Y))),
512 m_Value(Z)))) {
513 // Sink division: (X / Y) * Z --> (X * Z) / Y
514 Value *NewFMul = Builder.CreateFMulFMF(X, Z, &I);
515 return BinaryOperator::CreateFDivFMF(NewFMul, Y, &I);
516 }
517
518 // sqrt(X) * sqrt(Y) -> sqrt(X * Y)
519 // nnan disallows the possibility of returning a number if both operands are
520 // negative (in that case, we should return NaN).
521 if (I.hasNoNaNs() &&
522 match(Op0, m_OneUse(m_Intrinsic<Intrinsic::sqrt>(m_Value(X)))) &&
523 match(Op1, m_OneUse(m_Intrinsic<Intrinsic::sqrt>(m_Value(Y))))) {
524 Value *XY = Builder.CreateFMulFMF(X, Y, &I);
525 Value *Sqrt = Builder.CreateUnaryIntrinsic(Intrinsic::sqrt, XY, &I);
526 return replaceInstUsesWith(I, Sqrt);
527 }
528
529 // The following transforms are done irrespective of the number of uses
530 // for the expression "1.0/sqrt(X)".
531 // 1) 1.0/sqrt(X) * X -> X/sqrt(X)
532 // 2) X * 1.0/sqrt(X) -> X/sqrt(X)
533 // We always expect the backend to reduce X/sqrt(X) to sqrt(X), if it
534 // has the necessary (reassoc) fast-math-flags.
535 if (I.hasNoSignedZeros() &&
536 match(Op0, (m_FDiv(m_SpecificFP(1.0), m_Value(Y)))) &&
537 match(Y, m_Intrinsic<Intrinsic::sqrt>(m_Value(X))) && Op1 == X)
538 return BinaryOperator::CreateFDivFMF(X, Y, &I);
539 if (I.hasNoSignedZeros() &&
540 match(Op1, (m_FDiv(m_SpecificFP(1.0), m_Value(Y)))) &&
541 match(Y, m_Intrinsic<Intrinsic::sqrt>(m_Value(X))) && Op0 == X)
542 return BinaryOperator::CreateFDivFMF(X, Y, &I);
543
544 // Like the similar transform in instsimplify, this requires 'nsz' because
545 // sqrt(-0.0) = -0.0, and -0.0 * -0.0 does not simplify to -0.0.
546 if (I.hasNoNaNs() && I.hasNoSignedZeros() && Op0 == Op1 &&
547 Op0->hasNUses(2)) {
548 // Peek through fdiv to find squaring of square root:
549 // (X / sqrt(Y)) * (X / sqrt(Y)) --> (X * X) / Y
550 if (match(Op0, m_FDiv(m_Value(X),
551 m_Intrinsic<Intrinsic::sqrt>(m_Value(Y))))) {
552 Value *XX = Builder.CreateFMulFMF(X, X, &I);
553 return BinaryOperator::CreateFDivFMF(XX, Y, &I);
554 }
555 // (sqrt(Y) / X) * (sqrt(Y) / X) --> Y / (X * X)
556 if (match(Op0, m_FDiv(m_Intrinsic<Intrinsic::sqrt>(m_Value(Y)),
557 m_Value(X)))) {
558 Value *XX = Builder.CreateFMulFMF(X, X, &I);
559 return BinaryOperator::CreateFDivFMF(Y, XX, &I);
560 }
561 }
562
563 if (I.isOnlyUserOfAnyOperand()) {
564 // pow(x, y) * pow(x, z) -> pow(x, y + z)
565 if (match(Op0, m_Intrinsic<Intrinsic::pow>(m_Value(X), m_Value(Y))) &&
566 match(Op1, m_Intrinsic<Intrinsic::pow>(m_Specific(X), m_Value(Z)))) {
567 auto *YZ = Builder.CreateFAddFMF(Y, Z, &I);
568 auto *NewPow = Builder.CreateBinaryIntrinsic(Intrinsic::pow, X, YZ, &I);
569 return replaceInstUsesWith(I, NewPow);
570 }
571
572 // powi(x, y) * powi(x, z) -> powi(x, y + z)
573 if (match(Op0, m_Intrinsic<Intrinsic::powi>(m_Value(X), m_Value(Y))) &&
574 match(Op1, m_Intrinsic<Intrinsic::powi>(m_Specific(X), m_Value(Z))) &&
575 Y->getType() == Z->getType()) {
576 auto *YZ = Builder.CreateAdd(Y, Z);
577 auto *NewPow = Builder.CreateIntrinsic(
578 Intrinsic::powi, {X->getType(), YZ->getType()}, {X, YZ}, &I);
579 return replaceInstUsesWith(I, NewPow);
580 }
581
582 // exp(X) * exp(Y) -> exp(X + Y)
583 if (match(Op0, m_Intrinsic<Intrinsic::exp>(m_Value(X))) &&
584 match(Op1, m_Intrinsic<Intrinsic::exp>(m_Value(Y)))) {
585 Value *XY = Builder.CreateFAddFMF(X, Y, &I);
586 Value *Exp = Builder.CreateUnaryIntrinsic(Intrinsic::exp, XY, &I);
587 return replaceInstUsesWith(I, Exp);
588 }
589
590 // exp2(X) * exp2(Y) -> exp2(X + Y)
591 if (match(Op0, m_Intrinsic<Intrinsic::exp2>(m_Value(X))) &&
592 match(Op1, m_Intrinsic<Intrinsic::exp2>(m_Value(Y)))) {
593 Value *XY = Builder.CreateFAddFMF(X, Y, &I);
594 Value *Exp2 = Builder.CreateUnaryIntrinsic(Intrinsic::exp2, XY, &I);
595 return replaceInstUsesWith(I, Exp2);
596 }
597 }
598
599 // (X*Y) * X => (X*X) * Y where Y != X
600 // The purpose is two-fold:
601 // 1) to form a power expression (of X).
602 // 2) potentially shorten the critical path: After transformation, the
603 // latency of the instruction Y is amortized by the expression of X*X,
604 // and therefore Y is in a "less critical" position compared to what it
605 // was before the transformation.
606 if (match(Op0, m_OneUse(m_c_FMul(m_Specific(Op1), m_Value(Y)))) &&
607 Op1 != Y) {
608 Value *XX = Builder.CreateFMulFMF(Op1, Op1, &I);
609 return BinaryOperator::CreateFMulFMF(XX, Y, &I);
610 }
611 if (match(Op1, m_OneUse(m_c_FMul(m_Specific(Op0), m_Value(Y)))) &&
612 Op0 != Y) {
613 Value *XX = Builder.CreateFMulFMF(Op0, Op0, &I);
614 return BinaryOperator::CreateFMulFMF(XX, Y, &I);
615 }
616 }
617
618 // log2(X * 0.5) * Y = log2(X) * Y - Y
619 if (I.isFast()) {
620 IntrinsicInst *Log2 = nullptr;
621 if (match(Op0, m_OneUse(m_Intrinsic<Intrinsic::log2>(
622 m_OneUse(m_FMul(m_Value(X), m_SpecificFP(0.5))))))) {
623 Log2 = cast<IntrinsicInst>(Op0);
624 Y = Op1;
625 }
626 if (match(Op1, m_OneUse(m_Intrinsic<Intrinsic::log2>(
627 m_OneUse(m_FMul(m_Value(X), m_SpecificFP(0.5))))))) {
628 Log2 = cast<IntrinsicInst>(Op1);
629 Y = Op0;
630 }
631 if (Log2) {
632 Value *Log2 = Builder.CreateUnaryIntrinsic(Intrinsic::log2, X, &I);
633 Value *LogXTimesY = Builder.CreateFMulFMF(Log2, Y, &I);
634 return BinaryOperator::CreateFSubFMF(LogXTimesY, Y, &I);
635 }
636 }
637
638 return nullptr;
639}
640
641/// Fold a divide or remainder with a select instruction divisor when one of the
642/// select operands is zero. In that case, we can use the other select operand
643/// because div/rem by zero is undefined.
644bool InstCombinerImpl::simplifyDivRemOfSelectWithZeroOp(BinaryOperator &I) {
645 SelectInst *SI = dyn_cast<SelectInst>(I.getOperand(1));
646 if (!SI)
9
Assuming 'SI' is non-null
10
Taking false branch
647 return false;
648
649 int NonNullOperand;
650 if (match(SI->getTrueValue(), m_Zero()))
11
Calling 'match<llvm::Value, llvm::PatternMatch::is_zero>'
18
Returning from 'match<llvm::Value, llvm::PatternMatch::is_zero>'
19
Assuming the condition is true
20
Taking true branch
651 // div/rem X, (Cond ? 0 : Y) -> div/rem X, Y
652 NonNullOperand = 2;
653 else if (match(SI->getFalseValue(), m_Zero()))
654 // div/rem X, (Cond ? Y : 0) -> div/rem X, Y
655 NonNullOperand = 1;
656 else
657 return false;
658
659 // Change the div/rem to use 'Y' instead of the select.
660 replaceOperand(I, 1, SI->getOperand(NonNullOperand));
661
662 // Okay, we know we replace the operand of the div/rem with 'Y' with no
663 // problem. However, the select, or the condition of the select may have
664 // multiple uses. Based on our knowledge that the operand must be non-zero,
665 // propagate the known value for the select into other uses of it, and
666 // propagate a known value of the condition into its other users.
667
668 // If the select and condition only have a single use, don't bother with this,
669 // early exit.
670 Value *SelectCond = SI->getCondition();
671 if (SI->use_empty() && SelectCond->hasOneUse())
21
Calling 'Value::use_empty'
24
Returning from 'Value::use_empty'
672 return true;
673
674 // Scan the current block backward, looking for other uses of SI.
675 BasicBlock::iterator BBI = I.getIterator(), BBFront = I.getParent()->begin();
676 Type *CondTy = SelectCond->getType();
677 while (BBI != BBFront) {
25
Calling 'operator!='
28
Returning from 'operator!='
29
Loop condition is true. Entering loop body
37
Calling 'operator!='
40
Returning from 'operator!='
41
Loop condition is true. Entering loop body
678 --BBI;
679 // If we found an instruction that we can't assume will return, so
680 // information from below it cannot be propagated above it.
681 if (!isGuaranteedToTransferExecutionToSuccessor(&*BBI))
30
Assuming the condition is false
31
Taking false branch
42
Assuming the condition is false
43
Taking false branch
682 break;
683
684 // Replace uses of the select or its condition with the known values.
685 for (Use &Op : BBI->operands()) {
32
Assuming '__begin2' is equal to '__end2'
44
Assuming '__begin2' is not equal to '__end2'
686 if (Op == SI) {
45
Assuming the condition is true
46
Taking true branch
687 replaceUse(Op, SI->getOperand(NonNullOperand));
47
Called C++ object pointer is null
688 Worklist.push(&*BBI);
689 } else if (Op == SelectCond) {
690 replaceUse(Op, NonNullOperand == 1 ? ConstantInt::getTrue(CondTy)
691 : ConstantInt::getFalse(CondTy));
692 Worklist.push(&*BBI);
693 }
694 }
695
696 // If we past the instruction, quit looking for it.
697 if (&*BBI == SI)
33
Assuming the condition is true
34
Taking true branch
698 SI = nullptr;
35
Null pointer value stored to 'SI'
699 if (&*BBI == SelectCond)
36
Assuming the condition is false
700 SelectCond = nullptr;
701
702 // If we ran out of things to eliminate, break out of the loop.
703 if (!SelectCond
36.1
'SelectCond' is non-null
36.1
'SelectCond' is non-null
36.1
'SelectCond' is non-null
36.1
'SelectCond' is non-null
&& !SI)
704 break;
705
706 }
707 return true;
708}
709
710/// True if the multiply can not be expressed in an int this size.
711static bool multiplyOverflows(const APInt &C1, const APInt &C2, APInt &Product,
712 bool IsSigned) {
713 bool Overflow;
714 Product = IsSigned ? C1.smul_ov(C2, Overflow) : C1.umul_ov(C2, Overflow);
715 return Overflow;
716}
717
718/// True if C1 is a multiple of C2. Quotient contains C1/C2.
719static bool isMultiple(const APInt &C1, const APInt &C2, APInt &Quotient,
720 bool IsSigned) {
721 assert(C1.getBitWidth() == C2.getBitWidth() && "Constant widths not equal")(static_cast <bool> (C1.getBitWidth() == C2.getBitWidth
() && "Constant widths not equal") ? void (0) : __assert_fail
("C1.getBitWidth() == C2.getBitWidth() && \"Constant widths not equal\""
, "llvm/lib/Transforms/InstCombine/InstCombineMulDivRem.cpp",
721, __extension__ __PRETTY_FUNCTION__))
;
722
723 // Bail if we will divide by zero.
724 if (C2.isZero())
725 return false;
726
727 // Bail if we would divide INT_MIN by -1.
728 if (IsSigned && C1.isMinSignedValue() && C2.isAllOnes())
729 return false;
730
731 APInt Remainder(C1.getBitWidth(), /*val=*/0ULL, IsSigned);
732 if (IsSigned)
733 APInt::sdivrem(C1, C2, Quotient, Remainder);
734 else
735 APInt::udivrem(C1, C2, Quotient, Remainder);
736
737 return Remainder.isMinValue();
738}
739
740/// This function implements the transforms common to both integer division
741/// instructions (udiv and sdiv). It is called by the visitors to those integer
742/// division instructions.
743/// Common integer divide transforms
744Instruction *InstCombinerImpl::commonIDivTransforms(BinaryOperator &I) {
745 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
746 bool IsSigned = I.getOpcode() == Instruction::SDiv;
747 Type *Ty = I.getType();
748
749 // The RHS is known non-zero.
750 if (Value *V = simplifyValueKnownNonZero(I.getOperand(1), *this, I))
751 return replaceOperand(I, 1, V);
752
753 // Handle cases involving: [su]div X, (select Cond, Y, Z)
754 // This does not apply for fdiv.
755 if (simplifyDivRemOfSelectWithZeroOp(I))
756 return &I;
757
758 // If the divisor is a select-of-constants, try to constant fold all div ops:
759 // C / (select Cond, TrueC, FalseC) --> select Cond, (C / TrueC), (C / FalseC)
760 // TODO: Adapt simplifyDivRemOfSelectWithZeroOp to allow this and other folds.
761 if (match(Op0, m_ImmConstant()) &&
762 match(Op1, m_Select(m_Value(), m_ImmConstant(), m_ImmConstant()))) {
763 if (Instruction *R = FoldOpIntoSelect(I, cast<SelectInst>(Op1)))
764 return R;
765 }
766
767 const APInt *C2;
768 if (match(Op1, m_APInt(C2))) {
769 Value *X;
770 const APInt *C1;
771
772 // (X / C1) / C2 -> X / (C1*C2)
773 if ((IsSigned && match(Op0, m_SDiv(m_Value(X), m_APInt(C1)))) ||
774 (!IsSigned && match(Op0, m_UDiv(m_Value(X), m_APInt(C1))))) {
775 APInt Product(C1->getBitWidth(), /*val=*/0ULL, IsSigned);
776 if (!multiplyOverflows(*C1, *C2, Product, IsSigned))
777 return BinaryOperator::Create(I.getOpcode(), X,
778 ConstantInt::get(Ty, Product));
779 }
780
781 if ((IsSigned && match(Op0, m_NSWMul(m_Value(X), m_APInt(C1)))) ||
782 (!IsSigned && match(Op0, m_NUWMul(m_Value(X), m_APInt(C1))))) {
783 APInt Quotient(C1->getBitWidth(), /*val=*/0ULL, IsSigned);
784
785 // (X * C1) / C2 -> X / (C2 / C1) if C2 is a multiple of C1.
786 if (isMultiple(*C2, *C1, Quotient, IsSigned)) {
787 auto *NewDiv = BinaryOperator::Create(I.getOpcode(), X,
788 ConstantInt::get(Ty, Quotient));
789 NewDiv->setIsExact(I.isExact());
790 return NewDiv;
791 }
792
793 // (X * C1) / C2 -> X * (C1 / C2) if C1 is a multiple of C2.
794 if (isMultiple(*C1, *C2, Quotient, IsSigned)) {
795 auto *Mul = BinaryOperator::Create(Instruction::Mul, X,
796 ConstantInt::get(Ty, Quotient));
797 auto *OBO = cast<OverflowingBinaryOperator>(Op0);
798 Mul->setHasNoUnsignedWrap(!IsSigned && OBO->hasNoUnsignedWrap());
799 Mul->setHasNoSignedWrap(OBO->hasNoSignedWrap());
800 return Mul;
801 }
802 }
803
804 if ((IsSigned && match(Op0, m_NSWShl(m_Value(X), m_APInt(C1))) &&
805 C1->ult(C1->getBitWidth() - 1)) ||
806 (!IsSigned && match(Op0, m_NUWShl(m_Value(X), m_APInt(C1))) &&
807 C1->ult(C1->getBitWidth()))) {
808 APInt Quotient(C1->getBitWidth(), /*val=*/0ULL, IsSigned);
809 APInt C1Shifted = APInt::getOneBitSet(
810 C1->getBitWidth(), static_cast<unsigned>(C1->getZExtValue()));
811
812 // (X << C1) / C2 -> X / (C2 >> C1) if C2 is a multiple of 1 << C1.
813 if (isMultiple(*C2, C1Shifted, Quotient, IsSigned)) {
814 auto *BO = BinaryOperator::Create(I.getOpcode(), X,
815 ConstantInt::get(Ty, Quotient));
816 BO->setIsExact(I.isExact());
817 return BO;
818 }
819
820 // (X << C1) / C2 -> X * ((1 << C1) / C2) if 1 << C1 is a multiple of C2.
821 if (isMultiple(C1Shifted, *C2, Quotient, IsSigned)) {
822 auto *Mul = BinaryOperator::Create(Instruction::Mul, X,
823 ConstantInt::get(Ty, Quotient));
824 auto *OBO = cast<OverflowingBinaryOperator>(Op0);
825 Mul->setHasNoUnsignedWrap(!IsSigned && OBO->hasNoUnsignedWrap());
826 Mul->setHasNoSignedWrap(OBO->hasNoSignedWrap());
827 return Mul;
828 }
829 }
830
831 if (!C2->isZero()) // avoid X udiv 0
832 if (Instruction *FoldedDiv = foldBinOpIntoSelectOrPhi(I))
833 return FoldedDiv;
834 }
835
836 if (match(Op0, m_One())) {
837 assert(!Ty->isIntOrIntVectorTy(1) && "i1 divide not removed?")(static_cast <bool> (!Ty->isIntOrIntVectorTy(1) &&
"i1 divide not removed?") ? void (0) : __assert_fail ("!Ty->isIntOrIntVectorTy(1) && \"i1 divide not removed?\""
, "llvm/lib/Transforms/InstCombine/InstCombineMulDivRem.cpp",
837, __extension__ __PRETTY_FUNCTION__))
;
838 if (IsSigned) {
839 // If Op1 is 0 then it's undefined behaviour, if Op1 is 1 then the
840 // result is one, if Op1 is -1 then the result is minus one, otherwise
841 // it's zero.
842 Value *Inc = Builder.CreateAdd(Op1, Op0);
843 Value *Cmp = Builder.CreateICmpULT(Inc, ConstantInt::get(Ty, 3));
844 return SelectInst::Create(Cmp, Op1, ConstantInt::get(Ty, 0));
845 } else {
846 // If Op1 is 0 then it's undefined behaviour. If Op1 is 1 then the
847 // result is one, otherwise it's zero.
848 return new ZExtInst(Builder.CreateICmpEQ(Op1, Op0), Ty);
849 }
850 }
851
852 // See if we can fold away this div instruction.
853 if (SimplifyDemandedInstructionBits(I))
854 return &I;
855
856 // (X - (X rem Y)) / Y -> X / Y; usually originates as ((X / Y) * Y) / Y
857 Value *X, *Z;
858 if (match(Op0, m_Sub(m_Value(X), m_Value(Z)))) // (X - Z) / Y; Y = Op1
859 if ((IsSigned && match(Z, m_SRem(m_Specific(X), m_Specific(Op1)))) ||
860 (!IsSigned && match(Z, m_URem(m_Specific(X), m_Specific(Op1)))))
861 return BinaryOperator::Create(I.getOpcode(), X, Op1);
862
863 // (X << Y) / X -> 1 << Y
864 Value *Y;
865 if (IsSigned && match(Op0, m_NSWShl(m_Specific(Op1), m_Value(Y))))
866 return BinaryOperator::CreateNSWShl(ConstantInt::get(Ty, 1), Y);
867 if (!IsSigned && match(Op0, m_NUWShl(m_Specific(Op1), m_Value(Y))))
868 return BinaryOperator::CreateNUWShl(ConstantInt::get(Ty, 1), Y);
869
870 // X / (X * Y) -> 1 / Y if the multiplication does not overflow.
871 if (match(Op1, m_c_Mul(m_Specific(Op0), m_Value(Y)))) {
872 bool HasNSW = cast<OverflowingBinaryOperator>(Op1)->hasNoSignedWrap();
873 bool HasNUW = cast<OverflowingBinaryOperator>(Op1)->hasNoUnsignedWrap();
874 if ((IsSigned && HasNSW) || (!IsSigned && HasNUW)) {
875 replaceOperand(I, 0, ConstantInt::get(Ty, 1));
876 replaceOperand(I, 1, Y);
877 return &I;
878 }
879 }
880
881 return nullptr;
882}
883
884static const unsigned MaxDepth = 6;
885
886namespace {
887
888using FoldUDivOperandCb = Instruction *(*)(Value *Op0, Value *Op1,
889 const BinaryOperator &I,
890 InstCombinerImpl &IC);
891
892/// Used to maintain state for visitUDivOperand().
893struct UDivFoldAction {
894 /// Informs visitUDiv() how to fold this operand. This can be zero if this
895 /// action joins two actions together.
896 FoldUDivOperandCb FoldAction;
897
898 /// Which operand to fold.
899 Value *OperandToFold;
900
901 union {
902 /// The instruction returned when FoldAction is invoked.
903 Instruction *FoldResult;
904
905 /// Stores the LHS action index if this action joins two actions together.
906 size_t SelectLHSIdx;
907 };
908
909 UDivFoldAction(FoldUDivOperandCb FA, Value *InputOperand)
910 : FoldAction(FA), OperandToFold(InputOperand), FoldResult(nullptr) {}
911 UDivFoldAction(FoldUDivOperandCb FA, Value *InputOperand, size_t SLHS)
912 : FoldAction(FA), OperandToFold(InputOperand), SelectLHSIdx(SLHS) {}
913};
914
915} // end anonymous namespace
916
917// X udiv 2^C -> X >> C
918static Instruction *foldUDivPow2Cst(Value *Op0, Value *Op1,
919 const BinaryOperator &I,
920 InstCombinerImpl &IC) {
921 Constant *C1 = ConstantExpr::getExactLogBase2(cast<Constant>(Op1));
922 if (!C1)
923 llvm_unreachable("Failed to constant fold udiv -> logbase2")::llvm::llvm_unreachable_internal("Failed to constant fold udiv -> logbase2"
, "llvm/lib/Transforms/InstCombine/InstCombineMulDivRem.cpp",
923)
;
924 BinaryOperator *LShr = BinaryOperator::CreateLShr(Op0, C1);
925 if (I.isExact())
926 LShr->setIsExact();
927 return LShr;
928}
929
930// X udiv (C1 << N), where C1 is "1<<C2" --> X >> (N+C2)
931// X udiv (zext (C1 << N)), where C1 is "1<<C2" --> X >> (N+C2)
932static Instruction *foldUDivShl(Value *Op0, Value *Op1, const BinaryOperator &I,
933 InstCombinerImpl &IC) {
934 Value *ShiftLeft;
935 if (!match(Op1, m_ZExt(m_Value(ShiftLeft))))
936 ShiftLeft = Op1;
937
938 Constant *CI;
939 Value *N;
940 if (!match(ShiftLeft, m_Shl(m_Constant(CI), m_Value(N))))
941 llvm_unreachable("match should never fail here!")::llvm::llvm_unreachable_internal("match should never fail here!"
, "llvm/lib/Transforms/InstCombine/InstCombineMulDivRem.cpp",
941)
;
942 Constant *Log2Base = ConstantExpr::getExactLogBase2(CI);
943 if (!Log2Base)
944 llvm_unreachable("getLogBase2 should never fail here!")::llvm::llvm_unreachable_internal("getLogBase2 should never fail here!"
, "llvm/lib/Transforms/InstCombine/InstCombineMulDivRem.cpp",
944)
;
945 N = IC.Builder.CreateAdd(N, Log2Base);
946 if (Op1 != ShiftLeft)
947 N = IC.Builder.CreateZExt(N, Op1->getType());
948 BinaryOperator *LShr = BinaryOperator::CreateLShr(Op0, N);
949 if (I.isExact())
950 LShr->setIsExact();
951 return LShr;
952}
953
954// Recursively visits the possible right hand operands of a udiv
955// instruction, seeing through select instructions, to determine if we can
956// replace the udiv with something simpler. If we find that an operand is not
957// able to simplify the udiv, we abort the entire transformation.
958static size_t visitUDivOperand(Value *Op0, Value *Op1, const BinaryOperator &I,
959 SmallVectorImpl<UDivFoldAction> &Actions,
960 unsigned Depth = 0) {
961 // FIXME: assert that Op1 isn't/doesn't contain undef.
962
963 // Check to see if this is an unsigned division with an exact power of 2,
964 // if so, convert to a right shift.
965 if (match(Op1, m_Power2())) {
966 Actions.push_back(UDivFoldAction(foldUDivPow2Cst, Op1));
967 return Actions.size();
968 }
969
970 // X udiv (C1 << N), where C1 is "1<<C2" --> X >> (N+C2)
971 if (match(Op1, m_Shl(m_Power2(), m_Value())) ||
972 match(Op1, m_ZExt(m_Shl(m_Power2(), m_Value())))) {
973 Actions.push_back(UDivFoldAction(foldUDivShl, Op1));
974 return Actions.size();
975 }
976
977 // The remaining tests are all recursive, so bail out if we hit the limit.
978 if (Depth++ == MaxDepth)
979 return 0;
980
981 if (SelectInst *SI = dyn_cast<SelectInst>(Op1))
982 // FIXME: missed optimization: if one of the hands of select is/contains
983 // undef, just directly pick the other one.
984 // FIXME: can both hands contain undef?
985 if (size_t LHSIdx =
986 visitUDivOperand(Op0, SI->getOperand(1), I, Actions, Depth))
987 if (visitUDivOperand(Op0, SI->getOperand(2), I, Actions, Depth)) {
988 Actions.push_back(UDivFoldAction(nullptr, Op1, LHSIdx - 1));
989 return Actions.size();
990 }
991
992 return 0;
993}
994
995/// If we have zero-extended operands of an unsigned div or rem, we may be able
996/// to narrow the operation (sink the zext below the math).
997static Instruction *narrowUDivURem(BinaryOperator &I,
998 InstCombiner::BuilderTy &Builder) {
999 Instruction::BinaryOps Opcode = I.getOpcode();
1000 Value *N = I.getOperand(0);
1001 Value *D = I.getOperand(1);
1002 Type *Ty = I.getType();
1003 Value *X, *Y;
1004 if (match(N, m_ZExt(m_Value(X))) && match(D, m_ZExt(m_Value(Y))) &&
1005 X->getType() == Y->getType() && (N->hasOneUse() || D->hasOneUse())) {
1006 // udiv (zext X), (zext Y) --> zext (udiv X, Y)
1007 // urem (zext X), (zext Y) --> zext (urem X, Y)
1008 Value *NarrowOp = Builder.CreateBinOp(Opcode, X, Y);
1009 return new ZExtInst(NarrowOp, Ty);
1010 }
1011
1012 Constant *C;
1013 if ((match(N, m_OneUse(m_ZExt(m_Value(X)))) && match(D, m_Constant(C))) ||
1014 (match(D, m_OneUse(m_ZExt(m_Value(X)))) && match(N, m_Constant(C)))) {
1015 // If the constant is the same in the smaller type, use the narrow version.
1016 Constant *TruncC = ConstantExpr::getTrunc(C, X->getType());
1017 if (ConstantExpr::getZExt(TruncC, Ty) != C)
1018 return nullptr;
1019
1020 // udiv (zext X), C --> zext (udiv X, C')
1021 // urem (zext X), C --> zext (urem X, C')
1022 // udiv C, (zext X) --> zext (udiv C', X)
1023 // urem C, (zext X) --> zext (urem C', X)
1024 Value *NarrowOp = isa<Constant>(D) ? Builder.CreateBinOp(Opcode, X, TruncC)
1025 : Builder.CreateBinOp(Opcode, TruncC, X);
1026 return new ZExtInst(NarrowOp, Ty);
1027 }
1028
1029 return nullptr;
1030}
1031
1032Instruction *InstCombinerImpl::visitUDiv(BinaryOperator &I) {
1033 if (Value *V = SimplifyUDivInst(I.getOperand(0), I.getOperand(1),
1034 SQ.getWithInstruction(&I)))
1035 return replaceInstUsesWith(I, V);
1036
1037 if (Instruction *X = foldVectorBinop(I))
1038 return X;
1039
1040 // Handle the integer div common cases
1041 if (Instruction *Common = commonIDivTransforms(I))
1042 return Common;
1043
1044 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
1045 Value *X;
1046 const APInt *C1, *C2;
1047 if (match(Op0, m_LShr(m_Value(X), m_APInt(C1))) && match(Op1, m_APInt(C2))) {
1048 // (X lshr C1) udiv C2 --> X udiv (C2 << C1)
1049 bool Overflow;
1050 APInt C2ShlC1 = C2->ushl_ov(*C1, Overflow);
1051 if (!Overflow) {
1052 bool IsExact = I.isExact() && match(Op0, m_Exact(m_Value()));
1053 BinaryOperator *BO = BinaryOperator::CreateUDiv(
1054 X, ConstantInt::get(X->getType(), C2ShlC1));
1055 if (IsExact)
1056 BO->setIsExact();
1057 return BO;
1058 }
1059 }
1060
1061 // Op0 / C where C is large (negative) --> zext (Op0 >= C)
1062 // TODO: Could use isKnownNegative() to handle non-constant values.
1063 Type *Ty = I.getType();
1064 if (match(Op1, m_Negative())) {
1065 Value *Cmp = Builder.CreateICmpUGE(Op0, Op1);
1066 return CastInst::CreateZExtOrBitCast(Cmp, Ty);
1067 }
1068 // Op0 / (sext i1 X) --> zext (Op0 == -1) (if X is 0, the div is undefined)
1069 if (match(Op1, m_SExt(m_Value(X))) && X->getType()->isIntOrIntVectorTy(1)) {
1070 Value *Cmp = Builder.CreateICmpEQ(Op0, ConstantInt::getAllOnesValue(Ty));
1071 return CastInst::CreateZExtOrBitCast(Cmp, Ty);
1072 }
1073
1074 if (Instruction *NarrowDiv = narrowUDivURem(I, Builder))
1075 return NarrowDiv;
1076
1077 // If the udiv operands are non-overflowing multiplies with a common operand,
1078 // then eliminate the common factor:
1079 // (A * B) / (A * X) --> B / X (and commuted variants)
1080 // TODO: The code would be reduced if we had m_c_NUWMul pattern matching.
1081 // TODO: If -reassociation handled this generally, we could remove this.
1082 Value *A, *B;
1083 if (match(Op0, m_NUWMul(m_Value(A), m_Value(B)))) {
1084 if (match(Op1, m_NUWMul(m_Specific(A), m_Value(X))) ||
1085 match(Op1, m_NUWMul(m_Value(X), m_Specific(A))))
1086 return BinaryOperator::CreateUDiv(B, X);
1087 if (match(Op1, m_NUWMul(m_Specific(B), m_Value(X))) ||
1088 match(Op1, m_NUWMul(m_Value(X), m_Specific(B))))
1089 return BinaryOperator::CreateUDiv(A, X);
1090 }
1091
1092 // (LHS udiv (select (select (...)))) -> (LHS >> (select (select (...))))
1093 SmallVector<UDivFoldAction, 6> UDivActions;
1094 if (visitUDivOperand(Op0, Op1, I, UDivActions))
1095 for (unsigned i = 0, e = UDivActions.size(); i != e; ++i) {
1096 FoldUDivOperandCb Action = UDivActions[i].FoldAction;
1097 Value *ActionOp1 = UDivActions[i].OperandToFold;
1098 Instruction *Inst;
1099 if (Action)
1100 Inst = Action(Op0, ActionOp1, I, *this);
1101 else {
1102 // This action joins two actions together. The RHS of this action is
1103 // simply the last action we processed, we saved the LHS action index in
1104 // the joining action.
1105 size_t SelectRHSIdx = i - 1;
1106 Value *SelectRHS = UDivActions[SelectRHSIdx].FoldResult;
1107 size_t SelectLHSIdx = UDivActions[i].SelectLHSIdx;
1108 Value *SelectLHS = UDivActions[SelectLHSIdx].FoldResult;
1109 Inst = SelectInst::Create(cast<SelectInst>(ActionOp1)->getCondition(),
1110 SelectLHS, SelectRHS);
1111 }
1112
1113 // If this is the last action to process, return it to the InstCombiner.
1114 // Otherwise, we insert it before the UDiv and record it so that we may
1115 // use it as part of a joining action (i.e., a SelectInst).
1116 if (e - i != 1) {
1117 Inst->insertBefore(&I);
1118 UDivActions[i].FoldResult = Inst;
1119 } else
1120 return Inst;
1121 }
1122
1123 return nullptr;
1124}
1125
1126Instruction *InstCombinerImpl::visitSDiv(BinaryOperator &I) {
1127 if (Value *V = SimplifySDivInst(I.getOperand(0), I.getOperand(1),
1128 SQ.getWithInstruction(&I)))
1129 return replaceInstUsesWith(I, V);
1130
1131 if (Instruction *X = foldVectorBinop(I))
1132 return X;
1133
1134 // Handle the integer div common cases
1135 if (Instruction *Common = commonIDivTransforms(I))
1136 return Common;
1137
1138 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
1139 Type *Ty = I.getType();
1140 Value *X;
1141 // sdiv Op0, -1 --> -Op0
1142 // sdiv Op0, (sext i1 X) --> -Op0 (because if X is 0, the op is undefined)
1143 if (match(Op1, m_AllOnes()) ||
1144 (match(Op1, m_SExt(m_Value(X))) && X->getType()->isIntOrIntVectorTy(1)))
1145 return BinaryOperator::CreateNeg(Op0);
1146
1147 // X / INT_MIN --> X == INT_MIN
1148 if (match(Op1, m_SignMask()))
1149 return new ZExtInst(Builder.CreateICmpEQ(Op0, Op1), Ty);
1150
1151 // sdiv exact X, 1<<C --> ashr exact X, C iff 1<<C is non-negative
1152 // sdiv exact X, -1<<C --> -(ashr exact X, C)
1153 if (I.isExact() && ((match(Op1, m_Power2()) && match(Op1, m_NonNegative())) ||
1154 match(Op1, m_NegatedPower2()))) {
1155 bool DivisorWasNegative = match(Op1, m_NegatedPower2());
1156 if (DivisorWasNegative)
1157 Op1 = ConstantExpr::getNeg(cast<Constant>(Op1));
1158 auto *AShr = BinaryOperator::CreateExactAShr(
1159 Op0, ConstantExpr::getExactLogBase2(cast<Constant>(Op1)), I.getName());
1160 if (!DivisorWasNegative)
1161 return AShr;
1162 Builder.Insert(AShr);
1163 AShr->setName(I.getName() + ".neg");
1164 return BinaryOperator::CreateNeg(AShr, I.getName());
1165 }
1166
1167 const APInt *Op1C;
1168 if (match(Op1, m_APInt(Op1C))) {
1169 // If the dividend is sign-extended and the constant divisor is small enough
1170 // to fit in the source type, shrink the division to the narrower type:
1171 // (sext X) sdiv C --> sext (X sdiv C)
1172 Value *Op0Src;
1173 if (match(Op0, m_OneUse(m_SExt(m_Value(Op0Src)))) &&
1174 Op0Src->getType()->getScalarSizeInBits() >= Op1C->getMinSignedBits()) {
1175
1176 // In the general case, we need to make sure that the dividend is not the
1177 // minimum signed value because dividing that by -1 is UB. But here, we
1178 // know that the -1 divisor case is already handled above.
1179
1180 Constant *NarrowDivisor =
1181 ConstantExpr::getTrunc(cast<Constant>(Op1), Op0Src->getType());
1182 Value *NarrowOp = Builder.CreateSDiv(Op0Src, NarrowDivisor);
1183 return new SExtInst(NarrowOp, Ty);
1184 }
1185
1186 // -X / C --> X / -C (if the negation doesn't overflow).
1187 // TODO: This could be enhanced to handle arbitrary vector constants by
1188 // checking if all elements are not the min-signed-val.
1189 if (!Op1C->isMinSignedValue() &&
1190 match(Op0, m_NSWSub(m_Zero(), m_Value(X)))) {
1191 Constant *NegC = ConstantInt::get(Ty, -(*Op1C));
1192 Instruction *BO = BinaryOperator::CreateSDiv(X, NegC);
1193 BO->setIsExact(I.isExact());
1194 return BO;
1195 }
1196 }
1197
1198 // -X / Y --> -(X / Y)
1199 Value *Y;
1200 if (match(&I, m_SDiv(m_OneUse(m_NSWSub(m_Zero(), m_Value(X))), m_Value(Y))))
1201 return BinaryOperator::CreateNSWNeg(
1202 Builder.CreateSDiv(X, Y, I.getName(), I.isExact()));
1203
1204 // abs(X) / X --> X > -1 ? 1 : -1
1205 // X / abs(X) --> X > -1 ? 1 : -1
1206 if (match(&I, m_c_BinOp(
1207 m_OneUse(m_Intrinsic<Intrinsic::abs>(m_Value(X), m_One())),
1208 m_Deferred(X)))) {
1209 Constant *NegOne = ConstantInt::getAllOnesValue(Ty);
1210 Value *Cond = Builder.CreateICmpSGT(X, NegOne);
1211 return SelectInst::Create(Cond, ConstantInt::get(Ty, 1), NegOne);
1212 }
1213
1214 // If the sign bits of both operands are zero (i.e. we can prove they are
1215 // unsigned inputs), turn this into a udiv.
1216 APInt Mask(APInt::getSignMask(Ty->getScalarSizeInBits()));
1217 if (MaskedValueIsZero(Op0, Mask, 0, &I)) {
1218 if (MaskedValueIsZero(Op1, Mask, 0, &I)) {
1219 // X sdiv Y -> X udiv Y, iff X and Y don't have sign bit set
1220 auto *BO = BinaryOperator::CreateUDiv(Op0, Op1, I.getName());
1221 BO->setIsExact(I.isExact());
1222 return BO;
1223 }
1224
1225 if (match(Op1, m_NegatedPower2())) {
1226 // X sdiv (-(1 << C)) -> -(X sdiv (1 << C)) ->
1227 // -> -(X udiv (1 << C)) -> -(X u>> C)
1228 return BinaryOperator::CreateNeg(Builder.Insert(foldUDivPow2Cst(
1229 Op0, ConstantExpr::getNeg(cast<Constant>(Op1)), I, *this)));
1230 }
1231
1232 if (isKnownToBeAPowerOfTwo(Op1, /*OrZero*/ true, 0, &I)) {
1233 // X sdiv (1 << Y) -> X udiv (1 << Y) ( -> X u>> Y)
1234 // Safe because the only negative value (1 << Y) can take on is
1235 // INT_MIN, and X sdiv INT_MIN == X udiv INT_MIN == 0 if X doesn't have
1236 // the sign bit set.
1237 auto *BO = BinaryOperator::CreateUDiv(Op0, Op1, I.getName());
1238 BO->setIsExact(I.isExact());
1239 return BO;
1240 }
1241 }
1242
1243 return nullptr;
1244}
1245
1246/// Remove negation and try to convert division into multiplication.
1247static Instruction *foldFDivConstantDivisor(BinaryOperator &I) {
1248 Constant *C;
1249 if (!match(I.getOperand(1), m_Constant(C)))
1250 return nullptr;
1251
1252 // -X / C --> X / -C
1253 Value *X;
1254 if (match(I.getOperand(0), m_FNeg(m_Value(X))))
1255 return BinaryOperator::CreateFDivFMF(X, ConstantExpr::getFNeg(C), &I);
1256
1257 // If the constant divisor has an exact inverse, this is always safe. If not,
1258 // then we can still create a reciprocal if fast-math-flags allow it and the
1259 // constant is a regular number (not zero, infinite, or denormal).
1260 if (!(C->hasExactInverseFP() || (I.hasAllowReciprocal() && C->isNormalFP())))
1261 return nullptr;
1262
1263 // Disallow denormal constants because we don't know what would happen
1264 // on all targets.
1265 // TODO: Use Intrinsic::canonicalize or let function attributes tell us that
1266 // denorms are flushed?
1267 auto *RecipC = ConstantExpr::getFDiv(ConstantFP::get(I.getType(), 1.0), C);
1268 if (!RecipC->isNormalFP())
1269 return nullptr;
1270
1271 // X / C --> X * (1 / C)
1272 return BinaryOperator::CreateFMulFMF(I.getOperand(0), RecipC, &I);
1273}
1274
1275/// Remove negation and try to reassociate constant math.
1276static Instruction *foldFDivConstantDividend(BinaryOperator &I) {
1277 Constant *C;
1278 if (!match(I.getOperand(0), m_Constant(C)))
1279 return nullptr;
1280
1281 // C / -X --> -C / X
1282 Value *X;
1283 if (match(I.getOperand(1), m_FNeg(m_Value(X))))
1284 return BinaryOperator::CreateFDivFMF(ConstantExpr::getFNeg(C), X, &I);
1285
1286 if (!I.hasAllowReassoc() || !I.hasAllowReciprocal())
1287 return nullptr;
1288
1289 // Try to reassociate C / X expressions where X includes another constant.
1290 Constant *C2, *NewC = nullptr;
1291 if (match(I.getOperand(1), m_FMul(m_Value(X), m_Constant(C2)))) {
1292 // C / (X * C2) --> (C / C2) / X
1293 NewC = ConstantExpr::getFDiv(C, C2);
1294 } else if (match(I.getOperand(1), m_FDiv(m_Value(X), m_Constant(C2)))) {
1295 // C / (X / C2) --> (C * C2) / X
1296 NewC = ConstantExpr::getFMul(C, C2);
1297 }
1298 // Disallow denormal constants because we don't know what would happen
1299 // on all targets.
1300 // TODO: Use Intrinsic::canonicalize or let function attributes tell us that
1301 // denorms are flushed?
1302 if (!NewC || !NewC->isNormalFP())
1303 return nullptr;
1304
1305 return BinaryOperator::CreateFDivFMF(NewC, X, &I);
1306}
1307
1308/// Negate the exponent of pow/exp to fold division-by-pow() into multiply.
1309static Instruction *foldFDivPowDivisor(BinaryOperator &I,
1310 InstCombiner::BuilderTy &Builder) {
1311 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
1312 auto *II = dyn_cast<IntrinsicInst>(Op1);
1313 if (!II || !II->hasOneUse() || !I.hasAllowReassoc() ||
1314 !I.hasAllowReciprocal())
1315 return nullptr;
1316
1317 // Z / pow(X, Y) --> Z * pow(X, -Y)
1318 // Z / exp{2}(Y) --> Z * exp{2}(-Y)
1319 // In the general case, this creates an extra instruction, but fmul allows
1320 // for better canonicalization and optimization than fdiv.
1321 Intrinsic::ID IID = II->getIntrinsicID();
1322 SmallVector<Value *> Args;
1323 switch (IID) {
1324 case Intrinsic::pow:
1325 Args.push_back(II->getArgOperand(0));
1326 Args.push_back(Builder.CreateFNegFMF(II->getArgOperand(1), &I));
1327 break;
1328 case Intrinsic::powi: {
1329 // Require 'ninf' assuming that makes powi(X, -INT_MIN) acceptable.
1330 // That is, X ** (huge negative number) is 0.0, ~1.0, or INF and so
1331 // dividing by that is INF, ~1.0, or 0.0. Code that uses powi allows
1332 // non-standard results, so this corner case should be acceptable if the
1333 // code rules out INF values.
1334 if (!I.hasNoInfs())
1335 return nullptr;
1336 Args.push_back(II->getArgOperand(0));
1337 Args.push_back(Builder.CreateNeg(II->getArgOperand(1)));
1338 Type *Tys[] = {I.getType(), II->getArgOperand(1)->getType()};
1339 Value *Pow = Builder.CreateIntrinsic(IID, Tys, Args, &I);
1340 return BinaryOperator::CreateFMulFMF(Op0, Pow, &I);
1341 }
1342 case Intrinsic::exp:
1343 case Intrinsic::exp2:
1344 Args.push_back(Builder.CreateFNegFMF(II->getArgOperand(0), &I));
1345 break;
1346 default:
1347 return nullptr;
1348 }
1349 Value *Pow = Builder.CreateIntrinsic(IID, I.getType(), Args, &I);
1350 return BinaryOperator::CreateFMulFMF(Op0, Pow, &I);
1351}
1352
1353Instruction *InstCombinerImpl::visitFDiv(BinaryOperator &I) {
1354 if (Value *V = SimplifyFDivInst(I.getOperand(0), I.getOperand(1),
1355 I.getFastMathFlags(),
1356 SQ.getWithInstruction(&I)))
1357 return replaceInstUsesWith(I, V);
1358
1359 if (Instruction *X = foldVectorBinop(I))
1360 return X;
1361
1362 if (Instruction *R = foldFDivConstantDivisor(I))
1363 return R;
1364
1365 if (Instruction *R = foldFDivConstantDividend(I))
1366 return R;
1367
1368 if (Instruction *R = foldFPSignBitOps(I))
1369 return R;
1370
1371 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
1372 if (isa<Constant>(Op0))
1373 if (SelectInst *SI = dyn_cast<SelectInst>(Op1))
1374 if (Instruction *R = FoldOpIntoSelect(I, SI))
1375 return R;
1376
1377 if (isa<Constant>(Op1))
1378 if (SelectInst *SI = dyn_cast<SelectInst>(Op0))
1379 if (Instruction *R = FoldOpIntoSelect(I, SI))
1380 return R;
1381
1382 if (I.hasAllowReassoc() && I.hasAllowReciprocal()) {
1383 Value *X, *Y;
1384 if (match(Op0, m_OneUse(m_FDiv(m_Value(X), m_Value(Y)))) &&
1385 (!isa<Constant>(Y) || !isa<Constant>(Op1))) {
1386 // (X / Y) / Z => X / (Y * Z)
1387 Value *YZ = Builder.CreateFMulFMF(Y, Op1, &I);
1388 return BinaryOperator::CreateFDivFMF(X, YZ, &I);
1389 }
1390 if (match(Op1, m_OneUse(m_FDiv(m_Value(X), m_Value(Y)))) &&
1391 (!isa<Constant>(Y) || !isa<Constant>(Op0))) {
1392 // Z / (X / Y) => (Y * Z) / X
1393 Value *YZ = Builder.CreateFMulFMF(Y, Op0, &I);
1394 return BinaryOperator::CreateFDivFMF(YZ, X, &I);
1395 }
1396 // Z / (1.0 / Y) => (Y * Z)
1397 //
1398 // This is a special case of Z / (X / Y) => (Y * Z) / X, with X = 1.0. The
1399 // m_OneUse check is avoided because even in the case of the multiple uses
1400 // for 1.0/Y, the number of instructions remain the same and a division is
1401 // replaced by a multiplication.
1402 if (match(Op1, m_FDiv(m_SpecificFP(1.0), m_Value(Y))))
1403 return BinaryOperator::CreateFMulFMF(Y, Op0, &I);
1404 }
1405
1406 if (I.hasAllowReassoc() && Op0->hasOneUse() && Op1->hasOneUse()) {
1407 // sin(X) / cos(X) -> tan(X)
1408 // cos(X) / sin(X) -> 1/tan(X) (cotangent)
1409 Value *X;
1410 bool IsTan = match(Op0, m_Intrinsic<Intrinsic::sin>(m_Value(X))) &&
1411 match(Op1, m_Intrinsic<Intrinsic::cos>(m_Specific(X)));
1412 bool IsCot =
1413 !IsTan && match(Op0, m_Intrinsic<Intrinsic::cos>(m_Value(X))) &&
1414 match(Op1, m_Intrinsic<Intrinsic::sin>(m_Specific(X)));
1415
1416 if ((IsTan || IsCot) &&
1417 hasFloatFn(&TLI, I.getType(), LibFunc_tan, LibFunc_tanf, LibFunc_tanl)) {
1418 IRBuilder<> B(&I);
1419 IRBuilder<>::FastMathFlagGuard FMFGuard(B);
1420 B.setFastMathFlags(I.getFastMathFlags());
1421 AttributeList Attrs =
1422 cast<CallBase>(Op0)->getCalledFunction()->getAttributes();
1423 Value *Res = emitUnaryFloatFnCall(X, &TLI, LibFunc_tan, LibFunc_tanf,
1424 LibFunc_tanl, B, Attrs);
1425 if (IsCot)
1426 Res = B.CreateFDiv(ConstantFP::get(I.getType(), 1.0), Res);
1427 return replaceInstUsesWith(I, Res);
1428 }
1429 }
1430
1431 // X / (X * Y) --> 1.0 / Y
1432 // Reassociate to (X / X -> 1.0) is legal when NaNs are not allowed.
1433 // We can ignore the possibility that X is infinity because INF/INF is NaN.
1434 Value *X, *Y;
1435 if (I.hasNoNaNs() && I.hasAllowReassoc() &&
1436 match(Op1, m_c_FMul(m_Specific(Op0), m_Value(Y)))) {
1437 replaceOperand(I, 0, ConstantFP::get(I.getType(), 1.0));
1438 replaceOperand(I, 1, Y);
1439 return &I;
1440 }
1441
1442 // X / fabs(X) -> copysign(1.0, X)
1443 // fabs(X) / X -> copysign(1.0, X)
1444 if (I.hasNoNaNs() && I.hasNoInfs() &&
1445 (match(&I, m_FDiv(m_Value(X), m_FAbs(m_Deferred(X)))) ||
1446 match(&I, m_FDiv(m_FAbs(m_Value(X)), m_Deferred(X))))) {
1447 Value *V = Builder.CreateBinaryIntrinsic(
1448 Intrinsic::copysign, ConstantFP::get(I.getType(), 1.0), X, &I);
1449 return replaceInstUsesWith(I, V);
1450 }
1451
1452 if (Instruction *Mul = foldFDivPowDivisor(I, Builder))
1453 return Mul;
1454
1455 return nullptr;
1456}
1457
1458/// This function implements the transforms common to both integer remainder
1459/// instructions (urem and srem). It is called by the visitors to those integer
1460/// remainder instructions.
1461/// Common integer remainder transforms
1462Instruction *InstCombinerImpl::commonIRemTransforms(BinaryOperator &I) {
1463 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
1464
1465 // The RHS is known non-zero.
1466 if (Value *V = simplifyValueKnownNonZero(I.getOperand(1), *this, I))
6
Assuming 'V' is null
7
Taking false branch
1467 return replaceOperand(I, 1, V);
1468
1469 // Handle cases involving: rem X, (select Cond, Y, Z)
1470 if (simplifyDivRemOfSelectWithZeroOp(I))
8
Calling 'InstCombinerImpl::simplifyDivRemOfSelectWithZeroOp'
1471 return &I;
1472
1473 // If the divisor is a select-of-constants, try to constant fold all rem ops:
1474 // C % (select Cond, TrueC, FalseC) --> select Cond, (C % TrueC), (C % FalseC)
1475 // TODO: Adapt simplifyDivRemOfSelectWithZeroOp to allow this and other folds.
1476 if (match(Op0, m_ImmConstant()) &&
1477 match(Op1, m_Select(m_Value(), m_ImmConstant(), m_ImmConstant()))) {
1478 if (Instruction *R = FoldOpIntoSelect(I, cast<SelectInst>(Op1)))
1479 return R;
1480 }
1481
1482 if (isa<Constant>(Op1)) {
1483 if (Instruction *Op0I = dyn_cast<Instruction>(Op0)) {
1484 if (SelectInst *SI = dyn_cast<SelectInst>(Op0I)) {
1485 if (Instruction *R = FoldOpIntoSelect(I, SI))
1486 return R;
1487 } else if (auto *PN = dyn_cast<PHINode>(Op0I)) {
1488 const APInt *Op1Int;
1489 if (match(Op1, m_APInt(Op1Int)) && !Op1Int->isMinValue() &&
1490 (I.getOpcode() == Instruction::URem ||
1491 !Op1Int->isMinSignedValue())) {
1492 // foldOpIntoPhi will speculate instructions to the end of the PHI's
1493 // predecessor blocks, so do this only if we know the srem or urem
1494 // will not fault.
1495 if (Instruction *NV = foldOpIntoPhi(I, PN))
1496 return NV;
1497 }
1498 }
1499
1500 // See if we can fold away this rem instruction.
1501 if (SimplifyDemandedInstructionBits(I))
1502 return &I;
1503 }
1504 }
1505
1506 return nullptr;
1507}
1508
1509Instruction *InstCombinerImpl::visitURem(BinaryOperator &I) {
1510 if (Value *V = SimplifyURemInst(I.getOperand(0), I.getOperand(1),
1
Assuming 'V' is null
2
Taking false branch
1511 SQ.getWithInstruction(&I)))
1512 return replaceInstUsesWith(I, V);
1513
1514 if (Instruction *X = foldVectorBinop(I))
3
Assuming 'X' is null
4
Taking false branch
1515 return X;
1516
1517 if (Instruction *common = commonIRemTransforms(I))
5
Calling 'InstCombinerImpl::commonIRemTransforms'
1518 return common;
1519
1520 if (Instruction *NarrowRem = narrowUDivURem(I, Builder))
1521 return NarrowRem;
1522
1523 // X urem Y -> X and Y-1, where Y is a power of 2,
1524 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
1525 Type *Ty = I.getType();
1526 if (isKnownToBeAPowerOfTwo(Op1, /*OrZero*/ true, 0, &I)) {
1527 // This may increase instruction count, we don't enforce that Y is a
1528 // constant.
1529 Constant *N1 = Constant::getAllOnesValue(Ty);
1530 Value *Add = Builder.CreateAdd(Op1, N1);
1531 return BinaryOperator::CreateAnd(Op0, Add);
1532 }
1533
1534 // 1 urem X -> zext(X != 1)
1535 if (match(Op0, m_One())) {
1536 Value *Cmp = Builder.CreateICmpNE(Op1, ConstantInt::get(Ty, 1));
1537 return CastInst::CreateZExtOrBitCast(Cmp, Ty);
1538 }
1539
1540 // X urem C -> X < C ? X : X - C, where C >= signbit.
1541 if (match(Op1, m_Negative())) {
1542 Value *Cmp = Builder.CreateICmpULT(Op0, Op1);
1543 Value *Sub = Builder.CreateSub(Op0, Op1);
1544 return SelectInst::Create(Cmp, Op0, Sub);
1545 }
1546
1547 // If the divisor is a sext of a boolean, then the divisor must be max
1548 // unsigned value (-1). Therefore, the remainder is Op0 unless Op0 is also
1549 // max unsigned value. In that case, the remainder is 0:
1550 // urem Op0, (sext i1 X) --> (Op0 == -1) ? 0 : Op0
1551 Value *X;
1552 if (match(Op1, m_SExt(m_Value(X))) && X->getType()->isIntOrIntVectorTy(1)) {
1553 Value *Cmp = Builder.CreateICmpEQ(Op0, ConstantInt::getAllOnesValue(Ty));
1554 return SelectInst::Create(Cmp, ConstantInt::getNullValue(Ty), Op0);
1555 }
1556
1557 return nullptr;
1558}
1559
1560Instruction *InstCombinerImpl::visitSRem(BinaryOperator &I) {
1561 if (Value *V = SimplifySRemInst(I.getOperand(0), I.getOperand(1),
1562 SQ.getWithInstruction(&I)))
1563 return replaceInstUsesWith(I, V);
1564
1565 if (Instruction *X = foldVectorBinop(I))
1566 return X;
1567
1568 // Handle the integer rem common cases
1569 if (Instruction *Common = commonIRemTransforms(I))
1570 return Common;
1571
1572 Value *Op0 = I.getOperand(0), *Op1 = I.getOperand(1);
1573 {
1574 const APInt *Y;
1575 // X % -Y -> X % Y
1576 if (match(Op1, m_Negative(Y)) && !Y->isMinSignedValue())
1577 return replaceOperand(I, 1, ConstantInt::get(I.getType(), -*Y));
1578 }
1579
1580 // -X srem Y --> -(X srem Y)
1581 Value *X, *Y;
1582 if (match(&I, m_SRem(m_OneUse(m_NSWSub(m_Zero(), m_Value(X))), m_Value(Y))))
1583 return BinaryOperator::CreateNSWNeg(Builder.CreateSRem(X, Y));
1584
1585 // If the sign bits of both operands are zero (i.e. we can prove they are
1586 // unsigned inputs), turn this into a urem.
1587 APInt Mask(APInt::getSignMask(I.getType()->getScalarSizeInBits()));
1588 if (MaskedValueIsZero(Op1, Mask, 0, &I) &&
1589 MaskedValueIsZero(Op0, Mask, 0, &I)) {
1590 // X srem Y -> X urem Y, iff X and Y don't have sign bit set
1591 return BinaryOperator::CreateURem(Op0, Op1, I.getName());
1592 }
1593
1594 // If it's a constant vector, flip any negative values positive.
1595 if (isa<ConstantVector>(Op1) || isa<ConstantDataVector>(Op1)) {
1596 Constant *C = cast<Constant>(Op1);
1597 unsigned VWidth = cast<FixedVectorType>(C->getType())->getNumElements();
1598
1599 bool hasNegative = false;
1600 bool hasMissing = false;
1601 for (unsigned i = 0; i != VWidth; ++i) {
1602 Constant *Elt = C->getAggregateElement(i);
1603 if (!Elt) {
1604 hasMissing = true;
1605 break;
1606 }
1607
1608 if (ConstantInt *RHS = dyn_cast<ConstantInt>(Elt))
1609 if (RHS->isNegative())
1610 hasNegative = true;
1611 }
1612
1613 if (hasNegative && !hasMissing) {
1614 SmallVector<Constant *, 16> Elts(VWidth);
1615 for (unsigned i = 0; i != VWidth; ++i) {
1616 Elts[i] = C->getAggregateElement(i); // Handle undef, etc.
1617 if (ConstantInt *RHS = dyn_cast<ConstantInt>(Elts[i])) {
1618 if (RHS->isNegative())
1619 Elts[i] = cast<ConstantInt>(ConstantExpr::getNeg(RHS));
1620 }
1621 }
1622
1623 Constant *NewRHSV = ConstantVector::get(Elts);
1624 if (NewRHSV != C) // Don't loop on -MININT
1625 return replaceOperand(I, 1, NewRHSV);
1626 }
1627 }
1628
1629 return nullptr;
1630}
1631
1632Instruction *InstCombinerImpl::visitFRem(BinaryOperator &I) {
1633 if (Value *V = SimplifyFRemInst(I.getOperand(0), I.getOperand(1),
1634 I.getFastMathFlags(),
1635 SQ.getWithInstruction(&I)))
1636 return replaceInstUsesWith(I, V);
1637
1638 if (Instruction *X = foldVectorBinop(I))
1639 return X;
1640
1641 return nullptr;
1642}

/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/llvm/include/llvm/IR/PatternMatch.h

1//===- PatternMatch.h - Match on the LLVM IR --------------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file provides a simple and efficient mechanism for performing general
10// tree-based pattern matches on the LLVM IR. The power of these routines is
11// that it allows you to write concise patterns that are expressive and easy to
12// understand. The other major advantage of this is that it allows you to
13// trivially capture/bind elements in the pattern to variables. For example,
14// you can do something like this:
15//
16// Value *Exp = ...
17// Value *X, *Y; ConstantInt *C1, *C2; // (X & C1) | (Y & C2)
18// if (match(Exp, m_Or(m_And(m_Value(X), m_ConstantInt(C1)),
19// m_And(m_Value(Y), m_ConstantInt(C2))))) {
20// ... Pattern is matched and variables are bound ...
21// }
22//
23// This is primarily useful to things like the instruction combiner, but can
24// also be useful for static analysis tools or code generators.
25//
26//===----------------------------------------------------------------------===//
27
28#ifndef LLVM_IR_PATTERNMATCH_H
29#define LLVM_IR_PATTERNMATCH_H
30
31#include "llvm/ADT/APFloat.h"
32#include "llvm/ADT/APInt.h"
33#include "llvm/IR/Constant.h"
34#include "llvm/IR/Constants.h"
35#include "llvm/IR/DataLayout.h"
36#include "llvm/IR/InstrTypes.h"
37#include "llvm/IR/Instruction.h"
38#include "llvm/IR/Instructions.h"
39#include "llvm/IR/IntrinsicInst.h"
40#include "llvm/IR/Intrinsics.h"
41#include "llvm/IR/Operator.h"
42#include "llvm/IR/Value.h"
43#include "llvm/Support/Casting.h"
44#include <cstdint>
45
46namespace llvm {
47namespace PatternMatch {
48
49template <typename Val, typename Pattern> bool match(Val *V, const Pattern &P) {
50 return const_cast<Pattern &>(P).match(V);
12
Calling 'is_zero::match'
16
Returning from 'is_zero::match'
17
Returning value, which participates in a condition later
51}
52
53template <typename Pattern> bool match(ArrayRef<int> Mask, const Pattern &P) {
54 return const_cast<Pattern &>(P).match(Mask);
55}
56
57template <typename SubPattern_t> struct OneUse_match {
58 SubPattern_t SubPattern;
59
60 OneUse_match(const SubPattern_t &SP) : SubPattern(SP) {}
61
62 template <typename OpTy> bool match(OpTy *V) {
63 return V->hasOneUse() && SubPattern.match(V);
64 }
65};
66
67template <typename T> inline OneUse_match<T> m_OneUse(const T &SubPattern) {
68 return SubPattern;
69}
70
71template <typename Class> struct class_match {
72 template <typename ITy> bool match(ITy *V) { return isa<Class>(V); }
73};
74
75/// Match an arbitrary value and ignore it.
76inline class_match<Value> m_Value() { return class_match<Value>(); }
77
78/// Match an arbitrary unary operation and ignore it.
79inline class_match<UnaryOperator> m_UnOp() {
80 return class_match<UnaryOperator>();
81}
82
83/// Match an arbitrary binary operation and ignore it.
84inline class_match<BinaryOperator> m_BinOp() {
85 return class_match<BinaryOperator>();
86}
87
88/// Matches any compare instruction and ignore it.
89inline class_match<CmpInst> m_Cmp() { return class_match<CmpInst>(); }
90
91struct undef_match {
92 static bool check(const Value *V) {
93 if (isa<UndefValue>(V))
94 return true;
95
96 const auto *CA = dyn_cast<ConstantAggregate>(V);
97 if (!CA)
98 return false;
99
100 SmallPtrSet<const ConstantAggregate *, 8> Seen;
101 SmallVector<const ConstantAggregate *, 8> Worklist;
102
103 // Either UndefValue, PoisonValue, or an aggregate that only contains
104 // these is accepted by matcher.
105 // CheckValue returns false if CA cannot satisfy this constraint.
106 auto CheckValue = [&](const ConstantAggregate *CA) {
107 for (const Value *Op : CA->operand_values()) {
108 if (isa<UndefValue>(Op))
109 continue;
110
111 const auto *CA = dyn_cast<ConstantAggregate>(Op);
112 if (!CA)
113 return false;
114 if (Seen.insert(CA).second)
115 Worklist.emplace_back(CA);
116 }
117
118 return true;
119 };
120
121 if (!CheckValue(CA))
122 return false;
123
124 while (!Worklist.empty()) {
125 if (!CheckValue(Worklist.pop_back_val()))
126 return false;
127 }
128 return true;
129 }
130 template <typename ITy> bool match(ITy *V) { return check(V); }
131};
132
133/// Match an arbitrary undef constant. This matches poison as well.
134/// If this is an aggregate and contains a non-aggregate element that is
135/// neither undef nor poison, the aggregate is not matched.
136inline auto m_Undef() { return undef_match(); }
137
138/// Match an arbitrary poison constant.
139inline class_match<PoisonValue> m_Poison() { return class_match<PoisonValue>(); }
140
141/// Match an arbitrary Constant and ignore it.
142inline class_match<Constant> m_Constant() { return class_match<Constant>(); }
143
144/// Match an arbitrary ConstantInt and ignore it.
145inline class_match<ConstantInt> m_ConstantInt() {
146 return class_match<ConstantInt>();
147}
148
149/// Match an arbitrary ConstantFP and ignore it.
150inline class_match<ConstantFP> m_ConstantFP() {
151 return class_match<ConstantFP>();
152}
153
154/// Match an arbitrary ConstantExpr and ignore it.
155inline class_match<ConstantExpr> m_ConstantExpr() {
156 return class_match<ConstantExpr>();
157}
158
159/// Match an arbitrary basic block value and ignore it.
160inline class_match<BasicBlock> m_BasicBlock() {
161 return class_match<BasicBlock>();
162}
163
164/// Inverting matcher
165template <typename Ty> struct match_unless {
166 Ty M;
167
168 match_unless(const Ty &Matcher) : M(Matcher) {}
169
170 template <typename ITy> bool match(ITy *V) { return !M.match(V); }
171};
172
173/// Match if the inner matcher does *NOT* match.
174template <typename Ty> inline match_unless<Ty> m_Unless(const Ty &M) {
175 return match_unless<Ty>(M);
176}
177
178/// Matching combinators
179template <typename LTy, typename RTy> struct match_combine_or {
180 LTy L;
181 RTy R;
182
183 match_combine_or(const LTy &Left, const RTy &Right) : L(Left), R(Right) {}
184
185 template <typename ITy> bool match(ITy *V) {
186 if (L.match(V))
187 return true;
188 if (R.match(V))
189 return true;
190 return false;
191 }
192};
193
194template <typename LTy, typename RTy> struct match_combine_and {
195 LTy L;
196 RTy R;
197
198 match_combine_and(const LTy &Left, const RTy &Right) : L(Left), R(Right) {}
199
200 template <typename ITy> bool match(ITy *V) {
201 if (L.match(V))
202 if (R.match(V))
203 return true;
204 return false;
205 }
206};
207
208/// Combine two pattern matchers matching L || R
209template <typename LTy, typename RTy>
210inline match_combine_or<LTy, RTy> m_CombineOr(const LTy &L, const RTy &R) {
211 return match_combine_or<LTy, RTy>(L, R);
212}
213
214/// Combine two pattern matchers matching L && R
215template <typename LTy, typename RTy>
216inline match_combine_and<LTy, RTy> m_CombineAnd(const LTy &L, const RTy &R) {
217 return match_combine_and<LTy, RTy>(L, R);
218}
219
220struct apint_match {
221 const APInt *&Res;
222 bool AllowUndef;
223
224 apint_match(const APInt *&Res, bool AllowUndef)
225 : Res(Res), AllowUndef(AllowUndef) {}
226
227 template <typename ITy> bool match(ITy *V) {
228 if (auto *CI = dyn_cast<ConstantInt>(V)) {
229 Res = &CI->getValue();
230 return true;
231 }
232 if (V->getType()->isVectorTy())
233 if (const auto *C = dyn_cast<Constant>(V))
234 if (auto *CI = dyn_cast_or_null<ConstantInt>(
235 C->getSplatValue(AllowUndef))) {
236 Res = &CI->getValue();
237 return true;
238 }
239 return false;
240 }
241};
242// Either constexpr if or renaming ConstantFP::getValueAPF to
243// ConstantFP::getValue is needed to do it via single template
244// function for both apint/apfloat.
245struct apfloat_match {
246 const APFloat *&Res;
247 bool AllowUndef;
248
249 apfloat_match(const APFloat *&Res, bool AllowUndef)
250 : Res(Res), AllowUndef(AllowUndef) {}
251
252 template <typename ITy> bool match(ITy *V) {
253 if (auto *CI = dyn_cast<ConstantFP>(V)) {
254 Res = &CI->getValueAPF();
255 return true;
256 }
257 if (V->getType()->isVectorTy())
258 if (const auto *C = dyn_cast<Constant>(V))
259 if (auto *CI = dyn_cast_or_null<ConstantFP>(
260 C->getSplatValue(AllowUndef))) {
261 Res = &CI->getValueAPF();
262 return true;
263 }
264 return false;
265 }
266};
267
268/// Match a ConstantInt or splatted ConstantVector, binding the
269/// specified pointer to the contained APInt.
270inline apint_match m_APInt(const APInt *&Res) {
271 // Forbid undefs by default to maintain previous behavior.
272 return apint_match(Res, /* AllowUndef */ false);
273}
274
275/// Match APInt while allowing undefs in splat vector constants.
276inline apint_match m_APIntAllowUndef(const APInt *&Res) {
277 return apint_match(Res, /* AllowUndef */ true);
278}
279
280/// Match APInt while forbidding undefs in splat vector constants.
281inline apint_match m_APIntForbidUndef(const APInt *&Res) {
282 return apint_match(Res, /* AllowUndef */ false);
283}
284
285/// Match a ConstantFP or splatted ConstantVector, binding the
286/// specified pointer to the contained APFloat.
287inline apfloat_match m_APFloat(const APFloat *&Res) {
288 // Forbid undefs by default to maintain previous behavior.
289 return apfloat_match(Res, /* AllowUndef */ false);
290}
291
292/// Match APFloat while allowing undefs in splat vector constants.
293inline apfloat_match m_APFloatAllowUndef(const APFloat *&Res) {
294 return apfloat_match(Res, /* AllowUndef */ true);
295}
296
297/// Match APFloat while forbidding undefs in splat vector constants.
298inline apfloat_match m_APFloatForbidUndef(const APFloat *&Res) {
299 return apfloat_match(Res, /* AllowUndef */ false);
300}
301
302template <int64_t Val> struct constantint_match {
303 template <typename ITy> bool match(ITy *V) {
304 if (const auto *CI = dyn_cast<ConstantInt>(V)) {
305 const APInt &CIV = CI->getValue();
306 if (Val >= 0)
307 return CIV == static_cast<uint64_t>(Val);
308 // If Val is negative, and CI is shorter than it, truncate to the right
309 // number of bits. If it is larger, then we have to sign extend. Just
310 // compare their negated values.
311 return -CIV == -Val;
312 }
313 return false;
314 }
315};
316
317/// Match a ConstantInt with a specific value.
318template <int64_t Val> inline constantint_match<Val> m_ConstantInt() {
319 return constantint_match<Val>();
320}
321
322/// This helper class is used to match constant scalars, vector splats,
323/// and fixed width vectors that satisfy a specified predicate.
324/// For fixed width vector constants, undefined elements are ignored.
325template <typename Predicate, typename ConstantVal>
326struct cstval_pred_ty : public Predicate {
327 template <typename ITy> bool match(ITy *V) {
328 if (const auto *CV = dyn_cast<ConstantVal>(V))
329 return this->isValue(CV->getValue());
330 if (const auto *VTy = dyn_cast<VectorType>(V->getType())) {
331 if (const auto *C = dyn_cast<Constant>(V)) {
332 if (const auto *CV = dyn_cast_or_null<ConstantVal>(C->getSplatValue()))
333 return this->isValue(CV->getValue());
334
335 // Number of elements of a scalable vector unknown at compile time
336 auto *FVTy = dyn_cast<FixedVectorType>(VTy);
337 if (!FVTy)
338 return false;
339
340 // Non-splat vector constant: check each element for a match.
341 unsigned NumElts = FVTy->getNumElements();
342 assert(NumElts != 0 && "Constant vector with no elements?")(static_cast <bool> (NumElts != 0 && "Constant vector with no elements?"
) ? void (0) : __assert_fail ("NumElts != 0 && \"Constant vector with no elements?\""
, "llvm/include/llvm/IR/PatternMatch.h", 342, __extension__ __PRETTY_FUNCTION__
))
;
343 bool HasNonUndefElements = false;
344 for (unsigned i = 0; i != NumElts; ++i) {
345 Constant *Elt = C->getAggregateElement(i);
346 if (!Elt)
347 return false;
348 if (isa<UndefValue>(Elt))
349 continue;
350 auto *CV = dyn_cast<ConstantVal>(Elt);
351 if (!CV || !this->isValue(CV->getValue()))
352 return false;
353 HasNonUndefElements = true;
354 }
355 return HasNonUndefElements;
356 }
357 }
358 return false;
359 }
360};
361
362/// specialization of cstval_pred_ty for ConstantInt
363template <typename Predicate>
364using cst_pred_ty = cstval_pred_ty<Predicate, ConstantInt>;
365
366/// specialization of cstval_pred_ty for ConstantFP
367template <typename Predicate>
368using cstfp_pred_ty = cstval_pred_ty<Predicate, ConstantFP>;
369
370/// This helper class is used to match scalar and vector constants that
371/// satisfy a specified predicate, and bind them to an APInt.
372template <typename Predicate> struct api_pred_ty : public Predicate {
373 const APInt *&Res;
374
375 api_pred_ty(const APInt *&R) : Res(R) {}
376
377 template <typename ITy> bool match(ITy *V) {
378 if (const auto *CI = dyn_cast<ConstantInt>(V))
379 if (this->isValue(CI->getValue())) {
380 Res = &CI->getValue();
381 return true;
382 }
383 if (V->getType()->isVectorTy())
384 if (const auto *C = dyn_cast<Constant>(V))
385 if (auto *CI = dyn_cast_or_null<ConstantInt>(C->getSplatValue()))
386 if (this->isValue(CI->getValue())) {
387 Res = &CI->getValue();
388 return true;
389 }
390
391 return false;
392 }
393};
394
395/// This helper class is used to match scalar and vector constants that
396/// satisfy a specified predicate, and bind them to an APFloat.
397/// Undefs are allowed in splat vector constants.
398template <typename Predicate> struct apf_pred_ty : public Predicate {
399 const APFloat *&Res;
400
401 apf_pred_ty(const APFloat *&R) : Res(R) {}
402
403 template <typename ITy> bool match(ITy *V) {
404 if (const auto *CI = dyn_cast<ConstantFP>(V))
405 if (this->isValue(CI->getValue())) {
406 Res = &CI->getValue();
407 return true;
408 }
409 if (V->getType()->isVectorTy())
410 if (const auto *C = dyn_cast<Constant>(V))
411 if (auto *CI = dyn_cast_or_null<ConstantFP>(
412 C->getSplatValue(/* AllowUndef */ true)))
413 if (this->isValue(CI->getValue())) {
414 Res = &CI->getValue();
415 return true;
416 }
417
418 return false;
419 }
420};
421
422///////////////////////////////////////////////////////////////////////////////
423//
424// Encapsulate constant value queries for use in templated predicate matchers.
425// This allows checking if constants match using compound predicates and works
426// with vector constants, possibly with relaxed constraints. For example, ignore
427// undef values.
428//
429///////////////////////////////////////////////////////////////////////////////
430
431struct is_any_apint {
432 bool isValue(const APInt &C) { return true; }
433};
434/// Match an integer or vector with any integral constant.
435/// For vectors, this includes constants with undefined elements.
436inline cst_pred_ty<is_any_apint> m_AnyIntegralConstant() {
437 return cst_pred_ty<is_any_apint>();
438}
439
440struct is_all_ones {
441 bool isValue(const APInt &C) { return C.isAllOnes(); }
442};
443/// Match an integer or vector with all bits set.
444/// For vectors, this includes constants with undefined elements.
445inline cst_pred_ty<is_all_ones> m_AllOnes() {
446 return cst_pred_ty<is_all_ones>();
447}
448
449struct is_maxsignedvalue {
450 bool isValue(const APInt &C) { return C.isMaxSignedValue(); }
451};
452/// Match an integer or vector with values having all bits except for the high
453/// bit set (0x7f...).
454/// For vectors, this includes constants with undefined elements.
455inline cst_pred_ty<is_maxsignedvalue> m_MaxSignedValue() {
456 return cst_pred_ty<is_maxsignedvalue>();
457}
458inline api_pred_ty<is_maxsignedvalue> m_MaxSignedValue(const APInt *&V) {
459 return V;
460}
461
462struct is_negative {
463 bool isValue(const APInt &C) { return C.isNegative(); }
464};
465/// Match an integer or vector of negative values.
466/// For vectors, this includes constants with undefined elements.
467inline cst_pred_ty<is_negative> m_Negative() {
468 return cst_pred_ty<is_negative>();
469}
470inline api_pred_ty<is_negative> m_Negative(const APInt *&V) {
471 return V;
472}
473
474struct is_nonnegative {
475 bool isValue(const APInt &C) { return C.isNonNegative(); }
476};
477/// Match an integer or vector of non-negative values.
478/// For vectors, this includes constants with undefined elements.
479inline cst_pred_ty<is_nonnegative> m_NonNegative() {
480 return cst_pred_ty<is_nonnegative>();
481}
482inline api_pred_ty<is_nonnegative> m_NonNegative(const APInt *&V) {
483 return V;
484}
485
486struct is_strictlypositive {
487 bool isValue(const APInt &C) { return C.isStrictlyPositive(); }
488};
489/// Match an integer or vector of strictly positive values.
490/// For vectors, this includes constants with undefined elements.
491inline cst_pred_ty<is_strictlypositive> m_StrictlyPositive() {
492 return cst_pred_ty<is_strictlypositive>();
493}
494inline api_pred_ty<is_strictlypositive> m_StrictlyPositive(const APInt *&V) {
495 return V;
496}
497
498struct is_nonpositive {
499 bool isValue(const APInt &C) { return C.isNonPositive(); }
500};
501/// Match an integer or vector of non-positive values.
502/// For vectors, this includes constants with undefined elements.
503inline cst_pred_ty<is_nonpositive> m_NonPositive() {
504 return cst_pred_ty<is_nonpositive>();
505}
506inline api_pred_ty<is_nonpositive> m_NonPositive(const APInt *&V) { return V; }
507
508struct is_one {
509 bool isValue(const APInt &C) { return C.isOne(); }
510};
511/// Match an integer 1 or a vector with all elements equal to 1.
512/// For vectors, this includes constants with undefined elements.
513inline cst_pred_ty<is_one> m_One() {
514 return cst_pred_ty<is_one>();
515}
516
517struct is_zero_int {
518 bool isValue(const APInt &C) { return C.isZero(); }
519};
520/// Match an integer 0 or a vector with all elements equal to 0.
521/// For vectors, this includes constants with undefined elements.
522inline cst_pred_ty<is_zero_int> m_ZeroInt() {
523 return cst_pred_ty<is_zero_int>();
524}
525
526struct is_zero {
527 template <typename ITy> bool match(ITy *V) {
528 auto *C = dyn_cast<Constant>(V);
13
Assuming 'V' is a 'Constant'
529 // FIXME: this should be able to do something for scalable vectors
530 return C
13.1
'C' is non-null
13.1
'C' is non-null
13.1
'C' is non-null
13.1
'C' is non-null
&& (C->isNullValue() || cst_pred_ty<is_zero_int>().match(C))
;
14
Assuming the condition is false
15
Returning value, which participates in a condition later
531 }
532};
533/// Match any null constant or a vector with all elements equal to 0.
534/// For vectors, this includes constants with undefined elements.
535inline is_zero m_Zero() {
536 return is_zero();
537}
538
539struct is_power2 {
540 bool isValue(const APInt &C) { return C.isPowerOf2(); }
541};
542/// Match an integer or vector power-of-2.
543/// For vectors, this includes constants with undefined elements.
544inline cst_pred_ty<is_power2> m_Power2() {
545 return cst_pred_ty<is_power2>();
546}
547inline api_pred_ty<is_power2> m_Power2(const APInt *&V) {
548 return V;
549}
550
551struct is_negated_power2 {
552 bool isValue(const APInt &C) { return C.isNegatedPowerOf2(); }
553};
554/// Match a integer or vector negated power-of-2.
555/// For vectors, this includes constants with undefined elements.
556inline cst_pred_ty<is_negated_power2> m_NegatedPower2() {
557 return cst_pred_ty<is_negated_power2>();
558}
559inline api_pred_ty<is_negated_power2> m_NegatedPower2(const APInt *&V) {
560 return V;
561}
562
563struct is_power2_or_zero {
564 bool isValue(const APInt &C) { return !C || C.isPowerOf2(); }
565};
566/// Match an integer or vector of 0 or power-of-2 values.
567/// For vectors, this includes constants with undefined elements.
568inline cst_pred_ty<is_power2_or_zero> m_Power2OrZero() {
569 return cst_pred_ty<is_power2_or_zero>();
570}
571inline api_pred_ty<is_power2_or_zero> m_Power2OrZero(const APInt *&V) {
572 return V;
573}
574
575struct is_sign_mask {
576 bool isValue(const APInt &C) { return C.isSignMask(); }
577};
578/// Match an integer or vector with only the sign bit(s) set.
579/// For vectors, this includes constants with undefined elements.
580inline cst_pred_ty<is_sign_mask> m_SignMask() {
581 return cst_pred_ty<is_sign_mask>();
582}
583
584struct is_lowbit_mask {
585 bool isValue(const APInt &C) { return C.isMask(); }
586};
587/// Match an integer or vector with only the low bit(s) set.
588/// For vectors, this includes constants with undefined elements.
589inline cst_pred_ty<is_lowbit_mask> m_LowBitMask() {
590 return cst_pred_ty<is_lowbit_mask>();
591}
592inline api_pred_ty<is_lowbit_mask> m_LowBitMask(const APInt *&V) {
593 return V;
594}
595
596struct icmp_pred_with_threshold {
597 ICmpInst::Predicate Pred;
598 const APInt *Thr;
599 bool isValue(const APInt &C) { return ICmpInst::compare(C, *Thr, Pred); }
600};
601/// Match an integer or vector with every element comparing 'pred' (eg/ne/...)
602/// to Threshold. For vectors, this includes constants with undefined elements.
603inline cst_pred_ty<icmp_pred_with_threshold>
604m_SpecificInt_ICMP(ICmpInst::Predicate Predicate, const APInt &Threshold) {
605 cst_pred_ty<icmp_pred_with_threshold> P;
606 P.Pred = Predicate;
607 P.Thr = &Threshold;
608 return P;
609}
610
611struct is_nan {
612 bool isValue(const APFloat &C) { return C.isNaN(); }
613};
614/// Match an arbitrary NaN constant. This includes quiet and signalling nans.
615/// For vectors, this includes constants with undefined elements.
616inline cstfp_pred_ty<is_nan> m_NaN() {
617 return cstfp_pred_ty<is_nan>();
618}
619
620struct is_nonnan {
621 bool isValue(const APFloat &C) { return !C.isNaN(); }
622};
623/// Match a non-NaN FP constant.
624/// For vectors, this includes constants with undefined elements.
625inline cstfp_pred_ty<is_nonnan> m_NonNaN() {
626 return cstfp_pred_ty<is_nonnan>();
627}
628
629struct is_inf {
630 bool isValue(const APFloat &C) { return C.isInfinity(); }
631};
632/// Match a positive or negative infinity FP constant.
633/// For vectors, this includes constants with undefined elements.
634inline cstfp_pred_ty<is_inf> m_Inf() {
635 return cstfp_pred_ty<is_inf>();
636}
637
638struct is_noninf {
639 bool isValue(const APFloat &C) { return !C.isInfinity(); }
640};
641/// Match a non-infinity FP constant, i.e. finite or NaN.
642/// For vectors, this includes constants with undefined elements.
643inline cstfp_pred_ty<is_noninf> m_NonInf() {
644 return cstfp_pred_ty<is_noninf>();
645}
646
647struct is_finite {
648 bool isValue(const APFloat &C) { return C.isFinite(); }
649};
650/// Match a finite FP constant, i.e. not infinity or NaN.
651/// For vectors, this includes constants with undefined elements.
652inline cstfp_pred_ty<is_finite> m_Finite() {
653 return cstfp_pred_ty<is_finite>();
654}
655inline apf_pred_ty<is_finite> m_Finite(const APFloat *&V) { return V; }
656
657struct is_finitenonzero {
658 bool isValue(const APFloat &C) { return C.isFiniteNonZero(); }
659};
660/// Match a finite non-zero FP constant.
661/// For vectors, this includes constants with undefined elements.
662inline cstfp_pred_ty<is_finitenonzero> m_FiniteNonZero() {
663 return cstfp_pred_ty<is_finitenonzero>();
664}
665inline apf_pred_ty<is_finitenonzero> m_FiniteNonZero(const APFloat *&V) {
666 return V;
667}
668
669struct is_any_zero_fp {
670 bool isValue(const APFloat &C) { return C.isZero(); }
671};
672/// Match a floating-point negative zero or positive zero.
673/// For vectors, this includes constants with undefined elements.
674inline cstfp_pred_ty<is_any_zero_fp> m_AnyZeroFP() {
675 return cstfp_pred_ty<is_any_zero_fp>();
676}
677
678struct is_pos_zero_fp {
679 bool isValue(const APFloat &C) { return C.isPosZero(); }
680};
681/// Match a floating-point positive zero.
682/// For vectors, this includes constants with undefined elements.
683inline cstfp_pred_ty<is_pos_zero_fp> m_PosZeroFP() {
684 return cstfp_pred_ty<is_pos_zero_fp>();
685}
686
687struct is_neg_zero_fp {
688 bool isValue(const APFloat &C) { return C.isNegZero(); }
689};
690/// Match a floating-point negative zero.
691/// For vectors, this includes constants with undefined elements.
692inline cstfp_pred_ty<is_neg_zero_fp> m_NegZeroFP() {
693 return cstfp_pred_ty<is_neg_zero_fp>();
694}
695
696struct is_non_zero_fp {
697 bool isValue(const APFloat &C) { return C.isNonZero(); }
698};
699/// Match a floating-point non-zero.
700/// For vectors, this includes constants with undefined elements.
701inline cstfp_pred_ty<is_non_zero_fp> m_NonZeroFP() {
702 return cstfp_pred_ty<is_non_zero_fp>();
703}
704
705///////////////////////////////////////////////////////////////////////////////
706
707template <typename Class> struct bind_ty {
708 Class *&VR;
709
710 bind_ty(Class *&V) : VR(V) {}
711
712 template <typename ITy> bool match(ITy *V) {
713 if (auto *CV = dyn_cast<Class>(V)) {
714 VR = CV;
715 return true;
716 }
717 return false;
718 }
719};
720
721/// Match a value, capturing it if we match.
722inline bind_ty<Value> m_Value(Value *&V) { return V; }
723inline bind_ty<const Value> m_Value(const Value *&V) { return V; }
724
725/// Match an instruction, capturing it if we match.
726inline bind_ty<Instruction> m_Instruction(Instruction *&I) { return I; }
727/// Match a unary operator, capturing it if we match.
728inline bind_ty<UnaryOperator> m_UnOp(UnaryOperator *&I) { return I; }
729/// Match a binary operator, capturing it if we match.
730inline bind_ty<BinaryOperator> m_BinOp(BinaryOperator *&I) { return I; }
731/// Match a with overflow intrinsic, capturing it if we match.
732inline bind_ty<WithOverflowInst> m_WithOverflowInst(WithOverflowInst *&I) { return I; }
733inline bind_ty<const WithOverflowInst>
734m_WithOverflowInst(const WithOverflowInst *&I) {
735 return I;
736}
737
738/// Match a Constant, capturing the value if we match.
739inline bind_ty<Constant> m_Constant(Constant *&C) { return C; }
740
741/// Match a ConstantInt, capturing the value if we match.
742inline bind_ty<ConstantInt> m_ConstantInt(ConstantInt *&CI) { return CI; }
743
744/// Match a ConstantFP, capturing the value if we match.
745inline bind_ty<ConstantFP> m_ConstantFP(ConstantFP *&C) { return C; }
746
747/// Match a ConstantExpr, capturing the value if we match.
748inline bind_ty<ConstantExpr> m_ConstantExpr(ConstantExpr *&C) { return C; }
749
750/// Match a basic block value, capturing it if we match.
751inline bind_ty<BasicBlock> m_BasicBlock(BasicBlock *&V) { return V; }
752inline bind_ty<const BasicBlock> m_BasicBlock(const BasicBlock *&V) {
753 return V;
754}
755
756/// Match an arbitrary immediate Constant and ignore it.
757inline match_combine_and<class_match<Constant>,
758 match_unless<class_match<ConstantExpr>>>
759m_ImmConstant() {
760 return m_CombineAnd(m_Constant(), m_Unless(m_ConstantExpr()));
761}
762
763/// Match an immediate Constant, capturing the value if we match.
764inline match_combine_and<bind_ty<Constant>,
765 match_unless<class_match<ConstantExpr>>>
766m_ImmConstant(Constant *&C) {
767 return m_CombineAnd(m_Constant(C), m_Unless(m_ConstantExpr()));
768}
769
770/// Match a specified Value*.
771struct specificval_ty {
772 const Value *Val;
773
774 specificval_ty(const Value *V) : Val(V) {}
775
776 template <typename ITy> bool match(ITy *V) { return V == Val; }
777};
778
779/// Match if we have a specific specified value.
780inline specificval_ty m_Specific(const Value *V) { return V; }
781
782/// Stores a reference to the Value *, not the Value * itself,
783/// thus can be used in commutative matchers.
784template <typename Class> struct deferredval_ty {
785 Class *const &Val;
786
787 deferredval_ty(Class *const &V) : Val(V) {}
788
789 template <typename ITy> bool match(ITy *const V) { return V == Val; }
790};
791
792/// Like m_Specific(), but works if the specific value to match is determined
793/// as part of the same match() expression. For example:
794/// m_Add(m_Value(X), m_Specific(X)) is incorrect, because m_Specific() will
795/// bind X before the pattern match starts.
796/// m_Add(m_Value(X), m_Deferred(X)) is correct, and will check against
797/// whichever value m_Value(X) populated.
798inline deferredval_ty<Value> m_Deferred(Value *const &V) { return V; }
799inline deferredval_ty<const Value> m_Deferred(const Value *const &V) {
800 return V;
801}
802
803/// Match a specified floating point value or vector of all elements of
804/// that value.
805struct specific_fpval {
806 double Val;
807
808 specific_fpval(double V) : Val(V) {}
809
810 template <typename ITy> bool match(ITy *V) {
811 if (const auto *CFP = dyn_cast<ConstantFP>(V))
812 return CFP->isExactlyValue(Val);
813 if (V->getType()->isVectorTy())
814 if (const auto *C = dyn_cast<Constant>(V))
815 if (auto *CFP = dyn_cast_or_null<ConstantFP>(C->getSplatValue()))
816 return CFP->isExactlyValue(Val);
817 return false;
818 }
819};
820
821/// Match a specific floating point value or vector with all elements
822/// equal to the value.
823inline specific_fpval m_SpecificFP(double V) { return specific_fpval(V); }
824
825/// Match a float 1.0 or vector with all elements equal to 1.0.
826inline specific_fpval m_FPOne() { return m_SpecificFP(1.0); }
827
828struct bind_const_intval_ty {
829 uint64_t &VR;
830
831 bind_const_intval_ty(uint64_t &V) : VR(V) {}
832
833 template <typename ITy> bool match(ITy *V) {
834 if (const auto *CV = dyn_cast<ConstantInt>(V))
835 if (CV->getValue().ule(UINT64_MAX(18446744073709551615UL))) {
836 VR = CV->getZExtValue();
837 return true;
838 }
839 return false;
840 }
841};
842
843/// Match a specified integer value or vector of all elements of that
844/// value.
845template <bool AllowUndefs>
846struct specific_intval {
847 APInt Val;
848
849 specific_intval(APInt V) : Val(std::move(V)) {}
850
851 template <typename ITy> bool match(ITy *V) {
852 const auto *CI = dyn_cast<ConstantInt>(V);
853 if (!CI && V->getType()->isVectorTy())
854 if (const auto *C = dyn_cast<Constant>(V))
855 CI = dyn_cast_or_null<ConstantInt>(C->getSplatValue(AllowUndefs));
856
857 return CI && APInt::isSameValue(CI->getValue(), Val);
858 }
859};
860
861/// Match a specific integer value or vector with all elements equal to
862/// the value.
863inline specific_intval<false> m_SpecificInt(APInt V) {
864 return specific_intval<false>(std::move(V));
865}
866
867inline specific_intval<false> m_SpecificInt(uint64_t V) {
868 return m_SpecificInt(APInt(64, V));
869}
870
871inline specific_intval<true> m_SpecificIntAllowUndef(APInt V) {
872 return specific_intval<true>(std::move(V));
873}
874
875inline specific_intval<true> m_SpecificIntAllowUndef(uint64_t V) {
876 return m_SpecificIntAllowUndef(APInt(64, V));
877}
878
879/// Match a ConstantInt and bind to its value. This does not match
880/// ConstantInts wider than 64-bits.
881inline bind_const_intval_ty m_ConstantInt(uint64_t &V) { return V; }
882
883/// Match a specified basic block value.
884struct specific_bbval {
885 BasicBlock *Val;
886
887 specific_bbval(BasicBlock *Val) : Val(Val) {}
888
889 template <typename ITy> bool match(ITy *V) {
890 const auto *BB = dyn_cast<BasicBlock>(V);
891 return BB && BB == Val;
892 }
893};
894
895/// Match a specific basic block value.
896inline specific_bbval m_SpecificBB(BasicBlock *BB) {
897 return specific_bbval(BB);
898}
899
900/// A commutative-friendly version of m_Specific().
901inline deferredval_ty<BasicBlock> m_Deferred(BasicBlock *const &BB) {
902 return BB;
903}
904inline deferredval_ty<const BasicBlock>
905m_Deferred(const BasicBlock *const &BB) {
906 return BB;
907}
908
909//===----------------------------------------------------------------------===//
910// Matcher for any binary operator.
911//
912template <typename LHS_t, typename RHS_t, bool Commutable = false>
913struct AnyBinaryOp_match {
914 LHS_t L;
915 RHS_t R;
916
917 // The evaluation order is always stable, regardless of Commutability.
918 // The LHS is always matched first.
919 AnyBinaryOp_match(const LHS_t &LHS, const RHS_t &RHS) : L(LHS), R(RHS) {}
920
921 template <typename OpTy> bool match(OpTy *V) {
922 if (auto *I = dyn_cast<BinaryOperator>(V))
923 return (L.match(I->getOperand(0)) && R.match(I->getOperand(1))) ||
924 (Commutable && L.match(I->getOperand(1)) &&
925 R.match(I->getOperand(0)));
926 return false;
927 }
928};
929
930template <typename LHS, typename RHS>
931inline AnyBinaryOp_match<LHS, RHS> m_BinOp(const LHS &L, const RHS &R) {
932 return AnyBinaryOp_match<LHS, RHS>(L, R);
933}
934
935//===----------------------------------------------------------------------===//
936// Matcher for any unary operator.
937// TODO fuse unary, binary matcher into n-ary matcher
938//
939template <typename OP_t> struct AnyUnaryOp_match {
940 OP_t X;
941
942 AnyUnaryOp_match(const OP_t &X) : X(X) {}
943
944 template <typename OpTy> bool match(OpTy *V) {
945 if (auto *I = dyn_cast<UnaryOperator>(V))
946 return X.match(I->getOperand(0));
947 return false;
948 }
949};
950
951template <typename OP_t> inline AnyUnaryOp_match<OP_t> m_UnOp(const OP_t &X) {
952 return AnyUnaryOp_match<OP_t>(X);
953}
954
955//===----------------------------------------------------------------------===//
956// Matchers for specific binary operators.
957//
958
959template <typename LHS_t, typename RHS_t, unsigned Opcode,
960 bool Commutable = false>
961struct BinaryOp_match {
962 LHS_t L;
963 RHS_t R;
964
965 // The evaluation order is always stable, regardless of Commutability.
966 // The LHS is always matched first.
967 BinaryOp_match(const LHS_t &LHS, const RHS_t &RHS) : L(LHS), R(RHS) {}
968
969 template <typename OpTy> inline bool match(unsigned Opc, OpTy *V) {
970 if (V->getValueID() == Value::InstructionVal + Opc) {
971 auto *I = cast<BinaryOperator>(V);
972 return (L.match(I->getOperand(0)) && R.match(I->getOperand(1))) ||
973 (Commutable && L.match(I->getOperand(1)) &&
974 R.match(I->getOperand(0)));
975 }
976 if (auto *CE = dyn_cast<ConstantExpr>(V))
977 return CE->getOpcode() == Opc &&
978 ((L.match(CE->getOperand(0)) && R.match(CE->getOperand(1))) ||
979 (Commutable && L.match(CE->getOperand(1)) &&
980 R.match(CE->getOperand(0))));
981 return false;
982 }
983
984 template <typename OpTy> bool match(OpTy *V) { return match(Opcode, V); }
985};
986
987template <typename LHS, typename RHS>
988inline BinaryOp_match<LHS, RHS, Instruction::Add> m_Add(const LHS &L,
989 const RHS &R) {
990 return BinaryOp_match<LHS, RHS, Instruction::Add>(L, R);
991}
992
993template <typename LHS, typename RHS>
994inline BinaryOp_match<LHS, RHS, Instruction::FAdd> m_FAdd(const LHS &L,
995 const RHS &R) {
996 return BinaryOp_match<LHS, RHS, Instruction::FAdd>(L, R);
997}
998
999template <typename LHS, typename RHS>
1000inline BinaryOp_match<LHS, RHS, Instruction::Sub> m_Sub(const LHS &L,
1001 const RHS &R) {
1002 return BinaryOp_match<LHS, RHS, Instruction::Sub>(L, R);
1003}
1004
1005template <typename LHS, typename RHS>
1006inline BinaryOp_match<LHS, RHS, Instruction::FSub> m_FSub(const LHS &L,
1007 const RHS &R) {
1008 return BinaryOp_match<LHS, RHS, Instruction::FSub>(L, R);
1009}
1010
1011template <typename Op_t> struct FNeg_match {
1012 Op_t X;
1013
1014 FNeg_match(const Op_t &Op) : X(Op) {}
1015 template <typename OpTy> bool match(OpTy *V) {
1016 auto *FPMO = dyn_cast<FPMathOperator>(V);
1017 if (!FPMO) return false;
1018
1019 if (FPMO->getOpcode() == Instruction::FNeg)
1020 return X.match(FPMO->getOperand(0));
1021
1022 if (FPMO->getOpcode() == Instruction::FSub) {
1023 if (FPMO->hasNoSignedZeros()) {
1024 // With 'nsz', any zero goes.
1025 if (!cstfp_pred_ty<is_any_zero_fp>().match(FPMO->getOperand(0)))
1026 return false;
1027 } else {
1028 // Without 'nsz', we need fsub -0.0, X exactly.
1029 if (!cstfp_pred_ty<is_neg_zero_fp>().match(FPMO->getOperand(0)))
1030 return false;
1031 }
1032
1033 return X.match(FPMO->getOperand(1));
1034 }
1035
1036 return false;
1037 }
1038};
1039
1040/// Match 'fneg X' as 'fsub -0.0, X'.
1041template <typename OpTy>
1042inline FNeg_match<OpTy>
1043m_FNeg(const OpTy &X) {
1044 return FNeg_match<OpTy>(X);
1045}
1046
1047/// Match 'fneg X' as 'fsub +-0.0, X'.
1048template <typename RHS>
1049inline BinaryOp_match<cstfp_pred_ty<is_any_zero_fp>, RHS, Instruction::FSub>
1050m_FNegNSZ(const RHS &X) {
1051 return m_FSub(m_AnyZeroFP(), X);
1052}
1053
1054template <typename LHS, typename RHS>
1055inline BinaryOp_match<LHS, RHS, Instruction::Mul> m_Mul(const LHS &L,
1056 const RHS &R) {
1057 return BinaryOp_match<LHS, RHS, Instruction::Mul>(L, R);
1058}
1059
1060template <typename LHS, typename RHS>
1061inline BinaryOp_match<LHS, RHS, Instruction::FMul> m_FMul(const LHS &L,
1062 const RHS &R) {
1063 return BinaryOp_match<LHS, RHS, Instruction::FMul>(L, R);
1064}
1065
1066template <typename LHS, typename RHS>
1067inline BinaryOp_match<LHS, RHS, Instruction::UDiv> m_UDiv(const LHS &L,
1068 const RHS &R) {
1069 return BinaryOp_match<LHS, RHS, Instruction::UDiv>(L, R);
1070}
1071
1072template <typename LHS, typename RHS>
1073inline BinaryOp_match<LHS, RHS, Instruction::SDiv> m_SDiv(const LHS &L,
1074 const RHS &R) {
1075 return BinaryOp_match<LHS, RHS, Instruction::SDiv>(L, R);
1076}
1077
1078template <typename LHS, typename RHS>
1079inline BinaryOp_match<LHS, RHS, Instruction::FDiv> m_FDiv(const LHS &L,
1080 const RHS &R) {
1081 return BinaryOp_match<LHS, RHS, Instruction::FDiv>(L, R);
1082}
1083
1084template <typename LHS, typename RHS>
1085inline BinaryOp_match<LHS, RHS, Instruction::URem> m_URem(const LHS &L,
1086 const RHS &R) {
1087 return BinaryOp_match<LHS, RHS, Instruction::URem>(L, R);
1088}
1089
1090template <typename LHS, typename RHS>
1091inline BinaryOp_match<LHS, RHS, Instruction::SRem> m_SRem(const LHS &L,
1092 const RHS &R) {
1093 return BinaryOp_match<LHS, RHS, Instruction::SRem>(L, R);
1094}
1095
1096template <typename LHS, typename RHS>
1097inline BinaryOp_match<LHS, RHS, Instruction::FRem> m_FRem(const LHS &L,
1098 const RHS &R) {
1099 return BinaryOp_match<LHS, RHS, Instruction::FRem>(L, R);
1100}
1101
1102template <typename LHS, typename RHS>
1103inline BinaryOp_match<LHS, RHS, Instruction::And> m_And(const LHS &L,
1104 const RHS &R) {
1105 return BinaryOp_match<LHS, RHS, Instruction::And>(L, R);
1106}
1107
1108template <typename LHS, typename RHS>
1109inline BinaryOp_match<LHS, RHS, Instruction::Or> m_Or(const LHS &L,
1110 const RHS &R) {
1111 return BinaryOp_match<LHS, RHS, Instruction::Or>(L, R);
1112}
1113
1114template <typename LHS, typename RHS>
1115inline BinaryOp_match<LHS, RHS, Instruction::Xor> m_Xor(const LHS &L,
1116 const RHS &R) {
1117 return BinaryOp_match<LHS, RHS, Instruction::Xor>(L, R);
1118}
1119
1120template <typename LHS, typename RHS>
1121inline BinaryOp_match<LHS, RHS, Instruction::Shl> m_Shl(const LHS &L,
1122 const RHS &R) {
1123 return BinaryOp_match<LHS, RHS, Instruction::Shl>(L, R);
1124}
1125
1126template <typename LHS, typename RHS>
1127inline BinaryOp_match<LHS, RHS, Instruction::LShr> m_LShr(const LHS &L,
1128 const RHS &R) {
1129 return BinaryOp_match<LHS, RHS, Instruction::LShr>(L, R);
1130}
1131
1132template <typename LHS, typename RHS>
1133inline BinaryOp_match<LHS, RHS, Instruction::AShr> m_AShr(const LHS &L,
1134 const RHS &R) {
1135 return BinaryOp_match<LHS, RHS, Instruction::AShr>(L, R);
1136}
1137
1138template <typename LHS_t, typename RHS_t, unsigned Opcode,
1139 unsigned WrapFlags = 0>
1140struct OverflowingBinaryOp_match {
1141 LHS_t L;
1142 RHS_t R;
1143
1144 OverflowingBinaryOp_match(const LHS_t &LHS, const RHS_t &RHS)
1145 : L(LHS), R(RHS) {}
1146
1147 template <typename OpTy> bool match(OpTy *V) {
1148 if (auto *Op = dyn_cast<OverflowingBinaryOperator>(V)) {
1149 if (Op->getOpcode() != Opcode)
1150 return false;
1151 if ((WrapFlags & OverflowingBinaryOperator::NoUnsignedWrap) &&
1152 !Op->hasNoUnsignedWrap())
1153 return false;
1154 if ((WrapFlags & OverflowingBinaryOperator::NoSignedWrap) &&
1155 !Op->hasNoSignedWrap())
1156 return false;
1157 return L.match(Op->getOperand(0)) && R.match(Op->getOperand(1));
1158 }
1159 return false;
1160 }
1161};
1162
1163template <typename LHS, typename RHS>
1164inline OverflowingBinaryOp_match<LHS, RHS, Instruction::Add,
1165 OverflowingBinaryOperator::NoSignedWrap>
1166m_NSWAdd(const LHS &L, const RHS &R) {
1167 return OverflowingBinaryOp_match<LHS, RHS, Instruction::Add,
1168 OverflowingBinaryOperator::NoSignedWrap>(
1169 L, R);
1170}
1171template <typename LHS, typename RHS>
1172inline OverflowingBinaryOp_match<LHS, RHS, Instruction::Sub,
1173 OverflowingBinaryOperator::NoSignedWrap>
1174m_NSWSub(const LHS &L, const RHS &R) {
1175 return OverflowingBinaryOp_match<LHS, RHS, Instruction::Sub,
1176 OverflowingBinaryOperator::NoSignedWrap>(
1177 L, R);
1178}
1179template <typename LHS, typename RHS>
1180inline OverflowingBinaryOp_match<LHS, RHS, Instruction::Mul,
1181 OverflowingBinaryOperator::NoSignedWrap>
1182m_NSWMul(const LHS &L, const RHS &R) {
1183 return OverflowingBinaryOp_match<LHS, RHS, Instruction::Mul,
1184 OverflowingBinaryOperator::NoSignedWrap>(
1185 L, R);
1186}
1187template <typename LHS, typename RHS>
1188inline OverflowingBinaryOp_match<LHS, RHS, Instruction::Shl,
1189 OverflowingBinaryOperator::NoSignedWrap>
1190m_NSWShl(const LHS &L, const RHS &R) {
1191 return OverflowingBinaryOp_match<LHS, RHS, Instruction::Shl,
1192 OverflowingBinaryOperator::NoSignedWrap>(
1193 L, R);
1194}
1195
1196template <typename LHS, typename RHS>
1197inline OverflowingBinaryOp_match<LHS, RHS, Instruction::Add,
1198 OverflowingBinaryOperator::NoUnsignedWrap>
1199m_NUWAdd(const LHS &L, const RHS &R) {
1200 return OverflowingBinaryOp_match<LHS, RHS, Instruction::Add,
1201 OverflowingBinaryOperator::NoUnsignedWrap>(
1202 L, R);
1203}
1204template <typename LHS, typename RHS>
1205inline OverflowingBinaryOp_match<LHS, RHS, Instruction::Sub,
1206 OverflowingBinaryOperator::NoUnsignedWrap>
1207m_NUWSub(const LHS &L, const RHS &R) {
1208 return OverflowingBinaryOp_match<LHS, RHS, Instruction::Sub,
1209 OverflowingBinaryOperator::NoUnsignedWrap>(
1210 L, R);
1211}
1212template <typename LHS, typename RHS>
1213inline OverflowingBinaryOp_match<LHS, RHS, Instruction::Mul,
1214 OverflowingBinaryOperator::NoUnsignedWrap>
1215m_NUWMul(const LHS &L, const RHS &R) {
1216 return OverflowingBinaryOp_match<LHS, RHS, Instruction::Mul,
1217 OverflowingBinaryOperator::NoUnsignedWrap>(
1218 L, R);
1219}
1220template <typename LHS, typename RHS>
1221inline OverflowingBinaryOp_match<LHS, RHS, Instruction::Shl,
1222 OverflowingBinaryOperator::NoUnsignedWrap>
1223m_NUWShl(const LHS &L, const RHS &R) {
1224 return OverflowingBinaryOp_match<LHS, RHS, Instruction::Shl,
1225 OverflowingBinaryOperator::NoUnsignedWrap>(
1226 L, R);
1227}
1228
1229template <typename LHS_t, typename RHS_t, bool Commutable = false>
1230struct SpecificBinaryOp_match
1231 : public BinaryOp_match<LHS_t, RHS_t, 0, Commutable> {
1232 unsigned Opcode;
1233
1234 SpecificBinaryOp_match(unsigned Opcode, const LHS_t &LHS, const RHS_t &RHS)
1235 : BinaryOp_match<LHS_t, RHS_t, 0, Commutable>(LHS, RHS), Opcode(Opcode) {}
1236
1237 template <typename OpTy> bool match(OpTy *V) {
1238 return BinaryOp_match<LHS_t, RHS_t, 0, Commutable>::match(Opcode, V);
1239 }
1240};
1241
1242/// Matches a specific opcode.
1243template <typename LHS, typename RHS>
1244inline SpecificBinaryOp_match<LHS, RHS> m_BinOp(unsigned Opcode, const LHS &L,
1245 const RHS &R) {
1246 return SpecificBinaryOp_match<LHS, RHS>(Opcode, L, R);
1247}
1248
1249//===----------------------------------------------------------------------===//
1250// Class that matches a group of binary opcodes.
1251//
1252template <typename LHS_t, typename RHS_t, typename Predicate>
1253struct BinOpPred_match : Predicate {
1254 LHS_t L;
1255 RHS_t R;
1256
1257 BinOpPred_match(const LHS_t &LHS, const RHS_t &RHS) : L(LHS), R(RHS) {}
1258
1259 template <typename OpTy> bool match(OpTy *V) {
1260 if (auto *I = dyn_cast<Instruction>(V))
1261 return this->isOpType(I->getOpcode()) && L.match(I->getOperand(0)) &&
1262 R.match(I->getOperand(1));
1263 if (auto *CE = dyn_cast<ConstantExpr>(V))
1264 return this->isOpType(CE->getOpcode()) && L.match(CE->getOperand(0)) &&
1265 R.match(CE->getOperand(1));
1266 return false;
1267 }
1268};
1269
1270struct is_shift_op {
1271 bool isOpType(unsigned Opcode) { return Instruction::isShift(Opcode); }
1272};
1273
1274struct is_right_shift_op {
1275 bool isOpType(unsigned Opcode) {
1276 return Opcode == Instruction::LShr || Opcode == Instruction::AShr;
1277 }
1278};
1279
1280struct is_logical_shift_op {
1281 bool isOpType(unsigned Opcode) {
1282 return Opcode == Instruction::LShr || Opcode == Instruction::Shl;
1283 }
1284};
1285
1286struct is_bitwiselogic_op {
1287 bool isOpType(unsigned Opcode) {
1288 return Instruction::isBitwiseLogicOp(Opcode);
1289 }
1290};
1291
1292struct is_idiv_op {
1293 bool isOpType(unsigned Opcode) {
1294 return Opcode == Instruction::SDiv || Opcode == Instruction::UDiv;
1295 }
1296};
1297
1298struct is_irem_op {
1299 bool isOpType(unsigned Opcode) {
1300 return Opcode == Instruction::SRem || Opcode == Instruction::URem;
1301 }
1302};
1303
1304/// Matches shift operations.
1305template <typename LHS, typename RHS>
1306inline BinOpPred_match<LHS, RHS, is_shift_op> m_Shift(const LHS &L,
1307 const RHS &R) {
1308 return BinOpPred_match<LHS, RHS, is_shift_op>(L, R);
1309}
1310
1311/// Matches logical shift operations.
1312template <typename LHS, typename RHS>
1313inline BinOpPred_match<LHS, RHS, is_right_shift_op> m_Shr(const LHS &L,
1314 const RHS &R) {
1315 return BinOpPred_match<LHS, RHS, is_right_shift_op>(L, R);
1316}
1317
1318/// Matches logical shift operations.
1319template <typename LHS, typename RHS>
1320inline BinOpPred_match<LHS, RHS, is_logical_shift_op>
1321m_LogicalShift(const LHS &L, const RHS &R) {
1322 return BinOpPred_match<LHS, RHS, is_logical_shift_op>(L, R);
1323}
1324
1325/// Matches bitwise logic operations.
1326template <typename LHS, typename RHS>
1327inline BinOpPred_match<LHS, RHS, is_bitwiselogic_op>
1328m_BitwiseLogic(const LHS &L, const RHS &R) {
1329 return BinOpPred_match<LHS, RHS, is_bitwiselogic_op>(L, R);
1330}
1331
1332/// Matches integer division operations.
1333template <typename LHS, typename RHS>
1334inline BinOpPred_match<LHS, RHS, is_idiv_op> m_IDiv(const LHS &L,
1335 const RHS &R) {
1336 return BinOpPred_match<LHS, RHS, is_idiv_op>(L, R);
1337}
1338
1339/// Matches integer remainder operations.
1340template <typename LHS, typename RHS>
1341inline BinOpPred_match<LHS, RHS, is_irem_op> m_IRem(const LHS &L,
1342 const RHS &R) {
1343 return BinOpPred_match<LHS, RHS, is_irem_op>(L, R);
1344}
1345
1346//===----------------------------------------------------------------------===//
1347// Class that matches exact binary ops.
1348//
1349template <typename SubPattern_t> struct Exact_match {
1350 SubPattern_t SubPattern;
1351
1352 Exact_match(const SubPattern_t &SP) : SubPattern(SP) {}
1353
1354 template <typename OpTy> bool match(OpTy *V) {
1355 if (auto *PEO = dyn_cast<PossiblyExactOperator>(V))
1356 return PEO->isExact() && SubPattern.match(V);
1357 return false;
1358 }
1359};
1360
1361template <typename T> inline Exact_match<T> m_Exact(const T &SubPattern) {
1362 return SubPattern;
1363}
1364
1365//===----------------------------------------------------------------------===//
1366// Matchers for CmpInst classes
1367//
1368
1369template <typename LHS_t, typename RHS_t, typename Class, typename PredicateTy,
1370 bool Commutable = false>
1371struct CmpClass_match {
1372 PredicateTy &Predicate;
1373 LHS_t L;
1374 RHS_t R;
1375
1376 // The evaluation order is always stable, regardless of Commutability.
1377 // The LHS is always matched first.
1378 CmpClass_match(PredicateTy &Pred, const LHS_t &LHS, const RHS_t &RHS)
1379 : Predicate(Pred), L(LHS), R(RHS) {}
1380
1381 template <typename OpTy> bool match(OpTy *V) {
1382 if (auto *I = dyn_cast<Class>(V)) {
1383 if (L.match(I->getOperand(0)) && R.match(I->getOperand(1))) {
1384 Predicate = I->getPredicate();
1385 return true;
1386 } else if (Commutable && L.match(I->getOperand(1)) &&
1387 R.match(I->getOperand(0))) {
1388 Predicate = I->getSwappedPredicate();
1389 return true;
1390 }
1391 }
1392 return false;
1393 }
1394};
1395
1396template <typename LHS, typename RHS>
1397inline CmpClass_match<LHS, RHS, CmpInst, CmpInst::Predicate>
1398m_Cmp(CmpInst::Predicate &Pred, const LHS &L, const RHS &R) {
1399 return CmpClass_match<LHS, RHS, CmpInst, CmpInst::Predicate>(Pred, L, R);
1400}
1401
1402template <typename LHS, typename RHS>
1403inline CmpClass_match<LHS, RHS, ICmpInst, ICmpInst::Predicate>
1404m_ICmp(ICmpInst::Predicate &Pred, const LHS &L, const RHS &R) {
1405 return CmpClass_match<LHS, RHS, ICmpInst, ICmpInst::Predicate>(Pred, L, R);
1406}
1407
1408template <typename LHS, typename RHS>
1409inline CmpClass_match<LHS, RHS, FCmpInst, FCmpInst::Predicate>
1410m_FCmp(FCmpInst::Predicate &Pred, const LHS &L, const RHS &R) {
1411 return CmpClass_match<LHS, RHS, FCmpInst, FCmpInst::Predicate>(Pred, L, R);
1412}
1413
1414//===----------------------------------------------------------------------===//
1415// Matchers for instructions with a given opcode and number of operands.
1416//
1417
1418/// Matches instructions with Opcode and three operands.
1419template <typename T0, unsigned Opcode> struct OneOps_match {
1420 T0 Op1;
1421
1422 OneOps_match(const T0 &Op1) : Op1(Op1) {}
1423
1424 template <typename OpTy> bool match(OpTy *V) {
1425 if (V->getValueID() == Value::InstructionVal + Opcode) {
1426 auto *I = cast<Instruction>(V);
1427 return Op1.match(I->getOperand(0));
1428 }
1429 return false;
1430 }
1431};
1432
1433/// Matches instructions with Opcode and three operands.
1434template <typename T0, typename T1, unsigned Opcode> struct TwoOps_match {
1435 T0 Op1;
1436 T1 Op2;
1437
1438 TwoOps_match(const T0 &Op1, const T1 &Op2) : Op1(Op1), Op2(Op2) {}
1439
1440 template <typename OpTy> bool match(OpTy *V) {
1441 if (V->getValueID() == Value::InstructionVal + Opcode) {
1442 auto *I = cast<Instruction>(V);
1443 return Op1.match(I->getOperand(0)) && Op2.match(I->getOperand(1));
1444 }
1445 return false;
1446 }
1447};
1448
1449/// Matches instructions with Opcode and three operands.
1450template <typename T0, typename T1, typename T2, unsigned Opcode>
1451struct ThreeOps_match {
1452 T0 Op1;
1453 T1 Op2;
1454 T2 Op3;
1455
1456 ThreeOps_match(const T0 &Op1, const T1 &Op2, const T2 &Op3)
1457 : Op1(Op1), Op2(Op2), Op3(Op3) {}
1458
1459 template <typename OpTy> bool match(OpTy *V) {
1460 if (V->getValueID() == Value::InstructionVal + Opcode) {
1461 auto *I = cast<Instruction>(V);
1462 return Op1.match(I->getOperand(0)) && Op2.match(I->getOperand(1)) &&
1463 Op3.match(I->getOperand(2));
1464 }
1465 return false;
1466 }
1467};
1468
1469/// Matches SelectInst.
1470template <typename Cond, typename LHS, typename RHS>
1471inline ThreeOps_match<Cond, LHS, RHS, Instruction::Select>
1472m_Select(const Cond &C, const LHS &L, const RHS &R) {
1473 return ThreeOps_match<Cond, LHS, RHS, Instruction::Select>(C, L, R);
1474}
1475
1476/// This matches a select of two constants, e.g.:
1477/// m_SelectCst<-1, 0>(m_Value(V))
1478template <int64_t L, int64_t R, typename Cond>
1479inline ThreeOps_match<Cond, constantint_match<L>, constantint_match<R>,
1480 Instruction::Select>
1481m_SelectCst(const Cond &C) {
1482 return m_Select(C, m_ConstantInt<L>(), m_ConstantInt<R>());
1483}
1484
1485/// Matches FreezeInst.
1486template <typename OpTy>
1487inline OneOps_match<OpTy, Instruction::Freeze> m_Freeze(const OpTy &Op) {
1488 return OneOps_match<OpTy, Instruction::Freeze>(Op);
1489}
1490
1491/// Matches InsertElementInst.
1492template <typename Val_t, typename Elt_t, typename Idx_t>
1493inline ThreeOps_match<Val_t, Elt_t, Idx_t, Instruction::InsertElement>
1494m_InsertElt(const Val_t &Val, const Elt_t &Elt, const Idx_t &Idx) {
1495 return ThreeOps_match<Val_t, Elt_t, Idx_t, Instruction::InsertElement>(
1496 Val, Elt, Idx);
1497}
1498
1499/// Matches ExtractElementInst.
1500template <typename Val_t, typename Idx_t>
1501inline TwoOps_match<Val_t, Idx_t, Instruction::ExtractElement>
1502m_ExtractElt(const Val_t &Val, const Idx_t &Idx) {
1503 return TwoOps_match<Val_t, Idx_t, Instruction::ExtractElement>(Val, Idx);
1504}
1505
1506/// Matches shuffle.
1507template <typename T0, typename T1, typename T2> struct Shuffle_match {
1508 T0 Op1;
1509 T1 Op2;
1510 T2 Mask;
1511
1512 Shuffle_match(const T0 &Op1, const T1 &Op2, const T2 &Mask)
1513 : Op1(Op1), Op2(Op2), Mask(Mask) {}
1514
1515 template <typename OpTy> bool match(OpTy *V) {
1516 if (auto *I = dyn_cast<ShuffleVectorInst>(V)) {
1517 return Op1.match(I->getOperand(0)) && Op2.match(I->getOperand(1)) &&
1518 Mask.match(I->getShuffleMask());
1519 }
1520 return false;
1521 }
1522};
1523
1524struct m_Mask {
1525 ArrayRef<int> &MaskRef;
1526 m_Mask(ArrayRef<int> &MaskRef) : MaskRef(MaskRef) {}
1527 bool match(ArrayRef<int> Mask) {
1528 MaskRef = Mask;
1529 return true;
1530 }
1531};
1532
1533struct m_ZeroMask {
1534 bool match(ArrayRef<int> Mask) {
1535 return all_of(Mask, [](int Elem) { return Elem == 0 || Elem == -1; });
1536 }
1537};
1538
1539struct m_SpecificMask {
1540 ArrayRef<int> &MaskRef;
1541 m_SpecificMask(ArrayRef<int> &MaskRef) : MaskRef(MaskRef) {}
1542 bool match(ArrayRef<int> Mask) { return MaskRef == Mask; }
1543};
1544
1545struct m_SplatOrUndefMask {
1546 int &SplatIndex;
1547 m_SplatOrUndefMask(int &SplatIndex) : SplatIndex(SplatIndex) {}
1548 bool match(ArrayRef<int> Mask) {
1549 auto First = find_if(Mask, [](int Elem) { return Elem != -1; });
1550 if (First == Mask.end())
1551 return false;
1552 SplatIndex = *First;
1553 return all_of(Mask,
1554 [First](int Elem) { return Elem == *First || Elem == -1; });
1555 }
1556};
1557
1558/// Matches ShuffleVectorInst independently of mask value.
1559template <typename V1_t, typename V2_t>
1560inline TwoOps_match<V1_t, V2_t, Instruction::ShuffleVector>
1561m_Shuffle(const V1_t &v1, const V2_t &v2) {
1562 return TwoOps_match<V1_t, V2_t, Instruction::ShuffleVector>(v1, v2);
1563}
1564
1565template <typename V1_t, typename V2_t, typename Mask_t>
1566inline Shuffle_match<V1_t, V2_t, Mask_t>
1567m_Shuffle(const V1_t &v1, const V2_t &v2, const Mask_t &mask) {
1568 return Shuffle_match<V1_t, V2_t, Mask_t>(v1, v2, mask);
1569}
1570
1571/// Matches LoadInst.
1572template <typename OpTy>
1573inline OneOps_match<OpTy, Instruction::Load> m_Load(const OpTy &Op) {
1574 return OneOps_match<OpTy, Instruction::Load>(Op);
1575}
1576
1577/// Matches StoreInst.
1578template <typename ValueOpTy, typename PointerOpTy>
1579inline TwoOps_match<ValueOpTy, PointerOpTy, Instruction::Store>
1580m_Store(const ValueOpTy &ValueOp, const PointerOpTy &PointerOp) {
1581 return TwoOps_match<ValueOpTy, PointerOpTy, Instruction::Store>(ValueOp,
1582 PointerOp);
1583}
1584
1585//===----------------------------------------------------------------------===//
1586// Matchers for CastInst classes
1587//
1588
1589template <typename Op_t, unsigned Opcode> struct CastClass_match {
1590 Op_t Op;
1591
1592 CastClass_match(const Op_t &OpMatch) : Op(OpMatch) {}
1593
1594 template <typename OpTy> bool match(OpTy *V) {
1595 if (auto *O = dyn_cast<Operator>(V))
1596 return O->getOpcode() == Opcode && Op.match(O->getOperand(0));
1597 return false;
1598 }
1599};
1600
1601/// Matches BitCast.
1602template <typename OpTy>
1603inline CastClass_match<OpTy, Instruction::BitCast> m_BitCast(const OpTy &Op) {
1604 return CastClass_match<OpTy, Instruction::BitCast>(Op);
1605}
1606
1607/// Matches PtrToInt.
1608template <typename OpTy>
1609inline CastClass_match<OpTy, Instruction::PtrToInt> m_PtrToInt(const OpTy &Op) {
1610 return CastClass_match<OpTy, Instruction::PtrToInt>(Op);
1611}
1612
1613/// Matches IntToPtr.
1614template <typename OpTy>
1615inline CastClass_match<OpTy, Instruction::IntToPtr> m_IntToPtr(const OpTy &Op) {
1616 return CastClass_match<OpTy, Instruction::IntToPtr>(Op);
1617}
1618
1619/// Matches Trunc.
1620template <typename OpTy>
1621inline CastClass_match<OpTy, Instruction::Trunc> m_Trunc(const OpTy &Op) {
1622 return CastClass_match<OpTy, Instruction::Trunc>(Op);
1623}
1624
1625template <typename OpTy>
1626inline match_combine_or<CastClass_match<OpTy, Instruction::Trunc>, OpTy>
1627m_TruncOrSelf(const OpTy &Op) {
1628 return m_CombineOr(m_Trunc(Op), Op);
1629}
1630
1631/// Matches SExt.
1632template <typename OpTy>
1633inline CastClass_match<OpTy, Instruction::SExt> m_SExt(const OpTy &Op) {
1634 return CastClass_match<OpTy, Instruction::SExt>(Op);
1635}
1636
1637/// Matches ZExt.
1638template <typename OpTy>
1639inline CastClass_match<OpTy, Instruction::ZExt> m_ZExt(const OpTy &Op) {
1640 return CastClass_match<OpTy, Instruction::ZExt>(Op);
1641}
1642
1643template <typename OpTy>
1644inline match_combine_or<CastClass_match<OpTy, Instruction::ZExt>, OpTy>
1645m_ZExtOrSelf(const OpTy &Op) {
1646 return m_CombineOr(m_ZExt(Op), Op);
1647}
1648
1649template <typename OpTy>
1650inline match_combine_or<CastClass_match<OpTy, Instruction::SExt>, OpTy>
1651m_SExtOrSelf(const OpTy &Op) {
1652 return m_CombineOr(m_SExt(Op), Op);
1653}
1654
1655template <typename OpTy>
1656inline match_combine_or<CastClass_match<OpTy, Instruction::ZExt>,
1657 CastClass_match<OpTy, Instruction::SExt>>
1658m_ZExtOrSExt(const OpTy &Op) {
1659 return m_CombineOr(m_ZExt(Op), m_SExt(Op));
1660}
1661
1662template <typename OpTy>
1663inline match_combine_or<
1664 match_combine_or<CastClass_match<OpTy, Instruction::ZExt>,
1665 CastClass_match<OpTy, Instruction::SExt>>,
1666 OpTy>
1667m_ZExtOrSExtOrSelf(const OpTy &Op) {
1668 return m_CombineOr(m_ZExtOrSExt(Op), Op);
1669}
1670
1671template <typename OpTy>
1672inline CastClass_match<OpTy, Instruction::UIToFP> m_UIToFP(const OpTy &Op) {
1673 return CastClass_match<OpTy, Instruction::UIToFP>(Op);
1674}
1675
1676template <typename OpTy>
1677inline CastClass_match<OpTy, Instruction::SIToFP> m_SIToFP(const OpTy &Op) {
1678 return CastClass_match<OpTy, Instruction::SIToFP>(Op);
1679}
1680
1681template <typename OpTy>
1682inline CastClass_match<OpTy, Instruction::FPToUI> m_FPToUI(const OpTy &Op) {
1683 return CastClass_match<OpTy, Instruction::FPToUI>(Op);
1684}
1685
1686template <typename OpTy>
1687inline CastClass_match<OpTy, Instruction::FPToSI> m_FPToSI(const OpTy &Op) {
1688 return CastClass_match<OpTy, Instruction::FPToSI>(Op);
1689}
1690
1691template <typename OpTy>
1692inline CastClass_match<OpTy, Instruction::FPTrunc> m_FPTrunc(const OpTy &Op) {
1693 return CastClass_match<OpTy, Instruction::FPTrunc>(Op);
1694}
1695
1696template <typename OpTy>
1697inline CastClass_match<OpTy, Instruction::FPExt> m_FPExt(const OpTy &Op) {
1698 return CastClass_match<OpTy, Instruction::FPExt>(Op);
1699}
1700
1701//===----------------------------------------------------------------------===//
1702// Matchers for control flow.
1703//
1704
1705struct br_match {
1706 BasicBlock *&Succ;
1707
1708 br_match(BasicBlock *&Succ) : Succ(Succ) {}
1709
1710 template <typename OpTy> bool match(OpTy *V) {
1711 if (auto *BI = dyn_cast<BranchInst>(V))
1712 if (BI->isUnconditional()) {
1713 Succ = BI->getSuccessor(0);
1714 return true;
1715 }
1716 return false;
1717 }
1718};
1719
1720inline br_match m_UnconditionalBr(BasicBlock *&Succ) { return br_match(Succ); }
1721
1722template <typename Cond_t, typename TrueBlock_t, typename FalseBlock_t>
1723struct brc_match {
1724 Cond_t Cond;
1725 TrueBlock_t T;
1726 FalseBlock_t F;
1727
1728 brc_match(const Cond_t &C, const TrueBlock_t &t, const FalseBlock_t &f)
1729 : Cond(C), T(t), F(f) {}
1730
1731 template <typename OpTy> bool match(OpTy *V) {
1732 if (auto *BI = dyn_cast<BranchInst>(V))
1733 if (BI->isConditional() && Cond.match(BI->getCondition()))
1734 return T.match(BI->getSuccessor(0)) && F.match(BI->getSuccessor(1));
1735 return false;
1736 }
1737};
1738
1739template <typename Cond_t>
1740inline brc_match<Cond_t, bind_ty<BasicBlock>, bind_ty<BasicBlock>>
1741m_Br(const Cond_t &C, BasicBlock *&T, BasicBlock *&F) {
1742 return brc_match<Cond_t, bind_ty<BasicBlock>, bind_ty<BasicBlock>>(
1743 C, m_BasicBlock(T), m_BasicBlock(F));
1744}
1745
1746template <typename Cond_t, typename TrueBlock_t, typename FalseBlock_t>
1747inline brc_match<Cond_t, TrueBlock_t, FalseBlock_t>
1748m_Br(const Cond_t &C, const TrueBlock_t &T, const FalseBlock_t &F) {
1749 return brc_match<Cond_t, TrueBlock_t, FalseBlock_t>(C, T, F);
1750}
1751
1752//===----------------------------------------------------------------------===//
1753// Matchers for max/min idioms, eg: "select (sgt x, y), x, y" -> smax(x,y).
1754//
1755
1756template <typename CmpInst_t, typename LHS_t, typename RHS_t, typename Pred_t,
1757 bool Commutable = false>
1758struct MaxMin_match {
1759 using PredType = Pred_t;
1760 LHS_t L;
1761 RHS_t R;
1762
1763 // The evaluation order is always stable, regardless of Commutability.
1764 // The LHS is always matched first.
1765 MaxMin_match(const LHS_t &LHS, const RHS_t &RHS) : L(LHS), R(RHS) {}
1766
1767 template <typename OpTy> bool match(OpTy *V) {
1768 if (auto *II = dyn_cast<IntrinsicInst>(V)) {
1769 Intrinsic::ID IID = II->getIntrinsicID();
1770 if ((IID == Intrinsic::smax && Pred_t::match(ICmpInst::ICMP_SGT)) ||
1771 (IID == Intrinsic::smin && Pred_t::match(ICmpInst::ICMP_SLT)) ||
1772 (IID == Intrinsic::umax && Pred_t::match(ICmpInst::ICMP_UGT)) ||
1773 (IID == Intrinsic::umin && Pred_t::match(ICmpInst::ICMP_ULT))) {
1774 Value *LHS = II->getOperand(0), *RHS = II->getOperand(1);
1775 return (L.match(LHS) && R.match(RHS)) ||
1776 (Commutable && L.match(RHS) && R.match(LHS));
1777 }
1778 }
1779 // Look for "(x pred y) ? x : y" or "(x pred y) ? y : x".
1780 auto *SI = dyn_cast<SelectInst>(V);
1781 if (!SI)
1782 return false;
1783 auto *Cmp = dyn_cast<CmpInst_t>(SI->getCondition());
1784 if (!Cmp)
1785 return false;
1786 // At this point we have a select conditioned on a comparison. Check that
1787 // it is the values returned by the select that are being compared.
1788 auto *TrueVal = SI->getTrueValue();
1789 auto *FalseVal = SI->getFalseValue();
1790 auto *LHS = Cmp->getOperand(0);
1791 auto *RHS = Cmp->getOperand(1);
1792 if ((TrueVal != LHS || FalseVal != RHS) &&
1793 (TrueVal != RHS || FalseVal != LHS))
1794 return false;
1795 typename CmpInst_t::Predicate Pred =
1796 LHS == TrueVal ? Cmp->getPredicate() : Cmp->getInversePredicate();
1797 // Does "(x pred y) ? x : y" represent the desired max/min operation?
1798 if (!Pred_t::match(Pred))
1799 return false;
1800 // It does! Bind the operands.
1801 return (L.match(LHS) && R.match(RHS)) ||
1802 (Commutable && L.match(RHS) && R.match(LHS));
1803 }
1804};
1805
1806/// Helper class for identifying signed max predicates.
1807struct smax_pred_ty {
1808 static bool match(ICmpInst::Predicate Pred) {
1809 return Pred == CmpInst::ICMP_SGT || Pred == CmpInst::ICMP_SGE;
1810 }
1811};
1812
1813/// Helper class for identifying signed min predicates.
1814struct smin_pred_ty {
1815 static bool match(ICmpInst::Predicate Pred) {
1816 return Pred == CmpInst::ICMP_SLT || Pred == CmpInst::ICMP_SLE;
1817 }
1818};
1819
1820/// Helper class for identifying unsigned max predicates.
1821struct umax_pred_ty {
1822 static bool match(ICmpInst::Predicate Pred) {
1823 return Pred == CmpInst::ICMP_UGT || Pred == CmpInst::ICMP_UGE;
1824 }
1825};
1826
1827/// Helper class for identifying unsigned min predicates.
1828struct umin_pred_ty {
1829 static bool match(ICmpInst::Predicate Pred) {
1830 return Pred == CmpInst::ICMP_ULT || Pred == CmpInst::ICMP_ULE;
1831 }
1832};
1833
1834/// Helper class for identifying ordered max predicates.
1835struct ofmax_pred_ty {
1836 static bool match(FCmpInst::Predicate Pred) {
1837 return Pred == CmpInst::FCMP_OGT || Pred == CmpInst::FCMP_OGE;
1838 }
1839};
1840
1841/// Helper class for identifying ordered min predicates.
1842struct ofmin_pred_ty {
1843 static bool match(FCmpInst::Predicate Pred) {
1844 return Pred == CmpInst::FCMP_OLT || Pred == CmpInst::FCMP_OLE;
1845 }
1846};
1847
1848/// Helper class for identifying unordered max predicates.
1849struct ufmax_pred_ty {
1850 static bool match(FCmpInst::Predicate Pred) {
1851 return Pred == CmpInst::FCMP_UGT || Pred == CmpInst::FCMP_UGE;
1852 }
1853};
1854
1855/// Helper class for identifying unordered min predicates.
1856struct ufmin_pred_ty {
1857 static bool match(FCmpInst::Predicate Pred) {
1858 return Pred == CmpInst::FCMP_ULT || Pred == CmpInst::FCMP_ULE;
1859 }
1860};
1861
1862template <typename LHS, typename RHS>
1863inline MaxMin_match<ICmpInst, LHS, RHS, smax_pred_ty> m_SMax(const LHS &L,
1864 const RHS &R) {
1865 return MaxMin_match<ICmpInst, LHS, RHS, smax_pred_ty>(L, R);
1866}
1867
1868template <typename LHS, typename RHS>
1869inline MaxMin_match<ICmpInst, LHS, RHS, smin_pred_ty> m_SMin(const LHS &L,
1870 const RHS &R) {
1871 return MaxMin_match<ICmpInst, LHS, RHS, smin_pred_ty>(L, R);
1872}
1873
1874template <typename LHS, typename RHS>
1875inline MaxMin_match<ICmpInst, LHS, RHS, umax_pred_ty> m_UMax(const LHS &L,
1876 const RHS &R) {
1877 return MaxMin_match<ICmpInst, LHS, RHS, umax_pred_ty>(L, R);
1878}
1879
1880template <typename LHS, typename RHS>
1881inline MaxMin_match<ICmpInst, LHS, RHS, umin_pred_ty> m_UMin(const LHS &L,
1882 const RHS &R) {
1883 return MaxMin_match<ICmpInst, LHS, RHS, umin_pred_ty>(L, R);
1884}
1885
1886template <typename LHS, typename RHS>
1887inline match_combine_or<
1888 match_combine_or<MaxMin_match<ICmpInst, LHS, RHS, smax_pred_ty>,
1889 MaxMin_match<ICmpInst, LHS, RHS, smin_pred_ty>>,
1890 match_combine_or<MaxMin_match<ICmpInst, LHS, RHS, umax_pred_ty>,
1891 MaxMin_match<ICmpInst, LHS, RHS, umin_pred_ty>>>
1892m_MaxOrMin(const LHS &L, const RHS &R) {
1893 return m_CombineOr(m_CombineOr(m_SMax(L, R), m_SMin(L, R)),
1894 m_CombineOr(m_UMax(L, R), m_UMin(L, R)));
1895}
1896
1897/// Match an 'ordered' floating point maximum function.
1898/// Floating point has one special value 'NaN'. Therefore, there is no total
1899/// order. However, if we can ignore the 'NaN' value (for example, because of a
1900/// 'no-nans-float-math' flag) a combination of a fcmp and select has 'maximum'
1901/// semantics. In the presence of 'NaN' we have to preserve the original
1902/// select(fcmp(ogt/ge, L, R), L, R) semantics matched by this predicate.
1903///
1904/// max(L, R) iff L and R are not NaN
1905/// m_OrdFMax(L, R) = R iff L or R are NaN
1906template <typename LHS, typename RHS>
1907inline MaxMin_match<FCmpInst, LHS, RHS, ofmax_pred_ty> m_OrdFMax(const LHS &L,
1908 const RHS &R) {
1909 return MaxMin_match<FCmpInst, LHS, RHS, ofmax_pred_ty>(L, R);
1910}
1911
1912/// Match an 'ordered' floating point minimum function.
1913/// Floating point has one special value 'NaN'. Therefore, there is no total
1914/// order. However, if we can ignore the 'NaN' value (for example, because of a
1915/// 'no-nans-float-math' flag) a combination of a fcmp and select has 'minimum'
1916/// semantics. In the presence of 'NaN' we have to preserve the original
1917/// select(fcmp(olt/le, L, R), L, R) semantics matched by this predicate.
1918///
1919/// min(L, R) iff L and R are not NaN
1920/// m_OrdFMin(L, R) = R iff L or R are NaN
1921template <typename LHS, typename RHS>
1922inline MaxMin_match<FCmpInst, LHS, RHS, ofmin_pred_ty> m_OrdFMin(const LHS &L,
1923 const RHS &R) {
1924 return MaxMin_match<FCmpInst, LHS, RHS, ofmin_pred_ty>(L, R);
1925}
1926
1927/// Match an 'unordered' floating point maximum function.
1928/// Floating point has one special value 'NaN'. Therefore, there is no total
1929/// order. However, if we can ignore the 'NaN' value (for example, because of a
1930/// 'no-nans-float-math' flag) a combination of a fcmp and select has 'maximum'
1931/// semantics. In the presence of 'NaN' we have to preserve the original
1932/// select(fcmp(ugt/ge, L, R), L, R) semantics matched by this predicate.
1933///
1934/// max(L, R) iff L and R are not NaN
1935/// m_UnordFMax(L, R) = L iff L or R are NaN
1936template <typename LHS, typename RHS>
1937inline MaxMin_match<FCmpInst, LHS, RHS, ufmax_pred_ty>
1938m_UnordFMax(const LHS &L, const RHS &R) {
1939 return MaxMin_match<FCmpInst, LHS, RHS, ufmax_pred_ty>(L, R);
1940}
1941
1942/// Match an 'unordered' floating point minimum function.
1943/// Floating point has one special value 'NaN'. Therefore, there is no total
1944/// order. However, if we can ignore the 'NaN' value (for example, because of a
1945/// 'no-nans-float-math' flag) a combination of a fcmp and select has 'minimum'
1946/// semantics. In the presence of 'NaN' we have to preserve the original
1947/// select(fcmp(ult/le, L, R), L, R) semantics matched by this predicate.
1948///
1949/// min(L, R) iff L and R are not NaN
1950/// m_UnordFMin(L, R) = L iff L or R are NaN
1951template <typename LHS, typename RHS>
1952inline MaxMin_match<FCmpInst, LHS, RHS, ufmin_pred_ty>
1953m_UnordFMin(const LHS &L, const RHS &R) {
1954 return MaxMin_match<FCmpInst, LHS, RHS, ufmin_pred_ty>(L, R);
1955}
1956
1957//===----------------------------------------------------------------------===//
1958// Matchers for overflow check patterns: e.g. (a + b) u< a, (a ^ -1) <u b
1959// Note that S might be matched to other instructions than AddInst.
1960//
1961
1962template <typename LHS_t, typename RHS_t, typename Sum_t>
1963struct UAddWithOverflow_match {
1964 LHS_t L;
1965 RHS_t R;
1966 Sum_t S;
1967
1968 UAddWithOverflow_match(const LHS_t &L, const RHS_t &R, const Sum_t &S)
1969 : L(L), R(R), S(S) {}
1970
1971 template <typename OpTy> bool match(OpTy *V) {
1972 Value *ICmpLHS, *ICmpRHS;
1973 ICmpInst::Predicate Pred;
1974 if (!m_ICmp(Pred, m_Value(ICmpLHS), m_Value(ICmpRHS)).match(V))
1975 return false;
1976
1977 Value *AddLHS, *AddRHS;
1978 auto AddExpr = m_Add(m_Value(AddLHS), m_Value(AddRHS));
1979
1980 // (a + b) u< a, (a + b) u< b
1981 if (Pred == ICmpInst::ICMP_ULT)
1982 if (AddExpr.match(ICmpLHS) && (ICmpRHS == AddLHS || ICmpRHS == AddRHS))
1983 return L.match(AddLHS) && R.match(AddRHS) && S.match(ICmpLHS);
1984
1985 // a >u (a + b), b >u (a + b)
1986 if (Pred == ICmpInst::ICMP_UGT)
1987 if (AddExpr.match(ICmpRHS) && (ICmpLHS == AddLHS || ICmpLHS == AddRHS))
1988 return L.match(AddLHS) && R.match(AddRHS) && S.match(ICmpRHS);
1989
1990 Value *Op1;
1991 auto XorExpr = m_OneUse(m_Xor(m_Value(Op1), m_AllOnes()));
1992 // (a ^ -1) <u b
1993 if (Pred == ICmpInst::ICMP_ULT) {
1994 if (XorExpr.match(ICmpLHS))
1995 return L.match(Op1) && R.match(ICmpRHS) && S.match(ICmpLHS);
1996 }
1997 // b > u (a ^ -1)
1998 if (Pred == ICmpInst::ICMP_UGT) {
1999 if (XorExpr.match(ICmpRHS))
2000 return L.match(Op1) && R.match(ICmpLHS) && S.match(ICmpRHS);
2001 }
2002
2003 // Match special-case for increment-by-1.
2004 if (Pred == ICmpInst::ICMP_EQ) {
2005 // (a + 1) == 0
2006 // (1 + a) == 0
2007 if (AddExpr.match(ICmpLHS) && m_ZeroInt().match(ICmpRHS) &&
2008 (m_One().match(AddLHS) || m_One().match(AddRHS)))
2009 return L.match(AddLHS) && R.match(AddRHS) && S.match(ICmpLHS);
2010 // 0 == (a + 1)
2011 // 0 == (1 + a)
2012 if (m_ZeroInt().match(ICmpLHS) && AddExpr.match(ICmpRHS) &&
2013 (m_One().match(AddLHS) || m_One().match(AddRHS)))
2014 return L.match(AddLHS) && R.match(AddRHS) && S.match(ICmpRHS);
2015 }
2016
2017 return false;
2018 }
2019};
2020
2021/// Match an icmp instruction checking for unsigned overflow on addition.
2022///
2023/// S is matched to the addition whose result is being checked for overflow, and
2024/// L and R are matched to the LHS and RHS of S.
2025template <typename LHS_t, typename RHS_t, typename Sum_t>
2026UAddWithOverflow_match<LHS_t, RHS_t, Sum_t>
2027m_UAddWithOverflow(const LHS_t &L, const RHS_t &R, const Sum_t &S) {
2028 return UAddWithOverflow_match<LHS_t, RHS_t, Sum_t>(L, R, S);
2029}
2030
2031template <typename Opnd_t> struct Argument_match {
2032 unsigned OpI;
2033 Opnd_t Val;
2034
2035 Argument_match(unsigned OpIdx, const Opnd_t &V) : OpI(OpIdx), Val(V) {}
2036
2037 template <typename OpTy> bool match(OpTy *V) {
2038 // FIXME: Should likely be switched to use `CallBase`.
2039 if (const auto *CI = dyn_cast<CallInst>(V))
2040 return Val.match(CI->getArgOperand(OpI));
2041 return false;
2042 }
2043};
2044
2045/// Match an argument.
2046template <unsigned OpI, typename Opnd_t>
2047inline Argument_match<Opnd_t> m_Argument(const Opnd_t &Op) {
2048 return Argument_match<Opnd_t>(OpI, Op);
2049}
2050
2051/// Intrinsic matchers.
2052struct IntrinsicID_match {
2053 unsigned ID;
2054
2055 IntrinsicID_match(Intrinsic::ID IntrID) : ID(IntrID) {}
2056
2057 template <typename OpTy> bool match(OpTy *V) {
2058 if (const auto *CI = dyn_cast<CallInst>(V))
2059 if (const auto *F = CI->getCalledFunction())
2060 return F->getIntrinsicID() == ID;
2061 return false;
2062 }
2063};
2064
2065/// Intrinsic matches are combinations of ID matchers, and argument
2066/// matchers. Higher arity matcher are defined recursively in terms of and-ing
2067/// them with lower arity matchers. Here's some convenient typedefs for up to
2068/// several arguments, and more can be added as needed
2069template <typename T0 = void, typename T1 = void, typename T2 = void,
2070 typename T3 = void, typename T4 = void, typename T5 = void,
2071 typename T6 = void, typename T7 = void, typename T8 = void,
2072 typename T9 = void, typename T10 = void>
2073struct m_Intrinsic_Ty;
2074template <typename T0> struct m_Intrinsic_Ty<T0> {
2075 using Ty = match_combine_and<IntrinsicID_match, Argument_match<T0>>;
2076};
2077template <typename T0, typename T1> struct m_Intrinsic_Ty<T0, T1> {
2078 using Ty =
2079 match_combine_and<typename m_Intrinsic_Ty<T0>::Ty, Argument_match<T1>>;
2080};
2081template <typename T0, typename T1, typename T2>
2082struct m_Intrinsic_Ty<T0, T1, T2> {
2083 using Ty =
2084 match_combine_and<typename m_Intrinsic_Ty<T0, T1>::Ty,
2085 Argument_match<T2>>;
2086};
2087template <typename T0, typename T1, typename T2, typename T3>
2088struct m_Intrinsic_Ty<T0, T1, T2, T3> {
2089 using Ty =
2090 match_combine_and<typename m_Intrinsic_Ty<T0, T1, T2>::Ty,
2091 Argument_match<T3>>;
2092};
2093
2094template <typename T0, typename T1, typename T2, typename T3, typename T4>
2095struct m_Intrinsic_Ty<T0, T1, T2, T3, T4> {
2096 using Ty = match_combine_and<typename m_Intrinsic_Ty<T0, T1, T2, T3>::Ty,
2097 Argument_match<T4>>;
2098};
2099
2100template <typename T0, typename T1, typename T2, typename T3, typename T4, typename T5>
2101struct m_Intrinsic_Ty<T0, T1, T2, T3, T4, T5> {
2102 using Ty = match_combine_and<typename m_Intrinsic_Ty<T0, T1, T2, T3, T4>::Ty,
2103 Argument_match<T5>>;
2104};
2105
2106/// Match intrinsic calls like this:
2107/// m_Intrinsic<Intrinsic::fabs>(m_Value(X))
2108template <Intrinsic::ID IntrID> inline IntrinsicID_match m_Intrinsic() {
2109 return IntrinsicID_match(IntrID);
2110}
2111
2112/// Matches MaskedLoad Intrinsic.
2113template <typename Opnd0, typename Opnd1, typename Opnd2, typename Opnd3>
2114inline typename m_Intrinsic_Ty<Opnd0, Opnd1, Opnd2, Opnd3>::Ty
2115m_MaskedLoad(const Opnd0 &Op0, const Opnd1 &Op1, const Opnd2 &Op2,
2116 const Opnd3 &Op3) {
2117 return m_Intrinsic<Intrinsic::masked_load>(Op0, Op1, Op2, Op3);
2118}
2119
2120template <Intrinsic::ID IntrID, typename T0>
2121inline typename m_Intrinsic_Ty<T0>::Ty m_Intrinsic(const T0 &Op0) {
2122 return m_CombineAnd(m_Intrinsic<IntrID>(), m_Argument<0>(Op0));
2123}
2124
2125template <Intrinsic::ID IntrID, typename T0, typename T1>
2126inline typename m_Intrinsic_Ty<T0, T1>::Ty m_Intrinsic(const T0 &Op0,
2127 const T1 &Op1) {
2128 return m_CombineAnd(m_Intrinsic<IntrID>(Op0), m_Argument<1>(Op1));
2129}
2130
2131template <Intrinsic::ID IntrID, typename T0, typename T1, typename T2>
2132inline typename m_Intrinsic_Ty<T0, T1, T2>::Ty
2133m_Intrinsic(const T0 &Op0, const T1 &Op1, const T2 &Op2) {
2134 return m_CombineAnd(m_Intrinsic<IntrID>(Op0, Op1), m_Argument<2>(Op2));
2135}
2136
2137template <Intrinsic::ID IntrID, typename T0, typename T1, typename T2,
2138 typename T3>
2139inline typename m_Intrinsic_Ty<T0, T1, T2, T3>::Ty
2140m_Intrinsic(const T0 &Op0, const T1 &Op1, const T2 &Op2, const T3 &Op3) {
2141 return m_CombineAnd(m_Intrinsic<IntrID>(Op0, Op1, Op2), m_Argument<3>(Op3));
2142}
2143
2144template <Intrinsic::ID IntrID, typename T0, typename T1, typename T2,
2145 typename T3, typename T4>
2146inline typename m_Intrinsic_Ty<T0, T1, T2, T3, T4>::Ty
2147m_Intrinsic(const T0 &Op0, const T1 &Op1, const T2 &Op2, const T3 &Op3,
2148 const T4 &Op4) {
2149 return m_CombineAnd(m_Intrinsic<IntrID>(Op0, Op1, Op2, Op3),
2150 m_Argument<4>(Op4));
2151}
2152
2153template <Intrinsic::ID IntrID, typename T0, typename T1, typename T2,
2154 typename T3, typename T4, typename T5>
2155inline typename m_Intrinsic_Ty<T0, T1, T2, T3, T4, T5>::Ty
2156m_Intrinsic(const T0 &Op0, const T1 &Op1, const T2 &Op2, const T3 &Op3,
2157 const T4 &Op4, const T5 &Op5) {
2158 return m_CombineAnd(m_Intrinsic<IntrID>(Op0, Op1, Op2, Op3, Op4),
2159 m_Argument<5>(Op5));
2160}
2161
2162// Helper intrinsic matching specializations.
2163template <typename Opnd0>
2164inline typename m_Intrinsic_Ty<Opnd0>::Ty m_BitReverse(const Opnd0 &Op0) {
2165 return m_Intrinsic<Intrinsic::bitreverse>(Op0);
2166}
2167
2168template <typename Opnd0>
2169inline typename m_Intrinsic_Ty<Opnd0>::Ty m_BSwap(const Opnd0 &Op0) {
2170 return m_Intrinsic<Intrinsic::bswap>(Op0);
2171}
2172
2173template <typename Opnd0>
2174inline typename m_Intrinsic_Ty<Opnd0>::Ty m_FAbs(const Opnd0 &Op0) {
2175 return m_Intrinsic<Intrinsic::fabs>(Op0);
2176}
2177
2178template <typename Opnd0>
2179inline typename m_Intrinsic_Ty<Opnd0>::Ty m_FCanonicalize(const Opnd0 &Op0) {
2180 return m_Intrinsic<Intrinsic::canonicalize>(Op0);
2181}
2182
2183template <typename Opnd0, typename Opnd1>
2184inline typename m_Intrinsic_Ty<Opnd0, Opnd1>::Ty m_FMin(const Opnd0 &Op0,
2185 const Opnd1 &Op1) {
2186 return m_Intrinsic<Intrinsic::minnum>(Op0, Op1);
2187}
2188
2189template <typename Opnd0, typename Opnd1>
2190inline typename m_Intrinsic_Ty<Opnd0, Opnd1>::Ty m_FMax(const Opnd0 &Op0,
2191 const Opnd1 &Op1) {
2192 return m_Intrinsic<Intrinsic::maxnum>(Op0, Op1);
2193}
2194
2195template <typename Opnd0, typename Opnd1, typename Opnd2>
2196inline typename m_Intrinsic_Ty<Opnd0, Opnd1, Opnd2>::Ty
2197m_FShl(const Opnd0 &Op0, const Opnd1 &Op1, const Opnd2 &Op2) {
2198 return m_Intrinsic<Intrinsic::fshl>(Op0, Op1, Op2);
2199}
2200
2201template <typename Opnd0, typename Opnd1, typename Opnd2>
2202inline typename m_Intrinsic_Ty<Opnd0, Opnd1, Opnd2>::Ty
2203m_FShr(const Opnd0 &Op0, const Opnd1 &Op1, const Opnd2 &Op2) {
2204 return m_Intrinsic<Intrinsic::fshr>(Op0, Op1, Op2);
2205}
2206
2207//===----------------------------------------------------------------------===//
2208// Matchers for two-operands operators with the operators in either order
2209//
2210
2211/// Matches a BinaryOperator with LHS and RHS in either order.
2212template <typename LHS, typename RHS>
2213inline AnyBinaryOp_match<LHS, RHS, true> m_c_BinOp(const LHS &L, const RHS &R) {
2214 return AnyBinaryOp_match<LHS, RHS, true>(L, R);
2215}
2216
2217/// Matches an ICmp with a predicate over LHS and RHS in either order.
2218/// Swaps the predicate if operands are commuted.
2219template <typename LHS, typename RHS>
2220inline CmpClass_match<LHS, RHS, ICmpInst, ICmpInst::Predicate, true>
2221m_c_ICmp(ICmpInst::Predicate &Pred, const LHS &L, const RHS &R) {
2222 return CmpClass_match<LHS, RHS, ICmpInst, ICmpInst::Predicate, true>(Pred, L,
2223 R);
2224}
2225
2226/// Matches a specific opcode with LHS and RHS in either order.
2227template <typename LHS, typename RHS>
2228inline SpecificBinaryOp_match<LHS, RHS, true>
2229m_c_BinOp(unsigned Opcode, const LHS &L, const RHS &R) {
2230 return SpecificBinaryOp_match<LHS, RHS, true>(Opcode, L, R);
2231}
2232
2233/// Matches a Add with LHS and RHS in either order.
2234template <typename LHS, typename RHS>
2235inline BinaryOp_match<LHS, RHS, Instruction::Add, true> m_c_Add(const LHS &L,
2236 const RHS &R) {
2237 return BinaryOp_match<LHS, RHS, Instruction::Add, true>(L, R);
2238}
2239
2240/// Matches a Mul with LHS and RHS in either order.
2241template <typename LHS, typename RHS>
2242inline BinaryOp_match<LHS, RHS, Instruction::Mul, true> m_c_Mul(const LHS &L,
2243 const RHS &R) {
2244 return BinaryOp_match<LHS, RHS, Instruction::Mul, true>(L, R);
2245}
2246
2247/// Matches an And with LHS and RHS in either order.
2248template <typename LHS, typename RHS>
2249inline BinaryOp_match<LHS, RHS, Instruction::And, true> m_c_And(const LHS &L,
2250 const RHS &R) {
2251 return BinaryOp_match<LHS, RHS, Instruction::And, true>(L, R);
2252}
2253
2254/// Matches an Or with LHS and RHS in either order.
2255template <typename LHS, typename RHS>
2256inline BinaryOp_match<LHS, RHS, Instruction::Or, true> m_c_Or(const LHS &L,
2257 const RHS &R) {
2258 return BinaryOp_match<LHS, RHS, Instruction::Or, true>(L, R);
2259}
2260
2261/// Matches an Xor with LHS and RHS in either order.
2262template <typename LHS, typename RHS>
2263inline BinaryOp_match<LHS, RHS, Instruction::Xor, true> m_c_Xor(const LHS &L,
2264 const RHS &R) {
2265 return BinaryOp_match<LHS, RHS, Instruction::Xor, true>(L, R);
2266}
2267
2268/// Matches a 'Neg' as 'sub 0, V'.
2269template <typename ValTy>
2270inline BinaryOp_match<cst_pred_ty<is_zero_int>, ValTy, Instruction::Sub>
2271m_Neg(const ValTy &V) {
2272 return m_Sub(m_ZeroInt(), V);
2273}
2274
2275/// Matches a 'Neg' as 'sub nsw 0, V'.
2276template <typename ValTy>
2277inline OverflowingBinaryOp_match<cst_pred_ty<is_zero_int>, ValTy,
2278 Instruction::Sub,
2279 OverflowingBinaryOperator::NoSignedWrap>
2280m_NSWNeg(const ValTy &V) {
2281 return m_NSWSub(m_ZeroInt(), V);
2282}
2283
2284/// Matches a 'Not' as 'xor V, -1' or 'xor -1, V'.
2285template <typename ValTy>
2286inline BinaryOp_match<ValTy, cst_pred_ty<is_all_ones>, Instruction::Xor, true>
2287m_Not(const ValTy &V) {
2288 return m_c_Xor(V, m_AllOnes());
2289}
2290
2291template <typename ValTy> struct NotForbidUndef_match {
2292 ValTy Val;
2293 NotForbidUndef_match(const ValTy &V) : Val(V) {}
2294
2295 template <typename OpTy> bool match(OpTy *V) {
2296 // We do not use m_c_Xor because that could match an arbitrary APInt that is
2297 // not -1 as C and then fail to match the other operand if it is -1.
2298 // This code should still work even when both operands are constants.
2299 Value *X;
2300 const APInt *C;
2301 if (m_Xor(m_Value(X), m_APIntForbidUndef(C)).match(V) && C->isAllOnes())
2302 return Val.match(X);
2303 if (m_Xor(m_APIntForbidUndef(C), m_Value(X)).match(V) && C->isAllOnes())
2304 return Val.match(X);
2305 return false;
2306 }
2307};
2308
2309/// Matches a bitwise 'not' as 'xor V, -1' or 'xor -1, V'. For vectors, the
2310/// constant value must be composed of only -1 scalar elements.
2311template <typename ValTy>
2312inline NotForbidUndef_match<ValTy> m_NotForbidUndef(const ValTy &V) {
2313 return NotForbidUndef_match<ValTy>(V);
2314}
2315
2316/// Matches an SMin with LHS and RHS in either order.
2317template <typename LHS, typename RHS>
2318inline MaxMin_match<ICmpInst, LHS, RHS, smin_pred_ty, true>
2319m_c_SMin(const LHS &L, const RHS &R) {
2320 return MaxMin_match<ICmpInst, LHS, RHS, smin_pred_ty, true>(L, R);
2321}
2322/// Matches an SMax with LHS and RHS in either order.
2323template <typename LHS, typename RHS>
2324inline MaxMin_match<ICmpInst, LHS, RHS, smax_pred_ty, true>
2325m_c_SMax(const LHS &L, const RHS &R) {
2326 return MaxMin_match<ICmpInst, LHS, RHS, smax_pred_ty, true>(L, R);
2327}
2328/// Matches a UMin with LHS and RHS in either order.
2329template <typename LHS, typename RHS>
2330inline MaxMin_match<ICmpInst, LHS, RHS, umin_pred_ty, true>
2331m_c_UMin(const LHS &L, const RHS &R) {
2332 return MaxMin_match<ICmpInst, LHS, RHS, umin_pred_ty, true>(L, R);
2333}
2334/// Matches a UMax with LHS and RHS in either order.
2335template <typename LHS, typename RHS>
2336inline MaxMin_match<ICmpInst, LHS, RHS, umax_pred_ty, true>
2337m_c_UMax(const LHS &L, const RHS &R) {
2338 return MaxMin_match<ICmpInst, LHS, RHS, umax_pred_ty, true>(L, R);
2339}
2340
2341template <typename LHS, typename RHS>
2342inline match_combine_or<
2343 match_combine_or<MaxMin_match<ICmpInst, LHS, RHS, smax_pred_ty, true>,
2344 MaxMin_match<ICmpInst, LHS, RHS, smin_pred_ty, true>>,
2345 match_combine_or<MaxMin_match<ICmpInst, LHS, RHS, umax_pred_ty, true>,
2346 MaxMin_match<ICmpInst, LHS, RHS, umin_pred_ty, true>>>
2347m_c_MaxOrMin(const LHS &L, const RHS &R) {
2348 return m_CombineOr(m_CombineOr(m_c_SMax(L, R), m_c_SMin(L, R)),
2349 m_CombineOr(m_c_UMax(L, R), m_c_UMin(L, R)));
2350}
2351
2352/// Matches FAdd with LHS and RHS in either order.
2353template <typename LHS, typename RHS>
2354inline BinaryOp_match<LHS, RHS, Instruction::FAdd, true>
2355m_c_FAdd(const LHS &L, const RHS &R) {
2356 return BinaryOp_match<LHS, RHS, Instruction::FAdd, true>(L, R);
2357}
2358
2359/// Matches FMul with LHS and RHS in either order.
2360template <typename LHS, typename RHS>
2361inline BinaryOp_match<LHS, RHS, Instruction::FMul, true>
2362m_c_FMul(const LHS &L, const RHS &R) {
2363 return BinaryOp_match<LHS, RHS, Instruction::FMul, true>(L, R);
2364}
2365
2366template <typename Opnd_t> struct Signum_match {
2367 Opnd_t Val;
2368 Signum_match(const Opnd_t &V) : Val(V) {}
2369
2370 template <typename OpTy> bool match(OpTy *V) {
2371 unsigned TypeSize = V->getType()->getScalarSizeInBits();
2372 if (TypeSize == 0)
2373 return false;
2374
2375 unsigned ShiftWidth = TypeSize - 1;
2376 Value *OpL = nullptr, *OpR = nullptr;
2377
2378 // This is the representation of signum we match:
2379 //
2380 // signum(x) == (x >> 63) | (-x >>u 63)
2381 //
2382 // An i1 value is its own signum, so it's correct to match
2383 //
2384 // signum(x) == (x >> 0) | (-x >>u 0)
2385 //
2386 // for i1 values.
2387
2388 auto LHS = m_AShr(m_Value(OpL), m_SpecificInt(ShiftWidth));
2389 auto RHS = m_LShr(m_Neg(m_Value(OpR)), m_SpecificInt(ShiftWidth));
2390 auto Signum = m_Or(LHS, RHS);
2391
2392 return Signum.match(V) && OpL == OpR && Val.match(OpL);
2393 }
2394};
2395
2396/// Matches a signum pattern.
2397///
2398/// signum(x) =
2399/// x > 0 -> 1
2400/// x == 0 -> 0
2401/// x < 0 -> -1
2402template <typename Val_t> inline Signum_match<Val_t> m_Signum(const Val_t &V) {
2403 return Signum_match<Val_t>(V);
2404}
2405
2406template <int Ind, typename Opnd_t> struct ExtractValue_match {
2407 Opnd_t Val;
2408 ExtractValue_match(const Opnd_t &V) : Val(V) {}
2409
2410 template <typename OpTy> bool match(OpTy *V) {
2411 if (auto *I = dyn_cast<ExtractValueInst>(V)) {
2412 // If Ind is -1, don't inspect indices
2413 if (Ind != -1 &&
2414 !(I->getNumIndices() == 1 && I->getIndices()[0] == (unsigned)Ind))
2415 return false;
2416 return Val.match(I->getAggregateOperand());
2417 }
2418 return false;
2419 }
2420};
2421
2422/// Match a single index ExtractValue instruction.
2423/// For example m_ExtractValue<1>(...)
2424template <int Ind, typename Val_t>
2425inline ExtractValue_match<Ind, Val_t> m_ExtractValue(const Val_t &V) {
2426 return ExtractValue_match<Ind, Val_t>(V);
2427}
2428
2429/// Match an ExtractValue instruction with any index.
2430/// For example m_ExtractValue(...)
2431template <typename Val_t>
2432inline ExtractValue_match<-1, Val_t> m_ExtractValue(const Val_t &V) {
2433 return ExtractValue_match<-1, Val_t>(V);
2434}
2435
2436/// Matcher for a single index InsertValue instruction.
2437template <int Ind, typename T0, typename T1> struct InsertValue_match {
2438 T0 Op0;
2439 T1 Op1;
2440
2441 InsertValue_match(const T0 &Op0, const T1 &Op1) : Op0(Op0), Op1(Op1) {}
2442
2443 template <typename OpTy> bool match(OpTy *V) {
2444 if (auto *I = dyn_cast<InsertValueInst>(V)) {
2445 return Op0.match(I->getOperand(0)) && Op1.match(I->getOperand(1)) &&
2446 I->getNumIndices() == 1 && Ind == I->getIndices()[0];
2447 }
2448 return false;
2449 }
2450};
2451
2452/// Matches a single index InsertValue instruction.
2453template <int Ind, typename Val_t, typename Elt_t>
2454inline InsertValue_match<Ind, Val_t, Elt_t> m_InsertValue(const Val_t &Val,
2455 const Elt_t &Elt) {
2456 return InsertValue_match<Ind, Val_t, Elt_t>(Val, Elt);
2457}
2458
2459/// Matches patterns for `vscale`. This can either be a call to `llvm.vscale` or
2460/// the constant expression
2461/// `ptrtoint(gep <vscale x 1 x i8>, <vscale x 1 x i8>* null, i32 1>`
2462/// under the right conditions determined by DataLayout.
2463struct VScaleVal_match {
2464 const DataLayout &DL;
2465 VScaleVal_match(const DataLayout &DL) : DL(DL) {}
2466
2467 template <typename ITy> bool match(ITy *V) {
2468 if (m_Intrinsic<Intrinsic::vscale>().match(V))
2469 return true;
2470
2471 Value *Ptr;
2472 if (m_PtrToInt(m_Value(Ptr)).match(V)) {
2473 if (auto *GEP = dyn_cast<GEPOperator>(Ptr)) {
2474 auto *DerefTy = GEP->getSourceElementType();
2475 if (GEP->getNumIndices() == 1 && isa<ScalableVectorType>(DerefTy) &&
2476 m_Zero().match(GEP->getPointerOperand()) &&
2477 m_SpecificInt(1).match(GEP->idx_begin()->get()) &&
2478 DL.getTypeAllocSizeInBits(DerefTy).getKnownMinSize() == 8)
2479 return true;
2480 }
2481 }
2482
2483 return false;
2484 }
2485};
2486
2487inline VScaleVal_match m_VScale(const DataLayout &DL) {
2488 return VScaleVal_match(DL);
2489}
2490
2491template <typename LHS, typename RHS, unsigned Opcode, bool Commutable = false>
2492struct LogicalOp_match {
2493 LHS L;
2494 RHS R;
2495
2496 LogicalOp_match(const LHS &L, const RHS &R) : L(L), R(R) {}
2497
2498 template <typename T> bool match(T *V) {
2499 auto *I = dyn_cast<Instruction>(V);
2500 if (!I || !I->getType()->isIntOrIntVectorTy(1))
2501 return false;
2502
2503 if (I->getOpcode() == Opcode) {
2504 auto *Op0 = I->getOperand(0);
2505 auto *Op1 = I->getOperand(1);
2506 return (L.match(Op0) && R.match(Op1)) ||
2507 (Commutable && L.match(Op1) && R.match(Op0));
2508 }
2509
2510 if (auto *Select = dyn_cast<SelectInst>(I)) {
2511 auto *Cond = Select->getCondition();
2512 auto *TVal = Select->getTrueValue();
2513 auto *FVal = Select->getFalseValue();
2514 if (Opcode == Instruction::And) {
2515 auto *C = dyn_cast<Constant>(FVal);
2516 if (C && C->isNullValue())
2517 return (L.match(Cond) && R.match(TVal)) ||
2518 (Commutable && L.match(TVal) && R.match(Cond));
2519 } else {
2520 assert(Opcode == Instruction::Or)(static_cast <bool> (Opcode == Instruction::Or) ? void (
0) : __assert_fail ("Opcode == Instruction::Or", "llvm/include/llvm/IR/PatternMatch.h"
, 2520, __extension__ __PRETTY_FUNCTION__))
;
2521 auto *C = dyn_cast<Constant>(TVal);
2522 if (C && C->isOneValue())
2523 return (L.match(Cond) && R.match(FVal)) ||
2524 (Commutable && L.match(FVal) && R.match(Cond));
2525 }
2526 }
2527
2528 return false;
2529 }
2530};
2531
2532/// Matches L && R either in the form of L & R or L ? R : false.
2533/// Note that the latter form is poison-blocking.
2534template <typename LHS, typename RHS>
2535inline LogicalOp_match<LHS, RHS, Instruction::And>
2536m_LogicalAnd(const LHS &L, const RHS &R) {
2537 return LogicalOp_match<LHS, RHS, Instruction::And>(L, R);
2538}
2539
2540/// Matches L && R where L and R are arbitrary values.
2541inline auto m_LogicalAnd() { return m_LogicalAnd(m_Value(), m_Value()); }
2542
2543/// Matches L && R with LHS and RHS in either order.
2544template <typename LHS, typename RHS>
2545inline LogicalOp_match<LHS, RHS, Instruction::And, true>
2546m_c_LogicalAnd(const LHS &L, const RHS &R) {
2547 return LogicalOp_match<LHS, RHS, Instruction::And, true>(L, R);
2548}
2549
2550/// Matches L || R either in the form of L | R or L ? true : R.
2551/// Note that the latter form is poison-blocking.
2552template <typename LHS, typename RHS>
2553inline LogicalOp_match<LHS, RHS, Instruction::Or>
2554m_LogicalOr(const LHS &L, const RHS &R) {
2555 return LogicalOp_match<LHS, RHS, Instruction::Or>(L, R);
2556}
2557
2558/// Matches L || R where L and R are arbitrary values.
2559inline auto m_LogicalOr() { return m_LogicalOr(m_Value(), m_Value()); }
2560
2561/// Matches L || R with LHS and RHS in either order.
2562template <typename LHS, typename RHS>
2563inline LogicalOp_match<LHS, RHS, Instruction::Or, true>
2564m_c_LogicalOr(const LHS &L, const RHS &R) {
2565 return LogicalOp_match<LHS, RHS, Instruction::Or, true>(L, R);
2566}
2567
2568} // end namespace PatternMatch
2569} // end namespace llvm
2570
2571#endif // LLVM_IR_PATTERNMATCH_H

/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/llvm/include/llvm/IR/Value.h

1//===- llvm/Value.h - Definition of the Value class -------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file declares the Value class.
10//
11//===----------------------------------------------------------------------===//
12
13#ifndef LLVM_IR_VALUE_H
14#define LLVM_IR_VALUE_H
15
16#include "llvm-c/Types.h"
17#include "llvm/ADT/STLExtras.h"
18#include "llvm/ADT/StringRef.h"
19#include "llvm/ADT/iterator_range.h"
20#include "llvm/IR/Use.h"
21#include "llvm/Support/Alignment.h"
22#include "llvm/Support/CBindingWrapping.h"
23#include "llvm/Support/Casting.h"
24#include <cassert>
25#include <iterator>
26#include <memory>
27
28namespace llvm {
29
30class APInt;
31class Argument;
32class BasicBlock;
33class Constant;
34class ConstantData;
35class ConstantAggregate;
36class DataLayout;
37class Function;
38class GlobalAlias;
39class GlobalIFunc;
40class GlobalObject;
41class GlobalValue;
42class GlobalVariable;
43class InlineAsm;
44class Instruction;
45class LLVMContext;
46class MDNode;
47class Module;
48class ModuleSlotTracker;
49class raw_ostream;
50template<typename ValueTy> class StringMapEntry;
51class Twine;
52class Type;
53class User;
54
55using ValueName = StringMapEntry<Value *>;
56
57//===----------------------------------------------------------------------===//
58// Value Class
59//===----------------------------------------------------------------------===//
60
61/// LLVM Value Representation
62///
63/// This is a very important LLVM class. It is the base class of all values
64/// computed by a program that may be used as operands to other values. Value is
65/// the super class of other important classes such as Instruction and Function.
66/// All Values have a Type. Type is not a subclass of Value. Some values can
67/// have a name and they belong to some Module. Setting the name on the Value
68/// automatically updates the module's symbol table.
69///
70/// Every value has a "use list" that keeps track of which other Values are
71/// using this Value. A Value can also have an arbitrary number of ValueHandle
72/// objects that watch it and listen to RAUW and Destroy events. See
73/// llvm/IR/ValueHandle.h for details.
74class Value {
75 Type *VTy;
76 Use *UseList;
77
78 friend class ValueAsMetadata; // Allow access to IsUsedByMD.
79 friend class ValueHandleBase;
80
81 const unsigned char SubclassID; // Subclass identifier (for isa/dyn_cast)
82 unsigned char HasValueHandle : 1; // Has a ValueHandle pointing to this?
83
84protected:
85 /// Hold subclass data that can be dropped.
86 ///
87 /// This member is similar to SubclassData, however it is for holding
88 /// information which may be used to aid optimization, but which may be
89 /// cleared to zero without affecting conservative interpretation.
90 unsigned char SubclassOptionalData : 7;
91
92private:
93 /// Hold arbitrary subclass data.
94 ///
95 /// This member is defined by this class, but is not used for anything.
96 /// Subclasses can use it to hold whatever state they find useful. This
97 /// field is initialized to zero by the ctor.
98 unsigned short SubclassData;
99
100protected:
101 /// The number of operands in the subclass.
102 ///
103 /// This member is defined by this class, but not used for anything.
104 /// Subclasses can use it to store their number of operands, if they have
105 /// any.
106 ///
107 /// This is stored here to save space in User on 64-bit hosts. Since most
108 /// instances of Value have operands, 32-bit hosts aren't significantly
109 /// affected.
110 ///
111 /// Note, this should *NOT* be used directly by any class other than User.
112 /// User uses this value to find the Use list.
113 enum : unsigned { NumUserOperandsBits = 27 };
114 unsigned NumUserOperands : NumUserOperandsBits;
115
116 // Use the same type as the bitfield above so that MSVC will pack them.
117 unsigned IsUsedByMD : 1;
118 unsigned HasName : 1;
119 unsigned HasMetadata : 1; // Has metadata attached to this?
120 unsigned HasHungOffUses : 1;
121 unsigned HasDescriptor : 1;
122
123private:
124 template <typename UseT> // UseT == 'Use' or 'const Use'
125 class use_iterator_impl {
126 friend class Value;
127
128 UseT *U;
129
130 explicit use_iterator_impl(UseT *u) : U(u) {}
131
132 public:
133 using iterator_category = std::forward_iterator_tag;
134 using value_type = UseT *;
135 using difference_type = std::ptrdiff_t;
136 using pointer = value_type *;
137 using reference = value_type &;
138
139 use_iterator_impl() : U() {}
140
141 bool operator==(const use_iterator_impl &x) const { return U == x.U; }
142 bool operator!=(const use_iterator_impl &x) const { return !operator==(x); }
143
144 use_iterator_impl &operator++() { // Preincrement
145 assert(U && "Cannot increment end iterator!")(static_cast <bool> (U && "Cannot increment end iterator!"
) ? void (0) : __assert_fail ("U && \"Cannot increment end iterator!\""
, "llvm/include/llvm/IR/Value.h", 145, __extension__ __PRETTY_FUNCTION__
))
;
146 U = U->getNext();
147 return *this;
148 }
149
150 use_iterator_impl operator++(int) { // Postincrement
151 auto tmp = *this;
152 ++*this;
153 return tmp;
154 }
155
156 UseT &operator*() const {
157 assert(U && "Cannot dereference end iterator!")(static_cast <bool> (U && "Cannot dereference end iterator!"
) ? void (0) : __assert_fail ("U && \"Cannot dereference end iterator!\""
, "llvm/include/llvm/IR/Value.h", 157, __extension__ __PRETTY_FUNCTION__
))
;
158 return *U;
159 }
160
161 UseT *operator->() const { return &operator*(); }
162
163 operator use_iterator_impl<const UseT>() const {
164 return use_iterator_impl<const UseT>(U);
165 }
166 };
167
168 template <typename UserTy> // UserTy == 'User' or 'const User'
169 class user_iterator_impl {
170 use_iterator_impl<Use> UI;
171 explicit user_iterator_impl(Use *U) : UI(U) {}
172 friend class Value;
173
174 public:
175 using iterator_category = std::forward_iterator_tag;
176 using value_type = UserTy *;
177 using difference_type = std::ptrdiff_t;
178 using pointer = value_type *;
179 using reference = value_type &;
180
181 user_iterator_impl() = default;
182
183 bool operator==(const user_iterator_impl &x) const { return UI == x.UI; }
184 bool operator!=(const user_iterator_impl &x) const { return !operator==(x); }
185
186 /// Returns true if this iterator is equal to user_end() on the value.
187 bool atEnd() const { return *this == user_iterator_impl(); }
188
189 user_iterator_impl &operator++() { // Preincrement
190 ++UI;
191 return *this;
192 }
193
194 user_iterator_impl operator++(int) { // Postincrement
195 auto tmp = *this;
196 ++*this;
197 return tmp;
198 }
199
200 // Retrieve a pointer to the current User.
201 UserTy *operator*() const {
202 return UI->getUser();
203 }
204
205 UserTy *operator->() const { return operator*(); }
206
207 operator user_iterator_impl<const UserTy>() const {
208 return user_iterator_impl<const UserTy>(*UI);
209 }
210
211 Use &getUse() const { return *UI; }
212 };
213
214protected:
215 Value(Type *Ty, unsigned scid);
216
217 /// Value's destructor should be virtual by design, but that would require
218 /// that Value and all of its subclasses have a vtable that effectively
219 /// duplicates the information in the value ID. As a size optimization, the
220 /// destructor has been protected, and the caller should manually call
221 /// deleteValue.
222 ~Value(); // Use deleteValue() to delete a generic Value.
223
224public:
225 Value(const Value &) = delete;
226 Value &operator=(const Value &) = delete;
227
228 /// Delete a pointer to a generic Value.
229 void deleteValue();
230
231 /// Support for debugging, callable in GDB: V->dump()
232 void dump() const;
233
234 /// Implement operator<< on Value.
235 /// @{
236 void print(raw_ostream &O, bool IsForDebug = false) const;
237 void print(raw_ostream &O, ModuleSlotTracker &MST,
238 bool IsForDebug = false) const;
239 /// @}
240
241 /// Print the name of this Value out to the specified raw_ostream.
242 ///
243 /// This is useful when you just want to print 'int %reg126', not the
244 /// instruction that generated it. If you specify a Module for context, then
245 /// even constanst get pretty-printed; for example, the type of a null
246 /// pointer is printed symbolically.
247 /// @{
248 void printAsOperand(raw_ostream &O, bool PrintType = true,
249 const Module *M = nullptr) const;
250 void printAsOperand(raw_ostream &O, bool PrintType,
251 ModuleSlotTracker &MST) const;
252 /// @}
253
254 /// All values are typed, get the type of this value.
255 Type *getType() const { return VTy; }
256
257 /// All values hold a context through their type.
258 LLVMContext &getContext() const;
259
260 // All values can potentially be named.
261 bool hasName() const { return HasName; }
262 ValueName *getValueName() const;
263 void setValueName(ValueName *VN);
264
265private:
266 void destroyValueName();
267 enum class ReplaceMetadataUses { No, Yes };
268 void doRAUW(Value *New, ReplaceMetadataUses);
269 void setNameImpl(const Twine &Name);
270
271public:
272 /// Return a constant reference to the value's name.
273 ///
274 /// This guaranteed to return the same reference as long as the value is not
275 /// modified. If the value has a name, this does a hashtable lookup, so it's
276 /// not free.
277 StringRef getName() const;
278
279 /// Change the name of the value.
280 ///
281 /// Choose a new unique name if the provided name is taken.
282 ///
283 /// \param Name The new name; or "" if the value's name should be removed.
284 void setName(const Twine &Name);
285
286 /// Transfer the name from V to this value.
287 ///
288 /// After taking V's name, sets V's name to empty.
289 ///
290 /// \note It is an error to call V->takeName(V).
291 void takeName(Value *V);
292
293#ifndef NDEBUG
294 std::string getNameOrAsOperand() const;
295#endif
296
297 /// Change all uses of this to point to a new Value.
298 ///
299 /// Go through the uses list for this definition and make each use point to
300 /// "V" instead of "this". After this completes, 'this's use list is
301 /// guaranteed to be empty.
302 void replaceAllUsesWith(Value *V);
303
304 /// Change non-metadata uses of this to point to a new Value.
305 ///
306 /// Go through the uses list for this definition and make each use point to
307 /// "V" instead of "this". This function skips metadata entries in the list.
308 void replaceNonMetadataUsesWith(Value *V);
309
310 /// Go through the uses list for this definition and make each use point
311 /// to "V" if the callback ShouldReplace returns true for the given Use.
312 /// Unlike replaceAllUsesWith() this function does not support basic block
313 /// values.
314 void replaceUsesWithIf(Value *New,
315 llvm::function_ref<bool(Use &U)> ShouldReplace);
316
317 /// replaceUsesOutsideBlock - Go through the uses list for this definition and
318 /// make each use point to "V" instead of "this" when the use is outside the
319 /// block. 'This's use list is expected to have at least one element.
320 /// Unlike replaceAllUsesWith() this function does not support basic block
321 /// values.
322 void replaceUsesOutsideBlock(Value *V, BasicBlock *BB);
323
324 //----------------------------------------------------------------------
325 // Methods for handling the chain of uses of this Value.
326 //
327 // Materializing a function can introduce new uses, so these methods come in
328 // two variants:
329 // The methods that start with materialized_ check the uses that are
330 // currently known given which functions are materialized. Be very careful
331 // when using them since you might not get all uses.
332 // The methods that don't start with materialized_ assert that modules is
333 // fully materialized.
334 void assertModuleIsMaterializedImpl() const;
335 // This indirection exists so we can keep assertModuleIsMaterializedImpl()
336 // around in release builds of Value.cpp to be linked with other code built
337 // in debug mode. But this avoids calling it in any of the release built code.
338 void assertModuleIsMaterialized() const {
339#ifndef NDEBUG
340 assertModuleIsMaterializedImpl();
341#endif
342 }
343
344 bool use_empty() const {
345 assertModuleIsMaterialized();
346 return UseList == nullptr;
22
Assuming the condition is false
23
Returning zero, which participates in a condition later
347 }
348
349 bool materialized_use_empty() const {
350 return UseList == nullptr;
351 }
352
353 using use_iterator = use_iterator_impl<Use>;
354 using const_use_iterator = use_iterator_impl<const Use>;
355
356 use_iterator materialized_use_begin() { return use_iterator(UseList); }
357 const_use_iterator materialized_use_begin() const {
358 return const_use_iterator(UseList);
359 }
360 use_iterator use_begin() {
361 assertModuleIsMaterialized();
362 return materialized_use_begin();
363 }
364 const_use_iterator use_begin() const {
365 assertModuleIsMaterialized();
366 return materialized_use_begin();
367 }
368 use_iterator use_end() { return use_iterator(); }
369 const_use_iterator use_end() const { return const_use_iterator(); }
370 iterator_range<use_iterator> materialized_uses() {
371 return make_range(materialized_use_begin(), use_end());
372 }
373 iterator_range<const_use_iterator> materialized_uses() const {
374 return make_range(materialized_use_begin(), use_end());
375 }
376 iterator_range<use_iterator> uses() {
377 assertModuleIsMaterialized();
378 return materialized_uses();
379 }
380 iterator_range<const_use_iterator> uses() const {
381 assertModuleIsMaterialized();
382 return materialized_uses();
383 }
384
385 bool user_empty() const {
386 assertModuleIsMaterialized();
387 return UseList == nullptr;
388 }
389
390 using user_iterator = user_iterator_impl<User>;
391 using const_user_iterator = user_iterator_impl<const User>;
392
393 user_iterator materialized_user_begin() { return user_iterator(UseList); }
394 const_user_iterator materialized_user_begin() const {
395 return const_user_iterator(UseList);
396 }
397 user_iterator user_begin() {
398 assertModuleIsMaterialized();
399 return materialized_user_begin();
400 }
401 const_user_iterator user_begin() const {
402 assertModuleIsMaterialized();
403 return materialized_user_begin();
404 }
405 user_iterator user_end() { return user_iterator(); }
406 const_user_iterator user_end() const { return const_user_iterator(); }
407 User *user_back() {
408 assertModuleIsMaterialized();
409 return *materialized_user_begin();
410 }
411 const User *user_back() const {
412 assertModuleIsMaterialized();
413 return *materialized_user_begin();
414 }
415 iterator_range<user_iterator> materialized_users() {
416 return make_range(materialized_user_begin(), user_end());
417 }
418 iterator_range<const_user_iterator> materialized_users() const {
419 return make_range(materialized_user_begin(), user_end());
420 }
421 iterator_range<user_iterator> users() {
422 assertModuleIsMaterialized();
423 return materialized_users();
424 }
425 iterator_range<const_user_iterator> users() const {
426 assertModuleIsMaterialized();
427 return materialized_users();
428 }
429
430 /// Return true if there is exactly one use of this value.
431 ///
432 /// This is specialized because it is a common request and does not require
433 /// traversing the whole use list.
434 bool hasOneUse() const { return hasSingleElement(uses()); }
435
436 /// Return true if this Value has exactly N uses.
437 bool hasNUses(unsigned N) const;
438
439 /// Return true if this value has N uses or more.
440 ///
441 /// This is logically equivalent to getNumUses() >= N.
442 bool hasNUsesOrMore(unsigned N) const;
443
444 /// Return true if there is exactly one user of this value.
445 ///
446 /// Note that this is not the same as "has one use". If a value has one use,
447 /// then there certainly is a single user. But if value has several uses,
448 /// it is possible that all uses are in a single user, or not.
449 ///
450 /// This check is potentially costly, since it requires traversing,
451 /// in the worst case, the whole use list of a value.
452 bool hasOneUser() const;
453
454 /// Return true if there is exactly one use of this value that cannot be
455 /// dropped.
456 Use *getSingleUndroppableUse();
457 const Use *getSingleUndroppableUse() const {
458 return const_cast<Value *>(this)->getSingleUndroppableUse();
459 }
460
461 /// Return true if there is exactly one unique user of this value that cannot be
462 /// dropped (that user can have multiple uses of this value).
463 User *getUniqueUndroppableUser();
464 const User *getUniqueUndroppableUser() const {
465 return const_cast<Value *>(this)->getUniqueUndroppableUser();
466 }
467
468 /// Return true if there this value.
469 ///
470 /// This is specialized because it is a common request and does not require
471 /// traversing the whole use list.
472 bool hasNUndroppableUses(unsigned N) const;
473
474 /// Return true if this value has N uses or more.
475 ///
476 /// This is logically equivalent to getNumUses() >= N.
477 bool hasNUndroppableUsesOrMore(unsigned N) const;
478
479 /// Remove every uses that can safely be removed.
480 ///
481 /// This will remove for example uses in llvm.assume.
482 /// This should be used when performing want to perform a tranformation but
483 /// some Droppable uses pervent it.
484 /// This function optionally takes a filter to only remove some droppable
485 /// uses.
486 void dropDroppableUses(llvm::function_ref<bool(const Use *)> ShouldDrop =
487 [](const Use *) { return true; });
488
489 /// Remove every use of this value in \p User that can safely be removed.
490 void dropDroppableUsesIn(User &Usr);
491
492 /// Remove the droppable use \p U.
493 static void dropDroppableUse(Use &U);
494
495 /// Check if this value is used in the specified basic block.
496 bool isUsedInBasicBlock(const BasicBlock *BB) const;
497
498 /// This method computes the number of uses of this Value.
499 ///
500 /// This is a linear time operation. Use hasOneUse, hasNUses, or
501 /// hasNUsesOrMore to check for specific values.
502 unsigned getNumUses() const;
503
504 /// This method should only be used by the Use class.
505 void addUse(Use &U) { U.addToList(&UseList); }
506
507 /// Concrete subclass of this.
508 ///
509 /// An enumeration for keeping track of the concrete subclass of Value that
510 /// is actually instantiated. Values of this enumeration are kept in the
511 /// Value classes SubclassID field. They are used for concrete type
512 /// identification.
513 enum ValueTy {
514#define HANDLE_VALUE(Name) Name##Val,
515#include "llvm/IR/Value.def"
516
517 // Markers:
518#define HANDLE_CONSTANT_MARKER(Marker, Constant) Marker = Constant##Val,
519#include "llvm/IR/Value.def"
520 };
521
522 /// Return an ID for the concrete type of this object.
523 ///
524 /// This is used to implement the classof checks. This should not be used
525 /// for any other purpose, as the values may change as LLVM evolves. Also,
526 /// note that for instructions, the Instruction's opcode is added to
527 /// InstructionVal. So this means three things:
528 /// # there is no value with code InstructionVal (no opcode==0).
529 /// # there are more possible values for the value type than in ValueTy enum.
530 /// # the InstructionVal enumerator must be the highest valued enumerator in
531 /// the ValueTy enum.
532 unsigned getValueID() const {
533 return SubclassID;
534 }
535
536 /// Return the raw optional flags value contained in this value.
537 ///
538 /// This should only be used when testing two Values for equivalence.
539 unsigned getRawSubclassOptionalData() const {
540 return SubclassOptionalData;
541 }
542
543 /// Clear the optional flags contained in this value.
544 void clearSubclassOptionalData() {
545 SubclassOptionalData = 0;
546 }
547
548 /// Check the optional flags for equality.
549 bool hasSameSubclassOptionalData(const Value *V) const {
550 return SubclassOptionalData == V->SubclassOptionalData;
551 }
552
553 /// Return true if there is a value handle associated with this value.
554 bool hasValueHandle() const { return HasValueHandle; }
555
556 /// Return true if there is metadata referencing this value.
557 bool isUsedByMetadata() const { return IsUsedByMD; }
558
559 // Return true if this value is only transitively referenced by metadata.
560 bool isTransitiveUsedByMetadataOnly() const;
561
562protected:
563 /// Get the current metadata attachments for the given kind, if any.
564 ///
565 /// These functions require that the value have at most a single attachment
566 /// of the given kind, and return \c nullptr if such an attachment is missing.
567 /// @{
568 MDNode *getMetadata(unsigned KindID) const;
569 MDNode *getMetadata(StringRef Kind) const;
570 /// @}
571
572 /// Appends all attachments with the given ID to \c MDs in insertion order.
573 /// If the Value has no attachments with the given ID, or if ID is invalid,
574 /// leaves MDs unchanged.
575 /// @{
576 void getMetadata(unsigned KindID, SmallVectorImpl<MDNode *> &MDs) const;
577 void getMetadata(StringRef Kind, SmallVectorImpl<MDNode *> &MDs) const;
578 /// @}
579
580 /// Appends all metadata attached to this value to \c MDs, sorting by
581 /// KindID. The first element of each pair returned is the KindID, the second
582 /// element is the metadata value. Attachments with the same ID appear in
583 /// insertion order.
584 void
585 getAllMetadata(SmallVectorImpl<std::pair<unsigned, MDNode *>> &MDs) const;
586
587 /// Return true if this value has any metadata attached to it.
588 bool hasMetadata() const { return (bool)HasMetadata; }
589
590 /// Return true if this value has the given type of metadata attached.
591 /// @{
592 bool hasMetadata(unsigned KindID) const {
593 return getMetadata(KindID) != nullptr;
594 }
595 bool hasMetadata(StringRef Kind) const {
596 return getMetadata(Kind) != nullptr;
597 }
598 /// @}
599
600 /// Set a particular kind of metadata attachment.
601 ///
602 /// Sets the given attachment to \c MD, erasing it if \c MD is \c nullptr or
603 /// replacing it if it already exists.
604 /// @{
605 void setMetadata(unsigned KindID, MDNode *Node);
606 void setMetadata(StringRef Kind, MDNode *Node);
607 /// @}
608
609 /// Add a metadata attachment.
610 /// @{
611 void addMetadata(unsigned KindID, MDNode &MD);
612 void addMetadata(StringRef Kind, MDNode &MD);
613 /// @}
614
615 /// Erase all metadata attachments with the given kind.
616 ///
617 /// \returns true if any metadata was removed.
618 bool eraseMetadata(unsigned KindID);
619
620 /// Erase all metadata attached to this Value.
621 void clearMetadata();
622
623public:
624 /// Return true if this value is a swifterror value.
625 ///
626 /// swifterror values can be either a function argument or an alloca with a
627 /// swifterror attribute.
628 bool isSwiftError() const;
629
630 /// Strip off pointer casts, all-zero GEPs and address space casts.
631 ///
632 /// Returns the original uncasted value. If this is called on a non-pointer
633 /// value, it returns 'this'.
634 const Value *stripPointerCasts() const;
635 Value *stripPointerCasts() {
636 return const_cast<Value *>(
637 static_cast<const Value *>(this)->stripPointerCasts());
638 }
639
640 /// Strip off pointer casts, all-zero GEPs, address space casts, and aliases.
641 ///
642 /// Returns the original uncasted value. If this is called on a non-pointer
643 /// value, it returns 'this'.
644 const Value *stripPointerCastsAndAliases() const;
645 Value *stripPointerCastsAndAliases() {
646 return const_cast<Value *>(
647 static_cast<const Value *>(this)->stripPointerCastsAndAliases());
648 }
649
650 /// Strip off pointer casts, all-zero GEPs and address space casts
651 /// but ensures the representation of the result stays the same.
652 ///
653 /// Returns the original uncasted value with the same representation. If this
654 /// is called on a non-pointer value, it returns 'this'.
655 const Value *stripPointerCastsSameRepresentation() const;
656 Value *stripPointerCastsSameRepresentation() {
657 return const_cast<Value *>(static_cast<const Value *>(this)
658 ->stripPointerCastsSameRepresentation());
659 }
660
661 /// Strip off pointer casts, all-zero GEPs, single-argument phi nodes and
662 /// invariant group info.
663 ///
664 /// Returns the original uncasted value. If this is called on a non-pointer
665 /// value, it returns 'this'. This function should be used only in
666 /// Alias analysis.
667 const Value *stripPointerCastsForAliasAnalysis() const;
668 Value *stripPointerCastsForAliasAnalysis() {
669 return const_cast<Value *>(static_cast<const Value *>(this)
670 ->stripPointerCastsForAliasAnalysis());
671 }
672
673 /// Strip off pointer casts and all-constant inbounds GEPs.
674 ///
675 /// Returns the original pointer value. If this is called on a non-pointer
676 /// value, it returns 'this'.
677 const Value *stripInBoundsConstantOffsets() const;
678 Value *stripInBoundsConstantOffsets() {
679 return const_cast<Value *>(
680 static_cast<const Value *>(this)->stripInBoundsConstantOffsets());
681 }
682
683 /// Accumulate the constant offset this value has compared to a base pointer.
684 /// Only 'getelementptr' instructions (GEPs) are accumulated but other
685 /// instructions, e.g., casts, are stripped away as well.
686 /// The accumulated constant offset is added to \p Offset and the base
687 /// pointer is returned.
688 ///
689 /// The APInt \p Offset has to have a bit-width equal to the IntPtr type for
690 /// the address space of 'this' pointer value, e.g., use
691 /// DataLayout::getIndexTypeSizeInBits(Ty).
692 ///
693 /// If \p AllowNonInbounds is true, offsets in GEPs are stripped and
694 /// accumulated even if the GEP is not "inbounds".
695 ///
696 /// If \p AllowInvariantGroup is true then this method also looks through
697 /// strip.invariant.group and launder.invariant.group intrinsics.
698 ///
699 /// If \p ExternalAnalysis is provided it will be used to calculate a offset
700 /// when a operand of GEP is not constant.
701 /// For example, for a value \p ExternalAnalysis might try to calculate a
702 /// lower bound. If \p ExternalAnalysis is successful, it should return true.
703 ///
704 /// If this is called on a non-pointer value, it returns 'this' and the
705 /// \p Offset is not modified.
706 ///
707 /// Note that this function will never return a nullptr. It will also never
708 /// manipulate the \p Offset in a way that would not match the difference
709 /// between the underlying value and the returned one. Thus, if no constant
710 /// offset was found, the returned value is the underlying one and \p Offset
711 /// is unchanged.
712 const Value *stripAndAccumulateConstantOffsets(
713 const DataLayout &DL, APInt &Offset, bool AllowNonInbounds,
714 bool AllowInvariantGroup = false,
715 function_ref<bool(Value &Value, APInt &Offset)> ExternalAnalysis =
716 nullptr) const;
717 Value *stripAndAccumulateConstantOffsets(const DataLayout &DL, APInt &Offset,
718 bool AllowNonInbounds,
719 bool AllowInvariantGroup = false) {
720 return const_cast<Value *>(
721 static_cast<const Value *>(this)->stripAndAccumulateConstantOffsets(
722 DL, Offset, AllowNonInbounds, AllowInvariantGroup));
723 }
724
725 /// This is a wrapper around stripAndAccumulateConstantOffsets with the
726 /// in-bounds requirement set to false.
727 const Value *stripAndAccumulateInBoundsConstantOffsets(const DataLayout &DL,
728 APInt &Offset) const {
729 return stripAndAccumulateConstantOffsets(DL, Offset,
730 /* AllowNonInbounds */ false);
731 }
732 Value *stripAndAccumulateInBoundsConstantOffsets(const DataLayout &DL,
733 APInt &Offset) {
734 return stripAndAccumulateConstantOffsets(DL, Offset,
735 /* AllowNonInbounds */ false);
736 }
737
738 /// Strip off pointer casts and inbounds GEPs.
739 ///
740 /// Returns the original pointer value. If this is called on a non-pointer
741 /// value, it returns 'this'.
742 const Value *stripInBoundsOffsets(function_ref<void(const Value *)> Func =
743 [](const Value *) {}) const;
744 inline Value *stripInBoundsOffsets(function_ref<void(const Value *)> Func =
745 [](const Value *) {}) {
746 return const_cast<Value *>(
747 static_cast<const Value *>(this)->stripInBoundsOffsets(Func));
748 }
749
750 /// Return true if the memory object referred to by V can by freed in the
751 /// scope for which the SSA value defining the allocation is statically
752 /// defined. E.g. deallocation after the static scope of a value does not
753 /// count, but a deallocation before that does.
754 bool canBeFreed() const;
755
756 /// Returns the number of bytes known to be dereferenceable for the
757 /// pointer value.
758 ///
759 /// If CanBeNull is set by this function the pointer can either be null or be
760 /// dereferenceable up to the returned number of bytes.
761 ///
762 /// IF CanBeFreed is true, the pointer is known to be dereferenceable at
763 /// point of definition only. Caller must prove that allocation is not
764 /// deallocated between point of definition and use.
765 uint64_t getPointerDereferenceableBytes(const DataLayout &DL,
766 bool &CanBeNull,
767 bool &CanBeFreed) const;
768
769 /// Returns an alignment of the pointer value.
770 ///
771 /// Returns an alignment which is either specified explicitly, e.g. via
772 /// align attribute of a function argument, or guaranteed by DataLayout.
773 Align getPointerAlignment(const DataLayout &DL) const;
774
775 /// Translate PHI node to its predecessor from the given basic block.
776 ///
777 /// If this value is a PHI node with CurBB as its parent, return the value in
778 /// the PHI node corresponding to PredBB. If not, return ourself. This is
779 /// useful if you want to know the value something has in a predecessor
780 /// block.
781 const Value *DoPHITranslation(const BasicBlock *CurBB,
782 const BasicBlock *PredBB) const;
783 Value *DoPHITranslation(const BasicBlock *CurBB, const BasicBlock *PredBB) {
784 return const_cast<Value *>(
785 static_cast<const Value *>(this)->DoPHITranslation(CurBB, PredBB));
786 }
787
788 /// The maximum alignment for instructions.
789 ///
790 /// This is the greatest alignment value supported by load, store, and alloca
791 /// instructions, and global values.
792 static constexpr unsigned MaxAlignmentExponent = 32;
793 static constexpr uint64_t MaximumAlignment = 1ULL << MaxAlignmentExponent;
794
795 /// Mutate the type of this Value to be of the specified type.
796 ///
797 /// Note that this is an extremely dangerous operation which can create
798 /// completely invalid IR very easily. It is strongly recommended that you
799 /// recreate IR objects with the right types instead of mutating them in
800 /// place.
801 void mutateType(Type *Ty) {
802 VTy = Ty;
803 }
804
805 /// Sort the use-list.
806 ///
807 /// Sorts the Value's use-list by Cmp using a stable mergesort. Cmp is
808 /// expected to compare two \a Use references.
809 template <class Compare> void sortUseList(Compare Cmp);
810
811 /// Reverse the use-list.
812 void reverseUseList();
813
814private:
815 /// Merge two lists together.
816 ///
817 /// Merges \c L and \c R using \c Cmp. To enable stable sorts, always pushes
818 /// "equal" items from L before items from R.
819 ///
820 /// \return the first element in the list.
821 ///
822 /// \note Completely ignores \a Use::Prev (doesn't read, doesn't update).
823 template <class Compare>
824 static Use *mergeUseLists(Use *L, Use *R, Compare Cmp) {
825 Use *Merged;
826 Use **Next = &Merged;
827
828 while (true) {
829 if (!L) {
830 *Next = R;
831 break;
832 }
833 if (!R) {
834 *Next = L;
835 break;
836 }
837 if (Cmp(*R, *L)) {
838 *Next = R;
839 Next = &R->Next;
840 R = R->Next;
841 } else {
842 *Next = L;
843 Next = &L->Next;
844 L = L->Next;
845 }
846 }
847
848 return Merged;
849 }
850
851protected:
852 unsigned short getSubclassDataFromValue() const { return SubclassData; }
853 void setValueSubclassData(unsigned short D) { SubclassData = D; }
854};
855
856struct ValueDeleter { void operator()(Value *V) { V->deleteValue(); } };
857
858/// Use this instead of std::unique_ptr<Value> or std::unique_ptr<Instruction>.
859/// Those don't work because Value and Instruction's destructors are protected,
860/// aren't virtual, and won't destroy the complete object.
861using unique_value = std::unique_ptr<Value, ValueDeleter>;
862
863inline raw_ostream &operator<<(raw_ostream &OS, const Value &V) {
864 V.print(OS);
865 return OS;
866}
867
868void Use::set(Value *V) {
869 if (Val) removeFromList();
870 Val = V;
871 if (V) V->addUse(*this);
872}
873
874Value *Use::operator=(Value *RHS) {
875 set(RHS);
876 return RHS;
877}
878
879const Use &Use::operator=(const Use &RHS) {
880 set(RHS.Val);
881 return *this;
882}
883
884template <class Compare> void Value::sortUseList(Compare Cmp) {
885 if (!UseList || !UseList->Next)
886 // No need to sort 0 or 1 uses.
887 return;
888
889 // Note: this function completely ignores Prev pointers until the end when
890 // they're fixed en masse.
891
892 // Create a binomial vector of sorted lists, visiting uses one at a time and
893 // merging lists as necessary.
894 const unsigned MaxSlots = 32;
895 Use *Slots[MaxSlots];
896
897 // Collect the first use, turning it into a single-item list.
898 Use *Next = UseList->Next;
899 UseList->Next = nullptr;
900 unsigned NumSlots = 1;
901 Slots[0] = UseList;
902
903 // Collect all but the last use.
904 while (Next->Next) {
905 Use *Current = Next;
906 Next = Current->Next;
907
908 // Turn Current into a single-item list.
909 Current->Next = nullptr;
910
911 // Save Current in the first available slot, merging on collisions.
912 unsigned I;
913 for (I = 0; I < NumSlots; ++I) {
914 if (!Slots[I])
915 break;
916
917 // Merge two lists, doubling the size of Current and emptying slot I.
918 //
919 // Since the uses in Slots[I] originally preceded those in Current, send
920 // Slots[I] in as the left parameter to maintain a stable sort.
921 Current = mergeUseLists(Slots[I], Current, Cmp);
922 Slots[I] = nullptr;
923 }
924 // Check if this is a new slot.
925 if (I == NumSlots) {
926 ++NumSlots;
927 assert(NumSlots <= MaxSlots && "Use list bigger than 2^32")(static_cast <bool> (NumSlots <= MaxSlots &&
"Use list bigger than 2^32") ? void (0) : __assert_fail ("NumSlots <= MaxSlots && \"Use list bigger than 2^32\""
, "llvm/include/llvm/IR/Value.h", 927, __extension__ __PRETTY_FUNCTION__
))
;
928 }
929
930 // Found an open slot.
931 Slots[I] = Current;
932 }
933
934 // Merge all the lists together.
935 assert(Next && "Expected one more Use")(static_cast <bool> (Next && "Expected one more Use"
) ? void (0) : __assert_fail ("Next && \"Expected one more Use\""
, "llvm/include/llvm/IR/Value.h", 935, __extension__ __PRETTY_FUNCTION__
))
;
936 assert(!Next->Next && "Expected only one Use")(static_cast <bool> (!Next->Next && "Expected only one Use"
) ? void (0) : __assert_fail ("!Next->Next && \"Expected only one Use\""
, "llvm/include/llvm/IR/Value.h", 936, __extension__ __PRETTY_FUNCTION__
))
;
937 UseList = Next;
938 for (unsigned I = 0; I < NumSlots; ++I)
939 if (Slots[I])
940 // Since the uses in Slots[I] originally preceded those in UseList, send
941 // Slots[I] in as the left parameter to maintain a stable sort.
942 UseList = mergeUseLists(Slots[I], UseList, Cmp);
943
944 // Fix the Prev pointers.
945 for (Use *I = UseList, **Prev = &UseList; I; I = I->Next) {
946 I->Prev = Prev;
947 Prev = &I->Next;
948 }
949}
950
951// isa - Provide some specializations of isa so that we don't have to include
952// the subtype header files to test to see if the value is a subclass...
953//
954template <> struct isa_impl<Constant, Value> {
955 static inline bool doit(const Value &Val) {
956 static_assert(Value::ConstantFirstVal == 0, "Val.getValueID() >= Value::ConstantFirstVal");
957 return Val.getValueID() <= Value::ConstantLastVal;
958 }
959};
960
961template <> struct isa_impl<ConstantData, Value> {
962 static inline bool doit(const Value &Val) {
963 return Val.getValueID() >= Value::ConstantDataFirstVal &&
964 Val.getValueID() <= Value::ConstantDataLastVal;
965 }
966};
967
968template <> struct isa_impl<ConstantAggregate, Value> {
969 static inline bool doit(const Value &Val) {
970 return Val.getValueID() >= Value::ConstantAggregateFirstVal &&
971 Val.getValueID() <= Value::ConstantAggregateLastVal;
972 }
973};
974
975template <> struct isa_impl<Argument, Value> {
976 static inline bool doit (const Value &Val) {
977 return Val.getValueID() == Value::ArgumentVal;
978 }
979};
980
981template <> struct isa_impl<InlineAsm, Value> {
982 static inline bool doit(const Value &Val) {
983 return Val.getValueID() == Value::InlineAsmVal;
984 }
985};
986
987template <> struct isa_impl<Instruction, Value> {
988 static inline bool doit(const Value &Val) {
989 return Val.getValueID() >= Value::InstructionVal;
990 }
991};
992
993template <> struct isa_impl<BasicBlock, Value> {
994 static inline bool doit(const Value &Val) {
995 return Val.getValueID() == Value::BasicBlockVal;
996 }
997};
998
999template <> struct isa_impl<Function, Value> {
1000 static inline bool doit(const Value &Val) {
1001 return Val.getValueID() == Value::FunctionVal;
1002 }
1003};
1004
1005template <> struct isa_impl<GlobalVariable, Value> {
1006 static inline bool doit(const Value &Val) {
1007 return Val.getValueID() == Value::GlobalVariableVal;
1008 }
1009};
1010
1011template <> struct isa_impl<GlobalAlias, Value> {
1012 static inline bool doit(const Value &Val) {
1013 return Val.getValueID() == Value::GlobalAliasVal;
1014 }
1015};
1016
1017template <> struct isa_impl<GlobalIFunc, Value> {
1018 static inline bool doit(const Value &Val) {
1019 return Val.getValueID() == Value::GlobalIFuncVal;
1020 }
1021};
1022
1023template <> struct isa_impl<GlobalValue, Value> {
1024 static inline bool doit(const Value &Val) {
1025 return isa<GlobalObject>(Val) || isa<GlobalAlias>(Val);
1026 }
1027};
1028
1029template <> struct isa_impl<GlobalObject, Value> {
1030 static inline bool doit(const Value &Val) {
1031 return isa<GlobalVariable>(Val) || isa<Function>(Val) ||
1032 isa<GlobalIFunc>(Val);
1033 }
1034};
1035
1036// Create wrappers for C Binding types (see CBindingWrapping.h).
1037DEFINE_ISA_CONVERSION_FUNCTIONS(Value, LLVMValueRef)inline Value *unwrap(LLVMValueRef P) { return reinterpret_cast
<Value*>(P); } inline LLVMValueRef wrap(const Value *P)
{ return reinterpret_cast<LLVMValueRef>(const_cast<
Value*>(P)); } template<typename T> inline T *unwrap
(LLVMValueRef P) { return cast<T>(unwrap(P)); }
1038
1039// Specialized opaque value conversions.
1040inline Value **unwrap(LLVMValueRef *Vals) {
1041 return reinterpret_cast<Value**>(Vals);
1042}
1043
1044template<typename T>
1045inline T **unwrap(LLVMValueRef *Vals, unsigned Length) {
1046#ifndef NDEBUG
1047 for (LLVMValueRef *I = Vals, *E = Vals + Length; I != E; ++I)
1048 unwrap<T>(*I); // For side effect of calling assert on invalid usage.
1049#endif
1050 (void)Length;
1051 return reinterpret_cast<T**>(Vals);
1052}
1053
1054inline LLVMValueRef *wrap(const Value **Vals) {
1055 return reinterpret_cast<LLVMValueRef*>(const_cast<Value**>(Vals));
1056}
1057
1058} // end namespace llvm
1059
1060#endif // LLVM_IR_VALUE_H

/build/llvm-toolchain-snapshot-14~++20220119111520+da61cb019eb2/llvm/include/llvm/ADT/ilist_iterator.h

1//===- llvm/ADT/ilist_iterator.h - Intrusive List Iterator ------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8
9#ifndef LLVM_ADT_ILIST_ITERATOR_H
10#define LLVM_ADT_ILIST_ITERATOR_H
11
12#include "llvm/ADT/ilist_node.h"
13#include <cassert>
14#include <cstddef>
15#include <iterator>
16#include <type_traits>
17
18namespace llvm {
19
20namespace ilist_detail {
21
22/// Find const-correct node types.
23template <class OptionsT, bool IsConst> struct IteratorTraits;
24template <class OptionsT> struct IteratorTraits<OptionsT, false> {
25 using value_type = typename OptionsT::value_type;
26 using pointer = typename OptionsT::pointer;
27 using reference = typename OptionsT::reference;
28 using node_pointer = ilist_node_impl<OptionsT> *;
29 using node_reference = ilist_node_impl<OptionsT> &;
30};
31template <class OptionsT> struct IteratorTraits<OptionsT, true> {
32 using value_type = const typename OptionsT::value_type;
33 using pointer = typename OptionsT::const_pointer;
34 using reference = typename OptionsT::const_reference;
35 using node_pointer = const ilist_node_impl<OptionsT> *;
36 using node_reference = const ilist_node_impl<OptionsT> &;
37};
38
39template <bool IsReverse> struct IteratorHelper;
40template <> struct IteratorHelper<false> : ilist_detail::NodeAccess {
41 using Access = ilist_detail::NodeAccess;
42
43 template <class T> static void increment(T *&I) { I = Access::getNext(*I); }
44 template <class T> static void decrement(T *&I) { I = Access::getPrev(*I); }
45};
46template <> struct IteratorHelper<true> : ilist_detail::NodeAccess {
47 using Access = ilist_detail::NodeAccess;
48
49 template <class T> static void increment(T *&I) { I = Access::getPrev(*I); }
50 template <class T> static void decrement(T *&I) { I = Access::getNext(*I); }
51};
52
53} // end namespace ilist_detail
54
55/// Iterator for intrusive lists based on ilist_node.
56template <class OptionsT, bool IsReverse, bool IsConst>
57class ilist_iterator : ilist_detail::SpecificNodeAccess<OptionsT> {
58 friend ilist_iterator<OptionsT, IsReverse, !IsConst>;
59 friend ilist_iterator<OptionsT, !IsReverse, IsConst>;
60 friend ilist_iterator<OptionsT, !IsReverse, !IsConst>;
61
62 using Traits = ilist_detail::IteratorTraits<OptionsT, IsConst>;
63 using Access = ilist_detail::SpecificNodeAccess<OptionsT>;
64
65public:
66 using value_type = typename Traits::value_type;
67 using pointer = typename Traits::pointer;
68 using reference = typename Traits::reference;
69 using difference_type = ptrdiff_t;
70 using iterator_category = std::bidirectional_iterator_tag;
71 using const_pointer = typename OptionsT::const_pointer;
72 using const_reference = typename OptionsT::const_reference;
73
74private:
75 using node_pointer = typename Traits::node_pointer;
76 using node_reference = typename Traits::node_reference;
77
78 node_pointer NodePtr = nullptr;
79
80public:
81 /// Create from an ilist_node.
82 explicit ilist_iterator(node_reference N) : NodePtr(&N) {}
83
84 explicit ilist_iterator(pointer NP) : NodePtr(Access::getNodePtr(NP)) {}
85 explicit ilist_iterator(reference NR) : NodePtr(Access::getNodePtr(&NR)) {}
86 ilist_iterator() = default;
87
88 // This is templated so that we can allow constructing a const iterator from
89 // a nonconst iterator...
90 template <bool RHSIsConst>
91 ilist_iterator(const ilist_iterator<OptionsT, IsReverse, RHSIsConst> &RHS,
92 std::enable_if_t<IsConst || !RHSIsConst, void *> = nullptr)
93 : NodePtr(RHS.NodePtr) {}
94
95 // This is templated so that we can allow assigning to a const iterator from
96 // a nonconst iterator...
97 template <bool RHSIsConst>
98 std::enable_if_t<IsConst || !RHSIsConst, ilist_iterator &>
99 operator=(const ilist_iterator<OptionsT, IsReverse, RHSIsConst> &RHS) {
100 NodePtr = RHS.NodePtr;
101 return *this;
102 }
103
104 /// Explicit conversion between forward/reverse iterators.
105 ///
106 /// Translate between forward and reverse iterators without changing range
107 /// boundaries. The resulting iterator will dereference (and have a handle)
108 /// to the previous node, which is somewhat unexpected; but converting the
109 /// two endpoints in a range will give the same range in reverse.
110 ///
111 /// This matches std::reverse_iterator conversions.
112 explicit ilist_iterator(
113 const ilist_iterator<OptionsT, !IsReverse, IsConst> &RHS)
114 : ilist_iterator(++RHS.getReverse()) {}
115
116 /// Get a reverse iterator to the same node.
117 ///
118 /// Gives a reverse iterator that will dereference (and have a handle) to the
119 /// same node. Converting the endpoint iterators in a range will give a
120 /// different range; for range operations, use the explicit conversions.
121 ilist_iterator<OptionsT, !IsReverse, IsConst> getReverse() const {
122 if (NodePtr)
123 return ilist_iterator<OptionsT, !IsReverse, IsConst>(*NodePtr);
124 return ilist_iterator<OptionsT, !IsReverse, IsConst>();
125 }
126
127 /// Const-cast.
128 ilist_iterator<OptionsT, IsReverse, false> getNonConst() const {
129 if (NodePtr)
130 return ilist_iterator<OptionsT, IsReverse, false>(
131 const_cast<typename ilist_iterator<OptionsT, IsReverse,
132 false>::node_reference>(*NodePtr));
133 return ilist_iterator<OptionsT, IsReverse, false>();
134 }
135
136 // Accessors...
137 reference operator*() const {
138 assert(!NodePtr->isKnownSentinel())(static_cast <bool> (!NodePtr->isKnownSentinel()) ? void
(0) : __assert_fail ("!NodePtr->isKnownSentinel()", "llvm/include/llvm/ADT/ilist_iterator.h"
, 138, __extension__ __PRETTY_FUNCTION__))
;
139 return *Access::getValuePtr(NodePtr);
140 }
141 pointer operator->() const { return &operator*(); }
142
143 // Comparison operators
144 friend bool operator==(const ilist_iterator &LHS, const ilist_iterator &RHS) {
145 return LHS.NodePtr == RHS.NodePtr;
146 }
147 friend bool operator!=(const ilist_iterator &LHS, const ilist_iterator &RHS) {
148 return LHS.NodePtr != RHS.NodePtr;
26
Assuming 'LHS.NodePtr' is not equal to 'RHS.NodePtr'
27
Returning the value 1, which participates in a condition later
38
Assuming 'LHS.NodePtr' is not equal to 'RHS.NodePtr'
39
Returning the value 1, which participates in a condition later
149 }
150
151 // Increment and decrement operators...
152 ilist_iterator &operator--() {
153 NodePtr = IsReverse ? NodePtr->getNext() : NodePtr->getPrev();
154 return *this;
155 }
156 ilist_iterator &operator++() {
157 NodePtr = IsReverse ? NodePtr->getPrev() : NodePtr->getNext();
158 return *this;
159 }
160 ilist_iterator operator--(int) {
161 ilist_iterator tmp = *this;
162 --*this;
163 return tmp;
164 }
165 ilist_iterator operator++(int) {
166 ilist_iterator tmp = *this;
167 ++*this;
168 return tmp;
169 }
170
171 /// Get the underlying ilist_node.
172 node_pointer getNodePtr() const { return static_cast<node_pointer>(NodePtr); }
173
174 /// Check for end. Only valid if ilist_sentinel_tracking<true>.
175 bool isEnd() const { return NodePtr ? NodePtr->isSentinel() : false; }
176};
177
178template <typename From> struct simplify_type;
179
180/// Allow ilist_iterators to convert into pointers to a node automatically when
181/// used by the dyn_cast, cast, isa mechanisms...
182///
183/// FIXME: remove this, since there is no implicit conversion to NodeTy.
184template <class OptionsT, bool IsConst>
185struct simplify_type<ilist_iterator<OptionsT, false, IsConst>> {
186 using iterator = ilist_iterator<OptionsT, false, IsConst>;
187 using SimpleType = typename iterator::pointer;
188
189 static SimpleType getSimplifiedValue(const iterator &Node) { return &*Node; }
190};
191template <class OptionsT, bool IsConst>
192struct simplify_type<const ilist_iterator<OptionsT, false, IsConst>>
193 : simplify_type<ilist_iterator<OptionsT, false, IsConst>> {};
194
195} // end namespace llvm
196
197#endif // LLVM_ADT_ILIST_ITERATOR_H