1 //===-EDToken.h - LLVM Enhanced Disassembler --------------------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file defines the interface for the Enhanced Disassembly library's token
11 // class. The token is responsible for vending information about the token,
12 // such as its type and logical value.
14 //===----------------------------------------------------------------------===//
16 #ifndef LLVM_EDTOKEN_H
17 #define LLVM_EDTOKEN_H
19 #include "llvm/ADT/StringRef.h"
25 struct EDDisassembler;
27 /// EDToken - Encapsulates a single token, which can provide a string
28 /// representation of itself or interpret itself in various ways, depending
29 /// on the token type.
39 /// The parent disassembler
40 EDDisassembler &Disassembler;
42 /// The token's string representation
44 /// The token's string representation, but in a form suitable for export
46 /// The type of the token, as exposed through the external API
48 /// The type of the token, as recorded by the syntax-specific tokenizer
50 /// The operand corresponding to the token, or (unsigned int)-1 if not
51 /// part of an operand.
54 /// The sign if the token is a literal (1 if negative, 0 otherwise)
56 /// The absolute value if the token is a literal
57 uint64_t LiteralAbsoluteValue;
58 /// The LLVM register ID if the token is a register name
61 /// Constructor - Initializes an EDToken with the information common to all
64 /// @arg str - The string corresponding to the token
65 /// @arg type - The token's type as exposed through the public API
66 /// @arg localType - The token's type as recorded by the tokenizer
67 /// @arg disassembler - The disassembler responsible for the token
68 EDToken(llvm::StringRef str,
71 EDDisassembler &disassembler);
73 /// makeLiteral - Adds the information specific to a literal
74 /// @arg sign - The sign of the literal (1 if negative, 0
77 /// @arg absoluteValue - The absolute value of the literal
78 void makeLiteral(bool sign, uint64_t absoluteValue);
79 /// makeRegister - Adds the information specific to a register
81 /// @arg registerID - The LLVM register ID
82 void makeRegister(unsigned registerID);
84 /// setOperandID - Links the token to a numbered operand
86 /// @arg operandID - The operand ID to link to
87 void setOperandID(int operandID);
91 /// type - Returns the public type of the token
92 enum tokenType type() const;
93 /// localType - Returns the tokenizer-specific type of the token
94 uint64_t localType() const;
95 /// string - Returns the string representation of the token
96 llvm::StringRef string() const;
97 /// operandID - Returns the operand ID of the token
98 int operandID() const;
100 /// literalSign - Returns the sign of the token
101 /// (1 if negative, 0 if positive or unsigned, -1 if it is not a literal)
102 int literalSign() const;
103 /// literalAbsoluteValue - Retrieves the absolute value of the token, and
104 /// returns -1 if the token is not a literal
105 /// @arg value - A reference to a value that is filled in with the absolute
106 /// value, if it is valid
107 int literalAbsoluteValue(uint64_t &value) const;
108 /// registerID - Retrieves the register ID of the token, and returns -1 if the
109 /// token is not a register
111 /// @arg registerID - A reference to a value that is filled in with the
112 /// register ID, if it is valid
113 int registerID(unsigned ®isterID) const;
115 /// tokenize - Tokenizes a string using the platform- and syntax-specific
116 /// tokenizer, and returns 0 on success (-1 on failure)
118 /// @arg tokens - A vector that will be filled in with pointers to
120 /// @arg str - The string, as outputted by the AsmPrinter
121 /// @arg operandOrder - The order of the operands from the operandFlags array
122 /// as they appear in str
123 /// @arg disassembler - The disassembler for the desired target and
125 static int tokenize(std::vector<EDToken*> &tokens,
127 const char *operandOrder,
128 EDDisassembler &disassembler);
130 /// getString - Directs a character pointer to the string, returning 0 on
131 /// success (-1 on failure)
132 /// @arg buf - A reference to a pointer that is set to point to the string.
133 /// The string is still owned by the token.
134 int getString(const char*& buf);
137 } // end namespace llvm