add an accessor
[oota-llvm.git] / 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 //                               PHINode Class
722 //===----------------------------------------------------------------------===//
723
724 // PHINode - The PHINode class is used to represent the magical mystical PHI
725 // node, that can not exist in nature, but can be synthesized in a computer
726 // scientist's overactive imagination.
727 //
728 class PHINode : public Instruction {
729   /// ReservedSpace - The number of operands actually allocated.  NumOperands is
730   /// the number actually in use.
731   unsigned ReservedSpace;
732   PHINode(const PHINode &PN);
733 public:
734   PHINode(const Type *Ty, const std::string &Name = "",
735           Instruction *InsertBefore = 0)
736     : Instruction(Ty, Instruction::PHI, 0, 0, Name, InsertBefore),
737       ReservedSpace(0) {
738   }
739
740   PHINode(const Type *Ty, const std::string &Name, BasicBlock *InsertAtEnd)
741     : Instruction(Ty, Instruction::PHI, 0, 0, Name, InsertAtEnd),
742       ReservedSpace(0) {
743   }
744
745   ~PHINode();
746
747   /// reserveOperandSpace - This method can be used to avoid repeated
748   /// reallocation of PHI operand lists by reserving space for the correct
749   /// number of operands before adding them.  Unlike normal vector reserves,
750   /// this method can also be used to trim the operand space.
751   void reserveOperandSpace(unsigned NumValues) {
752     resizeOperands(NumValues*2);
753   }
754
755   virtual PHINode *clone() const;
756
757   /// getNumIncomingValues - Return the number of incoming edges
758   ///
759   unsigned getNumIncomingValues() const { return getNumOperands()/2; }
760
761   /// getIncomingValue - Return incoming value #x
762   ///
763   Value *getIncomingValue(unsigned i) const {
764     assert(i*2 < getNumOperands() && "Invalid value number!");
765     return getOperand(i*2);
766   }
767   void setIncomingValue(unsigned i, Value *V) {
768     assert(i*2 < getNumOperands() && "Invalid value number!");
769     setOperand(i*2, V);
770   }
771   unsigned getOperandNumForIncomingValue(unsigned i) {
772     return i*2;
773   }
774
775   /// getIncomingBlock - Return incoming basic block #x
776   ///
777   BasicBlock *getIncomingBlock(unsigned i) const {
778     return reinterpret_cast<BasicBlock*>(getOperand(i*2+1));
779   }
780   void setIncomingBlock(unsigned i, BasicBlock *BB) {
781     setOperand(i*2+1, reinterpret_cast<Value*>(BB));
782   }
783   unsigned getOperandNumForIncomingBlock(unsigned i) {
784     return i*2+1;
785   }
786
787   /// addIncoming - Add an incoming value to the end of the PHI list
788   ///
789   void addIncoming(Value *V, BasicBlock *BB) {
790     assert(getType() == V->getType() &&
791            "All operands to PHI node must be the same type as the PHI node!");
792     unsigned OpNo = NumOperands;
793     if (OpNo+2 > ReservedSpace)
794       resizeOperands(0);  // Get more space!
795     // Initialize some new operands.
796     NumOperands = OpNo+2;
797     OperandList[OpNo].init(V, this);
798     OperandList[OpNo+1].init(reinterpret_cast<Value*>(BB), this);
799   }
800
801   /// removeIncomingValue - Remove an incoming value.  This is useful if a
802   /// predecessor basic block is deleted.  The value removed is returned.
803   ///
804   /// If the last incoming value for a PHI node is removed (and DeletePHIIfEmpty
805   /// is true), the PHI node is destroyed and any uses of it are replaced with
806   /// dummy values.  The only time there should be zero incoming values to a PHI
807   /// node is when the block is dead, so this strategy is sound.
808   ///
809   Value *removeIncomingValue(unsigned Idx, bool DeletePHIIfEmpty = true);
810
811   Value *removeIncomingValue(const BasicBlock *BB, bool DeletePHIIfEmpty =true){
812     int Idx = getBasicBlockIndex(BB);
813     assert(Idx >= 0 && "Invalid basic block argument to remove!");
814     return removeIncomingValue(Idx, DeletePHIIfEmpty);
815   }
816
817   /// getBasicBlockIndex - Return the first index of the specified basic
818   /// block in the value list for this PHI.  Returns -1 if no instance.
819   ///
820   int getBasicBlockIndex(const BasicBlock *BB) const {
821     Use *OL = OperandList;
822     for (unsigned i = 0, e = getNumOperands(); i != e; i += 2)
823       if (OL[i+1] == reinterpret_cast<const Value*>(BB)) return i/2;
824     return -1;
825   }
826
827   Value *getIncomingValueForBlock(const BasicBlock *BB) const {
828     return getIncomingValue(getBasicBlockIndex(BB));
829   }
830
831   /// hasConstantValue - If the specified PHI node always merges together the 
832   /// same value, return the value, otherwise return null.
833   ///
834   Value *hasConstantValue(bool AllowNonDominatingInstruction = false) const;
835   
836   /// Methods for support type inquiry through isa, cast, and dyn_cast:
837   static inline bool classof(const PHINode *) { return true; }
838   static inline bool classof(const Instruction *I) {
839     return I->getOpcode() == Instruction::PHI;
840   }
841   static inline bool classof(const Value *V) {
842     return isa<Instruction>(V) && classof(cast<Instruction>(V));
843   }
844  private:
845   void resizeOperands(unsigned NumOperands);
846 };
847
848 //===----------------------------------------------------------------------===//
849 //                               ReturnInst Class
850 //===----------------------------------------------------------------------===//
851
852 //===---------------------------------------------------------------------------
853 /// ReturnInst - Return a value (possibly void), from a function.  Execution
854 /// does not continue in this function any longer.
855 ///
856 class ReturnInst : public TerminatorInst {
857   Use RetVal;  // Possibly null retval.
858   ReturnInst(const ReturnInst &RI) : TerminatorInst(Instruction::Ret, &RetVal,
859                                                     RI.getNumOperands()) {
860     if (RI.getNumOperands())
861       RetVal.init(RI.RetVal, this);
862   }
863
864   void init(Value *RetVal);
865
866 public:
867   // ReturnInst constructors:
868   // ReturnInst()                  - 'ret void' instruction
869   // ReturnInst(    null)          - 'ret void' instruction
870   // ReturnInst(Value* X)          - 'ret X'    instruction
871   // ReturnInst(    null, Inst *)  - 'ret void' instruction, insert before I
872   // ReturnInst(Value* X, Inst *I) - 'ret X'    instruction, insert before I
873   // ReturnInst(    null, BB *B)   - 'ret void' instruction, insert @ end of BB
874   // ReturnInst(Value* X, BB *B)   - 'ret X'    instruction, insert @ end of BB
875   //
876   // NOTE: If the Value* passed is of type void then the constructor behaves as
877   // if it was passed NULL.
878   ReturnInst(Value *retVal = 0, Instruction *InsertBefore = 0)
879     : TerminatorInst(Instruction::Ret, &RetVal, 0, InsertBefore) {
880     init(retVal);
881   }
882   ReturnInst(Value *retVal, BasicBlock *InsertAtEnd)
883     : TerminatorInst(Instruction::Ret, &RetVal, 0, InsertAtEnd) {
884     init(retVal);
885   }
886   ReturnInst(BasicBlock *InsertAtEnd)
887     : TerminatorInst(Instruction::Ret, &RetVal, 0, InsertAtEnd) {
888   }
889
890   virtual ReturnInst *clone() const;
891
892   // Transparently provide more efficient getOperand methods.
893   Value *getOperand(unsigned i) const {
894     assert(i < getNumOperands() && "getOperand() out of range!");
895     return RetVal;
896   }
897   void setOperand(unsigned i, Value *Val) {
898     assert(i < getNumOperands() && "setOperand() out of range!");
899     RetVal = Val;
900   }
901
902   Value *getReturnValue() const { return RetVal; }
903
904   unsigned getNumSuccessors() const { return 0; }
905
906   // Methods for support type inquiry through isa, cast, and dyn_cast:
907   static inline bool classof(const ReturnInst *) { return true; }
908   static inline bool classof(const Instruction *I) {
909     return (I->getOpcode() == Instruction::Ret);
910   }
911   static inline bool classof(const Value *V) {
912     return isa<Instruction>(V) && classof(cast<Instruction>(V));
913   }
914  private:
915   virtual BasicBlock *getSuccessorV(unsigned idx) const;
916   virtual unsigned getNumSuccessorsV() const;
917   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
918 };
919
920 //===----------------------------------------------------------------------===//
921 //                               BranchInst Class
922 //===----------------------------------------------------------------------===//
923
924 //===---------------------------------------------------------------------------
925 /// BranchInst - Conditional or Unconditional Branch instruction.
926 ///
927 class BranchInst : public TerminatorInst {
928   /// Ops list - Branches are strange.  The operands are ordered:
929   ///  TrueDest, FalseDest, Cond.  This makes some accessors faster because
930   /// they don't have to check for cond/uncond branchness.
931   Use Ops[3];
932   BranchInst(const BranchInst &BI);
933   void AssertOK();
934 public:
935   // BranchInst constructors (where {B, T, F} are blocks, and C is a condition):
936   // BranchInst(BB *B)                           - 'br B'
937   // BranchInst(BB* T, BB *F, Value *C)          - 'br C, T, F'
938   // BranchInst(BB* B, Inst *I)                  - 'br B'        insert before I
939   // BranchInst(BB* T, BB *F, Value *C, Inst *I) - 'br C, T, F', insert before I
940   // BranchInst(BB* B, BB *I)                    - 'br B'        insert at end
941   // BranchInst(BB* T, BB *F, Value *C, BB *I)   - 'br C, T, F', insert at end
942   BranchInst(BasicBlock *IfTrue, Instruction *InsertBefore = 0)
943     : TerminatorInst(Instruction::Br, Ops, 1, InsertBefore) {
944     assert(IfTrue != 0 && "Branch destination may not be null!");
945     Ops[0].init(reinterpret_cast<Value*>(IfTrue), this);
946   }
947   BranchInst(BasicBlock *IfTrue, BasicBlock *IfFalse, Value *Cond,
948              Instruction *InsertBefore = 0)
949     : TerminatorInst(Instruction::Br, Ops, 3, InsertBefore) {
950     Ops[0].init(reinterpret_cast<Value*>(IfTrue), this);
951     Ops[1].init(reinterpret_cast<Value*>(IfFalse), this);
952     Ops[2].init(Cond, this);
953 #ifndef NDEBUG
954     AssertOK();
955 #endif
956   }
957
958   BranchInst(BasicBlock *IfTrue, BasicBlock *InsertAtEnd)
959     : TerminatorInst(Instruction::Br, Ops, 1, InsertAtEnd) {
960     assert(IfTrue != 0 && "Branch destination may not be null!");
961     Ops[0].init(reinterpret_cast<Value*>(IfTrue), this);
962   }
963
964   BranchInst(BasicBlock *IfTrue, BasicBlock *IfFalse, Value *Cond,
965              BasicBlock *InsertAtEnd)
966     : TerminatorInst(Instruction::Br, Ops, 3, InsertAtEnd) {
967     Ops[0].init(reinterpret_cast<Value*>(IfTrue), this);
968     Ops[1].init(reinterpret_cast<Value*>(IfFalse), this);
969     Ops[2].init(Cond, this);
970 #ifndef NDEBUG
971     AssertOK();
972 #endif
973   }
974
975
976   /// Transparently provide more efficient getOperand methods.
977   Value *getOperand(unsigned i) const {
978     assert(i < getNumOperands() && "getOperand() out of range!");
979     return Ops[i];
980   }
981   void setOperand(unsigned i, Value *Val) {
982     assert(i < getNumOperands() && "setOperand() out of range!");
983     Ops[i] = Val;
984   }
985
986   virtual BranchInst *clone() const;
987
988   inline bool isUnconditional() const { return getNumOperands() == 1; }
989   inline bool isConditional()   const { return getNumOperands() == 3; }
990
991   inline Value *getCondition() const {
992     assert(isConditional() && "Cannot get condition of an uncond branch!");
993     return getOperand(2);
994   }
995
996   void setCondition(Value *V) {
997     assert(isConditional() && "Cannot set condition of unconditional branch!");
998     setOperand(2, V);
999   }
1000
1001   // setUnconditionalDest - Change the current branch to an unconditional branch
1002   // targeting the specified block.
1003   // FIXME: Eliminate this ugly method.
1004   void setUnconditionalDest(BasicBlock *Dest) {
1005     if (isConditional()) {  // Convert this to an uncond branch.
1006       NumOperands = 1;
1007       Ops[1].set(0);
1008       Ops[2].set(0);
1009     }
1010     setOperand(0, reinterpret_cast<Value*>(Dest));
1011   }
1012
1013   unsigned getNumSuccessors() const { return 1+isConditional(); }
1014
1015   BasicBlock *getSuccessor(unsigned i) const {
1016     assert(i < getNumSuccessors() && "Successor # out of range for Branch!");
1017     return (i == 0) ? cast<BasicBlock>(getOperand(0)) :
1018                       cast<BasicBlock>(getOperand(1));
1019   }
1020
1021   void setSuccessor(unsigned idx, BasicBlock *NewSucc) {
1022     assert(idx < getNumSuccessors() && "Successor # out of range for Branch!");
1023     setOperand(idx, reinterpret_cast<Value*>(NewSucc));
1024   }
1025
1026   // Methods for support type inquiry through isa, cast, and dyn_cast:
1027   static inline bool classof(const BranchInst *) { return true; }
1028   static inline bool classof(const Instruction *I) {
1029     return (I->getOpcode() == Instruction::Br);
1030   }
1031   static inline bool classof(const Value *V) {
1032     return isa<Instruction>(V) && classof(cast<Instruction>(V));
1033   }
1034 private:
1035   virtual BasicBlock *getSuccessorV(unsigned idx) const;
1036   virtual unsigned getNumSuccessorsV() const;
1037   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
1038 };
1039
1040 //===----------------------------------------------------------------------===//
1041 //                               SwitchInst Class
1042 //===----------------------------------------------------------------------===//
1043
1044 //===---------------------------------------------------------------------------
1045 /// SwitchInst - Multiway switch
1046 ///
1047 class SwitchInst : public TerminatorInst {
1048   unsigned ReservedSpace;
1049   // Operand[0]    = Value to switch on
1050   // Operand[1]    = Default basic block destination
1051   // Operand[2n  ] = Value to match
1052   // Operand[2n+1] = BasicBlock to go to on match
1053   SwitchInst(const SwitchInst &RI);
1054   void init(Value *Value, BasicBlock *Default, unsigned NumCases);
1055   void resizeOperands(unsigned No);
1056 public:
1057   /// SwitchInst ctor - Create a new switch instruction, specifying a value to
1058   /// switch on and a default destination.  The number of additional cases can
1059   /// be specified here to make memory allocation more efficient.  This
1060   /// constructor can also autoinsert before another instruction.
1061   SwitchInst(Value *Value, BasicBlock *Default, unsigned NumCases,
1062              Instruction *InsertBefore = 0)
1063     : TerminatorInst(Instruction::Switch, 0, 0, InsertBefore) {
1064     init(Value, Default, NumCases);
1065   }
1066
1067   /// SwitchInst ctor - Create a new switch instruction, specifying a value to
1068   /// switch on and a default destination.  The number of additional cases can
1069   /// be specified here to make memory allocation more efficient.  This
1070   /// constructor also autoinserts at the end of the specified BasicBlock.
1071   SwitchInst(Value *Value, BasicBlock *Default, unsigned NumCases,
1072              BasicBlock *InsertAtEnd)
1073     : TerminatorInst(Instruction::Switch, 0, 0, InsertAtEnd) {
1074     init(Value, Default, NumCases);
1075   }
1076   ~SwitchInst();
1077
1078
1079   // Accessor Methods for Switch stmt
1080   inline Value *getCondition() const { return getOperand(0); }
1081   void setCondition(Value *V) { setOperand(0, V); }
1082
1083   inline BasicBlock *getDefaultDest() const {
1084     return cast<BasicBlock>(getOperand(1));
1085   }
1086
1087   /// getNumCases - return the number of 'cases' in this switch instruction.
1088   /// Note that case #0 is always the default case.
1089   unsigned getNumCases() const {
1090     return getNumOperands()/2;
1091   }
1092
1093   /// getCaseValue - Return the specified case value.  Note that case #0, the
1094   /// default destination, does not have a case value.
1095   ConstantInt *getCaseValue(unsigned i) {
1096     assert(i && i < getNumCases() && "Illegal case value to get!");
1097     return getSuccessorValue(i);
1098   }
1099
1100   /// getCaseValue - Return the specified case value.  Note that case #0, the
1101   /// default destination, does not have a case value.
1102   const ConstantInt *getCaseValue(unsigned i) const {
1103     assert(i && i < getNumCases() && "Illegal case value to get!");
1104     return getSuccessorValue(i);
1105   }
1106
1107   /// findCaseValue - Search all of the case values for the specified constant.
1108   /// If it is explicitly handled, return the case number of it, otherwise
1109   /// return 0 to indicate that it is handled by the default handler.
1110   unsigned findCaseValue(const ConstantInt *C) const {
1111     for (unsigned i = 1, e = getNumCases(); i != e; ++i)
1112       if (getCaseValue(i) == C)
1113         return i;
1114     return 0;
1115   }
1116
1117   /// addCase - Add an entry to the switch instruction...
1118   ///
1119   void addCase(ConstantInt *OnVal, BasicBlock *Dest);
1120
1121   /// removeCase - This method removes the specified successor from the switch
1122   /// instruction.  Note that this cannot be used to remove the default
1123   /// destination (successor #0).
1124   ///
1125   void removeCase(unsigned idx);
1126
1127   virtual SwitchInst *clone() const;
1128
1129   unsigned getNumSuccessors() const { return getNumOperands()/2; }
1130   BasicBlock *getSuccessor(unsigned idx) const {
1131     assert(idx < getNumSuccessors() &&"Successor idx out of range for switch!");
1132     return cast<BasicBlock>(getOperand(idx*2+1));
1133   }
1134   void setSuccessor(unsigned idx, BasicBlock *NewSucc) {
1135     assert(idx < getNumSuccessors() && "Successor # out of range for switch!");
1136     setOperand(idx*2+1, reinterpret_cast<Value*>(NewSucc));
1137   }
1138
1139   // getSuccessorValue - Return the value associated with the specified
1140   // successor.
1141   inline ConstantInt *getSuccessorValue(unsigned idx) const {
1142     assert(idx < getNumSuccessors() && "Successor # out of range!");
1143     return reinterpret_cast<ConstantInt*>(getOperand(idx*2));
1144   }
1145
1146   // Methods for support type inquiry through isa, cast, and dyn_cast:
1147   static inline bool classof(const SwitchInst *) { return true; }
1148   static inline bool classof(const Instruction *I) {
1149     return I->getOpcode() == Instruction::Switch;
1150   }
1151   static inline bool classof(const Value *V) {
1152     return isa<Instruction>(V) && classof(cast<Instruction>(V));
1153   }
1154 private:
1155   virtual BasicBlock *getSuccessorV(unsigned idx) const;
1156   virtual unsigned getNumSuccessorsV() const;
1157   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
1158 };
1159
1160 //===----------------------------------------------------------------------===//
1161 //                               InvokeInst Class
1162 //===----------------------------------------------------------------------===//
1163
1164 //===---------------------------------------------------------------------------
1165
1166 /// InvokeInst - Invoke instruction.  The SubclassData field is used to hold the
1167 /// calling convention of the call.
1168 ///
1169 class InvokeInst : public TerminatorInst {
1170   InvokeInst(const InvokeInst &BI);
1171   void init(Value *Fn, BasicBlock *IfNormal, BasicBlock *IfException,
1172             const std::vector<Value*> &Params);
1173 public:
1174   InvokeInst(Value *Fn, BasicBlock *IfNormal, BasicBlock *IfException,
1175              const std::vector<Value*> &Params, const std::string &Name = "",
1176              Instruction *InsertBefore = 0);
1177   InvokeInst(Value *Fn, BasicBlock *IfNormal, BasicBlock *IfException,
1178              const std::vector<Value*> &Params, const std::string &Name,
1179              BasicBlock *InsertAtEnd);
1180   ~InvokeInst();
1181
1182   virtual InvokeInst *clone() const;
1183
1184   bool mayWriteToMemory() const { return true; }
1185
1186   /// getCallingConv/setCallingConv - Get or set the calling convention of this
1187   /// function call.
1188   unsigned getCallingConv() const { return SubclassData; }
1189   void setCallingConv(unsigned CC) {
1190     SubclassData = CC;
1191   }
1192
1193   /// getCalledFunction - Return the function called, or null if this is an
1194   /// indirect function invocation.
1195   ///
1196   Function *getCalledFunction() const {
1197     return dyn_cast<Function>(getOperand(0));
1198   }
1199
1200   // getCalledValue - Get a pointer to a function that is invoked by this inst.
1201   inline Value *getCalledValue() const { return getOperand(0); }
1202
1203   // get*Dest - Return the destination basic blocks...
1204   BasicBlock *getNormalDest() const {
1205     return cast<BasicBlock>(getOperand(1));
1206   }
1207   BasicBlock *getUnwindDest() const {
1208     return cast<BasicBlock>(getOperand(2));
1209   }
1210   void setNormalDest(BasicBlock *B) {
1211     setOperand(1, reinterpret_cast<Value*>(B));
1212   }
1213
1214   void setUnwindDest(BasicBlock *B) {
1215     setOperand(2, reinterpret_cast<Value*>(B));
1216   }
1217
1218   inline BasicBlock *getSuccessor(unsigned i) const {
1219     assert(i < 2 && "Successor # out of range for invoke!");
1220     return i == 0 ? getNormalDest() : getUnwindDest();
1221   }
1222
1223   void setSuccessor(unsigned idx, BasicBlock *NewSucc) {
1224     assert(idx < 2 && "Successor # out of range for invoke!");
1225     setOperand(idx+1, reinterpret_cast<Value*>(NewSucc));
1226   }
1227
1228   unsigned getNumSuccessors() const { return 2; }
1229
1230   // Methods for support type inquiry through isa, cast, and dyn_cast:
1231   static inline bool classof(const InvokeInst *) { return true; }
1232   static inline bool classof(const Instruction *I) {
1233     return (I->getOpcode() == Instruction::Invoke);
1234   }
1235   static inline bool classof(const Value *V) {
1236     return isa<Instruction>(V) && classof(cast<Instruction>(V));
1237   }
1238 private:
1239   virtual BasicBlock *getSuccessorV(unsigned idx) const;
1240   virtual unsigned getNumSuccessorsV() const;
1241   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
1242 };
1243
1244
1245 //===----------------------------------------------------------------------===//
1246 //                              UnwindInst Class
1247 //===----------------------------------------------------------------------===//
1248
1249 //===---------------------------------------------------------------------------
1250 /// UnwindInst - Immediately exit the current function, unwinding the stack
1251 /// until an invoke instruction is found.
1252 ///
1253 class UnwindInst : public TerminatorInst {
1254 public:
1255   UnwindInst(Instruction *InsertBefore = 0)
1256     : TerminatorInst(Instruction::Unwind, 0, 0, InsertBefore) {
1257   }
1258   UnwindInst(BasicBlock *InsertAtEnd)
1259     : TerminatorInst(Instruction::Unwind, 0, 0, InsertAtEnd) {
1260   }
1261
1262   virtual UnwindInst *clone() const;
1263
1264   unsigned getNumSuccessors() const { return 0; }
1265
1266   // Methods for support type inquiry through isa, cast, and dyn_cast:
1267   static inline bool classof(const UnwindInst *) { return true; }
1268   static inline bool classof(const Instruction *I) {
1269     return I->getOpcode() == Instruction::Unwind;
1270   }
1271   static inline bool classof(const Value *V) {
1272     return isa<Instruction>(V) && classof(cast<Instruction>(V));
1273   }
1274 private:
1275   virtual BasicBlock *getSuccessorV(unsigned idx) const;
1276   virtual unsigned getNumSuccessorsV() const;
1277   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
1278 };
1279
1280 //===----------------------------------------------------------------------===//
1281 //                           UnreachableInst Class
1282 //===----------------------------------------------------------------------===//
1283
1284 //===---------------------------------------------------------------------------
1285 /// UnreachableInst - This function has undefined behavior.  In particular, the
1286 /// presence of this instruction indicates some higher level knowledge that the
1287 /// end of the block cannot be reached.
1288 ///
1289 class UnreachableInst : public TerminatorInst {
1290 public:
1291   UnreachableInst(Instruction *InsertBefore = 0)
1292     : TerminatorInst(Instruction::Unreachable, 0, 0, InsertBefore) {
1293   }
1294   UnreachableInst(BasicBlock *InsertAtEnd)
1295     : TerminatorInst(Instruction::Unreachable, 0, 0, InsertAtEnd) {
1296   }
1297
1298   virtual UnreachableInst *clone() const;
1299
1300   unsigned getNumSuccessors() const { return 0; }
1301
1302   // Methods for support type inquiry through isa, cast, and dyn_cast:
1303   static inline bool classof(const UnreachableInst *) { return true; }
1304   static inline bool classof(const Instruction *I) {
1305     return I->getOpcode() == Instruction::Unreachable;
1306   }
1307   static inline bool classof(const Value *V) {
1308     return isa<Instruction>(V) && classof(cast<Instruction>(V));
1309   }
1310 private:
1311   virtual BasicBlock *getSuccessorV(unsigned idx) const;
1312   virtual unsigned getNumSuccessorsV() const;
1313   virtual void setSuccessorV(unsigned idx, BasicBlock *B);
1314 };
1315
1316 } // End llvm namespace
1317
1318 #endif