include/llvm/Instructions.h

   1 //===-- llvm/Instructions.h - Instruction subclass definitions --*- C++ -*-===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file was developed by the LLVM research group and is distributed under
   6 // the University of Illinois Open Source License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9 //
  10 // This file exposes the class definitions of all of the subclasses of the
  11 // Instruction class.  This is meant to be an easy way to get access to all
  12 // instruction subclasses.
  13 //
  14 //===----------------------------------------------------------------------===//
  15
  16 #ifndef LLVM_INSTRUCTIONS_H
  17 #define LLVM_INSTRUCTIONS_H
  18
  19 #include "llvm/Instruction.h"
  20 #include "llvm/InstrTypes.h"
  21
  22 namespace llvm {
  23
  24 class BasicBlock;
  25 class ConstantInt;
  26 class PointerType;
  27
  28 //===----------------------------------------------------------------------===//
  29 //                             AllocationInst Class
  30 //===----------------------------------------------------------------------===//
  31
  32 /// AllocationInst - This class is the common base class of MallocInst and
  33 /// AllocaInst.
  34 ///
  35 class AllocationInst : public UnaryInstruction {
  36   unsigned Alignment;
  37 protected:
  38   AllocationInst(const Type *Ty, Value *ArraySize, unsigned iTy, unsigned Align,
  39                  const std::string &Name = "", Instruction *InsertBefore = 0);
  40   AllocationInst(const Type *Ty, Value *ArraySize, unsigned iTy, unsigned Align,
  41                  const std::string &Name, BasicBlock *InsertAtEnd);
  42
  43 public:
  44
  45   /// isArrayAllocation - Return true if there is an allocation size parameter
  46   /// to the allocation instruction that is not 1.
  47   ///
  48   bool isArrayAllocation() const;
  49
  50   /// getArraySize - Get the number of element allocated, for a simple
  51   /// allocation of a single element, this will return a constant 1 value.
  52   ///
  53   inline const Value *getArraySize() const { return getOperand(0); }
  54   inline Value *getArraySize() { return getOperand(0); }
  55
  56   /// getType - Overload to return most specific pointer type
  57   ///
  58   inline const PointerType *getType() const {
  59     return reinterpret_cast<const PointerType*>(Instruction::getType());
  60   }
  61
  62   /// getAllocatedType - Return the type that is being allocated by the
  63   /// instruction.
  64   ///
  65   const Type *getAllocatedType() const;
  66
  67   /// getAlignment - Return the alignment of the memory that is being allocated
  68   /// by the instruction.
  69   ///
  70   unsigned getAlignment() const { return Alignment; }
  71   void setAlignment(unsigned Align) {
  72     assert((Align & (Align-1)) == 0 && "Alignment is not a power of 2!");
  73     Alignment = Align;
  74   }
  75
  76   virtual Instruction *clone() const = 0;
  77
  78   // Methods for support type inquiry through isa, cast, and dyn_cast:
  79   static inline bool classof(const AllocationInst *) { return true; }
  80   static inline bool classof(const Instruction *I) {
  81     return I->getOpcode() == Instruction::Alloca ||
  82            I->getOpcode() == Instruction::Malloc;
  83   }
  84   static inline bool classof(const Value *V) {
  85     return isa<Instruction>(V) && classof(cast<Instruction>(V));
  86   }
  87 };
  88
  89
  90 //===----------------------------------------------------------------------===//
  91 //                                MallocInst Class
  92 //===----------------------------------------------------------------------===//
  93
  94 /// MallocInst - an instruction to allocated memory on the heap
  95 ///
  96 class MallocInst : public AllocationInst {
  97   MallocInst(const MallocInst &MI);
  98 public:
  99   explicit MallocInst(const Type *Ty, Value *ArraySize = 0,
 100                       const std::string &Name = "",
 101                       Instruction *InsertBefore = 0)
 102     : AllocationInst(Ty, ArraySize, Malloc, 0, Name, InsertBefore) {}
 103   MallocInst(const Type *Ty, Value *ArraySize, const std::string &Name,
 104              BasicBlock *InsertAtEnd)
 105     : AllocationInst(Ty, ArraySize, Malloc, 0, Name, InsertAtEnd) {}
 106   MallocInst(const Type *Ty, Value *ArraySize, unsigned Align,
 107              const std::string &Name, BasicBlock *InsertAtEnd)
 108   : AllocationInst(Ty, ArraySize, Malloc, Align, Name, InsertAtEnd) {}
 109   explicit MallocInst(const Type *Ty, Value *ArraySize, unsigned Align,
 110                       const std::string &Name = "",
 111                       Instruction *InsertBefore = 0)
 112   : AllocationInst(Ty, ArraySize, Malloc, Align, Name, InsertBefore) {}
 113
 114   virtual MallocInst *clone() const;
 115
 116   // Methods for support type inquiry through isa, cast, and dyn_cast:
 117   static inline bool classof(const MallocInst *) { return true; }
 118   static inline bool classof(const Instruction *I) {
 119     return (I->getOpcode() == Instruction::Malloc);
 120   }
 121   static inline bool classof(const Value *V) {
 122     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 123   }
 124 };
 125
 126
 127 //===----------------------------------------------------------------------===//
 128 //                                AllocaInst Class
 129 //===----------------------------------------------------------------------===//
 130
 131 /// AllocaInst - an instruction to allocate memory on the stack
 132 ///
 133 class AllocaInst : public AllocationInst {
 134   AllocaInst(const AllocaInst &);
 135 public:
 136   explicit AllocaInst(const Type *Ty, Value *ArraySize = 0,
 137                       const std::string &Name = "",
 138                       Instruction *InsertBefore = 0)
 139     : AllocationInst(Ty, ArraySize, Alloca, 0, Name, InsertBefore) {}
 140   AllocaInst(const Type *Ty, Value *ArraySize, const std::string &Name,
 141              BasicBlock *InsertAtEnd)
 142     : AllocationInst(Ty, ArraySize, Alloca, 0, Name, InsertAtEnd) {}
 143   AllocaInst(const Type *Ty, Value *ArraySize, unsigned Align,
 144              const std::string &Name, BasicBlock *InsertAtEnd)
 145   : AllocationInst(Ty, ArraySize, Alloca, Align, Name, InsertAtEnd) {}
 146   explicit AllocaInst(const Type *Ty, Value *ArraySize, unsigned Align,
 147                       const std::string &Name = "",
 148                       Instruction *InsertBefore = 0)
 149   : AllocationInst(Ty, ArraySize, Alloca, Align, Name, InsertBefore) {}
 150
 151   virtual AllocaInst *clone() const;
 152
 153   // Methods for support type inquiry through isa, cast, and dyn_cast:
 154   static inline bool classof(const AllocaInst *) { return true; }
 155   static inline bool classof(const Instruction *I) {
 156     return (I->getOpcode() == Instruction::Alloca);
 157   }
 158   static inline bool classof(const Value *V) {
 159     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 160   }
 161 };
 162
 163
 164 //===----------------------------------------------------------------------===//
 165 //                                 FreeInst Class
 166 //===----------------------------------------------------------------------===//
 167
 168 /// FreeInst - an instruction to deallocate memory
 169 ///
 170 class FreeInst : public UnaryInstruction {
 171   void AssertOK();
 172 public:
 173   explicit FreeInst(Value *Ptr, Instruction *InsertBefore = 0);
 174   FreeInst(Value *Ptr, BasicBlock *InsertAfter);
 175
 176   virtual FreeInst *clone() const;
 177
 178   virtual bool mayWriteToMemory() const { return true; }
 179
 180   // Methods for support type inquiry through isa, cast, and dyn_cast:
 181   static inline bool classof(const FreeInst *) { return true; }
 182   static inline bool classof(const Instruction *I) {
 183     return (I->getOpcode() == Instruction::Free);
 184   }
 185   static inline bool classof(const Value *V) {
 186     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 187   }
 188 };
 189
 190
 191 //===----------------------------------------------------------------------===//
 192 //                                LoadInst Class
 193 //===----------------------------------------------------------------------===//
 194
 195 /// LoadInst - an instruction for reading from memory.  This uses the
 196 /// SubclassData field in Value to store whether or not the load is volatile.
 197 ///
 198 class LoadInst : public UnaryInstruction {
 199   LoadInst(const LoadInst &LI)
 200     : UnaryInstruction(LI.getType(), Load, LI.getOperand(0)) {
 201     setVolatile(LI.isVolatile());
 202
 203 #ifndef NDEBUG
 204     AssertOK();
 205 #endif
 206   }
 207   void AssertOK();
 208 public:
 209   LoadInst(Value *Ptr, const std::string &Name, Instruction *InsertBefore);
 210   LoadInst(Value *Ptr, const std::string &Name, BasicBlock *InsertAtEnd);
 211   LoadInst(Value *Ptr, const std::string &Name = "", bool isVolatile = false,
 212            Instruction *InsertBefore = 0);
 213   LoadInst(Value *Ptr, const std::string &Name, bool isVolatile,
 214            BasicBlock *InsertAtEnd);
 215
 216   /// isVolatile - Return true if this is a load from a volatile memory
 217   /// location.
 218   ///
 219   bool isVolatile() const { return SubclassData; }
 220
 221   /// setVolatile - Specify whether this is a volatile load or not.
 222   ///
 223   void setVolatile(bool V) { SubclassData = V; }
 224
 225   virtual LoadInst *clone() const;
 226
 227   virtual bool mayWriteToMemory() const { return isVolatile(); }
 228
 229   Value *getPointerOperand() { return getOperand(0); }
 230   const Value *getPointerOperand() const { return getOperand(0); }
 231   static unsigned getPointerOperandIndex() { return 0U; }
 232
 233   // Methods for support type inquiry through isa, cast, and dyn_cast:
 234   static inline bool classof(const LoadInst *) { return true; }
 235   static inline bool classof(const Instruction *I) {
 236     return I->getOpcode() == Instruction::Load;
 237   }
 238   static inline bool classof(const Value *V) {
 239     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 240   }
 241 };
 242
 243
 244 //===----------------------------------------------------------------------===//
 245 //                                StoreInst Class
 246 //===----------------------------------------------------------------------===//
 247
 248 /// StoreInst - an instruction for storing to memory
 249 ///
 250 class StoreInst : public Instruction {
 251   Use Ops[2];
 252   StoreInst(const StoreInst &SI) : Instruction(SI.getType(), Store, Ops, 2) {
 253     Ops[0].init(SI.Ops[0], this);
 254     Ops[1].init(SI.Ops[1], this);
 255     setVolatile(SI.isVolatile());
 256 #ifndef NDEBUG
 257     AssertOK();
 258 #endif
 259   }
 260   void AssertOK();
 261 public:
 262   StoreInst(Value *Val, Value *Ptr, Instruction *InsertBefore);
 263   StoreInst(Value *Val, Value *Ptr, BasicBlock *InsertAtEnd);
 264   StoreInst(Value *Val, Value *Ptr, bool isVolatile = false,
 265             Instruction *InsertBefore = 0);
 266   StoreInst(Value *Val, Value *Ptr, bool isVolatile, BasicBlock *InsertAtEnd);
 267
 268
 269   /// isVolatile - Return true if this is a load from a volatile memory
 270   /// location.
 271   ///
 272   bool isVolatile() const { return SubclassData; }
 273
 274   /// setVolatile - Specify whether this is a volatile load or not.
 275   ///
 276   void setVolatile(bool V) { SubclassData = V; }
 277
 278   /// Transparently provide more efficient getOperand methods.
 279   Value *getOperand(unsigned i) const {
 280     assert(i < 2 && "getOperand() out of range!");
 281     return Ops[i];
 282   }
 283   void setOperand(unsigned i, Value *Val) {
 284     assert(i < 2 && "setOperand() out of range!");
 285     Ops[i] = Val;
 286   }
 287   unsigned getNumOperands() const { return 2; }
 288
 289
 290   virtual StoreInst *clone() const;
 291
 292   virtual bool mayWriteToMemory() const { return true; }
 293
 294   Value *getPointerOperand() { return getOperand(1); }
 295   const Value *getPointerOperand() const { return getOperand(1); }
 296   static unsigned getPointerOperandIndex() { return 1U; }
 297
 298   // Methods for support type inquiry through isa, cast, and dyn_cast:
 299   static inline bool classof(const StoreInst *) { return true; }
 300   static inline bool classof(const Instruction *I) {
 301     return I->getOpcode() == Instruction::Store;
 302   }
 303   static inline bool classof(const Value *V) {
 304     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 305   }
 306 };
 307
 308
 309 //===----------------------------------------------------------------------===//
 310 //                             GetElementPtrInst Class
 311 //===----------------------------------------------------------------------===//
 312
 313 /// GetElementPtrInst - an instruction for type-safe pointer arithmetic to
 314 /// access elements of arrays and structs
 315 ///
 316 class GetElementPtrInst : public Instruction {
 317   GetElementPtrInst(const GetElementPtrInst &GEPI)
 318     : Instruction(reinterpret_cast<const Type*>(GEPI.getType()), GetElementPtr,
 319                   0, GEPI.getNumOperands()) {
 320     Use *OL = OperandList = new Use[NumOperands];
 321     Use *GEPIOL = GEPI.OperandList;
 322     for (unsigned i = 0, E = NumOperands; i != E; ++i)
 323       OL[i].init(GEPIOL[i], this);
 324   }
 325   void init(Value *Ptr, const std::vector<Value*> &Idx);
 326   void init(Value *Ptr, Value *Idx0, Value *Idx1);
 327   void init(Value *Ptr, Value *Idx);
 328 public:
 329   /// Constructors - Create a getelementptr instruction with a base pointer an
 330   /// list of indices.  The first ctor can optionally insert before an existing
 331   /// instruction, the second appends the new instruction to the specified
 332   /// BasicBlock.
 333   GetElementPtrInst(Value *Ptr, const std::vector<Value*> &Idx,
 334                     const std::string &Name = "", Instruction *InsertBefore =0);
 335   GetElementPtrInst(Value *Ptr, const std::vector<Value*> &Idx,
 336                     const std::string &Name, BasicBlock *InsertAtEnd);
 337
 338   /// Constructors - These two constructors are convenience methods because one
 339   /// and two index getelementptr instructions are so common.
 340   GetElementPtrInst(Value *Ptr, Value *Idx,
 341                     const std::string &Name = "", Instruction *InsertBefore =0);
 342   GetElementPtrInst(Value *Ptr, Value *Idx,
 343                     const std::string &Name, BasicBlock *InsertAtEnd);
 344   GetElementPtrInst(Value *Ptr, Value *Idx0, Value *Idx1,
 345                     const std::string &Name = "", Instruction *InsertBefore =0);
 346   GetElementPtrInst(Value *Ptr, Value *Idx0, Value *Idx1,
 347                     const std::string &Name, BasicBlock *InsertAtEnd);
 348   ~GetElementPtrInst();
 349
 350   virtual GetElementPtrInst *clone() const;
 351
 352   // getType - Overload to return most specific pointer type...
 353   inline const PointerType *getType() const {
 354     return reinterpret_cast<const PointerType*>(Instruction::getType());
 355   }
 356
 357   /// getIndexedType - Returns the type of the element that would be loaded with
 358   /// a load instruction with the specified parameters.
 359   ///
 360   /// A null type is returned if the indices are invalid for the specified
 361   /// pointer type.
 362   ///
 363   static const Type *getIndexedType(const Type *Ptr,
 364                                     const std::vector<Value*> &Indices,
 365                                     bool AllowStructLeaf = false);
 366   static const Type *getIndexedType(const Type *Ptr, Value *Idx0, Value *Idx1,
 367                                     bool AllowStructLeaf = false);
 368   static const Type *getIndexedType(const Type *Ptr, Value *Idx);
 369
 370   inline op_iterator       idx_begin()       { return op_begin()+1; }
 371   inline const_op_iterator idx_begin() const { return op_begin()+1; }
 372   inline op_iterator       idx_end()         { return op_end(); }
 373   inline const_op_iterator idx_end()   const { return op_end(); }
 374
 375   Value *getPointerOperand() {
 376     return getOperand(0);
 377   }
 378   const Value *getPointerOperand() const {
 379     return getOperand(0);
 380   }
 381   static unsigned getPointerOperandIndex() {
 382     return 0U;                      // get index for modifying correct operand
 383   }
 384
 385   inline unsigned getNumIndices() const {  // Note: always non-negative
 386     return getNumOperands() - 1;
 387   }
 388
 389   inline bool hasIndices() const {
 390     return getNumOperands() > 1;
 391   }
 392
 393   // Methods for support type inquiry through isa, cast, and dyn_cast:
 394   static inline bool classof(const GetElementPtrInst *) { return true; }
 395   static inline bool classof(const Instruction *I) {
 396     return (I->getOpcode() == Instruction::GetElementPtr);
 397   }
 398   static inline bool classof(const Value *V) {
 399     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 400   }
 401 };
 402
 403 //===----------------------------------------------------------------------===//
 404 //                            SetCondInst Class
 405 //===----------------------------------------------------------------------===//
 406
 407 /// SetCondInst class - Represent a setCC operator, where CC is eq, ne, lt, gt,
 408 /// le, or ge.
 409 ///
 410 class SetCondInst : public BinaryOperator {
 411 public:
 412   SetCondInst(BinaryOps Opcode, Value *LHS, Value *RHS,
 413               const std::string &Name = "", Instruction *InsertBefore = 0);
 414   SetCondInst(BinaryOps Opcode, Value *LHS, Value *RHS,
 415               const std::string &Name, BasicBlock *InsertAtEnd);
 416
 417   /// getInverseCondition - Return the inverse of the current condition opcode.
 418   /// For example seteq -> setne, setgt -> setle, setlt -> setge, etc...
 419   ///
 420   BinaryOps getInverseCondition() const {
 421     return getInverseCondition(getOpcode());
 422   }
 423
 424   /// getInverseCondition - Static version that you can use without an
 425   /// instruction available.
 426   ///
 427   static BinaryOps getInverseCondition(BinaryOps Opcode);
 428
 429   /// getSwappedCondition - Return the condition opcode that would be the result
 430   /// of exchanging the two operands of the setcc instruction without changing
 431   /// the result produced.  Thus, seteq->seteq, setle->setge, setlt->setgt, etc.
 432   ///
 433   BinaryOps getSwappedCondition() const {
 434     return getSwappedCondition(getOpcode());
 435   }
 436
 437   /// getSwappedCondition - Static version that you can use without an
 438   /// instruction available.
 439   ///
 440   static BinaryOps getSwappedCondition(BinaryOps Opcode);
 441
 442
 443   // Methods for support type inquiry through isa, cast, and dyn_cast:
 444   static inline bool classof(const SetCondInst *) { return true; }
 445   static inline bool classof(const Instruction *I) {
 446     return I->getOpcode() == SetEQ || I->getOpcode() == SetNE ||
 447            I->getOpcode() == SetLE || I->getOpcode() == SetGE ||
 448            I->getOpcode() == SetLT || I->getOpcode() == SetGT;
 449   }
 450   static inline bool classof(const Value *V) {
 451     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 452   }
 453 };
 454
 455 //===----------------------------------------------------------------------===//
 456 //                                 CastInst Class
 457 //===----------------------------------------------------------------------===//
 458
 459 /// CastInst - This class represents a cast from Operand[0] to the type of
 460 /// the instruction (i->getType()).
 461 ///
 462 class CastInst : public UnaryInstruction {
 463   CastInst(const CastInst &CI)
 464     : UnaryInstruction(CI.getType(), Cast, CI.getOperand(0)) {
 465   }
 466 public:
 467   CastInst(Value *S, const Type *Ty, const std::string &Name = "",
 468            Instruction *InsertBefore = 0)
 469     : UnaryInstruction(Ty, Cast, S, Name, InsertBefore) {
 470   }
 471   CastInst(Value *S, const Type *Ty, const std::string &Name,
 472            BasicBlock *InsertAtEnd)
 473     : UnaryInstruction(Ty, Cast, S, Name, InsertAtEnd) {
 474   }
 475
 476   virtual CastInst *clone() const;
 477
 478   // Methods for support type inquiry through isa, cast, and dyn_cast:
 479   static inline bool classof(const CastInst *) { return true; }
 480   static inline bool classof(const Instruction *I) {
 481     return I->getOpcode() == Cast;
 482   }
 483   static inline bool classof(const Value *V) {
 484     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 485   }
 486 };
 487
 488
 489 //===----------------------------------------------------------------------===//
 490 //                                 CallInst Class
 491 //===----------------------------------------------------------------------===//
 492
 493 /// CallInst - This class represents a function call, abstracting a target
 494 /// machine's calling convention.  This class uses low bit of the SubClassData
 495 /// field to indicate whether or not this is a tail call.  The rest of the bits
 496 /// hold the calling convention of the call.
 497 ///
 498 class CallInst : public Instruction {
 499   CallInst(const CallInst &CI);
 500   void init(Value *Func, const std::vector<Value*> &Params);
 501   void init(Value *Func, Value *Actual1, Value *Actual2);
 502   void init(Value *Func, Value *Actual);
 503   void init(Value *Func);
 504
 505 public:
 506   CallInst(Value *F, const std::vector<Value*> &Par,
 507            const std::string &Name = "", Instruction *InsertBefore = 0);
 508   CallInst(Value *F, const std::vector<Value*> &Par,
 509            const std::string &Name, BasicBlock *InsertAtEnd);
 510
 511   // Alternate CallInst ctors w/ two actuals, w/ one actual and no
 512   // actuals, respectively.
 513   CallInst(Value *F, Value *Actual1, Value *Actual2,
 514            const std::string& Name = "", Instruction *InsertBefore = 0);
 515   CallInst(Value *F, Value *Actual1, Value *Actual2,
 516            const std::string& Name, BasicBlock *InsertAtEnd);
 517   CallInst(Value *F, Value *Actual, const std::string& Name = "",
 518            Instruction *InsertBefore = 0);
 519   CallInst(Value *F, Value *Actual, const std::string& Name,
 520            BasicBlock *InsertAtEnd);
 521   explicit CallInst(Value *F, const std::string &Name = "",
 522                     Instruction *InsertBefore = 0);
 523   explicit CallInst(Value *F, const std::string &Name,
 524                     BasicBlock *InsertAtEnd);
 525   ~CallInst();
 526
 527   virtual CallInst *clone() const;
 528   bool mayWriteToMemory() const { return true; }
 529
 530   bool isTailCall() const           { return SubclassData & 1; }
 531   void setTailCall(bool isTailCall = true) {
 532     SubclassData = (SubclassData & ~1) | unsigned(isTailCall);
 533   }
 534
 535   /// getCallingConv/setCallingConv - Get or set the calling convention of this
 536   /// function call.
 537   unsigned getCallingConv() const { return SubclassData >> 1; }
 538   void setCallingConv(unsigned CC) {
 539     SubclassData = (SubclassData & 1) | (CC << 1);
 540   }
 541
 542   /// getCalledFunction - Return the function being called by this instruction
 543   /// if it is a direct call.  If it is a call through a function pointer,
 544   /// return null.
 545   Function *getCalledFunction() const {
 546     return static_cast<Function*>(dyn_cast<Function>(getOperand(0)));
 547   }
 548
 549   // getCalledValue - Get a pointer to a method that is invoked by this inst.
 550   inline const Value *getCalledValue() const { return getOperand(0); }
 551   inline       Value *getCalledValue()       { return getOperand(0); }
 552
 553   // Methods for support type inquiry through isa, cast, and dyn_cast:
 554   static inline bool classof(const CallInst *) { return true; }
 555   static inline bool classof(const Instruction *I) {
 556     return I->getOpcode() == Instruction::Call;
 557   }
 558   static inline bool classof(const Value *V) {
 559     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 560   }
 561 };
 562
 563
 564 //===----------------------------------------------------------------------===//
 565 //                                 ShiftInst Class
 566 //===----------------------------------------------------------------------===//
 567
 568 /// ShiftInst - This class represents left and right shift instructions.
 569 ///
 570 class ShiftInst : public Instruction {
 571   Use Ops[2];
 572   ShiftInst(const ShiftInst &SI)
 573     : Instruction(SI.getType(), SI.getOpcode(), Ops, 2) {
 574     Ops[0].init(SI.Ops[0], this);
 575     Ops[1].init(SI.Ops[1], this);
 576   }
 577   void init(OtherOps Opcode, Value *S, Value *SA) {
 578     assert((Opcode == Shl || Opcode == Shr) && "ShiftInst Opcode invalid!");
 579     Ops[0].init(S, this);
 580     Ops[1].init(SA, this);
 581   }
 582
 583 public:
 584   ShiftInst(OtherOps Opcode, Value *S, Value *SA, const std::string &Name = "",
 585             Instruction *InsertBefore = 0)
 586     : Instruction(S->getType(), Opcode, Ops, 2, Name, InsertBefore) {
 587     init(Opcode, S, SA);
 588   }
 589   ShiftInst(OtherOps Opcode, Value *S, Value *SA, const std::string &Name,
 590             BasicBlock *InsertAtEnd)
 591     : Instruction(S->getType(), Opcode, Ops, 2, Name, InsertAtEnd) {
 592     init(Opcode, S, SA);
 593   }
 594
 595   OtherOps getOpcode() const {
 596     return static_cast<OtherOps>(Instruction::getOpcode());
 597   }
 598
 599   /// Transparently provide more efficient getOperand methods.
 600   Value *getOperand(unsigned i) const {
 601     assert(i < 2 && "getOperand() out of range!");
 602     return Ops[i];
 603   }
 604   void setOperand(unsigned i, Value *Val) {
 605     assert(i < 2 && "setOperand() out of range!");
 606     Ops[i] = Val;
 607   }
 608   unsigned getNumOperands() const { return 2; }
 609
 610   virtual ShiftInst *clone() const;
 611
 612   // Methods for support type inquiry through isa, cast, and dyn_cast:
 613   static inline bool classof(const ShiftInst *) { return true; }
 614   static inline bool classof(const Instruction *I) {
 615     return (I->getOpcode() == Instruction::Shr) |
 616            (I->getOpcode() == Instruction::Shl);
 617   }
 618   static inline bool classof(const Value *V) {
 619     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 620   }
 621 };
 622
 623 //===----------------------------------------------------------------------===//
 624 //                               SelectInst Class
 625 //===----------------------------------------------------------------------===//
 626
 627 /// SelectInst - This class represents the LLVM 'select' instruction.
 628 ///
 629 class SelectInst : public Instruction {
 630   Use Ops[3];
 631
 632   void init(Value *C, Value *S1, Value *S2) {
 633     Ops[0].init(C, this);
 634     Ops[1].init(S1, this);
 635     Ops[2].init(S2, this);
 636   }
 637
 638   SelectInst(const SelectInst &SI)
 639     : Instruction(SI.getType(), SI.getOpcode(), Ops, 3) {
 640     init(SI.Ops[0], SI.Ops[1], SI.Ops[2]);
 641   }
 642 public:
 643   SelectInst(Value *C, Value *S1, Value *S2, const std::string &Name = "",
 644              Instruction *InsertBefore = 0)
 645     : Instruction(S1->getType(), Instruction::Select, Ops, 3,
 646                   Name, InsertBefore) {
 647     init(C, S1, S2);
 648   }
 649   SelectInst(Value *C, Value *S1, Value *S2, const std::string &Name,
 650              BasicBlock *InsertAtEnd)
 651     : Instruction(S1->getType(), Instruction::Select, Ops, 3,
 652                   Name, InsertAtEnd) {
 653     init(C, S1, S2);
 654   }
 655
 656   Value *getCondition() const { return Ops[0]; }
 657   Value *getTrueValue() const { return Ops[1]; }
 658   Value *getFalseValue() const { return Ops[2]; }
 659
 660   /// Transparently provide more efficient getOperand methods.
 661   Value *getOperand(unsigned i) const {
 662     assert(i < 3 && "getOperand() out of range!");
 663     return Ops[i];
 664   }
 665   void setOperand(unsigned i, Value *Val) {
 666     assert(i < 3 && "setOperand() out of range!");
 667     Ops[i] = Val;
 668   }
 669   unsigned getNumOperands() const { return 3; }
 670
 671   OtherOps getOpcode() const {
 672     return static_cast<OtherOps>(Instruction::getOpcode());
 673   }
 674
 675   virtual SelectInst *clone() const;
 676
 677   // Methods for support type inquiry through isa, cast, and dyn_cast:
 678   static inline bool classof(const SelectInst *) { return true; }
 679   static inline bool classof(const Instruction *I) {
 680     return I->getOpcode() == Instruction::Select;
 681   }
 682   static inline bool classof(const Value *V) {
 683     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 684   }
 685 };
 686
 687 //===----------------------------------------------------------------------===//
 688 //                                VAArgInst Class
 689 //===----------------------------------------------------------------------===//
 690
 691 /// VAArgInst - This class represents the va_arg llvm instruction, which returns
 692 /// an argument of the specified type given a va_list and increments that list
 693 ///
 694 class VAArgInst : public UnaryInstruction {
 695   VAArgInst(const VAArgInst &VAA)
 696     : UnaryInstruction(VAA.getType(), VAArg, VAA.getOperand(0)) {}
 697 public:
 698   VAArgInst(Value *List, const Type *Ty, const std::string &Name = "",
 699              Instruction *InsertBefore = 0)
 700     : UnaryInstruction(Ty, VAArg, List, Name, InsertBefore) {
 701   }
 702   VAArgInst(Value *List, const Type *Ty, const std::string &Name,
 703             BasicBlock *InsertAtEnd)
 704     : UnaryInstruction(Ty, VAArg, List, Name, InsertAtEnd) {
 705   }
 706
 707   virtual VAArgInst *clone() const;
 708   bool mayWriteToMemory() const { return true; }
 709
 710   // Methods for support type inquiry through isa, cast, and dyn_cast:
 711   static inline bool classof(const VAArgInst *) { return true; }
 712   static inline bool classof(const Instruction *I) {
 713     return I->getOpcode() == VAArg;
 714   }
 715   static inline bool classof(const Value *V) {
 716     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 717   }
 718 };
 719
 720 //===----------------------------------------------------------------------===//
 721 //                                ExtractElementInst Class
 722 //===----------------------------------------------------------------------===//
 723
 724 /// ExtractElementInst - This instruction extracts a single (scalar)
 725 /// element from a PackedType value
 726 ///
 727 class ExtractElementInst : public Instruction {
 728   Use Ops[2];
 729   ExtractElementInst(const ExtractElementInst &EI) :
 730     Instruction(EI.getType(), ExtractElement, Ops, 2) {
 731     Ops[0].init(EI.Ops[0], this);
 732     Ops[1].init(EI.Ops[1], this);
 733   }
 734
 735 public:
 736   ExtractElementInst(Value *Val, Value *Index,
 737                const std::string &Name = "", Instruction *InsertBefore = 0);
 738   ExtractElementInst(Value *Val, Value *Index,
 739                const std::string &Name, BasicBlock *InsertAtEnd);
 740
 741   virtual ExtractElementInst *clone() const;
 742
 743   virtual bool mayWriteToMemory() const { return false; }
 744
 745   /// Transparently provide more efficient getOperand methods.
 746   Value *getOperand(unsigned i) const {
 747     assert(i < 2 && "getOperand() out of range!");
 748     return Ops[i];
 749   }
 750   void setOperand(unsigned i, Value *Val) {
 751     assert(i < 2 && "setOperand() out of range!");
 752     Ops[i] = Val;
 753   }
 754   unsigned getNumOperands() const { return 2; }
 755
 756   // Methods for support type inquiry through isa, cast, and dyn_cast:
 757   static inline bool classof(const ExtractElementInst *) { return true; }
 758   static inline bool classof(const Instruction *I) {
 759     return I->getOpcode() == Instruction::ExtractElement;
 760   }
 761   static inline bool classof(const Value *V) {
 762     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 763   }
 764 };
 765
 766 //===----------------------------------------------------------------------===//
 767 //                               PHINode Class
 768 //===----------------------------------------------------------------------===//
 769
 770 // PHINode - The PHINode class is used to represent the magical mystical PHI
 771 // node, that can not exist in nature, but can be synthesized in a computer
 772 // scientist's overactive imagination.
 773 //
 774 class PHINode : public Instruction {
 775   /// ReservedSpace - The number of operands actually allocated.  NumOperands is
 776   /// the number actually in use.
 777   unsigned ReservedSpace;
 778   PHINode(const PHINode &PN);
 779 public:
 780   PHINode(const Type *Ty, const std::string &Name = "",
 781           Instruction *InsertBefore = 0)
 782     : Instruction(Ty, Instruction::PHI, 0, 0, Name, InsertBefore),
 783       ReservedSpace(0) {
 784   }
 785
 786   PHINode(const Type *Ty, const std::string &Name, BasicBlock *InsertAtEnd)
 787     : Instruction(Ty, Instruction::PHI, 0, 0, Name, InsertAtEnd),
 788       ReservedSpace(0) {
 789   }
 790
 791   ~PHINode();
 792
 793   /// reserveOperandSpace - This method can be used to avoid repeated
 794   /// reallocation of PHI operand lists by reserving space for the correct
 795   /// number of operands before adding them.  Unlike normal vector reserves,
 796   /// this method can also be used to trim the operand space.
 797   void reserveOperandSpace(unsigned NumValues) {
 798     resizeOperands(NumValues*2);
 799   }
 800
 801   virtual PHINode *clone() const;
 802
 803   /// getNumIncomingValues - Return the number of incoming edges
 804   ///
 805   unsigned getNumIncomingValues() const { return getNumOperands()/2; }
 806
 807   /// getIncomingValue - Return incoming value #x
 808   ///
 809   Value *getIncomingValue(unsigned i) const {
 810     assert(i*2 < getNumOperands() && "Invalid value number!");
 811     return getOperand(i*2);
 812   }
 813   void setIncomingValue(unsigned i, Value *V) {
 814     assert(i*2 < getNumOperands() && "Invalid value number!");
 815     setOperand(i*2, V);
 816   }
 817   unsigned getOperandNumForIncomingValue(unsigned i) {
 818     return i*2;
 819   }
 820
 821   /// getIncomingBlock - Return incoming basic block #x
 822   ///
 823   BasicBlock *getIncomingBlock(unsigned i) const {
 824     return reinterpret_cast<BasicBlock*>(getOperand(i*2+1));
 825   }
 826   void setIncomingBlock(unsigned i, BasicBlock *BB) {
 827     setOperand(i*2+1, reinterpret_cast<Value*>(BB));
 828   }
 829   unsigned getOperandNumForIncomingBlock(unsigned i) {
 830     return i*2+1;
 831   }
 832
 833   /// addIncoming - Add an incoming value to the end of the PHI list
 834   ///
 835   void addIncoming(Value *V, BasicBlock *BB) {
 836     assert(getType() == V->getType() &&
 837            "All operands to PHI node must be the same type as the PHI node!");
 838     unsigned OpNo = NumOperands;
 839     if (OpNo+2 > ReservedSpace)
 840       resizeOperands(0);  // Get more space!
 841     // Initialize some new operands.
 842     NumOperands = OpNo+2;
 843     OperandList[OpNo].init(V, this);
 844     OperandList[OpNo+1].init(reinterpret_cast<Value*>(BB), this);
 845   }
 846
 847   /// removeIncomingValue - Remove an incoming value.  This is useful if a
 848   /// predecessor basic block is deleted.  The value removed is returned.
 849   ///
 850   /// If the last incoming value for a PHI node is removed (and DeletePHIIfEmpty
 851   /// is true), the PHI node is destroyed and any uses of it are replaced with
 852   /// dummy values.  The only time there should be zero incoming values to a PHI
 853   /// node is when the block is dead, so this strategy is sound.
 854   ///
 855   Value *removeIncomingValue(unsigned Idx, bool DeletePHIIfEmpty = true);
 856
 857   Value *removeIncomingValue(const BasicBlock *BB, bool DeletePHIIfEmpty =true){
 858     int Idx = getBasicBlockIndex(BB);
 859     assert(Idx >= 0 && "Invalid basic block argument to remove!");
 860     return removeIncomingValue(Idx, DeletePHIIfEmpty);
 861   }
 862
 863   /// getBasicBlockIndex - Return the first index of the specified basic
 864   /// block in the value list for this PHI.  Returns -1 if no instance.
 865   ///
 866   int getBasicBlockIndex(const BasicBlock *BB) const {
 867     Use *OL = OperandList;
 868     for (unsigned i = 0, e = getNumOperands(); i != e; i += 2)
 869       if (OL[i+1] == reinterpret_cast<const Value*>(BB)) return i/2;
 870     return -1;
 871   }
 872
 873   Value *getIncomingValueForBlock(const BasicBlock *BB) const {
 874     return getIncomingValue(getBasicBlockIndex(BB));
 875   }
 876
 877   /// hasConstantValue - If the specified PHI node always merges together the
 878   /// same value, return the value, otherwise return null.
 879   ///
 880   Value *hasConstantValue(bool AllowNonDominatingInstruction = false) const;
 881
 882   /// Methods for support type inquiry through isa, cast, and dyn_cast:
 883   static inline bool classof(const PHINode *) { return true; }
 884   static inline bool classof(const Instruction *I) {
 885     return I->getOpcode() == Instruction::PHI;
 886   }
 887   static inline bool classof(const Value *V) {
 888     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 889   }
 890  private:
 891   void resizeOperands(unsigned NumOperands);
 892 };
 893
 894 //===----------------------------------------------------------------------===//
 895 //                               ReturnInst Class
 896 //===----------------------------------------------------------------------===//
 897
 898 //===---------------------------------------------------------------------------
 899 /// ReturnInst - Return a value (possibly void), from a function.  Execution
 900 /// does not continue in this function any longer.
 901 ///
 902 class ReturnInst : public TerminatorInst {
 903   Use RetVal;  // Possibly null retval.
 904   ReturnInst(const ReturnInst &RI) : TerminatorInst(Instruction::Ret, &RetVal,
 905                                                     RI.getNumOperands()) {
 906     if (RI.getNumOperands())
 907       RetVal.init(RI.RetVal, this);
 908   }
 909
 910   void init(Value *RetVal);
 911
 912 public:
 913   // ReturnInst constructors:
 914   // ReturnInst()                  - 'ret void' instruction
 915   // ReturnInst(    null)          - 'ret void' instruction
 916   // ReturnInst(Value* X)          - 'ret X'    instruction
 917   // ReturnInst(    null, Inst *)  - 'ret void' instruction, insert before I
 918   // ReturnInst(Value* X, Inst *I) - 'ret X'    instruction, insert before I
 919   // ReturnInst(    null, BB *B)   - 'ret void' instruction, insert @ end of BB
 920   // ReturnInst(Value* X, BB *B)   - 'ret X'    instruction, insert @ end of BB
 921   //
 922   // NOTE: If the Value* passed is of type void then the constructor behaves as
 923   // if it was passed NULL.
 924   ReturnInst(Value *retVal = 0, Instruction *InsertBefore = 0)
 925     : TerminatorInst(Instruction::Ret, &RetVal, 0, InsertBefore) {
 926     init(retVal);
 927   }
 928   ReturnInst(Value *retVal, BasicBlock *InsertAtEnd)
 929     : TerminatorInst(Instruction::Ret, &RetVal, 0, InsertAtEnd) {
 930     init(retVal);
 931   }
 932   ReturnInst(BasicBlock *InsertAtEnd)
 933     : TerminatorInst(Instruction::Ret, &RetVal, 0, InsertAtEnd) {
 934   }
 935
 936   virtual ReturnInst *clone() const;
 937
 938   // Transparently provide more efficient getOperand methods.
 939   Value *getOperand(unsigned i) const {
 940     assert(i < getNumOperands() && "getOperand() out of range!");
 941     return RetVal;
 942   }
 943   void setOperand(unsigned i, Value *Val) {
 944     assert(i < getNumOperands() && "setOperand() out of range!");
 945     RetVal = Val;
 946   }
 947
 948   Value *getReturnValue() const { return RetVal; }
 949
 950   unsigned getNumSuccessors() const { return 0; }
 951
 952   // Methods for support type inquiry through isa, cast, and dyn_cast:
 953   static inline bool classof(const ReturnInst *) { return true; }
 954   static inline bool classof(const Instruction *I) {
 955     return (I->getOpcode() == Instruction::Ret);
 956   }
 957   static inline bool classof(const Value *V) {
 958     return isa<Instruction>(V) && classof(cast<Instruction>(V));
 959   }
 960  private:
 961   virtual BasicBlock *getSuccessorV(unsigned idx) const;
 962   virtual unsigned getNumSuccessorsV() const;
 963   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
 964 };
 965
 966 //===----------------------------------------------------------------------===//
 967 //                               BranchInst Class
 968 //===----------------------------------------------------------------------===//
 969
 970 //===---------------------------------------------------------------------------
 971 /// BranchInst - Conditional or Unconditional Branch instruction.
 972 ///
 973 class BranchInst : public TerminatorInst {
 974   /// Ops list - Branches are strange.  The operands are ordered:
 975   ///  TrueDest, FalseDest, Cond.  This makes some accessors faster because
 976   /// they don't have to check for cond/uncond branchness.
 977   Use Ops[3];
 978   BranchInst(const BranchInst &BI);
 979   void AssertOK();
 980 public:
 981   // BranchInst constructors (where {B, T, F} are blocks, and C is a condition):
 982   // BranchInst(BB *B)                           - 'br B'
 983   // BranchInst(BB* T, BB *F, Value *C)          - 'br C, T, F'
 984   // BranchInst(BB* B, Inst *I)                  - 'br B'        insert before I
 985   // BranchInst(BB* T, BB *F, Value *C, Inst *I) - 'br C, T, F', insert before I
 986   // BranchInst(BB* B, BB *I)                    - 'br B'        insert at end
 987   // BranchInst(BB* T, BB *F, Value *C, BB *I)   - 'br C, T, F', insert at end
 988   BranchInst(BasicBlock *IfTrue, Instruction *InsertBefore = 0)
 989     : TerminatorInst(Instruction::Br, Ops, 1, InsertBefore) {
 990     assert(IfTrue != 0 && "Branch destination may not be null!");
 991     Ops[0].init(reinterpret_cast<Value*>(IfTrue), this);
 992   }
 993   BranchInst(BasicBlock *IfTrue, BasicBlock *IfFalse, Value *Cond,
 994              Instruction *InsertBefore = 0)
 995     : TerminatorInst(Instruction::Br, Ops, 3, InsertBefore) {
 996     Ops[0].init(reinterpret_cast<Value*>(IfTrue), this);
 997     Ops[1].init(reinterpret_cast<Value*>(IfFalse), this);
 998     Ops[2].init(Cond, this);
 999 #ifndef NDEBUG
1000     AssertOK();
1001 #endif
1002   }
1003
1004   BranchInst(BasicBlock *IfTrue, BasicBlock *InsertAtEnd)
1005     : TerminatorInst(Instruction::Br, Ops, 1, InsertAtEnd) {
1006     assert(IfTrue != 0 && "Branch destination may not be null!");
1007     Ops[0].init(reinterpret_cast<Value*>(IfTrue), this);
1008   }
1009
1010   BranchInst(BasicBlock *IfTrue, BasicBlock *IfFalse, Value *Cond,
1011              BasicBlock *InsertAtEnd)
1012     : TerminatorInst(Instruction::Br, Ops, 3, InsertAtEnd) {
1013     Ops[0].init(reinterpret_cast<Value*>(IfTrue), this);
1014     Ops[1].init(reinterpret_cast<Value*>(IfFalse), this);
1015     Ops[2].init(Cond, this);
1016 #ifndef NDEBUG
1017     AssertOK();
1018 #endif
1019   }
1020
1021
1022   /// Transparently provide more efficient getOperand methods.
1023   Value *getOperand(unsigned i) const {
1024     assert(i < getNumOperands() && "getOperand() out of range!");
1025     return Ops[i];
1026   }
1027   void setOperand(unsigned i, Value *Val) {
1028     assert(i < getNumOperands() && "setOperand() out of range!");
1029     Ops[i] = Val;
1030   }
1031
1032   virtual BranchInst *clone() const;
1033
1034   inline bool isUnconditional() const { return getNumOperands() == 1; }
1035   inline bool isConditional()   const { return getNumOperands() == 3; }
1036
1037   inline Value *getCondition() const {
1038     assert(isConditional() && "Cannot get condition of an uncond branch!");
1039     return getOperand(2);
1040   }
1041
1042   void setCondition(Value *V) {
1043     assert(isConditional() && "Cannot set condition of unconditional branch!");
1044     setOperand(2, V);
1045   }
1046
1047   // setUnconditionalDest - Change the current branch to an unconditional branch
1048   // targeting the specified block.
1049   // FIXME: Eliminate this ugly method.
1050   void setUnconditionalDest(BasicBlock *Dest) {
1051     if (isConditional()) {  // Convert this to an uncond branch.
1052       NumOperands = 1;
1053       Ops[1].set(0);
1054       Ops[2].set(0);
1055     }
1056     setOperand(0, reinterpret_cast<Value*>(Dest));
1057   }
1058
1059   unsigned getNumSuccessors() const { return 1+isConditional(); }
1060
1061   BasicBlock *getSuccessor(unsigned i) const {
1062     assert(i < getNumSuccessors() && "Successor # out of range for Branch!");
1063     return (i == 0) ? cast<BasicBlock>(getOperand(0)) :
1064                       cast<BasicBlock>(getOperand(1));
1065   }
1066
1067   void setSuccessor(unsigned idx, BasicBlock *NewSucc) {
1068     assert(idx < getNumSuccessors() && "Successor # out of range for Branch!");
1069     setOperand(idx, reinterpret_cast<Value*>(NewSucc));
1070   }
1071
1072   // Methods for support type inquiry through isa, cast, and dyn_cast:
1073   static inline bool classof(const BranchInst *) { return true; }
1074   static inline bool classof(const Instruction *I) {
1075     return (I->getOpcode() == Instruction::Br);
1076   }
1077   static inline bool classof(const Value *V) {
1078     return isa<Instruction>(V) && classof(cast<Instruction>(V));
1079   }
1080 private:
1081   virtual BasicBlock *getSuccessorV(unsigned idx) const;
1082   virtual unsigned getNumSuccessorsV() const;
1083   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
1084 };
1085
1086 //===----------------------------------------------------------------------===//
1087 //                               SwitchInst Class
1088 //===----------------------------------------------------------------------===//
1089
1090 //===---------------------------------------------------------------------------
1091 /// SwitchInst - Multiway switch
1092 ///
1093 class SwitchInst : public TerminatorInst {
1094   unsigned ReservedSpace;
1095   // Operand[0]    = Value to switch on
1096   // Operand[1]    = Default basic block destination
1097   // Operand[2n  ] = Value to match
1098   // Operand[2n+1] = BasicBlock to go to on match
1099   SwitchInst(const SwitchInst &RI);
1100   void init(Value *Value, BasicBlock *Default, unsigned NumCases);
1101   void resizeOperands(unsigned No);
1102 public:
1103   /// SwitchInst ctor - Create a new switch instruction, specifying a value to
1104   /// switch on and a default destination.  The number of additional cases can
1105   /// be specified here to make memory allocation more efficient.  This
1106   /// constructor can also autoinsert before another instruction.
1107   SwitchInst(Value *Value, BasicBlock *Default, unsigned NumCases,
1108              Instruction *InsertBefore = 0)
1109     : TerminatorInst(Instruction::Switch, 0, 0, InsertBefore) {
1110     init(Value, Default, NumCases);
1111   }
1112
1113   /// SwitchInst ctor - Create a new switch instruction, specifying a value to
1114   /// switch on and a default destination.  The number of additional cases can
1115   /// be specified here to make memory allocation more efficient.  This
1116   /// constructor also autoinserts at the end of the specified BasicBlock.
1117   SwitchInst(Value *Value, BasicBlock *Default, unsigned NumCases,
1118              BasicBlock *InsertAtEnd)
1119     : TerminatorInst(Instruction::Switch, 0, 0, InsertAtEnd) {
1120     init(Value, Default, NumCases);
1121   }
1122   ~SwitchInst();
1123
1124
1125   // Accessor Methods for Switch stmt
1126   inline Value *getCondition() const { return getOperand(0); }
1127   void setCondition(Value *V) { setOperand(0, V); }
1128
1129   inline BasicBlock *getDefaultDest() const {
1130     return cast<BasicBlock>(getOperand(1));
1131   }
1132
1133   /// getNumCases - return the number of 'cases' in this switch instruction.
1134   /// Note that case #0 is always the default case.
1135   unsigned getNumCases() const {
1136     return getNumOperands()/2;
1137   }
1138
1139   /// getCaseValue - Return the specified case value.  Note that case #0, the
1140   /// default destination, does not have a case value.
1141   ConstantInt *getCaseValue(unsigned i) {
1142     assert(i && i < getNumCases() && "Illegal case value to get!");
1143     return getSuccessorValue(i);
1144   }
1145
1146   /// getCaseValue - Return the specified case value.  Note that case #0, the
1147   /// default destination, does not have a case value.
1148   const ConstantInt *getCaseValue(unsigned i) const {
1149     assert(i && i < getNumCases() && "Illegal case value to get!");
1150     return getSuccessorValue(i);
1151   }
1152
1153   /// findCaseValue - Search all of the case values for the specified constant.
1154   /// If it is explicitly handled, return the case number of it, otherwise
1155   /// return 0 to indicate that it is handled by the default handler.
1156   unsigned findCaseValue(const ConstantInt *C) const {
1157     for (unsigned i = 1, e = getNumCases(); i != e; ++i)
1158       if (getCaseValue(i) == C)
1159         return i;
1160     return 0;
1161   }
1162
1163   /// addCase - Add an entry to the switch instruction...
1164   ///
1165   void addCase(ConstantInt *OnVal, BasicBlock *Dest);
1166
1167   /// removeCase - This method removes the specified successor from the switch
1168   /// instruction.  Note that this cannot be used to remove the default
1169   /// destination (successor #0).
1170   ///
1171   void removeCase(unsigned idx);
1172
1173   virtual SwitchInst *clone() const;
1174
1175   unsigned getNumSuccessors() const { return getNumOperands()/2; }
1176   BasicBlock *getSuccessor(unsigned idx) const {
1177     assert(idx < getNumSuccessors() &&"Successor idx out of range for switch!");
1178     return cast<BasicBlock>(getOperand(idx*2+1));
1179   }
1180   void setSuccessor(unsigned idx, BasicBlock *NewSucc) {
1181     assert(idx < getNumSuccessors() && "Successor # out of range for switch!");
1182     setOperand(idx*2+1, reinterpret_cast<Value*>(NewSucc));
1183   }
1184
1185   // getSuccessorValue - Return the value associated with the specified
1186   // successor.
1187   inline ConstantInt *getSuccessorValue(unsigned idx) const {
1188     assert(idx < getNumSuccessors() && "Successor # out of range!");
1189     return reinterpret_cast<ConstantInt*>(getOperand(idx*2));
1190   }
1191
1192   // Methods for support type inquiry through isa, cast, and dyn_cast:
1193   static inline bool classof(const SwitchInst *) { return true; }
1194   static inline bool classof(const Instruction *I) {
1195     return I->getOpcode() == Instruction::Switch;
1196   }
1197   static inline bool classof(const Value *V) {
1198     return isa<Instruction>(V) && classof(cast<Instruction>(V));
1199   }
1200 private:
1201   virtual BasicBlock *getSuccessorV(unsigned idx) const;
1202   virtual unsigned getNumSuccessorsV() const;
1203   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
1204 };
1205
1206 //===----------------------------------------------------------------------===//
1207 //                               InvokeInst Class
1208 //===----------------------------------------------------------------------===//
1209
1210 //===---------------------------------------------------------------------------
1211
1212 /// InvokeInst - Invoke instruction.  The SubclassData field is used to hold the
1213 /// calling convention of the call.
1214 ///
1215 class InvokeInst : public TerminatorInst {
1216   InvokeInst(const InvokeInst &BI);
1217   void init(Value *Fn, BasicBlock *IfNormal, BasicBlock *IfException,
1218             const std::vector<Value*> &Params);
1219 public:
1220   InvokeInst(Value *Fn, BasicBlock *IfNormal, BasicBlock *IfException,
1221              const std::vector<Value*> &Params, const std::string &Name = "",
1222              Instruction *InsertBefore = 0);
1223   InvokeInst(Value *Fn, BasicBlock *IfNormal, BasicBlock *IfException,
1224              const std::vector<Value*> &Params, const std::string &Name,
1225              BasicBlock *InsertAtEnd);
1226   ~InvokeInst();
1227
1228   virtual InvokeInst *clone() const;
1229
1230   bool mayWriteToMemory() const { return true; }
1231
1232   /// getCallingConv/setCallingConv - Get or set the calling convention of this
1233   /// function call.
1234   unsigned getCallingConv() const { return SubclassData; }
1235   void setCallingConv(unsigned CC) {
1236     SubclassData = CC;
1237   }
1238
1239   /// getCalledFunction - Return the function called, or null if this is an
1240   /// indirect function invocation.
1241   ///
1242   Function *getCalledFunction() const {
1243     return dyn_cast<Function>(getOperand(0));
1244   }
1245
1246   // getCalledValue - Get a pointer to a function that is invoked by this inst.
1247   inline Value *getCalledValue() const { return getOperand(0); }
1248
1249   // get*Dest - Return the destination basic blocks...
1250   BasicBlock *getNormalDest() const {
1251     return cast<BasicBlock>(getOperand(1));
1252   }
1253   BasicBlock *getUnwindDest() const {
1254     return cast<BasicBlock>(getOperand(2));
1255   }
1256   void setNormalDest(BasicBlock *B) {
1257     setOperand(1, reinterpret_cast<Value*>(B));
1258   }
1259
1260   void setUnwindDest(BasicBlock *B) {
1261     setOperand(2, reinterpret_cast<Value*>(B));
1262   }
1263
1264   inline BasicBlock *getSuccessor(unsigned i) const {
1265     assert(i < 2 && "Successor # out of range for invoke!");
1266     return i == 0 ? getNormalDest() : getUnwindDest();
1267   }
1268
1269   void setSuccessor(unsigned idx, BasicBlock *NewSucc) {
1270     assert(idx < 2 && "Successor # out of range for invoke!");
1271     setOperand(idx+1, reinterpret_cast<Value*>(NewSucc));
1272   }
1273
1274   unsigned getNumSuccessors() const { return 2; }
1275
1276   // Methods for support type inquiry through isa, cast, and dyn_cast:
1277   static inline bool classof(const InvokeInst *) { return true; }
1278   static inline bool classof(const Instruction *I) {
1279     return (I->getOpcode() == Instruction::Invoke);
1280   }
1281   static inline bool classof(const Value *V) {
1282     return isa<Instruction>(V) && classof(cast<Instruction>(V));
1283   }
1284 private:
1285   virtual BasicBlock *getSuccessorV(unsigned idx) const;
1286   virtual unsigned getNumSuccessorsV() const;
1287   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
1288 };
1289
1290
1291 //===----------------------------------------------------------------------===//
1292 //                              UnwindInst Class
1293 //===----------------------------------------------------------------------===//
1294
1295 //===---------------------------------------------------------------------------
1296 /// UnwindInst - Immediately exit the current function, unwinding the stack
1297 /// until an invoke instruction is found.
1298 ///
1299 class UnwindInst : public TerminatorInst {
1300 public:
1301   UnwindInst(Instruction *InsertBefore = 0)
1302     : TerminatorInst(Instruction::Unwind, 0, 0, InsertBefore) {
1303   }
1304   UnwindInst(BasicBlock *InsertAtEnd)
1305     : TerminatorInst(Instruction::Unwind, 0, 0, InsertAtEnd) {
1306   }
1307
1308   virtual UnwindInst *clone() const;
1309
1310   unsigned getNumSuccessors() const { return 0; }
1311
1312   // Methods for support type inquiry through isa, cast, and dyn_cast:
1313   static inline bool classof(const UnwindInst *) { return true; }
1314   static inline bool classof(const Instruction *I) {
1315     return I->getOpcode() == Instruction::Unwind;
1316   }
1317   static inline bool classof(const Value *V) {
1318     return isa<Instruction>(V) && classof(cast<Instruction>(V));
1319   }
1320 private:
1321   virtual BasicBlock *getSuccessorV(unsigned idx) const;
1322   virtual unsigned getNumSuccessorsV() const;
1323   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
1324 };
1325
1326 //===----------------------------------------------------------------------===//
1327 //                           UnreachableInst Class
1328 //===----------------------------------------------------------------------===//
1329
1330 //===---------------------------------------------------------------------------
1331 /// UnreachableInst - This function has undefined behavior.  In particular, the
1332 /// presence of this instruction indicates some higher level knowledge that the
1333 /// end of the block cannot be reached.
1334 ///
1335 class UnreachableInst : public TerminatorInst {
1336 public:
1337   UnreachableInst(Instruction *InsertBefore = 0)
1338     : TerminatorInst(Instruction::Unreachable, 0, 0, InsertBefore) {
1339   }
1340   UnreachableInst(BasicBlock *InsertAtEnd)
1341     : TerminatorInst(Instruction::Unreachable, 0, 0, InsertAtEnd) {
1342   }
1343
1344   virtual UnreachableInst *clone() const;
1345
1346   unsigned getNumSuccessors() const { return 0; }
1347
1348   // Methods for support type inquiry through isa, cast, and dyn_cast:
1349   static inline bool classof(const UnreachableInst *) { return true; }
1350   static inline bool classof(const Instruction *I) {
1351     return I->getOpcode() == Instruction::Unreachable;
1352   }
1353   static inline bool classof(const Value *V) {
1354     return isa<Instruction>(V) && classof(cast<Instruction>(V));
1355   }
1356 private:
1357   virtual BasicBlock *getSuccessorV(unsigned idx) const;
1358   virtual unsigned getNumSuccessorsV() const;
1359   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
1360 };
1361
1362 } // End llvm namespace
1363
1364 #endif