clang  3.7.0
TextDiagnostic.h
Go to the documentation of this file.
1 //===--- TextDiagnostic.h - Text Diagnostic Pretty-Printing -----*- 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 // This is a utility class that provides support for textual pretty-printing of
11 // diagnostics. It is used to implement the different code paths which require
12 // such functionality in a consistent way.
13 //
14 //===----------------------------------------------------------------------===//
15 
16 #ifndef LLVM_CLANG_FRONTEND_TEXTDIAGNOSTIC_H
17 #define LLVM_CLANG_FRONTEND_TEXTDIAGNOSTIC_H
18 
20 
21 namespace clang {
22 
23 /// \brief Class to encapsulate the logic for formatting and printing a textual
24 /// diagnostic message.
25 ///
26 /// This class provides an interface for building and emitting a textual
27 /// diagnostic, including all of the macro backtraces, caret diagnostics, FixIt
28 /// Hints, and code snippets. In the presence of macros this involves
29 /// a recursive process, synthesizing notes for each macro expansion.
30 ///
31 /// The purpose of this class is to isolate the implementation of printing
32 /// beautiful text diagnostics from any particular interfaces. The Clang
33 /// DiagnosticClient is implemented through this class as is diagnostic
34 /// printing coming out of libclang.
36  raw_ostream &OS;
37 
38 public:
39  TextDiagnostic(raw_ostream &OS,
40  const LangOptions &LangOpts,
42 
43  ~TextDiagnostic() override;
44 
45  /// \brief Print the diagonstic level to a raw_ostream.
46  ///
47  /// This is a static helper that handles colorizing the level and formatting
48  /// it into an arbitrary output stream. This is used internally by the
49  /// TextDiagnostic emission code, but it can also be used directly by
50  /// consumers that don't have a source manager or other state that the full
51  /// TextDiagnostic logic requires.
52  static void printDiagnosticLevel(raw_ostream &OS,
54  bool ShowColors,
55  bool CLFallbackMode = false);
56 
57  /// \brief Pretty-print a diagnostic message to a raw_ostream.
58  ///
59  /// This is a static helper to handle the line wrapping, colorizing, and
60  /// rendering of a diagnostic message to a particular ostream. It is
61  /// publicly visible so that clients which do not have sufficient state to
62  /// build a complete TextDiagnostic object can still get consistent
63  /// formatting of their diagnostic messages.
64  ///
65  /// \param OS Where the message is printed
66  /// \param IsSupplemental true if this is a continuation note diagnostic
67  /// \param Message The text actually printed
68  /// \param CurrentColumn The starting column of the first line, accounting
69  /// for any prefix.
70  /// \param Columns The number of columns to use in line-wrapping, 0 disables
71  /// all line-wrapping.
72  /// \param ShowColors Enable colorizing of the message.
73  static void printDiagnosticMessage(raw_ostream &OS, bool IsSupplemental,
74  StringRef Message, unsigned CurrentColumn,
75  unsigned Columns, bool ShowColors);
76 
77 protected:
80  StringRef Message,
82  const SourceManager *SM,
83  DiagOrStoredDiag D) override;
84 
88  const SourceManager &SM) override;
89 
93  ArrayRef<FixItHint> Hints,
94  const SourceManager &SM) override {
95  emitSnippetAndCaret(Loc, Level, Ranges, Hints, SM);
96  }
97 
99  const SourceManager &SM) override;
100 
102  StringRef ModuleName,
103  const SourceManager &SM) override;
104 
106  StringRef ModuleName,
107  const SourceManager &SM) override;
108 
109 private:
110  void emitSnippetAndCaret(SourceLocation Loc, DiagnosticsEngine::Level Level,
112  ArrayRef<FixItHint> Hints,
113  const SourceManager &SM);
114 
115  void emitSnippet(StringRef SourceLine);
116 
117  void emitParseableFixits(ArrayRef<FixItHint> Hints, const SourceManager &SM);
118 };
119 
120 } // end namespace clang
121 
122 #endif
void emitCodeContext(SourceLocation Loc, DiagnosticsEngine::Level Level, SmallVectorImpl< CharSourceRange > &Ranges, ArrayRef< FixItHint > Hints, const SourceManager &SM) override
void emitDiagnosticLoc(SourceLocation Loc, PresumedLoc PLoc, DiagnosticsEngine::Level Level, ArrayRef< CharSourceRange > Ranges, const SourceManager &SM) override
Print out the file/line/column information and include trace.
const LangOptions & LangOpts
void emitImportLocation(SourceLocation Loc, PresumedLoc PLoc, StringRef ModuleName, const SourceManager &SM) override
Class to encapsulate the logic for formatting and printing a textual diagnostic message.
Keeps track of the various options that can be enabled, which controls the dialect of C or C++ that i...
Definition: LangOptions.h:48
Class to encapsulate the logic for formatting a diagnostic message.
SmallVector< CharSourceRange, 8 > Ranges
Definition: Format.cpp:1554
TextDiagnostic(raw_ostream &OS, const LangOptions &LangOpts, DiagnosticOptions *DiagOpts)
SourceManager & SM
IntrusiveRefCntPtr< DiagnosticOptions > DiagOpts
Represents an unpacked "presumed" location which can be presented to the user.
void emitDiagnosticMessage(SourceLocation Loc, PresumedLoc PLoc, DiagnosticsEngine::Level Level, StringRef Message, ArrayRef< CharSourceRange > Ranges, const SourceManager *SM, DiagOrStoredDiag D) override
llvm::PointerUnion< const Diagnostic *, const StoredDiagnostic * > DiagOrStoredDiag
Encodes a location in the source. The SourceManager can decode this to get at the full include stack...
Options for controlling the compiler diagnostics engine.
static void printDiagnosticLevel(raw_ostream &OS, DiagnosticsEngine::Level Level, bool ShowColors, bool CLFallbackMode=false)
Print the diagonstic level to a raw_ostream.
static void printDiagnosticMessage(raw_ostream &OS, bool IsSupplemental, StringRef Message, unsigned CurrentColumn, unsigned Columns, bool ShowColors)
Pretty-print a diagnostic message to a raw_ostream.
void emitIncludeLocation(SourceLocation Loc, PresumedLoc PLoc, const SourceManager &SM) override
void emitBuildingModuleLocation(SourceLocation Loc, PresumedLoc PLoc, StringRef ModuleName, const SourceManager &SM) override
Level
The level of the diagnostic, after it has been through mapping.
Definition: Diagnostic.h:141
This class handles loading and caching of source files into memory.