1 //===- MCInstPrinter.h - MCInst to target assembly syntax -------*- 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 #ifndef LLVM_MC_MCINSTPRINTER_H
11 #define LLVM_MC_MCINSTPRINTER_H
13 #include "llvm/Support/DataTypes.h"
14 #include "llvm/Support/Format.h"
22 class MCSubtargetInfo;
32 /// MCInstPrinter - This is an instance of a target assembly language printer
33 /// that converts an MCInst to valid target assembly syntax.
36 /// CommentStream - a stream that comments can be emitted to if desired.
37 /// Each comment must end with a newline. This will be null if verbose
38 /// assembly emission is disable.
39 raw_ostream *CommentStream;
41 const MCInstrInfo &MII;
42 const MCRegisterInfo &MRI;
44 /// True if we are printing marked up assembly.
47 /// True if we are printing immediates as hex.
50 /// Which style to use for printing hexadecimal values.
51 HexStyle::Style PrintHexStyle;
53 /// Utility function for printing annotations.
54 void printAnnotation(raw_ostream &OS, StringRef Annot);
56 MCInstPrinter(const MCAsmInfo &mai, const MCInstrInfo &mii,
57 const MCRegisterInfo &mri)
58 : CommentStream(nullptr), MAI(mai), MII(mii), MRI(mri),
59 UseMarkup(0), PrintImmHex(0),
60 PrintHexStyle(HexStyle::C) {}
62 virtual ~MCInstPrinter();
64 /// setCommentStream - Specify a stream to emit comments to.
65 void setCommentStream(raw_ostream &OS) { CommentStream = &OS; }
67 /// printInst - Print the specified MCInst to the specified raw_ostream.
69 virtual void printInst(const MCInst *MI, raw_ostream &OS,
70 StringRef Annot, const MCSubtargetInfo &STI) = 0;
72 /// getOpcodeName - Return the name of the specified opcode enum (e.g.
73 /// "MOV32ri") or empty if we can't resolve it.
74 StringRef getOpcodeName(unsigned Opcode) const;
76 /// printRegName - Print the assembler register name.
77 virtual void printRegName(raw_ostream &OS, unsigned RegNo) const;
79 bool getUseMarkup() const { return UseMarkup; }
80 void setUseMarkup(bool Value) { UseMarkup = Value; }
82 /// Utility functions to make adding mark ups simpler.
83 StringRef markup(StringRef s) const;
84 StringRef markup(StringRef a, StringRef b) const;
86 bool getPrintImmHex() const { return PrintImmHex; }
87 void setPrintImmHex(bool Value) { PrintImmHex = Value; }
89 HexStyle::Style getPrintHexStyleHex() const { return PrintHexStyle; }
90 void setPrintImmHex(HexStyle::Style Value) { PrintHexStyle = Value; }
92 /// Utility function to print immediates in decimal or hex.
93 format_object<int64_t> formatImm(int64_t Value) const {
94 return PrintImmHex ? formatHex(Value) : formatDec(Value);
97 /// Utility functions to print decimal/hexadecimal values.
98 format_object<int64_t> formatDec(int64_t Value) const;
99 format_object<int64_t> formatHex(int64_t Value) const;
100 format_object<uint64_t> formatHex(uint64_t Value) const;