//===- Record.h - Classes to represent Table Records ------------*- C++ -*-===// // // This file defines the main TableGen data structures, including the TableGen // types, values, and high-level data structures. // //===----------------------------------------------------------------------===// #ifndef RECORD_H #define RECORD_H #include #include #include #include #include // RecTy subclasses... class BitRecTy; class BitsRecTy; class IntRecTy; class StringRecTy; class ListRecTy; class CodeRecTy; class DagRecTy; class RecordRecTy; // Init subclasses... class Init; class UnsetInit; class BitInit; class BitsInit; class IntInit; class StringInit; class CodeInit; class ListInit; class DefInit; class DagInit; class TypedInit; class VarInit; class FieldInit; class VarBitInit; // Other classes... class Record; //===----------------------------------------------------------------------===// // Type Classes //===----------------------------------------------------------------------===// struct RecTy { virtual ~RecTy() {} virtual void print(std::ostream &OS) const = 0; void dump() const; /// typeIsConvertibleTo - Return true if all values of 'this' type can be /// converted to the specified type. virtual bool typeIsConvertibleTo(const RecTy *RHS) const = 0; public: // These methods should only be called from subclasses of Init virtual Init *convertValue( UnsetInit *UI) { return 0; } virtual Init *convertValue( BitInit *BI) { return 0; } virtual Init *convertValue( BitsInit *BI) { return 0; } virtual Init *convertValue( IntInit *II) { return 0; } virtual Init *convertValue(StringInit *SI) { return 0; } virtual Init *convertValue( ListInit *LI) { return 0; } virtual Init *convertValue( CodeInit *CI) { return 0; } virtual Init *convertValue(VarBitInit *VB) { return 0; } virtual Init *convertValue( DefInit *DI) { return 0; } virtual Init *convertValue( DagInit *DI) { return 0; } virtual Init *convertValue( TypedInit *TI) { return 0; } virtual Init *convertValue( VarInit *VI) { return convertValue((TypedInit*)VI); } virtual Init *convertValue( FieldInit *FI) { return convertValue((TypedInit*)FI); } public: // These methods should only be called by subclasses of RecTy. // baseClassOf - These virtual methods should be overloaded to return true iff // all values of type 'RHS' can be converted to the 'this' type. virtual bool baseClassOf(const BitRecTy *RHS) const { return false; } virtual bool baseClassOf(const BitsRecTy *RHS) const { return false; } virtual bool baseClassOf(const IntRecTy *RHS) const { return false; } virtual bool baseClassOf(const StringRecTy *RHS) const { return false; } virtual bool baseClassOf(const ListRecTy *RHS) const { return false; } virtual bool baseClassOf(const CodeRecTy *RHS) const { return false; } virtual bool baseClassOf(const DagRecTy *RHS) const { return false; } virtual bool baseClassOf(const RecordRecTy *RHS) const { return false; } }; inline std::ostream &operator<<(std::ostream &OS, const RecTy &Ty) { Ty.print(OS); return OS; } /// BitRecTy - 'bit' - Represent a single bit /// struct BitRecTy : public RecTy { Init *convertValue(UnsetInit *UI) { return (Init*)UI; } Init *convertValue(BitInit *BI) { return (Init*)BI; } Init *convertValue(BitsInit *BI); Init *convertValue(IntInit *II); Init *convertValue(TypedInit *VI); Init *convertValue(VarBitInit *VB) { return (Init*)VB; } void print(std::ostream &OS) const { OS << "bit"; } bool typeIsConvertibleTo(const RecTy *RHS) const { return RHS->baseClassOf(this); } virtual bool baseClassOf(const BitRecTy *RHS) const { return true; } virtual bool baseClassOf(const BitsRecTy *RHS) const; virtual bool baseClassOf(const IntRecTy *RHS) const { return true; } }; /// BitsRecTy - 'bits' - Represent a fixed number of bits /// class BitsRecTy : public RecTy { unsigned Size; public: BitsRecTy(unsigned Sz) : Size(Sz) {} unsigned getNumBits() const { return Size; } Init *convertValue(UnsetInit *UI); Init *convertValue(BitInit *UI); Init *convertValue(BitsInit *BI); Init *convertValue(IntInit *II); Init *convertValue(TypedInit *VI); void print(std::ostream &OS) const { OS << "bits<" << Size << ">"; } bool typeIsConvertibleTo(const RecTy *RHS) const { return RHS->baseClassOf(this); } virtual bool baseClassOf(const BitRecTy *RHS) const { return Size == 1; } virtual bool baseClassOf(const IntRecTy *RHS) const { return true; } virtual bool baseClassOf(const BitsRecTy *RHS) const { return RHS->Size == Size; } }; /// IntRecTy - 'int' - Represent an integer value of no particular size /// struct IntRecTy : public RecTy { Init *convertValue(UnsetInit *UI) { return (Init*)UI; } Init *convertValue(IntInit *II) { return (Init*)II; } Init *convertValue(BitInit *BI); Init *convertValue(BitsInit *BI); Init *convertValue(TypedInit *TI); void print(std::ostream &OS) const { OS << "int"; } bool typeIsConvertibleTo(const RecTy *RHS) const { return RHS->baseClassOf(this); } virtual bool baseClassOf(const BitRecTy *RHS) const { return true; } virtual bool baseClassOf(const IntRecTy *RHS) const { return true; } virtual bool baseClassOf(const BitsRecTy *RHS) const { return true; } }; /// StringRecTy - 'string' - Represent an string value /// struct StringRecTy : public RecTy { Init *convertValue(UnsetInit *UI) { return (Init*)UI; } Init *convertValue(StringInit *SI) { return (Init*)SI; } Init *convertValue(TypedInit *TI); void print(std::ostream &OS) const { OS << "string"; } bool typeIsConvertibleTo(const RecTy *RHS) const { return RHS->baseClassOf(this); } virtual bool baseClassOf(const StringRecTy *RHS) const { return true; } }; /// ListRecTy - 'list' - Represent a list of values, all of which must be of /// the specified type. /// class ListRecTy : public RecTy { RecTy *Ty; public: ListRecTy(RecTy *T) : Ty(T) {} RecTy *getElementType() const { return Ty; } Init *convertValue(UnsetInit *UI) { return (Init*)UI; } Init *convertValue(ListInit *LI); Init *convertValue(TypedInit *TI); void print(std::ostream &OS) const; bool typeIsConvertibleTo(const RecTy *RHS) const { return RHS->baseClassOf(this); } virtual bool baseClassOf(const ListRecTy *RHS) const { return RHS->getElementType()->typeIsConvertibleTo(Ty); } }; /// CodeRecTy - 'code' - Represent an code fragment, function or method. /// struct CodeRecTy : public RecTy { Init *convertValue(UnsetInit *UI) { return (Init*)UI; } Init *convertValue( CodeInit *CI) { return (Init*)CI; } Init *convertValue(TypedInit *TI); void print(std::ostream &OS) const { OS << "code"; } bool typeIsConvertibleTo(const RecTy *RHS) const { return RHS->baseClassOf(this); } virtual bool baseClassOf(const CodeRecTy *RHS) const { return true; } }; /// DagRecTy - 'dag' - Represent a dag fragment /// struct DagRecTy : public RecTy { Init *convertValue(UnsetInit *UI) { return (Init*)UI; } Init *convertValue( DagInit *CI) { return (Init*)CI; } Init *convertValue(TypedInit *TI); void print(std::ostream &OS) const { OS << "dag"; } bool typeIsConvertibleTo(const RecTy *RHS) const { return RHS->baseClassOf(this); } virtual bool baseClassOf(const DagRecTy *RHS) const { return true; } }; /// RecordRecTy - '' - Represent an instance of a class, such as: /// (R32 X = EAX). /// class RecordRecTy : public RecTy { Record *Rec; public: RecordRecTy(Record *R) : Rec(R) {} Record *getRecord() const { return Rec; } Init *convertValue(UnsetInit *UI) { return (Init*)UI; } Init *convertValue( DefInit *DI); Init *convertValue(TypedInit *VI); void print(std::ostream &OS) const; bool typeIsConvertibleTo(const RecTy *RHS) const { return RHS->baseClassOf(this); } virtual bool baseClassOf(const RecordRecTy *RHS) const; }; //===----------------------------------------------------------------------===// // Initializer Classes //===----------------------------------------------------------------------===// struct Init { virtual ~Init() {} /// isComplete - This virtual method should be overridden by values that may /// not be completely specified yet. virtual bool isComplete() const { return true; } /// print - Print out this value. virtual void print(std::ostream &OS) const = 0; /// dump - Debugging method that may be called through a debugger, just /// invokes print on cerr. void dump() const; /// convertInitializerTo - This virtual function is a simple call-back /// function that should be overridden to call the appropriate /// RecTy::convertValue method. /// virtual Init *convertInitializerTo(RecTy *Ty) = 0; /// convertInitializerBitRange - This method is used to implement the bitrange /// selection operator. Given an initializer, it selects the specified bits /// out, returning them as a new init of bits type. If it is not legal to use /// the bit subscript operator on this initializer, return null. /// virtual Init *convertInitializerBitRange(const std::vector &Bits) { return 0; } /// getFieldType - This method is used to implement the FieldInit class. /// Implementors of this method should return the type of the named field if /// they are of record type. /// virtual RecTy *getFieldType(const std::string &FieldName) const { return 0; } /// getFieldInit - This method complements getFieldType to return the /// initializer for the specified field. If getFieldType returns non-null /// this method should return non-null, otherwise it returns null. /// virtual Init *getFieldInit(Record &R, const std::string &FieldName) const { return 0; } /// resolveReferences - This method is used by classes that refer to other /// variables which may not be defined at the time they expression is formed. /// If a value is set for the variable later, this method will be called on /// users of the value to allow the value to propagate out. /// virtual Init *resolveReferences(Record &R) { return this; } }; inline std::ostream &operator<<(std::ostream &OS, const Init &I) { I.print(OS); return OS; } /// UnsetInit - ? - Represents an uninitialized value /// struct UnsetInit : public Init { virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } virtual bool isComplete() const { return false; } virtual void print(std::ostream &OS) const { OS << "?"; } }; /// BitInit - true/false - Represent a concrete initializer for a bit. /// class BitInit : public Init { bool Value; public: BitInit(bool V) : Value(V) {} bool getValue() const { return Value; } virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } virtual void print(std::ostream &OS) const { OS << (Value ? "1" : "0"); } }; /// BitsInit - { a, b, c } - Represents an initializer for a BitsRecTy value. /// It contains a vector of bits, whose size is determined by the type. /// class BitsInit : public Init { std::vector Bits; public: BitsInit(unsigned Size) : Bits(Size) {} unsigned getNumBits() const { return Bits.size(); } Init *getBit(unsigned Bit) const { assert(Bit < Bits.size() && "Bit index out of range!"); return Bits[Bit]; } void setBit(unsigned Bit, Init *V) { assert(Bit < Bits.size() && "Bit index out of range!"); assert(Bits[Bit] == 0 && "Bit already set!"); Bits[Bit] = V; } virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } virtual Init *convertInitializerBitRange(const std::vector &Bits); virtual bool isComplete() const { for (unsigned i = 0; i != getNumBits(); ++i) if (!getBit(i)->isComplete()) return false; return true; } virtual void print(std::ostream &OS) const; virtual Init *resolveReferences(Record &R); // printXX - Print this bitstream with the specified format, returning true if // it is not possible. bool printInHex(std::ostream &OS) const; bool printAsVariable(std::ostream &OS) const; bool printAsUnset(std::ostream &OS) const; }; /// IntInit - 7 - Represent an initalization by a literal integer value. /// class IntInit : public Init { int Value; public: IntInit(int V) : Value(V) {} int getValue() const { return Value; } virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } virtual Init *convertInitializerBitRange(const std::vector &Bits); virtual void print(std::ostream &OS) const { OS << Value; } }; /// StringInit - "foo" - Represent an initialization by a string value. /// class StringInit : public Init { std::string Value; public: StringInit(const std::string &V) : Value(V) {} const std::string &getValue() const { return Value; } virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } virtual void print(std::ostream &OS) const { OS << "\"" << Value << "\""; } }; /// CodeInit - "[{...}]" - Represent a code fragment. /// class CodeInit : public Init { std::string Value; public: CodeInit(const std::string &V) : Value(V) {} const std::string getValue() const { return Value; } virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } virtual void print(std::ostream &OS) const { OS << "[{" << Value << "}]"; } }; /// ListInit - [AL, AH, CL] - Represent a list of defs /// class ListInit : public Init { std::vector Values; public: ListInit(std::vector &Vs) { Values.swap(Vs); } unsigned getSize() const { return Values.size(); } Init *getElement(unsigned i) const { assert(i < Values.size() && "List element index out of range!"); return Values[i]; } virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } virtual void print(std::ostream &OS) const; }; /// TypedInit - This is the common super-class of types that have a specific, /// explicit, type. /// class TypedInit : public Init { RecTy *Ty; public: TypedInit(RecTy *T) : Ty(T) {} RecTy *getType() const { return Ty; } /// resolveBitReference - This method is used to implement /// VarBitInit::resolveReferences. If the bit is able to be resolved, we /// simply return the resolved value, otherwise we return this. /// virtual Init *resolveBitReference(Record &R, unsigned Bit) = 0; }; /// VarInit - 'Opcode' - Represent a reference to an entire variable object. /// class VarInit : public TypedInit { std::string VarName; public: VarInit(const std::string &VN, RecTy *T) : TypedInit(T), VarName(VN) {} virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } const std::string &getName() const { return VarName; } virtual Init *convertInitializerBitRange(const std::vector &Bits); virtual Init *resolveBitReference(Record &R, unsigned Bit); virtual RecTy *getFieldType(const std::string &FieldName) const; virtual Init *getFieldInit(Record &R, const std::string &FieldName) const; /// resolveReferences - This method is used by classes that refer to other /// variables which may not be defined at the time they expression is formed. /// If a value is set for the variable later, this method will be called on /// users of the value to allow the value to propagate out. /// virtual Init *resolveReferences(Record &R); virtual void print(std::ostream &OS) const { OS << VarName; } }; /// VarBitInit - Opcode{0} - Represent access to one bit of a variable or field. /// class VarBitInit : public Init { TypedInit *TI; unsigned Bit; public: VarBitInit(TypedInit *T, unsigned B) : TI(T), Bit(B) { assert(T->getType() && dynamic_cast(T->getType()) && ((BitsRecTy*)T->getType())->getNumBits() > B && "Illegal VarBitInit expression!"); } virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } TypedInit *getVariable() const { return TI; } unsigned getBitNum() const { return Bit; } virtual void print(std::ostream &OS) const { TI->print(OS); OS << "{" << Bit << "}"; } virtual Init *resolveReferences(Record &R); }; /// DefInit - AL - Represent a reference to a 'def' in the description /// class DefInit : public Init { Record *Def; public: DefInit(Record *D) : Def(D) {} virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } Record *getDef() const { return Def; } //virtual Init *convertInitializerBitRange(const std::vector &Bits); virtual RecTy *getFieldType(const std::string &FieldName) const; virtual Init *getFieldInit(Record &R, const std::string &FieldName) const; virtual void print(std::ostream &OS) const; }; /// FieldInit - X.Y - Represent a reference to a subfield of a variable /// class FieldInit : public TypedInit { Init *Rec; // Record we are referring to std::string FieldName; // Field we are accessing public: FieldInit(Init *R, const std::string &FN) : TypedInit(R->getFieldType(FN)), Rec(R), FieldName(FN) { assert(getType() && "FieldInit with non-record type!"); } virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } virtual Init *convertInitializerBitRange(const std::vector &Bits); virtual Init *resolveBitReference(Record &R, unsigned Bit); virtual Init *resolveReferences(Record &R); virtual void print(std::ostream &OS) const { Rec->print(OS); OS << "." << FieldName; } }; /// DagInit - (def a, b) - Represent a DAG tree value. DAG inits are required /// to have Records for their first value, after that, any legal Init is /// possible. /// class DagInit : public Init { Record *NodeTypeDef; std::vector Args; std::vector ArgNames; public: DagInit(Record *D, const std::vector > &args) : NodeTypeDef(D) { Args.reserve(args.size()); ArgNames.reserve(args.size()); for (unsigned i = 0, e = args.size(); i != e; ++i) { Args.push_back(args[i].first); ArgNames.push_back(args[i].second); } } virtual Init *convertInitializerTo(RecTy *Ty) { return Ty->convertValue(this); } Record *getNodeType() const { return NodeTypeDef; } unsigned getNumArgs() const { return Args.size(); } Init *getArg(unsigned Num) const { assert(Num < Args.size() && "Arg number out of range!"); return Args[Num]; } const std::string &getArgName(unsigned Num) const { assert(Num < ArgNames.size() && "Arg number out of range!"); return ArgNames[Num]; } void setArg(unsigned Num, Init *I) { assert(Num < Args.size() && "Arg number out of range!"); Args[Num] = I; } virtual void print(std::ostream &OS) const; }; //===----------------------------------------------------------------------===// // High-Level Classes //===----------------------------------------------------------------------===// class RecordVal { std::string Name; RecTy *Ty; unsigned Prefix; Init *Value; public: RecordVal(const std::string &N, RecTy *T, unsigned P); const std::string &getName() const { return Name; } unsigned getPrefix() const { return Prefix; } RecTy *getType() const { return Ty; } Init *getValue() const { return Value; } bool setValue(Init *V) { if (V) { Value = V->convertInitializerTo(Ty); return Value == 0; } Value = 0; return false; } void dump() const; void print(std::ostream &OS, bool PrintSem = true) const; }; inline std::ostream &operator<<(std::ostream &OS, const RecordVal &RV) { RV.print(OS << " "); return OS; } struct Record { const std::string Name; std::vector TemplateArgs; std::vector Values; std::vector SuperClasses; public: Record(const std::string &N) : Name(N) {} ~Record() {} const std::string &getName() const { return Name; } const std::vector &getTemplateArgs() const { return TemplateArgs; } const std::vector &getValues() const { return Values; } const std::vector &getSuperClasses() const { return SuperClasses; } bool isTemplateArg(const std::string &Name) const { for (unsigned i = 0, e = TemplateArgs.size(); i != e; ++i) if (TemplateArgs[i] == Name) return true; return false; } const RecordVal *getValue(const std::string &Name) const { for (unsigned i = 0, e = Values.size(); i != e; ++i) if (Values[i].getName() == Name) return &Values[i]; return 0; } RecordVal *getValue(const std::string &Name) { for (unsigned i = 0, e = Values.size(); i != e; ++i) if (Values[i].getName() == Name) return &Values[i]; return 0; } void addTemplateArg(const std::string &Name) { assert(!isTemplateArg(Name) && "Template arg already defined!"); TemplateArgs.push_back(Name); } void addValue(const RecordVal &RV) { assert(getValue(RV.getName()) == 0 && "Value already added!"); Values.push_back(RV); } void removeValue(const std::string &Name) { assert(getValue(Name) && "Cannot remove an entry that does not exist!"); for (unsigned i = 0, e = Values.size(); i != e; ++i) if (Values[i].getName() == Name) { Values.erase(Values.begin()+i); return; } assert(0 && "Name does not exist in record!"); } bool isSubClassOf(Record *R) const { for (unsigned i = 0, e = SuperClasses.size(); i != e; ++i) if (SuperClasses[i] == R) return true; return false; } bool isSubClassOf(const std::string &Name) const { for (unsigned i = 0, e = SuperClasses.size(); i != e; ++i) if (SuperClasses[i]->getName() == Name) return true; return false; } void addSuperClass(Record *R) { assert(!isSubClassOf(R) && "Already subclassing record!"); SuperClasses.push_back(R); } // resolveReferences - If there are any field references that refer to fields // that have been filled in, we can propagate the values now. // void resolveReferences(); void dump() const; //===--------------------------------------------------------------------===// // High-level methods useful to tablegen back-ends // /// getValueInit - Return the initializer for a value with the specified name, /// or throw an exception if the field does not exist. /// Init *getValueInit(const std::string &FieldName) const; /// getValueAsString - This method looks up the specified field and returns /// its value as a string, throwing an exception if the field does not exist /// or if the value is not a string. /// std::string getValueAsString(const std::string &FieldName) const; /// getValueAsBitsInit - This method looks up the specified field and returns /// its value as a BitsInit, throwing an exception if the field does not exist /// or if the value is not the right type. /// BitsInit *getValueAsBitsInit(const std::string &FieldName) const; /// getValueAsListInit - This method looks up the specified field and returns /// its value as a ListInit, throwing an exception if the field does not exist /// or if the value is not the right type. /// ListInit *getValueAsListInit(const std::string &FieldName) const; /// getValueAsDef - This method looks up the specified field and returns its /// value as a Record, throwing an exception if the field does not exist or if /// the value is not the right type. /// Record *getValueAsDef(const std::string &FieldName) const; /// getValueAsBit - This method looks up the specified field and returns its /// value as a bit, throwing an exception if the field does not exist or if /// the value is not the right type. /// bool getValueAsBit(const std::string &FieldName) const; /// getValueAsInt - This method looks up the specified field and returns its /// value as an int, throwing an exception if the field does not exist or if /// the value is not the right type. /// int getValueAsInt(const std::string &FieldName) const; /// getValueAsDag - This method looks up the specified field and returns its /// value as an Dag, throwing an exception if the field does not exist or if /// the value is not the right type. /// DagInit *getValueAsDag(const std::string &FieldName) const; }; std::ostream &operator<<(std::ostream &OS, const Record &R); class RecordKeeper { std::map Classes, Defs; public: ~RecordKeeper() { for (std::map::iterator I = Classes.begin(), E = Classes.end(); I != E; ++I) delete I->second; for (std::map::iterator I = Defs.begin(), E = Defs.end(); I != E; ++I) delete I->second; } const std::map &getClasses() const { return Classes; } const std::map &getDefs() const { return Defs; } Record *getClass(const std::string &Name) const { std::map::const_iterator I = Classes.find(Name); return I == Classes.end() ? 0 : I->second; } Record *getDef(const std::string &Name) const { std::map::const_iterator I = Defs.find(Name); return I == Defs.end() ? 0 : I->second; } void addClass(Record *R) { assert(getClass(R->getName()) == 0 && "Class already exists!"); Classes.insert(std::make_pair(R->getName(), R)); } void addDef(Record *R) { assert(getDef(R->getName()) == 0 && "Def already exists!"); Defs.insert(std::make_pair(R->getName(), R)); } //===--------------------------------------------------------------------===// // High-level helper methods, useful for tablegen backends... /// getAllDerivedDefinitions - This method returns all concrete definitions /// that derive from the specified class name. If a class with the specified /// name does not exist, an exception is thrown. std::vector getAllDerivedDefinitions(const std::string &ClassName) const; void dump() const; }; std::ostream &operator<<(std::ostream &OS, const RecordKeeper &RK); extern RecordKeeper Records; #endif