2001-06-06 20:29:01 +00:00
|
|
|
//===-- llvm/Value.h - Definition of the Value class -------------*- C++ -*--=//
|
|
|
|
//
|
|
|
|
// This file defines the very important Value class. This is subclassed by a
|
2002-04-28 04:46:29 +00:00
|
|
|
// bunch of other important classes, like Instruction, Function, Type, etc...
|
2001-06-06 20:29:01 +00:00
|
|
|
//
|
2001-10-01 13:58:13 +00:00
|
|
|
// This file also defines the Use<> template for users of value.
|
|
|
|
//
|
2001-06-06 20:29:01 +00:00
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
|
|
|
|
#ifndef LLVM_VALUE_H
|
|
|
|
#define LLVM_VALUE_H
|
|
|
|
|
2001-09-07 16:25:23 +00:00
|
|
|
#include "llvm/AbstractTypeUser.h"
|
2003-01-14 21:29:58 +00:00
|
|
|
#include "Support/Annotation.h"
|
2002-04-08 21:51:32 +00:00
|
|
|
#include "Support/Casting.h"
|
2002-06-25 20:33:28 +00:00
|
|
|
#include <iostream>
|
2002-09-23 17:45:52 +00:00
|
|
|
#include <vector>
|
2001-06-06 20:29:01 +00:00
|
|
|
|
|
|
|
class User;
|
|
|
|
class Type;
|
2001-12-03 22:26:30 +00:00
|
|
|
class Constant;
|
2002-04-09 19:59:31 +00:00
|
|
|
class Argument;
|
2001-06-27 23:27:42 +00:00
|
|
|
class Instruction;
|
|
|
|
class BasicBlock;
|
2001-10-03 14:53:21 +00:00
|
|
|
class GlobalValue;
|
2002-03-23 22:51:58 +00:00
|
|
|
class Function;
|
2001-09-10 07:58:01 +00:00
|
|
|
class GlobalVariable;
|
2001-09-07 16:25:23 +00:00
|
|
|
class SymbolTable;
|
2001-06-06 20:29:01 +00:00
|
|
|
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
// Value Class
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
|
2002-08-25 22:54:55 +00:00
|
|
|
/// Value - The base class of all values computed by a program that may be used
|
|
|
|
/// as operands to other values.
|
|
|
|
///
|
2001-09-07 16:25:23 +00:00
|
|
|
class Value : public Annotable, // Values are annotable
|
|
|
|
public AbstractTypeUser { // Values use potentially abstract types
|
2001-06-06 20:29:01 +00:00
|
|
|
public:
|
|
|
|
enum ValueTy {
|
|
|
|
TypeVal, // This is an instance of Type
|
2001-12-03 22:26:30 +00:00
|
|
|
ConstantVal, // This is an instance of Constant
|
2002-04-09 19:59:31 +00:00
|
|
|
ArgumentVal, // This is an instance of Argument
|
2001-06-06 20:29:01 +00:00
|
|
|
InstructionVal, // This is an instance of Instruction
|
|
|
|
BasicBlockVal, // This is an instance of BasicBlock
|
2002-03-26 17:48:08 +00:00
|
|
|
FunctionVal, // This is an instance of Function
|
2001-10-03 14:53:21 +00:00
|
|
|
GlobalVariableVal, // This is an instance of GlobalVariable
|
2001-06-06 20:29:01 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
private:
|
2002-01-20 22:54:45 +00:00
|
|
|
std::vector<User *> Uses;
|
|
|
|
std::string Name;
|
2003-06-18 19:22:36 +00:00
|
|
|
PATypeHandle Ty;
|
2001-06-06 20:29:01 +00:00
|
|
|
ValueTy VTy;
|
|
|
|
|
2002-07-24 20:01:57 +00:00
|
|
|
void operator=(const Value &); // Do not implement
|
2001-06-06 20:29:01 +00:00
|
|
|
Value(const Value &); // Do not implement
|
|
|
|
public:
|
2002-01-20 22:54:45 +00:00
|
|
|
Value(const Type *Ty, ValueTy vty, const std::string &name = "");
|
2001-06-06 20:29:01 +00:00
|
|
|
virtual ~Value();
|
2001-09-18 12:23:40 +00:00
|
|
|
|
2002-08-25 22:54:55 +00:00
|
|
|
/// dump - Support for debugging, callable in GDB: V->dump()
|
|
|
|
//
|
2001-09-18 17:03:04 +00:00
|
|
|
void dump() const;
|
2002-04-08 21:51:32 +00:00
|
|
|
|
2002-08-25 22:54:55 +00:00
|
|
|
/// print - Implement operator<< on Value...
|
|
|
|
///
|
2002-04-08 21:51:32 +00:00
|
|
|
virtual void print(std::ostream &O) const = 0;
|
2001-09-18 12:23:40 +00:00
|
|
|
|
2002-08-25 22:54:55 +00:00
|
|
|
/// All values are typed, get the type of this value.
|
|
|
|
///
|
2001-09-18 17:03:04 +00:00
|
|
|
inline const Type *getType() const { return Ty; }
|
2001-09-18 12:23:40 +00:00
|
|
|
|
2001-06-27 23:27:42 +00:00
|
|
|
// All values can potentially be named...
|
2002-01-20 22:54:45 +00:00
|
|
|
inline bool hasName() const { return Name != ""; }
|
|
|
|
inline const std::string &getName() const { return Name; }
|
2001-09-18 17:03:04 +00:00
|
|
|
|
2002-01-20 22:54:45 +00:00
|
|
|
virtual void setName(const std::string &name, SymbolTable * = 0) {
|
2001-09-18 17:03:04 +00:00
|
|
|
Name = name;
|
|
|
|
}
|
2001-09-18 12:23:40 +00:00
|
|
|
|
2002-08-25 22:54:55 +00:00
|
|
|
/// getValueType - Return the immediate subclass of this Value.
|
|
|
|
///
|
2001-06-27 23:27:42 +00:00
|
|
|
inline ValueTy getValueType() const { return VTy; }
|
2001-09-18 12:23:40 +00:00
|
|
|
|
2002-08-25 22:54:55 +00:00
|
|
|
/// replaceAllUsesWith - Go through the uses list for this definition and make
|
|
|
|
/// each use point to "V" instead of "this". After this completes, 'this's
|
|
|
|
/// use list is guaranteed to be empty.
|
|
|
|
///
|
|
|
|
void replaceAllUsesWith(Value *V);
|
2001-06-06 20:29:01 +00:00
|
|
|
|
2002-08-25 22:54:55 +00:00
|
|
|
/// refineAbstractType - This function is implemented because we use
|
|
|
|
/// potentially abstract types, and these types may be resolved to more
|
|
|
|
/// concrete types after we are constructed.
|
|
|
|
///
|
2001-09-07 16:25:23 +00:00
|
|
|
virtual void refineAbstractType(const DerivedType *OldTy, const Type *NewTy);
|
2001-09-18 12:23:40 +00:00
|
|
|
|
2001-06-06 20:29:01 +00:00
|
|
|
//----------------------------------------------------------------------
|
2001-09-14 16:56:32 +00:00
|
|
|
// Methods for handling the vector of uses of this Value.
|
2001-06-06 20:29:01 +00:00
|
|
|
//
|
2002-01-20 22:54:45 +00:00
|
|
|
typedef std::vector<User*>::iterator use_iterator;
|
|
|
|
typedef std::vector<User*>::const_iterator use_const_iterator;
|
2001-06-06 20:29:01 +00:00
|
|
|
|
2001-06-07 16:58:36 +00:00
|
|
|
inline unsigned use_size() const { return Uses.size(); }
|
2001-06-06 20:29:01 +00:00
|
|
|
inline bool use_empty() const { return Uses.empty(); }
|
|
|
|
inline use_iterator use_begin() { return Uses.begin(); }
|
|
|
|
inline use_const_iterator use_begin() const { return Uses.begin(); }
|
|
|
|
inline use_iterator use_end() { return Uses.end(); }
|
|
|
|
inline use_const_iterator use_end() const { return Uses.end(); }
|
2001-10-13 06:18:19 +00:00
|
|
|
inline User *use_back() { return Uses.back(); }
|
|
|
|
inline const User *use_back() const { return Uses.back(); }
|
2001-06-06 20:29:01 +00:00
|
|
|
|
2002-10-09 00:25:01 +00:00
|
|
|
/// addUse/killUse - These two methods should only be used by the Use class
|
|
|
|
/// below.
|
2001-06-06 20:29:01 +00:00
|
|
|
inline void addUse(User *I) { Uses.push_back(I); }
|
|
|
|
void killUse(User *I);
|
|
|
|
};
|
|
|
|
|
2002-04-08 21:51:32 +00:00
|
|
|
inline std::ostream &operator<<(std::ostream &OS, const Value *V) {
|
|
|
|
if (V == 0)
|
|
|
|
OS << "<null> value!\n";
|
|
|
|
else
|
|
|
|
V->print(OS);
|
|
|
|
return OS;
|
|
|
|
}
|
|
|
|
|
2002-06-25 16:12:52 +00:00
|
|
|
inline std::ostream &operator<<(std::ostream &OS, const Value &V) {
|
|
|
|
V.print(OS);
|
|
|
|
return OS;
|
|
|
|
}
|
|
|
|
|
2001-10-01 13:58:13 +00:00
|
|
|
|
|
|
|
//===----------------------------------------------------------------------===//
|
2002-10-09 00:42:03 +00:00
|
|
|
// Use Class
|
2001-10-01 13:58:13 +00:00
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
|
2002-10-09 00:42:03 +00:00
|
|
|
// Use is here to make keeping the "use" list of a Value up-to-date really easy.
|
2001-06-06 20:29:01 +00:00
|
|
|
//
|
2002-10-09 00:42:03 +00:00
|
|
|
class Use {
|
|
|
|
Value *Val;
|
2001-06-06 20:29:01 +00:00
|
|
|
User *U;
|
|
|
|
public:
|
2002-10-09 00:42:03 +00:00
|
|
|
inline Use(Value *v, User *user) {
|
2001-06-06 20:29:01 +00:00
|
|
|
Val = v; U = user;
|
|
|
|
if (Val) Val->addUse(U);
|
|
|
|
}
|
|
|
|
|
2002-10-09 00:42:03 +00:00
|
|
|
inline Use(const Use &user) {
|
2001-06-06 20:29:01 +00:00
|
|
|
Val = 0;
|
|
|
|
U = user.U;
|
2001-06-11 15:04:06 +00:00
|
|
|
operator=(user.Val);
|
2001-06-06 20:29:01 +00:00
|
|
|
}
|
2002-10-09 00:42:03 +00:00
|
|
|
inline ~Use() { if (Val) Val->killUse(U); }
|
|
|
|
inline operator Value*() const { return Val; }
|
|
|
|
|
|
|
|
inline Value *operator=(Value *V) {
|
2001-06-06 20:29:01 +00:00
|
|
|
if (Val) Val->killUse(U);
|
|
|
|
Val = V;
|
|
|
|
if (V) V->addUse(U);
|
|
|
|
return V;
|
|
|
|
}
|
|
|
|
|
2002-10-09 00:42:03 +00:00
|
|
|
inline Value *operator->() { return Val; }
|
|
|
|
inline const Value *operator->() const { return Val; }
|
2001-06-06 20:29:01 +00:00
|
|
|
|
2002-10-09 00:42:03 +00:00
|
|
|
inline Value *get() { return Val; }
|
|
|
|
inline const Value *get() const { return Val; }
|
2001-10-01 16:18:37 +00:00
|
|
|
|
2002-10-09 00:42:03 +00:00
|
|
|
inline const Use &operator=(const Use &user) {
|
2001-06-06 20:29:01 +00:00
|
|
|
if (Val) Val->killUse(U);
|
|
|
|
Val = user.Val;
|
|
|
|
Val->addUse(U);
|
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2002-10-09 00:42:03 +00:00
|
|
|
template<> struct simplify_type<Use> {
|
|
|
|
typedef Value* SimpleType;
|
2002-06-25 16:12:52 +00:00
|
|
|
|
2002-10-09 00:42:03 +00:00
|
|
|
static SimpleType getSimplifiedValue(const Use &Val) {
|
2002-06-25 16:12:52 +00:00
|
|
|
return (SimpleType)Val.get();
|
|
|
|
}
|
|
|
|
};
|
2002-10-09 00:42:03 +00:00
|
|
|
template<> struct simplify_type<const Use> {
|
|
|
|
typedef Value* SimpleType;
|
2002-06-25 16:12:52 +00:00
|
|
|
|
2002-10-09 00:42:03 +00:00
|
|
|
static SimpleType getSimplifiedValue(const Use &Val) {
|
2002-06-25 16:12:52 +00:00
|
|
|
return (SimpleType)Val.get();
|
|
|
|
}
|
|
|
|
};
|
2001-10-01 18:26:53 +00:00
|
|
|
|
2002-04-08 21:51:32 +00:00
|
|
|
// isa - Provide some specializations of isa so that we don't have to include
|
|
|
|
// the subtype header files to test to see if the value is a subclass...
|
2001-10-01 18:26:53 +00:00
|
|
|
//
|
2002-06-25 16:12:52 +00:00
|
|
|
template <> inline bool isa_impl<Type, Value>(const Value &Val) {
|
|
|
|
return Val.getValueType() == Value::TypeVal;
|
2001-10-01 20:11:19 +00:00
|
|
|
}
|
2002-06-25 16:12:52 +00:00
|
|
|
template <> inline bool isa_impl<Constant, Value>(const Value &Val) {
|
|
|
|
return Val.getValueType() == Value::ConstantVal;
|
2001-10-01 18:26:53 +00:00
|
|
|
}
|
2002-06-25 16:12:52 +00:00
|
|
|
template <> inline bool isa_impl<Argument, Value>(const Value &Val) {
|
|
|
|
return Val.getValueType() == Value::ArgumentVal;
|
2001-10-01 20:11:19 +00:00
|
|
|
}
|
2002-06-25 16:12:52 +00:00
|
|
|
template <> inline bool isa_impl<Instruction, Value>(const Value &Val) {
|
|
|
|
return Val.getValueType() == Value::InstructionVal;
|
2001-10-01 18:26:53 +00:00
|
|
|
}
|
2002-06-25 16:12:52 +00:00
|
|
|
template <> inline bool isa_impl<BasicBlock, Value>(const Value &Val) {
|
|
|
|
return Val.getValueType() == Value::BasicBlockVal;
|
2001-10-01 20:11:19 +00:00
|
|
|
}
|
2002-06-25 16:12:52 +00:00
|
|
|
template <> inline bool isa_impl<Function, Value>(const Value &Val) {
|
|
|
|
return Val.getValueType() == Value::FunctionVal;
|
2001-10-01 18:26:53 +00:00
|
|
|
}
|
2002-06-25 16:12:52 +00:00
|
|
|
template <> inline bool isa_impl<GlobalVariable, Value>(const Value &Val) {
|
|
|
|
return Val.getValueType() == Value::GlobalVariableVal;
|
2001-10-03 14:53:21 +00:00
|
|
|
}
|
2002-06-25 16:12:52 +00:00
|
|
|
template <> inline bool isa_impl<GlobalValue, Value>(const Value &Val) {
|
2002-03-23 22:51:58 +00:00
|
|
|
return isa<GlobalVariable>(Val) || isa<Function>(Val);
|
2001-10-01 20:11:19 +00:00
|
|
|
}
|
2001-10-01 18:26:53 +00:00
|
|
|
|
2001-06-06 20:29:01 +00:00
|
|
|
#endif
|