1 //===- AsmWriterInst.h - Classes encapsulating a printable inst -*- C++ -*-===// 2 // 3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 4 // See https://llvm.org/LICENSE.txt for license information. 5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 6 // 7 //===----------------------------------------------------------------------===// 8 // 9 // These classes implement a parser for assembly strings. The parser splits 10 // the string into operands, which can be literal strings (the constant bits of 11 // the string), actual operands (i.e., operands from the MachineInstr), and 12 // dynamically-generated text, specified by raw C++ code. 13 // 14 //===----------------------------------------------------------------------===// 15 16 #ifndef LLVM_UTILS_TABLEGEN_ASMWRITERINST_H 17 #define LLVM_UTILS_TABLEGEN_ASMWRITERINST_H 18 19 #include <string> 20 #include <vector> 21 22 namespace llvm { 23 class CodeGenInstruction; 24 class Record; 25 26 struct AsmWriterOperand { 27 enum OpType { 28 // Output this text surrounded by quotes to the asm. 29 isLiteralTextOperand, 30 // This is the name of a routine to call to print the operand. 31 isMachineInstrOperand, 32 // Output this text verbatim to the asm writer. It is code that 33 // will output some text to the asm. 34 isLiteralStatementOperand 35 } OperandType; 36 37 /// MiOpNo - For isMachineInstrOperand, this is the operand number of the 38 /// machine instruction. 39 unsigned MIOpNo = 0; 40 41 /// Str - For isLiteralTextOperand, this IS the literal text. For 42 /// isMachineInstrOperand, this is the PrinterMethodName for the operand.. 43 /// For isLiteralStatementOperand, this is the code to insert verbatim 44 /// into the asm writer. 45 std::string Str; 46 47 /// MiModifier - For isMachineInstrOperand, this is the modifier string for 48 /// an operand, specified with syntax like ${opname:modifier}. 49 std::string MiModifier; 50 51 bool PCRel = false; 52 53 // To make VS STL happy OperandTypeAsmWriterOperand54 AsmWriterOperand(OpType op = isLiteralTextOperand):OperandType(op) {} 55 56 AsmWriterOperand(const std::string &LitStr, 57 OpType op = isLiteralTextOperand) OperandTypeAsmWriterOperand58 : OperandType(op), Str(LitStr) {} 59 60 AsmWriterOperand(const std::string &Printer, unsigned _MIOpNo, 61 const std::string &Modifier, 62 OpType op = isMachineInstrOperand, bool PCRel = false) OperandTypeAsmWriterOperand63 : OperandType(op), MIOpNo(_MIOpNo), Str(Printer), MiModifier(Modifier), 64 PCRel(PCRel) {} 65 66 bool operator!=(const AsmWriterOperand &Other) const { 67 if (OperandType != Other.OperandType || Str != Other.Str) return true; 68 if (OperandType == isMachineInstrOperand) 69 return MIOpNo != Other.MIOpNo || MiModifier != Other.MiModifier; 70 return false; 71 } 72 bool operator==(const AsmWriterOperand &Other) const { 73 return !operator!=(Other); 74 } 75 76 /// getCode - Return the code that prints this operand. 77 std::string getCode(bool PassSubtarget) const; 78 }; 79 80 class AsmWriterInst { 81 public: 82 std::vector<AsmWriterOperand> Operands; 83 const CodeGenInstruction *CGI; 84 unsigned CGIIndex; 85 86 AsmWriterInst(const CodeGenInstruction &CGI, unsigned CGIIndex, 87 unsigned Variant); 88 89 /// MatchesAllButOneOp - If this instruction is exactly identical to the 90 /// specified instruction except for one differing operand, return the 91 /// differing operand number. Otherwise return ~0. 92 unsigned MatchesAllButOneOp(const AsmWriterInst &Other) const; 93 94 private: AddLiteralString(const std::string & Str)95 void AddLiteralString(const std::string &Str) { 96 // If the last operand was already a literal text string, append this to 97 // it, otherwise add a new operand. 98 if (!Operands.empty() && 99 Operands.back().OperandType == AsmWriterOperand::isLiteralTextOperand) 100 Operands.back().Str.append(Str); 101 else 102 Operands.push_back(AsmWriterOperand(Str)); 103 } 104 }; 105 } 106 107 #endif 108