TextDiagnosticPrinter.cpp revision eace8743030d2979251a0c5ae247371cfd9056e5
1//===--- TextDiagnosticPrinter.cpp - Diagnostic Printer -------------------===//
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 diagnostic client prints out their diagnostic messages.
11//
12//===----------------------------------------------------------------------===//
13
14#include "clang/Frontend/TextDiagnosticPrinter.h"
15#include "clang/Basic/SourceManager.h"
16#include "clang/Frontend/DiagnosticOptions.h"
17#include "clang/Lex/Lexer.h"
18#include "llvm/Support/MemoryBuffer.h"
19#include "llvm/Support/raw_ostream.h"
20#include "llvm/ADT/SmallString.h"
21#include <algorithm>
22using namespace clang;
23
24static const enum llvm::raw_ostream::Colors noteColor =
25  llvm::raw_ostream::BLACK;
26static const enum llvm::raw_ostream::Colors fixitColor =
27  llvm::raw_ostream::GREEN;
28static const enum llvm::raw_ostream::Colors caretColor =
29  llvm::raw_ostream::GREEN;
30static const enum llvm::raw_ostream::Colors warningColor =
31  llvm::raw_ostream::MAGENTA;
32static const enum llvm::raw_ostream::Colors errorColor = llvm::raw_ostream::RED;
33static const enum llvm::raw_ostream::Colors fatalColor = llvm::raw_ostream::RED;
34// used for changing only the bold attribute
35static const enum llvm::raw_ostream::Colors savedColor =
36  llvm::raw_ostream::SAVEDCOLOR;
37
38/// \brief Number of spaces to indent when word-wrapping.
39const unsigned WordWrapIndentation = 6;
40
41TextDiagnosticPrinter::TextDiagnosticPrinter(llvm::raw_ostream &os,
42                                             const DiagnosticOptions &diags)
43  : OS(os), LangOpts(0), DiagOpts(&diags),
44    LastCaretDiagnosticWasNote(false) {
45}
46
47void TextDiagnosticPrinter::
48PrintIncludeStack(SourceLocation Loc, const SourceManager &SM) {
49  if (Loc.isInvalid()) return;
50
51  PresumedLoc PLoc = SM.getPresumedLoc(Loc);
52
53  // Print out the other include frames first.
54  PrintIncludeStack(PLoc.getIncludeLoc(), SM);
55
56  if (DiagOpts->ShowLocation)
57    OS << "In file included from " << PLoc.getFilename()
58       << ':' << PLoc.getLine() << ":\n";
59  else
60    OS << "In included file:\n";
61}
62
63/// HighlightRange - Given a SourceRange and a line number, highlight (with ~'s)
64/// any characters in LineNo that intersect the SourceRange.
65void TextDiagnosticPrinter::HighlightRange(const SourceRange &R,
66                                           const SourceManager &SM,
67                                           unsigned LineNo, FileID FID,
68                                           std::string &CaretLine,
69                                           const std::string &SourceLine) {
70  assert(CaretLine.size() == SourceLine.size() &&
71         "Expect a correspondence between source and caret line!");
72  if (!R.isValid()) return;
73
74  SourceLocation Begin = SM.getInstantiationLoc(R.getBegin());
75  SourceLocation End = SM.getInstantiationLoc(R.getEnd());
76
77  // If the End location and the start location are the same and are a macro
78  // location, then the range was something that came from a macro expansion
79  // or _Pragma.  If this is an object-like macro, the best we can do is to
80  // highlight the range.  If this is a function-like macro, we'd also like to
81  // highlight the arguments.
82  if (Begin == End && R.getEnd().isMacroID())
83    End = SM.getInstantiationRange(R.getEnd()).second;
84
85  unsigned StartLineNo = SM.getInstantiationLineNumber(Begin);
86  if (StartLineNo > LineNo || SM.getFileID(Begin) != FID)
87    return;  // No intersection.
88
89  unsigned EndLineNo = SM.getInstantiationLineNumber(End);
90  if (EndLineNo < LineNo || SM.getFileID(End) != FID)
91    return;  // No intersection.
92
93  // Compute the column number of the start.
94  unsigned StartColNo = 0;
95  if (StartLineNo == LineNo) {
96    StartColNo = SM.getInstantiationColumnNumber(Begin);
97    if (StartColNo) --StartColNo;  // Zero base the col #.
98  }
99
100  // Pick the first non-whitespace column.
101  while (StartColNo < SourceLine.size() &&
102         (SourceLine[StartColNo] == ' ' || SourceLine[StartColNo] == '\t'))
103    ++StartColNo;
104
105  // Compute the column number of the end.
106  unsigned EndColNo = CaretLine.size();
107  if (EndLineNo == LineNo) {
108    EndColNo = SM.getInstantiationColumnNumber(End);
109    if (EndColNo) {
110      --EndColNo;  // Zero base the col #.
111
112      // Add in the length of the token, so that we cover multi-char tokens.
113      EndColNo += Lexer::MeasureTokenLength(End, SM, *LangOpts);
114    } else {
115      EndColNo = CaretLine.size();
116    }
117  }
118
119  // Pick the last non-whitespace column.
120  if (EndColNo <= SourceLine.size())
121    while (EndColNo-1 &&
122           (SourceLine[EndColNo-1] == ' ' || SourceLine[EndColNo-1] == '\t'))
123      --EndColNo;
124  else
125    EndColNo = SourceLine.size();
126
127  // Fill the range with ~'s.
128  assert(StartColNo <= EndColNo && "Invalid range!");
129  for (unsigned i = StartColNo; i < EndColNo; ++i)
130    CaretLine[i] = '~';
131}
132
133/// \brief When the source code line we want to print is too long for
134/// the terminal, select the "interesting" region.
135static void SelectInterestingSourceRegion(std::string &SourceLine,
136                                          std::string &CaretLine,
137                                          std::string &FixItInsertionLine,
138                                          unsigned EndOfCaretToken,
139                                          unsigned Columns) {
140  if (CaretLine.size() > SourceLine.size())
141    SourceLine.resize(CaretLine.size(), ' ');
142
143  // Find the slice that we need to display the full caret line
144  // correctly.
145  unsigned CaretStart = 0, CaretEnd = CaretLine.size();
146  for (; CaretStart != CaretEnd; ++CaretStart)
147    if (!isspace(CaretLine[CaretStart]))
148      break;
149
150  for (; CaretEnd != CaretStart; --CaretEnd)
151    if (!isspace(CaretLine[CaretEnd - 1]))
152      break;
153
154  // Make sure we don't chop the string shorter than the caret token
155  // itself.
156  if (CaretEnd < EndOfCaretToken)
157    CaretEnd = EndOfCaretToken;
158
159  // If we have a fix-it line, make sure the slice includes all of the
160  // fix-it information.
161  if (!FixItInsertionLine.empty()) {
162    unsigned FixItStart = 0, FixItEnd = FixItInsertionLine.size();
163    for (; FixItStart != FixItEnd; ++FixItStart)
164      if (!isspace(FixItInsertionLine[FixItStart]))
165        break;
166
167    for (; FixItEnd != FixItStart; --FixItEnd)
168      if (!isspace(FixItInsertionLine[FixItEnd - 1]))
169        break;
170
171    if (FixItStart < CaretStart)
172      CaretStart = FixItStart;
173    if (FixItEnd > CaretEnd)
174      CaretEnd = FixItEnd;
175  }
176
177  // CaretLine[CaretStart, CaretEnd) contains all of the interesting
178  // parts of the caret line. While this slice is smaller than the
179  // number of columns we have, try to grow the slice to encompass
180  // more context.
181
182  // If the end of the interesting region comes before we run out of
183  // space in the terminal, start at the beginning of the line.
184  if (Columns > 3 && CaretEnd < Columns - 3)
185    CaretStart = 0;
186
187  unsigned TargetColumns = Columns;
188  if (TargetColumns > 8)
189    TargetColumns -= 8; // Give us extra room for the ellipses.
190  unsigned SourceLength = SourceLine.size();
191  while ((CaretEnd - CaretStart) < TargetColumns) {
192    bool ExpandedRegion = false;
193    // Move the start of the interesting region left until we've
194    // pulled in something else interesting.
195    if (CaretStart == 1)
196      CaretStart = 0;
197    else if (CaretStart > 1) {
198      unsigned NewStart = CaretStart - 1;
199
200      // Skip over any whitespace we see here; we're looking for
201      // another bit of interesting text.
202      while (NewStart && isspace(SourceLine[NewStart]))
203        --NewStart;
204
205      // Skip over this bit of "interesting" text.
206      while (NewStart && !isspace(SourceLine[NewStart]))
207        --NewStart;
208
209      // Move up to the non-whitespace character we just saw.
210      if (NewStart)
211        ++NewStart;
212
213      // If we're still within our limit, update the starting
214      // position within the source/caret line.
215      if (CaretEnd - NewStart <= TargetColumns) {
216        CaretStart = NewStart;
217        ExpandedRegion = true;
218      }
219    }
220
221    // Move the end of the interesting region right until we've
222    // pulled in something else interesting.
223    if (CaretEnd != SourceLength) {
224      assert(CaretEnd < SourceLength && "Unexpected caret position!");
225      unsigned NewEnd = CaretEnd;
226
227      // Skip over any whitespace we see here; we're looking for
228      // another bit of interesting text.
229      while (NewEnd != SourceLength && isspace(SourceLine[NewEnd - 1]))
230        ++NewEnd;
231
232      // Skip over this bit of "interesting" text.
233      while (NewEnd != SourceLength && !isspace(SourceLine[NewEnd - 1]))
234        ++NewEnd;
235
236      if (NewEnd - CaretStart <= TargetColumns) {
237        CaretEnd = NewEnd;
238        ExpandedRegion = true;
239      }
240    }
241
242    if (!ExpandedRegion)
243      break;
244  }
245
246  // [CaretStart, CaretEnd) is the slice we want. Update the various
247  // output lines to show only this slice, with two-space padding
248  // before the lines so that it looks nicer.
249  if (CaretEnd < SourceLine.size())
250    SourceLine.replace(CaretEnd, std::string::npos, "...");
251  if (CaretEnd < CaretLine.size())
252    CaretLine.erase(CaretEnd, std::string::npos);
253  if (FixItInsertionLine.size() > CaretEnd)
254    FixItInsertionLine.erase(CaretEnd, std::string::npos);
255
256  if (CaretStart > 2) {
257    SourceLine.replace(0, CaretStart, "  ...");
258    CaretLine.replace(0, CaretStart, "     ");
259    if (FixItInsertionLine.size() >= CaretStart)
260      FixItInsertionLine.replace(0, CaretStart, "     ");
261  }
262}
263
264void TextDiagnosticPrinter::EmitCaretDiagnostic(SourceLocation Loc,
265                                                SourceRange *Ranges,
266                                                unsigned NumRanges,
267                                                SourceManager &SM,
268                                          const CodeModificationHint *Hints,
269                                                unsigned NumHints,
270                                                unsigned Columns) {
271  assert(!Loc.isInvalid() && "must have a valid source location here");
272
273  // If this is a macro ID, first emit information about where this was
274  // instantiated (recursively) then emit information about where. the token was
275  // spelled from.
276  if (!Loc.isFileID()) {
277    SourceLocation OneLevelUp = SM.getImmediateInstantiationRange(Loc).first;
278    // FIXME: Map ranges?
279    EmitCaretDiagnostic(OneLevelUp, Ranges, NumRanges, SM, 0, 0, Columns);
280
281    Loc = SM.getImmediateSpellingLoc(Loc);
282
283    // Map the ranges.
284    for (unsigned i = 0; i != NumRanges; ++i) {
285      SourceLocation S = Ranges[i].getBegin(), E = Ranges[i].getEnd();
286      if (S.isMacroID()) S = SM.getImmediateSpellingLoc(S);
287      if (E.isMacroID()) E = SM.getImmediateSpellingLoc(E);
288      Ranges[i] = SourceRange(S, E);
289    }
290
291    if (DiagOpts->ShowLocation) {
292      std::pair<FileID, unsigned> IInfo = SM.getDecomposedInstantiationLoc(Loc);
293
294      // Emit the file/line/column that this expansion came from.
295      OS << SM.getBuffer(IInfo.first)->getBufferIdentifier() << ':'
296         << SM.getLineNumber(IInfo.first, IInfo.second) << ':';
297      if (DiagOpts->ShowColumn)
298        OS << SM.getColumnNumber(IInfo.first, IInfo.second) << ':';
299      OS << ' ';
300    }
301    OS << "note: instantiated from:\n";
302
303    EmitCaretDiagnostic(Loc, Ranges, NumRanges, SM, Hints, NumHints, Columns);
304    return;
305  }
306
307  // Decompose the location into a FID/Offset pair.
308  std::pair<FileID, unsigned> LocInfo = SM.getDecomposedLoc(Loc);
309  FileID FID = LocInfo.first;
310  unsigned FileOffset = LocInfo.second;
311
312  // Get information about the buffer it points into.
313  std::pair<const char*, const char*> BufferInfo = SM.getBufferData(FID);
314  const char *BufStart = BufferInfo.first;
315
316  unsigned ColNo = SM.getColumnNumber(FID, FileOffset);
317  unsigned CaretEndColNo
318    = ColNo + Lexer::MeasureTokenLength(Loc, SM, *LangOpts);
319
320  // Rewind from the current position to the start of the line.
321  const char *TokPtr = BufStart+FileOffset;
322  const char *LineStart = TokPtr-ColNo+1; // Column # is 1-based.
323
324
325  // Compute the line end.  Scan forward from the error position to the end of
326  // the line.
327  const char *LineEnd = TokPtr;
328  while (*LineEnd != '\n' && *LineEnd != '\r' && *LineEnd != '\0')
329    ++LineEnd;
330
331  // FIXME: This shouldn't be necessary, but the CaretEndColNo can extend past
332  // the source line length as currently being computed. See
333  // test/Misc/message-length.c.
334  CaretEndColNo = std::min(CaretEndColNo, unsigned(LineEnd - LineStart));
335
336  // Copy the line of code into an std::string for ease of manipulation.
337  std::string SourceLine(LineStart, LineEnd);
338
339  // Create a line for the caret that is filled with spaces that is the same
340  // length as the line of source code.
341  std::string CaretLine(LineEnd-LineStart, ' ');
342
343  // Highlight all of the characters covered by Ranges with ~ characters.
344  if (NumRanges) {
345    unsigned LineNo = SM.getLineNumber(FID, FileOffset);
346
347    for (unsigned i = 0, e = NumRanges; i != e; ++i)
348      HighlightRange(Ranges[i], SM, LineNo, FID, CaretLine, SourceLine);
349  }
350
351  // Next, insert the caret itself.
352  if (ColNo-1 < CaretLine.size())
353    CaretLine[ColNo-1] = '^';
354  else
355    CaretLine.push_back('^');
356
357  // Scan the source line, looking for tabs.  If we find any, manually expand
358  // them to 8 characters and update the CaretLine to match.
359  for (unsigned i = 0; i != SourceLine.size(); ++i) {
360    if (SourceLine[i] != '\t') continue;
361
362    // Replace this tab with at least one space.
363    SourceLine[i] = ' ';
364
365    // Compute the number of spaces we need to insert.
366    unsigned NumSpaces = ((i+8)&~7) - (i+1);
367    assert(NumSpaces < 8 && "Invalid computation of space amt");
368
369    // Insert spaces into the SourceLine.
370    SourceLine.insert(i+1, NumSpaces, ' ');
371
372    // Insert spaces or ~'s into CaretLine.
373    CaretLine.insert(i+1, NumSpaces, CaretLine[i] == '~' ? '~' : ' ');
374  }
375
376  // If we are in -fdiagnostics-print-source-range-info mode, we are trying to
377  // produce easily machine parsable output.  Add a space before the source line
378  // and the caret to make it trivial to tell the main diagnostic line from what
379  // the user is intended to see.
380  if (DiagOpts->ShowSourceRanges) {
381    SourceLine = ' ' + SourceLine;
382    CaretLine = ' ' + CaretLine;
383  }
384
385  std::string FixItInsertionLine;
386  if (NumHints && DiagOpts->ShowFixits) {
387    for (const CodeModificationHint *Hint = Hints, *LastHint = Hints + NumHints;
388         Hint != LastHint; ++Hint) {
389      if (Hint->InsertionLoc.isValid()) {
390        // We have an insertion hint. Determine whether the inserted
391        // code is on the same line as the caret.
392        std::pair<FileID, unsigned> HintLocInfo
393          = SM.getDecomposedInstantiationLoc(Hint->InsertionLoc);
394        if (SM.getLineNumber(HintLocInfo.first, HintLocInfo.second) ==
395              SM.getLineNumber(FID, FileOffset)) {
396          // Insert the new code into the line just below the code
397          // that the user wrote.
398          unsigned HintColNo
399            = SM.getColumnNumber(HintLocInfo.first, HintLocInfo.second);
400          unsigned LastColumnModified
401            = HintColNo - 1 + Hint->CodeToInsert.size();
402          if (LastColumnModified > FixItInsertionLine.size())
403            FixItInsertionLine.resize(LastColumnModified, ' ');
404          std::copy(Hint->CodeToInsert.begin(), Hint->CodeToInsert.end(),
405                    FixItInsertionLine.begin() + HintColNo - 1);
406        } else {
407          FixItInsertionLine.clear();
408          break;
409        }
410      }
411    }
412  }
413
414  // If the source line is too long for our terminal, select only the
415  // "interesting" source region within that line.
416  if (Columns && SourceLine.size() > Columns)
417    SelectInterestingSourceRegion(SourceLine, CaretLine, FixItInsertionLine,
418                                  CaretEndColNo, Columns);
419
420  // Finally, remove any blank spaces from the end of CaretLine.
421  while (CaretLine[CaretLine.size()-1] == ' ')
422    CaretLine.erase(CaretLine.end()-1);
423
424  // Emit what we have computed.
425  OS << SourceLine << '\n';
426
427  if (DiagOpts->ShowColors)
428    OS.changeColor(caretColor, true);
429  OS << CaretLine << '\n';
430  if (DiagOpts->ShowColors)
431    OS.resetColor();
432
433  if (!FixItInsertionLine.empty()) {
434    if (DiagOpts->ShowColors)
435      // Print fixit line in color
436      OS.changeColor(fixitColor, false);
437    if (DiagOpts->ShowSourceRanges)
438      OS << ' ';
439    OS << FixItInsertionLine << '\n';
440    if (DiagOpts->ShowColors)
441      OS.resetColor();
442  }
443}
444
445/// \brief Skip over whitespace in the string, starting at the given
446/// index.
447///
448/// \returns The index of the first non-whitespace character that is
449/// greater than or equal to Idx or, if no such character exists,
450/// returns the end of the string.
451static unsigned skipWhitespace(unsigned Idx,
452                               const llvm::SmallVectorImpl<char> &Str,
453                               unsigned Length) {
454  while (Idx < Length && isspace(Str[Idx]))
455    ++Idx;
456  return Idx;
457}
458
459/// \brief If the given character is the start of some kind of
460/// balanced punctuation (e.g., quotes or parentheses), return the
461/// character that will terminate the punctuation.
462///
463/// \returns The ending punctuation character, if any, or the NULL
464/// character if the input character does not start any punctuation.
465static inline char findMatchingPunctuation(char c) {
466  switch (c) {
467  case '\'': return '\'';
468  case '`': return '\'';
469  case '"':  return '"';
470  case '(':  return ')';
471  case '[': return ']';
472  case '{': return '}';
473  default: break;
474  }
475
476  return 0;
477}
478
479/// \brief Find the end of the word starting at the given offset
480/// within a string.
481///
482/// \returns the index pointing one character past the end of the
483/// word.
484unsigned findEndOfWord(unsigned Start,
485                       const llvm::SmallVectorImpl<char> &Str,
486                       unsigned Length, unsigned Column,
487                       unsigned Columns) {
488  unsigned End = Start + 1;
489
490  // Determine if the start of the string is actually opening
491  // punctuation, e.g., a quote or parentheses.
492  char EndPunct = findMatchingPunctuation(Str[Start]);
493  if (!EndPunct) {
494    // This is a normal word. Just find the first space character.
495    while (End < Length && !isspace(Str[End]))
496      ++End;
497    return End;
498  }
499
500  // We have the start of a balanced punctuation sequence (quotes,
501  // parentheses, etc.). Determine the full sequence is.
502  llvm::SmallVector<char, 16> PunctuationEndStack;
503  PunctuationEndStack.push_back(EndPunct);
504  while (End < Length && !PunctuationEndStack.empty()) {
505    if (Str[End] == PunctuationEndStack.back())
506      PunctuationEndStack.pop_back();
507    else if (char SubEndPunct = findMatchingPunctuation(Str[End]))
508      PunctuationEndStack.push_back(SubEndPunct);
509
510    ++End;
511  }
512
513  // Find the first space character after the punctuation ended.
514  while (End < Length && !isspace(Str[End]))
515    ++End;
516
517  unsigned PunctWordLength = End - Start;
518  if (// If the word fits on this line
519      Column + PunctWordLength <= Columns ||
520      // ... or the word is "short enough" to take up the next line
521      // without too much ugly white space
522      PunctWordLength < Columns/3)
523    return End; // Take the whole thing as a single "word".
524
525  // The whole quoted/parenthesized string is too long to print as a
526  // single "word". Instead, find the "word" that starts just after
527  // the punctuation and use that end-point instead. This will recurse
528  // until it finds something small enough to consider a word.
529  return findEndOfWord(Start + 1, Str, Length, Column + 1, Columns);
530}
531
532/// \brief Print the given string to a stream, word-wrapping it to
533/// some number of columns in the process.
534///
535/// \brief OS the stream to which the word-wrapping string will be
536/// emitted.
537///
538/// \brief Str the string to word-wrap and output.
539///
540/// \brief Columns the number of columns to word-wrap to.
541///
542/// \brief Column the column number at which the first character of \p
543/// Str will be printed. This will be non-zero when part of the first
544/// line has already been printed.
545///
546/// \brief Indentation the number of spaces to indent any lines beyond
547/// the first line.
548///
549/// \returns true if word-wrapping was required, or false if the
550/// string fit on the first line.
551static bool PrintWordWrapped(llvm::raw_ostream &OS,
552                             const llvm::SmallVectorImpl<char> &Str,
553                             unsigned Columns,
554                             unsigned Column = 0,
555                             unsigned Indentation = WordWrapIndentation) {
556  unsigned Length = Str.size();
557
558  // If there is a newline in this message somewhere, find that
559  // newline and split the message into the part before the newline
560  // (which will be word-wrapped) and the part from the newline one
561  // (which will be emitted unchanged).
562  for (unsigned I = 0; I != Length; ++I)
563    if (Str[I] == '\n') {
564      Length = I;
565      break;
566    }
567
568  // The string used to indent each line.
569  llvm::SmallString<16> IndentStr;
570  IndentStr.assign(Indentation, ' ');
571  bool Wrapped = false;
572  for (unsigned WordStart = 0, WordEnd; WordStart < Length;
573       WordStart = WordEnd) {
574    // Find the beginning of the next word.
575    WordStart = skipWhitespace(WordStart, Str, Length);
576    if (WordStart == Length)
577      break;
578
579    // Find the end of this word.
580    WordEnd = findEndOfWord(WordStart, Str, Length, Column, Columns);
581
582    // Does this word fit on the current line?
583    unsigned WordLength = WordEnd - WordStart;
584    if (Column + WordLength < Columns) {
585      // This word fits on the current line; print it there.
586      if (WordStart) {
587        OS << ' ';
588        Column += 1;
589      }
590      OS.write(&Str[WordStart], WordLength);
591      Column += WordLength;
592      continue;
593    }
594
595    // This word does not fit on the current line, so wrap to the next
596    // line.
597    OS << '\n';
598    OS.write(&IndentStr[0], Indentation);
599    OS.write(&Str[WordStart], WordLength);
600    Column = Indentation + WordLength;
601    Wrapped = true;
602  }
603
604  if (Length == Str.size())
605    return Wrapped; // We're done.
606
607  // There is a newline in the message, followed by something that
608  // will not be word-wrapped. Print that.
609  OS.write(&Str[Length], Str.size() - Length);
610  return true;
611}
612
613void TextDiagnosticPrinter::HandleDiagnostic(Diagnostic::Level Level,
614                                             const DiagnosticInfo &Info) {
615  // Keeps track of the the starting position of the location
616  // information (e.g., "foo.c:10:4:") that precedes the error
617  // message. We use this information to determine how long the
618  // file+line+column number prefix is.
619  uint64_t StartOfLocationInfo = OS.tell();
620
621  // If the location is specified, print out a file/line/col and include trace
622  // if enabled.
623  if (Info.getLocation().isValid()) {
624    const SourceManager &SM = Info.getLocation().getManager();
625    PresumedLoc PLoc = SM.getPresumedLoc(Info.getLocation());
626    unsigned LineNo = PLoc.getLine();
627
628    // First, if this diagnostic is not in the main file, print out the
629    // "included from" lines.
630    if (LastWarningLoc != PLoc.getIncludeLoc()) {
631      LastWarningLoc = PLoc.getIncludeLoc();
632      PrintIncludeStack(LastWarningLoc, SM);
633      StartOfLocationInfo = OS.tell();
634    }
635
636    // Compute the column number.
637    if (DiagOpts->ShowLocation) {
638      if (DiagOpts->ShowColors)
639        OS.changeColor(savedColor, true);
640      OS << PLoc.getFilename() << ':' << LineNo << ':';
641      if (DiagOpts->ShowColumn)
642        if (unsigned ColNo = PLoc.getColumn())
643          OS << ColNo << ':';
644
645      if (DiagOpts->ShowSourceRanges && Info.getNumRanges()) {
646        FileID CaretFileID =
647          SM.getFileID(SM.getInstantiationLoc(Info.getLocation()));
648        bool PrintedRange = false;
649
650        for (unsigned i = 0, e = Info.getNumRanges(); i != e; ++i) {
651          // Ignore invalid ranges.
652          if (!Info.getRange(i).isValid()) continue;
653
654          SourceLocation B = Info.getRange(i).getBegin();
655          SourceLocation E = Info.getRange(i).getEnd();
656          B = SM.getInstantiationLoc(B);
657          E = SM.getInstantiationLoc(E);
658
659          // If the End location and the start location are the same and are a
660          // macro location, then the range was something that came from a macro
661          // expansion or _Pragma.  If this is an object-like macro, the best we
662          // can do is to highlight the range.  If this is a function-like
663          // macro, we'd also like to highlight the arguments.
664          if (B == E && Info.getRange(i).getEnd().isMacroID())
665            E = SM.getInstantiationRange(Info.getRange(i).getEnd()).second;
666
667          std::pair<FileID, unsigned> BInfo = SM.getDecomposedLoc(B);
668          std::pair<FileID, unsigned> EInfo = SM.getDecomposedLoc(E);
669
670          // If the start or end of the range is in another file, just discard
671          // it.
672          if (BInfo.first != CaretFileID || EInfo.first != CaretFileID)
673            continue;
674
675          // Add in the length of the token, so that we cover multi-char tokens.
676          unsigned TokSize = Lexer::MeasureTokenLength(E, SM, *LangOpts);
677
678          OS << '{' << SM.getLineNumber(BInfo.first, BInfo.second) << ':'
679             << SM.getColumnNumber(BInfo.first, BInfo.second) << '-'
680             << SM.getLineNumber(EInfo.first, EInfo.second) << ':'
681             << (SM.getColumnNumber(EInfo.first, EInfo.second)+TokSize) << '}';
682          PrintedRange = true;
683        }
684
685        if (PrintedRange)
686          OS << ':';
687      }
688      OS << ' ';
689      if (DiagOpts->ShowColors)
690        OS.resetColor();
691    }
692  }
693
694  if (DiagOpts->ShowColors) {
695    // Print diagnostic category in bold and color
696    switch (Level) {
697    case Diagnostic::Ignored: assert(0 && "Invalid diagnostic type");
698    case Diagnostic::Note:    OS.changeColor(noteColor, true); break;
699    case Diagnostic::Warning: OS.changeColor(warningColor, true); break;
700    case Diagnostic::Error:   OS.changeColor(errorColor, true); break;
701    case Diagnostic::Fatal:   OS.changeColor(fatalColor, true); break;
702    }
703  }
704
705  switch (Level) {
706  case Diagnostic::Ignored: assert(0 && "Invalid diagnostic type");
707  case Diagnostic::Note:    OS << "note: "; break;
708  case Diagnostic::Warning: OS << "warning: "; break;
709  case Diagnostic::Error:   OS << "error: "; break;
710  case Diagnostic::Fatal:   OS << "fatal error: "; break;
711  }
712
713  if (DiagOpts->ShowColors)
714    OS.resetColor();
715
716  llvm::SmallString<100> OutStr;
717  Info.FormatDiagnostic(OutStr);
718
719  if (DiagOpts->ShowOptionNames)
720    if (const char *Opt = Diagnostic::getWarningOptionForDiag(Info.getID())) {
721      OutStr += " [-W";
722      OutStr += Opt;
723      OutStr += ']';
724    }
725
726  if (DiagOpts->ShowColors) {
727    // Print warnings, errors and fatal errors in bold, no color
728    switch (Level) {
729    case Diagnostic::Warning: OS.changeColor(savedColor, true); break;
730    case Diagnostic::Error:   OS.changeColor(savedColor, true); break;
731    case Diagnostic::Fatal:   OS.changeColor(savedColor, true); break;
732    default: break; //don't bold notes
733    }
734  }
735
736  if (DiagOpts->MessageLength) {
737    // We will be word-wrapping the error message, so compute the
738    // column number where we currently are (after printing the
739    // location information).
740    unsigned Column = OS.tell() - StartOfLocationInfo;
741    PrintWordWrapped(OS, OutStr, DiagOpts->MessageLength, Column);
742  } else {
743    OS.write(OutStr.begin(), OutStr.size());
744  }
745  OS << '\n';
746  if (DiagOpts->ShowColors)
747    OS.resetColor();
748
749  // If caret diagnostics are enabled and we have location, we want to
750  // emit the caret.  However, we only do this if the location moved
751  // from the last diagnostic, if the last diagnostic was a note that
752  // was part of a different warning or error diagnostic, or if the
753  // diagnostic has ranges.  We don't want to emit the same caret
754  // multiple times if one loc has multiple diagnostics.
755  if (DiagOpts->ShowCarets && Info.getLocation().isValid() &&
756      ((LastLoc != Info.getLocation()) || Info.getNumRanges() ||
757       (LastCaretDiagnosticWasNote && Level != Diagnostic::Note) ||
758       Info.getNumCodeModificationHints())) {
759    // Cache the LastLoc, it allows us to omit duplicate source/caret spewage.
760    LastLoc = Info.getLocation();
761    LastCaretDiagnosticWasNote = (Level == Diagnostic::Note);
762
763    // Get the ranges into a local array we can hack on.
764    SourceRange Ranges[20];
765    unsigned NumRanges = Info.getNumRanges();
766    assert(NumRanges < 20 && "Out of space");
767    for (unsigned i = 0; i != NumRanges; ++i)
768      Ranges[i] = Info.getRange(i);
769
770    unsigned NumHints = Info.getNumCodeModificationHints();
771    for (unsigned idx = 0; idx < NumHints; ++idx) {
772      const CodeModificationHint &Hint = Info.getCodeModificationHint(idx);
773      if (Hint.RemoveRange.isValid()) {
774        assert(NumRanges < 20 && "Out of space");
775        Ranges[NumRanges++] = Hint.RemoveRange;
776      }
777    }
778
779    EmitCaretDiagnostic(LastLoc, Ranges, NumRanges, LastLoc.getManager(),
780                        Info.getCodeModificationHints(),
781                        Info.getNumCodeModificationHints(),
782                        DiagOpts->MessageLength);
783  }
784
785  OS.flush();
786}
787