1 //===-- ScopedPrinter.h ---------------------------------------------------===//
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_SUPPORT_SCOPEDPRINTER_H
11 #define LLVM_SUPPORT_SCOPEDPRINTER_H
12 
13 #include "llvm/ADT/APSInt.h"
14 #include "llvm/ADT/ArrayRef.h"
15 #include "llvm/ADT/SmallVector.h"
16 #include "llvm/ADT/StringRef.h"
17 #include "llvm/Support/DataTypes.h"
18 #include "llvm/Support/Endian.h"
19 #include "llvm/Support/raw_ostream.h"
20 #include <algorithm>
21 
22 namespace llvm {
23 
24 template <typename T> struct EnumEntry {
25   StringRef Name;
26   // While Name suffices in most of the cases, in certain cases
27   // GNU style and LLVM style of ELFDumper do not
28   // display same string for same enum. The AltName if initialized appropriately
29   // will hold the string that GNU style emits.
30   // Example:
31   // "EM_X86_64" string on LLVM style for Elf_Ehdr->e_machine corresponds to
32   // "Advanced Micro Devices X86-64" on GNU style
33   StringRef AltName;
34   T Value;
EnumEntryEnumEntry35   EnumEntry(StringRef N, StringRef A, T V) : Name(N), AltName(A), Value(V) {}
EnumEntryEnumEntry36   EnumEntry(StringRef N, T V) : Name(N), AltName(N), Value(V) {}
37 };
38 
39 struct HexNumber {
40   // To avoid sign-extension we have to explicitly cast to the appropriate
41   // unsigned type. The overloads are here so that every type that is implicitly
42   // convertible to an integer (including enums and endian helpers) can be used
43   // without requiring type traits or call-site changes.
HexNumberHexNumber44   HexNumber(char Value) : Value(static_cast<unsigned char>(Value)) {}
HexNumberHexNumber45   HexNumber(signed char Value) : Value(static_cast<unsigned char>(Value)) {}
HexNumberHexNumber46   HexNumber(signed short Value) : Value(static_cast<unsigned short>(Value)) {}
HexNumberHexNumber47   HexNumber(signed int Value) : Value(static_cast<unsigned int>(Value)) {}
HexNumberHexNumber48   HexNumber(signed long Value) : Value(static_cast<unsigned long>(Value)) {}
HexNumberHexNumber49   HexNumber(signed long long Value)
50       : Value(static_cast<unsigned long long>(Value)) {}
HexNumberHexNumber51   HexNumber(unsigned char Value) : Value(Value) {}
HexNumberHexNumber52   HexNumber(unsigned short Value) : Value(Value) {}
HexNumberHexNumber53   HexNumber(unsigned int Value) : Value(Value) {}
HexNumberHexNumber54   HexNumber(unsigned long Value) : Value(Value) {}
HexNumberHexNumber55   HexNumber(unsigned long long Value) : Value(Value) {}
56   uint64_t Value;
57 };
58 
59 raw_ostream &operator<<(raw_ostream &OS, const HexNumber &Value);
60 const std::string to_hexString(uint64_t Value, bool UpperCase = true);
61 
to_string(const T & Value)62 template <class T> const std::string to_string(const T &Value) {
63   std::string number;
64   llvm::raw_string_ostream stream(number);
65   stream << Value;
66   return stream.str();
67 }
68 
69 class ScopedPrinter {
70 public:
ScopedPrinter(raw_ostream & OS)71   ScopedPrinter(raw_ostream &OS) : OS(OS), IndentLevel(0) {}
72 
flush()73   void flush() { OS.flush(); }
74 
75   void indent(int Levels = 1) { IndentLevel += Levels; }
76 
77   void unindent(int Levels = 1) {
78     IndentLevel = std::max(0, IndentLevel - Levels);
79   }
80 
resetIndent()81   void resetIndent() { IndentLevel = 0; }
82 
setPrefix(StringRef P)83   void setPrefix(StringRef P) { Prefix = P; }
84 
printIndent()85   void printIndent() {
86     OS << Prefix;
87     for (int i = 0; i < IndentLevel; ++i)
88       OS << "  ";
89   }
90 
hex(T Value)91   template <typename T> HexNumber hex(T Value) { return HexNumber(Value); }
92 
93   template <typename T, typename TEnum>
printEnum(StringRef Label,T Value,ArrayRef<EnumEntry<TEnum>> EnumValues)94   void printEnum(StringRef Label, T Value,
95                  ArrayRef<EnumEntry<TEnum>> EnumValues) {
96     StringRef Name;
97     bool Found = false;
98     for (const auto &EnumItem : EnumValues) {
99       if (EnumItem.Value == Value) {
100         Name = EnumItem.Name;
101         Found = true;
102         break;
103       }
104     }
105 
106     if (Found) {
107       startLine() << Label << ": " << Name << " (" << hex(Value) << ")\n";
108     } else {
109       startLine() << Label << ": " << hex(Value) << "\n";
110     }
111   }
112 
113   template <typename T, typename TFlag>
114   void printFlags(StringRef Label, T Value, ArrayRef<EnumEntry<TFlag>> Flags,
115                   TFlag EnumMask1 = {}, TFlag EnumMask2 = {},
116                   TFlag EnumMask3 = {}) {
117     typedef EnumEntry<TFlag> FlagEntry;
118     typedef SmallVector<FlagEntry, 10> FlagVector;
119     FlagVector SetFlags;
120 
121     for (const auto &Flag : Flags) {
122       if (Flag.Value == 0)
123         continue;
124 
125       TFlag EnumMask{};
126       if (Flag.Value & EnumMask1)
127         EnumMask = EnumMask1;
128       else if (Flag.Value & EnumMask2)
129         EnumMask = EnumMask2;
130       else if (Flag.Value & EnumMask3)
131         EnumMask = EnumMask3;
132       bool IsEnum = (Flag.Value & EnumMask) != 0;
133       if ((!IsEnum && (Value & Flag.Value) == Flag.Value) ||
134           (IsEnum && (Value & EnumMask) == Flag.Value)) {
135         SetFlags.push_back(Flag);
136       }
137     }
138 
139     std::sort(SetFlags.begin(), SetFlags.end(), &flagName<TFlag>);
140 
141     startLine() << Label << " [ (" << hex(Value) << ")\n";
142     for (const auto &Flag : SetFlags) {
143       startLine() << "  " << Flag.Name << " (" << hex(Flag.Value) << ")\n";
144     }
145     startLine() << "]\n";
146   }
147 
printFlags(StringRef Label,T Value)148   template <typename T> void printFlags(StringRef Label, T Value) {
149     startLine() << Label << " [ (" << hex(Value) << ")\n";
150     uint64_t Flag = 1;
151     uint64_t Curr = Value;
152     while (Curr > 0) {
153       if (Curr & 1)
154         startLine() << "  " << hex(Flag) << "\n";
155       Curr >>= 1;
156       Flag <<= 1;
157     }
158     startLine() << "]\n";
159   }
160 
printNumber(StringRef Label,uint64_t Value)161   void printNumber(StringRef Label, uint64_t Value) {
162     startLine() << Label << ": " << Value << "\n";
163   }
164 
printNumber(StringRef Label,uint32_t Value)165   void printNumber(StringRef Label, uint32_t Value) {
166     startLine() << Label << ": " << Value << "\n";
167   }
168 
printNumber(StringRef Label,uint16_t Value)169   void printNumber(StringRef Label, uint16_t Value) {
170     startLine() << Label << ": " << Value << "\n";
171   }
172 
printNumber(StringRef Label,uint8_t Value)173   void printNumber(StringRef Label, uint8_t Value) {
174     startLine() << Label << ": " << unsigned(Value) << "\n";
175   }
176 
printNumber(StringRef Label,int64_t Value)177   void printNumber(StringRef Label, int64_t Value) {
178     startLine() << Label << ": " << Value << "\n";
179   }
180 
printNumber(StringRef Label,int32_t Value)181   void printNumber(StringRef Label, int32_t Value) {
182     startLine() << Label << ": " << Value << "\n";
183   }
184 
printNumber(StringRef Label,int16_t Value)185   void printNumber(StringRef Label, int16_t Value) {
186     startLine() << Label << ": " << Value << "\n";
187   }
188 
printNumber(StringRef Label,int8_t Value)189   void printNumber(StringRef Label, int8_t Value) {
190     startLine() << Label << ": " << int(Value) << "\n";
191   }
192 
printNumber(StringRef Label,const APSInt & Value)193   void printNumber(StringRef Label, const APSInt &Value) {
194     startLine() << Label << ": " << Value << "\n";
195   }
196 
printBoolean(StringRef Label,bool Value)197   void printBoolean(StringRef Label, bool Value) {
198     startLine() << Label << ": " << (Value ? "Yes" : "No") << '\n';
199   }
200 
printVersion(StringRef Label,T...Version)201   template <typename... T> void printVersion(StringRef Label, T... Version) {
202     startLine() << Label << ": ";
203     printVersionInternal(Version...);
204     getOStream() << "\n";
205   }
206 
printList(StringRef Label,const T & List)207   template <typename T> void printList(StringRef Label, const T &List) {
208     startLine() << Label << ": [";
209     bool Comma = false;
210     for (const auto &Item : List) {
211       if (Comma)
212         OS << ", ";
213       OS << Item;
214       Comma = true;
215     }
216     OS << "]\n";
217   }
218 
219   template <typename T, typename U>
printList(StringRef Label,const T & List,const U & Printer)220   void printList(StringRef Label, const T &List, const U &Printer) {
221     startLine() << Label << ": [";
222     bool Comma = false;
223     for (const auto &Item : List) {
224       if (Comma)
225         OS << ", ";
226       Printer(OS, Item);
227       Comma = true;
228     }
229     OS << "]\n";
230   }
231 
printHexList(StringRef Label,const T & List)232   template <typename T> void printHexList(StringRef Label, const T &List) {
233     startLine() << Label << ": [";
234     bool Comma = false;
235     for (const auto &Item : List) {
236       if (Comma)
237         OS << ", ";
238       OS << hex(Item);
239       Comma = true;
240     }
241     OS << "]\n";
242   }
243 
printHex(StringRef Label,T Value)244   template <typename T> void printHex(StringRef Label, T Value) {
245     startLine() << Label << ": " << hex(Value) << "\n";
246   }
247 
printHex(StringRef Label,StringRef Str,T Value)248   template <typename T> void printHex(StringRef Label, StringRef Str, T Value) {
249     startLine() << Label << ": " << Str << " (" << hex(Value) << ")\n";
250   }
251 
252   template <typename T>
printSymbolOffset(StringRef Label,StringRef Symbol,T Value)253   void printSymbolOffset(StringRef Label, StringRef Symbol, T Value) {
254     startLine() << Label << ": " << Symbol << '+' << hex(Value) << '\n';
255   }
256 
printString(StringRef Value)257   void printString(StringRef Value) { startLine() << Value << "\n"; }
258 
printString(StringRef Label,StringRef Value)259   void printString(StringRef Label, StringRef Value) {
260     startLine() << Label << ": " << Value << "\n";
261   }
262 
printString(StringRef Label,const std::string & Value)263   void printString(StringRef Label, const std::string &Value) {
264     startLine() << Label << ": " << Value << "\n";
265   }
266 
267   template <typename T>
printNumber(StringRef Label,StringRef Str,T Value)268   void printNumber(StringRef Label, StringRef Str, T Value) {
269     startLine() << Label << ": " << Str << " (" << Value << ")\n";
270   }
271 
printBinary(StringRef Label,StringRef Str,ArrayRef<uint8_t> Value)272   void printBinary(StringRef Label, StringRef Str, ArrayRef<uint8_t> Value) {
273     printBinaryImpl(Label, Str, Value, false);
274   }
275 
printBinary(StringRef Label,StringRef Str,ArrayRef<char> Value)276   void printBinary(StringRef Label, StringRef Str, ArrayRef<char> Value) {
277     auto V = makeArrayRef(reinterpret_cast<const uint8_t *>(Value.data()),
278                           Value.size());
279     printBinaryImpl(Label, Str, V, false);
280   }
281 
printBinary(StringRef Label,ArrayRef<uint8_t> Value)282   void printBinary(StringRef Label, ArrayRef<uint8_t> Value) {
283     printBinaryImpl(Label, StringRef(), Value, false);
284   }
285 
printBinary(StringRef Label,ArrayRef<char> Value)286   void printBinary(StringRef Label, ArrayRef<char> Value) {
287     auto V = makeArrayRef(reinterpret_cast<const uint8_t *>(Value.data()),
288                           Value.size());
289     printBinaryImpl(Label, StringRef(), V, false);
290   }
291 
printBinary(StringRef Label,StringRef Value)292   void printBinary(StringRef Label, StringRef Value) {
293     auto V = makeArrayRef(reinterpret_cast<const uint8_t *>(Value.data()),
294                           Value.size());
295     printBinaryImpl(Label, StringRef(), V, false);
296   }
297 
printBinaryBlock(StringRef Label,ArrayRef<uint8_t> Value)298   void printBinaryBlock(StringRef Label, ArrayRef<uint8_t> Value) {
299     printBinaryImpl(Label, StringRef(), Value, true);
300   }
301 
printBinaryBlock(StringRef Label,StringRef Value)302   void printBinaryBlock(StringRef Label, StringRef Value) {
303     auto V = makeArrayRef(reinterpret_cast<const uint8_t *>(Value.data()),
304                           Value.size());
305     printBinaryImpl(Label, StringRef(), V, true);
306   }
307 
printObject(StringRef Label,const T & Value)308   template <typename T> void printObject(StringRef Label, const T &Value) {
309     startLine() << Label << ": " << Value << "\n";
310   }
311 
startLine()312   raw_ostream &startLine() {
313     printIndent();
314     return OS;
315   }
316 
getOStream()317   raw_ostream &getOStream() { return OS; }
318 
319 private:
printVersionInternal(T Value)320   template <typename T> void printVersionInternal(T Value) {
321     getOStream() << Value;
322   }
323 
324   template <typename S, typename T, typename... TArgs>
printVersionInternal(S Value,T Value2,TArgs...Args)325   void printVersionInternal(S Value, T Value2, TArgs... Args) {
326     getOStream() << Value << ".";
327     printVersionInternal(Value2, Args...);
328   }
329 
330   template <typename T>
flagName(const EnumEntry<T> & lhs,const EnumEntry<T> & rhs)331   static bool flagName(const EnumEntry<T> &lhs, const EnumEntry<T> &rhs) {
332     return lhs.Name < rhs.Name;
333   }
334 
335   void printBinaryImpl(StringRef Label, StringRef Str, ArrayRef<uint8_t> Value,
336                        bool Block);
337 
338   raw_ostream &OS;
339   int IndentLevel;
340   StringRef Prefix;
341 };
342 
343 template <>
344 inline void
345 ScopedPrinter::printHex<support::ulittle16_t>(StringRef Label,
346                                               support::ulittle16_t Value) {
347   startLine() << Label << ": " << hex(Value) << "\n";
348 }
349 
350 template<char Open, char Close>
351 struct DelimitedScope {
DelimitedScopeDelimitedScope352   explicit DelimitedScope(ScopedPrinter &W) : W(W) {
353     W.startLine() << Open << '\n';
354     W.indent();
355   }
356 
DelimitedScopeDelimitedScope357   DelimitedScope(ScopedPrinter &W, StringRef N) : W(W) {
358     W.startLine() << N;
359     if (!N.empty())
360       W.getOStream() << ' ';
361     W.getOStream() << Open << '\n';
362     W.indent();
363   }
364 
~DelimitedScopeDelimitedScope365   ~DelimitedScope() {
366     W.unindent();
367     W.startLine() << Close << '\n';
368   }
369 
370   ScopedPrinter &W;
371 };
372 
373 using DictScope = DelimitedScope<'{', '}'>;
374 using ListScope = DelimitedScope<'[', ']'>;
375 
376 } // namespace llvm
377 
378 #endif
379