1 //===- Instructions.cpp - Implement the LLVM instructions -----------------===//
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 all of the non-inline methods for the LLVM instruction
10 // classes.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "llvm/IR/Instructions.h"
15 #include "LLVMContextImpl.h"
16 #include "llvm/ADT/None.h"
17 #include "llvm/ADT/SmallVector.h"
18 #include "llvm/ADT/Twine.h"
19 #include "llvm/IR/Attributes.h"
20 #include "llvm/IR/BasicBlock.h"
21 #include "llvm/IR/CallSite.h"
22 #include "llvm/IR/Constant.h"
23 #include "llvm/IR/Constants.h"
24 #include "llvm/IR/DataLayout.h"
25 #include "llvm/IR/DerivedTypes.h"
26 #include "llvm/IR/Function.h"
27 #include "llvm/IR/InstrTypes.h"
28 #include "llvm/IR/Instruction.h"
29 #include "llvm/IR/Intrinsics.h"
30 #include "llvm/IR/LLVMContext.h"
31 #include "llvm/IR/MDBuilder.h"
32 #include "llvm/IR/Metadata.h"
33 #include "llvm/IR/Module.h"
34 #include "llvm/IR/Operator.h"
35 #include "llvm/IR/Type.h"
36 #include "llvm/IR/Value.h"
37 #include "llvm/Support/AtomicOrdering.h"
38 #include "llvm/Support/Casting.h"
39 #include "llvm/Support/ErrorHandling.h"
40 #include "llvm/Support/MathExtras.h"
41 #include "llvm/Support/TypeSize.h"
42 #include <algorithm>
43 #include <cassert>
44 #include <cstdint>
45 #include <vector>
46 
47 using namespace llvm;
48 
49 //===----------------------------------------------------------------------===//
50 //                            AllocaInst Class
51 //===----------------------------------------------------------------------===//
52 
53 Optional<uint64_t>
54 AllocaInst::getAllocationSizeInBits(const DataLayout &DL) const {
55   uint64_t Size = DL.getTypeAllocSizeInBits(getAllocatedType());
56   if (isArrayAllocation()) {
57     auto C = dyn_cast<ConstantInt>(getArraySize());
58     if (!C)
59       return None;
60     Size *= C->getZExtValue();
61   }
62   return Size;
63 }
64 
65 //===----------------------------------------------------------------------===//
66 //                            CallSite Class
67 //===----------------------------------------------------------------------===//
68 
69 User::op_iterator CallSite::getCallee() const {
70   return cast<CallBase>(getInstruction())->op_end() - 1;
71 }
72 
73 //===----------------------------------------------------------------------===//
74 //                              SelectInst Class
75 //===----------------------------------------------------------------------===//
76 
77 /// areInvalidOperands - Return a string if the specified operands are invalid
78 /// for a select operation, otherwise return null.
79 const char *SelectInst::areInvalidOperands(Value *Op0, Value *Op1, Value *Op2) {
80   if (Op1->getType() != Op2->getType())
81     return "both values to select must have same type";
82 
83   if (Op1->getType()->isTokenTy())
84     return "select values cannot have token type";
85 
86   if (VectorType *VT = dyn_cast<VectorType>(Op0->getType())) {
87     // Vector select.
88     if (VT->getElementType() != Type::getInt1Ty(Op0->getContext()))
89       return "vector select condition element type must be i1";
90     VectorType *ET = dyn_cast<VectorType>(Op1->getType());
91     if (!ET)
92       return "selected values for vector select must be vectors";
93     if (ET->getNumElements() != VT->getNumElements())
94       return "vector select requires selected vectors to have "
95                    "the same vector length as select condition";
96   } else if (Op0->getType() != Type::getInt1Ty(Op0->getContext())) {
97     return "select condition must be i1 or <n x i1>";
98   }
99   return nullptr;
100 }
101 
102 //===----------------------------------------------------------------------===//
103 //                               PHINode Class
104 //===----------------------------------------------------------------------===//
105 
106 PHINode::PHINode(const PHINode &PN)
107     : Instruction(PN.getType(), Instruction::PHI, nullptr, PN.getNumOperands()),
108       ReservedSpace(PN.getNumOperands()) {
109   allocHungoffUses(PN.getNumOperands());
110   std::copy(PN.op_begin(), PN.op_end(), op_begin());
111   std::copy(PN.block_begin(), PN.block_end(), block_begin());
112   SubclassOptionalData = PN.SubclassOptionalData;
113 }
114 
115 // removeIncomingValue - Remove an incoming value.  This is useful if a
116 // predecessor basic block is deleted.
117 Value *PHINode::removeIncomingValue(unsigned Idx, bool DeletePHIIfEmpty) {
118   Value *Removed = getIncomingValue(Idx);
119 
120   // Move everything after this operand down.
121   //
122   // FIXME: we could just swap with the end of the list, then erase.  However,
123   // clients might not expect this to happen.  The code as it is thrashes the
124   // use/def lists, which is kinda lame.
125   std::copy(op_begin() + Idx + 1, op_end(), op_begin() + Idx);
126   std::copy(block_begin() + Idx + 1, block_end(), block_begin() + Idx);
127 
128   // Nuke the last value.
129   Op<-1>().set(nullptr);
130   setNumHungOffUseOperands(getNumOperands() - 1);
131 
132   // If the PHI node is dead, because it has zero entries, nuke it now.
133   if (getNumOperands() == 0 && DeletePHIIfEmpty) {
134     // If anyone is using this PHI, make them use a dummy value instead...
135     replaceAllUsesWith(UndefValue::get(getType()));
136     eraseFromParent();
137   }
138   return Removed;
139 }
140 
141 /// growOperands - grow operands - This grows the operand list in response
142 /// to a push_back style of operation.  This grows the number of ops by 1.5
143 /// times.
144 ///
145 void PHINode::growOperands() {
146   unsigned e = getNumOperands();
147   unsigned NumOps = e + e / 2;
148   if (NumOps < 2) NumOps = 2;      // 2 op PHI nodes are VERY common.
149 
150   ReservedSpace = NumOps;
151   growHungoffUses(ReservedSpace, /* IsPhi */ true);
152 }
153 
154 /// hasConstantValue - If the specified PHI node always merges together the same
155 /// value, return the value, otherwise return null.
156 Value *PHINode::hasConstantValue() const {
157   // Exploit the fact that phi nodes always have at least one entry.
158   Value *ConstantValue = getIncomingValue(0);
159   for (unsigned i = 1, e = getNumIncomingValues(); i != e; ++i)
160     if (getIncomingValue(i) != ConstantValue && getIncomingValue(i) != this) {
161       if (ConstantValue != this)
162         return nullptr; // Incoming values not all the same.
163        // The case where the first value is this PHI.
164       ConstantValue = getIncomingValue(i);
165     }
166   if (ConstantValue == this)
167     return UndefValue::get(getType());
168   return ConstantValue;
169 }
170 
171 /// hasConstantOrUndefValue - Whether the specified PHI node always merges
172 /// together the same value, assuming that undefs result in the same value as
173 /// non-undefs.
174 /// Unlike \ref hasConstantValue, this does not return a value because the
175 /// unique non-undef incoming value need not dominate the PHI node.
176 bool PHINode::hasConstantOrUndefValue() const {
177   Value *ConstantValue = nullptr;
178   for (unsigned i = 0, e = getNumIncomingValues(); i != e; ++i) {
179     Value *Incoming = getIncomingValue(i);
180     if (Incoming != this && !isa<UndefValue>(Incoming)) {
181       if (ConstantValue && ConstantValue != Incoming)
182         return false;
183       ConstantValue = Incoming;
184     }
185   }
186   return true;
187 }
188 
189 //===----------------------------------------------------------------------===//
190 //                       LandingPadInst Implementation
191 //===----------------------------------------------------------------------===//
192 
193 LandingPadInst::LandingPadInst(Type *RetTy, unsigned NumReservedValues,
194                                const Twine &NameStr, Instruction *InsertBefore)
195     : Instruction(RetTy, Instruction::LandingPad, nullptr, 0, InsertBefore) {
196   init(NumReservedValues, NameStr);
197 }
198 
199 LandingPadInst::LandingPadInst(Type *RetTy, unsigned NumReservedValues,
200                                const Twine &NameStr, BasicBlock *InsertAtEnd)
201     : Instruction(RetTy, Instruction::LandingPad, nullptr, 0, InsertAtEnd) {
202   init(NumReservedValues, NameStr);
203 }
204 
205 LandingPadInst::LandingPadInst(const LandingPadInst &LP)
206     : Instruction(LP.getType(), Instruction::LandingPad, nullptr,
207                   LP.getNumOperands()),
208       ReservedSpace(LP.getNumOperands()) {
209   allocHungoffUses(LP.getNumOperands());
210   Use *OL = getOperandList();
211   const Use *InOL = LP.getOperandList();
212   for (unsigned I = 0, E = ReservedSpace; I != E; ++I)
213     OL[I] = InOL[I];
214 
215   setCleanup(LP.isCleanup());
216 }
217 
218 LandingPadInst *LandingPadInst::Create(Type *RetTy, unsigned NumReservedClauses,
219                                        const Twine &NameStr,
220                                        Instruction *InsertBefore) {
221   return new LandingPadInst(RetTy, NumReservedClauses, NameStr, InsertBefore);
222 }
223 
224 LandingPadInst *LandingPadInst::Create(Type *RetTy, unsigned NumReservedClauses,
225                                        const Twine &NameStr,
226                                        BasicBlock *InsertAtEnd) {
227   return new LandingPadInst(RetTy, NumReservedClauses, NameStr, InsertAtEnd);
228 }
229 
230 void LandingPadInst::init(unsigned NumReservedValues, const Twine &NameStr) {
231   ReservedSpace = NumReservedValues;
232   setNumHungOffUseOperands(0);
233   allocHungoffUses(ReservedSpace);
234   setName(NameStr);
235   setCleanup(false);
236 }
237 
238 /// growOperands - grow operands - This grows the operand list in response to a
239 /// push_back style of operation. This grows the number of ops by 2 times.
240 void LandingPadInst::growOperands(unsigned Size) {
241   unsigned e = getNumOperands();
242   if (ReservedSpace >= e + Size) return;
243   ReservedSpace = (std::max(e, 1U) + Size / 2) * 2;
244   growHungoffUses(ReservedSpace);
245 }
246 
247 void LandingPadInst::addClause(Constant *Val) {
248   unsigned OpNo = getNumOperands();
249   growOperands(1);
250   assert(OpNo < ReservedSpace && "Growing didn't work!");
251   setNumHungOffUseOperands(getNumOperands() + 1);
252   getOperandList()[OpNo] = Val;
253 }
254 
255 //===----------------------------------------------------------------------===//
256 //                        CallBase Implementation
257 //===----------------------------------------------------------------------===//
258 
259 Function *CallBase::getCaller() { return getParent()->getParent(); }
260 
261 unsigned CallBase::getNumSubclassExtraOperandsDynamic() const {
262   assert(getOpcode() == Instruction::CallBr && "Unexpected opcode!");
263   return cast<CallBrInst>(this)->getNumIndirectDests() + 1;
264 }
265 
266 bool CallBase::isIndirectCall() const {
267   const Value *V = getCalledValue();
268   if (isa<Function>(V) || isa<Constant>(V))
269     return false;
270   if (const CallInst *CI = dyn_cast<CallInst>(this))
271     if (CI->isInlineAsm())
272       return false;
273   return true;
274 }
275 
276 /// Tests if this call site must be tail call optimized. Only a CallInst can
277 /// be tail call optimized.
278 bool CallBase::isMustTailCall() const {
279   if (auto *CI = dyn_cast<CallInst>(this))
280     return CI->isMustTailCall();
281   return false;
282 }
283 
284 /// Tests if this call site is marked as a tail call.
285 bool CallBase::isTailCall() const {
286   if (auto *CI = dyn_cast<CallInst>(this))
287     return CI->isTailCall();
288   return false;
289 }
290 
291 Intrinsic::ID CallBase::getIntrinsicID() const {
292   if (auto *F = getCalledFunction())
293     return F->getIntrinsicID();
294   return Intrinsic::not_intrinsic;
295 }
296 
297 bool CallBase::isReturnNonNull() const {
298   if (hasRetAttr(Attribute::NonNull))
299     return true;
300 
301   if (getDereferenceableBytes(AttributeList::ReturnIndex) > 0 &&
302            !NullPointerIsDefined(getCaller(),
303                                  getType()->getPointerAddressSpace()))
304     return true;
305 
306   return false;
307 }
308 
309 Value *CallBase::getReturnedArgOperand() const {
310   unsigned Index;
311 
312   if (Attrs.hasAttrSomewhere(Attribute::Returned, &Index) && Index)
313     return getArgOperand(Index - AttributeList::FirstArgIndex);
314   if (const Function *F = getCalledFunction())
315     if (F->getAttributes().hasAttrSomewhere(Attribute::Returned, &Index) &&
316         Index)
317       return getArgOperand(Index - AttributeList::FirstArgIndex);
318 
319   return nullptr;
320 }
321 
322 bool CallBase::hasRetAttr(Attribute::AttrKind Kind) const {
323   if (Attrs.hasAttribute(AttributeList::ReturnIndex, Kind))
324     return true;
325 
326   // Look at the callee, if available.
327   if (const Function *F = getCalledFunction())
328     return F->getAttributes().hasAttribute(AttributeList::ReturnIndex, Kind);
329   return false;
330 }
331 
332 /// Determine whether the argument or parameter has the given attribute.
333 bool CallBase::paramHasAttr(unsigned ArgNo, Attribute::AttrKind Kind) const {
334   assert(ArgNo < getNumArgOperands() && "Param index out of bounds!");
335 
336   if (Attrs.hasParamAttribute(ArgNo, Kind))
337     return true;
338   if (const Function *F = getCalledFunction())
339     return F->getAttributes().hasParamAttribute(ArgNo, Kind);
340   return false;
341 }
342 
343 bool CallBase::hasFnAttrOnCalledFunction(Attribute::AttrKind Kind) const {
344   if (const Function *F = getCalledFunction())
345     return F->getAttributes().hasAttribute(AttributeList::FunctionIndex, Kind);
346   return false;
347 }
348 
349 bool CallBase::hasFnAttrOnCalledFunction(StringRef Kind) const {
350   if (const Function *F = getCalledFunction())
351     return F->getAttributes().hasAttribute(AttributeList::FunctionIndex, Kind);
352   return false;
353 }
354 
355 void CallBase::getOperandBundlesAsDefs(
356     SmallVectorImpl<OperandBundleDef> &Defs) const {
357   for (unsigned i = 0, e = getNumOperandBundles(); i != e; ++i)
358     Defs.emplace_back(getOperandBundleAt(i));
359 }
360 
361 CallBase::op_iterator
362 CallBase::populateBundleOperandInfos(ArrayRef<OperandBundleDef> Bundles,
363                                      const unsigned BeginIndex) {
364   auto It = op_begin() + BeginIndex;
365   for (auto &B : Bundles)
366     It = std::copy(B.input_begin(), B.input_end(), It);
367 
368   auto *ContextImpl = getContext().pImpl;
369   auto BI = Bundles.begin();
370   unsigned CurrentIndex = BeginIndex;
371 
372   for (auto &BOI : bundle_op_infos()) {
373     assert(BI != Bundles.end() && "Incorrect allocation?");
374 
375     BOI.Tag = ContextImpl->getOrInsertBundleTag(BI->getTag());
376     BOI.Begin = CurrentIndex;
377     BOI.End = CurrentIndex + BI->input_size();
378     CurrentIndex = BOI.End;
379     BI++;
380   }
381 
382   assert(BI == Bundles.end() && "Incorrect allocation?");
383 
384   return It;
385 }
386 
387 CallBase::BundleOpInfo &CallBase::getBundleOpInfoForOperand(unsigned OpIdx) {
388   /// When there isn't many bundles, we do a simple linear search.
389   /// Else fallback to a binary-search that use the fact that bundles usually
390   /// have similar number of argument to get faster convergence.
391   if (bundle_op_info_end() - bundle_op_info_begin() < 8) {
392     for (auto &BOI : bundle_op_infos())
393       if (BOI.Begin <= OpIdx && OpIdx < BOI.End)
394         return BOI;
395 
396     llvm_unreachable("Did not find operand bundle for operand!");
397   }
398 
399   assert(OpIdx >= arg_size() && "the Idx is not in the operand bundles");
400   assert(bundle_op_info_end() - bundle_op_info_begin() > 0 &&
401          OpIdx < std::prev(bundle_op_info_end())->End &&
402          "The Idx isn't in the operand bundle");
403 
404   /// We need a decimal number below and to prevent using floating point numbers
405   /// we use an intergal value multiplied by this constant.
406   constexpr unsigned NumberScaling = 1024;
407 
408   bundle_op_iterator Begin = bundle_op_info_begin();
409   bundle_op_iterator End = bundle_op_info_end();
410   bundle_op_iterator Current;
411 
412   while (Begin != End) {
413     unsigned ScaledOperandPerBundle =
414         NumberScaling * (std::prev(End)->End - Begin->Begin) / (End - Begin);
415     Current = Begin + (((OpIdx - Begin->Begin) * NumberScaling) /
416                        ScaledOperandPerBundle);
417     if (Current >= End)
418       Current = std::prev(End);
419     assert(Current < End && Current >= Begin &&
420            "the operand bundle doesn't cover every value in the range");
421     if (OpIdx >= Current->Begin && OpIdx < Current->End)
422       break;
423     if (OpIdx >= Current->End)
424       Begin = Current + 1;
425     else
426       End = Current;
427   }
428 
429   assert(OpIdx >= Current->Begin && OpIdx < Current->End &&
430          "the operand bundle doesn't cover every value in the range");
431   return *Current;
432 }
433 
434 //===----------------------------------------------------------------------===//
435 //                        CallInst Implementation
436 //===----------------------------------------------------------------------===//
437 
438 void CallInst::init(FunctionType *FTy, Value *Func, ArrayRef<Value *> Args,
439                     ArrayRef<OperandBundleDef> Bundles, const Twine &NameStr) {
440   this->FTy = FTy;
441   assert(getNumOperands() == Args.size() + CountBundleInputs(Bundles) + 1 &&
442          "NumOperands not set up?");
443   setCalledOperand(Func);
444 
445 #ifndef NDEBUG
446   assert((Args.size() == FTy->getNumParams() ||
447           (FTy->isVarArg() && Args.size() > FTy->getNumParams())) &&
448          "Calling a function with bad signature!");
449 
450   for (unsigned i = 0; i != Args.size(); ++i)
451     assert((i >= FTy->getNumParams() ||
452             FTy->getParamType(i) == Args[i]->getType()) &&
453            "Calling a function with a bad signature!");
454 #endif
455 
456   llvm::copy(Args, op_begin());
457 
458   auto It = populateBundleOperandInfos(Bundles, Args.size());
459   (void)It;
460   assert(It + 1 == op_end() && "Should add up!");
461 
462   setName(NameStr);
463 }
464 
465 void CallInst::init(FunctionType *FTy, Value *Func, const Twine &NameStr) {
466   this->FTy = FTy;
467   assert(getNumOperands() == 1 && "NumOperands not set up?");
468   setCalledOperand(Func);
469 
470   assert(FTy->getNumParams() == 0 && "Calling a function with bad signature");
471 
472   setName(NameStr);
473 }
474 
475 CallInst::CallInst(FunctionType *Ty, Value *Func, const Twine &Name,
476                    Instruction *InsertBefore)
477     : CallBase(Ty->getReturnType(), Instruction::Call,
478                OperandTraits<CallBase>::op_end(this) - 1, 1, InsertBefore) {
479   init(Ty, Func, Name);
480 }
481 
482 CallInst::CallInst(FunctionType *Ty, Value *Func, const Twine &Name,
483                    BasicBlock *InsertAtEnd)
484     : CallBase(Ty->getReturnType(), Instruction::Call,
485                OperandTraits<CallBase>::op_end(this) - 1, 1, InsertAtEnd) {
486   init(Ty, Func, Name);
487 }
488 
489 CallInst::CallInst(const CallInst &CI)
490     : CallBase(CI.Attrs, CI.FTy, CI.getType(), Instruction::Call,
491                OperandTraits<CallBase>::op_end(this) - CI.getNumOperands(),
492                CI.getNumOperands()) {
493   setTailCallKind(CI.getTailCallKind());
494   setCallingConv(CI.getCallingConv());
495 
496   std::copy(CI.op_begin(), CI.op_end(), op_begin());
497   std::copy(CI.bundle_op_info_begin(), CI.bundle_op_info_end(),
498             bundle_op_info_begin());
499   SubclassOptionalData = CI.SubclassOptionalData;
500 }
501 
502 CallInst *CallInst::Create(CallInst *CI, ArrayRef<OperandBundleDef> OpB,
503                            Instruction *InsertPt) {
504   std::vector<Value *> Args(CI->arg_begin(), CI->arg_end());
505 
506   auto *NewCI = CallInst::Create(CI->getFunctionType(), CI->getCalledValue(),
507                                  Args, OpB, CI->getName(), InsertPt);
508   NewCI->setTailCallKind(CI->getTailCallKind());
509   NewCI->setCallingConv(CI->getCallingConv());
510   NewCI->SubclassOptionalData = CI->SubclassOptionalData;
511   NewCI->setAttributes(CI->getAttributes());
512   NewCI->setDebugLoc(CI->getDebugLoc());
513   return NewCI;
514 }
515 
516 // Update profile weight for call instruction by scaling it using the ratio
517 // of S/T. The meaning of "branch_weights" meta data for call instruction is
518 // transfered to represent call count.
519 void CallInst::updateProfWeight(uint64_t S, uint64_t T) {
520   auto *ProfileData = getMetadata(LLVMContext::MD_prof);
521   if (ProfileData == nullptr)
522     return;
523 
524   auto *ProfDataName = dyn_cast<MDString>(ProfileData->getOperand(0));
525   if (!ProfDataName || (!ProfDataName->getString().equals("branch_weights") &&
526                         !ProfDataName->getString().equals("VP")))
527     return;
528 
529   if (T == 0) {
530     LLVM_DEBUG(dbgs() << "Attempting to update profile weights will result in "
531                          "div by 0. Ignoring. Likely the function "
532                       << getParent()->getParent()->getName()
533                       << " has 0 entry count, and contains call instructions "
534                          "with non-zero prof info.");
535     return;
536   }
537 
538   MDBuilder MDB(getContext());
539   SmallVector<Metadata *, 3> Vals;
540   Vals.push_back(ProfileData->getOperand(0));
541   APInt APS(128, S), APT(128, T);
542   if (ProfDataName->getString().equals("branch_weights") &&
543       ProfileData->getNumOperands() > 0) {
544     // Using APInt::div may be expensive, but most cases should fit 64 bits.
545     APInt Val(128, mdconst::dyn_extract<ConstantInt>(ProfileData->getOperand(1))
546                        ->getValue()
547                        .getZExtValue());
548     Val *= APS;
549     Vals.push_back(MDB.createConstant(ConstantInt::get(
550         Type::getInt64Ty(getContext()), Val.udiv(APT).getLimitedValue())));
551   } else if (ProfDataName->getString().equals("VP"))
552     for (unsigned i = 1; i < ProfileData->getNumOperands(); i += 2) {
553       // The first value is the key of the value profile, which will not change.
554       Vals.push_back(ProfileData->getOperand(i));
555       // Using APInt::div may be expensive, but most cases should fit 64 bits.
556       APInt Val(128,
557                 mdconst::dyn_extract<ConstantInt>(ProfileData->getOperand(i + 1))
558                     ->getValue()
559                     .getZExtValue());
560       Val *= APS;
561       Vals.push_back(MDB.createConstant(
562           ConstantInt::get(Type::getInt64Ty(getContext()),
563                            Val.udiv(APT).getLimitedValue())));
564     }
565   setMetadata(LLVMContext::MD_prof, MDNode::get(getContext(), Vals));
566 }
567 
568 /// IsConstantOne - Return true only if val is constant int 1
569 static bool IsConstantOne(Value *val) {
570   assert(val && "IsConstantOne does not work with nullptr val");
571   const ConstantInt *CVal = dyn_cast<ConstantInt>(val);
572   return CVal && CVal->isOne();
573 }
574 
575 static Instruction *createMalloc(Instruction *InsertBefore,
576                                  BasicBlock *InsertAtEnd, Type *IntPtrTy,
577                                  Type *AllocTy, Value *AllocSize,
578                                  Value *ArraySize,
579                                  ArrayRef<OperandBundleDef> OpB,
580                                  Function *MallocF, const Twine &Name) {
581   assert(((!InsertBefore && InsertAtEnd) || (InsertBefore && !InsertAtEnd)) &&
582          "createMalloc needs either InsertBefore or InsertAtEnd");
583 
584   // malloc(type) becomes:
585   //       bitcast (i8* malloc(typeSize)) to type*
586   // malloc(type, arraySize) becomes:
587   //       bitcast (i8* malloc(typeSize*arraySize)) to type*
588   if (!ArraySize)
589     ArraySize = ConstantInt::get(IntPtrTy, 1);
590   else if (ArraySize->getType() != IntPtrTy) {
591     if (InsertBefore)
592       ArraySize = CastInst::CreateIntegerCast(ArraySize, IntPtrTy, false,
593                                               "", InsertBefore);
594     else
595       ArraySize = CastInst::CreateIntegerCast(ArraySize, IntPtrTy, false,
596                                               "", InsertAtEnd);
597   }
598 
599   if (!IsConstantOne(ArraySize)) {
600     if (IsConstantOne(AllocSize)) {
601       AllocSize = ArraySize;         // Operand * 1 = Operand
602     } else if (Constant *CO = dyn_cast<Constant>(ArraySize)) {
603       Constant *Scale = ConstantExpr::getIntegerCast(CO, IntPtrTy,
604                                                      false /*ZExt*/);
605       // Malloc arg is constant product of type size and array size
606       AllocSize = ConstantExpr::getMul(Scale, cast<Constant>(AllocSize));
607     } else {
608       // Multiply type size by the array size...
609       if (InsertBefore)
610         AllocSize = BinaryOperator::CreateMul(ArraySize, AllocSize,
611                                               "mallocsize", InsertBefore);
612       else
613         AllocSize = BinaryOperator::CreateMul(ArraySize, AllocSize,
614                                               "mallocsize", InsertAtEnd);
615     }
616   }
617 
618   assert(AllocSize->getType() == IntPtrTy && "malloc arg is wrong size");
619   // Create the call to Malloc.
620   BasicBlock *BB = InsertBefore ? InsertBefore->getParent() : InsertAtEnd;
621   Module *M = BB->getParent()->getParent();
622   Type *BPTy = Type::getInt8PtrTy(BB->getContext());
623   FunctionCallee MallocFunc = MallocF;
624   if (!MallocFunc)
625     // prototype malloc as "void *malloc(size_t)"
626     MallocFunc = M->getOrInsertFunction("malloc", BPTy, IntPtrTy);
627   PointerType *AllocPtrType = PointerType::getUnqual(AllocTy);
628   CallInst *MCall = nullptr;
629   Instruction *Result = nullptr;
630   if (InsertBefore) {
631     MCall = CallInst::Create(MallocFunc, AllocSize, OpB, "malloccall",
632                              InsertBefore);
633     Result = MCall;
634     if (Result->getType() != AllocPtrType)
635       // Create a cast instruction to convert to the right type...
636       Result = new BitCastInst(MCall, AllocPtrType, Name, InsertBefore);
637   } else {
638     MCall = CallInst::Create(MallocFunc, AllocSize, OpB, "malloccall");
639     Result = MCall;
640     if (Result->getType() != AllocPtrType) {
641       InsertAtEnd->getInstList().push_back(MCall);
642       // Create a cast instruction to convert to the right type...
643       Result = new BitCastInst(MCall, AllocPtrType, Name);
644     }
645   }
646   MCall->setTailCall();
647   if (Function *F = dyn_cast<Function>(MallocFunc.getCallee())) {
648     MCall->setCallingConv(F->getCallingConv());
649     if (!F->returnDoesNotAlias())
650       F->setReturnDoesNotAlias();
651   }
652   assert(!MCall->getType()->isVoidTy() && "Malloc has void return type");
653 
654   return Result;
655 }
656 
657 /// CreateMalloc - Generate the IR for a call to malloc:
658 /// 1. Compute the malloc call's argument as the specified type's size,
659 ///    possibly multiplied by the array size if the array size is not
660 ///    constant 1.
661 /// 2. Call malloc with that argument.
662 /// 3. Bitcast the result of the malloc call to the specified type.
663 Instruction *CallInst::CreateMalloc(Instruction *InsertBefore,
664                                     Type *IntPtrTy, Type *AllocTy,
665                                     Value *AllocSize, Value *ArraySize,
666                                     Function *MallocF,
667                                     const Twine &Name) {
668   return createMalloc(InsertBefore, nullptr, IntPtrTy, AllocTy, AllocSize,
669                       ArraySize, None, MallocF, Name);
670 }
671 Instruction *CallInst::CreateMalloc(Instruction *InsertBefore,
672                                     Type *IntPtrTy, Type *AllocTy,
673                                     Value *AllocSize, Value *ArraySize,
674                                     ArrayRef<OperandBundleDef> OpB,
675                                     Function *MallocF,
676                                     const Twine &Name) {
677   return createMalloc(InsertBefore, nullptr, IntPtrTy, AllocTy, AllocSize,
678                       ArraySize, OpB, MallocF, Name);
679 }
680 
681 /// CreateMalloc - Generate the IR for a call to malloc:
682 /// 1. Compute the malloc call's argument as the specified type's size,
683 ///    possibly multiplied by the array size if the array size is not
684 ///    constant 1.
685 /// 2. Call malloc with that argument.
686 /// 3. Bitcast the result of the malloc call to the specified type.
687 /// Note: This function does not add the bitcast to the basic block, that is the
688 /// responsibility of the caller.
689 Instruction *CallInst::CreateMalloc(BasicBlock *InsertAtEnd,
690                                     Type *IntPtrTy, Type *AllocTy,
691                                     Value *AllocSize, Value *ArraySize,
692                                     Function *MallocF, const Twine &Name) {
693   return createMalloc(nullptr, InsertAtEnd, IntPtrTy, AllocTy, AllocSize,
694                       ArraySize, None, MallocF, Name);
695 }
696 Instruction *CallInst::CreateMalloc(BasicBlock *InsertAtEnd,
697                                     Type *IntPtrTy, Type *AllocTy,
698                                     Value *AllocSize, Value *ArraySize,
699                                     ArrayRef<OperandBundleDef> OpB,
700                                     Function *MallocF, const Twine &Name) {
701   return createMalloc(nullptr, InsertAtEnd, IntPtrTy, AllocTy, AllocSize,
702                       ArraySize, OpB, MallocF, Name);
703 }
704 
705 static Instruction *createFree(Value *Source,
706                                ArrayRef<OperandBundleDef> Bundles,
707                                Instruction *InsertBefore,
708                                BasicBlock *InsertAtEnd) {
709   assert(((!InsertBefore && InsertAtEnd) || (InsertBefore && !InsertAtEnd)) &&
710          "createFree needs either InsertBefore or InsertAtEnd");
711   assert(Source->getType()->isPointerTy() &&
712          "Can not free something of nonpointer type!");
713 
714   BasicBlock *BB = InsertBefore ? InsertBefore->getParent() : InsertAtEnd;
715   Module *M = BB->getParent()->getParent();
716 
717   Type *VoidTy = Type::getVoidTy(M->getContext());
718   Type *IntPtrTy = Type::getInt8PtrTy(M->getContext());
719   // prototype free as "void free(void*)"
720   FunctionCallee FreeFunc = M->getOrInsertFunction("free", VoidTy, IntPtrTy);
721   CallInst *Result = nullptr;
722   Value *PtrCast = Source;
723   if (InsertBefore) {
724     if (Source->getType() != IntPtrTy)
725       PtrCast = new BitCastInst(Source, IntPtrTy, "", InsertBefore);
726     Result = CallInst::Create(FreeFunc, PtrCast, Bundles, "", InsertBefore);
727   } else {
728     if (Source->getType() != IntPtrTy)
729       PtrCast = new BitCastInst(Source, IntPtrTy, "", InsertAtEnd);
730     Result = CallInst::Create(FreeFunc, PtrCast, Bundles, "");
731   }
732   Result->setTailCall();
733   if (Function *F = dyn_cast<Function>(FreeFunc.getCallee()))
734     Result->setCallingConv(F->getCallingConv());
735 
736   return Result;
737 }
738 
739 /// CreateFree - Generate the IR for a call to the builtin free function.
740 Instruction *CallInst::CreateFree(Value *Source, Instruction *InsertBefore) {
741   return createFree(Source, None, InsertBefore, nullptr);
742 }
743 Instruction *CallInst::CreateFree(Value *Source,
744                                   ArrayRef<OperandBundleDef> Bundles,
745                                   Instruction *InsertBefore) {
746   return createFree(Source, Bundles, InsertBefore, nullptr);
747 }
748 
749 /// CreateFree - Generate the IR for a call to the builtin free function.
750 /// Note: This function does not add the call to the basic block, that is the
751 /// responsibility of the caller.
752 Instruction *CallInst::CreateFree(Value *Source, BasicBlock *InsertAtEnd) {
753   Instruction *FreeCall = createFree(Source, None, nullptr, InsertAtEnd);
754   assert(FreeCall && "CreateFree did not create a CallInst");
755   return FreeCall;
756 }
757 Instruction *CallInst::CreateFree(Value *Source,
758                                   ArrayRef<OperandBundleDef> Bundles,
759                                   BasicBlock *InsertAtEnd) {
760   Instruction *FreeCall = createFree(Source, Bundles, nullptr, InsertAtEnd);
761   assert(FreeCall && "CreateFree did not create a CallInst");
762   return FreeCall;
763 }
764 
765 //===----------------------------------------------------------------------===//
766 //                        InvokeInst Implementation
767 //===----------------------------------------------------------------------===//
768 
769 void InvokeInst::init(FunctionType *FTy, Value *Fn, BasicBlock *IfNormal,
770                       BasicBlock *IfException, ArrayRef<Value *> Args,
771                       ArrayRef<OperandBundleDef> Bundles,
772                       const Twine &NameStr) {
773   this->FTy = FTy;
774 
775   assert((int)getNumOperands() ==
776              ComputeNumOperands(Args.size(), CountBundleInputs(Bundles)) &&
777          "NumOperands not set up?");
778   setNormalDest(IfNormal);
779   setUnwindDest(IfException);
780   setCalledOperand(Fn);
781 
782 #ifndef NDEBUG
783   assert(((Args.size() == FTy->getNumParams()) ||
784           (FTy->isVarArg() && Args.size() > FTy->getNumParams())) &&
785          "Invoking a function with bad signature");
786 
787   for (unsigned i = 0, e = Args.size(); i != e; i++)
788     assert((i >= FTy->getNumParams() ||
789             FTy->getParamType(i) == Args[i]->getType()) &&
790            "Invoking a function with a bad signature!");
791 #endif
792 
793   llvm::copy(Args, op_begin());
794 
795   auto It = populateBundleOperandInfos(Bundles, Args.size());
796   (void)It;
797   assert(It + 3 == op_end() && "Should add up!");
798 
799   setName(NameStr);
800 }
801 
802 InvokeInst::InvokeInst(const InvokeInst &II)
803     : CallBase(II.Attrs, II.FTy, II.getType(), Instruction::Invoke,
804                OperandTraits<CallBase>::op_end(this) - II.getNumOperands(),
805                II.getNumOperands()) {
806   setCallingConv(II.getCallingConv());
807   std::copy(II.op_begin(), II.op_end(), op_begin());
808   std::copy(II.bundle_op_info_begin(), II.bundle_op_info_end(),
809             bundle_op_info_begin());
810   SubclassOptionalData = II.SubclassOptionalData;
811 }
812 
813 InvokeInst *InvokeInst::Create(InvokeInst *II, ArrayRef<OperandBundleDef> OpB,
814                                Instruction *InsertPt) {
815   std::vector<Value *> Args(II->arg_begin(), II->arg_end());
816 
817   auto *NewII = InvokeInst::Create(II->getFunctionType(), II->getCalledValue(),
818                                    II->getNormalDest(), II->getUnwindDest(),
819                                    Args, OpB, II->getName(), InsertPt);
820   NewII->setCallingConv(II->getCallingConv());
821   NewII->SubclassOptionalData = II->SubclassOptionalData;
822   NewII->setAttributes(II->getAttributes());
823   NewII->setDebugLoc(II->getDebugLoc());
824   return NewII;
825 }
826 
827 
828 LandingPadInst *InvokeInst::getLandingPadInst() const {
829   return cast<LandingPadInst>(getUnwindDest()->getFirstNonPHI());
830 }
831 
832 //===----------------------------------------------------------------------===//
833 //                        CallBrInst Implementation
834 //===----------------------------------------------------------------------===//
835 
836 void CallBrInst::init(FunctionType *FTy, Value *Fn, BasicBlock *Fallthrough,
837                       ArrayRef<BasicBlock *> IndirectDests,
838                       ArrayRef<Value *> Args,
839                       ArrayRef<OperandBundleDef> Bundles,
840                       const Twine &NameStr) {
841   this->FTy = FTy;
842 
843   assert((int)getNumOperands() ==
844              ComputeNumOperands(Args.size(), IndirectDests.size(),
845                                 CountBundleInputs(Bundles)) &&
846          "NumOperands not set up?");
847   NumIndirectDests = IndirectDests.size();
848   setDefaultDest(Fallthrough);
849   for (unsigned i = 0; i != NumIndirectDests; ++i)
850     setIndirectDest(i, IndirectDests[i]);
851   setCalledOperand(Fn);
852 
853 #ifndef NDEBUG
854   assert(((Args.size() == FTy->getNumParams()) ||
855           (FTy->isVarArg() && Args.size() > FTy->getNumParams())) &&
856          "Calling a function with bad signature");
857 
858   for (unsigned i = 0, e = Args.size(); i != e; i++)
859     assert((i >= FTy->getNumParams() ||
860             FTy->getParamType(i) == Args[i]->getType()) &&
861            "Calling a function with a bad signature!");
862 #endif
863 
864   std::copy(Args.begin(), Args.end(), op_begin());
865 
866   auto It = populateBundleOperandInfos(Bundles, Args.size());
867   (void)It;
868   assert(It + 2 + IndirectDests.size() == op_end() && "Should add up!");
869 
870   setName(NameStr);
871 }
872 
873 void CallBrInst::updateArgBlockAddresses(unsigned i, BasicBlock *B) {
874   assert(getNumIndirectDests() > i && "IndirectDest # out of range for callbr");
875   if (BasicBlock *OldBB = getIndirectDest(i)) {
876     BlockAddress *Old = BlockAddress::get(OldBB);
877     BlockAddress *New = BlockAddress::get(B);
878     for (unsigned ArgNo = 0, e = getNumArgOperands(); ArgNo != e; ++ArgNo)
879       if (dyn_cast<BlockAddress>(getArgOperand(ArgNo)) == Old)
880         setArgOperand(ArgNo, New);
881   }
882 }
883 
884 CallBrInst::CallBrInst(const CallBrInst &CBI)
885     : CallBase(CBI.Attrs, CBI.FTy, CBI.getType(), Instruction::CallBr,
886                OperandTraits<CallBase>::op_end(this) - CBI.getNumOperands(),
887                CBI.getNumOperands()) {
888   setCallingConv(CBI.getCallingConv());
889   std::copy(CBI.op_begin(), CBI.op_end(), op_begin());
890   std::copy(CBI.bundle_op_info_begin(), CBI.bundle_op_info_end(),
891             bundle_op_info_begin());
892   SubclassOptionalData = CBI.SubclassOptionalData;
893   NumIndirectDests = CBI.NumIndirectDests;
894 }
895 
896 CallBrInst *CallBrInst::Create(CallBrInst *CBI, ArrayRef<OperandBundleDef> OpB,
897                                Instruction *InsertPt) {
898   std::vector<Value *> Args(CBI->arg_begin(), CBI->arg_end());
899 
900   auto *NewCBI = CallBrInst::Create(CBI->getFunctionType(),
901                                     CBI->getCalledValue(),
902                                     CBI->getDefaultDest(),
903                                     CBI->getIndirectDests(),
904                                     Args, OpB, CBI->getName(), InsertPt);
905   NewCBI->setCallingConv(CBI->getCallingConv());
906   NewCBI->SubclassOptionalData = CBI->SubclassOptionalData;
907   NewCBI->setAttributes(CBI->getAttributes());
908   NewCBI->setDebugLoc(CBI->getDebugLoc());
909   NewCBI->NumIndirectDests = CBI->NumIndirectDests;
910   return NewCBI;
911 }
912 
913 //===----------------------------------------------------------------------===//
914 //                        ReturnInst Implementation
915 //===----------------------------------------------------------------------===//
916 
917 ReturnInst::ReturnInst(const ReturnInst &RI)
918     : Instruction(Type::getVoidTy(RI.getContext()), Instruction::Ret,
919                   OperandTraits<ReturnInst>::op_end(this) - RI.getNumOperands(),
920                   RI.getNumOperands()) {
921   if (RI.getNumOperands())
922     Op<0>() = RI.Op<0>();
923   SubclassOptionalData = RI.SubclassOptionalData;
924 }
925 
926 ReturnInst::ReturnInst(LLVMContext &C, Value *retVal, Instruction *InsertBefore)
927     : Instruction(Type::getVoidTy(C), Instruction::Ret,
928                   OperandTraits<ReturnInst>::op_end(this) - !!retVal, !!retVal,
929                   InsertBefore) {
930   if (retVal)
931     Op<0>() = retVal;
932 }
933 
934 ReturnInst::ReturnInst(LLVMContext &C, Value *retVal, BasicBlock *InsertAtEnd)
935     : Instruction(Type::getVoidTy(C), Instruction::Ret,
936                   OperandTraits<ReturnInst>::op_end(this) - !!retVal, !!retVal,
937                   InsertAtEnd) {
938   if (retVal)
939     Op<0>() = retVal;
940 }
941 
942 ReturnInst::ReturnInst(LLVMContext &Context, BasicBlock *InsertAtEnd)
943     : Instruction(Type::getVoidTy(Context), Instruction::Ret,
944                   OperandTraits<ReturnInst>::op_end(this), 0, InsertAtEnd) {}
945 
946 //===----------------------------------------------------------------------===//
947 //                        ResumeInst Implementation
948 //===----------------------------------------------------------------------===//
949 
950 ResumeInst::ResumeInst(const ResumeInst &RI)
951     : Instruction(Type::getVoidTy(RI.getContext()), Instruction::Resume,
952                   OperandTraits<ResumeInst>::op_begin(this), 1) {
953   Op<0>() = RI.Op<0>();
954 }
955 
956 ResumeInst::ResumeInst(Value *Exn, Instruction *InsertBefore)
957     : Instruction(Type::getVoidTy(Exn->getContext()), Instruction::Resume,
958                   OperandTraits<ResumeInst>::op_begin(this), 1, InsertBefore) {
959   Op<0>() = Exn;
960 }
961 
962 ResumeInst::ResumeInst(Value *Exn, BasicBlock *InsertAtEnd)
963     : Instruction(Type::getVoidTy(Exn->getContext()), Instruction::Resume,
964                   OperandTraits<ResumeInst>::op_begin(this), 1, InsertAtEnd) {
965   Op<0>() = Exn;
966 }
967 
968 //===----------------------------------------------------------------------===//
969 //                        CleanupReturnInst Implementation
970 //===----------------------------------------------------------------------===//
971 
972 CleanupReturnInst::CleanupReturnInst(const CleanupReturnInst &CRI)
973     : Instruction(CRI.getType(), Instruction::CleanupRet,
974                   OperandTraits<CleanupReturnInst>::op_end(this) -
975                       CRI.getNumOperands(),
976                   CRI.getNumOperands()) {
977   setInstructionSubclassData(CRI.getSubclassDataFromInstruction());
978   Op<0>() = CRI.Op<0>();
979   if (CRI.hasUnwindDest())
980     Op<1>() = CRI.Op<1>();
981 }
982 
983 void CleanupReturnInst::init(Value *CleanupPad, BasicBlock *UnwindBB) {
984   if (UnwindBB)
985     setInstructionSubclassData(getSubclassDataFromInstruction() | 1);
986 
987   Op<0>() = CleanupPad;
988   if (UnwindBB)
989     Op<1>() = UnwindBB;
990 }
991 
992 CleanupReturnInst::CleanupReturnInst(Value *CleanupPad, BasicBlock *UnwindBB,
993                                      unsigned Values, Instruction *InsertBefore)
994     : Instruction(Type::getVoidTy(CleanupPad->getContext()),
995                   Instruction::CleanupRet,
996                   OperandTraits<CleanupReturnInst>::op_end(this) - Values,
997                   Values, InsertBefore) {
998   init(CleanupPad, UnwindBB);
999 }
1000 
1001 CleanupReturnInst::CleanupReturnInst(Value *CleanupPad, BasicBlock *UnwindBB,
1002                                      unsigned Values, BasicBlock *InsertAtEnd)
1003     : Instruction(Type::getVoidTy(CleanupPad->getContext()),
1004                   Instruction::CleanupRet,
1005                   OperandTraits<CleanupReturnInst>::op_end(this) - Values,
1006                   Values, InsertAtEnd) {
1007   init(CleanupPad, UnwindBB);
1008 }
1009 
1010 //===----------------------------------------------------------------------===//
1011 //                        CatchReturnInst Implementation
1012 //===----------------------------------------------------------------------===//
1013 void CatchReturnInst::init(Value *CatchPad, BasicBlock *BB) {
1014   Op<0>() = CatchPad;
1015   Op<1>() = BB;
1016 }
1017 
1018 CatchReturnInst::CatchReturnInst(const CatchReturnInst &CRI)
1019     : Instruction(Type::getVoidTy(CRI.getContext()), Instruction::CatchRet,
1020                   OperandTraits<CatchReturnInst>::op_begin(this), 2) {
1021   Op<0>() = CRI.Op<0>();
1022   Op<1>() = CRI.Op<1>();
1023 }
1024 
1025 CatchReturnInst::CatchReturnInst(Value *CatchPad, BasicBlock *BB,
1026                                  Instruction *InsertBefore)
1027     : Instruction(Type::getVoidTy(BB->getContext()), Instruction::CatchRet,
1028                   OperandTraits<CatchReturnInst>::op_begin(this), 2,
1029                   InsertBefore) {
1030   init(CatchPad, BB);
1031 }
1032 
1033 CatchReturnInst::CatchReturnInst(Value *CatchPad, BasicBlock *BB,
1034                                  BasicBlock *InsertAtEnd)
1035     : Instruction(Type::getVoidTy(BB->getContext()), Instruction::CatchRet,
1036                   OperandTraits<CatchReturnInst>::op_begin(this), 2,
1037                   InsertAtEnd) {
1038   init(CatchPad, BB);
1039 }
1040 
1041 //===----------------------------------------------------------------------===//
1042 //                       CatchSwitchInst Implementation
1043 //===----------------------------------------------------------------------===//
1044 
1045 CatchSwitchInst::CatchSwitchInst(Value *ParentPad, BasicBlock *UnwindDest,
1046                                  unsigned NumReservedValues,
1047                                  const Twine &NameStr,
1048                                  Instruction *InsertBefore)
1049     : Instruction(ParentPad->getType(), Instruction::CatchSwitch, nullptr, 0,
1050                   InsertBefore) {
1051   if (UnwindDest)
1052     ++NumReservedValues;
1053   init(ParentPad, UnwindDest, NumReservedValues + 1);
1054   setName(NameStr);
1055 }
1056 
1057 CatchSwitchInst::CatchSwitchInst(Value *ParentPad, BasicBlock *UnwindDest,
1058                                  unsigned NumReservedValues,
1059                                  const Twine &NameStr, BasicBlock *InsertAtEnd)
1060     : Instruction(ParentPad->getType(), Instruction::CatchSwitch, nullptr, 0,
1061                   InsertAtEnd) {
1062   if (UnwindDest)
1063     ++NumReservedValues;
1064   init(ParentPad, UnwindDest, NumReservedValues + 1);
1065   setName(NameStr);
1066 }
1067 
1068 CatchSwitchInst::CatchSwitchInst(const CatchSwitchInst &CSI)
1069     : Instruction(CSI.getType(), Instruction::CatchSwitch, nullptr,
1070                   CSI.getNumOperands()) {
1071   init(CSI.getParentPad(), CSI.getUnwindDest(), CSI.getNumOperands());
1072   setNumHungOffUseOperands(ReservedSpace);
1073   Use *OL = getOperandList();
1074   const Use *InOL = CSI.getOperandList();
1075   for (unsigned I = 1, E = ReservedSpace; I != E; ++I)
1076     OL[I] = InOL[I];
1077 }
1078 
1079 void CatchSwitchInst::init(Value *ParentPad, BasicBlock *UnwindDest,
1080                            unsigned NumReservedValues) {
1081   assert(ParentPad && NumReservedValues);
1082 
1083   ReservedSpace = NumReservedValues;
1084   setNumHungOffUseOperands(UnwindDest ? 2 : 1);
1085   allocHungoffUses(ReservedSpace);
1086 
1087   Op<0>() = ParentPad;
1088   if (UnwindDest) {
1089     setInstructionSubclassData(getSubclassDataFromInstruction() | 1);
1090     setUnwindDest(UnwindDest);
1091   }
1092 }
1093 
1094 /// growOperands - grow operands - This grows the operand list in response to a
1095 /// push_back style of operation. This grows the number of ops by 2 times.
1096 void CatchSwitchInst::growOperands(unsigned Size) {
1097   unsigned NumOperands = getNumOperands();
1098   assert(NumOperands >= 1);
1099   if (ReservedSpace >= NumOperands + Size)
1100     return;
1101   ReservedSpace = (NumOperands + Size / 2) * 2;
1102   growHungoffUses(ReservedSpace);
1103 }
1104 
1105 void CatchSwitchInst::addHandler(BasicBlock *Handler) {
1106   unsigned OpNo = getNumOperands();
1107   growOperands(1);
1108   assert(OpNo < ReservedSpace && "Growing didn't work!");
1109   setNumHungOffUseOperands(getNumOperands() + 1);
1110   getOperandList()[OpNo] = Handler;
1111 }
1112 
1113 void CatchSwitchInst::removeHandler(handler_iterator HI) {
1114   // Move all subsequent handlers up one.
1115   Use *EndDst = op_end() - 1;
1116   for (Use *CurDst = HI.getCurrent(); CurDst != EndDst; ++CurDst)
1117     *CurDst = *(CurDst + 1);
1118   // Null out the last handler use.
1119   *EndDst = nullptr;
1120 
1121   setNumHungOffUseOperands(getNumOperands() - 1);
1122 }
1123 
1124 //===----------------------------------------------------------------------===//
1125 //                        FuncletPadInst Implementation
1126 //===----------------------------------------------------------------------===//
1127 void FuncletPadInst::init(Value *ParentPad, ArrayRef<Value *> Args,
1128                           const Twine &NameStr) {
1129   assert(getNumOperands() == 1 + Args.size() && "NumOperands not set up?");
1130   llvm::copy(Args, op_begin());
1131   setParentPad(ParentPad);
1132   setName(NameStr);
1133 }
1134 
1135 FuncletPadInst::FuncletPadInst(const FuncletPadInst &FPI)
1136     : Instruction(FPI.getType(), FPI.getOpcode(),
1137                   OperandTraits<FuncletPadInst>::op_end(this) -
1138                       FPI.getNumOperands(),
1139                   FPI.getNumOperands()) {
1140   std::copy(FPI.op_begin(), FPI.op_end(), op_begin());
1141   setParentPad(FPI.getParentPad());
1142 }
1143 
1144 FuncletPadInst::FuncletPadInst(Instruction::FuncletPadOps Op, Value *ParentPad,
1145                                ArrayRef<Value *> Args, unsigned Values,
1146                                const Twine &NameStr, Instruction *InsertBefore)
1147     : Instruction(ParentPad->getType(), Op,
1148                   OperandTraits<FuncletPadInst>::op_end(this) - Values, Values,
1149                   InsertBefore) {
1150   init(ParentPad, Args, NameStr);
1151 }
1152 
1153 FuncletPadInst::FuncletPadInst(Instruction::FuncletPadOps Op, Value *ParentPad,
1154                                ArrayRef<Value *> Args, unsigned Values,
1155                                const Twine &NameStr, BasicBlock *InsertAtEnd)
1156     : Instruction(ParentPad->getType(), Op,
1157                   OperandTraits<FuncletPadInst>::op_end(this) - Values, Values,
1158                   InsertAtEnd) {
1159   init(ParentPad, Args, NameStr);
1160 }
1161 
1162 //===----------------------------------------------------------------------===//
1163 //                      UnreachableInst Implementation
1164 //===----------------------------------------------------------------------===//
1165 
1166 UnreachableInst::UnreachableInst(LLVMContext &Context,
1167                                  Instruction *InsertBefore)
1168     : Instruction(Type::getVoidTy(Context), Instruction::Unreachable, nullptr,
1169                   0, InsertBefore) {}
1170 UnreachableInst::UnreachableInst(LLVMContext &Context, BasicBlock *InsertAtEnd)
1171     : Instruction(Type::getVoidTy(Context), Instruction::Unreachable, nullptr,
1172                   0, InsertAtEnd) {}
1173 
1174 //===----------------------------------------------------------------------===//
1175 //                        BranchInst Implementation
1176 //===----------------------------------------------------------------------===//
1177 
1178 void BranchInst::AssertOK() {
1179   if (isConditional())
1180     assert(getCondition()->getType()->isIntegerTy(1) &&
1181            "May only branch on boolean predicates!");
1182 }
1183 
1184 BranchInst::BranchInst(BasicBlock *IfTrue, Instruction *InsertBefore)
1185     : Instruction(Type::getVoidTy(IfTrue->getContext()), Instruction::Br,
1186                   OperandTraits<BranchInst>::op_end(this) - 1, 1,
1187                   InsertBefore) {
1188   assert(IfTrue && "Branch destination may not be null!");
1189   Op<-1>() = IfTrue;
1190 }
1191 
1192 BranchInst::BranchInst(BasicBlock *IfTrue, BasicBlock *IfFalse, Value *Cond,
1193                        Instruction *InsertBefore)
1194     : Instruction(Type::getVoidTy(IfTrue->getContext()), Instruction::Br,
1195                   OperandTraits<BranchInst>::op_end(this) - 3, 3,
1196                   InsertBefore) {
1197   Op<-1>() = IfTrue;
1198   Op<-2>() = IfFalse;
1199   Op<-3>() = Cond;
1200 #ifndef NDEBUG
1201   AssertOK();
1202 #endif
1203 }
1204 
1205 BranchInst::BranchInst(BasicBlock *IfTrue, BasicBlock *InsertAtEnd)
1206     : Instruction(Type::getVoidTy(IfTrue->getContext()), Instruction::Br,
1207                   OperandTraits<BranchInst>::op_end(this) - 1, 1, InsertAtEnd) {
1208   assert(IfTrue && "Branch destination may not be null!");
1209   Op<-1>() = IfTrue;
1210 }
1211 
1212 BranchInst::BranchInst(BasicBlock *IfTrue, BasicBlock *IfFalse, Value *Cond,
1213                        BasicBlock *InsertAtEnd)
1214     : Instruction(Type::getVoidTy(IfTrue->getContext()), Instruction::Br,
1215                   OperandTraits<BranchInst>::op_end(this) - 3, 3, InsertAtEnd) {
1216   Op<-1>() = IfTrue;
1217   Op<-2>() = IfFalse;
1218   Op<-3>() = Cond;
1219 #ifndef NDEBUG
1220   AssertOK();
1221 #endif
1222 }
1223 
1224 BranchInst::BranchInst(const BranchInst &BI)
1225     : Instruction(Type::getVoidTy(BI.getContext()), Instruction::Br,
1226                   OperandTraits<BranchInst>::op_end(this) - BI.getNumOperands(),
1227                   BI.getNumOperands()) {
1228   Op<-1>() = BI.Op<-1>();
1229   if (BI.getNumOperands() != 1) {
1230     assert(BI.getNumOperands() == 3 && "BR can have 1 or 3 operands!");
1231     Op<-3>() = BI.Op<-3>();
1232     Op<-2>() = BI.Op<-2>();
1233   }
1234   SubclassOptionalData = BI.SubclassOptionalData;
1235 }
1236 
1237 void BranchInst::swapSuccessors() {
1238   assert(isConditional() &&
1239          "Cannot swap successors of an unconditional branch");
1240   Op<-1>().swap(Op<-2>());
1241 
1242   // Update profile metadata if present and it matches our structural
1243   // expectations.
1244   swapProfMetadata();
1245 }
1246 
1247 //===----------------------------------------------------------------------===//
1248 //                        AllocaInst Implementation
1249 //===----------------------------------------------------------------------===//
1250 
1251 static Value *getAISize(LLVMContext &Context, Value *Amt) {
1252   if (!Amt)
1253     Amt = ConstantInt::get(Type::getInt32Ty(Context), 1);
1254   else {
1255     assert(!isa<BasicBlock>(Amt) &&
1256            "Passed basic block into allocation size parameter! Use other ctor");
1257     assert(Amt->getType()->isIntegerTy() &&
1258            "Allocation array size is not an integer!");
1259   }
1260   return Amt;
1261 }
1262 
1263 AllocaInst::AllocaInst(Type *Ty, unsigned AddrSpace, const Twine &Name,
1264                        Instruction *InsertBefore)
1265   : AllocaInst(Ty, AddrSpace, /*ArraySize=*/nullptr, Name, InsertBefore) {}
1266 
1267 AllocaInst::AllocaInst(Type *Ty, unsigned AddrSpace, const Twine &Name,
1268                        BasicBlock *InsertAtEnd)
1269   : AllocaInst(Ty, AddrSpace, /*ArraySize=*/nullptr, Name, InsertAtEnd) {}
1270 
1271 AllocaInst::AllocaInst(Type *Ty, unsigned AddrSpace, Value *ArraySize,
1272                        const Twine &Name, Instruction *InsertBefore)
1273     : AllocaInst(Ty, AddrSpace, ArraySize, /*Align=*/None, Name, InsertBefore) {
1274 }
1275 
1276 AllocaInst::AllocaInst(Type *Ty, unsigned AddrSpace, Value *ArraySize,
1277                        const Twine &Name, BasicBlock *InsertAtEnd)
1278     : AllocaInst(Ty, AddrSpace, ArraySize, /*Align=*/None, Name, InsertAtEnd) {}
1279 
1280 AllocaInst::AllocaInst(Type *Ty, unsigned AddrSpace, Value *ArraySize,
1281                        MaybeAlign Align, const Twine &Name,
1282                        Instruction *InsertBefore)
1283     : UnaryInstruction(PointerType::get(Ty, AddrSpace), Alloca,
1284                        getAISize(Ty->getContext(), ArraySize), InsertBefore),
1285       AllocatedType(Ty) {
1286   setAlignment(MaybeAlign(Align));
1287   assert(!Ty->isVoidTy() && "Cannot allocate void!");
1288   setName(Name);
1289 }
1290 
1291 AllocaInst::AllocaInst(Type *Ty, unsigned AddrSpace, Value *ArraySize,
1292                        MaybeAlign Align, const Twine &Name,
1293                        BasicBlock *InsertAtEnd)
1294     : UnaryInstruction(PointerType::get(Ty, AddrSpace), Alloca,
1295                        getAISize(Ty->getContext(), ArraySize), InsertAtEnd),
1296       AllocatedType(Ty) {
1297   setAlignment(Align);
1298   assert(!Ty->isVoidTy() && "Cannot allocate void!");
1299   setName(Name);
1300 }
1301 
1302 void AllocaInst::setAlignment(MaybeAlign Align) {
1303   assert((!Align || *Align <= MaximumAlignment) &&
1304          "Alignment is greater than MaximumAlignment!");
1305   setInstructionSubclassData((getSubclassDataFromInstruction() & ~31) |
1306                              encode(Align));
1307   if (Align)
1308     assert(getAlignment() == Align->value() &&
1309            "Alignment representation error!");
1310   else
1311     assert(getAlignment() == 0 && "Alignment representation error!");
1312 }
1313 
1314 bool AllocaInst::isArrayAllocation() const {
1315   if (ConstantInt *CI = dyn_cast<ConstantInt>(getOperand(0)))
1316     return !CI->isOne();
1317   return true;
1318 }
1319 
1320 /// isStaticAlloca - Return true if this alloca is in the entry block of the
1321 /// function and is a constant size.  If so, the code generator will fold it
1322 /// into the prolog/epilog code, so it is basically free.
1323 bool AllocaInst::isStaticAlloca() const {
1324   // Must be constant size.
1325   if (!isa<ConstantInt>(getArraySize())) return false;
1326 
1327   // Must be in the entry block.
1328   const BasicBlock *Parent = getParent();
1329   return Parent == &Parent->getParent()->front() && !isUsedWithInAlloca();
1330 }
1331 
1332 //===----------------------------------------------------------------------===//
1333 //                           LoadInst Implementation
1334 //===----------------------------------------------------------------------===//
1335 
1336 void LoadInst::AssertOK() {
1337   assert(getOperand(0)->getType()->isPointerTy() &&
1338          "Ptr must have pointer type.");
1339   assert(!(isAtomic() && getAlignment() == 0) &&
1340          "Alignment required for atomic load");
1341 }
1342 
1343 LoadInst::LoadInst(Type *Ty, Value *Ptr, const Twine &Name,
1344                    Instruction *InsertBef)
1345     : LoadInst(Ty, Ptr, Name, /*isVolatile=*/false, InsertBef) {}
1346 
1347 LoadInst::LoadInst(Type *Ty, Value *Ptr, const Twine &Name,
1348                    BasicBlock *InsertAE)
1349     : LoadInst(Ty, Ptr, Name, /*isVolatile=*/false, InsertAE) {}
1350 
1351 LoadInst::LoadInst(Type *Ty, Value *Ptr, const Twine &Name, bool isVolatile,
1352                    Instruction *InsertBef)
1353     : LoadInst(Ty, Ptr, Name, isVolatile, /*Align=*/None, InsertBef) {}
1354 
1355 LoadInst::LoadInst(Type *Ty, Value *Ptr, const Twine &Name, bool isVolatile,
1356                    BasicBlock *InsertAE)
1357     : LoadInst(Ty, Ptr, Name, isVolatile, /*Align=*/None, InsertAE) {}
1358 
1359 LoadInst::LoadInst(Type *Ty, Value *Ptr, const Twine &Name, bool isVolatile,
1360                    MaybeAlign Align, Instruction *InsertBef)
1361     : LoadInst(Ty, Ptr, Name, isVolatile, Align, AtomicOrdering::NotAtomic,
1362                SyncScope::System, InsertBef) {}
1363 
1364 LoadInst::LoadInst(Type *Ty, Value *Ptr, const Twine &Name, bool isVolatile,
1365                    MaybeAlign Align, BasicBlock *InsertAE)
1366     : LoadInst(Ty, Ptr, Name, isVolatile, Align, AtomicOrdering::NotAtomic,
1367                SyncScope::System, InsertAE) {}
1368 
1369 LoadInst::LoadInst(Type *Ty, Value *Ptr, const Twine &Name, bool isVolatile,
1370                    MaybeAlign Align, AtomicOrdering Order, SyncScope::ID SSID,
1371                    Instruction *InsertBef)
1372     : UnaryInstruction(Ty, Load, Ptr, InsertBef) {
1373   assert(Ty == cast<PointerType>(Ptr->getType())->getElementType());
1374   setVolatile(isVolatile);
1375   setAlignment(MaybeAlign(Align));
1376   setAtomic(Order, SSID);
1377   AssertOK();
1378   setName(Name);
1379 }
1380 
1381 LoadInst::LoadInst(Type *Ty, Value *Ptr, const Twine &Name, bool isVolatile,
1382                    MaybeAlign Align, AtomicOrdering Order, SyncScope::ID SSID,
1383                    BasicBlock *InsertAE)
1384     : UnaryInstruction(Ty, Load, Ptr, InsertAE) {
1385   assert(Ty == cast<PointerType>(Ptr->getType())->getElementType());
1386   setVolatile(isVolatile);
1387   setAlignment(Align);
1388   setAtomic(Order, SSID);
1389   AssertOK();
1390   setName(Name);
1391 }
1392 
1393 void LoadInst::setAlignment(MaybeAlign Align) {
1394   assert((!Align || *Align <= MaximumAlignment) &&
1395          "Alignment is greater than MaximumAlignment!");
1396   setInstructionSubclassData((getSubclassDataFromInstruction() & ~(31 << 1)) |
1397                              (encode(Align) << 1));
1398   assert(getAlign() == Align && "Alignment representation error!");
1399 }
1400 
1401 //===----------------------------------------------------------------------===//
1402 //                           StoreInst Implementation
1403 //===----------------------------------------------------------------------===//
1404 
1405 void StoreInst::AssertOK() {
1406   assert(getOperand(0) && getOperand(1) && "Both operands must be non-null!");
1407   assert(getOperand(1)->getType()->isPointerTy() &&
1408          "Ptr must have pointer type!");
1409   assert(getOperand(0)->getType() ==
1410                  cast<PointerType>(getOperand(1)->getType())->getElementType()
1411          && "Ptr must be a pointer to Val type!");
1412   assert(!(isAtomic() && getAlignment() == 0) &&
1413          "Alignment required for atomic store");
1414 }
1415 
1416 StoreInst::StoreInst(Value *val, Value *addr, Instruction *InsertBefore)
1417     : StoreInst(val, addr, /*isVolatile=*/false, InsertBefore) {}
1418 
1419 StoreInst::StoreInst(Value *val, Value *addr, BasicBlock *InsertAtEnd)
1420     : StoreInst(val, addr, /*isVolatile=*/false, InsertAtEnd) {}
1421 
1422 StoreInst::StoreInst(Value *val, Value *addr, bool isVolatile,
1423                      Instruction *InsertBefore)
1424     : StoreInst(val, addr, isVolatile, /*Align=*/None, InsertBefore) {}
1425 
1426 StoreInst::StoreInst(Value *val, Value *addr, bool isVolatile,
1427                      BasicBlock *InsertAtEnd)
1428     : StoreInst(val, addr, isVolatile, /*Align=*/None, InsertAtEnd) {}
1429 
1430 StoreInst::StoreInst(Value *val, Value *addr, bool isVolatile, MaybeAlign Align,
1431                      Instruction *InsertBefore)
1432     : StoreInst(val, addr, isVolatile, Align, AtomicOrdering::NotAtomic,
1433                 SyncScope::System, InsertBefore) {}
1434 
1435 StoreInst::StoreInst(Value *val, Value *addr, bool isVolatile, MaybeAlign Align,
1436                      BasicBlock *InsertAtEnd)
1437     : StoreInst(val, addr, isVolatile, Align, AtomicOrdering::NotAtomic,
1438                 SyncScope::System, InsertAtEnd) {}
1439 
1440 StoreInst::StoreInst(Value *val, Value *addr, bool isVolatile, MaybeAlign Align,
1441                      AtomicOrdering Order, SyncScope::ID SSID,
1442                      Instruction *InsertBefore)
1443     : Instruction(Type::getVoidTy(val->getContext()), Store,
1444                   OperandTraits<StoreInst>::op_begin(this),
1445                   OperandTraits<StoreInst>::operands(this), InsertBefore) {
1446   Op<0>() = val;
1447   Op<1>() = addr;
1448   setVolatile(isVolatile);
1449   setAlignment(Align);
1450   setAtomic(Order, SSID);
1451   AssertOK();
1452 }
1453 
1454 StoreInst::StoreInst(Value *val, Value *addr, bool isVolatile, MaybeAlign Align,
1455                      AtomicOrdering Order, SyncScope::ID SSID,
1456                      BasicBlock *InsertAtEnd)
1457     : Instruction(Type::getVoidTy(val->getContext()), Store,
1458                   OperandTraits<StoreInst>::op_begin(this),
1459                   OperandTraits<StoreInst>::operands(this), InsertAtEnd) {
1460   Op<0>() = val;
1461   Op<1>() = addr;
1462   setVolatile(isVolatile);
1463   setAlignment(Align);
1464   setAtomic(Order, SSID);
1465   AssertOK();
1466 }
1467 
1468 void StoreInst::setAlignment(MaybeAlign Alignment) {
1469   assert((!Alignment || *Alignment <= MaximumAlignment) &&
1470          "Alignment is greater than MaximumAlignment!");
1471   setInstructionSubclassData((getSubclassDataFromInstruction() & ~(31 << 1)) |
1472                              (encode(Alignment) << 1));
1473   assert(getAlign() == Alignment && "Alignment representation error!");
1474 }
1475 
1476 //===----------------------------------------------------------------------===//
1477 //                       AtomicCmpXchgInst Implementation
1478 //===----------------------------------------------------------------------===//
1479 
1480 void AtomicCmpXchgInst::Init(Value *Ptr, Value *Cmp, Value *NewVal,
1481                              AtomicOrdering SuccessOrdering,
1482                              AtomicOrdering FailureOrdering,
1483                              SyncScope::ID SSID) {
1484   Op<0>() = Ptr;
1485   Op<1>() = Cmp;
1486   Op<2>() = NewVal;
1487   setSuccessOrdering(SuccessOrdering);
1488   setFailureOrdering(FailureOrdering);
1489   setSyncScopeID(SSID);
1490 
1491   assert(getOperand(0) && getOperand(1) && getOperand(2) &&
1492          "All operands must be non-null!");
1493   assert(getOperand(0)->getType()->isPointerTy() &&
1494          "Ptr must have pointer type!");
1495   assert(getOperand(1)->getType() ==
1496                  cast<PointerType>(getOperand(0)->getType())->getElementType()
1497          && "Ptr must be a pointer to Cmp type!");
1498   assert(getOperand(2)->getType() ==
1499                  cast<PointerType>(getOperand(0)->getType())->getElementType()
1500          && "Ptr must be a pointer to NewVal type!");
1501   assert(SuccessOrdering != AtomicOrdering::NotAtomic &&
1502          "AtomicCmpXchg instructions must be atomic!");
1503   assert(FailureOrdering != AtomicOrdering::NotAtomic &&
1504          "AtomicCmpXchg instructions must be atomic!");
1505   assert(!isStrongerThan(FailureOrdering, SuccessOrdering) &&
1506          "AtomicCmpXchg failure argument shall be no stronger than the success "
1507          "argument");
1508   assert(FailureOrdering != AtomicOrdering::Release &&
1509          FailureOrdering != AtomicOrdering::AcquireRelease &&
1510          "AtomicCmpXchg failure ordering cannot include release semantics");
1511 }
1512 
1513 AtomicCmpXchgInst::AtomicCmpXchgInst(Value *Ptr, Value *Cmp, Value *NewVal,
1514                                      AtomicOrdering SuccessOrdering,
1515                                      AtomicOrdering FailureOrdering,
1516                                      SyncScope::ID SSID,
1517                                      Instruction *InsertBefore)
1518     : Instruction(
1519           StructType::get(Cmp->getType(), Type::getInt1Ty(Cmp->getContext())),
1520           AtomicCmpXchg, OperandTraits<AtomicCmpXchgInst>::op_begin(this),
1521           OperandTraits<AtomicCmpXchgInst>::operands(this), InsertBefore) {
1522   Init(Ptr, Cmp, NewVal, SuccessOrdering, FailureOrdering, SSID);
1523 }
1524 
1525 AtomicCmpXchgInst::AtomicCmpXchgInst(Value *Ptr, Value *Cmp, Value *NewVal,
1526                                      AtomicOrdering SuccessOrdering,
1527                                      AtomicOrdering FailureOrdering,
1528                                      SyncScope::ID SSID,
1529                                      BasicBlock *InsertAtEnd)
1530     : Instruction(
1531           StructType::get(Cmp->getType(), Type::getInt1Ty(Cmp->getContext())),
1532           AtomicCmpXchg, OperandTraits<AtomicCmpXchgInst>::op_begin(this),
1533           OperandTraits<AtomicCmpXchgInst>::operands(this), InsertAtEnd) {
1534   Init(Ptr, Cmp, NewVal, SuccessOrdering, FailureOrdering, SSID);
1535 }
1536 
1537 //===----------------------------------------------------------------------===//
1538 //                       AtomicRMWInst Implementation
1539 //===----------------------------------------------------------------------===//
1540 
1541 void AtomicRMWInst::Init(BinOp Operation, Value *Ptr, Value *Val,
1542                          AtomicOrdering Ordering,
1543                          SyncScope::ID SSID) {
1544   Op<0>() = Ptr;
1545   Op<1>() = Val;
1546   setOperation(Operation);
1547   setOrdering(Ordering);
1548   setSyncScopeID(SSID);
1549 
1550   assert(getOperand(0) && getOperand(1) &&
1551          "All operands must be non-null!");
1552   assert(getOperand(0)->getType()->isPointerTy() &&
1553          "Ptr must have pointer type!");
1554   assert(getOperand(1)->getType() ==
1555          cast<PointerType>(getOperand(0)->getType())->getElementType()
1556          && "Ptr must be a pointer to Val type!");
1557   assert(Ordering != AtomicOrdering::NotAtomic &&
1558          "AtomicRMW instructions must be atomic!");
1559 }
1560 
1561 AtomicRMWInst::AtomicRMWInst(BinOp Operation, Value *Ptr, Value *Val,
1562                              AtomicOrdering Ordering,
1563                              SyncScope::ID SSID,
1564                              Instruction *InsertBefore)
1565   : Instruction(Val->getType(), AtomicRMW,
1566                 OperandTraits<AtomicRMWInst>::op_begin(this),
1567                 OperandTraits<AtomicRMWInst>::operands(this),
1568                 InsertBefore) {
1569   Init(Operation, Ptr, Val, Ordering, SSID);
1570 }
1571 
1572 AtomicRMWInst::AtomicRMWInst(BinOp Operation, Value *Ptr, Value *Val,
1573                              AtomicOrdering Ordering,
1574                              SyncScope::ID SSID,
1575                              BasicBlock *InsertAtEnd)
1576   : Instruction(Val->getType(), AtomicRMW,
1577                 OperandTraits<AtomicRMWInst>::op_begin(this),
1578                 OperandTraits<AtomicRMWInst>::operands(this),
1579                 InsertAtEnd) {
1580   Init(Operation, Ptr, Val, Ordering, SSID);
1581 }
1582 
1583 StringRef AtomicRMWInst::getOperationName(BinOp Op) {
1584   switch (Op) {
1585   case AtomicRMWInst::Xchg:
1586     return "xchg";
1587   case AtomicRMWInst::Add:
1588     return "add";
1589   case AtomicRMWInst::Sub:
1590     return "sub";
1591   case AtomicRMWInst::And:
1592     return "and";
1593   case AtomicRMWInst::Nand:
1594     return "nand";
1595   case AtomicRMWInst::Or:
1596     return "or";
1597   case AtomicRMWInst::Xor:
1598     return "xor";
1599   case AtomicRMWInst::Max:
1600     return "max";
1601   case AtomicRMWInst::Min:
1602     return "min";
1603   case AtomicRMWInst::UMax:
1604     return "umax";
1605   case AtomicRMWInst::UMin:
1606     return "umin";
1607   case AtomicRMWInst::FAdd:
1608     return "fadd";
1609   case AtomicRMWInst::FSub:
1610     return "fsub";
1611   case AtomicRMWInst::BAD_BINOP:
1612     return "<invalid operation>";
1613   }
1614 
1615   llvm_unreachable("invalid atomicrmw operation");
1616 }
1617 
1618 //===----------------------------------------------------------------------===//
1619 //                       FenceInst Implementation
1620 //===----------------------------------------------------------------------===//
1621 
1622 FenceInst::FenceInst(LLVMContext &C, AtomicOrdering Ordering,
1623                      SyncScope::ID SSID,
1624                      Instruction *InsertBefore)
1625   : Instruction(Type::getVoidTy(C), Fence, nullptr, 0, InsertBefore) {
1626   setOrdering(Ordering);
1627   setSyncScopeID(SSID);
1628 }
1629 
1630 FenceInst::FenceInst(LLVMContext &C, AtomicOrdering Ordering,
1631                      SyncScope::ID SSID,
1632                      BasicBlock *InsertAtEnd)
1633   : Instruction(Type::getVoidTy(C), Fence, nullptr, 0, InsertAtEnd) {
1634   setOrdering(Ordering);
1635   setSyncScopeID(SSID);
1636 }
1637 
1638 //===----------------------------------------------------------------------===//
1639 //                       GetElementPtrInst Implementation
1640 //===----------------------------------------------------------------------===//
1641 
1642 void GetElementPtrInst::init(Value *Ptr, ArrayRef<Value *> IdxList,
1643                              const Twine &Name) {
1644   assert(getNumOperands() == 1 + IdxList.size() &&
1645          "NumOperands not initialized?");
1646   Op<0>() = Ptr;
1647   llvm::copy(IdxList, op_begin() + 1);
1648   setName(Name);
1649 }
1650 
1651 GetElementPtrInst::GetElementPtrInst(const GetElementPtrInst &GEPI)
1652     : Instruction(GEPI.getType(), GetElementPtr,
1653                   OperandTraits<GetElementPtrInst>::op_end(this) -
1654                       GEPI.getNumOperands(),
1655                   GEPI.getNumOperands()),
1656       SourceElementType(GEPI.SourceElementType),
1657       ResultElementType(GEPI.ResultElementType) {
1658   std::copy(GEPI.op_begin(), GEPI.op_end(), op_begin());
1659   SubclassOptionalData = GEPI.SubclassOptionalData;
1660 }
1661 
1662 Type *GetElementPtrInst::getTypeAtIndex(Type *Ty, Value *Idx) {
1663   if (auto Struct = dyn_cast<StructType>(Ty)) {
1664     if (!Struct->indexValid(Idx))
1665       return nullptr;
1666     return Struct->getTypeAtIndex(Idx);
1667   }
1668   if (!Idx->getType()->isIntOrIntVectorTy())
1669     return nullptr;
1670   if (auto Array = dyn_cast<ArrayType>(Ty))
1671     return Array->getElementType();
1672   if (auto Vector = dyn_cast<VectorType>(Ty))
1673     return Vector->getElementType();
1674   return nullptr;
1675 }
1676 
1677 Type *GetElementPtrInst::getTypeAtIndex(Type *Ty, uint64_t Idx) {
1678   if (auto Struct = dyn_cast<StructType>(Ty)) {
1679     if (Idx >= Struct->getNumElements())
1680       return nullptr;
1681     return Struct->getElementType(Idx);
1682   }
1683   if (auto Array = dyn_cast<ArrayType>(Ty))
1684     return Array->getElementType();
1685   if (auto Vector = dyn_cast<VectorType>(Ty))
1686     return Vector->getElementType();
1687   return nullptr;
1688 }
1689 
1690 template <typename IndexTy>
1691 static Type *getIndexedTypeInternal(Type *Ty, ArrayRef<IndexTy> IdxList) {
1692   if (IdxList.empty())
1693     return Ty;
1694   for (IndexTy V : IdxList.slice(1)) {
1695     Ty = GetElementPtrInst::getTypeAtIndex(Ty, V);
1696     if (!Ty)
1697       return Ty;
1698   }
1699   return Ty;
1700 }
1701 
1702 Type *GetElementPtrInst::getIndexedType(Type *Ty, ArrayRef<Value *> IdxList) {
1703   return getIndexedTypeInternal(Ty, IdxList);
1704 }
1705 
1706 Type *GetElementPtrInst::getIndexedType(Type *Ty,
1707                                         ArrayRef<Constant *> IdxList) {
1708   return getIndexedTypeInternal(Ty, IdxList);
1709 }
1710 
1711 Type *GetElementPtrInst::getIndexedType(Type *Ty, ArrayRef<uint64_t> IdxList) {
1712   return getIndexedTypeInternal(Ty, IdxList);
1713 }
1714 
1715 /// hasAllZeroIndices - Return true if all of the indices of this GEP are
1716 /// zeros.  If so, the result pointer and the first operand have the same
1717 /// value, just potentially different types.
1718 bool GetElementPtrInst::hasAllZeroIndices() const {
1719   for (unsigned i = 1, e = getNumOperands(); i != e; ++i) {
1720     if (ConstantInt *CI = dyn_cast<ConstantInt>(getOperand(i))) {
1721       if (!CI->isZero()) return false;
1722     } else {
1723       return false;
1724     }
1725   }
1726   return true;
1727 }
1728 
1729 /// hasAllConstantIndices - Return true if all of the indices of this GEP are
1730 /// constant integers.  If so, the result pointer and the first operand have
1731 /// a constant offset between them.
1732 bool GetElementPtrInst::hasAllConstantIndices() const {
1733   for (unsigned i = 1, e = getNumOperands(); i != e; ++i) {
1734     if (!isa<ConstantInt>(getOperand(i)))
1735       return false;
1736   }
1737   return true;
1738 }
1739 
1740 void GetElementPtrInst::setIsInBounds(bool B) {
1741   cast<GEPOperator>(this)->setIsInBounds(B);
1742 }
1743 
1744 bool GetElementPtrInst::isInBounds() const {
1745   return cast<GEPOperator>(this)->isInBounds();
1746 }
1747 
1748 bool GetElementPtrInst::accumulateConstantOffset(const DataLayout &DL,
1749                                                  APInt &Offset) const {
1750   // Delegate to the generic GEPOperator implementation.
1751   return cast<GEPOperator>(this)->accumulateConstantOffset(DL, Offset);
1752 }
1753 
1754 //===----------------------------------------------------------------------===//
1755 //                           ExtractElementInst Implementation
1756 //===----------------------------------------------------------------------===//
1757 
1758 ExtractElementInst::ExtractElementInst(Value *Val, Value *Index,
1759                                        const Twine &Name,
1760                                        Instruction *InsertBef)
1761   : Instruction(cast<VectorType>(Val->getType())->getElementType(),
1762                 ExtractElement,
1763                 OperandTraits<ExtractElementInst>::op_begin(this),
1764                 2, InsertBef) {
1765   assert(isValidOperands(Val, Index) &&
1766          "Invalid extractelement instruction operands!");
1767   Op<0>() = Val;
1768   Op<1>() = Index;
1769   setName(Name);
1770 }
1771 
1772 ExtractElementInst::ExtractElementInst(Value *Val, Value *Index,
1773                                        const Twine &Name,
1774                                        BasicBlock *InsertAE)
1775   : Instruction(cast<VectorType>(Val->getType())->getElementType(),
1776                 ExtractElement,
1777                 OperandTraits<ExtractElementInst>::op_begin(this),
1778                 2, InsertAE) {
1779   assert(isValidOperands(Val, Index) &&
1780          "Invalid extractelement instruction operands!");
1781 
1782   Op<0>() = Val;
1783   Op<1>() = Index;
1784   setName(Name);
1785 }
1786 
1787 bool ExtractElementInst::isValidOperands(const Value *Val, const Value *Index) {
1788   if (!Val->getType()->isVectorTy() || !Index->getType()->isIntegerTy())
1789     return false;
1790   return true;
1791 }
1792 
1793 //===----------------------------------------------------------------------===//
1794 //                           InsertElementInst Implementation
1795 //===----------------------------------------------------------------------===//
1796 
1797 InsertElementInst::InsertElementInst(Value *Vec, Value *Elt, Value *Index,
1798                                      const Twine &Name,
1799                                      Instruction *InsertBef)
1800   : Instruction(Vec->getType(), InsertElement,
1801                 OperandTraits<InsertElementInst>::op_begin(this),
1802                 3, InsertBef) {
1803   assert(isValidOperands(Vec, Elt, Index) &&
1804          "Invalid insertelement instruction operands!");
1805   Op<0>() = Vec;
1806   Op<1>() = Elt;
1807   Op<2>() = Index;
1808   setName(Name);
1809 }
1810 
1811 InsertElementInst::InsertElementInst(Value *Vec, Value *Elt, Value *Index,
1812                                      const Twine &Name,
1813                                      BasicBlock *InsertAE)
1814   : Instruction(Vec->getType(), InsertElement,
1815                 OperandTraits<InsertElementInst>::op_begin(this),
1816                 3, InsertAE) {
1817   assert(isValidOperands(Vec, Elt, Index) &&
1818          "Invalid insertelement instruction operands!");
1819 
1820   Op<0>() = Vec;
1821   Op<1>() = Elt;
1822   Op<2>() = Index;
1823   setName(Name);
1824 }
1825 
1826 bool InsertElementInst::isValidOperands(const Value *Vec, const Value *Elt,
1827                                         const Value *Index) {
1828   if (!Vec->getType()->isVectorTy())
1829     return false;   // First operand of insertelement must be vector type.
1830 
1831   if (Elt->getType() != cast<VectorType>(Vec->getType())->getElementType())
1832     return false;// Second operand of insertelement must be vector element type.
1833 
1834   if (!Index->getType()->isIntegerTy())
1835     return false;  // Third operand of insertelement must be i32.
1836   return true;
1837 }
1838 
1839 //===----------------------------------------------------------------------===//
1840 //                      ShuffleVectorInst Implementation
1841 //===----------------------------------------------------------------------===//
1842 
1843 ShuffleVectorInst::ShuffleVectorInst(Value *V1, Value *V2, Value *Mask,
1844                                      const Twine &Name,
1845                                      Instruction *InsertBefore)
1846 : Instruction(VectorType::get(cast<VectorType>(V1->getType())->getElementType(),
1847                 cast<VectorType>(Mask->getType())->getElementCount()),
1848               ShuffleVector,
1849               OperandTraits<ShuffleVectorInst>::op_begin(this),
1850               OperandTraits<ShuffleVectorInst>::operands(this),
1851               InsertBefore) {
1852   assert(isValidOperands(V1, V2, Mask) &&
1853          "Invalid shuffle vector instruction operands!");
1854   Op<0>() = V1;
1855   Op<1>() = V2;
1856   Op<2>() = Mask;
1857   setName(Name);
1858 }
1859 
1860 ShuffleVectorInst::ShuffleVectorInst(Value *V1, Value *V2, Value *Mask,
1861                                      const Twine &Name,
1862                                      BasicBlock *InsertAtEnd)
1863 : Instruction(VectorType::get(cast<VectorType>(V1->getType())->getElementType(),
1864                 cast<VectorType>(Mask->getType())->getElementCount()),
1865               ShuffleVector,
1866               OperandTraits<ShuffleVectorInst>::op_begin(this),
1867               OperandTraits<ShuffleVectorInst>::operands(this),
1868               InsertAtEnd) {
1869   assert(isValidOperands(V1, V2, Mask) &&
1870          "Invalid shuffle vector instruction operands!");
1871 
1872   Op<0>() = V1;
1873   Op<1>() = V2;
1874   Op<2>() = Mask;
1875   setName(Name);
1876 }
1877 
1878 void ShuffleVectorInst::commute() {
1879   int NumOpElts = Op<0>()->getType()->getVectorNumElements();
1880   int NumMaskElts = getMask()->getType()->getVectorNumElements();
1881   SmallVector<Constant*, 16> NewMask(NumMaskElts);
1882   Type *Int32Ty = Type::getInt32Ty(getContext());
1883   for (int i = 0; i != NumMaskElts; ++i) {
1884     int MaskElt = getMaskValue(i);
1885     if (MaskElt == -1) {
1886       NewMask[i] = UndefValue::get(Int32Ty);
1887       continue;
1888     }
1889     assert(MaskElt >= 0 && MaskElt < 2 * NumOpElts && "Out-of-range mask");
1890     MaskElt = (MaskElt < NumOpElts) ? MaskElt + NumOpElts : MaskElt - NumOpElts;
1891     NewMask[i] = ConstantInt::get(Int32Ty, MaskElt);
1892   }
1893   Op<2>() = ConstantVector::get(NewMask);
1894   Op<0>().swap(Op<1>());
1895 }
1896 
1897 bool ShuffleVectorInst::isValidOperands(const Value *V1, const Value *V2,
1898                                         const Value *Mask) {
1899   // V1 and V2 must be vectors of the same type.
1900   if (!V1->getType()->isVectorTy() || V1->getType() != V2->getType())
1901     return false;
1902 
1903   // Mask must be vector of i32.
1904   auto *MaskTy = dyn_cast<VectorType>(Mask->getType());
1905   if (!MaskTy || !MaskTy->getElementType()->isIntegerTy(32))
1906     return false;
1907 
1908   // Check to see if Mask is valid.
1909   if (isa<UndefValue>(Mask) || isa<ConstantAggregateZero>(Mask))
1910     return true;
1911 
1912   if (const auto *MV = dyn_cast<ConstantVector>(Mask)) {
1913     unsigned V1Size = cast<VectorType>(V1->getType())->getNumElements();
1914     for (Value *Op : MV->operands()) {
1915       if (auto *CI = dyn_cast<ConstantInt>(Op)) {
1916         if (CI->uge(V1Size*2))
1917           return false;
1918       } else if (!isa<UndefValue>(Op)) {
1919         return false;
1920       }
1921     }
1922     return true;
1923   }
1924 
1925   if (const auto *CDS = dyn_cast<ConstantDataSequential>(Mask)) {
1926     unsigned V1Size = cast<VectorType>(V1->getType())->getNumElements();
1927     for (unsigned i = 0, e = MaskTy->getNumElements(); i != e; ++i)
1928       if (CDS->getElementAsInteger(i) >= V1Size*2)
1929         return false;
1930     return true;
1931   }
1932 
1933   // The bitcode reader can create a place holder for a forward reference
1934   // used as the shuffle mask. When this occurs, the shuffle mask will
1935   // fall into this case and fail. To avoid this error, do this bit of
1936   // ugliness to allow such a mask pass.
1937   if (const auto *CE = dyn_cast<ConstantExpr>(Mask))
1938     if (CE->getOpcode() == Instruction::UserOp1)
1939       return true;
1940 
1941   return false;
1942 }
1943 
1944 int ShuffleVectorInst::getMaskValue(const Constant *Mask, unsigned i) {
1945   assert(i < Mask->getType()->getVectorNumElements() && "Index out of range");
1946   assert(!Mask->getType()->getVectorElementCount().Scalable &&
1947     "Length of scalable vectors unknown at compile time");
1948   if (auto *CDS = dyn_cast<ConstantDataSequential>(Mask))
1949     return CDS->getElementAsInteger(i);
1950   Constant *C = Mask->getAggregateElement(i);
1951   if (isa<UndefValue>(C))
1952     return -1;
1953   return cast<ConstantInt>(C)->getZExtValue();
1954 }
1955 
1956 void ShuffleVectorInst::getShuffleMask(const Constant *Mask,
1957                                        SmallVectorImpl<int> &Result) {
1958   assert(!Mask->getType()->getVectorElementCount().Scalable &&
1959     "Length of scalable vectors unknown at compile time");
1960   unsigned NumElts = Mask->getType()->getVectorNumElements();
1961   if (isa<ConstantAggregateZero>(Mask)) {
1962     Result.resize(NumElts, 0);
1963     return;
1964   }
1965   Result.reserve(NumElts);
1966   if (auto *CDS = dyn_cast<ConstantDataSequential>(Mask)) {
1967     for (unsigned i = 0; i != NumElts; ++i)
1968       Result.push_back(CDS->getElementAsInteger(i));
1969     return;
1970   }
1971   for (unsigned i = 0; i != NumElts; ++i) {
1972     Constant *C = Mask->getAggregateElement(i);
1973     Result.push_back(isa<UndefValue>(C) ? -1 :
1974                      cast<ConstantInt>(C)->getZExtValue());
1975   }
1976 }
1977 
1978 static bool isSingleSourceMaskImpl(ArrayRef<int> Mask, int NumOpElts) {
1979   assert(!Mask.empty() && "Shuffle mask must contain elements");
1980   bool UsesLHS = false;
1981   bool UsesRHS = false;
1982   for (int i = 0, NumMaskElts = Mask.size(); i < NumMaskElts; ++i) {
1983     if (Mask[i] == -1)
1984       continue;
1985     assert(Mask[i] >= 0 && Mask[i] < (NumOpElts * 2) &&
1986            "Out-of-bounds shuffle mask element");
1987     UsesLHS |= (Mask[i] < NumOpElts);
1988     UsesRHS |= (Mask[i] >= NumOpElts);
1989     if (UsesLHS && UsesRHS)
1990       return false;
1991   }
1992   assert((UsesLHS ^ UsesRHS) && "Should have selected from exactly 1 source");
1993   return true;
1994 }
1995 
1996 bool ShuffleVectorInst::isSingleSourceMask(ArrayRef<int> Mask) {
1997   // We don't have vector operand size information, so assume operands are the
1998   // same size as the mask.
1999   return isSingleSourceMaskImpl(Mask, Mask.size());
2000 }
2001 
2002 static bool isIdentityMaskImpl(ArrayRef<int> Mask, int NumOpElts) {
2003   if (!isSingleSourceMaskImpl(Mask, NumOpElts))
2004     return false;
2005   for (int i = 0, NumMaskElts = Mask.size(); i < NumMaskElts; ++i) {
2006     if (Mask[i] == -1)
2007       continue;
2008     if (Mask[i] != i && Mask[i] != (NumOpElts + i))
2009       return false;
2010   }
2011   return true;
2012 }
2013 
2014 bool ShuffleVectorInst::isIdentityMask(ArrayRef<int> Mask) {
2015   // We don't have vector operand size information, so assume operands are the
2016   // same size as the mask.
2017   return isIdentityMaskImpl(Mask, Mask.size());
2018 }
2019 
2020 bool ShuffleVectorInst::isReverseMask(ArrayRef<int> Mask) {
2021   if (!isSingleSourceMask(Mask))
2022     return false;
2023   for (int i = 0, NumElts = Mask.size(); i < NumElts; ++i) {
2024     if (Mask[i] == -1)
2025       continue;
2026     if (Mask[i] != (NumElts - 1 - i) && Mask[i] != (NumElts + NumElts - 1 - i))
2027       return false;
2028   }
2029   return true;
2030 }
2031 
2032 bool ShuffleVectorInst::isZeroEltSplatMask(ArrayRef<int> Mask) {
2033   if (!isSingleSourceMask(Mask))
2034     return false;
2035   for (int i = 0, NumElts = Mask.size(); i < NumElts; ++i) {
2036     if (Mask[i] == -1)
2037       continue;
2038     if (Mask[i] != 0 && Mask[i] != NumElts)
2039       return false;
2040   }
2041   return true;
2042 }
2043 
2044 bool ShuffleVectorInst::isSelectMask(ArrayRef<int> Mask) {
2045   // Select is differentiated from identity. It requires using both sources.
2046   if (isSingleSourceMask(Mask))
2047     return false;
2048   for (int i = 0, NumElts = Mask.size(); i < NumElts; ++i) {
2049     if (Mask[i] == -1)
2050       continue;
2051     if (Mask[i] != i && Mask[i] != (NumElts + i))
2052       return false;
2053   }
2054   return true;
2055 }
2056 
2057 bool ShuffleVectorInst::isTransposeMask(ArrayRef<int> Mask) {
2058   // Example masks that will return true:
2059   // v1 = <a, b, c, d>
2060   // v2 = <e, f, g, h>
2061   // trn1 = shufflevector v1, v2 <0, 4, 2, 6> = <a, e, c, g>
2062   // trn2 = shufflevector v1, v2 <1, 5, 3, 7> = <b, f, d, h>
2063 
2064   // 1. The number of elements in the mask must be a power-of-2 and at least 2.
2065   int NumElts = Mask.size();
2066   if (NumElts < 2 || !isPowerOf2_32(NumElts))
2067     return false;
2068 
2069   // 2. The first element of the mask must be either a 0 or a 1.
2070   if (Mask[0] != 0 && Mask[0] != 1)
2071     return false;
2072 
2073   // 3. The difference between the first 2 elements must be equal to the
2074   // number of elements in the mask.
2075   if ((Mask[1] - Mask[0]) != NumElts)
2076     return false;
2077 
2078   // 4. The difference between consecutive even-numbered and odd-numbered
2079   // elements must be equal to 2.
2080   for (int i = 2; i < NumElts; ++i) {
2081     int MaskEltVal = Mask[i];
2082     if (MaskEltVal == -1)
2083       return false;
2084     int MaskEltPrevVal = Mask[i - 2];
2085     if (MaskEltVal - MaskEltPrevVal != 2)
2086       return false;
2087   }
2088   return true;
2089 }
2090 
2091 bool ShuffleVectorInst::isExtractSubvectorMask(ArrayRef<int> Mask,
2092                                                int NumSrcElts, int &Index) {
2093   // Must extract from a single source.
2094   if (!isSingleSourceMaskImpl(Mask, NumSrcElts))
2095     return false;
2096 
2097   // Must be smaller (else this is an Identity shuffle).
2098   if (NumSrcElts <= (int)Mask.size())
2099     return false;
2100 
2101   // Find start of extraction, accounting that we may start with an UNDEF.
2102   int SubIndex = -1;
2103   for (int i = 0, e = Mask.size(); i != e; ++i) {
2104     int M = Mask[i];
2105     if (M < 0)
2106       continue;
2107     int Offset = (M % NumSrcElts) - i;
2108     if (0 <= SubIndex && SubIndex != Offset)
2109       return false;
2110     SubIndex = Offset;
2111   }
2112 
2113   if (0 <= SubIndex && SubIndex + (int)Mask.size() <= NumSrcElts) {
2114     Index = SubIndex;
2115     return true;
2116   }
2117   return false;
2118 }
2119 
2120 bool ShuffleVectorInst::isIdentityWithPadding() const {
2121   int NumOpElts = Op<0>()->getType()->getVectorNumElements();
2122   int NumMaskElts = getType()->getVectorNumElements();
2123   if (NumMaskElts <= NumOpElts)
2124     return false;
2125 
2126   // The first part of the mask must choose elements from exactly 1 source op.
2127   SmallVector<int, 16> Mask = getShuffleMask();
2128   if (!isIdentityMaskImpl(Mask, NumOpElts))
2129     return false;
2130 
2131   // All extending must be with undef elements.
2132   for (int i = NumOpElts; i < NumMaskElts; ++i)
2133     if (Mask[i] != -1)
2134       return false;
2135 
2136   return true;
2137 }
2138 
2139 bool ShuffleVectorInst::isIdentityWithExtract() const {
2140   int NumOpElts = Op<0>()->getType()->getVectorNumElements();
2141   int NumMaskElts = getType()->getVectorNumElements();
2142   if (NumMaskElts >= NumOpElts)
2143     return false;
2144 
2145   return isIdentityMaskImpl(getShuffleMask(), NumOpElts);
2146 }
2147 
2148 bool ShuffleVectorInst::isConcat() const {
2149   // Vector concatenation is differentiated from identity with padding.
2150   if (isa<UndefValue>(Op<0>()) || isa<UndefValue>(Op<1>()))
2151     return false;
2152 
2153   int NumOpElts = Op<0>()->getType()->getVectorNumElements();
2154   int NumMaskElts = getType()->getVectorNumElements();
2155   if (NumMaskElts != NumOpElts * 2)
2156     return false;
2157 
2158   // Use the mask length rather than the operands' vector lengths here. We
2159   // already know that the shuffle returns a vector twice as long as the inputs,
2160   // and neither of the inputs are undef vectors. If the mask picks consecutive
2161   // elements from both inputs, then this is a concatenation of the inputs.
2162   return isIdentityMaskImpl(getShuffleMask(), NumMaskElts);
2163 }
2164 
2165 //===----------------------------------------------------------------------===//
2166 //                             InsertValueInst Class
2167 //===----------------------------------------------------------------------===//
2168 
2169 void InsertValueInst::init(Value *Agg, Value *Val, ArrayRef<unsigned> Idxs,
2170                            const Twine &Name) {
2171   assert(getNumOperands() == 2 && "NumOperands not initialized?");
2172 
2173   // There's no fundamental reason why we require at least one index
2174   // (other than weirdness with &*IdxBegin being invalid; see
2175   // getelementptr's init routine for example). But there's no
2176   // present need to support it.
2177   assert(!Idxs.empty() && "InsertValueInst must have at least one index");
2178 
2179   assert(ExtractValueInst::getIndexedType(Agg->getType(), Idxs) ==
2180          Val->getType() && "Inserted value must match indexed type!");
2181   Op<0>() = Agg;
2182   Op<1>() = Val;
2183 
2184   Indices.append(Idxs.begin(), Idxs.end());
2185   setName(Name);
2186 }
2187 
2188 InsertValueInst::InsertValueInst(const InsertValueInst &IVI)
2189   : Instruction(IVI.getType(), InsertValue,
2190                 OperandTraits<InsertValueInst>::op_begin(this), 2),
2191     Indices(IVI.Indices) {
2192   Op<0>() = IVI.getOperand(0);
2193   Op<1>() = IVI.getOperand(1);
2194   SubclassOptionalData = IVI.SubclassOptionalData;
2195 }
2196 
2197 //===----------------------------------------------------------------------===//
2198 //                             ExtractValueInst Class
2199 //===----------------------------------------------------------------------===//
2200 
2201 void ExtractValueInst::init(ArrayRef<unsigned> Idxs, const Twine &Name) {
2202   assert(getNumOperands() == 1 && "NumOperands not initialized?");
2203 
2204   // There's no fundamental reason why we require at least one index.
2205   // But there's no present need to support it.
2206   assert(!Idxs.empty() && "ExtractValueInst must have at least one index");
2207 
2208   Indices.append(Idxs.begin(), Idxs.end());
2209   setName(Name);
2210 }
2211 
2212 ExtractValueInst::ExtractValueInst(const ExtractValueInst &EVI)
2213   : UnaryInstruction(EVI.getType(), ExtractValue, EVI.getOperand(0)),
2214     Indices(EVI.Indices) {
2215   SubclassOptionalData = EVI.SubclassOptionalData;
2216 }
2217 
2218 // getIndexedType - Returns the type of the element that would be extracted
2219 // with an extractvalue instruction with the specified parameters.
2220 //
2221 // A null type is returned if the indices are invalid for the specified
2222 // pointer type.
2223 //
2224 Type *ExtractValueInst::getIndexedType(Type *Agg,
2225                                        ArrayRef<unsigned> Idxs) {
2226   for (unsigned Index : Idxs) {
2227     // We can't use CompositeType::indexValid(Index) here.
2228     // indexValid() always returns true for arrays because getelementptr allows
2229     // out-of-bounds indices. Since we don't allow those for extractvalue and
2230     // insertvalue we need to check array indexing manually.
2231     // Since the only other types we can index into are struct types it's just
2232     // as easy to check those manually as well.
2233     if (ArrayType *AT = dyn_cast<ArrayType>(Agg)) {
2234       if (Index >= AT->getNumElements())
2235         return nullptr;
2236       Agg = AT->getElementType();
2237     } else if (StructType *ST = dyn_cast<StructType>(Agg)) {
2238       if (Index >= ST->getNumElements())
2239         return nullptr;
2240       Agg = ST->getElementType(Index);
2241     } else {
2242       // Not a valid type to index into.
2243       return nullptr;
2244     }
2245   }
2246   return const_cast<Type*>(Agg);
2247 }
2248 
2249 //===----------------------------------------------------------------------===//
2250 //                             UnaryOperator Class
2251 //===----------------------------------------------------------------------===//
2252 
2253 UnaryOperator::UnaryOperator(UnaryOps iType, Value *S,
2254                              Type *Ty, const Twine &Name,
2255                              Instruction *InsertBefore)
2256   : UnaryInstruction(Ty, iType, S, InsertBefore) {
2257   Op<0>() = S;
2258   setName(Name);
2259   AssertOK();
2260 }
2261 
2262 UnaryOperator::UnaryOperator(UnaryOps iType, Value *S,
2263                              Type *Ty, const Twine &Name,
2264                              BasicBlock *InsertAtEnd)
2265   : UnaryInstruction(Ty, iType, S, InsertAtEnd) {
2266   Op<0>() = S;
2267   setName(Name);
2268   AssertOK();
2269 }
2270 
2271 UnaryOperator *UnaryOperator::Create(UnaryOps Op, Value *S,
2272                                      const Twine &Name,
2273                                      Instruction *InsertBefore) {
2274   return new UnaryOperator(Op, S, S->getType(), Name, InsertBefore);
2275 }
2276 
2277 UnaryOperator *UnaryOperator::Create(UnaryOps Op, Value *S,
2278                                      const Twine &Name,
2279                                      BasicBlock *InsertAtEnd) {
2280   UnaryOperator *Res = Create(Op, S, Name);
2281   InsertAtEnd->getInstList().push_back(Res);
2282   return Res;
2283 }
2284 
2285 void UnaryOperator::AssertOK() {
2286   Value *LHS = getOperand(0);
2287   (void)LHS; // Silence warnings.
2288 #ifndef NDEBUG
2289   switch (getOpcode()) {
2290   case FNeg:
2291     assert(getType() == LHS->getType() &&
2292            "Unary operation should return same type as operand!");
2293     assert(getType()->isFPOrFPVectorTy() &&
2294            "Tried to create a floating-point operation on a "
2295            "non-floating-point type!");
2296     break;
2297   default: llvm_unreachable("Invalid opcode provided");
2298   }
2299 #endif
2300 }
2301 
2302 //===----------------------------------------------------------------------===//
2303 //                             BinaryOperator Class
2304 //===----------------------------------------------------------------------===//
2305 
2306 BinaryOperator::BinaryOperator(BinaryOps iType, Value *S1, Value *S2,
2307                                Type *Ty, const Twine &Name,
2308                                Instruction *InsertBefore)
2309   : Instruction(Ty, iType,
2310                 OperandTraits<BinaryOperator>::op_begin(this),
2311                 OperandTraits<BinaryOperator>::operands(this),
2312                 InsertBefore) {
2313   Op<0>() = S1;
2314   Op<1>() = S2;
2315   setName(Name);
2316   AssertOK();
2317 }
2318 
2319 BinaryOperator::BinaryOperator(BinaryOps iType, Value *S1, Value *S2,
2320                                Type *Ty, const Twine &Name,
2321                                BasicBlock *InsertAtEnd)
2322   : Instruction(Ty, iType,
2323                 OperandTraits<BinaryOperator>::op_begin(this),
2324                 OperandTraits<BinaryOperator>::operands(this),
2325                 InsertAtEnd) {
2326   Op<0>() = S1;
2327   Op<1>() = S2;
2328   setName(Name);
2329   AssertOK();
2330 }
2331 
2332 void BinaryOperator::AssertOK() {
2333   Value *LHS = getOperand(0), *RHS = getOperand(1);
2334   (void)LHS; (void)RHS; // Silence warnings.
2335   assert(LHS->getType() == RHS->getType() &&
2336          "Binary operator operand types must match!");
2337 #ifndef NDEBUG
2338   switch (getOpcode()) {
2339   case Add: case Sub:
2340   case Mul:
2341     assert(getType() == LHS->getType() &&
2342            "Arithmetic operation should return same type as operands!");
2343     assert(getType()->isIntOrIntVectorTy() &&
2344            "Tried to create an integer operation on a non-integer type!");
2345     break;
2346   case FAdd: case FSub:
2347   case FMul:
2348     assert(getType() == LHS->getType() &&
2349            "Arithmetic operation should return same type as operands!");
2350     assert(getType()->isFPOrFPVectorTy() &&
2351            "Tried to create a floating-point operation on a "
2352            "non-floating-point type!");
2353     break;
2354   case UDiv:
2355   case SDiv:
2356     assert(getType() == LHS->getType() &&
2357            "Arithmetic operation should return same type as operands!");
2358     assert(getType()->isIntOrIntVectorTy() &&
2359            "Incorrect operand type (not integer) for S/UDIV");
2360     break;
2361   case FDiv:
2362     assert(getType() == LHS->getType() &&
2363            "Arithmetic operation should return same type as operands!");
2364     assert(getType()->isFPOrFPVectorTy() &&
2365            "Incorrect operand type (not floating point) for FDIV");
2366     break;
2367   case URem:
2368   case SRem:
2369     assert(getType() == LHS->getType() &&
2370            "Arithmetic operation should return same type as operands!");
2371     assert(getType()->isIntOrIntVectorTy() &&
2372            "Incorrect operand type (not integer) for S/UREM");
2373     break;
2374   case FRem:
2375     assert(getType() == LHS->getType() &&
2376            "Arithmetic operation should return same type as operands!");
2377     assert(getType()->isFPOrFPVectorTy() &&
2378            "Incorrect operand type (not floating point) for FREM");
2379     break;
2380   case Shl:
2381   case LShr:
2382   case AShr:
2383     assert(getType() == LHS->getType() &&
2384            "Shift operation should return same type as operands!");
2385     assert(getType()->isIntOrIntVectorTy() &&
2386            "Tried to create a shift operation on a non-integral type!");
2387     break;
2388   case And: case Or:
2389   case Xor:
2390     assert(getType() == LHS->getType() &&
2391            "Logical operation should return same type as operands!");
2392     assert(getType()->isIntOrIntVectorTy() &&
2393            "Tried to create a logical operation on a non-integral type!");
2394     break;
2395   default: llvm_unreachable("Invalid opcode provided");
2396   }
2397 #endif
2398 }
2399 
2400 BinaryOperator *BinaryOperator::Create(BinaryOps Op, Value *S1, Value *S2,
2401                                        const Twine &Name,
2402                                        Instruction *InsertBefore) {
2403   assert(S1->getType() == S2->getType() &&
2404          "Cannot create binary operator with two operands of differing type!");
2405   return new BinaryOperator(Op, S1, S2, S1->getType(), Name, InsertBefore);
2406 }
2407 
2408 BinaryOperator *BinaryOperator::Create(BinaryOps Op, Value *S1, Value *S2,
2409                                        const Twine &Name,
2410                                        BasicBlock *InsertAtEnd) {
2411   BinaryOperator *Res = Create(Op, S1, S2, Name);
2412   InsertAtEnd->getInstList().push_back(Res);
2413   return Res;
2414 }
2415 
2416 BinaryOperator *BinaryOperator::CreateNeg(Value *Op, const Twine &Name,
2417                                           Instruction *InsertBefore) {
2418   Value *zero = ConstantFP::getZeroValueForNegation(Op->getType());
2419   return new BinaryOperator(Instruction::Sub,
2420                             zero, Op,
2421                             Op->getType(), Name, InsertBefore);
2422 }
2423 
2424 BinaryOperator *BinaryOperator::CreateNeg(Value *Op, const Twine &Name,
2425                                           BasicBlock *InsertAtEnd) {
2426   Value *zero = ConstantFP::getZeroValueForNegation(Op->getType());
2427   return new BinaryOperator(Instruction::Sub,
2428                             zero, Op,
2429                             Op->getType(), Name, InsertAtEnd);
2430 }
2431 
2432 BinaryOperator *BinaryOperator::CreateNSWNeg(Value *Op, const Twine &Name,
2433                                              Instruction *InsertBefore) {
2434   Value *zero = ConstantFP::getZeroValueForNegation(Op->getType());
2435   return BinaryOperator::CreateNSWSub(zero, Op, Name, InsertBefore);
2436 }
2437 
2438 BinaryOperator *BinaryOperator::CreateNSWNeg(Value *Op, const Twine &Name,
2439                                              BasicBlock *InsertAtEnd) {
2440   Value *zero = ConstantFP::getZeroValueForNegation(Op->getType());
2441   return BinaryOperator::CreateNSWSub(zero, Op, Name, InsertAtEnd);
2442 }
2443 
2444 BinaryOperator *BinaryOperator::CreateNUWNeg(Value *Op, const Twine &Name,
2445                                              Instruction *InsertBefore) {
2446   Value *zero = ConstantFP::getZeroValueForNegation(Op->getType());
2447   return BinaryOperator::CreateNUWSub(zero, Op, Name, InsertBefore);
2448 }
2449 
2450 BinaryOperator *BinaryOperator::CreateNUWNeg(Value *Op, const Twine &Name,
2451                                              BasicBlock *InsertAtEnd) {
2452   Value *zero = ConstantFP::getZeroValueForNegation(Op->getType());
2453   return BinaryOperator::CreateNUWSub(zero, Op, Name, InsertAtEnd);
2454 }
2455 
2456 BinaryOperator *BinaryOperator::CreateNot(Value *Op, const Twine &Name,
2457                                           Instruction *InsertBefore) {
2458   Constant *C = Constant::getAllOnesValue(Op->getType());
2459   return new BinaryOperator(Instruction::Xor, Op, C,
2460                             Op->getType(), Name, InsertBefore);
2461 }
2462 
2463 BinaryOperator *BinaryOperator::CreateNot(Value *Op, const Twine &Name,
2464                                           BasicBlock *InsertAtEnd) {
2465   Constant *AllOnes = Constant::getAllOnesValue(Op->getType());
2466   return new BinaryOperator(Instruction::Xor, Op, AllOnes,
2467                             Op->getType(), Name, InsertAtEnd);
2468 }
2469 
2470 // Exchange the two operands to this instruction. This instruction is safe to
2471 // use on any binary instruction and does not modify the semantics of the
2472 // instruction. If the instruction is order-dependent (SetLT f.e.), the opcode
2473 // is changed.
2474 bool BinaryOperator::swapOperands() {
2475   if (!isCommutative())
2476     return true; // Can't commute operands
2477   Op<0>().swap(Op<1>());
2478   return false;
2479 }
2480 
2481 //===----------------------------------------------------------------------===//
2482 //                             FPMathOperator Class
2483 //===----------------------------------------------------------------------===//
2484 
2485 float FPMathOperator::getFPAccuracy() const {
2486   const MDNode *MD =
2487       cast<Instruction>(this)->getMetadata(LLVMContext::MD_fpmath);
2488   if (!MD)
2489     return 0.0;
2490   ConstantFP *Accuracy = mdconst::extract<ConstantFP>(MD->getOperand(0));
2491   return Accuracy->getValueAPF().convertToFloat();
2492 }
2493 
2494 //===----------------------------------------------------------------------===//
2495 //                                CastInst Class
2496 //===----------------------------------------------------------------------===//
2497 
2498 // Just determine if this cast only deals with integral->integral conversion.
2499 bool CastInst::isIntegerCast() const {
2500   switch (getOpcode()) {
2501     default: return false;
2502     case Instruction::ZExt:
2503     case Instruction::SExt:
2504     case Instruction::Trunc:
2505       return true;
2506     case Instruction::BitCast:
2507       return getOperand(0)->getType()->isIntegerTy() &&
2508         getType()->isIntegerTy();
2509   }
2510 }
2511 
2512 bool CastInst::isLosslessCast() const {
2513   // Only BitCast can be lossless, exit fast if we're not BitCast
2514   if (getOpcode() != Instruction::BitCast)
2515     return false;
2516 
2517   // Identity cast is always lossless
2518   Type *SrcTy = getOperand(0)->getType();
2519   Type *DstTy = getType();
2520   if (SrcTy == DstTy)
2521     return true;
2522 
2523   // Pointer to pointer is always lossless.
2524   if (SrcTy->isPointerTy())
2525     return DstTy->isPointerTy();
2526   return false;  // Other types have no identity values
2527 }
2528 
2529 /// This function determines if the CastInst does not require any bits to be
2530 /// changed in order to effect the cast. Essentially, it identifies cases where
2531 /// no code gen is necessary for the cast, hence the name no-op cast.  For
2532 /// example, the following are all no-op casts:
2533 /// # bitcast i32* %x to i8*
2534 /// # bitcast <2 x i32> %x to <4 x i16>
2535 /// # ptrtoint i32* %x to i32     ; on 32-bit plaforms only
2536 /// Determine if the described cast is a no-op.
2537 bool CastInst::isNoopCast(Instruction::CastOps Opcode,
2538                           Type *SrcTy,
2539                           Type *DestTy,
2540                           const DataLayout &DL) {
2541   switch (Opcode) {
2542     default: llvm_unreachable("Invalid CastOp");
2543     case Instruction::Trunc:
2544     case Instruction::ZExt:
2545     case Instruction::SExt:
2546     case Instruction::FPTrunc:
2547     case Instruction::FPExt:
2548     case Instruction::UIToFP:
2549     case Instruction::SIToFP:
2550     case Instruction::FPToUI:
2551     case Instruction::FPToSI:
2552     case Instruction::AddrSpaceCast:
2553       // TODO: Target informations may give a more accurate answer here.
2554       return false;
2555     case Instruction::BitCast:
2556       return true;  // BitCast never modifies bits.
2557     case Instruction::PtrToInt:
2558       return DL.getIntPtrType(SrcTy)->getScalarSizeInBits() ==
2559              DestTy->getScalarSizeInBits();
2560     case Instruction::IntToPtr:
2561       return DL.getIntPtrType(DestTy)->getScalarSizeInBits() ==
2562              SrcTy->getScalarSizeInBits();
2563   }
2564 }
2565 
2566 bool CastInst::isNoopCast(const DataLayout &DL) const {
2567   return isNoopCast(getOpcode(), getOperand(0)->getType(), getType(), DL);
2568 }
2569 
2570 /// This function determines if a pair of casts can be eliminated and what
2571 /// opcode should be used in the elimination. This assumes that there are two
2572 /// instructions like this:
2573 /// *  %F = firstOpcode SrcTy %x to MidTy
2574 /// *  %S = secondOpcode MidTy %F to DstTy
2575 /// The function returns a resultOpcode so these two casts can be replaced with:
2576 /// *  %Replacement = resultOpcode %SrcTy %x to DstTy
2577 /// If no such cast is permitted, the function returns 0.
2578 unsigned CastInst::isEliminableCastPair(
2579   Instruction::CastOps firstOp, Instruction::CastOps secondOp,
2580   Type *SrcTy, Type *MidTy, Type *DstTy, Type *SrcIntPtrTy, Type *MidIntPtrTy,
2581   Type *DstIntPtrTy) {
2582   // Define the 144 possibilities for these two cast instructions. The values
2583   // in this matrix determine what to do in a given situation and select the
2584   // case in the switch below.  The rows correspond to firstOp, the columns
2585   // correspond to secondOp.  In looking at the table below, keep in mind
2586   // the following cast properties:
2587   //
2588   //          Size Compare       Source               Destination
2589   // Operator  Src ? Size   Type       Sign         Type       Sign
2590   // -------- ------------ -------------------   ---------------------
2591   // TRUNC         >       Integer      Any        Integral     Any
2592   // ZEXT          <       Integral   Unsigned     Integer      Any
2593   // SEXT          <       Integral    Signed      Integer      Any
2594   // FPTOUI       n/a      FloatPt      n/a        Integral   Unsigned
2595   // FPTOSI       n/a      FloatPt      n/a        Integral    Signed
2596   // UITOFP       n/a      Integral   Unsigned     FloatPt      n/a
2597   // SITOFP       n/a      Integral    Signed      FloatPt      n/a
2598   // FPTRUNC       >       FloatPt      n/a        FloatPt      n/a
2599   // FPEXT         <       FloatPt      n/a        FloatPt      n/a
2600   // PTRTOINT     n/a      Pointer      n/a        Integral   Unsigned
2601   // INTTOPTR     n/a      Integral   Unsigned     Pointer      n/a
2602   // BITCAST       =       FirstClass   n/a       FirstClass    n/a
2603   // ADDRSPCST    n/a      Pointer      n/a        Pointer      n/a
2604   //
2605   // NOTE: some transforms are safe, but we consider them to be non-profitable.
2606   // For example, we could merge "fptoui double to i32" + "zext i32 to i64",
2607   // into "fptoui double to i64", but this loses information about the range
2608   // of the produced value (we no longer know the top-part is all zeros).
2609   // Further this conversion is often much more expensive for typical hardware,
2610   // and causes issues when building libgcc.  We disallow fptosi+sext for the
2611   // same reason.
2612   const unsigned numCastOps =
2613     Instruction::CastOpsEnd - Instruction::CastOpsBegin;
2614   static const uint8_t CastResults[numCastOps][numCastOps] = {
2615     // T        F  F  U  S  F  F  P  I  B  A  -+
2616     // R  Z  S  P  P  I  I  T  P  2  N  T  S   |
2617     // U  E  E  2  2  2  2  R  E  I  T  C  C   +- secondOp
2618     // N  X  X  U  S  F  F  N  X  N  2  V  V   |
2619     // C  T  T  I  I  P  P  C  T  T  P  T  T  -+
2620     {  1, 0, 0,99,99, 0, 0,99,99,99, 0, 3, 0}, // Trunc         -+
2621     {  8, 1, 9,99,99, 2,17,99,99,99, 2, 3, 0}, // ZExt           |
2622     {  8, 0, 1,99,99, 0, 2,99,99,99, 0, 3, 0}, // SExt           |
2623     {  0, 0, 0,99,99, 0, 0,99,99,99, 0, 3, 0}, // FPToUI         |
2624     {  0, 0, 0,99,99, 0, 0,99,99,99, 0, 3, 0}, // FPToSI         |
2625     { 99,99,99, 0, 0,99,99, 0, 0,99,99, 4, 0}, // UIToFP         +- firstOp
2626     { 99,99,99, 0, 0,99,99, 0, 0,99,99, 4, 0}, // SIToFP         |
2627     { 99,99,99, 0, 0,99,99, 0, 0,99,99, 4, 0}, // FPTrunc        |
2628     { 99,99,99, 2, 2,99,99, 8, 2,99,99, 4, 0}, // FPExt          |
2629     {  1, 0, 0,99,99, 0, 0,99,99,99, 7, 3, 0}, // PtrToInt       |
2630     { 99,99,99,99,99,99,99,99,99,11,99,15, 0}, // IntToPtr       |
2631     {  5, 5, 5, 6, 6, 5, 5, 6, 6,16, 5, 1,14}, // BitCast        |
2632     {  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,13,12}, // AddrSpaceCast -+
2633   };
2634 
2635   // TODO: This logic could be encoded into the table above and handled in the
2636   // switch below.
2637   // If either of the casts are a bitcast from scalar to vector, disallow the
2638   // merging. However, any pair of bitcasts are allowed.
2639   bool IsFirstBitcast  = (firstOp == Instruction::BitCast);
2640   bool IsSecondBitcast = (secondOp == Instruction::BitCast);
2641   bool AreBothBitcasts = IsFirstBitcast && IsSecondBitcast;
2642 
2643   // Check if any of the casts convert scalars <-> vectors.
2644   if ((IsFirstBitcast  && isa<VectorType>(SrcTy) != isa<VectorType>(MidTy)) ||
2645       (IsSecondBitcast && isa<VectorType>(MidTy) != isa<VectorType>(DstTy)))
2646     if (!AreBothBitcasts)
2647       return 0;
2648 
2649   int ElimCase = CastResults[firstOp-Instruction::CastOpsBegin]
2650                             [secondOp-Instruction::CastOpsBegin];
2651   switch (ElimCase) {
2652     case 0:
2653       // Categorically disallowed.
2654       return 0;
2655     case 1:
2656       // Allowed, use first cast's opcode.
2657       return firstOp;
2658     case 2:
2659       // Allowed, use second cast's opcode.
2660       return secondOp;
2661     case 3:
2662       // No-op cast in second op implies firstOp as long as the DestTy
2663       // is integer and we are not converting between a vector and a
2664       // non-vector type.
2665       if (!SrcTy->isVectorTy() && DstTy->isIntegerTy())
2666         return firstOp;
2667       return 0;
2668     case 4:
2669       // No-op cast in second op implies firstOp as long as the DestTy
2670       // is floating point.
2671       if (DstTy->isFloatingPointTy())
2672         return firstOp;
2673       return 0;
2674     case 5:
2675       // No-op cast in first op implies secondOp as long as the SrcTy
2676       // is an integer.
2677       if (SrcTy->isIntegerTy())
2678         return secondOp;
2679       return 0;
2680     case 6:
2681       // No-op cast in first op implies secondOp as long as the SrcTy
2682       // is a floating point.
2683       if (SrcTy->isFloatingPointTy())
2684         return secondOp;
2685       return 0;
2686     case 7: {
2687       // Cannot simplify if address spaces are different!
2688       if (SrcTy->getPointerAddressSpace() != DstTy->getPointerAddressSpace())
2689         return 0;
2690 
2691       unsigned MidSize = MidTy->getScalarSizeInBits();
2692       // We can still fold this without knowing the actual sizes as long we
2693       // know that the intermediate pointer is the largest possible
2694       // pointer size.
2695       // FIXME: Is this always true?
2696       if (MidSize == 64)
2697         return Instruction::BitCast;
2698 
2699       // ptrtoint, inttoptr -> bitcast (ptr -> ptr) if int size is >= ptr size.
2700       if (!SrcIntPtrTy || DstIntPtrTy != SrcIntPtrTy)
2701         return 0;
2702       unsigned PtrSize = SrcIntPtrTy->getScalarSizeInBits();
2703       if (MidSize >= PtrSize)
2704         return Instruction::BitCast;
2705       return 0;
2706     }
2707     case 8: {
2708       // ext, trunc -> bitcast,    if the SrcTy and DstTy are same size
2709       // ext, trunc -> ext,        if sizeof(SrcTy) < sizeof(DstTy)
2710       // ext, trunc -> trunc,      if sizeof(SrcTy) > sizeof(DstTy)
2711       unsigned SrcSize = SrcTy->getScalarSizeInBits();
2712       unsigned DstSize = DstTy->getScalarSizeInBits();
2713       if (SrcSize == DstSize)
2714         return Instruction::BitCast;
2715       else if (SrcSize < DstSize)
2716         return firstOp;
2717       return secondOp;
2718     }
2719     case 9:
2720       // zext, sext -> zext, because sext can't sign extend after zext
2721       return Instruction::ZExt;
2722     case 11: {
2723       // inttoptr, ptrtoint -> bitcast if SrcSize<=PtrSize and SrcSize==DstSize
2724       if (!MidIntPtrTy)
2725         return 0;
2726       unsigned PtrSize = MidIntPtrTy->getScalarSizeInBits();
2727       unsigned SrcSize = SrcTy->getScalarSizeInBits();
2728       unsigned DstSize = DstTy->getScalarSizeInBits();
2729       if (SrcSize <= PtrSize && SrcSize == DstSize)
2730         return Instruction::BitCast;
2731       return 0;
2732     }
2733     case 12:
2734       // addrspacecast, addrspacecast -> bitcast,       if SrcAS == DstAS
2735       // addrspacecast, addrspacecast -> addrspacecast, if SrcAS != DstAS
2736       if (SrcTy->getPointerAddressSpace() != DstTy->getPointerAddressSpace())
2737         return Instruction::AddrSpaceCast;
2738       return Instruction::BitCast;
2739     case 13:
2740       // FIXME: this state can be merged with (1), but the following assert
2741       // is useful to check the correcteness of the sequence due to semantic
2742       // change of bitcast.
2743       assert(
2744         SrcTy->isPtrOrPtrVectorTy() &&
2745         MidTy->isPtrOrPtrVectorTy() &&
2746         DstTy->isPtrOrPtrVectorTy() &&
2747         SrcTy->getPointerAddressSpace() != MidTy->getPointerAddressSpace() &&
2748         MidTy->getPointerAddressSpace() == DstTy->getPointerAddressSpace() &&
2749         "Illegal addrspacecast, bitcast sequence!");
2750       // Allowed, use first cast's opcode
2751       return firstOp;
2752     case 14:
2753       // bitcast, addrspacecast -> addrspacecast if the element type of
2754       // bitcast's source is the same as that of addrspacecast's destination.
2755       if (SrcTy->getScalarType()->getPointerElementType() ==
2756           DstTy->getScalarType()->getPointerElementType())
2757         return Instruction::AddrSpaceCast;
2758       return 0;
2759     case 15:
2760       // FIXME: this state can be merged with (1), but the following assert
2761       // is useful to check the correcteness of the sequence due to semantic
2762       // change of bitcast.
2763       assert(
2764         SrcTy->isIntOrIntVectorTy() &&
2765         MidTy->isPtrOrPtrVectorTy() &&
2766         DstTy->isPtrOrPtrVectorTy() &&
2767         MidTy->getPointerAddressSpace() == DstTy->getPointerAddressSpace() &&
2768         "Illegal inttoptr, bitcast sequence!");
2769       // Allowed, use first cast's opcode
2770       return firstOp;
2771     case 16:
2772       // FIXME: this state can be merged with (2), but the following assert
2773       // is useful to check the correcteness of the sequence due to semantic
2774       // change of bitcast.
2775       assert(
2776         SrcTy->isPtrOrPtrVectorTy() &&
2777         MidTy->isPtrOrPtrVectorTy() &&
2778         DstTy->isIntOrIntVectorTy() &&
2779         SrcTy->getPointerAddressSpace() == MidTy->getPointerAddressSpace() &&
2780         "Illegal bitcast, ptrtoint sequence!");
2781       // Allowed, use second cast's opcode
2782       return secondOp;
2783     case 17:
2784       // (sitofp (zext x)) -> (uitofp x)
2785       return Instruction::UIToFP;
2786     case 99:
2787       // Cast combination can't happen (error in input). This is for all cases
2788       // where the MidTy is not the same for the two cast instructions.
2789       llvm_unreachable("Invalid Cast Combination");
2790     default:
2791       llvm_unreachable("Error in CastResults table!!!");
2792   }
2793 }
2794 
2795 CastInst *CastInst::Create(Instruction::CastOps op, Value *S, Type *Ty,
2796   const Twine &Name, Instruction *InsertBefore) {
2797   assert(castIsValid(op, S, Ty) && "Invalid cast!");
2798   // Construct and return the appropriate CastInst subclass
2799   switch (op) {
2800   case Trunc:         return new TruncInst         (S, Ty, Name, InsertBefore);
2801   case ZExt:          return new ZExtInst          (S, Ty, Name, InsertBefore);
2802   case SExt:          return new SExtInst          (S, Ty, Name, InsertBefore);
2803   case FPTrunc:       return new FPTruncInst       (S, Ty, Name, InsertBefore);
2804   case FPExt:         return new FPExtInst         (S, Ty, Name, InsertBefore);
2805   case UIToFP:        return new UIToFPInst        (S, Ty, Name, InsertBefore);
2806   case SIToFP:        return new SIToFPInst        (S, Ty, Name, InsertBefore);
2807   case FPToUI:        return new FPToUIInst        (S, Ty, Name, InsertBefore);
2808   case FPToSI:        return new FPToSIInst        (S, Ty, Name, InsertBefore);
2809   case PtrToInt:      return new PtrToIntInst      (S, Ty, Name, InsertBefore);
2810   case IntToPtr:      return new IntToPtrInst      (S, Ty, Name, InsertBefore);
2811   case BitCast:       return new BitCastInst       (S, Ty, Name, InsertBefore);
2812   case AddrSpaceCast: return new AddrSpaceCastInst (S, Ty, Name, InsertBefore);
2813   default: llvm_unreachable("Invalid opcode provided");
2814   }
2815 }
2816 
2817 CastInst *CastInst::Create(Instruction::CastOps op, Value *S, Type *Ty,
2818   const Twine &Name, BasicBlock *InsertAtEnd) {
2819   assert(castIsValid(op, S, Ty) && "Invalid cast!");
2820   // Construct and return the appropriate CastInst subclass
2821   switch (op) {
2822   case Trunc:         return new TruncInst         (S, Ty, Name, InsertAtEnd);
2823   case ZExt:          return new ZExtInst          (S, Ty, Name, InsertAtEnd);
2824   case SExt:          return new SExtInst          (S, Ty, Name, InsertAtEnd);
2825   case FPTrunc:       return new FPTruncInst       (S, Ty, Name, InsertAtEnd);
2826   case FPExt:         return new FPExtInst         (S, Ty, Name, InsertAtEnd);
2827   case UIToFP:        return new UIToFPInst        (S, Ty, Name, InsertAtEnd);
2828   case SIToFP:        return new SIToFPInst        (S, Ty, Name, InsertAtEnd);
2829   case FPToUI:        return new FPToUIInst        (S, Ty, Name, InsertAtEnd);
2830   case FPToSI:        return new FPToSIInst        (S, Ty, Name, InsertAtEnd);
2831   case PtrToInt:      return new PtrToIntInst      (S, Ty, Name, InsertAtEnd);
2832   case IntToPtr:      return new IntToPtrInst      (S, Ty, Name, InsertAtEnd);
2833   case BitCast:       return new BitCastInst       (S, Ty, Name, InsertAtEnd);
2834   case AddrSpaceCast: return new AddrSpaceCastInst (S, Ty, Name, InsertAtEnd);
2835   default: llvm_unreachable("Invalid opcode provided");
2836   }
2837 }
2838 
2839 CastInst *CastInst::CreateZExtOrBitCast(Value *S, Type *Ty,
2840                                         const Twine &Name,
2841                                         Instruction *InsertBefore) {
2842   if (S->getType()->getScalarSizeInBits() == Ty->getScalarSizeInBits())
2843     return Create(Instruction::BitCast, S, Ty, Name, InsertBefore);
2844   return Create(Instruction::ZExt, S, Ty, Name, InsertBefore);
2845 }
2846 
2847 CastInst *CastInst::CreateZExtOrBitCast(Value *S, Type *Ty,
2848                                         const Twine &Name,
2849                                         BasicBlock *InsertAtEnd) {
2850   if (S->getType()->getScalarSizeInBits() == Ty->getScalarSizeInBits())
2851     return Create(Instruction::BitCast, S, Ty, Name, InsertAtEnd);
2852   return Create(Instruction::ZExt, S, Ty, Name, InsertAtEnd);
2853 }
2854 
2855 CastInst *CastInst::CreateSExtOrBitCast(Value *S, Type *Ty,
2856                                         const Twine &Name,
2857                                         Instruction *InsertBefore) {
2858   if (S->getType()->getScalarSizeInBits() == Ty->getScalarSizeInBits())
2859     return Create(Instruction::BitCast, S, Ty, Name, InsertBefore);
2860   return Create(Instruction::SExt, S, Ty, Name, InsertBefore);
2861 }
2862 
2863 CastInst *CastInst::CreateSExtOrBitCast(Value *S, Type *Ty,
2864                                         const Twine &Name,
2865                                         BasicBlock *InsertAtEnd) {
2866   if (S->getType()->getScalarSizeInBits() == Ty->getScalarSizeInBits())
2867     return Create(Instruction::BitCast, S, Ty, Name, InsertAtEnd);
2868   return Create(Instruction::SExt, S, Ty, Name, InsertAtEnd);
2869 }
2870 
2871 CastInst *CastInst::CreateTruncOrBitCast(Value *S, Type *Ty,
2872                                          const Twine &Name,
2873                                          Instruction *InsertBefore) {
2874   if (S->getType()->getScalarSizeInBits() == Ty->getScalarSizeInBits())
2875     return Create(Instruction::BitCast, S, Ty, Name, InsertBefore);
2876   return Create(Instruction::Trunc, S, Ty, Name, InsertBefore);
2877 }
2878 
2879 CastInst *CastInst::CreateTruncOrBitCast(Value *S, Type *Ty,
2880                                          const Twine &Name,
2881                                          BasicBlock *InsertAtEnd) {
2882   if (S->getType()->getScalarSizeInBits() == Ty->getScalarSizeInBits())
2883     return Create(Instruction::BitCast, S, Ty, Name, InsertAtEnd);
2884   return Create(Instruction::Trunc, S, Ty, Name, InsertAtEnd);
2885 }
2886 
2887 CastInst *CastInst::CreatePointerCast(Value *S, Type *Ty,
2888                                       const Twine &Name,
2889                                       BasicBlock *InsertAtEnd) {
2890   assert(S->getType()->isPtrOrPtrVectorTy() && "Invalid cast");
2891   assert((Ty->isIntOrIntVectorTy() || Ty->isPtrOrPtrVectorTy()) &&
2892          "Invalid cast");
2893   assert(Ty->isVectorTy() == S->getType()->isVectorTy() && "Invalid cast");
2894   assert((!Ty->isVectorTy() ||
2895           Ty->getVectorNumElements() == S->getType()->getVectorNumElements()) &&
2896          "Invalid cast");
2897 
2898   if (Ty->isIntOrIntVectorTy())
2899     return Create(Instruction::PtrToInt, S, Ty, Name, InsertAtEnd);
2900 
2901   return CreatePointerBitCastOrAddrSpaceCast(S, Ty, Name, InsertAtEnd);
2902 }
2903 
2904 /// Create a BitCast or a PtrToInt cast instruction
2905 CastInst *CastInst::CreatePointerCast(Value *S, Type *Ty,
2906                                       const Twine &Name,
2907                                       Instruction *InsertBefore) {
2908   assert(S->getType()->isPtrOrPtrVectorTy() && "Invalid cast");
2909   assert((Ty->isIntOrIntVectorTy() || Ty->isPtrOrPtrVectorTy()) &&
2910          "Invalid cast");
2911   assert(Ty->isVectorTy() == S->getType()->isVectorTy() && "Invalid cast");
2912   assert((!Ty->isVectorTy() ||
2913           Ty->getVectorNumElements() == S->getType()->getVectorNumElements()) &&
2914          "Invalid cast");
2915 
2916   if (Ty->isIntOrIntVectorTy())
2917     return Create(Instruction::PtrToInt, S, Ty, Name, InsertBefore);
2918 
2919   return CreatePointerBitCastOrAddrSpaceCast(S, Ty, Name, InsertBefore);
2920 }
2921 
2922 CastInst *CastInst::CreatePointerBitCastOrAddrSpaceCast(
2923   Value *S, Type *Ty,
2924   const Twine &Name,
2925   BasicBlock *InsertAtEnd) {
2926   assert(S->getType()->isPtrOrPtrVectorTy() && "Invalid cast");
2927   assert(Ty->isPtrOrPtrVectorTy() && "Invalid cast");
2928 
2929   if (S->getType()->getPointerAddressSpace() != Ty->getPointerAddressSpace())
2930     return Create(Instruction::AddrSpaceCast, S, Ty, Name, InsertAtEnd);
2931 
2932   return Create(Instruction::BitCast, S, Ty, Name, InsertAtEnd);
2933 }
2934 
2935 CastInst *CastInst::CreatePointerBitCastOrAddrSpaceCast(
2936   Value *S, Type *Ty,
2937   const Twine &Name,
2938   Instruction *InsertBefore) {
2939   assert(S->getType()->isPtrOrPtrVectorTy() && "Invalid cast");
2940   assert(Ty->isPtrOrPtrVectorTy() && "Invalid cast");
2941 
2942   if (S->getType()->getPointerAddressSpace() != Ty->getPointerAddressSpace())
2943     return Create(Instruction::AddrSpaceCast, S, Ty, Name, InsertBefore);
2944 
2945   return Create(Instruction::BitCast, S, Ty, Name, InsertBefore);
2946 }
2947 
2948 CastInst *CastInst::CreateBitOrPointerCast(Value *S, Type *Ty,
2949                                            const Twine &Name,
2950                                            Instruction *InsertBefore) {
2951   if (S->getType()->isPointerTy() && Ty->isIntegerTy())
2952     return Create(Instruction::PtrToInt, S, Ty, Name, InsertBefore);
2953   if (S->getType()->isIntegerTy() && Ty->isPointerTy())
2954     return Create(Instruction::IntToPtr, S, Ty, Name, InsertBefore);
2955 
2956   return Create(Instruction::BitCast, S, Ty, Name, InsertBefore);
2957 }
2958 
2959 CastInst *CastInst::CreateIntegerCast(Value *C, Type *Ty,
2960                                       bool isSigned, const Twine &Name,
2961                                       Instruction *InsertBefore) {
2962   assert(C->getType()->isIntOrIntVectorTy() && Ty->isIntOrIntVectorTy() &&
2963          "Invalid integer cast");
2964   unsigned SrcBits = C->getType()->getScalarSizeInBits();
2965   unsigned DstBits = Ty->getScalarSizeInBits();
2966   Instruction::CastOps opcode =
2967     (SrcBits == DstBits ? Instruction::BitCast :
2968      (SrcBits > DstBits ? Instruction::Trunc :
2969       (isSigned ? Instruction::SExt : Instruction::ZExt)));
2970   return Create(opcode, C, Ty, Name, InsertBefore);
2971 }
2972 
2973 CastInst *CastInst::CreateIntegerCast(Value *C, Type *Ty,
2974                                       bool isSigned, const Twine &Name,
2975                                       BasicBlock *InsertAtEnd) {
2976   assert(C->getType()->isIntOrIntVectorTy() && Ty->isIntOrIntVectorTy() &&
2977          "Invalid cast");
2978   unsigned SrcBits = C->getType()->getScalarSizeInBits();
2979   unsigned DstBits = Ty->getScalarSizeInBits();
2980   Instruction::CastOps opcode =
2981     (SrcBits == DstBits ? Instruction::BitCast :
2982      (SrcBits > DstBits ? Instruction::Trunc :
2983       (isSigned ? Instruction::SExt : Instruction::ZExt)));
2984   return Create(opcode, C, Ty, Name, InsertAtEnd);
2985 }
2986 
2987 CastInst *CastInst::CreateFPCast(Value *C, Type *Ty,
2988                                  const Twine &Name,
2989                                  Instruction *InsertBefore) {
2990   assert(C->getType()->isFPOrFPVectorTy() && Ty->isFPOrFPVectorTy() &&
2991          "Invalid cast");
2992   unsigned SrcBits = C->getType()->getScalarSizeInBits();
2993   unsigned DstBits = Ty->getScalarSizeInBits();
2994   Instruction::CastOps opcode =
2995     (SrcBits == DstBits ? Instruction::BitCast :
2996      (SrcBits > DstBits ? Instruction::FPTrunc : Instruction::FPExt));
2997   return Create(opcode, C, Ty, Name, InsertBefore);
2998 }
2999 
3000 CastInst *CastInst::CreateFPCast(Value *C, Type *Ty,
3001                                  const Twine &Name,
3002                                  BasicBlock *InsertAtEnd) {
3003   assert(C->getType()->isFPOrFPVectorTy() && Ty->isFPOrFPVectorTy() &&
3004          "Invalid cast");
3005   unsigned SrcBits = C->getType()->getScalarSizeInBits();
3006   unsigned DstBits = Ty->getScalarSizeInBits();
3007   Instruction::CastOps opcode =
3008     (SrcBits == DstBits ? Instruction::BitCast :
3009      (SrcBits > DstBits ? Instruction::FPTrunc : Instruction::FPExt));
3010   return Create(opcode, C, Ty, Name, InsertAtEnd);
3011 }
3012 
3013 // Check whether it is valid to call getCastOpcode for these types.
3014 // This routine must be kept in sync with getCastOpcode.
3015 bool CastInst::isCastable(Type *SrcTy, Type *DestTy) {
3016   if (!SrcTy->isFirstClassType() || !DestTy->isFirstClassType())
3017     return false;
3018 
3019   if (SrcTy == DestTy)
3020     return true;
3021 
3022   if (VectorType *SrcVecTy = dyn_cast<VectorType>(SrcTy))
3023     if (VectorType *DestVecTy = dyn_cast<VectorType>(DestTy))
3024       if (SrcVecTy->getNumElements() == DestVecTy->getNumElements()) {
3025         // An element by element cast.  Valid if casting the elements is valid.
3026         SrcTy = SrcVecTy->getElementType();
3027         DestTy = DestVecTy->getElementType();
3028       }
3029 
3030   // Get the bit sizes, we'll need these
3031   TypeSize SrcBits = SrcTy->getPrimitiveSizeInBits();   // 0 for ptr
3032   TypeSize DestBits = DestTy->getPrimitiveSizeInBits(); // 0 for ptr
3033 
3034   // Run through the possibilities ...
3035   if (DestTy->isIntegerTy()) {               // Casting to integral
3036     if (SrcTy->isIntegerTy())                // Casting from integral
3037         return true;
3038     if (SrcTy->isFloatingPointTy())   // Casting from floating pt
3039       return true;
3040     if (SrcTy->isVectorTy())          // Casting from vector
3041       return DestBits == SrcBits;
3042                                       // Casting from something else
3043     return SrcTy->isPointerTy();
3044   }
3045   if (DestTy->isFloatingPointTy()) {  // Casting to floating pt
3046     if (SrcTy->isIntegerTy())                // Casting from integral
3047       return true;
3048     if (SrcTy->isFloatingPointTy())   // Casting from floating pt
3049       return true;
3050     if (SrcTy->isVectorTy())          // Casting from vector
3051       return DestBits == SrcBits;
3052                                     // Casting from something else
3053     return false;
3054   }
3055   if (DestTy->isVectorTy())         // Casting to vector
3056     return DestBits == SrcBits;
3057   if (DestTy->isPointerTy()) {        // Casting to pointer
3058     if (SrcTy->isPointerTy())                // Casting from pointer
3059       return true;
3060     return SrcTy->isIntegerTy();             // Casting from integral
3061   }
3062   if (DestTy->isX86_MMXTy()) {
3063     if (SrcTy->isVectorTy())
3064       return DestBits == SrcBits;       // 64-bit vector to MMX
3065     return false;
3066   }                                    // Casting to something else
3067   return false;
3068 }
3069 
3070 bool CastInst::isBitCastable(Type *SrcTy, Type *DestTy) {
3071   if (!SrcTy->isFirstClassType() || !DestTy->isFirstClassType())
3072     return false;
3073 
3074   if (SrcTy == DestTy)
3075     return true;
3076 
3077   if (VectorType *SrcVecTy = dyn_cast<VectorType>(SrcTy)) {
3078     if (VectorType *DestVecTy = dyn_cast<VectorType>(DestTy)) {
3079       if (SrcVecTy->getElementCount() == DestVecTy->getElementCount()) {
3080         // An element by element cast. Valid if casting the elements is valid.
3081         SrcTy = SrcVecTy->getElementType();
3082         DestTy = DestVecTy->getElementType();
3083       }
3084     }
3085   }
3086 
3087   if (PointerType *DestPtrTy = dyn_cast<PointerType>(DestTy)) {
3088     if (PointerType *SrcPtrTy = dyn_cast<PointerType>(SrcTy)) {
3089       return SrcPtrTy->getAddressSpace() == DestPtrTy->getAddressSpace();
3090     }
3091   }
3092 
3093   TypeSize SrcBits = SrcTy->getPrimitiveSizeInBits();   // 0 for ptr
3094   TypeSize DestBits = DestTy->getPrimitiveSizeInBits(); // 0 for ptr
3095 
3096   // Could still have vectors of pointers if the number of elements doesn't
3097   // match
3098   if (SrcBits.getKnownMinSize() == 0 || DestBits.getKnownMinSize() == 0)
3099     return false;
3100 
3101   if (SrcBits != DestBits)
3102     return false;
3103 
3104   if (DestTy->isX86_MMXTy() || SrcTy->isX86_MMXTy())
3105     return false;
3106 
3107   return true;
3108 }
3109 
3110 bool CastInst::isBitOrNoopPointerCastable(Type *SrcTy, Type *DestTy,
3111                                           const DataLayout &DL) {
3112   // ptrtoint and inttoptr are not allowed on non-integral pointers
3113   if (auto *PtrTy = dyn_cast<PointerType>(SrcTy))
3114     if (auto *IntTy = dyn_cast<IntegerType>(DestTy))
3115       return (IntTy->getBitWidth() == DL.getPointerTypeSizeInBits(PtrTy) &&
3116               !DL.isNonIntegralPointerType(PtrTy));
3117   if (auto *PtrTy = dyn_cast<PointerType>(DestTy))
3118     if (auto *IntTy = dyn_cast<IntegerType>(SrcTy))
3119       return (IntTy->getBitWidth() == DL.getPointerTypeSizeInBits(PtrTy) &&
3120               !DL.isNonIntegralPointerType(PtrTy));
3121 
3122   return isBitCastable(SrcTy, DestTy);
3123 }
3124 
3125 // Provide a way to get a "cast" where the cast opcode is inferred from the
3126 // types and size of the operand. This, basically, is a parallel of the
3127 // logic in the castIsValid function below.  This axiom should hold:
3128 //   castIsValid( getCastOpcode(Val, Ty), Val, Ty)
3129 // should not assert in castIsValid. In other words, this produces a "correct"
3130 // casting opcode for the arguments passed to it.
3131 // This routine must be kept in sync with isCastable.
3132 Instruction::CastOps
3133 CastInst::getCastOpcode(
3134   const Value *Src, bool SrcIsSigned, Type *DestTy, bool DestIsSigned) {
3135   Type *SrcTy = Src->getType();
3136 
3137   assert(SrcTy->isFirstClassType() && DestTy->isFirstClassType() &&
3138          "Only first class types are castable!");
3139 
3140   if (SrcTy == DestTy)
3141     return BitCast;
3142 
3143   // FIXME: Check address space sizes here
3144   if (VectorType *SrcVecTy = dyn_cast<VectorType>(SrcTy))
3145     if (VectorType *DestVecTy = dyn_cast<VectorType>(DestTy))
3146       if (SrcVecTy->getNumElements() == DestVecTy->getNumElements()) {
3147         // An element by element cast.  Find the appropriate opcode based on the
3148         // element types.
3149         SrcTy = SrcVecTy->getElementType();
3150         DestTy = DestVecTy->getElementType();
3151       }
3152 
3153   // Get the bit sizes, we'll need these
3154   unsigned SrcBits = SrcTy->getPrimitiveSizeInBits();   // 0 for ptr
3155   unsigned DestBits = DestTy->getPrimitiveSizeInBits(); // 0 for ptr
3156 
3157   // Run through the possibilities ...
3158   if (DestTy->isIntegerTy()) {                      // Casting to integral
3159     if (SrcTy->isIntegerTy()) {                     // Casting from integral
3160       if (DestBits < SrcBits)
3161         return Trunc;                               // int -> smaller int
3162       else if (DestBits > SrcBits) {                // its an extension
3163         if (SrcIsSigned)
3164           return SExt;                              // signed -> SEXT
3165         else
3166           return ZExt;                              // unsigned -> ZEXT
3167       } else {
3168         return BitCast;                             // Same size, No-op cast
3169       }
3170     } else if (SrcTy->isFloatingPointTy()) {        // Casting from floating pt
3171       if (DestIsSigned)
3172         return FPToSI;                              // FP -> sint
3173       else
3174         return FPToUI;                              // FP -> uint
3175     } else if (SrcTy->isVectorTy()) {
3176       assert(DestBits == SrcBits &&
3177              "Casting vector to integer of different width");
3178       return BitCast;                             // Same size, no-op cast
3179     } else {
3180       assert(SrcTy->isPointerTy() &&
3181              "Casting from a value that is not first-class type");
3182       return PtrToInt;                              // ptr -> int
3183     }
3184   } else if (DestTy->isFloatingPointTy()) {         // Casting to floating pt
3185     if (SrcTy->isIntegerTy()) {                     // Casting from integral
3186       if (SrcIsSigned)
3187         return SIToFP;                              // sint -> FP
3188       else
3189         return UIToFP;                              // uint -> FP
3190     } else if (SrcTy->isFloatingPointTy()) {        // Casting from floating pt
3191       if (DestBits < SrcBits) {
3192         return FPTrunc;                             // FP -> smaller FP
3193       } else if (DestBits > SrcBits) {
3194         return FPExt;                               // FP -> larger FP
3195       } else  {
3196         return BitCast;                             // same size, no-op cast
3197       }
3198     } else if (SrcTy->isVectorTy()) {
3199       assert(DestBits == SrcBits &&
3200              "Casting vector to floating point of different width");
3201       return BitCast;                             // same size, no-op cast
3202     }
3203     llvm_unreachable("Casting pointer or non-first class to float");
3204   } else if (DestTy->isVectorTy()) {
3205     assert(DestBits == SrcBits &&
3206            "Illegal cast to vector (wrong type or size)");
3207     return BitCast;
3208   } else if (DestTy->isPointerTy()) {
3209     if (SrcTy->isPointerTy()) {
3210       if (DestTy->getPointerAddressSpace() != SrcTy->getPointerAddressSpace())
3211         return AddrSpaceCast;
3212       return BitCast;                               // ptr -> ptr
3213     } else if (SrcTy->isIntegerTy()) {
3214       return IntToPtr;                              // int -> ptr
3215     }
3216     llvm_unreachable("Casting pointer to other than pointer or int");
3217   } else if (DestTy->isX86_MMXTy()) {
3218     if (SrcTy->isVectorTy()) {
3219       assert(DestBits == SrcBits && "Casting vector of wrong width to X86_MMX");
3220       return BitCast;                               // 64-bit vector to MMX
3221     }
3222     llvm_unreachable("Illegal cast to X86_MMX");
3223   }
3224   llvm_unreachable("Casting to type that is not first-class");
3225 }
3226 
3227 //===----------------------------------------------------------------------===//
3228 //                    CastInst SubClass Constructors
3229 //===----------------------------------------------------------------------===//
3230 
3231 /// Check that the construction parameters for a CastInst are correct. This
3232 /// could be broken out into the separate constructors but it is useful to have
3233 /// it in one place and to eliminate the redundant code for getting the sizes
3234 /// of the types involved.
3235 bool
3236 CastInst::castIsValid(Instruction::CastOps op, Value *S, Type *DstTy) {
3237   // Check for type sanity on the arguments
3238   Type *SrcTy = S->getType();
3239 
3240   if (!SrcTy->isFirstClassType() || !DstTy->isFirstClassType() ||
3241       SrcTy->isAggregateType() || DstTy->isAggregateType())
3242     return false;
3243 
3244   // Get the size of the types in bits, we'll need this later
3245   unsigned SrcBitSize = SrcTy->getScalarSizeInBits();
3246   unsigned DstBitSize = DstTy->getScalarSizeInBits();
3247 
3248   // If these are vector types, get the lengths of the vectors (using zero for
3249   // scalar types means that checking that vector lengths match also checks that
3250   // scalars are not being converted to vectors or vectors to scalars).
3251   unsigned SrcLength = SrcTy->isVectorTy() ?
3252     cast<VectorType>(SrcTy)->getNumElements() : 0;
3253   unsigned DstLength = DstTy->isVectorTy() ?
3254     cast<VectorType>(DstTy)->getNumElements() : 0;
3255 
3256   // Switch on the opcode provided
3257   switch (op) {
3258   default: return false; // This is an input error
3259   case Instruction::Trunc:
3260     return SrcTy->isIntOrIntVectorTy() && DstTy->isIntOrIntVectorTy() &&
3261       SrcLength == DstLength && SrcBitSize > DstBitSize;
3262   case Instruction::ZExt:
3263     return SrcTy->isIntOrIntVectorTy() && DstTy->isIntOrIntVectorTy() &&
3264       SrcLength == DstLength && SrcBitSize < DstBitSize;
3265   case Instruction::SExt:
3266     return SrcTy->isIntOrIntVectorTy() && DstTy->isIntOrIntVectorTy() &&
3267       SrcLength == DstLength && SrcBitSize < DstBitSize;
3268   case Instruction::FPTrunc:
3269     return SrcTy->isFPOrFPVectorTy() && DstTy->isFPOrFPVectorTy() &&
3270       SrcLength == DstLength && SrcBitSize > DstBitSize;
3271   case Instruction::FPExt:
3272     return SrcTy->isFPOrFPVectorTy() && DstTy->isFPOrFPVectorTy() &&
3273       SrcLength == DstLength && SrcBitSize < DstBitSize;
3274   case Instruction::UIToFP:
3275   case Instruction::SIToFP:
3276     return SrcTy->isIntOrIntVectorTy() && DstTy->isFPOrFPVectorTy() &&
3277       SrcLength == DstLength;
3278   case Instruction::FPToUI:
3279   case Instruction::FPToSI:
3280     return SrcTy->isFPOrFPVectorTy() && DstTy->isIntOrIntVectorTy() &&
3281       SrcLength == DstLength;
3282   case Instruction::PtrToInt:
3283     if (isa<VectorType>(SrcTy) != isa<VectorType>(DstTy))
3284       return false;
3285     if (VectorType *VT = dyn_cast<VectorType>(SrcTy))
3286       if (VT->getNumElements() != cast<VectorType>(DstTy)->getNumElements())
3287         return false;
3288     return SrcTy->isPtrOrPtrVectorTy() && DstTy->isIntOrIntVectorTy();
3289   case Instruction::IntToPtr:
3290     if (isa<VectorType>(SrcTy) != isa<VectorType>(DstTy))
3291       return false;
3292     if (VectorType *VT = dyn_cast<VectorType>(SrcTy))
3293       if (VT->getNumElements() != cast<VectorType>(DstTy)->getNumElements())
3294         return false;
3295     return SrcTy->isIntOrIntVectorTy() && DstTy->isPtrOrPtrVectorTy();
3296   case Instruction::BitCast: {
3297     PointerType *SrcPtrTy = dyn_cast<PointerType>(SrcTy->getScalarType());
3298     PointerType *DstPtrTy = dyn_cast<PointerType>(DstTy->getScalarType());
3299 
3300     // BitCast implies a no-op cast of type only. No bits change.
3301     // However, you can't cast pointers to anything but pointers.
3302     if (!SrcPtrTy != !DstPtrTy)
3303       return false;
3304 
3305     // For non-pointer cases, the cast is okay if the source and destination bit
3306     // widths are identical.
3307     if (!SrcPtrTy)
3308       return SrcTy->getPrimitiveSizeInBits() == DstTy->getPrimitiveSizeInBits();
3309 
3310     // If both are pointers then the address spaces must match.
3311     if (SrcPtrTy->getAddressSpace() != DstPtrTy->getAddressSpace())
3312       return false;
3313 
3314     // A vector of pointers must have the same number of elements.
3315     VectorType *SrcVecTy = dyn_cast<VectorType>(SrcTy);
3316     VectorType *DstVecTy = dyn_cast<VectorType>(DstTy);
3317     if (SrcVecTy && DstVecTy)
3318       return (SrcVecTy->getNumElements() == DstVecTy->getNumElements());
3319     if (SrcVecTy)
3320       return SrcVecTy->getNumElements() == 1;
3321     if (DstVecTy)
3322       return DstVecTy->getNumElements() == 1;
3323 
3324     return true;
3325   }
3326   case Instruction::AddrSpaceCast: {
3327     PointerType *SrcPtrTy = dyn_cast<PointerType>(SrcTy->getScalarType());
3328     if (!SrcPtrTy)
3329       return false;
3330 
3331     PointerType *DstPtrTy = dyn_cast<PointerType>(DstTy->getScalarType());
3332     if (!DstPtrTy)
3333       return false;
3334 
3335     if (SrcPtrTy->getAddressSpace() == DstPtrTy->getAddressSpace())
3336       return false;
3337 
3338     if (VectorType *SrcVecTy = dyn_cast<VectorType>(SrcTy)) {
3339       if (VectorType *DstVecTy = dyn_cast<VectorType>(DstTy))
3340         return (SrcVecTy->getNumElements() == DstVecTy->getNumElements());
3341 
3342       return false;
3343     }
3344 
3345     return true;
3346   }
3347   }
3348 }
3349 
3350 TruncInst::TruncInst(
3351   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3352 ) : CastInst(Ty, Trunc, S, Name, InsertBefore) {
3353   assert(castIsValid(getOpcode(), S, Ty) && "Illegal Trunc");
3354 }
3355 
3356 TruncInst::TruncInst(
3357   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3358 ) : CastInst(Ty, Trunc, S, Name, InsertAtEnd) {
3359   assert(castIsValid(getOpcode(), S, Ty) && "Illegal Trunc");
3360 }
3361 
3362 ZExtInst::ZExtInst(
3363   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3364 )  : CastInst(Ty, ZExt, S, Name, InsertBefore) {
3365   assert(castIsValid(getOpcode(), S, Ty) && "Illegal ZExt");
3366 }
3367 
3368 ZExtInst::ZExtInst(
3369   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3370 )  : CastInst(Ty, ZExt, S, Name, InsertAtEnd) {
3371   assert(castIsValid(getOpcode(), S, Ty) && "Illegal ZExt");
3372 }
3373 SExtInst::SExtInst(
3374   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3375 ) : CastInst(Ty, SExt, S, Name, InsertBefore) {
3376   assert(castIsValid(getOpcode(), S, Ty) && "Illegal SExt");
3377 }
3378 
3379 SExtInst::SExtInst(
3380   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3381 )  : CastInst(Ty, SExt, S, Name, InsertAtEnd) {
3382   assert(castIsValid(getOpcode(), S, Ty) && "Illegal SExt");
3383 }
3384 
3385 FPTruncInst::FPTruncInst(
3386   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3387 ) : CastInst(Ty, FPTrunc, S, Name, InsertBefore) {
3388   assert(castIsValid(getOpcode(), S, Ty) && "Illegal FPTrunc");
3389 }
3390 
3391 FPTruncInst::FPTruncInst(
3392   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3393 ) : CastInst(Ty, FPTrunc, S, Name, InsertAtEnd) {
3394   assert(castIsValid(getOpcode(), S, Ty) && "Illegal FPTrunc");
3395 }
3396 
3397 FPExtInst::FPExtInst(
3398   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3399 ) : CastInst(Ty, FPExt, S, Name, InsertBefore) {
3400   assert(castIsValid(getOpcode(), S, Ty) && "Illegal FPExt");
3401 }
3402 
3403 FPExtInst::FPExtInst(
3404   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3405 ) : CastInst(Ty, FPExt, S, Name, InsertAtEnd) {
3406   assert(castIsValid(getOpcode(), S, Ty) && "Illegal FPExt");
3407 }
3408 
3409 UIToFPInst::UIToFPInst(
3410   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3411 ) : CastInst(Ty, UIToFP, S, Name, InsertBefore) {
3412   assert(castIsValid(getOpcode(), S, Ty) && "Illegal UIToFP");
3413 }
3414 
3415 UIToFPInst::UIToFPInst(
3416   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3417 ) : CastInst(Ty, UIToFP, S, Name, InsertAtEnd) {
3418   assert(castIsValid(getOpcode(), S, Ty) && "Illegal UIToFP");
3419 }
3420 
3421 SIToFPInst::SIToFPInst(
3422   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3423 ) : CastInst(Ty, SIToFP, S, Name, InsertBefore) {
3424   assert(castIsValid(getOpcode(), S, Ty) && "Illegal SIToFP");
3425 }
3426 
3427 SIToFPInst::SIToFPInst(
3428   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3429 ) : CastInst(Ty, SIToFP, S, Name, InsertAtEnd) {
3430   assert(castIsValid(getOpcode(), S, Ty) && "Illegal SIToFP");
3431 }
3432 
3433 FPToUIInst::FPToUIInst(
3434   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3435 ) : CastInst(Ty, FPToUI, S, Name, InsertBefore) {
3436   assert(castIsValid(getOpcode(), S, Ty) && "Illegal FPToUI");
3437 }
3438 
3439 FPToUIInst::FPToUIInst(
3440   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3441 ) : CastInst(Ty, FPToUI, S, Name, InsertAtEnd) {
3442   assert(castIsValid(getOpcode(), S, Ty) && "Illegal FPToUI");
3443 }
3444 
3445 FPToSIInst::FPToSIInst(
3446   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3447 ) : CastInst(Ty, FPToSI, S, Name, InsertBefore) {
3448   assert(castIsValid(getOpcode(), S, Ty) && "Illegal FPToSI");
3449 }
3450 
3451 FPToSIInst::FPToSIInst(
3452   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3453 ) : CastInst(Ty, FPToSI, S, Name, InsertAtEnd) {
3454   assert(castIsValid(getOpcode(), S, Ty) && "Illegal FPToSI");
3455 }
3456 
3457 PtrToIntInst::PtrToIntInst(
3458   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3459 ) : CastInst(Ty, PtrToInt, S, Name, InsertBefore) {
3460   assert(castIsValid(getOpcode(), S, Ty) && "Illegal PtrToInt");
3461 }
3462 
3463 PtrToIntInst::PtrToIntInst(
3464   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3465 ) : CastInst(Ty, PtrToInt, S, Name, InsertAtEnd) {
3466   assert(castIsValid(getOpcode(), S, Ty) && "Illegal PtrToInt");
3467 }
3468 
3469 IntToPtrInst::IntToPtrInst(
3470   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3471 ) : CastInst(Ty, IntToPtr, S, Name, InsertBefore) {
3472   assert(castIsValid(getOpcode(), S, Ty) && "Illegal IntToPtr");
3473 }
3474 
3475 IntToPtrInst::IntToPtrInst(
3476   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3477 ) : CastInst(Ty, IntToPtr, S, Name, InsertAtEnd) {
3478   assert(castIsValid(getOpcode(), S, Ty) && "Illegal IntToPtr");
3479 }
3480 
3481 BitCastInst::BitCastInst(
3482   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3483 ) : CastInst(Ty, BitCast, S, Name, InsertBefore) {
3484   assert(castIsValid(getOpcode(), S, Ty) && "Illegal BitCast");
3485 }
3486 
3487 BitCastInst::BitCastInst(
3488   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3489 ) : CastInst(Ty, BitCast, S, Name, InsertAtEnd) {
3490   assert(castIsValid(getOpcode(), S, Ty) && "Illegal BitCast");
3491 }
3492 
3493 AddrSpaceCastInst::AddrSpaceCastInst(
3494   Value *S, Type *Ty, const Twine &Name, Instruction *InsertBefore
3495 ) : CastInst(Ty, AddrSpaceCast, S, Name, InsertBefore) {
3496   assert(castIsValid(getOpcode(), S, Ty) && "Illegal AddrSpaceCast");
3497 }
3498 
3499 AddrSpaceCastInst::AddrSpaceCastInst(
3500   Value *S, Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd
3501 ) : CastInst(Ty, AddrSpaceCast, S, Name, InsertAtEnd) {
3502   assert(castIsValid(getOpcode(), S, Ty) && "Illegal AddrSpaceCast");
3503 }
3504 
3505 //===----------------------------------------------------------------------===//
3506 //                               CmpInst Classes
3507 //===----------------------------------------------------------------------===//
3508 
3509 CmpInst::CmpInst(Type *ty, OtherOps op, Predicate predicate, Value *LHS,
3510                  Value *RHS, const Twine &Name, Instruction *InsertBefore,
3511                  Instruction *FlagsSource)
3512   : Instruction(ty, op,
3513                 OperandTraits<CmpInst>::op_begin(this),
3514                 OperandTraits<CmpInst>::operands(this),
3515                 InsertBefore) {
3516   Op<0>() = LHS;
3517   Op<1>() = RHS;
3518   setPredicate((Predicate)predicate);
3519   setName(Name);
3520   if (FlagsSource)
3521     copyIRFlags(FlagsSource);
3522 }
3523 
3524 CmpInst::CmpInst(Type *ty, OtherOps op, Predicate predicate, Value *LHS,
3525                  Value *RHS, const Twine &Name, BasicBlock *InsertAtEnd)
3526   : Instruction(ty, op,
3527                 OperandTraits<CmpInst>::op_begin(this),
3528                 OperandTraits<CmpInst>::operands(this),
3529                 InsertAtEnd) {
3530   Op<0>() = LHS;
3531   Op<1>() = RHS;
3532   setPredicate((Predicate)predicate);
3533   setName(Name);
3534 }
3535 
3536 CmpInst *
3537 CmpInst::Create(OtherOps Op, Predicate predicate, Value *S1, Value *S2,
3538                 const Twine &Name, Instruction *InsertBefore) {
3539   if (Op == Instruction::ICmp) {
3540     if (InsertBefore)
3541       return new ICmpInst(InsertBefore, CmpInst::Predicate(predicate),
3542                           S1, S2, Name);
3543     else
3544       return new ICmpInst(CmpInst::Predicate(predicate),
3545                           S1, S2, Name);
3546   }
3547 
3548   if (InsertBefore)
3549     return new FCmpInst(InsertBefore, CmpInst::Predicate(predicate),
3550                         S1, S2, Name);
3551   else
3552     return new FCmpInst(CmpInst::Predicate(predicate),
3553                         S1, S2, Name);
3554 }
3555 
3556 CmpInst *
3557 CmpInst::Create(OtherOps Op, Predicate predicate, Value *S1, Value *S2,
3558                 const Twine &Name, BasicBlock *InsertAtEnd) {
3559   if (Op == Instruction::ICmp) {
3560     return new ICmpInst(*InsertAtEnd, CmpInst::Predicate(predicate),
3561                         S1, S2, Name);
3562   }
3563   return new FCmpInst(*InsertAtEnd, CmpInst::Predicate(predicate),
3564                       S1, S2, Name);
3565 }
3566 
3567 void CmpInst::swapOperands() {
3568   if (ICmpInst *IC = dyn_cast<ICmpInst>(this))
3569     IC->swapOperands();
3570   else
3571     cast<FCmpInst>(this)->swapOperands();
3572 }
3573 
3574 bool CmpInst::isCommutative() const {
3575   if (const ICmpInst *IC = dyn_cast<ICmpInst>(this))
3576     return IC->isCommutative();
3577   return cast<FCmpInst>(this)->isCommutative();
3578 }
3579 
3580 bool CmpInst::isEquality() const {
3581   if (const ICmpInst *IC = dyn_cast<ICmpInst>(this))
3582     return IC->isEquality();
3583   return cast<FCmpInst>(this)->isEquality();
3584 }
3585 
3586 CmpInst::Predicate CmpInst::getInversePredicate(Predicate pred) {
3587   switch (pred) {
3588     default: llvm_unreachable("Unknown cmp predicate!");
3589     case ICMP_EQ: return ICMP_NE;
3590     case ICMP_NE: return ICMP_EQ;
3591     case ICMP_UGT: return ICMP_ULE;
3592     case ICMP_ULT: return ICMP_UGE;
3593     case ICMP_UGE: return ICMP_ULT;
3594     case ICMP_ULE: return ICMP_UGT;
3595     case ICMP_SGT: return ICMP_SLE;
3596     case ICMP_SLT: return ICMP_SGE;
3597     case ICMP_SGE: return ICMP_SLT;
3598     case ICMP_SLE: return ICMP_SGT;
3599 
3600     case FCMP_OEQ: return FCMP_UNE;
3601     case FCMP_ONE: return FCMP_UEQ;
3602     case FCMP_OGT: return FCMP_ULE;
3603     case FCMP_OLT: return FCMP_UGE;
3604     case FCMP_OGE: return FCMP_ULT;
3605     case FCMP_OLE: return FCMP_UGT;
3606     case FCMP_UEQ: return FCMP_ONE;
3607     case FCMP_UNE: return FCMP_OEQ;
3608     case FCMP_UGT: return FCMP_OLE;
3609     case FCMP_ULT: return FCMP_OGE;
3610     case FCMP_UGE: return FCMP_OLT;
3611     case FCMP_ULE: return FCMP_OGT;
3612     case FCMP_ORD: return FCMP_UNO;
3613     case FCMP_UNO: return FCMP_ORD;
3614     case FCMP_TRUE: return FCMP_FALSE;
3615     case FCMP_FALSE: return FCMP_TRUE;
3616   }
3617 }
3618 
3619 StringRef CmpInst::getPredicateName(Predicate Pred) {
3620   switch (Pred) {
3621   default:                   return "unknown";
3622   case FCmpInst::FCMP_FALSE: return "false";
3623   case FCmpInst::FCMP_OEQ:   return "oeq";
3624   case FCmpInst::FCMP_OGT:   return "ogt";
3625   case FCmpInst::FCMP_OGE:   return "oge";
3626   case FCmpInst::FCMP_OLT:   return "olt";
3627   case FCmpInst::FCMP_OLE:   return "ole";
3628   case FCmpInst::FCMP_ONE:   return "one";
3629   case FCmpInst::FCMP_ORD:   return "ord";
3630   case FCmpInst::FCMP_UNO:   return "uno";
3631   case FCmpInst::FCMP_UEQ:   return "ueq";
3632   case FCmpInst::FCMP_UGT:   return "ugt";
3633   case FCmpInst::FCMP_UGE:   return "uge";
3634   case FCmpInst::FCMP_ULT:   return "ult";
3635   case FCmpInst::FCMP_ULE:   return "ule";
3636   case FCmpInst::FCMP_UNE:   return "une";
3637   case FCmpInst::FCMP_TRUE:  return "true";
3638   case ICmpInst::ICMP_EQ:    return "eq";
3639   case ICmpInst::ICMP_NE:    return "ne";
3640   case ICmpInst::ICMP_SGT:   return "sgt";
3641   case ICmpInst::ICMP_SGE:   return "sge";
3642   case ICmpInst::ICMP_SLT:   return "slt";
3643   case ICmpInst::ICMP_SLE:   return "sle";
3644   case ICmpInst::ICMP_UGT:   return "ugt";
3645   case ICmpInst::ICMP_UGE:   return "uge";
3646   case ICmpInst::ICMP_ULT:   return "ult";
3647   case ICmpInst::ICMP_ULE:   return "ule";
3648   }
3649 }
3650 
3651 ICmpInst::Predicate ICmpInst::getSignedPredicate(Predicate pred) {
3652   switch (pred) {
3653     default: llvm_unreachable("Unknown icmp predicate!");
3654     case ICMP_EQ: case ICMP_NE:
3655     case ICMP_SGT: case ICMP_SLT: case ICMP_SGE: case ICMP_SLE:
3656        return pred;
3657     case ICMP_UGT: return ICMP_SGT;
3658     case ICMP_ULT: return ICMP_SLT;
3659     case ICMP_UGE: return ICMP_SGE;
3660     case ICMP_ULE: return ICMP_SLE;
3661   }
3662 }
3663 
3664 ICmpInst::Predicate ICmpInst::getUnsignedPredicate(Predicate pred) {
3665   switch (pred) {
3666     default: llvm_unreachable("Unknown icmp predicate!");
3667     case ICMP_EQ: case ICMP_NE:
3668     case ICMP_UGT: case ICMP_ULT: case ICMP_UGE: case ICMP_ULE:
3669        return pred;
3670     case ICMP_SGT: return ICMP_UGT;
3671     case ICMP_SLT: return ICMP_ULT;
3672     case ICMP_SGE: return ICMP_UGE;
3673     case ICMP_SLE: return ICMP_ULE;
3674   }
3675 }
3676 
3677 CmpInst::Predicate CmpInst::getFlippedStrictnessPredicate(Predicate pred) {
3678   switch (pred) {
3679     default: llvm_unreachable("Unknown or unsupported cmp predicate!");
3680     case ICMP_SGT: return ICMP_SGE;
3681     case ICMP_SLT: return ICMP_SLE;
3682     case ICMP_SGE: return ICMP_SGT;
3683     case ICMP_SLE: return ICMP_SLT;
3684     case ICMP_UGT: return ICMP_UGE;
3685     case ICMP_ULT: return ICMP_ULE;
3686     case ICMP_UGE: return ICMP_UGT;
3687     case ICMP_ULE: return ICMP_ULT;
3688 
3689     case FCMP_OGT: return FCMP_OGE;
3690     case FCMP_OLT: return FCMP_OLE;
3691     case FCMP_OGE: return FCMP_OGT;
3692     case FCMP_OLE: return FCMP_OLT;
3693     case FCMP_UGT: return FCMP_UGE;
3694     case FCMP_ULT: return FCMP_ULE;
3695     case FCMP_UGE: return FCMP_UGT;
3696     case FCMP_ULE: return FCMP_ULT;
3697   }
3698 }
3699 
3700 CmpInst::Predicate CmpInst::getSwappedPredicate(Predicate pred) {
3701   switch (pred) {
3702     default: llvm_unreachable("Unknown cmp predicate!");
3703     case ICMP_EQ: case ICMP_NE:
3704       return pred;
3705     case ICMP_SGT: return ICMP_SLT;
3706     case ICMP_SLT: return ICMP_SGT;
3707     case ICMP_SGE: return ICMP_SLE;
3708     case ICMP_SLE: return ICMP_SGE;
3709     case ICMP_UGT: return ICMP_ULT;
3710     case ICMP_ULT: return ICMP_UGT;
3711     case ICMP_UGE: return ICMP_ULE;
3712     case ICMP_ULE: return ICMP_UGE;
3713 
3714     case FCMP_FALSE: case FCMP_TRUE:
3715     case FCMP_OEQ: case FCMP_ONE:
3716     case FCMP_UEQ: case FCMP_UNE:
3717     case FCMP_ORD: case FCMP_UNO:
3718       return pred;
3719     case FCMP_OGT: return FCMP_OLT;
3720     case FCMP_OLT: return FCMP_OGT;
3721     case FCMP_OGE: return FCMP_OLE;
3722     case FCMP_OLE: return FCMP_OGE;
3723     case FCMP_UGT: return FCMP_ULT;
3724     case FCMP_ULT: return FCMP_UGT;
3725     case FCMP_UGE: return FCMP_ULE;
3726     case FCMP_ULE: return FCMP_UGE;
3727   }
3728 }
3729 
3730 CmpInst::Predicate CmpInst::getNonStrictPredicate(Predicate pred) {
3731   switch (pred) {
3732   case ICMP_SGT: return ICMP_SGE;
3733   case ICMP_SLT: return ICMP_SLE;
3734   case ICMP_UGT: return ICMP_UGE;
3735   case ICMP_ULT: return ICMP_ULE;
3736   case FCMP_OGT: return FCMP_OGE;
3737   case FCMP_OLT: return FCMP_OLE;
3738   case FCMP_UGT: return FCMP_UGE;
3739   case FCMP_ULT: return FCMP_ULE;
3740   default: return pred;
3741   }
3742 }
3743 
3744 CmpInst::Predicate CmpInst::getSignedPredicate(Predicate pred) {
3745   assert(CmpInst::isUnsigned(pred) && "Call only with signed predicates!");
3746 
3747   switch (pred) {
3748   default:
3749     llvm_unreachable("Unknown predicate!");
3750   case CmpInst::ICMP_ULT:
3751     return CmpInst::ICMP_SLT;
3752   case CmpInst::ICMP_ULE:
3753     return CmpInst::ICMP_SLE;
3754   case CmpInst::ICMP_UGT:
3755     return CmpInst::ICMP_SGT;
3756   case CmpInst::ICMP_UGE:
3757     return CmpInst::ICMP_SGE;
3758   }
3759 }
3760 
3761 bool CmpInst::isUnsigned(Predicate predicate) {
3762   switch (predicate) {
3763     default: return false;
3764     case ICmpInst::ICMP_ULT: case ICmpInst::ICMP_ULE: case ICmpInst::ICMP_UGT:
3765     case ICmpInst::ICMP_UGE: return true;
3766   }
3767 }
3768 
3769 bool CmpInst::isSigned(Predicate predicate) {
3770   switch (predicate) {
3771     default: return false;
3772     case ICmpInst::ICMP_SLT: case ICmpInst::ICMP_SLE: case ICmpInst::ICMP_SGT:
3773     case ICmpInst::ICMP_SGE: return true;
3774   }
3775 }
3776 
3777 bool CmpInst::isOrdered(Predicate predicate) {
3778   switch (predicate) {
3779     default: return false;
3780     case FCmpInst::FCMP_OEQ: case FCmpInst::FCMP_ONE: case FCmpInst::FCMP_OGT:
3781     case FCmpInst::FCMP_OLT: case FCmpInst::FCMP_OGE: case FCmpInst::FCMP_OLE:
3782     case FCmpInst::FCMP_ORD: return true;
3783   }
3784 }
3785 
3786 bool CmpInst::isUnordered(Predicate predicate) {
3787   switch (predicate) {
3788     default: return false;
3789     case FCmpInst::FCMP_UEQ: case FCmpInst::FCMP_UNE: case FCmpInst::FCMP_UGT:
3790     case FCmpInst::FCMP_ULT: case FCmpInst::FCMP_UGE: case FCmpInst::FCMP_ULE:
3791     case FCmpInst::FCMP_UNO: return true;
3792   }
3793 }
3794 
3795 bool CmpInst::isTrueWhenEqual(Predicate predicate) {
3796   switch(predicate) {
3797     default: return false;
3798     case ICMP_EQ:   case ICMP_UGE: case ICMP_ULE: case ICMP_SGE: case ICMP_SLE:
3799     case FCMP_TRUE: case FCMP_UEQ: case FCMP_UGE: case FCMP_ULE: return true;
3800   }
3801 }
3802 
3803 bool CmpInst::isFalseWhenEqual(Predicate predicate) {
3804   switch(predicate) {
3805   case ICMP_NE:    case ICMP_UGT: case ICMP_ULT: case ICMP_SGT: case ICMP_SLT:
3806   case FCMP_FALSE: case FCMP_ONE: case FCMP_OGT: case FCMP_OLT: return true;
3807   default: return false;
3808   }
3809 }
3810 
3811 bool CmpInst::isImpliedTrueByMatchingCmp(Predicate Pred1, Predicate Pred2) {
3812   // If the predicates match, then we know the first condition implies the
3813   // second is true.
3814   if (Pred1 == Pred2)
3815     return true;
3816 
3817   switch (Pred1) {
3818   default:
3819     break;
3820   case ICMP_EQ:
3821     // A == B implies A >=u B, A <=u B, A >=s B, and A <=s B are true.
3822     return Pred2 == ICMP_UGE || Pred2 == ICMP_ULE || Pred2 == ICMP_SGE ||
3823            Pred2 == ICMP_SLE;
3824   case ICMP_UGT: // A >u B implies A != B and A >=u B are true.
3825     return Pred2 == ICMP_NE || Pred2 == ICMP_UGE;
3826   case ICMP_ULT: // A <u B implies A != B and A <=u B are true.
3827     return Pred2 == ICMP_NE || Pred2 == ICMP_ULE;
3828   case ICMP_SGT: // A >s B implies A != B and A >=s B are true.
3829     return Pred2 == ICMP_NE || Pred2 == ICMP_SGE;
3830   case ICMP_SLT: // A <s B implies A != B and A <=s B are true.
3831     return Pred2 == ICMP_NE || Pred2 == ICMP_SLE;
3832   }
3833   return false;
3834 }
3835 
3836 bool CmpInst::isImpliedFalseByMatchingCmp(Predicate Pred1, Predicate Pred2) {
3837   return isImpliedTrueByMatchingCmp(Pred1, getInversePredicate(Pred2));
3838 }
3839 
3840 //===----------------------------------------------------------------------===//
3841 //                        SwitchInst Implementation
3842 //===----------------------------------------------------------------------===//
3843 
3844 void SwitchInst::init(Value *Value, BasicBlock *Default, unsigned NumReserved) {
3845   assert(Value && Default && NumReserved);
3846   ReservedSpace = NumReserved;
3847   setNumHungOffUseOperands(2);
3848   allocHungoffUses(ReservedSpace);
3849 
3850   Op<0>() = Value;
3851   Op<1>() = Default;
3852 }
3853 
3854 /// SwitchInst ctor - Create a new switch instruction, specifying a value to
3855 /// switch on and a default destination.  The number of additional cases can
3856 /// be specified here to make memory allocation more efficient.  This
3857 /// constructor can also autoinsert before another instruction.
3858 SwitchInst::SwitchInst(Value *Value, BasicBlock *Default, unsigned NumCases,
3859                        Instruction *InsertBefore)
3860     : Instruction(Type::getVoidTy(Value->getContext()), Instruction::Switch,
3861                   nullptr, 0, InsertBefore) {
3862   init(Value, Default, 2+NumCases*2);
3863 }
3864 
3865 /// SwitchInst ctor - Create a new switch instruction, specifying a value to
3866 /// switch on and a default destination.  The number of additional cases can
3867 /// be specified here to make memory allocation more efficient.  This
3868 /// constructor also autoinserts at the end of the specified BasicBlock.
3869 SwitchInst::SwitchInst(Value *Value, BasicBlock *Default, unsigned NumCases,
3870                        BasicBlock *InsertAtEnd)
3871     : Instruction(Type::getVoidTy(Value->getContext()), Instruction::Switch,
3872                   nullptr, 0, InsertAtEnd) {
3873   init(Value, Default, 2+NumCases*2);
3874 }
3875 
3876 SwitchInst::SwitchInst(const SwitchInst &SI)
3877     : Instruction(SI.getType(), Instruction::Switch, nullptr, 0) {
3878   init(SI.getCondition(), SI.getDefaultDest(), SI.getNumOperands());
3879   setNumHungOffUseOperands(SI.getNumOperands());
3880   Use *OL = getOperandList();
3881   const Use *InOL = SI.getOperandList();
3882   for (unsigned i = 2, E = SI.getNumOperands(); i != E; i += 2) {
3883     OL[i] = InOL[i];
3884     OL[i+1] = InOL[i+1];
3885   }
3886   SubclassOptionalData = SI.SubclassOptionalData;
3887 }
3888 
3889 /// addCase - Add an entry to the switch instruction...
3890 ///
3891 void SwitchInst::addCase(ConstantInt *OnVal, BasicBlock *Dest) {
3892   unsigned NewCaseIdx = getNumCases();
3893   unsigned OpNo = getNumOperands();
3894   if (OpNo+2 > ReservedSpace)
3895     growOperands();  // Get more space!
3896   // Initialize some new operands.
3897   assert(OpNo+1 < ReservedSpace && "Growing didn't work!");
3898   setNumHungOffUseOperands(OpNo+2);
3899   CaseHandle Case(this, NewCaseIdx);
3900   Case.setValue(OnVal);
3901   Case.setSuccessor(Dest);
3902 }
3903 
3904 /// removeCase - This method removes the specified case and its successor
3905 /// from the switch instruction.
3906 SwitchInst::CaseIt SwitchInst::removeCase(CaseIt I) {
3907   unsigned idx = I->getCaseIndex();
3908 
3909   assert(2 + idx*2 < getNumOperands() && "Case index out of range!!!");
3910 
3911   unsigned NumOps = getNumOperands();
3912   Use *OL = getOperandList();
3913 
3914   // Overwrite this case with the end of the list.
3915   if (2 + (idx + 1) * 2 != NumOps) {
3916     OL[2 + idx * 2] = OL[NumOps - 2];
3917     OL[2 + idx * 2 + 1] = OL[NumOps - 1];
3918   }
3919 
3920   // Nuke the last value.
3921   OL[NumOps-2].set(nullptr);
3922   OL[NumOps-2+1].set(nullptr);
3923   setNumHungOffUseOperands(NumOps-2);
3924 
3925   return CaseIt(this, idx);
3926 }
3927 
3928 /// growOperands - grow operands - This grows the operand list in response
3929 /// to a push_back style of operation.  This grows the number of ops by 3 times.
3930 ///
3931 void SwitchInst::growOperands() {
3932   unsigned e = getNumOperands();
3933   unsigned NumOps = e*3;
3934 
3935   ReservedSpace = NumOps;
3936   growHungoffUses(ReservedSpace);
3937 }
3938 
3939 MDNode *
3940 SwitchInstProfUpdateWrapper::getProfBranchWeightsMD(const SwitchInst &SI) {
3941   if (MDNode *ProfileData = SI.getMetadata(LLVMContext::MD_prof))
3942     if (auto *MDName = dyn_cast<MDString>(ProfileData->getOperand(0)))
3943       if (MDName->getString() == "branch_weights")
3944         return ProfileData;
3945   return nullptr;
3946 }
3947 
3948 MDNode *SwitchInstProfUpdateWrapper::buildProfBranchWeightsMD() {
3949   assert(Changed && "called only if metadata has changed");
3950 
3951   if (!Weights)
3952     return nullptr;
3953 
3954   assert(SI.getNumSuccessors() == Weights->size() &&
3955          "num of prof branch_weights must accord with num of successors");
3956 
3957   bool AllZeroes =
3958       all_of(Weights.getValue(), [](uint32_t W) { return W == 0; });
3959 
3960   if (AllZeroes || Weights.getValue().size() < 2)
3961     return nullptr;
3962 
3963   return MDBuilder(SI.getParent()->getContext()).createBranchWeights(*Weights);
3964 }
3965 
3966 void SwitchInstProfUpdateWrapper::init() {
3967   MDNode *ProfileData = getProfBranchWeightsMD(SI);
3968   if (!ProfileData)
3969     return;
3970 
3971   if (ProfileData->getNumOperands() != SI.getNumSuccessors() + 1) {
3972     llvm_unreachable("number of prof branch_weights metadata operands does "
3973                      "not correspond to number of succesors");
3974   }
3975 
3976   SmallVector<uint32_t, 8> Weights;
3977   for (unsigned CI = 1, CE = SI.getNumSuccessors(); CI <= CE; ++CI) {
3978     ConstantInt *C = mdconst::extract<ConstantInt>(ProfileData->getOperand(CI));
3979     uint32_t CW = C->getValue().getZExtValue();
3980     Weights.push_back(CW);
3981   }
3982   this->Weights = std::move(Weights);
3983 }
3984 
3985 SwitchInst::CaseIt
3986 SwitchInstProfUpdateWrapper::removeCase(SwitchInst::CaseIt I) {
3987   if (Weights) {
3988     assert(SI.getNumSuccessors() == Weights->size() &&
3989            "num of prof branch_weights must accord with num of successors");
3990     Changed = true;
3991     // Copy the last case to the place of the removed one and shrink.
3992     // This is tightly coupled with the way SwitchInst::removeCase() removes
3993     // the cases in SwitchInst::removeCase(CaseIt).
3994     Weights.getValue()[I->getCaseIndex() + 1] = Weights.getValue().back();
3995     Weights.getValue().pop_back();
3996   }
3997   return SI.removeCase(I);
3998 }
3999 
4000 void SwitchInstProfUpdateWrapper::addCase(
4001     ConstantInt *OnVal, BasicBlock *Dest,
4002     SwitchInstProfUpdateWrapper::CaseWeightOpt W) {
4003   SI.addCase(OnVal, Dest);
4004 
4005   if (!Weights && W && *W) {
4006     Changed = true;
4007     Weights = SmallVector<uint32_t, 8>(SI.getNumSuccessors(), 0);
4008     Weights.getValue()[SI.getNumSuccessors() - 1] = *W;
4009   } else if (Weights) {
4010     Changed = true;
4011     Weights.getValue().push_back(W ? *W : 0);
4012   }
4013   if (Weights)
4014     assert(SI.getNumSuccessors() == Weights->size() &&
4015            "num of prof branch_weights must accord with num of successors");
4016 }
4017 
4018 SymbolTableList<Instruction>::iterator
4019 SwitchInstProfUpdateWrapper::eraseFromParent() {
4020   // Instruction is erased. Mark as unchanged to not touch it in the destructor.
4021   Changed = false;
4022   if (Weights)
4023     Weights->resize(0);
4024   return SI.eraseFromParent();
4025 }
4026 
4027 SwitchInstProfUpdateWrapper::CaseWeightOpt
4028 SwitchInstProfUpdateWrapper::getSuccessorWeight(unsigned idx) {
4029   if (!Weights)
4030     return None;
4031   return Weights.getValue()[idx];
4032 }
4033 
4034 void SwitchInstProfUpdateWrapper::setSuccessorWeight(
4035     unsigned idx, SwitchInstProfUpdateWrapper::CaseWeightOpt W) {
4036   if (!W)
4037     return;
4038 
4039   if (!Weights && *W)
4040     Weights = SmallVector<uint32_t, 8>(SI.getNumSuccessors(), 0);
4041 
4042   if (Weights) {
4043     auto &OldW = Weights.getValue()[idx];
4044     if (*W != OldW) {
4045       Changed = true;
4046       OldW = *W;
4047     }
4048   }
4049 }
4050 
4051 SwitchInstProfUpdateWrapper::CaseWeightOpt
4052 SwitchInstProfUpdateWrapper::getSuccessorWeight(const SwitchInst &SI,
4053                                                 unsigned idx) {
4054   if (MDNode *ProfileData = getProfBranchWeightsMD(SI))
4055     if (ProfileData->getNumOperands() == SI.getNumSuccessors() + 1)
4056       return mdconst::extract<ConstantInt>(ProfileData->getOperand(idx + 1))
4057           ->getValue()
4058           .getZExtValue();
4059 
4060   return None;
4061 }
4062 
4063 //===----------------------------------------------------------------------===//
4064 //                        IndirectBrInst Implementation
4065 //===----------------------------------------------------------------------===//
4066 
4067 void IndirectBrInst::init(Value *Address, unsigned NumDests) {
4068   assert(Address && Address->getType()->isPointerTy() &&
4069          "Address of indirectbr must be a pointer");
4070   ReservedSpace = 1+NumDests;
4071   setNumHungOffUseOperands(1);
4072   allocHungoffUses(ReservedSpace);
4073 
4074   Op<0>() = Address;
4075 }
4076 
4077 
4078 /// growOperands - grow operands - This grows the operand list in response
4079 /// to a push_back style of operation.  This grows the number of ops by 2 times.
4080 ///
4081 void IndirectBrInst::growOperands() {
4082   unsigned e = getNumOperands();
4083   unsigned NumOps = e*2;
4084 
4085   ReservedSpace = NumOps;
4086   growHungoffUses(ReservedSpace);
4087 }
4088 
4089 IndirectBrInst::IndirectBrInst(Value *Address, unsigned NumCases,
4090                                Instruction *InsertBefore)
4091     : Instruction(Type::getVoidTy(Address->getContext()),
4092                   Instruction::IndirectBr, nullptr, 0, InsertBefore) {
4093   init(Address, NumCases);
4094 }
4095 
4096 IndirectBrInst::IndirectBrInst(Value *Address, unsigned NumCases,
4097                                BasicBlock *InsertAtEnd)
4098     : Instruction(Type::getVoidTy(Address->getContext()),
4099                   Instruction::IndirectBr, nullptr, 0, InsertAtEnd) {
4100   init(Address, NumCases);
4101 }
4102 
4103 IndirectBrInst::IndirectBrInst(const IndirectBrInst &IBI)
4104     : Instruction(Type::getVoidTy(IBI.getContext()), Instruction::IndirectBr,
4105                   nullptr, IBI.getNumOperands()) {
4106   allocHungoffUses(IBI.getNumOperands());
4107   Use *OL = getOperandList();
4108   const Use *InOL = IBI.getOperandList();
4109   for (unsigned i = 0, E = IBI.getNumOperands(); i != E; ++i)
4110     OL[i] = InOL[i];
4111   SubclassOptionalData = IBI.SubclassOptionalData;
4112 }
4113 
4114 /// addDestination - Add a destination.
4115 ///
4116 void IndirectBrInst::addDestination(BasicBlock *DestBB) {
4117   unsigned OpNo = getNumOperands();
4118   if (OpNo+1 > ReservedSpace)
4119     growOperands();  // Get more space!
4120   // Initialize some new operands.
4121   assert(OpNo < ReservedSpace && "Growing didn't work!");
4122   setNumHungOffUseOperands(OpNo+1);
4123   getOperandList()[OpNo] = DestBB;
4124 }
4125 
4126 /// removeDestination - This method removes the specified successor from the
4127 /// indirectbr instruction.
4128 void IndirectBrInst::removeDestination(unsigned idx) {
4129   assert(idx < getNumOperands()-1 && "Successor index out of range!");
4130 
4131   unsigned NumOps = getNumOperands();
4132   Use *OL = getOperandList();
4133 
4134   // Replace this value with the last one.
4135   OL[idx+1] = OL[NumOps-1];
4136 
4137   // Nuke the last value.
4138   OL[NumOps-1].set(nullptr);
4139   setNumHungOffUseOperands(NumOps-1);
4140 }
4141 
4142 //===----------------------------------------------------------------------===//
4143 //                            FreezeInst Implementation
4144 //===----------------------------------------------------------------------===//
4145 
4146 FreezeInst::FreezeInst(Value *S,
4147                        const Twine &Name, Instruction *InsertBefore)
4148     : UnaryInstruction(S->getType(), Freeze, S, InsertBefore) {
4149   setName(Name);
4150 }
4151 
4152 FreezeInst::FreezeInst(Value *S,
4153                        const Twine &Name, BasicBlock *InsertAtEnd)
4154     : UnaryInstruction(S->getType(), Freeze, S, InsertAtEnd) {
4155   setName(Name);
4156 }
4157 
4158 //===----------------------------------------------------------------------===//
4159 //                           cloneImpl() implementations
4160 //===----------------------------------------------------------------------===//
4161 
4162 // Define these methods here so vtables don't get emitted into every translation
4163 // unit that uses these classes.
4164 
4165 GetElementPtrInst *GetElementPtrInst::cloneImpl() const {
4166   return new (getNumOperands()) GetElementPtrInst(*this);
4167 }
4168 
4169 UnaryOperator *UnaryOperator::cloneImpl() const {
4170   return Create(getOpcode(), Op<0>());
4171 }
4172 
4173 BinaryOperator *BinaryOperator::cloneImpl() const {
4174   return Create(getOpcode(), Op<0>(), Op<1>());
4175 }
4176 
4177 FCmpInst *FCmpInst::cloneImpl() const {
4178   return new FCmpInst(getPredicate(), Op<0>(), Op<1>());
4179 }
4180 
4181 ICmpInst *ICmpInst::cloneImpl() const {
4182   return new ICmpInst(getPredicate(), Op<0>(), Op<1>());
4183 }
4184 
4185 ExtractValueInst *ExtractValueInst::cloneImpl() const {
4186   return new ExtractValueInst(*this);
4187 }
4188 
4189 InsertValueInst *InsertValueInst::cloneImpl() const {
4190   return new InsertValueInst(*this);
4191 }
4192 
4193 AllocaInst *AllocaInst::cloneImpl() const {
4194   AllocaInst *Result =
4195       new AllocaInst(getAllocatedType(), getType()->getAddressSpace(),
4196                      (Value *)getOperand(0), MaybeAlign(getAlignment()));
4197   Result->setUsedWithInAlloca(isUsedWithInAlloca());
4198   Result->setSwiftError(isSwiftError());
4199   return Result;
4200 }
4201 
4202 LoadInst *LoadInst::cloneImpl() const {
4203   return new LoadInst(getType(), getOperand(0), Twine(), isVolatile(),
4204                       MaybeAlign(getAlignment()), getOrdering(),
4205                       getSyncScopeID());
4206 }
4207 
4208 StoreInst *StoreInst::cloneImpl() const {
4209   return new StoreInst(getOperand(0), getOperand(1), isVolatile(),
4210                        MaybeAlign(getAlignment()), getOrdering(),
4211                        getSyncScopeID());
4212 }
4213 
4214 AtomicCmpXchgInst *AtomicCmpXchgInst::cloneImpl() const {
4215   AtomicCmpXchgInst *Result =
4216     new AtomicCmpXchgInst(getOperand(0), getOperand(1), getOperand(2),
4217                           getSuccessOrdering(), getFailureOrdering(),
4218                           getSyncScopeID());
4219   Result->setVolatile(isVolatile());
4220   Result->setWeak(isWeak());
4221   return Result;
4222 }
4223 
4224 AtomicRMWInst *AtomicRMWInst::cloneImpl() const {
4225   AtomicRMWInst *Result =
4226     new AtomicRMWInst(getOperation(), getOperand(0), getOperand(1),
4227                       getOrdering(), getSyncScopeID());
4228   Result->setVolatile(isVolatile());
4229   return Result;
4230 }
4231 
4232 FenceInst *FenceInst::cloneImpl() const {
4233   return new FenceInst(getContext(), getOrdering(), getSyncScopeID());
4234 }
4235 
4236 TruncInst *TruncInst::cloneImpl() const {
4237   return new TruncInst(getOperand(0), getType());
4238 }
4239 
4240 ZExtInst *ZExtInst::cloneImpl() const {
4241   return new ZExtInst(getOperand(0), getType());
4242 }
4243 
4244 SExtInst *SExtInst::cloneImpl() const {
4245   return new SExtInst(getOperand(0), getType());
4246 }
4247 
4248 FPTruncInst *FPTruncInst::cloneImpl() const {
4249   return new FPTruncInst(getOperand(0), getType());
4250 }
4251 
4252 FPExtInst *FPExtInst::cloneImpl() const {
4253   return new FPExtInst(getOperand(0), getType());
4254 }
4255 
4256 UIToFPInst *UIToFPInst::cloneImpl() const {
4257   return new UIToFPInst(getOperand(0), getType());
4258 }
4259 
4260 SIToFPInst *SIToFPInst::cloneImpl() const {
4261   return new SIToFPInst(getOperand(0), getType());
4262 }
4263 
4264 FPToUIInst *FPToUIInst::cloneImpl() const {
4265   return new FPToUIInst(getOperand(0), getType());
4266 }
4267 
4268 FPToSIInst *FPToSIInst::cloneImpl() const {
4269   return new FPToSIInst(getOperand(0), getType());
4270 }
4271 
4272 PtrToIntInst *PtrToIntInst::cloneImpl() const {
4273   return new PtrToIntInst(getOperand(0), getType());
4274 }
4275 
4276 IntToPtrInst *IntToPtrInst::cloneImpl() const {
4277   return new IntToPtrInst(getOperand(0), getType());
4278 }
4279 
4280 BitCastInst *BitCastInst::cloneImpl() const {
4281   return new BitCastInst(getOperand(0), getType());
4282 }
4283 
4284 AddrSpaceCastInst *AddrSpaceCastInst::cloneImpl() const {
4285   return new AddrSpaceCastInst(getOperand(0), getType());
4286 }
4287 
4288 CallInst *CallInst::cloneImpl() const {
4289   if (hasOperandBundles()) {
4290     unsigned DescriptorBytes = getNumOperandBundles() * sizeof(BundleOpInfo);
4291     return new(getNumOperands(), DescriptorBytes) CallInst(*this);
4292   }
4293   return  new(getNumOperands()) CallInst(*this);
4294 }
4295 
4296 SelectInst *SelectInst::cloneImpl() const {
4297   return SelectInst::Create(getOperand(0), getOperand(1), getOperand(2));
4298 }
4299 
4300 VAArgInst *VAArgInst::cloneImpl() const {
4301   return new VAArgInst(getOperand(0), getType());
4302 }
4303 
4304 ExtractElementInst *ExtractElementInst::cloneImpl() const {
4305   return ExtractElementInst::Create(getOperand(0), getOperand(1));
4306 }
4307 
4308 InsertElementInst *InsertElementInst::cloneImpl() const {
4309   return InsertElementInst::Create(getOperand(0), getOperand(1), getOperand(2));
4310 }
4311 
4312 ShuffleVectorInst *ShuffleVectorInst::cloneImpl() const {
4313   return new ShuffleVectorInst(getOperand(0), getOperand(1), getOperand(2));
4314 }
4315 
4316 PHINode *PHINode::cloneImpl() const { return new PHINode(*this); }
4317 
4318 LandingPadInst *LandingPadInst::cloneImpl() const {
4319   return new LandingPadInst(*this);
4320 }
4321 
4322 ReturnInst *ReturnInst::cloneImpl() const {
4323   return new(getNumOperands()) ReturnInst(*this);
4324 }
4325 
4326 BranchInst *BranchInst::cloneImpl() const {
4327   return new(getNumOperands()) BranchInst(*this);
4328 }
4329 
4330 SwitchInst *SwitchInst::cloneImpl() const { return new SwitchInst(*this); }
4331 
4332 IndirectBrInst *IndirectBrInst::cloneImpl() const {
4333   return new IndirectBrInst(*this);
4334 }
4335 
4336 InvokeInst *InvokeInst::cloneImpl() const {
4337   if (hasOperandBundles()) {
4338     unsigned DescriptorBytes = getNumOperandBundles() * sizeof(BundleOpInfo);
4339     return new(getNumOperands(), DescriptorBytes) InvokeInst(*this);
4340   }
4341   return new(getNumOperands()) InvokeInst(*this);
4342 }
4343 
4344 CallBrInst *CallBrInst::cloneImpl() const {
4345   if (hasOperandBundles()) {
4346     unsigned DescriptorBytes = getNumOperandBundles() * sizeof(BundleOpInfo);
4347     return new (getNumOperands(), DescriptorBytes) CallBrInst(*this);
4348   }
4349   return new (getNumOperands()) CallBrInst(*this);
4350 }
4351 
4352 ResumeInst *ResumeInst::cloneImpl() const { return new (1) ResumeInst(*this); }
4353 
4354 CleanupReturnInst *CleanupReturnInst::cloneImpl() const {
4355   return new (getNumOperands()) CleanupReturnInst(*this);
4356 }
4357 
4358 CatchReturnInst *CatchReturnInst::cloneImpl() const {
4359   return new (getNumOperands()) CatchReturnInst(*this);
4360 }
4361 
4362 CatchSwitchInst *CatchSwitchInst::cloneImpl() const {
4363   return new CatchSwitchInst(*this);
4364 }
4365 
4366 FuncletPadInst *FuncletPadInst::cloneImpl() const {
4367   return new (getNumOperands()) FuncletPadInst(*this);
4368 }
4369 
4370 UnreachableInst *UnreachableInst::cloneImpl() const {
4371   LLVMContext &Context = getContext();
4372   return new UnreachableInst(Context);
4373 }
4374 
4375 FreezeInst *FreezeInst::cloneImpl() const {
4376   return new FreezeInst(getOperand(0));
4377 }
4378