include/llvm/MC/MCInstPrinter.h

   1 //===- MCInstPrinter.h - MCInst to target assembly syntax -------*- C++ -*-===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file is distributed under the University of Illinois Open Source
   6 // License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9
  10 #ifndef LLVM_MC_MCINSTPRINTER_H
  11 #define LLVM_MC_MCINSTPRINTER_H
  12
  13 #include "llvm/Support/DataTypes.h"
  14 #include "llvm/Support/Format.h"
  15
  16 namespace llvm {
  17 class MCInst;
  18 class raw_ostream;
  19 class MCAsmInfo;
  20 class MCInstrInfo;
  21 class MCRegisterInfo;
  22 class MCSubtargetInfo;
  23 class StringRef;
  24
  25 namespace HexStyle {
  26     enum Style {
  27         C,          ///< 0xff
  28         Asm         ///< 0ffh
  29     };
  30 }
  31
  32 /// MCInstPrinter - This is an instance of a target assembly language printer
  33 /// that converts an MCInst to valid target assembly syntax.
  34 class MCInstPrinter {
  35 protected:
  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;
  40   const MCAsmInfo &MAI;
  41   const MCInstrInfo &MII;
  42   const MCRegisterInfo &MRI;
  43
  44   /// The current set of available features.
  45   uint64_t AvailableFeatures;
  46
  47   /// True if we are printing marked up assembly.
  48   bool UseMarkup;
  49
  50   /// True if we are printing immediates as hex.
  51   bool PrintImmHex;
  52
  53   /// Which style to use for printing hexadecimal values.
  54   HexStyle::Style PrintHexStyle;
  55
  56   /// Utility function for printing annotations.
  57   void printAnnotation(raw_ostream &OS, StringRef Annot);
  58 public:
  59   MCInstPrinter(const MCAsmInfo &mai, const MCInstrInfo &mii,
  60                 const MCRegisterInfo &mri)
  61     : CommentStream(nullptr), MAI(mai), MII(mii), MRI(mri),
  62       AvailableFeatures(0), UseMarkup(0), PrintImmHex(0),
  63       PrintHexStyle(HexStyle::C) {}
  64
  65   virtual ~MCInstPrinter();
  66
  67   /// setCommentStream - Specify a stream to emit comments to.
  68   void setCommentStream(raw_ostream &OS) { CommentStream = &OS; }
  69
  70   /// printInst - Print the specified MCInst to the specified raw_ostream.
  71   ///
  72   virtual void printInst(const MCInst *MI, raw_ostream &OS,
  73                          StringRef Annot, const MCSubtargetInfo &STI) = 0;
  74
  75   /// getOpcodeName - Return the name of the specified opcode enum (e.g.
  76   /// "MOV32ri") or empty if we can't resolve it.
  77   StringRef getOpcodeName(unsigned Opcode) const;
  78
  79   /// printRegName - Print the assembler register name.
  80   virtual void printRegName(raw_ostream &OS, unsigned RegNo) const;
  81
  82   uint64_t getAvailableFeatures() const { return AvailableFeatures; }
  83   void setAvailableFeatures(uint64_t Value) { AvailableFeatures = Value; }
  84
  85   bool getUseMarkup() const { return UseMarkup; }
  86   void setUseMarkup(bool Value) { UseMarkup = Value; }
  87
  88   /// Utility functions to make adding mark ups simpler.
  89   StringRef markup(StringRef s) const;
  90   StringRef markup(StringRef a, StringRef b) const;
  91
  92   bool getPrintImmHex() const { return PrintImmHex; }
  93   void setPrintImmHex(bool Value) { PrintImmHex = Value; }
  94
  95   HexStyle::Style getPrintHexStyleHex() const { return PrintHexStyle; }
  96   void setPrintImmHex(HexStyle::Style Value) { PrintHexStyle = Value; }
  97
  98   /// Utility function to print immediates in decimal or hex.
  99   format_object<int64_t> formatImm(int64_t Value) const {
 100     return PrintImmHex ? formatHex(Value) : formatDec(Value);
 101   }
 102
 103   /// Utility functions to print decimal/hexadecimal values.
 104   format_object<int64_t> formatDec(int64_t Value) const;
 105   format_object<int64_t> formatHex(int64_t Value) const;
 106   format_object<uint64_t> formatHex(uint64_t Value) const;
 107 };
 108
 109 } // namespace llvm
 110
 111 #endif