xref: /llvm-project/llvm/unittests/IR/IRBuilderTest.cpp (revision 2f8238f849c4836b333082f387d91408234ea73b)
1 //===- llvm/unittest/IR/IRBuilderTest.cpp - IRBuilder tests ---------------===//
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 #include "llvm/Analysis/InstSimplifyFolder.h"
10 #include "llvm/IR/IRBuilder.h"
11 #include "llvm/IR/BasicBlock.h"
12 #include "llvm/IR/DIBuilder.h"
13 #include "llvm/IR/DataLayout.h"
14 #include "llvm/IR/Function.h"
15 #include "llvm/IR/IntrinsicInst.h"
16 #include "llvm/IR/IntrinsicsAArch64.h"
17 #include "llvm/IR/LLVMContext.h"
18 #include "llvm/IR/MDBuilder.h"
19 #include "llvm/IR/Module.h"
20 #include "llvm/IR/NoFolder.h"
21 #include "llvm/IR/Verifier.h"
22 #include "gmock/gmock.h"
23 #include "gtest/gtest.h"
24 
25 #include <type_traits>
26 
27 using namespace llvm;
28 using ::testing::UnorderedElementsAre;
29 
30 namespace {
31 
32 class IRBuilderTest : public testing::Test {
33 protected:
34   void SetUp() override {
35     M.reset(new Module("MyModule", Ctx));
36     FunctionType *FTy = FunctionType::get(Type::getVoidTy(Ctx),
37                                           /*isVarArg=*/false);
38     F = Function::Create(FTy, Function::ExternalLinkage, "", M.get());
39     BB = BasicBlock::Create(Ctx, "", F);
40     GV = new GlobalVariable(*M, Type::getFloatTy(Ctx), true,
41                             GlobalValue::ExternalLinkage, nullptr);
42   }
43 
44   void TearDown() override {
45     BB = nullptr;
46     M.reset();
47   }
48 
49   LLVMContext Ctx;
50   std::unique_ptr<Module> M;
51   Function *F;
52   BasicBlock *BB;
53   GlobalVariable *GV;
54 };
55 
56 TEST_F(IRBuilderTest, Intrinsics) {
57   IRBuilder<> Builder(BB);
58   Value *V;
59   Instruction *I;
60   Value *Result;
61   IntrinsicInst *II;
62 
63   V = Builder.CreateLoad(GV->getValueType(), GV);
64   I = cast<Instruction>(Builder.CreateFAdd(V, V));
65   I->setHasNoInfs(true);
66   I->setHasNoNaNs(false);
67 
68   Result = Builder.CreateMinNum(V, V);
69   II = cast<IntrinsicInst>(Result);
70   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::minnum);
71 
72   Result = Builder.CreateMaxNum(V, V);
73   II = cast<IntrinsicInst>(Result);
74   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::maxnum);
75 
76   Result = Builder.CreateMinimum(V, V);
77   II = cast<IntrinsicInst>(Result);
78   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::minimum);
79 
80   Result = Builder.CreateMaximum(V, V);
81   II = cast<IntrinsicInst>(Result);
82   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::maximum);
83 
84   Result = Builder.CreateIntrinsic(Intrinsic::readcyclecounter, {}, {});
85   II = cast<IntrinsicInst>(Result);
86   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::readcyclecounter);
87 
88   Result = Builder.CreateUnaryIntrinsic(Intrinsic::fabs, V);
89   II = cast<IntrinsicInst>(Result);
90   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::fabs);
91   EXPECT_FALSE(II->hasNoInfs());
92   EXPECT_FALSE(II->hasNoNaNs());
93 
94   Result = Builder.CreateUnaryIntrinsic(Intrinsic::fabs, V, I);
95   II = cast<IntrinsicInst>(Result);
96   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::fabs);
97   EXPECT_TRUE(II->hasNoInfs());
98   EXPECT_FALSE(II->hasNoNaNs());
99 
100   Result = Builder.CreateBinaryIntrinsic(Intrinsic::pow, V, V);
101   II = cast<IntrinsicInst>(Result);
102   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::pow);
103   EXPECT_FALSE(II->hasNoInfs());
104   EXPECT_FALSE(II->hasNoNaNs());
105 
106   Result = Builder.CreateBinaryIntrinsic(Intrinsic::pow, V, V, I);
107   II = cast<IntrinsicInst>(Result);
108   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::pow);
109   EXPECT_TRUE(II->hasNoInfs());
110   EXPECT_FALSE(II->hasNoNaNs());
111 
112   Result = Builder.CreateIntrinsic(Intrinsic::fma, {V->getType()}, {V, V, V});
113   II = cast<IntrinsicInst>(Result);
114   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::fma);
115   EXPECT_FALSE(II->hasNoInfs());
116   EXPECT_FALSE(II->hasNoNaNs());
117 
118   Result =
119       Builder.CreateIntrinsic(Intrinsic::fma, {V->getType()}, {V, V, V}, I);
120   II = cast<IntrinsicInst>(Result);
121   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::fma);
122   EXPECT_TRUE(II->hasNoInfs());
123   EXPECT_FALSE(II->hasNoNaNs());
124 
125   Result =
126       Builder.CreateIntrinsic(Intrinsic::fma, {V->getType()}, {V, V, V}, I);
127   II = cast<IntrinsicInst>(Result);
128   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::fma);
129   EXPECT_TRUE(II->hasNoInfs());
130   EXPECT_FALSE(II->hasNoNaNs());
131 
132   Result = Builder.CreateUnaryIntrinsic(Intrinsic::roundeven, V);
133   II = cast<IntrinsicInst>(Result);
134   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::roundeven);
135   EXPECT_FALSE(II->hasNoInfs());
136   EXPECT_FALSE(II->hasNoNaNs());
137 
138   Result = Builder.CreateIntrinsic(
139       Intrinsic::set_rounding, {},
140       {Builder.getInt32(static_cast<uint32_t>(RoundingMode::TowardZero))});
141   II = cast<IntrinsicInst>(Result);
142   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::set_rounding);
143 }
144 
145 TEST_F(IRBuilderTest, IntrinsicMangling) {
146   IRBuilder<> Builder(BB);
147   Type *VoidTy = Builder.getVoidTy();
148   Type *Int64Ty = Builder.getInt64Ty();
149   Value *Int64Val = Builder.getInt64(0);
150   Value *DoubleVal = PoisonValue::get(Builder.getDoubleTy());
151   CallInst *Call;
152 
153   // Mangled return type, no arguments.
154   Call = Builder.CreateIntrinsic(Int64Ty, Intrinsic::coro_size, {});
155   EXPECT_EQ(Call->getCalledFunction()->getName(), "llvm.coro.size.i64");
156 
157   // Void return type, mangled argument type.
158   Call =
159       Builder.CreateIntrinsic(VoidTy, Intrinsic::set_loop_iterations, Int64Val);
160   EXPECT_EQ(Call->getCalledFunction()->getName(),
161             "llvm.set.loop.iterations.i64");
162 
163   // Mangled return type and argument type.
164   Call = Builder.CreateIntrinsic(Int64Ty, Intrinsic::lround, DoubleVal);
165   EXPECT_EQ(Call->getCalledFunction()->getName(), "llvm.lround.i64.f64");
166 }
167 
168 TEST_F(IRBuilderTest, IntrinsicsWithScalableVectors) {
169   IRBuilder<> Builder(BB);
170   CallInst *Call;
171   FunctionType *FTy;
172 
173   // Test scalable flag isn't dropped for intrinsic that is explicitly defined
174   // with scalable vectors, e.g. LLVMType<nxv4i32>.
175   Type *SrcVecTy = VectorType::get(Builder.getHalfTy(), 8, true);
176   Type *DstVecTy = VectorType::get(Builder.getInt32Ty(), 4, true);
177   Type *PredTy = VectorType::get(Builder.getInt1Ty(), 4, true);
178 
179   SmallVector<Value*, 3> ArgTys;
180   ArgTys.push_back(UndefValue::get(DstVecTy));
181   ArgTys.push_back(UndefValue::get(PredTy));
182   ArgTys.push_back(UndefValue::get(SrcVecTy));
183 
184   Call = Builder.CreateIntrinsic(Intrinsic::aarch64_sve_fcvtzs_i32f16, {},
185                                  ArgTys, nullptr, "aarch64.sve.fcvtzs.i32f16");
186   FTy = Call->getFunctionType();
187   EXPECT_EQ(FTy->getReturnType(), DstVecTy);
188   for (unsigned i = 0; i != ArgTys.size(); ++i)
189     EXPECT_EQ(FTy->getParamType(i), ArgTys[i]->getType());
190 
191   // Test scalable flag isn't dropped for intrinsic defined with
192   // LLVMScalarOrSameVectorWidth.
193 
194   Type *VecTy = VectorType::get(Builder.getInt32Ty(), 4, true);
195   Type *PtrToVecTy = Builder.getPtrTy();
196   PredTy = VectorType::get(Builder.getInt1Ty(), 4, true);
197 
198   ArgTys.clear();
199   ArgTys.push_back(UndefValue::get(PtrToVecTy));
200   ArgTys.push_back(UndefValue::get(Builder.getInt32Ty()));
201   ArgTys.push_back(UndefValue::get(PredTy));
202   ArgTys.push_back(UndefValue::get(VecTy));
203 
204   Call = Builder.CreateIntrinsic(Intrinsic::masked_load,
205                                  {VecTy, PtrToVecTy}, ArgTys,
206                                  nullptr, "masked.load");
207   FTy = Call->getFunctionType();
208   EXPECT_EQ(FTy->getReturnType(), VecTy);
209   for (unsigned i = 0; i != ArgTys.size(); ++i)
210     EXPECT_EQ(FTy->getParamType(i), ArgTys[i]->getType());
211 }
212 
213 TEST_F(IRBuilderTest, CreateVScale) {
214   IRBuilder<> Builder(BB);
215 
216   Constant *Zero = Builder.getInt32(0);
217   Value *VScale = Builder.CreateVScale(Zero);
218   EXPECT_TRUE(isa<ConstantInt>(VScale) && cast<ConstantInt>(VScale)->isZero());
219 }
220 
221 TEST_F(IRBuilderTest, CreateStepVector) {
222   IRBuilder<> Builder(BB);
223 
224   // Fixed width vectors
225   Type *DstVecTy = VectorType::get(Builder.getInt32Ty(), 4, false);
226   Value *StepVec = Builder.CreateStepVector(DstVecTy);
227   EXPECT_TRUE(isa<Constant>(StepVec));
228   EXPECT_EQ(StepVec->getType(), DstVecTy);
229 
230   const auto *VectorValue = cast<Constant>(StepVec);
231   for (unsigned i = 0; i < 4; i++) {
232     EXPECT_TRUE(isa<ConstantInt>(VectorValue->getAggregateElement(i)));
233     ConstantInt *El = cast<ConstantInt>(VectorValue->getAggregateElement(i));
234     EXPECT_EQ(El->getValue(), i);
235   }
236 
237   // Scalable vectors
238   DstVecTy = VectorType::get(Builder.getInt32Ty(), 4, true);
239   StepVec = Builder.CreateStepVector(DstVecTy);
240   EXPECT_TRUE(isa<CallInst>(StepVec));
241   CallInst *Call = cast<CallInst>(StepVec);
242   FunctionType *FTy = Call->getFunctionType();
243   EXPECT_EQ(FTy->getReturnType(), DstVecTy);
244   EXPECT_EQ(Call->getIntrinsicID(), Intrinsic::stepvector);
245 }
246 
247 TEST_F(IRBuilderTest, CreateStepVectorI3) {
248   IRBuilder<> Builder(BB);
249 
250   // Scalable vectors
251   Type *DstVecTy = VectorType::get(IntegerType::get(Ctx, 3), 2, true);
252   Type *VecI8Ty = VectorType::get(Builder.getInt8Ty(), 2, true);
253   Value *StepVec = Builder.CreateStepVector(DstVecTy);
254   EXPECT_TRUE(isa<TruncInst>(StepVec));
255   TruncInst *Trunc = cast<TruncInst>(StepVec);
256   EXPECT_EQ(Trunc->getDestTy(), DstVecTy);
257   EXPECT_EQ(Trunc->getSrcTy(), VecI8Ty);
258   EXPECT_TRUE(isa<CallInst>(Trunc->getOperand(0)));
259 
260   CallInst *Call = cast<CallInst>(Trunc->getOperand(0));
261   FunctionType *FTy = Call->getFunctionType();
262   EXPECT_EQ(FTy->getReturnType(), VecI8Ty);
263   EXPECT_EQ(Call->getIntrinsicID(), Intrinsic::stepvector);
264 }
265 
266 TEST_F(IRBuilderTest, ConstrainedFP) {
267   IRBuilder<> Builder(BB);
268   Value *V;
269   Value *VDouble;
270   Value *VInt;
271   CallInst *Call;
272   IntrinsicInst *II;
273   GlobalVariable *GVDouble = new GlobalVariable(*M, Type::getDoubleTy(Ctx),
274                             true, GlobalValue::ExternalLinkage, nullptr);
275 
276   V = Builder.CreateLoad(GV->getValueType(), GV);
277   VDouble = Builder.CreateLoad(GVDouble->getValueType(), GVDouble);
278 
279   // See if we get constrained intrinsics instead of non-constrained
280   // instructions.
281   Builder.setIsFPConstrained(true);
282   auto Parent = BB->getParent();
283   Parent->addFnAttr(Attribute::StrictFP);
284 
285   V = Builder.CreateFAdd(V, V);
286   ASSERT_TRUE(isa<IntrinsicInst>(V));
287   II = cast<IntrinsicInst>(V);
288   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_fadd);
289 
290   V = Builder.CreateFSub(V, V);
291   ASSERT_TRUE(isa<IntrinsicInst>(V));
292   II = cast<IntrinsicInst>(V);
293   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_fsub);
294 
295   V = Builder.CreateFMul(V, V);
296   ASSERT_TRUE(isa<IntrinsicInst>(V));
297   II = cast<IntrinsicInst>(V);
298   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_fmul);
299 
300   V = Builder.CreateFDiv(V, V);
301   ASSERT_TRUE(isa<IntrinsicInst>(V));
302   II = cast<IntrinsicInst>(V);
303   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_fdiv);
304 
305   V = Builder.CreateFRem(V, V);
306   ASSERT_TRUE(isa<IntrinsicInst>(V));
307   II = cast<IntrinsicInst>(V);
308   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_frem);
309 
310   VInt = Builder.CreateFPToUI(VDouble, Builder.getInt32Ty());
311   ASSERT_TRUE(isa<IntrinsicInst>(VInt));
312   II = cast<IntrinsicInst>(VInt);
313   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_fptoui);
314 
315   VInt = Builder.CreateFPToSI(VDouble, Builder.getInt32Ty());
316   ASSERT_TRUE(isa<IntrinsicInst>(VInt));
317   II = cast<IntrinsicInst>(VInt);
318   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_fptosi);
319 
320   VDouble = Builder.CreateUIToFP(VInt, Builder.getDoubleTy());
321   ASSERT_TRUE(isa<IntrinsicInst>(VDouble));
322   II = cast<IntrinsicInst>(VDouble);
323   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_uitofp);
324 
325   VDouble = Builder.CreateSIToFP(VInt, Builder.getDoubleTy());
326   ASSERT_TRUE(isa<IntrinsicInst>(VDouble));
327   II = cast<IntrinsicInst>(VDouble);
328   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_sitofp);
329 
330   V = Builder.CreateFPTrunc(VDouble, Type::getFloatTy(Ctx));
331   ASSERT_TRUE(isa<IntrinsicInst>(V));
332   II = cast<IntrinsicInst>(V);
333   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_fptrunc);
334 
335   VDouble = Builder.CreateFPExt(V, Type::getDoubleTy(Ctx));
336   ASSERT_TRUE(isa<IntrinsicInst>(VDouble));
337   II = cast<IntrinsicInst>(VDouble);
338   EXPECT_EQ(II->getIntrinsicID(), Intrinsic::experimental_constrained_fpext);
339 
340   // Verify attributes on the call are created automatically.
341   AttributeSet CallAttrs = II->getAttributes().getFnAttrs();
342   EXPECT_EQ(CallAttrs.hasAttribute(Attribute::StrictFP), true);
343 
344   // Verify attributes on the containing function are created when requested.
345   Builder.setConstrainedFPFunctionAttr();
346   AttributeList Attrs = BB->getParent()->getAttributes();
347   AttributeSet FnAttrs = Attrs.getFnAttrs();
348   EXPECT_EQ(FnAttrs.hasAttribute(Attribute::StrictFP), true);
349 
350   // Verify the codepaths for setting and overriding the default metadata.
351   V = Builder.CreateFAdd(V, V);
352   ASSERT_TRUE(isa<ConstrainedFPIntrinsic>(V));
353   auto *CII = cast<ConstrainedFPIntrinsic>(V);
354   EXPECT_EQ(fp::ebStrict, CII->getExceptionBehavior());
355   EXPECT_EQ(RoundingMode::Dynamic, CII->getRoundingMode());
356 
357   Builder.setDefaultConstrainedExcept(fp::ebIgnore);
358   Builder.setDefaultConstrainedRounding(RoundingMode::TowardPositive);
359   V = Builder.CreateFAdd(V, V);
360   CII = cast<ConstrainedFPIntrinsic>(V);
361   EXPECT_EQ(fp::ebIgnore, CII->getExceptionBehavior());
362   EXPECT_EQ(CII->getRoundingMode(), RoundingMode::TowardPositive);
363 
364   Builder.setDefaultConstrainedExcept(fp::ebIgnore);
365   Builder.setDefaultConstrainedRounding(RoundingMode::NearestTiesToEven);
366   V = Builder.CreateFAdd(V, V);
367   CII = cast<ConstrainedFPIntrinsic>(V);
368   EXPECT_EQ(fp::ebIgnore, CII->getExceptionBehavior());
369   EXPECT_EQ(RoundingMode::NearestTiesToEven, CII->getRoundingMode());
370 
371   Builder.setDefaultConstrainedExcept(fp::ebMayTrap);
372   Builder.setDefaultConstrainedRounding(RoundingMode::TowardNegative);
373   V = Builder.CreateFAdd(V, V);
374   CII = cast<ConstrainedFPIntrinsic>(V);
375   EXPECT_EQ(fp::ebMayTrap, CII->getExceptionBehavior());
376   EXPECT_EQ(RoundingMode::TowardNegative, CII->getRoundingMode());
377 
378   Builder.setDefaultConstrainedExcept(fp::ebStrict);
379   Builder.setDefaultConstrainedRounding(RoundingMode::TowardZero);
380   V = Builder.CreateFAdd(V, V);
381   CII = cast<ConstrainedFPIntrinsic>(V);
382   EXPECT_EQ(fp::ebStrict, CII->getExceptionBehavior());
383   EXPECT_EQ(RoundingMode::TowardZero, CII->getRoundingMode());
384 
385   Builder.setDefaultConstrainedExcept(fp::ebIgnore);
386   Builder.setDefaultConstrainedRounding(RoundingMode::Dynamic);
387   V = Builder.CreateFAdd(V, V);
388   CII = cast<ConstrainedFPIntrinsic>(V);
389   EXPECT_EQ(fp::ebIgnore, CII->getExceptionBehavior());
390   EXPECT_EQ(RoundingMode::Dynamic, CII->getRoundingMode());
391 
392   // Now override the defaults.
393   Call = Builder.CreateConstrainedFPBinOp(
394         Intrinsic::experimental_constrained_fadd, V, V, nullptr, "", nullptr,
395         RoundingMode::TowardNegative, fp::ebMayTrap);
396   CII = cast<ConstrainedFPIntrinsic>(Call);
397   EXPECT_EQ(CII->getIntrinsicID(), Intrinsic::experimental_constrained_fadd);
398   EXPECT_EQ(fp::ebMayTrap, CII->getExceptionBehavior());
399   EXPECT_EQ(RoundingMode::TowardNegative, CII->getRoundingMode());
400 
401   Builder.CreateRetVoid();
402   EXPECT_FALSE(verifyModule(*M));
403 }
404 
405 TEST_F(IRBuilderTest, ConstrainedFPIntrinsics) {
406   IRBuilder<> Builder(BB);
407   Value *V;
408   Value *VDouble;
409   ConstrainedFPIntrinsic *CII;
410   GlobalVariable *GVDouble = new GlobalVariable(
411       *M, Type::getDoubleTy(Ctx), true, GlobalValue::ExternalLinkage, nullptr);
412   VDouble = Builder.CreateLoad(GVDouble->getValueType(), GVDouble);
413 
414   Builder.setDefaultConstrainedExcept(fp::ebStrict);
415   Builder.setDefaultConstrainedRounding(RoundingMode::TowardZero);
416   Function *Fn = Intrinsic::getOrInsertDeclaration(
417       M.get(), Intrinsic::experimental_constrained_roundeven,
418       {Type::getDoubleTy(Ctx)});
419   V = Builder.CreateConstrainedFPCall(Fn, { VDouble });
420   CII = cast<ConstrainedFPIntrinsic>(V);
421   EXPECT_EQ(Intrinsic::experimental_constrained_roundeven, CII->getIntrinsicID());
422   EXPECT_EQ(fp::ebStrict, CII->getExceptionBehavior());
423 }
424 
425 TEST_F(IRBuilderTest, ConstrainedFPFunctionCall) {
426   IRBuilder<> Builder(BB);
427 
428   // Create an empty constrained FP function.
429   FunctionType *FTy = FunctionType::get(Type::getVoidTy(Ctx),
430                                         /*isVarArg=*/false);
431   Function *Callee =
432       Function::Create(FTy, Function::ExternalLinkage, "", M.get());
433   BasicBlock *CalleeBB = BasicBlock::Create(Ctx, "", Callee);
434   IRBuilder<> CalleeBuilder(CalleeBB);
435   CalleeBuilder.setIsFPConstrained(true);
436   CalleeBuilder.setConstrainedFPFunctionAttr();
437   CalleeBuilder.CreateRetVoid();
438 
439   // Now call the empty constrained FP function.
440   Builder.setIsFPConstrained(true);
441   Builder.setConstrainedFPFunctionAttr();
442   CallInst *FCall = Builder.CreateCall(Callee, {});
443 
444   // Check the attributes to verify the strictfp attribute is on the call.
445   EXPECT_TRUE(
446       FCall->getAttributes().getFnAttrs().hasAttribute(Attribute::StrictFP));
447 
448   Builder.CreateRetVoid();
449   EXPECT_FALSE(verifyModule(*M));
450 }
451 
452 TEST_F(IRBuilderTest, Lifetime) {
453   IRBuilder<> Builder(BB);
454   AllocaInst *Var1 = Builder.CreateAlloca(Builder.getInt8Ty());
455   AllocaInst *Var2 = Builder.CreateAlloca(Builder.getInt32Ty());
456   AllocaInst *Var3 = Builder.CreateAlloca(Builder.getInt8Ty(),
457                                           Builder.getInt32(123));
458 
459   CallInst *Start1 = Builder.CreateLifetimeStart(Var1);
460   CallInst *Start2 = Builder.CreateLifetimeStart(Var2);
461   CallInst *Start3 = Builder.CreateLifetimeStart(Var3, Builder.getInt64(100));
462 
463   EXPECT_EQ(Start1->getArgOperand(0), Builder.getInt64(-1));
464   EXPECT_EQ(Start2->getArgOperand(0), Builder.getInt64(-1));
465   EXPECT_EQ(Start3->getArgOperand(0), Builder.getInt64(100));
466 
467   EXPECT_EQ(Start1->getArgOperand(1), Var1);
468   EXPECT_EQ(Start2->getArgOperand(1)->stripPointerCasts(), Var2);
469   EXPECT_EQ(Start3->getArgOperand(1), Var3);
470 
471   Value *End1 = Builder.CreateLifetimeEnd(Var1);
472   Builder.CreateLifetimeEnd(Var2);
473   Builder.CreateLifetimeEnd(Var3);
474 
475   IntrinsicInst *II_Start1 = dyn_cast<IntrinsicInst>(Start1);
476   IntrinsicInst *II_End1 = dyn_cast<IntrinsicInst>(End1);
477   ASSERT_TRUE(II_Start1 != nullptr);
478   EXPECT_EQ(II_Start1->getIntrinsicID(), Intrinsic::lifetime_start);
479   ASSERT_TRUE(II_End1 != nullptr);
480   EXPECT_EQ(II_End1->getIntrinsicID(), Intrinsic::lifetime_end);
481 }
482 
483 TEST_F(IRBuilderTest, CreateCondBr) {
484   IRBuilder<> Builder(BB);
485   BasicBlock *TBB = BasicBlock::Create(Ctx, "", F);
486   BasicBlock *FBB = BasicBlock::Create(Ctx, "", F);
487 
488   BranchInst *BI = Builder.CreateCondBr(Builder.getTrue(), TBB, FBB);
489   Instruction *TI = BB->getTerminator();
490   EXPECT_EQ(BI, TI);
491   EXPECT_EQ(2u, TI->getNumSuccessors());
492   EXPECT_EQ(TBB, TI->getSuccessor(0));
493   EXPECT_EQ(FBB, TI->getSuccessor(1));
494 
495   BI->eraseFromParent();
496   MDNode *Weights = MDBuilder(Ctx).createBranchWeights(42, 13);
497   BI = Builder.CreateCondBr(Builder.getTrue(), TBB, FBB, Weights);
498   TI = BB->getTerminator();
499   EXPECT_EQ(BI, TI);
500   EXPECT_EQ(2u, TI->getNumSuccessors());
501   EXPECT_EQ(TBB, TI->getSuccessor(0));
502   EXPECT_EQ(FBB, TI->getSuccessor(1));
503   EXPECT_EQ(Weights, TI->getMetadata(LLVMContext::MD_prof));
504 }
505 
506 TEST_F(IRBuilderTest, LandingPadName) {
507   IRBuilder<> Builder(BB);
508   LandingPadInst *LP = Builder.CreateLandingPad(Builder.getInt32Ty(), 0, "LP");
509   EXPECT_EQ(LP->getName(), "LP");
510 }
511 
512 TEST_F(IRBuilderTest, DataLayout) {
513   std::unique_ptr<Module> M(new Module("test", Ctx));
514   M->setDataLayout("e-n32");
515   EXPECT_TRUE(M->getDataLayout().isLegalInteger(32));
516   M->setDataLayout("e");
517   EXPECT_FALSE(M->getDataLayout().isLegalInteger(32));
518 }
519 
520 TEST_F(IRBuilderTest, GetIntTy) {
521   IRBuilder<> Builder(BB);
522   IntegerType *Ty1 = Builder.getInt1Ty();
523   EXPECT_EQ(Ty1, IntegerType::get(Ctx, 1));
524 
525   const DataLayout &DL = M->getDataLayout();
526   IntegerType *IntPtrTy = Builder.getIntPtrTy(DL);
527   unsigned IntPtrBitSize = DL.getPointerSizeInBits(0);
528   EXPECT_EQ(IntPtrTy, IntegerType::get(Ctx, IntPtrBitSize));
529 }
530 
531 TEST_F(IRBuilderTest, UnaryOperators) {
532   IRBuilder<NoFolder> Builder(BB);
533   Value *V = Builder.CreateLoad(GV->getValueType(), GV);
534 
535   // Test CreateUnOp(X)
536   Value *U = Builder.CreateUnOp(Instruction::FNeg, V);
537   ASSERT_TRUE(isa<Instruction>(U));
538   ASSERT_TRUE(isa<FPMathOperator>(U));
539   ASSERT_TRUE(isa<UnaryOperator>(U));
540   ASSERT_FALSE(isa<BinaryOperator>(U));
541 
542   // Test CreateFNegFMF(X)
543   Instruction *I = cast<Instruction>(U);
544   I->setHasNoSignedZeros(true);
545   I->setHasNoNaNs(true);
546   Value *VFMF = Builder.CreateFNegFMF(V, I);
547   Instruction *IFMF = cast<Instruction>(VFMF);
548   EXPECT_TRUE(IFMF->hasNoSignedZeros());
549   EXPECT_TRUE(IFMF->hasNoNaNs());
550   EXPECT_FALSE(IFMF->hasAllowReassoc());
551 }
552 
553 TEST_F(IRBuilderTest, FastMathFlags) {
554   IRBuilder<> Builder(BB);
555   Value *F, *FC;
556   Instruction *FDiv, *FAdd, *FCmp, *FCall, *FNeg, *FSub, *FMul, *FRem;
557 
558   F = Builder.CreateLoad(GV->getValueType(), GV);
559   F = Builder.CreateFAdd(F, F);
560 
561   EXPECT_FALSE(Builder.getFastMathFlags().any());
562   ASSERT_TRUE(isa<Instruction>(F));
563   FAdd = cast<Instruction>(F);
564   EXPECT_FALSE(FAdd->hasNoNaNs());
565 
566   FastMathFlags FMF;
567   Builder.setFastMathFlags(FMF);
568 
569   // By default, no flags are set.
570   F = Builder.CreateFAdd(F, F);
571   EXPECT_FALSE(Builder.getFastMathFlags().any());
572   ASSERT_TRUE(isa<Instruction>(F));
573   FAdd = cast<Instruction>(F);
574   EXPECT_FALSE(FAdd->hasNoNaNs());
575   EXPECT_FALSE(FAdd->hasNoInfs());
576   EXPECT_FALSE(FAdd->hasNoSignedZeros());
577   EXPECT_FALSE(FAdd->hasAllowReciprocal());
578   EXPECT_FALSE(FAdd->hasAllowContract());
579   EXPECT_FALSE(FAdd->hasAllowReassoc());
580   EXPECT_FALSE(FAdd->hasApproxFunc());
581 
582   // Set all flags in the instruction.
583   FAdd->setFast(true);
584   EXPECT_TRUE(FAdd->hasNoNaNs());
585   EXPECT_TRUE(FAdd->hasNoInfs());
586   EXPECT_TRUE(FAdd->hasNoSignedZeros());
587   EXPECT_TRUE(FAdd->hasAllowReciprocal());
588   EXPECT_TRUE(FAdd->hasAllowContract());
589   EXPECT_TRUE(FAdd->hasAllowReassoc());
590   EXPECT_TRUE(FAdd->hasApproxFunc());
591 
592   // All flags are set in the builder.
593   FMF.setFast();
594   Builder.setFastMathFlags(FMF);
595 
596   F = Builder.CreateFAdd(F, F);
597   EXPECT_TRUE(Builder.getFastMathFlags().any());
598   EXPECT_TRUE(Builder.getFastMathFlags().all());
599   ASSERT_TRUE(isa<Instruction>(F));
600   FAdd = cast<Instruction>(F);
601   EXPECT_TRUE(FAdd->hasNoNaNs());
602   EXPECT_TRUE(FAdd->isFast());
603 
604   // Now, try it with CreateBinOp
605   F = Builder.CreateBinOp(Instruction::FAdd, F, F);
606   EXPECT_TRUE(Builder.getFastMathFlags().any());
607   ASSERT_TRUE(isa<Instruction>(F));
608   FAdd = cast<Instruction>(F);
609   EXPECT_TRUE(FAdd->hasNoNaNs());
610   EXPECT_TRUE(FAdd->isFast());
611 
612   F = Builder.CreateFDiv(F, F);
613   EXPECT_TRUE(Builder.getFastMathFlags().all());
614   ASSERT_TRUE(isa<Instruction>(F));
615   FDiv = cast<Instruction>(F);
616   EXPECT_TRUE(FDiv->hasAllowReciprocal());
617 
618   // Clear all FMF in the builder.
619   Builder.clearFastMathFlags();
620 
621   F = Builder.CreateFDiv(F, F);
622   ASSERT_TRUE(isa<Instruction>(F));
623   FDiv = cast<Instruction>(F);
624   EXPECT_FALSE(FDiv->hasAllowReciprocal());
625 
626   // Try individual flags.
627   FMF.clear();
628   FMF.setAllowReciprocal();
629   Builder.setFastMathFlags(FMF);
630 
631   F = Builder.CreateFDiv(F, F);
632   EXPECT_TRUE(Builder.getFastMathFlags().any());
633   EXPECT_TRUE(Builder.getFastMathFlags().AllowReciprocal);
634   ASSERT_TRUE(isa<Instruction>(F));
635   FDiv = cast<Instruction>(F);
636   EXPECT_TRUE(FDiv->hasAllowReciprocal());
637 
638   Builder.clearFastMathFlags();
639 
640   FC = Builder.CreateFCmpOEQ(F, F);
641   ASSERT_TRUE(isa<Instruction>(FC));
642   FCmp = cast<Instruction>(FC);
643   EXPECT_FALSE(FCmp->hasAllowReciprocal());
644 
645   FMF.clear();
646   FMF.setAllowReciprocal();
647   Builder.setFastMathFlags(FMF);
648 
649   FC = Builder.CreateFCmpOEQ(F, F);
650   EXPECT_TRUE(Builder.getFastMathFlags().any());
651   EXPECT_TRUE(Builder.getFastMathFlags().AllowReciprocal);
652   ASSERT_TRUE(isa<Instruction>(FC));
653   FCmp = cast<Instruction>(FC);
654   EXPECT_TRUE(FCmp->hasAllowReciprocal());
655 
656   Builder.clearFastMathFlags();
657 
658   // Test FP-contract
659   FC = Builder.CreateFAdd(F, F);
660   ASSERT_TRUE(isa<Instruction>(FC));
661   FAdd = cast<Instruction>(FC);
662   EXPECT_FALSE(FAdd->hasAllowContract());
663 
664   FMF.clear();
665   FMF.setAllowContract(true);
666   Builder.setFastMathFlags(FMF);
667 
668   FC = Builder.CreateFAdd(F, F);
669   EXPECT_TRUE(Builder.getFastMathFlags().any());
670   EXPECT_TRUE(Builder.getFastMathFlags().AllowContract);
671   ASSERT_TRUE(isa<Instruction>(FC));
672   FAdd = cast<Instruction>(FC);
673   EXPECT_TRUE(FAdd->hasAllowContract());
674 
675   FMF.setApproxFunc();
676   Builder.clearFastMathFlags();
677   Builder.setFastMathFlags(FMF);
678   // Now 'aml' and 'contract' are set.
679   F = Builder.CreateFMul(F, F);
680   FAdd = cast<Instruction>(F);
681   EXPECT_TRUE(FAdd->hasApproxFunc());
682   EXPECT_TRUE(FAdd->hasAllowContract());
683   EXPECT_FALSE(FAdd->hasAllowReassoc());
684 
685   FMF.setAllowReassoc();
686   Builder.clearFastMathFlags();
687   Builder.setFastMathFlags(FMF);
688   // Now 'aml' and 'contract' and 'reassoc' are set.
689   F = Builder.CreateFMul(F, F);
690   FAdd = cast<Instruction>(F);
691   EXPECT_TRUE(FAdd->hasApproxFunc());
692   EXPECT_TRUE(FAdd->hasAllowContract());
693   EXPECT_TRUE(FAdd->hasAllowReassoc());
694 
695   // Test a call with FMF.
696   auto CalleeTy = FunctionType::get(Type::getFloatTy(Ctx),
697                                     /*isVarArg=*/false);
698   auto Callee =
699       Function::Create(CalleeTy, Function::ExternalLinkage, "", M.get());
700 
701   FCall = Builder.CreateCall(Callee, {});
702   EXPECT_FALSE(FCall->hasNoNaNs());
703 
704   Function *V =
705       Function::Create(CalleeTy, Function::ExternalLinkage, "", M.get());
706   FCall = Builder.CreateCall(V, {});
707   EXPECT_FALSE(FCall->hasNoNaNs());
708 
709   FMF.clear();
710   FMF.setNoNaNs();
711   Builder.setFastMathFlags(FMF);
712 
713   FCall = Builder.CreateCall(Callee, {});
714   EXPECT_TRUE(Builder.getFastMathFlags().any());
715   EXPECT_TRUE(Builder.getFastMathFlags().NoNaNs);
716   EXPECT_TRUE(FCall->hasNoNaNs());
717 
718   FCall = Builder.CreateCall(V, {});
719   EXPECT_TRUE(Builder.getFastMathFlags().any());
720   EXPECT_TRUE(Builder.getFastMathFlags().NoNaNs);
721   EXPECT_TRUE(FCall->hasNoNaNs());
722 
723   Builder.clearFastMathFlags();
724 
725   // To test a copy, make sure that a '0' and a '1' change state.
726   F = Builder.CreateFDiv(F, F);
727   ASSERT_TRUE(isa<Instruction>(F));
728   FDiv = cast<Instruction>(F);
729   EXPECT_FALSE(FDiv->getFastMathFlags().any());
730   FDiv->setHasAllowReciprocal(true);
731   FAdd->setHasAllowReciprocal(false);
732   FAdd->setHasNoNaNs(true);
733   FDiv->copyFastMathFlags(FAdd);
734   EXPECT_TRUE(FDiv->hasNoNaNs());
735   EXPECT_FALSE(FDiv->hasAllowReciprocal());
736 
737   // Test that CreateF*FMF functions copy flags from the source instruction
738   // instead of using the builder default.
739   Instruction *const FMFSource = FAdd;
740   EXPECT_FALSE(Builder.getFastMathFlags().noNaNs());
741   EXPECT_TRUE(FMFSource->hasNoNaNs());
742 
743   F = Builder.CreateFNegFMF(F, FMFSource);
744   ASSERT_TRUE(isa<Instruction>(F));
745   FNeg = cast<Instruction>(F);
746   EXPECT_TRUE(FNeg->hasNoNaNs());
747   F = Builder.CreateFAddFMF(F, F, FMFSource);
748   ASSERT_TRUE(isa<Instruction>(F));
749   FAdd = cast<Instruction>(F);
750   EXPECT_TRUE(FAdd->hasNoNaNs());
751   F = Builder.CreateFSubFMF(F, F, FMFSource);
752   ASSERT_TRUE(isa<Instruction>(F));
753   FSub = cast<Instruction>(F);
754   EXPECT_TRUE(FSub->hasNoNaNs());
755   F = Builder.CreateFMulFMF(F, F, FMFSource);
756   ASSERT_TRUE(isa<Instruction>(F));
757   FMul = cast<Instruction>(F);
758   EXPECT_TRUE(FMul->hasNoNaNs());
759   F = Builder.CreateFDivFMF(F, F, FMFSource);
760   ASSERT_TRUE(isa<Instruction>(F));
761   FDiv = cast<Instruction>(F);
762   EXPECT_TRUE(FDiv->hasNoNaNs());
763   F = Builder.CreateFRemFMF(F, F, FMFSource);
764   ASSERT_TRUE(isa<Instruction>(F));
765   FRem = cast<Instruction>(F);
766   EXPECT_TRUE(FRem->hasNoNaNs());
767 }
768 
769 TEST_F(IRBuilderTest, WrapFlags) {
770   IRBuilder<NoFolder> Builder(BB);
771 
772   // Test instructions.
773   GlobalVariable *G = new GlobalVariable(*M, Builder.getInt32Ty(), true,
774                                          GlobalValue::ExternalLinkage, nullptr);
775   Value *V = Builder.CreateLoad(G->getValueType(), G);
776   EXPECT_TRUE(
777       cast<BinaryOperator>(Builder.CreateNSWAdd(V, V))->hasNoSignedWrap());
778   EXPECT_TRUE(
779       cast<BinaryOperator>(Builder.CreateNSWMul(V, V))->hasNoSignedWrap());
780   EXPECT_TRUE(
781       cast<BinaryOperator>(Builder.CreateNSWSub(V, V))->hasNoSignedWrap());
782   EXPECT_TRUE(cast<BinaryOperator>(
783                   Builder.CreateShl(V, V, "", /* NUW */ false, /* NSW */ true))
784                   ->hasNoSignedWrap());
785 
786   EXPECT_TRUE(
787       cast<BinaryOperator>(Builder.CreateNUWAdd(V, V))->hasNoUnsignedWrap());
788   EXPECT_TRUE(
789       cast<BinaryOperator>(Builder.CreateNUWMul(V, V))->hasNoUnsignedWrap());
790   EXPECT_TRUE(
791       cast<BinaryOperator>(Builder.CreateNUWSub(V, V))->hasNoUnsignedWrap());
792   EXPECT_TRUE(cast<BinaryOperator>(
793                   Builder.CreateShl(V, V, "", /* NUW */ true, /* NSW */ false))
794                   ->hasNoUnsignedWrap());
795 
796   // Test operators created with constants.
797   Constant *C = Builder.getInt32(42);
798   EXPECT_TRUE(cast<OverflowingBinaryOperator>(Builder.CreateNSWAdd(C, C))
799                   ->hasNoSignedWrap());
800   EXPECT_TRUE(cast<OverflowingBinaryOperator>(Builder.CreateNSWSub(C, C))
801                   ->hasNoSignedWrap());
802   EXPECT_TRUE(cast<OverflowingBinaryOperator>(Builder.CreateNSWMul(C, C))
803                   ->hasNoSignedWrap());
804   EXPECT_TRUE(cast<OverflowingBinaryOperator>(
805                   Builder.CreateShl(C, C, "", /* NUW */ false, /* NSW */ true))
806                   ->hasNoSignedWrap());
807 
808   EXPECT_TRUE(cast<OverflowingBinaryOperator>(Builder.CreateNUWAdd(C, C))
809                   ->hasNoUnsignedWrap());
810   EXPECT_TRUE(cast<OverflowingBinaryOperator>(Builder.CreateNUWSub(C, C))
811                   ->hasNoUnsignedWrap());
812   EXPECT_TRUE(cast<OverflowingBinaryOperator>(Builder.CreateNUWMul(C, C))
813                   ->hasNoUnsignedWrap());
814   EXPECT_TRUE(cast<OverflowingBinaryOperator>(
815                   Builder.CreateShl(C, C, "", /* NUW */ true, /* NSW */ false))
816                   ->hasNoUnsignedWrap());
817 }
818 
819 TEST_F(IRBuilderTest, RAIIHelpersTest) {
820   IRBuilder<> Builder(BB);
821   EXPECT_FALSE(Builder.getFastMathFlags().allowReciprocal());
822   MDBuilder MDB(M->getContext());
823 
824   MDNode *FPMathA = MDB.createFPMath(0.01f);
825   MDNode *FPMathB = MDB.createFPMath(0.1f);
826 
827   Builder.setDefaultFPMathTag(FPMathA);
828 
829   {
830     IRBuilder<>::FastMathFlagGuard Guard(Builder);
831     FastMathFlags FMF;
832     FMF.setAllowReciprocal();
833     Builder.setFastMathFlags(FMF);
834     Builder.setDefaultFPMathTag(FPMathB);
835     EXPECT_TRUE(Builder.getFastMathFlags().allowReciprocal());
836     EXPECT_EQ(FPMathB, Builder.getDefaultFPMathTag());
837   }
838 
839   EXPECT_FALSE(Builder.getFastMathFlags().allowReciprocal());
840   EXPECT_EQ(FPMathA, Builder.getDefaultFPMathTag());
841 
842   Value *F = Builder.CreateLoad(GV->getValueType(), GV);
843 
844   {
845     IRBuilder<>::InsertPointGuard Guard(Builder);
846     Builder.SetInsertPoint(cast<Instruction>(F));
847     EXPECT_EQ(F, &*Builder.GetInsertPoint());
848   }
849 
850   EXPECT_EQ(BB->end(), Builder.GetInsertPoint());
851   EXPECT_EQ(BB, Builder.GetInsertBlock());
852 }
853 
854 TEST_F(IRBuilderTest, createFunction) {
855   IRBuilder<> Builder(BB);
856   DIBuilder DIB(*M);
857   auto File = DIB.createFile("error.swift", "/");
858   auto CU =
859       DIB.createCompileUnit(dwarf::DW_LANG_Swift, File, "swiftc", true, "", 0);
860   auto Type = DIB.createSubroutineType(DIB.getOrCreateTypeArray({}));
861   auto NoErr = DIB.createFunction(
862       CU, "noerr", "", File, 1, Type, 1, DINode::FlagZero,
863       DISubprogram::SPFlagDefinition | DISubprogram::SPFlagOptimized);
864   EXPECT_TRUE(!NoErr->getThrownTypes());
865   auto Int = DIB.createBasicType("Int", 64, dwarf::DW_ATE_signed);
866   auto Error = DIB.getOrCreateArray({Int});
867   auto Err = DIB.createFunction(
868       CU, "err", "", File, 1, Type, 1, DINode::FlagZero,
869       DISubprogram::SPFlagDefinition | DISubprogram::SPFlagOptimized, nullptr,
870       nullptr, Error.get());
871   EXPECT_TRUE(Err->getThrownTypes().get() == Error.get());
872   DIB.finalize();
873 }
874 
875 TEST_F(IRBuilderTest, DIBuilder) {
876   auto GetLastDbgRecord = [](const Instruction *I) -> DbgRecord * {
877     if (I->getDbgRecordRange().empty())
878       return nullptr;
879     return &*std::prev(I->getDbgRecordRange().end());
880   };
881 
882   auto ExpectOrder = [&](DbgInstPtr First, BasicBlock::iterator Second) {
883     if (M->IsNewDbgInfoFormat) {
884       EXPECT_TRUE(isa<DbgRecord *>(First));
885       EXPECT_FALSE(Second->getDbgRecordRange().empty());
886       EXPECT_EQ(GetLastDbgRecord(&*Second), cast<DbgRecord *>(First));
887     } else {
888       EXPECT_TRUE(isa<Instruction *>(First));
889       EXPECT_EQ(&*std::prev(Second), cast<Instruction *>(First));
890     }
891   };
892 
893   auto RunTest = [&]() {
894     IRBuilder<> Builder(BB);
895     DIBuilder DIB(*M);
896     auto File = DIB.createFile("F.CBL", "/");
897     auto CU = DIB.createCompileUnit(dwarf::DW_LANG_Cobol74,
898                                     DIB.createFile("F.CBL", "/"),
899                                     "llvm-cobol74", true, "", 0);
900     auto Type = DIB.createSubroutineType(DIB.getOrCreateTypeArray({}));
901     auto SP = DIB.createFunction(
902         CU, "foo", "", File, 1, Type, 1, DINode::FlagZero,
903         DISubprogram::SPFlagDefinition | DISubprogram::SPFlagOptimized);
904     F->setSubprogram(SP);
905     AllocaInst *I = Builder.CreateAlloca(Builder.getInt8Ty());
906     auto BarSP = DIB.createFunction(
907         CU, "bar", "", File, 1, Type, 1, DINode::FlagZero,
908         DISubprogram::SPFlagDefinition | DISubprogram::SPFlagOptimized);
909     auto BarScope = DIB.createLexicalBlockFile(BarSP, File, 0);
910     I->setDebugLoc(DILocation::get(Ctx, 2, 0, BarScope));
911 
912     // Create another instruction so that there's one before the alloca we're
913     // inserting debug intrinsics before, to make end-checking easier.
914     I = Builder.CreateAlloca(Builder.getInt1Ty());
915 
916     // Label metadata and records
917     // --------------------------
918     DILocation *LabelLoc = DILocation::get(Ctx, 1, 0, BarScope);
919     DILabel *AlwaysPreserveLabel = DIB.createLabel(
920         BarScope, "meles_meles", File, 1, /*AlwaysPreserve*/ true);
921     DILabel *Label =
922         DIB.createLabel(BarScope, "badger", File, 1, /*AlwaysPreserve*/ false);
923 
924     { /* dbg.label | DbgLabelRecord */
925       // Insert before I and check order.
926       ExpectOrder(DIB.insertLabel(Label, LabelLoc, I), I->getIterator());
927 
928       // We should be able to insert at the end of the block, even if there's
929       // no terminator yet. Note that in RemoveDIs mode this record won't get
930       // inserted into the block untill another instruction is added.
931       DbgInstPtr LabelRecord = DIB.insertLabel(Label, LabelLoc, BB);
932       // Specifically do not insert a terminator, to check this works. `I`
933       // should have absorbed the DbgLabelRecord in the new debug info mode.
934       I = Builder.CreateAlloca(Builder.getInt32Ty());
935       ExpectOrder(LabelRecord, I->getIterator());
936     }
937 
938     // Variable metadata and records
939     // -----------------------------
940     DILocation *VarLoc = DILocation::get(Ctx, 2, 0, BarScope);
941     auto *IntType = DIB.createBasicType("int", 32, dwarf::DW_ATE_signed);
942     DILocalVariable *VarX =
943         DIB.createAutoVariable(BarSP, "X", File, 2, IntType, true);
944     DILocalVariable *VarY =
945         DIB.createAutoVariable(BarSP, "Y", File, 2, IntType, true);
946     { /* dbg.value | DbgVariableRecord::Value */
947       ExpectOrder(DIB.insertDbgValueIntrinsic(I, VarX, DIB.createExpression(),
948                                               VarLoc, I),
949                   I->getIterator());
950       // Check inserting at end of the block works as with labels.
951       DbgInstPtr VarXValue = DIB.insertDbgValueIntrinsic(
952           I, VarX, DIB.createExpression(), VarLoc, BB);
953       I = Builder.CreateAlloca(Builder.getInt32Ty());
954       ExpectOrder(VarXValue, I->getIterator());
955       EXPECT_EQ(BB->getTrailingDbgRecords(), nullptr);
956     }
957     { /* dbg.declare | DbgVariableRecord::Declare */
958       ExpectOrder(DIB.insertDeclare(I, VarY, DIB.createExpression(), VarLoc, I),
959                   I->getIterator());
960       // Check inserting at end of the block works as with labels.
961       DbgInstPtr VarYDeclare =
962           DIB.insertDeclare(I, VarY, DIB.createExpression(), VarLoc, BB);
963       I = Builder.CreateAlloca(Builder.getInt32Ty());
964       ExpectOrder(VarYDeclare, I->getIterator());
965       EXPECT_EQ(BB->getTrailingDbgRecords(), nullptr);
966     }
967     { /* dbg.assign | DbgVariableRecord::Assign */
968       I = Builder.CreateAlloca(Builder.getInt32Ty());
969       I->setMetadata(LLVMContext::MD_DIAssignID, DIAssignID::getDistinct(Ctx));
970       // DbgAssign interface is slightly different - it always inserts after the
971       // linked instr. Check we can do this with no instruction to insert
972       // before.
973       DbgInstPtr VarXAssign =
974           DIB.insertDbgAssign(I, I, VarX, DIB.createExpression(), I,
975                               DIB.createExpression(), VarLoc);
976       I = Builder.CreateAlloca(Builder.getInt32Ty());
977       ExpectOrder(VarXAssign, I->getIterator());
978       EXPECT_EQ(BB->getTrailingDbgRecords(), nullptr);
979     }
980 
981     Builder.CreateRet(nullptr);
982     DIB.finalize();
983     // Check the labels are not/are added to Bar's retainedNodes array
984     // (AlwaysPreserve).
985     EXPECT_EQ(find(BarSP->getRetainedNodes(), Label),
986               BarSP->getRetainedNodes().end());
987     EXPECT_NE(find(BarSP->getRetainedNodes(), AlwaysPreserveLabel),
988               BarSP->getRetainedNodes().end());
989     EXPECT_NE(find(BarSP->getRetainedNodes(), VarX),
990               BarSP->getRetainedNodes().end());
991     EXPECT_NE(find(BarSP->getRetainedNodes(), VarY),
992               BarSP->getRetainedNodes().end());
993     EXPECT_TRUE(verifyModule(*M));
994   };
995 
996   // Test in new-debug mode.
997   EXPECT_TRUE(M->IsNewDbgInfoFormat);
998   RunTest();
999 
1000   // Test in old-debug mode.
1001   // Reset the test then call convertFromNewDbgValues to flip the flag
1002   // on the test's Module, Function and BasicBlock.
1003   TearDown();
1004   SetUp();
1005   M->convertFromNewDbgValues();
1006   EXPECT_FALSE(M->IsNewDbgInfoFormat);
1007   RunTest();
1008 }
1009 
1010 TEST_F(IRBuilderTest, createArtificialSubprogram) {
1011   IRBuilder<> Builder(BB);
1012   DIBuilder DIB(*M);
1013   auto File = DIB.createFile("main.c", "/");
1014   auto CU = DIB.createCompileUnit(dwarf::DW_LANG_C, File, "clang",
1015                                   /*isOptimized=*/true, /*Flags=*/"",
1016                                   /*Runtime Version=*/0);
1017   auto Type = DIB.createSubroutineType(DIB.getOrCreateTypeArray({}));
1018   auto SP = DIB.createFunction(
1019       CU, "foo", /*LinkageName=*/"", File,
1020       /*LineNo=*/1, Type, /*ScopeLine=*/2, DINode::FlagZero,
1021       DISubprogram::SPFlagDefinition | DISubprogram::SPFlagOptimized);
1022   EXPECT_TRUE(SP->isDistinct());
1023 
1024   F->setSubprogram(SP);
1025   AllocaInst *I = Builder.CreateAlloca(Builder.getInt8Ty());
1026   ReturnInst *R = Builder.CreateRetVoid();
1027   I->setDebugLoc(DILocation::get(Ctx, 3, 2, SP));
1028   R->setDebugLoc(DILocation::get(Ctx, 4, 2, SP));
1029   DIB.finalize();
1030   EXPECT_FALSE(verifyModule(*M));
1031 
1032   Function *G = Function::Create(F->getFunctionType(),
1033                                  Function::ExternalLinkage, "", M.get());
1034   BasicBlock *GBB = BasicBlock::Create(Ctx, "", G);
1035   Builder.SetInsertPoint(GBB);
1036   I->removeFromParent();
1037   Builder.Insert(I);
1038   Builder.CreateRetVoid();
1039   EXPECT_FALSE(verifyModule(*M));
1040 
1041   DISubprogram *GSP = DIBuilder::createArtificialSubprogram(F->getSubprogram());
1042   EXPECT_EQ(SP->getFile(), GSP->getFile());
1043   EXPECT_EQ(SP->getType(), GSP->getType());
1044   EXPECT_EQ(SP->getLine(), GSP->getLine());
1045   EXPECT_EQ(SP->getScopeLine(), GSP->getScopeLine());
1046   EXPECT_TRUE(GSP->isDistinct());
1047 
1048   G->setSubprogram(GSP);
1049   EXPECT_TRUE(verifyModule(*M));
1050 
1051   auto *InlinedAtNode =
1052       DILocation::getDistinct(Ctx, GSP->getScopeLine(), 0, GSP);
1053   DebugLoc DL = I->getDebugLoc();
1054   DenseMap<const MDNode *, MDNode *> IANodes;
1055   auto IA = DebugLoc::appendInlinedAt(DL, InlinedAtNode, Ctx, IANodes);
1056   auto NewDL =
1057       DILocation::get(Ctx, DL.getLine(), DL.getCol(), DL.getScope(), IA);
1058   I->setDebugLoc(NewDL);
1059   EXPECT_FALSE(verifyModule(*M));
1060 
1061   EXPECT_EQ("foo", SP->getName());
1062   EXPECT_EQ("foo", GSP->getName());
1063   EXPECT_FALSE(SP->isArtificial());
1064   EXPECT_TRUE(GSP->isArtificial());
1065 }
1066 
1067 // Check that we can add debug info to an existing DICompileUnit.
1068 TEST_F(IRBuilderTest, appendDebugInfo) {
1069   IRBuilder<> Builder(BB);
1070   Builder.CreateRetVoid();
1071   EXPECT_FALSE(verifyModule(*M));
1072 
1073   auto GetNames = [](DICompileUnit *CU) {
1074     SmallVector<StringRef> Names;
1075     for (auto *ET : CU->getEnumTypes())
1076       Names.push_back(ET->getName());
1077     for (auto *RT : CU->getRetainedTypes())
1078       Names.push_back(RT->getName());
1079     for (auto *GV : CU->getGlobalVariables())
1080       Names.push_back(GV->getVariable()->getName());
1081     for (auto *IE : CU->getImportedEntities())
1082       Names.push_back(IE->getName());
1083     for (auto *Node : CU->getMacros())
1084       if (auto *MN = dyn_cast_or_null<DIMacro>(Node))
1085         Names.push_back(MN->getName());
1086     return Names;
1087   };
1088 
1089   DICompileUnit *CU;
1090   {
1091     DIBuilder DIB(*M);
1092     auto *File = DIB.createFile("main.c", "/");
1093     CU = DIB.createCompileUnit(dwarf::DW_LANG_C, File, "clang",
1094                                /*isOptimized=*/true, /*Flags=*/"",
1095                                /*Runtime Version=*/0);
1096     auto *ByteTy = DIB.createBasicType("byte0", 8, dwarf::DW_ATE_signed);
1097     DIB.createEnumerationType(CU, "ET0", File, /*LineNo=*/0, /*SizeInBits=*/8,
1098                               /*AlignInBits=*/8, /*Elements=*/{}, ByteTy);
1099     DIB.retainType(ByteTy);
1100     DIB.createGlobalVariableExpression(CU, "GV0", /*LinkageName=*/"", File,
1101                                        /*LineNo=*/1, ByteTy,
1102                                        /*IsLocalToUnit=*/true);
1103     DIB.createImportedDeclaration(CU, nullptr, File, /*LineNo=*/2, "IM0");
1104     DIB.createMacro(nullptr, /*LineNo=*/0, dwarf::DW_MACINFO_define, "M0");
1105     DIB.finalize();
1106   }
1107   EXPECT_FALSE(verifyModule(*M));
1108   EXPECT_THAT(GetNames(CU),
1109               UnorderedElementsAre("ET0", "byte0", "GV0", "IM0", "M0"));
1110 
1111   {
1112     DIBuilder DIB(*M, true, CU);
1113     auto *File = CU->getFile();
1114     auto *ByteTy = DIB.createBasicType("byte1", 8, dwarf::DW_ATE_signed);
1115     DIB.createEnumerationType(CU, "ET1", File, /*LineNo=*/0,
1116                               /*SizeInBits=*/8, /*AlignInBits=*/8,
1117                               /*Elements=*/{}, ByteTy);
1118     DIB.retainType(ByteTy);
1119     DIB.createGlobalVariableExpression(CU, "GV1", /*LinkageName=*/"", File,
1120                                        /*LineNo=*/1, ByteTy,
1121                                        /*IsLocalToUnit=*/true);
1122     DIB.createImportedDeclaration(CU, nullptr, File, /*LineNo=*/2, "IM1");
1123     DIB.createMacro(nullptr, /*LineNo=*/0, dwarf::DW_MACINFO_define, "M1");
1124     DIB.finalize();
1125   }
1126   EXPECT_FALSE(verifyModule(*M));
1127   EXPECT_THAT(GetNames(CU),
1128               UnorderedElementsAre("ET0", "byte0", "GV0", "IM0", "M0", "ET1",
1129                                    "byte1", "GV1", "IM1", "M1"));
1130 }
1131 
1132 TEST_F(IRBuilderTest, InsertExtractElement) {
1133   IRBuilder<> Builder(BB);
1134 
1135   auto VecTy = FixedVectorType::get(Builder.getInt64Ty(), 4);
1136   auto Elt1 = Builder.getInt64(-1);
1137   auto Elt2 = Builder.getInt64(-2);
1138   Value *Vec = Builder.CreateInsertElement(VecTy, Elt1, Builder.getInt8(1));
1139   Vec = Builder.CreateInsertElement(Vec, Elt2, 2);
1140   auto X1 = Builder.CreateExtractElement(Vec, 1);
1141   auto X2 = Builder.CreateExtractElement(Vec, Builder.getInt32(2));
1142   EXPECT_EQ(Elt1, X1);
1143   EXPECT_EQ(Elt2, X2);
1144 }
1145 
1146 TEST_F(IRBuilderTest, CreateGlobalString) {
1147   IRBuilder<> Builder(BB);
1148 
1149   auto String1a = Builder.CreateGlobalString("TestString", "String1a");
1150   auto String1b = Builder.CreateGlobalString("TestString", "String1b", 0);
1151   auto String2 = Builder.CreateGlobalString("TestString", "String2", 1);
1152   auto String3 = Builder.CreateGlobalString("TestString", "String3", 2);
1153 
1154   EXPECT_TRUE(String1a->getType()->getPointerAddressSpace() == 0);
1155   EXPECT_TRUE(String1b->getType()->getPointerAddressSpace() == 0);
1156   EXPECT_TRUE(String2->getType()->getPointerAddressSpace() == 1);
1157   EXPECT_TRUE(String3->getType()->getPointerAddressSpace() == 2);
1158 }
1159 
1160 TEST_F(IRBuilderTest, DebugLoc) {
1161   auto CalleeTy = FunctionType::get(Type::getVoidTy(Ctx),
1162                                     /*isVarArg=*/false);
1163   auto Callee =
1164       Function::Create(CalleeTy, Function::ExternalLinkage, "", M.get());
1165 
1166   DIBuilder DIB(*M);
1167   auto File = DIB.createFile("tmp.cpp", "/");
1168   auto CU = DIB.createCompileUnit(dwarf::DW_LANG_C_plus_plus_11,
1169                                   DIB.createFile("tmp.cpp", "/"), "", true, "",
1170                                   0);
1171   auto SPType = DIB.createSubroutineType(DIB.getOrCreateTypeArray({}));
1172   auto SP =
1173       DIB.createFunction(CU, "foo", "foo", File, 1, SPType, 1, DINode::FlagZero,
1174                          DISubprogram::SPFlagDefinition);
1175   DebugLoc DL1 = DILocation::get(Ctx, 2, 0, SP);
1176   DebugLoc DL2 = DILocation::get(Ctx, 3, 0, SP);
1177 
1178   auto BB2 = BasicBlock::Create(Ctx, "bb2", F);
1179   auto Br = BranchInst::Create(BB2, BB);
1180   Br->setDebugLoc(DL1);
1181 
1182   IRBuilder<> Builder(Ctx);
1183   Builder.SetInsertPoint(Br);
1184   EXPECT_EQ(DL1, Builder.getCurrentDebugLocation());
1185   auto Call1 = Builder.CreateCall(Callee, {});
1186   EXPECT_EQ(DL1, Call1->getDebugLoc());
1187 
1188   Call1->setDebugLoc(DL2);
1189   Builder.SetInsertPoint(Call1->getParent(), Call1->getIterator());
1190   EXPECT_EQ(DL2, Builder.getCurrentDebugLocation());
1191   auto Call2 = Builder.CreateCall(Callee, {});
1192   EXPECT_EQ(DL2, Call2->getDebugLoc());
1193 
1194   DIB.finalize();
1195 }
1196 
1197 TEST_F(IRBuilderTest, DIImportedEntity) {
1198   IRBuilder<> Builder(BB);
1199   DIBuilder DIB(*M);
1200   auto F = DIB.createFile("F.CBL", "/");
1201   auto CU = DIB.createCompileUnit(dwarf::DW_LANG_Cobol74,
1202                                   F, "llvm-cobol74",
1203                                   true, "", 0);
1204   MDTuple *Elements = MDTuple::getDistinct(Ctx, {});
1205 
1206   DIB.createImportedDeclaration(CU, nullptr, F, 1);
1207   DIB.createImportedDeclaration(CU, nullptr, F, 1);
1208   DIB.createImportedModule(CU, (DIImportedEntity *)nullptr, F, 2);
1209   DIB.createImportedModule(CU, (DIImportedEntity *)nullptr, F, 2);
1210   DIB.createImportedModule(CU, (DIImportedEntity *)nullptr, F, 2, Elements);
1211   DIB.createImportedModule(CU, (DIImportedEntity *)nullptr, F, 2, Elements);
1212   DIB.finalize();
1213   EXPECT_TRUE(verifyModule(*M));
1214   EXPECT_TRUE(CU->getImportedEntities().size() == 3);
1215 }
1216 
1217 //  0: #define M0 V0          <-- command line definition
1218 //  0: main.c                 <-- main file
1219 //     3:   #define M1 V1     <-- M1 definition in main.c
1220 //     5:   #include "file.h" <-- inclusion of file.h from main.c
1221 //          1: #define M2     <-- M2 definition in file.h with no value
1222 //     7:   #undef M1 V1      <-- M1 un-definition in main.c
1223 TEST_F(IRBuilderTest, DIBuilderMacro) {
1224   IRBuilder<> Builder(BB);
1225   DIBuilder DIB(*M);
1226   auto File1 = DIB.createFile("main.c", "/");
1227   auto File2 = DIB.createFile("file.h", "/");
1228   auto CU = DIB.createCompileUnit(
1229       dwarf::DW_LANG_C, DIB.createFile("main.c", "/"), "llvm-c", true, "", 0);
1230   auto MDef0 =
1231       DIB.createMacro(nullptr, 0, dwarf::DW_MACINFO_define, "M0", "V0");
1232   auto TMF1 = DIB.createTempMacroFile(nullptr, 0, File1);
1233   auto MDef1 = DIB.createMacro(TMF1, 3, dwarf::DW_MACINFO_define, "M1", "V1");
1234   auto TMF2 = DIB.createTempMacroFile(TMF1, 5, File2);
1235   auto MDef2 = DIB.createMacro(TMF2, 1, dwarf::DW_MACINFO_define, "M2");
1236   auto MUndef1 = DIB.createMacro(TMF1, 7, dwarf::DW_MACINFO_undef, "M1");
1237 
1238   EXPECT_EQ(dwarf::DW_MACINFO_define, MDef1->getMacinfoType());
1239   EXPECT_EQ(3u, MDef1->getLine());
1240   EXPECT_EQ("M1", MDef1->getName());
1241   EXPECT_EQ("V1", MDef1->getValue());
1242 
1243   EXPECT_EQ(dwarf::DW_MACINFO_undef, MUndef1->getMacinfoType());
1244   EXPECT_EQ(7u, MUndef1->getLine());
1245   EXPECT_EQ("M1", MUndef1->getName());
1246   EXPECT_EQ("", MUndef1->getValue());
1247 
1248   EXPECT_EQ(dwarf::DW_MACINFO_start_file, TMF2->getMacinfoType());
1249   EXPECT_EQ(5u, TMF2->getLine());
1250   EXPECT_EQ(File2, TMF2->getFile());
1251 
1252   DIB.finalize();
1253 
1254   SmallVector<Metadata *, 4> Elements;
1255   Elements.push_back(MDef2);
1256   auto MF2 = DIMacroFile::get(Ctx, dwarf::DW_MACINFO_start_file, 5, File2,
1257                               DIB.getOrCreateMacroArray(Elements));
1258 
1259   Elements.clear();
1260   Elements.push_back(MDef1);
1261   Elements.push_back(MF2);
1262   Elements.push_back(MUndef1);
1263   auto MF1 = DIMacroFile::get(Ctx, dwarf::DW_MACINFO_start_file, 0, File1,
1264                               DIB.getOrCreateMacroArray(Elements));
1265 
1266   Elements.clear();
1267   Elements.push_back(MDef0);
1268   Elements.push_back(MF1);
1269   auto MN0 = MDTuple::get(Ctx, Elements);
1270   EXPECT_EQ(MN0, CU->getRawMacros());
1271 
1272   Elements.clear();
1273   Elements.push_back(MDef1);
1274   Elements.push_back(MF2);
1275   Elements.push_back(MUndef1);
1276   auto MN1 = MDTuple::get(Ctx, Elements);
1277   EXPECT_EQ(MN1, MF1->getRawElements());
1278 
1279   Elements.clear();
1280   Elements.push_back(MDef2);
1281   auto MN2 = MDTuple::get(Ctx, Elements);
1282   EXPECT_EQ(MN2, MF2->getRawElements());
1283   EXPECT_TRUE(verifyModule(*M));
1284 }
1285 
1286 TEST_F(IRBuilderTest, NoFolderNames) {
1287   IRBuilder<NoFolder> Builder(BB);
1288   auto *Add =
1289       Builder.CreateAdd(Builder.getInt32(1), Builder.getInt32(2), "add");
1290   EXPECT_EQ(Add->getName(), "add");
1291 }
1292 
1293 TEST_F(IRBuilderTest, CTAD) {
1294   struct TestInserter : public IRBuilderDefaultInserter {
1295     TestInserter() = default;
1296   };
1297   InstSimplifyFolder Folder(M->getDataLayout());
1298 
1299   IRBuilder Builder1(Ctx, Folder, TestInserter());
1300   static_assert(std::is_same_v<decltype(Builder1),
1301                                IRBuilder<InstSimplifyFolder, TestInserter>>);
1302   IRBuilder Builder2(Ctx);
1303   static_assert(std::is_same_v<decltype(Builder2), IRBuilder<>>);
1304   IRBuilder Builder3(BB, Folder);
1305   static_assert(
1306       std::is_same_v<decltype(Builder3), IRBuilder<InstSimplifyFolder>>);
1307   IRBuilder Builder4(BB);
1308   static_assert(std::is_same_v<decltype(Builder4), IRBuilder<>>);
1309   // The block BB is empty, so don't test this one.
1310   // IRBuilder Builder5(BB->getTerminator());
1311   // static_assert(std::is_same_v<decltype(Builder5), IRBuilder<>>);
1312   IRBuilder Builder6(BB, BB->end(), Folder);
1313   static_assert(
1314       std::is_same_v<decltype(Builder6), IRBuilder<InstSimplifyFolder>>);
1315   IRBuilder Builder7(BB, BB->end());
1316   static_assert(std::is_same_v<decltype(Builder7), IRBuilder<>>);
1317 }
1318 }
1319