xref: /llvm-project-15.0.7/clang/lib/Lex/Lexer.cpp (revision 7e82e019)
1 //===--- Lexer.cpp - C Language Family Lexer ------------------------------===//
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 file implements the Lexer and Token interfaces.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "clang/Lex/Lexer.h"
15 #include "UnicodeCharSets.h"
16 #include "clang/Basic/CharInfo.h"
17 #include "clang/Basic/SourceManager.h"
18 #include "clang/Lex/CodeCompletionHandler.h"
19 #include "clang/Lex/LexDiagnostic.h"
20 #include "clang/Lex/LiteralSupport.h"
21 #include "clang/Lex/Preprocessor.h"
22 #include "llvm/ADT/STLExtras.h"
23 #include "llvm/ADT/StringExtras.h"
24 #include "llvm/ADT/StringSwitch.h"
25 #include "llvm/Support/Compiler.h"
26 #include "llvm/Support/ConvertUTF.h"
27 #include "llvm/Support/MemoryBuffer.h"
28 #include <cstring>
29 using namespace clang;
30 
31 //===----------------------------------------------------------------------===//
32 // Token Class Implementation
33 //===----------------------------------------------------------------------===//
34 
35 /// isObjCAtKeyword - Return true if we have an ObjC keyword identifier.
36 bool Token::isObjCAtKeyword(tok::ObjCKeywordKind objcKey) const {
37   if (IdentifierInfo *II = getIdentifierInfo())
38     return II->getObjCKeywordID() == objcKey;
39   return false;
40 }
41 
42 /// getObjCKeywordID - Return the ObjC keyword kind.
43 tok::ObjCKeywordKind Token::getObjCKeywordID() const {
44   IdentifierInfo *specId = getIdentifierInfo();
45   return specId ? specId->getObjCKeywordID() : tok::objc_not_keyword;
46 }
47 
48 
49 //===----------------------------------------------------------------------===//
50 // Lexer Class Implementation
51 //===----------------------------------------------------------------------===//
52 
53 void Lexer::anchor() { }
54 
55 void Lexer::InitLexer(const char *BufStart, const char *BufPtr,
56                       const char *BufEnd) {
57   BufferStart = BufStart;
58   BufferPtr = BufPtr;
59   BufferEnd = BufEnd;
60 
61   assert(BufEnd[0] == 0 &&
62          "We assume that the input buffer has a null character at the end"
63          " to simplify lexing!");
64 
65   // Check whether we have a BOM in the beginning of the buffer. If yes - act
66   // accordingly. Right now we support only UTF-8 with and without BOM, so, just
67   // skip the UTF-8 BOM if it's present.
68   if (BufferStart == BufferPtr) {
69     // Determine the size of the BOM.
70     StringRef Buf(BufferStart, BufferEnd - BufferStart);
71     size_t BOMLength = llvm::StringSwitch<size_t>(Buf)
72       .StartsWith("\xEF\xBB\xBF", 3) // UTF-8 BOM
73       .Default(0);
74 
75     // Skip the BOM.
76     BufferPtr += BOMLength;
77   }
78 
79   Is_PragmaLexer = false;
80   CurrentConflictMarkerState = CMK_None;
81 
82   // Start of the file is a start of line.
83   IsAtStartOfLine = true;
84   IsAtPhysicalStartOfLine = true;
85 
86   HasLeadingSpace = false;
87   HasLeadingEmptyMacro = false;
88 
89   // We are not after parsing a #.
90   ParsingPreprocessorDirective = false;
91 
92   // We are not after parsing #include.
93   ParsingFilename = false;
94 
95   // We are not in raw mode.  Raw mode disables diagnostics and interpretation
96   // of tokens (e.g. identifiers, thus disabling macro expansion).  It is used
97   // to quickly lex the tokens of the buffer, e.g. when handling a "#if 0" block
98   // or otherwise skipping over tokens.
99   LexingRawMode = false;
100 
101   // Default to not keeping comments.
102   ExtendedTokenMode = 0;
103 }
104 
105 /// Lexer constructor - Create a new lexer object for the specified buffer
106 /// with the specified preprocessor managing the lexing process.  This lexer
107 /// assumes that the associated file buffer and Preprocessor objects will
108 /// outlive it, so it doesn't take ownership of either of them.
109 Lexer::Lexer(FileID FID, const llvm::MemoryBuffer *InputFile, Preprocessor &PP)
110   : PreprocessorLexer(&PP, FID),
111     FileLoc(PP.getSourceManager().getLocForStartOfFile(FID)),
112     LangOpts(PP.getLangOpts()) {
113 
114   InitLexer(InputFile->getBufferStart(), InputFile->getBufferStart(),
115             InputFile->getBufferEnd());
116 
117   resetExtendedTokenMode();
118 }
119 
120 void Lexer::resetExtendedTokenMode() {
121   assert(PP && "Cannot reset token mode without a preprocessor");
122   if (LangOpts.TraditionalCPP)
123     SetKeepWhitespaceMode(true);
124   else
125     SetCommentRetentionState(PP->getCommentRetentionState());
126 }
127 
128 /// Lexer constructor - Create a new raw lexer object.  This object is only
129 /// suitable for calls to 'LexFromRawLexer'.  This lexer assumes that the text
130 /// range will outlive it, so it doesn't take ownership of it.
131 Lexer::Lexer(SourceLocation fileloc, const LangOptions &langOpts,
132              const char *BufStart, const char *BufPtr, const char *BufEnd)
133   : FileLoc(fileloc), LangOpts(langOpts) {
134 
135   InitLexer(BufStart, BufPtr, BufEnd);
136 
137   // We *are* in raw mode.
138   LexingRawMode = true;
139 }
140 
141 /// Lexer constructor - Create a new raw lexer object.  This object is only
142 /// suitable for calls to 'LexFromRawLexer'.  This lexer assumes that the text
143 /// range will outlive it, so it doesn't take ownership of it.
144 Lexer::Lexer(FileID FID, const llvm::MemoryBuffer *FromFile,
145              const SourceManager &SM, const LangOptions &langOpts)
146     : Lexer(SM.getLocForStartOfFile(FID), langOpts, FromFile->getBufferStart(),
147             FromFile->getBufferStart(), FromFile->getBufferEnd()) {}
148 
149 /// Create_PragmaLexer: Lexer constructor - Create a new lexer object for
150 /// _Pragma expansion.  This has a variety of magic semantics that this method
151 /// sets up.  It returns a new'd Lexer that must be delete'd when done.
152 ///
153 /// On entrance to this routine, TokStartLoc is a macro location which has a
154 /// spelling loc that indicates the bytes to be lexed for the token and an
155 /// expansion location that indicates where all lexed tokens should be
156 /// "expanded from".
157 ///
158 /// TODO: It would really be nice to make _Pragma just be a wrapper around a
159 /// normal lexer that remaps tokens as they fly by.  This would require making
160 /// Preprocessor::Lex virtual.  Given that, we could just dump in a magic lexer
161 /// interface that could handle this stuff.  This would pull GetMappedTokenLoc
162 /// out of the critical path of the lexer!
163 ///
164 Lexer *Lexer::Create_PragmaLexer(SourceLocation SpellingLoc,
165                                  SourceLocation ExpansionLocStart,
166                                  SourceLocation ExpansionLocEnd,
167                                  unsigned TokLen, Preprocessor &PP) {
168   SourceManager &SM = PP.getSourceManager();
169 
170   // Create the lexer as if we were going to lex the file normally.
171   FileID SpellingFID = SM.getFileID(SpellingLoc);
172   const llvm::MemoryBuffer *InputFile = SM.getBuffer(SpellingFID);
173   Lexer *L = new Lexer(SpellingFID, InputFile, PP);
174 
175   // Now that the lexer is created, change the start/end locations so that we
176   // just lex the subsection of the file that we want.  This is lexing from a
177   // scratch buffer.
178   const char *StrData = SM.getCharacterData(SpellingLoc);
179 
180   L->BufferPtr = StrData;
181   L->BufferEnd = StrData+TokLen;
182   assert(L->BufferEnd[0] == 0 && "Buffer is not nul terminated!");
183 
184   // Set the SourceLocation with the remapping information.  This ensures that
185   // GetMappedTokenLoc will remap the tokens as they are lexed.
186   L->FileLoc = SM.createExpansionLoc(SM.getLocForStartOfFile(SpellingFID),
187                                      ExpansionLocStart,
188                                      ExpansionLocEnd, TokLen);
189 
190   // Ensure that the lexer thinks it is inside a directive, so that end \n will
191   // return an EOD token.
192   L->ParsingPreprocessorDirective = true;
193 
194   // This lexer really is for _Pragma.
195   L->Is_PragmaLexer = true;
196   return L;
197 }
198 
199 
200 /// Stringify - Convert the specified string into a C string, with surrounding
201 /// ""'s, and with escaped \ and " characters.
202 std::string Lexer::Stringify(StringRef Str, bool Charify) {
203   std::string Result = Str;
204   char Quote = Charify ? '\'' : '"';
205   for (unsigned i = 0, e = Result.size(); i != e; ++i) {
206     if (Result[i] == '\\' || Result[i] == Quote) {
207       Result.insert(Result.begin()+i, '\\');
208       ++i; ++e;
209     }
210   }
211   return Result;
212 }
213 
214 /// Stringify - Convert the specified string into a C string by escaping '\'
215 /// and " characters.  This does not add surrounding ""'s to the string.
216 void Lexer::Stringify(SmallVectorImpl<char> &Str) {
217   for (unsigned i = 0, e = Str.size(); i != e; ++i) {
218     if (Str[i] == '\\' || Str[i] == '"') {
219       Str.insert(Str.begin()+i, '\\');
220       ++i; ++e;
221     }
222   }
223 }
224 
225 //===----------------------------------------------------------------------===//
226 // Token Spelling
227 //===----------------------------------------------------------------------===//
228 
229 /// \brief Slow case of getSpelling. Extract the characters comprising the
230 /// spelling of this token from the provided input buffer.
231 static size_t getSpellingSlow(const Token &Tok, const char *BufPtr,
232                               const LangOptions &LangOpts, char *Spelling) {
233   assert(Tok.needsCleaning() && "getSpellingSlow called on simple token");
234 
235   size_t Length = 0;
236   const char *BufEnd = BufPtr + Tok.getLength();
237 
238   if (tok::isStringLiteral(Tok.getKind())) {
239     // Munch the encoding-prefix and opening double-quote.
240     while (BufPtr < BufEnd) {
241       unsigned Size;
242       Spelling[Length++] = Lexer::getCharAndSizeNoWarn(BufPtr, Size, LangOpts);
243       BufPtr += Size;
244 
245       if (Spelling[Length - 1] == '"')
246         break;
247     }
248 
249     // Raw string literals need special handling; trigraph expansion and line
250     // splicing do not occur within their d-char-sequence nor within their
251     // r-char-sequence.
252     if (Length >= 2 &&
253         Spelling[Length - 2] == 'R' && Spelling[Length - 1] == '"') {
254       // Search backwards from the end of the token to find the matching closing
255       // quote.
256       const char *RawEnd = BufEnd;
257       do --RawEnd; while (*RawEnd != '"');
258       size_t RawLength = RawEnd - BufPtr + 1;
259 
260       // Everything between the quotes is included verbatim in the spelling.
261       memcpy(Spelling + Length, BufPtr, RawLength);
262       Length += RawLength;
263       BufPtr += RawLength;
264 
265       // The rest of the token is lexed normally.
266     }
267   }
268 
269   while (BufPtr < BufEnd) {
270     unsigned Size;
271     Spelling[Length++] = Lexer::getCharAndSizeNoWarn(BufPtr, Size, LangOpts);
272     BufPtr += Size;
273   }
274 
275   assert(Length < Tok.getLength() &&
276          "NeedsCleaning flag set on token that didn't need cleaning!");
277   return Length;
278 }
279 
280 /// getSpelling() - Return the 'spelling' of this token.  The spelling of a
281 /// token are the characters used to represent the token in the source file
282 /// after trigraph expansion and escaped-newline folding.  In particular, this
283 /// wants to get the true, uncanonicalized, spelling of things like digraphs
284 /// UCNs, etc.
285 StringRef Lexer::getSpelling(SourceLocation loc,
286                              SmallVectorImpl<char> &buffer,
287                              const SourceManager &SM,
288                              const LangOptions &options,
289                              bool *invalid) {
290   // Break down the source location.
291   std::pair<FileID, unsigned> locInfo = SM.getDecomposedLoc(loc);
292 
293   // Try to the load the file buffer.
294   bool invalidTemp = false;
295   StringRef file = SM.getBufferData(locInfo.first, &invalidTemp);
296   if (invalidTemp) {
297     if (invalid) *invalid = true;
298     return StringRef();
299   }
300 
301   const char *tokenBegin = file.data() + locInfo.second;
302 
303   // Lex from the start of the given location.
304   Lexer lexer(SM.getLocForStartOfFile(locInfo.first), options,
305               file.begin(), tokenBegin, file.end());
306   Token token;
307   lexer.LexFromRawLexer(token);
308 
309   unsigned length = token.getLength();
310 
311   // Common case:  no need for cleaning.
312   if (!token.needsCleaning())
313     return StringRef(tokenBegin, length);
314 
315   // Hard case, we need to relex the characters into the string.
316   buffer.resize(length);
317   buffer.resize(getSpellingSlow(token, tokenBegin, options, buffer.data()));
318   return StringRef(buffer.data(), buffer.size());
319 }
320 
321 /// getSpelling() - Return the 'spelling' of this token.  The spelling of a
322 /// token are the characters used to represent the token in the source file
323 /// after trigraph expansion and escaped-newline folding.  In particular, this
324 /// wants to get the true, uncanonicalized, spelling of things like digraphs
325 /// UCNs, etc.
326 std::string Lexer::getSpelling(const Token &Tok, const SourceManager &SourceMgr,
327                                const LangOptions &LangOpts, bool *Invalid) {
328   assert((int)Tok.getLength() >= 0 && "Token character range is bogus!");
329 
330   bool CharDataInvalid = false;
331   const char *TokStart = SourceMgr.getCharacterData(Tok.getLocation(),
332                                                     &CharDataInvalid);
333   if (Invalid)
334     *Invalid = CharDataInvalid;
335   if (CharDataInvalid)
336     return std::string();
337 
338   // If this token contains nothing interesting, return it directly.
339   if (!Tok.needsCleaning())
340     return std::string(TokStart, TokStart + Tok.getLength());
341 
342   std::string Result;
343   Result.resize(Tok.getLength());
344   Result.resize(getSpellingSlow(Tok, TokStart, LangOpts, &*Result.begin()));
345   return Result;
346 }
347 
348 /// getSpelling - This method is used to get the spelling of a token into a
349 /// preallocated buffer, instead of as an std::string.  The caller is required
350 /// to allocate enough space for the token, which is guaranteed to be at least
351 /// Tok.getLength() bytes long.  The actual length of the token is returned.
352 ///
353 /// Note that this method may do two possible things: it may either fill in
354 /// the buffer specified with characters, or it may *change the input pointer*
355 /// to point to a constant buffer with the data already in it (avoiding a
356 /// copy).  The caller is not allowed to modify the returned buffer pointer
357 /// if an internal buffer is returned.
358 unsigned Lexer::getSpelling(const Token &Tok, const char *&Buffer,
359                             const SourceManager &SourceMgr,
360                             const LangOptions &LangOpts, bool *Invalid) {
361   assert((int)Tok.getLength() >= 0 && "Token character range is bogus!");
362 
363   const char *TokStart = nullptr;
364   // NOTE: this has to be checked *before* testing for an IdentifierInfo.
365   if (Tok.is(tok::raw_identifier))
366     TokStart = Tok.getRawIdentifier().data();
367   else if (!Tok.hasUCN()) {
368     if (const IdentifierInfo *II = Tok.getIdentifierInfo()) {
369       // Just return the string from the identifier table, which is very quick.
370       Buffer = II->getNameStart();
371       return II->getLength();
372     }
373   }
374 
375   // NOTE: this can be checked even after testing for an IdentifierInfo.
376   if (Tok.isLiteral())
377     TokStart = Tok.getLiteralData();
378 
379   if (!TokStart) {
380     // Compute the start of the token in the input lexer buffer.
381     bool CharDataInvalid = false;
382     TokStart = SourceMgr.getCharacterData(Tok.getLocation(), &CharDataInvalid);
383     if (Invalid)
384       *Invalid = CharDataInvalid;
385     if (CharDataInvalid) {
386       Buffer = "";
387       return 0;
388     }
389   }
390 
391   // If this token contains nothing interesting, return it directly.
392   if (!Tok.needsCleaning()) {
393     Buffer = TokStart;
394     return Tok.getLength();
395   }
396 
397   // Otherwise, hard case, relex the characters into the string.
398   return getSpellingSlow(Tok, TokStart, LangOpts, const_cast<char*>(Buffer));
399 }
400 
401 
402 /// MeasureTokenLength - Relex the token at the specified location and return
403 /// its length in bytes in the input file.  If the token needs cleaning (e.g.
404 /// includes a trigraph or an escaped newline) then this count includes bytes
405 /// that are part of that.
406 unsigned Lexer::MeasureTokenLength(SourceLocation Loc,
407                                    const SourceManager &SM,
408                                    const LangOptions &LangOpts) {
409   Token TheTok;
410   if (getRawToken(Loc, TheTok, SM, LangOpts))
411     return 0;
412   return TheTok.getLength();
413 }
414 
415 /// \brief Relex the token at the specified location.
416 /// \returns true if there was a failure, false on success.
417 bool Lexer::getRawToken(SourceLocation Loc, Token &Result,
418                         const SourceManager &SM,
419                         const LangOptions &LangOpts,
420                         bool IgnoreWhiteSpace) {
421   // TODO: this could be special cased for common tokens like identifiers, ')',
422   // etc to make this faster, if it mattered.  Just look at StrData[0] to handle
423   // all obviously single-char tokens.  This could use
424   // Lexer::isObviouslySimpleCharacter for example to handle identifiers or
425   // something.
426 
427   // If this comes from a macro expansion, we really do want the macro name, not
428   // the token this macro expanded to.
429   Loc = SM.getExpansionLoc(Loc);
430   std::pair<FileID, unsigned> LocInfo = SM.getDecomposedLoc(Loc);
431   bool Invalid = false;
432   StringRef Buffer = SM.getBufferData(LocInfo.first, &Invalid);
433   if (Invalid)
434     return true;
435 
436   const char *StrData = Buffer.data()+LocInfo.second;
437 
438   if (!IgnoreWhiteSpace && isWhitespace(StrData[0]))
439     return true;
440 
441   // Create a lexer starting at the beginning of this token.
442   Lexer TheLexer(SM.getLocForStartOfFile(LocInfo.first), LangOpts,
443                  Buffer.begin(), StrData, Buffer.end());
444   TheLexer.SetCommentRetentionState(true);
445   TheLexer.LexFromRawLexer(Result);
446   return false;
447 }
448 
449 static SourceLocation getBeginningOfFileToken(SourceLocation Loc,
450                                               const SourceManager &SM,
451                                               const LangOptions &LangOpts) {
452   assert(Loc.isFileID());
453   std::pair<FileID, unsigned> LocInfo = SM.getDecomposedLoc(Loc);
454   if (LocInfo.first.isInvalid())
455     return Loc;
456 
457   bool Invalid = false;
458   StringRef Buffer = SM.getBufferData(LocInfo.first, &Invalid);
459   if (Invalid)
460     return Loc;
461 
462   // Back up from the current location until we hit the beginning of a line
463   // (or the buffer). We'll relex from that point.
464   const char *BufStart = Buffer.data();
465   if (LocInfo.second >= Buffer.size())
466     return Loc;
467 
468   const char *StrData = BufStart+LocInfo.second;
469   if (StrData[0] == '\n' || StrData[0] == '\r')
470     return Loc;
471 
472   const char *LexStart = StrData;
473   while (LexStart != BufStart) {
474     if (LexStart[0] == '\n' || LexStart[0] == '\r') {
475       ++LexStart;
476       break;
477     }
478 
479     --LexStart;
480   }
481 
482   // Create a lexer starting at the beginning of this token.
483   SourceLocation LexerStartLoc = Loc.getLocWithOffset(-LocInfo.second);
484   Lexer TheLexer(LexerStartLoc, LangOpts, BufStart, LexStart, Buffer.end());
485   TheLexer.SetCommentRetentionState(true);
486 
487   // Lex tokens until we find the token that contains the source location.
488   Token TheTok;
489   do {
490     TheLexer.LexFromRawLexer(TheTok);
491 
492     if (TheLexer.getBufferLocation() > StrData) {
493       // Lexing this token has taken the lexer past the source location we're
494       // looking for. If the current token encompasses our source location,
495       // return the beginning of that token.
496       if (TheLexer.getBufferLocation() - TheTok.getLength() <= StrData)
497         return TheTok.getLocation();
498 
499       // We ended up skipping over the source location entirely, which means
500       // that it points into whitespace. We're done here.
501       break;
502     }
503   } while (TheTok.getKind() != tok::eof);
504 
505   // We've passed our source location; just return the original source location.
506   return Loc;
507 }
508 
509 SourceLocation Lexer::GetBeginningOfToken(SourceLocation Loc,
510                                           const SourceManager &SM,
511                                           const LangOptions &LangOpts) {
512  if (Loc.isFileID())
513    return getBeginningOfFileToken(Loc, SM, LangOpts);
514 
515  if (!SM.isMacroArgExpansion(Loc))
516    return Loc;
517 
518  SourceLocation FileLoc = SM.getSpellingLoc(Loc);
519  SourceLocation BeginFileLoc = getBeginningOfFileToken(FileLoc, SM, LangOpts);
520  std::pair<FileID, unsigned> FileLocInfo = SM.getDecomposedLoc(FileLoc);
521  std::pair<FileID, unsigned> BeginFileLocInfo
522    = SM.getDecomposedLoc(BeginFileLoc);
523  assert(FileLocInfo.first == BeginFileLocInfo.first &&
524         FileLocInfo.second >= BeginFileLocInfo.second);
525  return Loc.getLocWithOffset(BeginFileLocInfo.second - FileLocInfo.second);
526 }
527 
528 namespace {
529   enum PreambleDirectiveKind {
530     PDK_Skipped,
531     PDK_StartIf,
532     PDK_EndIf,
533     PDK_Unknown
534   };
535 }
536 
537 std::pair<unsigned, bool> Lexer::ComputePreamble(StringRef Buffer,
538                                                  const LangOptions &LangOpts,
539                                                  unsigned MaxLines) {
540   // Create a lexer starting at the beginning of the file. Note that we use a
541   // "fake" file source location at offset 1 so that the lexer will track our
542   // position within the file.
543   const unsigned StartOffset = 1;
544   SourceLocation FileLoc = SourceLocation::getFromRawEncoding(StartOffset);
545   Lexer TheLexer(FileLoc, LangOpts, Buffer.begin(), Buffer.begin(),
546                  Buffer.end());
547   TheLexer.SetCommentRetentionState(true);
548 
549   // StartLoc will differ from FileLoc if there is a BOM that was skipped.
550   SourceLocation StartLoc = TheLexer.getSourceLocation();
551 
552   bool InPreprocessorDirective = false;
553   Token TheTok;
554   Token IfStartTok;
555   unsigned IfCount = 0;
556   SourceLocation ActiveCommentLoc;
557 
558   unsigned MaxLineOffset = 0;
559   if (MaxLines) {
560     const char *CurPtr = Buffer.begin();
561     unsigned CurLine = 0;
562     while (CurPtr != Buffer.end()) {
563       char ch = *CurPtr++;
564       if (ch == '\n') {
565         ++CurLine;
566         if (CurLine == MaxLines)
567           break;
568       }
569     }
570     if (CurPtr != Buffer.end())
571       MaxLineOffset = CurPtr - Buffer.begin();
572   }
573 
574   do {
575     TheLexer.LexFromRawLexer(TheTok);
576 
577     if (InPreprocessorDirective) {
578       // If we've hit the end of the file, we're done.
579       if (TheTok.getKind() == tok::eof) {
580         break;
581       }
582 
583       // If we haven't hit the end of the preprocessor directive, skip this
584       // token.
585       if (!TheTok.isAtStartOfLine())
586         continue;
587 
588       // We've passed the end of the preprocessor directive, and will look
589       // at this token again below.
590       InPreprocessorDirective = false;
591     }
592 
593     // Keep track of the # of lines in the preamble.
594     if (TheTok.isAtStartOfLine()) {
595       unsigned TokOffset = TheTok.getLocation().getRawEncoding() - StartOffset;
596 
597       // If we were asked to limit the number of lines in the preamble,
598       // and we're about to exceed that limit, we're done.
599       if (MaxLineOffset && TokOffset >= MaxLineOffset)
600         break;
601     }
602 
603     // Comments are okay; skip over them.
604     if (TheTok.getKind() == tok::comment) {
605       if (ActiveCommentLoc.isInvalid())
606         ActiveCommentLoc = TheTok.getLocation();
607       continue;
608     }
609 
610     if (TheTok.isAtStartOfLine() && TheTok.getKind() == tok::hash) {
611       // This is the start of a preprocessor directive.
612       Token HashTok = TheTok;
613       InPreprocessorDirective = true;
614       ActiveCommentLoc = SourceLocation();
615 
616       // Figure out which directive this is. Since we're lexing raw tokens,
617       // we don't have an identifier table available. Instead, just look at
618       // the raw identifier to recognize and categorize preprocessor directives.
619       TheLexer.LexFromRawLexer(TheTok);
620       if (TheTok.getKind() == tok::raw_identifier && !TheTok.needsCleaning()) {
621         StringRef Keyword = TheTok.getRawIdentifier();
622         PreambleDirectiveKind PDK
623           = llvm::StringSwitch<PreambleDirectiveKind>(Keyword)
624               .Case("include", PDK_Skipped)
625               .Case("__include_macros", PDK_Skipped)
626               .Case("define", PDK_Skipped)
627               .Case("undef", PDK_Skipped)
628               .Case("line", PDK_Skipped)
629               .Case("error", PDK_Skipped)
630               .Case("pragma", PDK_Skipped)
631               .Case("import", PDK_Skipped)
632               .Case("include_next", PDK_Skipped)
633               .Case("warning", PDK_Skipped)
634               .Case("ident", PDK_Skipped)
635               .Case("sccs", PDK_Skipped)
636               .Case("assert", PDK_Skipped)
637               .Case("unassert", PDK_Skipped)
638               .Case("if", PDK_StartIf)
639               .Case("ifdef", PDK_StartIf)
640               .Case("ifndef", PDK_StartIf)
641               .Case("elif", PDK_Skipped)
642               .Case("else", PDK_Skipped)
643               .Case("endif", PDK_EndIf)
644               .Default(PDK_Unknown);
645 
646         switch (PDK) {
647         case PDK_Skipped:
648           continue;
649 
650         case PDK_StartIf:
651           if (IfCount == 0)
652             IfStartTok = HashTok;
653 
654           ++IfCount;
655           continue;
656 
657         case PDK_EndIf:
658           // Mismatched #endif. The preamble ends here.
659           if (IfCount == 0)
660             break;
661 
662           --IfCount;
663           continue;
664 
665         case PDK_Unknown:
666           // We don't know what this directive is; stop at the '#'.
667           break;
668         }
669       }
670 
671       // We only end up here if we didn't recognize the preprocessor
672       // directive or it was one that can't occur in the preamble at this
673       // point. Roll back the current token to the location of the '#'.
674       InPreprocessorDirective = false;
675       TheTok = HashTok;
676     }
677 
678     // We hit a token that we don't recognize as being in the
679     // "preprocessing only" part of the file, so we're no longer in
680     // the preamble.
681     break;
682   } while (true);
683 
684   SourceLocation End;
685   if (IfCount)
686     End = IfStartTok.getLocation();
687   else if (ActiveCommentLoc.isValid())
688     End = ActiveCommentLoc; // don't truncate a decl comment.
689   else
690     End = TheTok.getLocation();
691 
692   return std::make_pair(End.getRawEncoding() - StartLoc.getRawEncoding(),
693                         IfCount? IfStartTok.isAtStartOfLine()
694                                : TheTok.isAtStartOfLine());
695 }
696 
697 
698 /// AdvanceToTokenCharacter - Given a location that specifies the start of a
699 /// token, return a new location that specifies a character within the token.
700 SourceLocation Lexer::AdvanceToTokenCharacter(SourceLocation TokStart,
701                                               unsigned CharNo,
702                                               const SourceManager &SM,
703                                               const LangOptions &LangOpts) {
704   // Figure out how many physical characters away the specified expansion
705   // character is.  This needs to take into consideration newlines and
706   // trigraphs.
707   bool Invalid = false;
708   const char *TokPtr = SM.getCharacterData(TokStart, &Invalid);
709 
710   // If they request the first char of the token, we're trivially done.
711   if (Invalid || (CharNo == 0 && Lexer::isObviouslySimpleCharacter(*TokPtr)))
712     return TokStart;
713 
714   unsigned PhysOffset = 0;
715 
716   // The usual case is that tokens don't contain anything interesting.  Skip
717   // over the uninteresting characters.  If a token only consists of simple
718   // chars, this method is extremely fast.
719   while (Lexer::isObviouslySimpleCharacter(*TokPtr)) {
720     if (CharNo == 0)
721       return TokStart.getLocWithOffset(PhysOffset);
722     ++TokPtr;
723     --CharNo;
724     ++PhysOffset;
725   }
726 
727   // If we have a character that may be a trigraph or escaped newline, use a
728   // lexer to parse it correctly.
729   for (; CharNo; --CharNo) {
730     unsigned Size;
731     Lexer::getCharAndSizeNoWarn(TokPtr, Size, LangOpts);
732     TokPtr += Size;
733     PhysOffset += Size;
734   }
735 
736   // Final detail: if we end up on an escaped newline, we want to return the
737   // location of the actual byte of the token.  For example foo\<newline>bar
738   // advanced by 3 should return the location of b, not of \\.  One compounding
739   // detail of this is that the escape may be made by a trigraph.
740   if (!Lexer::isObviouslySimpleCharacter(*TokPtr))
741     PhysOffset += Lexer::SkipEscapedNewLines(TokPtr)-TokPtr;
742 
743   return TokStart.getLocWithOffset(PhysOffset);
744 }
745 
746 /// \brief Computes the source location just past the end of the
747 /// token at this source location.
748 ///
749 /// This routine can be used to produce a source location that
750 /// points just past the end of the token referenced by \p Loc, and
751 /// is generally used when a diagnostic needs to point just after a
752 /// token where it expected something different that it received. If
753 /// the returned source location would not be meaningful (e.g., if
754 /// it points into a macro), this routine returns an invalid
755 /// source location.
756 ///
757 /// \param Offset an offset from the end of the token, where the source
758 /// location should refer to. The default offset (0) produces a source
759 /// location pointing just past the end of the token; an offset of 1 produces
760 /// a source location pointing to the last character in the token, etc.
761 SourceLocation Lexer::getLocForEndOfToken(SourceLocation Loc, unsigned Offset,
762                                           const SourceManager &SM,
763                                           const LangOptions &LangOpts) {
764   if (Loc.isInvalid())
765     return SourceLocation();
766 
767   if (Loc.isMacroID()) {
768     if (Offset > 0 || !isAtEndOfMacroExpansion(Loc, SM, LangOpts, &Loc))
769       return SourceLocation(); // Points inside the macro expansion.
770   }
771 
772   unsigned Len = Lexer::MeasureTokenLength(Loc, SM, LangOpts);
773   if (Len > Offset)
774     Len = Len - Offset;
775   else
776     return Loc;
777 
778   return Loc.getLocWithOffset(Len);
779 }
780 
781 /// \brief Returns true if the given MacroID location points at the first
782 /// token of the macro expansion.
783 bool Lexer::isAtStartOfMacroExpansion(SourceLocation loc,
784                                       const SourceManager &SM,
785                                       const LangOptions &LangOpts,
786                                       SourceLocation *MacroBegin) {
787   assert(loc.isValid() && loc.isMacroID() && "Expected a valid macro loc");
788 
789   SourceLocation expansionLoc;
790   if (!SM.isAtStartOfImmediateMacroExpansion(loc, &expansionLoc))
791     return false;
792 
793   if (expansionLoc.isFileID()) {
794     // No other macro expansions, this is the first.
795     if (MacroBegin)
796       *MacroBegin = expansionLoc;
797     return true;
798   }
799 
800   return isAtStartOfMacroExpansion(expansionLoc, SM, LangOpts, MacroBegin);
801 }
802 
803 /// \brief Returns true if the given MacroID location points at the last
804 /// token of the macro expansion.
805 bool Lexer::isAtEndOfMacroExpansion(SourceLocation loc,
806                                     const SourceManager &SM,
807                                     const LangOptions &LangOpts,
808                                     SourceLocation *MacroEnd) {
809   assert(loc.isValid() && loc.isMacroID() && "Expected a valid macro loc");
810 
811   SourceLocation spellLoc = SM.getSpellingLoc(loc);
812   unsigned tokLen = MeasureTokenLength(spellLoc, SM, LangOpts);
813   if (tokLen == 0)
814     return false;
815 
816   SourceLocation afterLoc = loc.getLocWithOffset(tokLen);
817   SourceLocation expansionLoc;
818   if (!SM.isAtEndOfImmediateMacroExpansion(afterLoc, &expansionLoc))
819     return false;
820 
821   if (expansionLoc.isFileID()) {
822     // No other macro expansions.
823     if (MacroEnd)
824       *MacroEnd = expansionLoc;
825     return true;
826   }
827 
828   return isAtEndOfMacroExpansion(expansionLoc, SM, LangOpts, MacroEnd);
829 }
830 
831 static CharSourceRange makeRangeFromFileLocs(CharSourceRange Range,
832                                              const SourceManager &SM,
833                                              const LangOptions &LangOpts) {
834   SourceLocation Begin = Range.getBegin();
835   SourceLocation End = Range.getEnd();
836   assert(Begin.isFileID() && End.isFileID());
837   if (Range.isTokenRange()) {
838     End = Lexer::getLocForEndOfToken(End, 0, SM,LangOpts);
839     if (End.isInvalid())
840       return CharSourceRange();
841   }
842 
843   // Break down the source locations.
844   FileID FID;
845   unsigned BeginOffs;
846   std::tie(FID, BeginOffs) = SM.getDecomposedLoc(Begin);
847   if (FID.isInvalid())
848     return CharSourceRange();
849 
850   unsigned EndOffs;
851   if (!SM.isInFileID(End, FID, &EndOffs) ||
852       BeginOffs > EndOffs)
853     return CharSourceRange();
854 
855   return CharSourceRange::getCharRange(Begin, End);
856 }
857 
858 CharSourceRange Lexer::makeFileCharRange(CharSourceRange Range,
859                                          const SourceManager &SM,
860                                          const LangOptions &LangOpts) {
861   SourceLocation Begin = Range.getBegin();
862   SourceLocation End = Range.getEnd();
863   if (Begin.isInvalid() || End.isInvalid())
864     return CharSourceRange();
865 
866   if (Begin.isFileID() && End.isFileID())
867     return makeRangeFromFileLocs(Range, SM, LangOpts);
868 
869   if (Begin.isMacroID() && End.isFileID()) {
870     if (!isAtStartOfMacroExpansion(Begin, SM, LangOpts, &Begin))
871       return CharSourceRange();
872     Range.setBegin(Begin);
873     return makeRangeFromFileLocs(Range, SM, LangOpts);
874   }
875 
876   if (Begin.isFileID() && End.isMacroID()) {
877     if ((Range.isTokenRange() && !isAtEndOfMacroExpansion(End, SM, LangOpts,
878                                                           &End)) ||
879         (Range.isCharRange() && !isAtStartOfMacroExpansion(End, SM, LangOpts,
880                                                            &End)))
881       return CharSourceRange();
882     Range.setEnd(End);
883     return makeRangeFromFileLocs(Range, SM, LangOpts);
884   }
885 
886   assert(Begin.isMacroID() && End.isMacroID());
887   SourceLocation MacroBegin, MacroEnd;
888   if (isAtStartOfMacroExpansion(Begin, SM, LangOpts, &MacroBegin) &&
889       ((Range.isTokenRange() && isAtEndOfMacroExpansion(End, SM, LangOpts,
890                                                         &MacroEnd)) ||
891        (Range.isCharRange() && isAtStartOfMacroExpansion(End, SM, LangOpts,
892                                                          &MacroEnd)))) {
893     Range.setBegin(MacroBegin);
894     Range.setEnd(MacroEnd);
895     return makeRangeFromFileLocs(Range, SM, LangOpts);
896   }
897 
898   bool Invalid = false;
899   const SrcMgr::SLocEntry &BeginEntry = SM.getSLocEntry(SM.getFileID(Begin),
900                                                         &Invalid);
901   if (Invalid)
902     return CharSourceRange();
903 
904   if (BeginEntry.getExpansion().isMacroArgExpansion()) {
905     const SrcMgr::SLocEntry &EndEntry = SM.getSLocEntry(SM.getFileID(End),
906                                                         &Invalid);
907     if (Invalid)
908       return CharSourceRange();
909 
910     if (EndEntry.getExpansion().isMacroArgExpansion() &&
911         BeginEntry.getExpansion().getExpansionLocStart() ==
912             EndEntry.getExpansion().getExpansionLocStart()) {
913       Range.setBegin(SM.getImmediateSpellingLoc(Begin));
914       Range.setEnd(SM.getImmediateSpellingLoc(End));
915       return makeFileCharRange(Range, SM, LangOpts);
916     }
917   }
918 
919   return CharSourceRange();
920 }
921 
922 StringRef Lexer::getSourceText(CharSourceRange Range,
923                                const SourceManager &SM,
924                                const LangOptions &LangOpts,
925                                bool *Invalid) {
926   Range = makeFileCharRange(Range, SM, LangOpts);
927   if (Range.isInvalid()) {
928     if (Invalid) *Invalid = true;
929     return StringRef();
930   }
931 
932   // Break down the source location.
933   std::pair<FileID, unsigned> beginInfo = SM.getDecomposedLoc(Range.getBegin());
934   if (beginInfo.first.isInvalid()) {
935     if (Invalid) *Invalid = true;
936     return StringRef();
937   }
938 
939   unsigned EndOffs;
940   if (!SM.isInFileID(Range.getEnd(), beginInfo.first, &EndOffs) ||
941       beginInfo.second > EndOffs) {
942     if (Invalid) *Invalid = true;
943     return StringRef();
944   }
945 
946   // Try to the load the file buffer.
947   bool invalidTemp = false;
948   StringRef file = SM.getBufferData(beginInfo.first, &invalidTemp);
949   if (invalidTemp) {
950     if (Invalid) *Invalid = true;
951     return StringRef();
952   }
953 
954   if (Invalid) *Invalid = false;
955   return file.substr(beginInfo.second, EndOffs - beginInfo.second);
956 }
957 
958 StringRef Lexer::getImmediateMacroName(SourceLocation Loc,
959                                        const SourceManager &SM,
960                                        const LangOptions &LangOpts) {
961   assert(Loc.isMacroID() && "Only reasonble to call this on macros");
962 
963   // Find the location of the immediate macro expansion.
964   while (1) {
965     FileID FID = SM.getFileID(Loc);
966     const SrcMgr::SLocEntry *E = &SM.getSLocEntry(FID);
967     const SrcMgr::ExpansionInfo &Expansion = E->getExpansion();
968     Loc = Expansion.getExpansionLocStart();
969     if (!Expansion.isMacroArgExpansion())
970       break;
971 
972     // For macro arguments we need to check that the argument did not come
973     // from an inner macro, e.g: "MAC1( MAC2(foo) )"
974 
975     // Loc points to the argument id of the macro definition, move to the
976     // macro expansion.
977     Loc = SM.getImmediateExpansionRange(Loc).first;
978     SourceLocation SpellLoc = Expansion.getSpellingLoc();
979     if (SpellLoc.isFileID())
980       break; // No inner macro.
981 
982     // If spelling location resides in the same FileID as macro expansion
983     // location, it means there is no inner macro.
984     FileID MacroFID = SM.getFileID(Loc);
985     if (SM.isInFileID(SpellLoc, MacroFID))
986       break;
987 
988     // Argument came from inner macro.
989     Loc = SpellLoc;
990   }
991 
992   // Find the spelling location of the start of the non-argument expansion
993   // range. This is where the macro name was spelled in order to begin
994   // expanding this macro.
995   Loc = SM.getSpellingLoc(Loc);
996 
997   // Dig out the buffer where the macro name was spelled and the extents of the
998   // name so that we can render it into the expansion note.
999   std::pair<FileID, unsigned> ExpansionInfo = SM.getDecomposedLoc(Loc);
1000   unsigned MacroTokenLength = Lexer::MeasureTokenLength(Loc, SM, LangOpts);
1001   StringRef ExpansionBuffer = SM.getBufferData(ExpansionInfo.first);
1002   return ExpansionBuffer.substr(ExpansionInfo.second, MacroTokenLength);
1003 }
1004 
1005 StringRef Lexer::getImmediateMacroNameForDiagnostics(
1006     SourceLocation Loc, const SourceManager &SM, const LangOptions &LangOpts) {
1007   assert(Loc.isMacroID() && "Only reasonble to call this on macros");
1008   // Walk past macro argument expanions.
1009   while (SM.isMacroArgExpansion(Loc))
1010     Loc = SM.getImmediateExpansionRange(Loc).first;
1011 
1012   // If the macro's spelling has no FileID, then it's actually a token paste
1013   // or stringization (or similar) and not a macro at all.
1014   if (!SM.getFileEntryForID(SM.getFileID(SM.getSpellingLoc(Loc))))
1015     return StringRef();
1016 
1017   // Find the spelling location of the start of the non-argument expansion
1018   // range. This is where the macro name was spelled in order to begin
1019   // expanding this macro.
1020   Loc = SM.getSpellingLoc(SM.getImmediateExpansionRange(Loc).first);
1021 
1022   // Dig out the buffer where the macro name was spelled and the extents of the
1023   // name so that we can render it into the expansion note.
1024   std::pair<FileID, unsigned> ExpansionInfo = SM.getDecomposedLoc(Loc);
1025   unsigned MacroTokenLength = Lexer::MeasureTokenLength(Loc, SM, LangOpts);
1026   StringRef ExpansionBuffer = SM.getBufferData(ExpansionInfo.first);
1027   return ExpansionBuffer.substr(ExpansionInfo.second, MacroTokenLength);
1028 }
1029 
1030 bool Lexer::isIdentifierBodyChar(char c, const LangOptions &LangOpts) {
1031   return isIdentifierBody(c, LangOpts.DollarIdents);
1032 }
1033 
1034 
1035 //===----------------------------------------------------------------------===//
1036 // Diagnostics forwarding code.
1037 //===----------------------------------------------------------------------===//
1038 
1039 /// GetMappedTokenLoc - If lexing out of a 'mapped buffer', where we pretend the
1040 /// lexer buffer was all expanded at a single point, perform the mapping.
1041 /// This is currently only used for _Pragma implementation, so it is the slow
1042 /// path of the hot getSourceLocation method.  Do not allow it to be inlined.
1043 static LLVM_ATTRIBUTE_NOINLINE SourceLocation GetMappedTokenLoc(
1044     Preprocessor &PP, SourceLocation FileLoc, unsigned CharNo, unsigned TokLen);
1045 static SourceLocation GetMappedTokenLoc(Preprocessor &PP,
1046                                         SourceLocation FileLoc,
1047                                         unsigned CharNo, unsigned TokLen) {
1048   assert(FileLoc.isMacroID() && "Must be a macro expansion");
1049 
1050   // Otherwise, we're lexing "mapped tokens".  This is used for things like
1051   // _Pragma handling.  Combine the expansion location of FileLoc with the
1052   // spelling location.
1053   SourceManager &SM = PP.getSourceManager();
1054 
1055   // Create a new SLoc which is expanded from Expansion(FileLoc) but whose
1056   // characters come from spelling(FileLoc)+Offset.
1057   SourceLocation SpellingLoc = SM.getSpellingLoc(FileLoc);
1058   SpellingLoc = SpellingLoc.getLocWithOffset(CharNo);
1059 
1060   // Figure out the expansion loc range, which is the range covered by the
1061   // original _Pragma(...) sequence.
1062   std::pair<SourceLocation,SourceLocation> II =
1063     SM.getImmediateExpansionRange(FileLoc);
1064 
1065   return SM.createExpansionLoc(SpellingLoc, II.first, II.second, TokLen);
1066 }
1067 
1068 /// getSourceLocation - Return a source location identifier for the specified
1069 /// offset in the current file.
1070 SourceLocation Lexer::getSourceLocation(const char *Loc,
1071                                         unsigned TokLen) const {
1072   assert(Loc >= BufferStart && Loc <= BufferEnd &&
1073          "Location out of range for this buffer!");
1074 
1075   // In the normal case, we're just lexing from a simple file buffer, return
1076   // the file id from FileLoc with the offset specified.
1077   unsigned CharNo = Loc-BufferStart;
1078   if (FileLoc.isFileID())
1079     return FileLoc.getLocWithOffset(CharNo);
1080 
1081   // Otherwise, this is the _Pragma lexer case, which pretends that all of the
1082   // tokens are lexed from where the _Pragma was defined.
1083   assert(PP && "This doesn't work on raw lexers");
1084   return GetMappedTokenLoc(*PP, FileLoc, CharNo, TokLen);
1085 }
1086 
1087 /// Diag - Forwarding function for diagnostics.  This translate a source
1088 /// position in the current buffer into a SourceLocation object for rendering.
1089 DiagnosticBuilder Lexer::Diag(const char *Loc, unsigned DiagID) const {
1090   return PP->Diag(getSourceLocation(Loc), DiagID);
1091 }
1092 
1093 //===----------------------------------------------------------------------===//
1094 // Trigraph and Escaped Newline Handling Code.
1095 //===----------------------------------------------------------------------===//
1096 
1097 /// GetTrigraphCharForLetter - Given a character that occurs after a ?? pair,
1098 /// return the decoded trigraph letter it corresponds to, or '\0' if nothing.
1099 static char GetTrigraphCharForLetter(char Letter) {
1100   switch (Letter) {
1101   default:   return 0;
1102   case '=':  return '#';
1103   case ')':  return ']';
1104   case '(':  return '[';
1105   case '!':  return '|';
1106   case '\'': return '^';
1107   case '>':  return '}';
1108   case '/':  return '\\';
1109   case '<':  return '{';
1110   case '-':  return '~';
1111   }
1112 }
1113 
1114 /// DecodeTrigraphChar - If the specified character is a legal trigraph when
1115 /// prefixed with ??, emit a trigraph warning.  If trigraphs are enabled,
1116 /// return the result character.  Finally, emit a warning about trigraph use
1117 /// whether trigraphs are enabled or not.
1118 static char DecodeTrigraphChar(const char *CP, Lexer *L) {
1119   char Res = GetTrigraphCharForLetter(*CP);
1120   if (!Res || !L) return Res;
1121 
1122   if (!L->getLangOpts().Trigraphs) {
1123     if (!L->isLexingRawMode())
1124       L->Diag(CP-2, diag::trigraph_ignored);
1125     return 0;
1126   }
1127 
1128   if (!L->isLexingRawMode())
1129     L->Diag(CP-2, diag::trigraph_converted) << StringRef(&Res, 1);
1130   return Res;
1131 }
1132 
1133 /// getEscapedNewLineSize - Return the size of the specified escaped newline,
1134 /// or 0 if it is not an escaped newline. P[-1] is known to be a "\" or a
1135 /// trigraph equivalent on entry to this function.
1136 unsigned Lexer::getEscapedNewLineSize(const char *Ptr) {
1137   unsigned Size = 0;
1138   while (isWhitespace(Ptr[Size])) {
1139     ++Size;
1140 
1141     if (Ptr[Size-1] != '\n' && Ptr[Size-1] != '\r')
1142       continue;
1143 
1144     // If this is a \r\n or \n\r, skip the other half.
1145     if ((Ptr[Size] == '\r' || Ptr[Size] == '\n') &&
1146         Ptr[Size-1] != Ptr[Size])
1147       ++Size;
1148 
1149     return Size;
1150   }
1151 
1152   // Not an escaped newline, must be a \t or something else.
1153   return 0;
1154 }
1155 
1156 /// SkipEscapedNewLines - If P points to an escaped newline (or a series of
1157 /// them), skip over them and return the first non-escaped-newline found,
1158 /// otherwise return P.
1159 const char *Lexer::SkipEscapedNewLines(const char *P) {
1160   while (1) {
1161     const char *AfterEscape;
1162     if (*P == '\\') {
1163       AfterEscape = P+1;
1164     } else if (*P == '?') {
1165       // If not a trigraph for escape, bail out.
1166       if (P[1] != '?' || P[2] != '/')
1167         return P;
1168       AfterEscape = P+3;
1169     } else {
1170       return P;
1171     }
1172 
1173     unsigned NewLineSize = Lexer::getEscapedNewLineSize(AfterEscape);
1174     if (NewLineSize == 0) return P;
1175     P = AfterEscape+NewLineSize;
1176   }
1177 }
1178 
1179 /// \brief Checks that the given token is the first token that occurs after the
1180 /// given location (this excludes comments and whitespace). Returns the location
1181 /// immediately after the specified token. If the token is not found or the
1182 /// location is inside a macro, the returned source location will be invalid.
1183 SourceLocation Lexer::findLocationAfterToken(SourceLocation Loc,
1184                                         tok::TokenKind TKind,
1185                                         const SourceManager &SM,
1186                                         const LangOptions &LangOpts,
1187                                         bool SkipTrailingWhitespaceAndNewLine) {
1188   if (Loc.isMacroID()) {
1189     if (!Lexer::isAtEndOfMacroExpansion(Loc, SM, LangOpts, &Loc))
1190       return SourceLocation();
1191   }
1192   Loc = Lexer::getLocForEndOfToken(Loc, 0, SM, LangOpts);
1193 
1194   // Break down the source location.
1195   std::pair<FileID, unsigned> LocInfo = SM.getDecomposedLoc(Loc);
1196 
1197   // Try to load the file buffer.
1198   bool InvalidTemp = false;
1199   StringRef File = SM.getBufferData(LocInfo.first, &InvalidTemp);
1200   if (InvalidTemp)
1201     return SourceLocation();
1202 
1203   const char *TokenBegin = File.data() + LocInfo.second;
1204 
1205   // Lex from the start of the given location.
1206   Lexer lexer(SM.getLocForStartOfFile(LocInfo.first), LangOpts, File.begin(),
1207                                       TokenBegin, File.end());
1208   // Find the token.
1209   Token Tok;
1210   lexer.LexFromRawLexer(Tok);
1211   if (Tok.isNot(TKind))
1212     return SourceLocation();
1213   SourceLocation TokenLoc = Tok.getLocation();
1214 
1215   // Calculate how much whitespace needs to be skipped if any.
1216   unsigned NumWhitespaceChars = 0;
1217   if (SkipTrailingWhitespaceAndNewLine) {
1218     const char *TokenEnd = SM.getCharacterData(TokenLoc) +
1219                            Tok.getLength();
1220     unsigned char C = *TokenEnd;
1221     while (isHorizontalWhitespace(C)) {
1222       C = *(++TokenEnd);
1223       NumWhitespaceChars++;
1224     }
1225 
1226     // Skip \r, \n, \r\n, or \n\r
1227     if (C == '\n' || C == '\r') {
1228       char PrevC = C;
1229       C = *(++TokenEnd);
1230       NumWhitespaceChars++;
1231       if ((C == '\n' || C == '\r') && C != PrevC)
1232         NumWhitespaceChars++;
1233     }
1234   }
1235 
1236   return TokenLoc.getLocWithOffset(Tok.getLength() + NumWhitespaceChars);
1237 }
1238 
1239 /// getCharAndSizeSlow - Peek a single 'character' from the specified buffer,
1240 /// get its size, and return it.  This is tricky in several cases:
1241 ///   1. If currently at the start of a trigraph, we warn about the trigraph,
1242 ///      then either return the trigraph (skipping 3 chars) or the '?',
1243 ///      depending on whether trigraphs are enabled or not.
1244 ///   2. If this is an escaped newline (potentially with whitespace between
1245 ///      the backslash and newline), implicitly skip the newline and return
1246 ///      the char after it.
1247 ///
1248 /// This handles the slow/uncommon case of the getCharAndSize method.  Here we
1249 /// know that we can accumulate into Size, and that we have already incremented
1250 /// Ptr by Size bytes.
1251 ///
1252 /// NOTE: When this method is updated, getCharAndSizeSlowNoWarn (below) should
1253 /// be updated to match.
1254 ///
1255 char Lexer::getCharAndSizeSlow(const char *Ptr, unsigned &Size,
1256                                Token *Tok) {
1257   // If we have a slash, look for an escaped newline.
1258   if (Ptr[0] == '\\') {
1259     ++Size;
1260     ++Ptr;
1261 Slash:
1262     // Common case, backslash-char where the char is not whitespace.
1263     if (!isWhitespace(Ptr[0])) return '\\';
1264 
1265     // See if we have optional whitespace characters between the slash and
1266     // newline.
1267     if (unsigned EscapedNewLineSize = getEscapedNewLineSize(Ptr)) {
1268       // Remember that this token needs to be cleaned.
1269       if (Tok) Tok->setFlag(Token::NeedsCleaning);
1270 
1271       // Warn if there was whitespace between the backslash and newline.
1272       if (Ptr[0] != '\n' && Ptr[0] != '\r' && Tok && !isLexingRawMode())
1273         Diag(Ptr, diag::backslash_newline_space);
1274 
1275       // Found backslash<whitespace><newline>.  Parse the char after it.
1276       Size += EscapedNewLineSize;
1277       Ptr  += EscapedNewLineSize;
1278 
1279       // If the char that we finally got was a \n, then we must have had
1280       // something like \<newline><newline>.  We don't want to consume the
1281       // second newline.
1282       if (*Ptr == '\n' || *Ptr == '\r' || *Ptr == '\0')
1283         return ' ';
1284 
1285       // Use slow version to accumulate a correct size field.
1286       return getCharAndSizeSlow(Ptr, Size, Tok);
1287     }
1288 
1289     // Otherwise, this is not an escaped newline, just return the slash.
1290     return '\\';
1291   }
1292 
1293   // If this is a trigraph, process it.
1294   if (Ptr[0] == '?' && Ptr[1] == '?') {
1295     // If this is actually a legal trigraph (not something like "??x"), emit
1296     // a trigraph warning.  If so, and if trigraphs are enabled, return it.
1297     if (char C = DecodeTrigraphChar(Ptr+2, Tok ? this : nullptr)) {
1298       // Remember that this token needs to be cleaned.
1299       if (Tok) Tok->setFlag(Token::NeedsCleaning);
1300 
1301       Ptr += 3;
1302       Size += 3;
1303       if (C == '\\') goto Slash;
1304       return C;
1305     }
1306   }
1307 
1308   // If this is neither, return a single character.
1309   ++Size;
1310   return *Ptr;
1311 }
1312 
1313 
1314 /// getCharAndSizeSlowNoWarn - Handle the slow/uncommon case of the
1315 /// getCharAndSizeNoWarn method.  Here we know that we can accumulate into Size,
1316 /// and that we have already incremented Ptr by Size bytes.
1317 ///
1318 /// NOTE: When this method is updated, getCharAndSizeSlow (above) should
1319 /// be updated to match.
1320 char Lexer::getCharAndSizeSlowNoWarn(const char *Ptr, unsigned &Size,
1321                                      const LangOptions &LangOpts) {
1322   // If we have a slash, look for an escaped newline.
1323   if (Ptr[0] == '\\') {
1324     ++Size;
1325     ++Ptr;
1326 Slash:
1327     // Common case, backslash-char where the char is not whitespace.
1328     if (!isWhitespace(Ptr[0])) return '\\';
1329 
1330     // See if we have optional whitespace characters followed by a newline.
1331     if (unsigned EscapedNewLineSize = getEscapedNewLineSize(Ptr)) {
1332       // Found backslash<whitespace><newline>.  Parse the char after it.
1333       Size += EscapedNewLineSize;
1334       Ptr  += EscapedNewLineSize;
1335 
1336       // If the char that we finally got was a \n, then we must have had
1337       // something like \<newline><newline>.  We don't want to consume the
1338       // second newline.
1339       if (*Ptr == '\n' || *Ptr == '\r' || *Ptr == '\0')
1340         return ' ';
1341 
1342       // Use slow version to accumulate a correct size field.
1343       return getCharAndSizeSlowNoWarn(Ptr, Size, LangOpts);
1344     }
1345 
1346     // Otherwise, this is not an escaped newline, just return the slash.
1347     return '\\';
1348   }
1349 
1350   // If this is a trigraph, process it.
1351   if (LangOpts.Trigraphs && Ptr[0] == '?' && Ptr[1] == '?') {
1352     // If this is actually a legal trigraph (not something like "??x"), return
1353     // it.
1354     if (char C = GetTrigraphCharForLetter(Ptr[2])) {
1355       Ptr += 3;
1356       Size += 3;
1357       if (C == '\\') goto Slash;
1358       return C;
1359     }
1360   }
1361 
1362   // If this is neither, return a single character.
1363   ++Size;
1364   return *Ptr;
1365 }
1366 
1367 //===----------------------------------------------------------------------===//
1368 // Helper methods for lexing.
1369 //===----------------------------------------------------------------------===//
1370 
1371 /// \brief Routine that indiscriminately skips bytes in the source file.
1372 void Lexer::SkipBytes(unsigned Bytes, bool StartOfLine) {
1373   BufferPtr += Bytes;
1374   if (BufferPtr > BufferEnd)
1375     BufferPtr = BufferEnd;
1376   // FIXME: What exactly does the StartOfLine bit mean?  There are two
1377   // possible meanings for the "start" of the line: the first token on the
1378   // unexpanded line, or the first token on the expanded line.
1379   IsAtStartOfLine = StartOfLine;
1380   IsAtPhysicalStartOfLine = StartOfLine;
1381 }
1382 
1383 static bool isAllowedIDChar(uint32_t C, const LangOptions &LangOpts) {
1384   if (LangOpts.AsmPreprocessor) {
1385     return false;
1386   } else if (LangOpts.CPlusPlus11 || LangOpts.C11) {
1387     static const llvm::sys::UnicodeCharSet C11AllowedIDChars(
1388         C11AllowedIDCharRanges);
1389     return C11AllowedIDChars.contains(C);
1390   } else if (LangOpts.CPlusPlus) {
1391     static const llvm::sys::UnicodeCharSet CXX03AllowedIDChars(
1392         CXX03AllowedIDCharRanges);
1393     return CXX03AllowedIDChars.contains(C);
1394   } else {
1395     static const llvm::sys::UnicodeCharSet C99AllowedIDChars(
1396         C99AllowedIDCharRanges);
1397     return C99AllowedIDChars.contains(C);
1398   }
1399 }
1400 
1401 static bool isAllowedInitiallyIDChar(uint32_t C, const LangOptions &LangOpts) {
1402   assert(isAllowedIDChar(C, LangOpts));
1403   if (LangOpts.AsmPreprocessor) {
1404     return false;
1405   } else if (LangOpts.CPlusPlus11 || LangOpts.C11) {
1406     static const llvm::sys::UnicodeCharSet C11DisallowedInitialIDChars(
1407         C11DisallowedInitialIDCharRanges);
1408     return !C11DisallowedInitialIDChars.contains(C);
1409   } else if (LangOpts.CPlusPlus) {
1410     return true;
1411   } else {
1412     static const llvm::sys::UnicodeCharSet C99DisallowedInitialIDChars(
1413         C99DisallowedInitialIDCharRanges);
1414     return !C99DisallowedInitialIDChars.contains(C);
1415   }
1416 }
1417 
1418 static inline CharSourceRange makeCharRange(Lexer &L, const char *Begin,
1419                                             const char *End) {
1420   return CharSourceRange::getCharRange(L.getSourceLocation(Begin),
1421                                        L.getSourceLocation(End));
1422 }
1423 
1424 static void maybeDiagnoseIDCharCompat(DiagnosticsEngine &Diags, uint32_t C,
1425                                       CharSourceRange Range, bool IsFirst) {
1426   // Check C99 compatibility.
1427   if (!Diags.isIgnored(diag::warn_c99_compat_unicode_id, Range.getBegin())) {
1428     enum {
1429       CannotAppearInIdentifier = 0,
1430       CannotStartIdentifier
1431     };
1432 
1433     static const llvm::sys::UnicodeCharSet C99AllowedIDChars(
1434         C99AllowedIDCharRanges);
1435     static const llvm::sys::UnicodeCharSet C99DisallowedInitialIDChars(
1436         C99DisallowedInitialIDCharRanges);
1437     if (!C99AllowedIDChars.contains(C)) {
1438       Diags.Report(Range.getBegin(), diag::warn_c99_compat_unicode_id)
1439         << Range
1440         << CannotAppearInIdentifier;
1441     } else if (IsFirst && C99DisallowedInitialIDChars.contains(C)) {
1442       Diags.Report(Range.getBegin(), diag::warn_c99_compat_unicode_id)
1443         << Range
1444         << CannotStartIdentifier;
1445     }
1446   }
1447 
1448   // Check C++98 compatibility.
1449   if (!Diags.isIgnored(diag::warn_cxx98_compat_unicode_id, Range.getBegin())) {
1450     static const llvm::sys::UnicodeCharSet CXX03AllowedIDChars(
1451         CXX03AllowedIDCharRanges);
1452     if (!CXX03AllowedIDChars.contains(C)) {
1453       Diags.Report(Range.getBegin(), diag::warn_cxx98_compat_unicode_id)
1454         << Range;
1455     }
1456   }
1457 }
1458 
1459 bool Lexer::tryConsumeIdentifierUCN(const char *&CurPtr, unsigned Size,
1460                                     Token &Result) {
1461   const char *UCNPtr = CurPtr + Size;
1462   uint32_t CodePoint = tryReadUCN(UCNPtr, CurPtr, /*Token=*/nullptr);
1463   if (CodePoint == 0 || !isAllowedIDChar(CodePoint, LangOpts))
1464     return false;
1465 
1466   if (!isLexingRawMode())
1467     maybeDiagnoseIDCharCompat(PP->getDiagnostics(), CodePoint,
1468                               makeCharRange(*this, CurPtr, UCNPtr),
1469                               /*IsFirst=*/false);
1470 
1471   Result.setFlag(Token::HasUCN);
1472   if ((UCNPtr - CurPtr ==  6 && CurPtr[1] == 'u') ||
1473       (UCNPtr - CurPtr == 10 && CurPtr[1] == 'U'))
1474     CurPtr = UCNPtr;
1475   else
1476     while (CurPtr != UCNPtr)
1477       (void)getAndAdvanceChar(CurPtr, Result);
1478   return true;
1479 }
1480 
1481 bool Lexer::tryConsumeIdentifierUTF8Char(const char *&CurPtr) {
1482   const char *UnicodePtr = CurPtr;
1483   UTF32 CodePoint;
1484   ConversionResult Result =
1485       llvm::convertUTF8Sequence((const UTF8 **)&UnicodePtr,
1486                                 (const UTF8 *)BufferEnd,
1487                                 &CodePoint,
1488                                 strictConversion);
1489   if (Result != conversionOK ||
1490       !isAllowedIDChar(static_cast<uint32_t>(CodePoint), LangOpts))
1491     return false;
1492 
1493   if (!isLexingRawMode())
1494     maybeDiagnoseIDCharCompat(PP->getDiagnostics(), CodePoint,
1495                               makeCharRange(*this, CurPtr, UnicodePtr),
1496                               /*IsFirst=*/false);
1497 
1498   CurPtr = UnicodePtr;
1499   return true;
1500 }
1501 
1502 bool Lexer::LexIdentifier(Token &Result, const char *CurPtr) {
1503   // Match [_A-Za-z0-9]*, we have already matched [_A-Za-z$]
1504   unsigned Size;
1505   unsigned char C = *CurPtr++;
1506   while (isIdentifierBody(C))
1507     C = *CurPtr++;
1508 
1509   --CurPtr;   // Back up over the skipped character.
1510 
1511   // Fast path, no $,\,? in identifier found.  '\' might be an escaped newline
1512   // or UCN, and ? might be a trigraph for '\', an escaped newline or UCN.
1513   //
1514   // TODO: Could merge these checks into an InfoTable flag to make the
1515   // comparison cheaper
1516   if (isASCII(C) && C != '\\' && C != '?' &&
1517       (C != '$' || !LangOpts.DollarIdents)) {
1518 FinishIdentifier:
1519     const char *IdStart = BufferPtr;
1520     FormTokenWithChars(Result, CurPtr, tok::raw_identifier);
1521     Result.setRawIdentifierData(IdStart);
1522 
1523     // If we are in raw mode, return this identifier raw.  There is no need to
1524     // look up identifier information or attempt to macro expand it.
1525     if (LexingRawMode)
1526       return true;
1527 
1528     // Fill in Result.IdentifierInfo and update the token kind,
1529     // looking up the identifier in the identifier table.
1530     IdentifierInfo *II = PP->LookUpIdentifierInfo(Result);
1531 
1532     // Finally, now that we know we have an identifier, pass this off to the
1533     // preprocessor, which may macro expand it or something.
1534     if (II->isHandleIdentifierCase())
1535       return PP->HandleIdentifier(Result);
1536 
1537     return true;
1538   }
1539 
1540   // Otherwise, $,\,? in identifier found.  Enter slower path.
1541 
1542   C = getCharAndSize(CurPtr, Size);
1543   while (1) {
1544     if (C == '$') {
1545       // If we hit a $ and they are not supported in identifiers, we are done.
1546       if (!LangOpts.DollarIdents) goto FinishIdentifier;
1547 
1548       // Otherwise, emit a diagnostic and continue.
1549       if (!isLexingRawMode())
1550         Diag(CurPtr, diag::ext_dollar_in_identifier);
1551       CurPtr = ConsumeChar(CurPtr, Size, Result);
1552       C = getCharAndSize(CurPtr, Size);
1553       continue;
1554 
1555     } else if (C == '\\' && tryConsumeIdentifierUCN(CurPtr, Size, Result)) {
1556       C = getCharAndSize(CurPtr, Size);
1557       continue;
1558     } else if (!isASCII(C) && tryConsumeIdentifierUTF8Char(CurPtr)) {
1559       C = getCharAndSize(CurPtr, Size);
1560       continue;
1561     } else if (!isIdentifierBody(C)) {
1562       goto FinishIdentifier;
1563     }
1564 
1565     // Otherwise, this character is good, consume it.
1566     CurPtr = ConsumeChar(CurPtr, Size, Result);
1567 
1568     C = getCharAndSize(CurPtr, Size);
1569     while (isIdentifierBody(C)) {
1570       CurPtr = ConsumeChar(CurPtr, Size, Result);
1571       C = getCharAndSize(CurPtr, Size);
1572     }
1573   }
1574 }
1575 
1576 /// isHexaLiteral - Return true if Start points to a hex constant.
1577 /// in microsoft mode (where this is supposed to be several different tokens).
1578 bool Lexer::isHexaLiteral(const char *Start, const LangOptions &LangOpts) {
1579   unsigned Size;
1580   char C1 = Lexer::getCharAndSizeNoWarn(Start, Size, LangOpts);
1581   if (C1 != '0')
1582     return false;
1583   char C2 = Lexer::getCharAndSizeNoWarn(Start + Size, Size, LangOpts);
1584   return (C2 == 'x' || C2 == 'X');
1585 }
1586 
1587 /// LexNumericConstant - Lex the remainder of a integer or floating point
1588 /// constant. From[-1] is the first character lexed.  Return the end of the
1589 /// constant.
1590 bool Lexer::LexNumericConstant(Token &Result, const char *CurPtr) {
1591   unsigned Size;
1592   char C = getCharAndSize(CurPtr, Size);
1593   char PrevCh = 0;
1594   while (isPreprocessingNumberBody(C)) {
1595     CurPtr = ConsumeChar(CurPtr, Size, Result);
1596     PrevCh = C;
1597     C = getCharAndSize(CurPtr, Size);
1598   }
1599 
1600   // If we fell out, check for a sign, due to 1e+12.  If we have one, continue.
1601   if ((C == '-' || C == '+') && (PrevCh == 'E' || PrevCh == 'e')) {
1602     // If we are in Microsoft mode, don't continue if the constant is hex.
1603     // For example, MSVC will accept the following as 3 tokens: 0x1234567e+1
1604     if (!LangOpts.MicrosoftExt || !isHexaLiteral(BufferPtr, LangOpts))
1605       return LexNumericConstant(Result, ConsumeChar(CurPtr, Size, Result));
1606   }
1607 
1608   // If we have a hex FP constant, continue.
1609   if ((C == '-' || C == '+') && (PrevCh == 'P' || PrevCh == 'p')) {
1610     // Outside C99, we accept hexadecimal floating point numbers as a
1611     // not-quite-conforming extension. Only do so if this looks like it's
1612     // actually meant to be a hexfloat, and not if it has a ud-suffix.
1613     bool IsHexFloat = true;
1614     if (!LangOpts.C99) {
1615       if (!isHexaLiteral(BufferPtr, LangOpts))
1616         IsHexFloat = false;
1617       else if (std::find(BufferPtr, CurPtr, '_') != CurPtr)
1618         IsHexFloat = false;
1619     }
1620     if (IsHexFloat)
1621       return LexNumericConstant(Result, ConsumeChar(CurPtr, Size, Result));
1622   }
1623 
1624   // If we have a digit separator, continue.
1625   if (C == '\'' && getLangOpts().CPlusPlus14) {
1626     unsigned NextSize;
1627     char Next = getCharAndSizeNoWarn(CurPtr + Size, NextSize, getLangOpts());
1628     if (isIdentifierBody(Next)) {
1629       if (!isLexingRawMode())
1630         Diag(CurPtr, diag::warn_cxx11_compat_digit_separator);
1631       CurPtr = ConsumeChar(CurPtr, Size, Result);
1632       CurPtr = ConsumeChar(CurPtr, NextSize, Result);
1633       return LexNumericConstant(Result, CurPtr);
1634     }
1635   }
1636 
1637   // If we have a UCN or UTF-8 character (perhaps in a ud-suffix), continue.
1638   if (C == '\\' && tryConsumeIdentifierUCN(CurPtr, Size, Result))
1639     return LexNumericConstant(Result, CurPtr);
1640   if (!isASCII(C) && tryConsumeIdentifierUTF8Char(CurPtr))
1641     return LexNumericConstant(Result, CurPtr);
1642 
1643   // Update the location of token as well as BufferPtr.
1644   const char *TokStart = BufferPtr;
1645   FormTokenWithChars(Result, CurPtr, tok::numeric_constant);
1646   Result.setLiteralData(TokStart);
1647   return true;
1648 }
1649 
1650 /// LexUDSuffix - Lex the ud-suffix production for user-defined literal suffixes
1651 /// in C++11, or warn on a ud-suffix in C++98.
1652 const char *Lexer::LexUDSuffix(Token &Result, const char *CurPtr,
1653                                bool IsStringLiteral) {
1654   assert(getLangOpts().CPlusPlus);
1655 
1656   // Maximally munch an identifier.
1657   unsigned Size;
1658   char C = getCharAndSize(CurPtr, Size);
1659   bool Consumed = false;
1660 
1661   if (!isIdentifierHead(C)) {
1662     if (C == '\\' && tryConsumeIdentifierUCN(CurPtr, Size, Result))
1663       Consumed = true;
1664     else if (!isASCII(C) && tryConsumeIdentifierUTF8Char(CurPtr))
1665       Consumed = true;
1666     else
1667       return CurPtr;
1668   }
1669 
1670   if (!getLangOpts().CPlusPlus11) {
1671     if (!isLexingRawMode())
1672       Diag(CurPtr,
1673            C == '_' ? diag::warn_cxx11_compat_user_defined_literal
1674                     : diag::warn_cxx11_compat_reserved_user_defined_literal)
1675         << FixItHint::CreateInsertion(getSourceLocation(CurPtr), " ");
1676     return CurPtr;
1677   }
1678 
1679   // C++11 [lex.ext]p10, [usrlit.suffix]p1: A program containing a ud-suffix
1680   // that does not start with an underscore is ill-formed. As a conforming
1681   // extension, we treat all such suffixes as if they had whitespace before
1682   // them. We assume a suffix beginning with a UCN or UTF-8 character is more
1683   // likely to be a ud-suffix than a macro, however, and accept that.
1684   if (!Consumed) {
1685     bool IsUDSuffix = false;
1686     if (C == '_')
1687       IsUDSuffix = true;
1688     else if (IsStringLiteral && getLangOpts().CPlusPlus14) {
1689       // In C++1y, we need to look ahead a few characters to see if this is a
1690       // valid suffix for a string literal or a numeric literal (this could be
1691       // the 'operator""if' defining a numeric literal operator).
1692       const unsigned MaxStandardSuffixLength = 3;
1693       char Buffer[MaxStandardSuffixLength] = { C };
1694       unsigned Consumed = Size;
1695       unsigned Chars = 1;
1696       while (true) {
1697         unsigned NextSize;
1698         char Next = getCharAndSizeNoWarn(CurPtr + Consumed, NextSize,
1699                                          getLangOpts());
1700         if (!isIdentifierBody(Next)) {
1701           // End of suffix. Check whether this is on the whitelist.
1702           IsUDSuffix = (Chars == 1 && Buffer[0] == 's') ||
1703                        NumericLiteralParser::isValidUDSuffix(
1704                            getLangOpts(), StringRef(Buffer, Chars));
1705           break;
1706         }
1707 
1708         if (Chars == MaxStandardSuffixLength)
1709           // Too long: can't be a standard suffix.
1710           break;
1711 
1712         Buffer[Chars++] = Next;
1713         Consumed += NextSize;
1714       }
1715     }
1716 
1717     if (!IsUDSuffix) {
1718       if (!isLexingRawMode())
1719         Diag(CurPtr, getLangOpts().MSVCCompat
1720                          ? diag::ext_ms_reserved_user_defined_literal
1721                          : diag::ext_reserved_user_defined_literal)
1722           << FixItHint::CreateInsertion(getSourceLocation(CurPtr), " ");
1723       return CurPtr;
1724     }
1725 
1726     CurPtr = ConsumeChar(CurPtr, Size, Result);
1727   }
1728 
1729   Result.setFlag(Token::HasUDSuffix);
1730   while (true) {
1731     C = getCharAndSize(CurPtr, Size);
1732     if (isIdentifierBody(C)) { CurPtr = ConsumeChar(CurPtr, Size, Result); }
1733     else if (C == '\\' && tryConsumeIdentifierUCN(CurPtr, Size, Result)) {}
1734     else if (!isASCII(C) && tryConsumeIdentifierUTF8Char(CurPtr)) {}
1735     else break;
1736   }
1737 
1738   return CurPtr;
1739 }
1740 
1741 /// LexStringLiteral - Lex the remainder of a string literal, after having lexed
1742 /// either " or L" or u8" or u" or U".
1743 bool Lexer::LexStringLiteral(Token &Result, const char *CurPtr,
1744                              tok::TokenKind Kind) {
1745   // Does this string contain the \0 character?
1746   const char *NulCharacter = nullptr;
1747 
1748   if (!isLexingRawMode() &&
1749       (Kind == tok::utf8_string_literal ||
1750        Kind == tok::utf16_string_literal ||
1751        Kind == tok::utf32_string_literal))
1752     Diag(BufferPtr, getLangOpts().CPlusPlus
1753            ? diag::warn_cxx98_compat_unicode_literal
1754            : diag::warn_c99_compat_unicode_literal);
1755 
1756   char C = getAndAdvanceChar(CurPtr, Result);
1757   while (C != '"') {
1758     // Skip escaped characters.  Escaped newlines will already be processed by
1759     // getAndAdvanceChar.
1760     if (C == '\\')
1761       C = getAndAdvanceChar(CurPtr, Result);
1762 
1763     if (C == '\n' || C == '\r' ||             // Newline.
1764         (C == 0 && CurPtr-1 == BufferEnd)) {  // End of file.
1765       if (!isLexingRawMode() && !LangOpts.AsmPreprocessor)
1766         Diag(BufferPtr, diag::ext_unterminated_char_or_string) << 1;
1767       FormTokenWithChars(Result, CurPtr-1, tok::unknown);
1768       return true;
1769     }
1770 
1771     if (C == 0) {
1772       if (isCodeCompletionPoint(CurPtr-1)) {
1773         PP->CodeCompleteNaturalLanguage();
1774         FormTokenWithChars(Result, CurPtr-1, tok::unknown);
1775         cutOffLexing();
1776         return true;
1777       }
1778 
1779       NulCharacter = CurPtr-1;
1780     }
1781     C = getAndAdvanceChar(CurPtr, Result);
1782   }
1783 
1784   // If we are in C++11, lex the optional ud-suffix.
1785   if (getLangOpts().CPlusPlus)
1786     CurPtr = LexUDSuffix(Result, CurPtr, true);
1787 
1788   // If a nul character existed in the string, warn about it.
1789   if (NulCharacter && !isLexingRawMode())
1790     Diag(NulCharacter, diag::null_in_char_or_string) << 1;
1791 
1792   // Update the location of the token as well as the BufferPtr instance var.
1793   const char *TokStart = BufferPtr;
1794   FormTokenWithChars(Result, CurPtr, Kind);
1795   Result.setLiteralData(TokStart);
1796   return true;
1797 }
1798 
1799 /// LexRawStringLiteral - Lex the remainder of a raw string literal, after
1800 /// having lexed R", LR", u8R", uR", or UR".
1801 bool Lexer::LexRawStringLiteral(Token &Result, const char *CurPtr,
1802                                 tok::TokenKind Kind) {
1803   // This function doesn't use getAndAdvanceChar because C++0x [lex.pptoken]p3:
1804   //  Between the initial and final double quote characters of the raw string,
1805   //  any transformations performed in phases 1 and 2 (trigraphs,
1806   //  universal-character-names, and line splicing) are reverted.
1807 
1808   if (!isLexingRawMode())
1809     Diag(BufferPtr, diag::warn_cxx98_compat_raw_string_literal);
1810 
1811   unsigned PrefixLen = 0;
1812 
1813   while (PrefixLen != 16 && isRawStringDelimBody(CurPtr[PrefixLen]))
1814     ++PrefixLen;
1815 
1816   // If the last character was not a '(', then we didn't lex a valid delimiter.
1817   if (CurPtr[PrefixLen] != '(') {
1818     if (!isLexingRawMode()) {
1819       const char *PrefixEnd = &CurPtr[PrefixLen];
1820       if (PrefixLen == 16) {
1821         Diag(PrefixEnd, diag::err_raw_delim_too_long);
1822       } else {
1823         Diag(PrefixEnd, diag::err_invalid_char_raw_delim)
1824           << StringRef(PrefixEnd, 1);
1825       }
1826     }
1827 
1828     // Search for the next '"' in hopes of salvaging the lexer. Unfortunately,
1829     // it's possible the '"' was intended to be part of the raw string, but
1830     // there's not much we can do about that.
1831     while (1) {
1832       char C = *CurPtr++;
1833 
1834       if (C == '"')
1835         break;
1836       if (C == 0 && CurPtr-1 == BufferEnd) {
1837         --CurPtr;
1838         break;
1839       }
1840     }
1841 
1842     FormTokenWithChars(Result, CurPtr, tok::unknown);
1843     return true;
1844   }
1845 
1846   // Save prefix and move CurPtr past it
1847   const char *Prefix = CurPtr;
1848   CurPtr += PrefixLen + 1; // skip over prefix and '('
1849 
1850   while (1) {
1851     char C = *CurPtr++;
1852 
1853     if (C == ')') {
1854       // Check for prefix match and closing quote.
1855       if (strncmp(CurPtr, Prefix, PrefixLen) == 0 && CurPtr[PrefixLen] == '"') {
1856         CurPtr += PrefixLen + 1; // skip over prefix and '"'
1857         break;
1858       }
1859     } else if (C == 0 && CurPtr-1 == BufferEnd) { // End of file.
1860       if (!isLexingRawMode())
1861         Diag(BufferPtr, diag::err_unterminated_raw_string)
1862           << StringRef(Prefix, PrefixLen);
1863       FormTokenWithChars(Result, CurPtr-1, tok::unknown);
1864       return true;
1865     }
1866   }
1867 
1868   // If we are in C++11, lex the optional ud-suffix.
1869   if (getLangOpts().CPlusPlus)
1870     CurPtr = LexUDSuffix(Result, CurPtr, true);
1871 
1872   // Update the location of token as well as BufferPtr.
1873   const char *TokStart = BufferPtr;
1874   FormTokenWithChars(Result, CurPtr, Kind);
1875   Result.setLiteralData(TokStart);
1876   return true;
1877 }
1878 
1879 /// LexAngledStringLiteral - Lex the remainder of an angled string literal,
1880 /// after having lexed the '<' character.  This is used for #include filenames.
1881 bool Lexer::LexAngledStringLiteral(Token &Result, const char *CurPtr) {
1882   // Does this string contain the \0 character?
1883   const char *NulCharacter = nullptr;
1884   const char *AfterLessPos = CurPtr;
1885   char C = getAndAdvanceChar(CurPtr, Result);
1886   while (C != '>') {
1887     // Skip escaped characters.
1888     if (C == '\\' && CurPtr < BufferEnd) {
1889       // Skip the escaped character.
1890       getAndAdvanceChar(CurPtr, Result);
1891     } else if (C == '\n' || C == '\r' ||             // Newline.
1892                (C == 0 && (CurPtr-1 == BufferEnd ||  // End of file.
1893                            isCodeCompletionPoint(CurPtr-1)))) {
1894       // If the filename is unterminated, then it must just be a lone <
1895       // character.  Return this as such.
1896       FormTokenWithChars(Result, AfterLessPos, tok::less);
1897       return true;
1898     } else if (C == 0) {
1899       NulCharacter = CurPtr-1;
1900     }
1901     C = getAndAdvanceChar(CurPtr, Result);
1902   }
1903 
1904   // If a nul character existed in the string, warn about it.
1905   if (NulCharacter && !isLexingRawMode())
1906     Diag(NulCharacter, diag::null_in_char_or_string) << 1;
1907 
1908   // Update the location of token as well as BufferPtr.
1909   const char *TokStart = BufferPtr;
1910   FormTokenWithChars(Result, CurPtr, tok::angle_string_literal);
1911   Result.setLiteralData(TokStart);
1912   return true;
1913 }
1914 
1915 
1916 /// LexCharConstant - Lex the remainder of a character constant, after having
1917 /// lexed either ' or L' or u8' or u' or U'.
1918 bool Lexer::LexCharConstant(Token &Result, const char *CurPtr,
1919                             tok::TokenKind Kind) {
1920   // Does this character contain the \0 character?
1921   const char *NulCharacter = nullptr;
1922 
1923   if (!isLexingRawMode()) {
1924     if (Kind == tok::utf16_char_constant || Kind == tok::utf32_char_constant)
1925       Diag(BufferPtr, getLangOpts().CPlusPlus
1926                           ? diag::warn_cxx98_compat_unicode_literal
1927                           : diag::warn_c99_compat_unicode_literal);
1928     else if (Kind == tok::utf8_char_constant)
1929       Diag(BufferPtr, diag::warn_cxx14_compat_u8_character_literal);
1930   }
1931 
1932   char C = getAndAdvanceChar(CurPtr, Result);
1933   if (C == '\'') {
1934     if (!isLexingRawMode() && !LangOpts.AsmPreprocessor)
1935       Diag(BufferPtr, diag::ext_empty_character);
1936     FormTokenWithChars(Result, CurPtr, tok::unknown);
1937     return true;
1938   }
1939 
1940   while (C != '\'') {
1941     // Skip escaped characters.
1942     if (C == '\\')
1943       C = getAndAdvanceChar(CurPtr, Result);
1944 
1945     if (C == '\n' || C == '\r' ||             // Newline.
1946         (C == 0 && CurPtr-1 == BufferEnd)) {  // End of file.
1947       if (!isLexingRawMode() && !LangOpts.AsmPreprocessor)
1948         Diag(BufferPtr, diag::ext_unterminated_char_or_string) << 0;
1949       FormTokenWithChars(Result, CurPtr-1, tok::unknown);
1950       return true;
1951     }
1952 
1953     if (C == 0) {
1954       if (isCodeCompletionPoint(CurPtr-1)) {
1955         PP->CodeCompleteNaturalLanguage();
1956         FormTokenWithChars(Result, CurPtr-1, tok::unknown);
1957         cutOffLexing();
1958         return true;
1959       }
1960 
1961       NulCharacter = CurPtr-1;
1962     }
1963     C = getAndAdvanceChar(CurPtr, Result);
1964   }
1965 
1966   // If we are in C++11, lex the optional ud-suffix.
1967   if (getLangOpts().CPlusPlus)
1968     CurPtr = LexUDSuffix(Result, CurPtr, false);
1969 
1970   // If a nul character existed in the character, warn about it.
1971   if (NulCharacter && !isLexingRawMode())
1972     Diag(NulCharacter, diag::null_in_char_or_string) << 0;
1973 
1974   // Update the location of token as well as BufferPtr.
1975   const char *TokStart = BufferPtr;
1976   FormTokenWithChars(Result, CurPtr, Kind);
1977   Result.setLiteralData(TokStart);
1978   return true;
1979 }
1980 
1981 /// SkipWhitespace - Efficiently skip over a series of whitespace characters.
1982 /// Update BufferPtr to point to the next non-whitespace character and return.
1983 ///
1984 /// This method forms a token and returns true if KeepWhitespaceMode is enabled.
1985 ///
1986 bool Lexer::SkipWhitespace(Token &Result, const char *CurPtr,
1987                            bool &TokAtPhysicalStartOfLine) {
1988   // Whitespace - Skip it, then return the token after the whitespace.
1989   bool SawNewline = isVerticalWhitespace(CurPtr[-1]);
1990 
1991   unsigned char Char = *CurPtr;
1992 
1993   // Skip consecutive spaces efficiently.
1994   while (1) {
1995     // Skip horizontal whitespace very aggressively.
1996     while (isHorizontalWhitespace(Char))
1997       Char = *++CurPtr;
1998 
1999     // Otherwise if we have something other than whitespace, we're done.
2000     if (!isVerticalWhitespace(Char))
2001       break;
2002 
2003     if (ParsingPreprocessorDirective) {
2004       // End of preprocessor directive line, let LexTokenInternal handle this.
2005       BufferPtr = CurPtr;
2006       return false;
2007     }
2008 
2009     // OK, but handle newline.
2010     SawNewline = true;
2011     Char = *++CurPtr;
2012   }
2013 
2014   // If the client wants us to return whitespace, return it now.
2015   if (isKeepWhitespaceMode()) {
2016     FormTokenWithChars(Result, CurPtr, tok::unknown);
2017     if (SawNewline) {
2018       IsAtStartOfLine = true;
2019       IsAtPhysicalStartOfLine = true;
2020     }
2021     // FIXME: The next token will not have LeadingSpace set.
2022     return true;
2023   }
2024 
2025   // If this isn't immediately after a newline, there is leading space.
2026   char PrevChar = CurPtr[-1];
2027   bool HasLeadingSpace = !isVerticalWhitespace(PrevChar);
2028 
2029   Result.setFlagValue(Token::LeadingSpace, HasLeadingSpace);
2030   if (SawNewline) {
2031     Result.setFlag(Token::StartOfLine);
2032     TokAtPhysicalStartOfLine = true;
2033   }
2034 
2035   BufferPtr = CurPtr;
2036   return false;
2037 }
2038 
2039 /// We have just read the // characters from input.  Skip until we find the
2040 /// newline character thats terminate the comment.  Then update BufferPtr and
2041 /// return.
2042 ///
2043 /// If we're in KeepCommentMode or any CommentHandler has inserted
2044 /// some tokens, this will store the first token and return true.
2045 bool Lexer::SkipLineComment(Token &Result, const char *CurPtr,
2046                             bool &TokAtPhysicalStartOfLine) {
2047   // If Line comments aren't explicitly enabled for this language, emit an
2048   // extension warning.
2049   if (!LangOpts.LineComment && !isLexingRawMode()) {
2050     Diag(BufferPtr, diag::ext_line_comment);
2051 
2052     // Mark them enabled so we only emit one warning for this translation
2053     // unit.
2054     LangOpts.LineComment = true;
2055   }
2056 
2057   // Scan over the body of the comment.  The common case, when scanning, is that
2058   // the comment contains normal ascii characters with nothing interesting in
2059   // them.  As such, optimize for this case with the inner loop.
2060   char C;
2061   do {
2062     C = *CurPtr;
2063     // Skip over characters in the fast loop.
2064     while (C != 0 &&                // Potentially EOF.
2065            C != '\n' && C != '\r')  // Newline or DOS-style newline.
2066       C = *++CurPtr;
2067 
2068     const char *NextLine = CurPtr;
2069     if (C != 0) {
2070       // We found a newline, see if it's escaped.
2071       const char *EscapePtr = CurPtr-1;
2072       bool HasSpace = false;
2073       while (isHorizontalWhitespace(*EscapePtr)) { // Skip whitespace.
2074         --EscapePtr;
2075         HasSpace = true;
2076       }
2077 
2078       if (*EscapePtr == '\\') // Escaped newline.
2079         CurPtr = EscapePtr;
2080       else if (EscapePtr[0] == '/' && EscapePtr[-1] == '?' &&
2081                EscapePtr[-2] == '?') // Trigraph-escaped newline.
2082         CurPtr = EscapePtr-2;
2083       else
2084         break; // This is a newline, we're done.
2085 
2086       // If there was space between the backslash and newline, warn about it.
2087       if (HasSpace && !isLexingRawMode())
2088         Diag(EscapePtr, diag::backslash_newline_space);
2089     }
2090 
2091     // Otherwise, this is a hard case.  Fall back on getAndAdvanceChar to
2092     // properly decode the character.  Read it in raw mode to avoid emitting
2093     // diagnostics about things like trigraphs.  If we see an escaped newline,
2094     // we'll handle it below.
2095     const char *OldPtr = CurPtr;
2096     bool OldRawMode = isLexingRawMode();
2097     LexingRawMode = true;
2098     C = getAndAdvanceChar(CurPtr, Result);
2099     LexingRawMode = OldRawMode;
2100 
2101     // If we only read only one character, then no special handling is needed.
2102     // We're done and can skip forward to the newline.
2103     if (C != 0 && CurPtr == OldPtr+1) {
2104       CurPtr = NextLine;
2105       break;
2106     }
2107 
2108     // If we read multiple characters, and one of those characters was a \r or
2109     // \n, then we had an escaped newline within the comment.  Emit diagnostic
2110     // unless the next line is also a // comment.
2111     if (CurPtr != OldPtr+1 && C != '/' && CurPtr[0] != '/') {
2112       for (; OldPtr != CurPtr; ++OldPtr)
2113         if (OldPtr[0] == '\n' || OldPtr[0] == '\r') {
2114           // Okay, we found a // comment that ends in a newline, if the next
2115           // line is also a // comment, but has spaces, don't emit a diagnostic.
2116           if (isWhitespace(C)) {
2117             const char *ForwardPtr = CurPtr;
2118             while (isWhitespace(*ForwardPtr))  // Skip whitespace.
2119               ++ForwardPtr;
2120             if (ForwardPtr[0] == '/' && ForwardPtr[1] == '/')
2121               break;
2122           }
2123 
2124           if (!isLexingRawMode())
2125             Diag(OldPtr-1, diag::ext_multi_line_line_comment);
2126           break;
2127         }
2128     }
2129 
2130     if (CurPtr == BufferEnd+1) {
2131       --CurPtr;
2132       break;
2133     }
2134 
2135     if (C == '\0' && isCodeCompletionPoint(CurPtr-1)) {
2136       PP->CodeCompleteNaturalLanguage();
2137       cutOffLexing();
2138       return false;
2139     }
2140 
2141   } while (C != '\n' && C != '\r');
2142 
2143   // Found but did not consume the newline.  Notify comment handlers about the
2144   // comment unless we're in a #if 0 block.
2145   if (PP && !isLexingRawMode() &&
2146       PP->HandleComment(Result, SourceRange(getSourceLocation(BufferPtr),
2147                                             getSourceLocation(CurPtr)))) {
2148     BufferPtr = CurPtr;
2149     return true; // A token has to be returned.
2150   }
2151 
2152   // If we are returning comments as tokens, return this comment as a token.
2153   if (inKeepCommentMode())
2154     return SaveLineComment(Result, CurPtr);
2155 
2156   // If we are inside a preprocessor directive and we see the end of line,
2157   // return immediately, so that the lexer can return this as an EOD token.
2158   if (ParsingPreprocessorDirective || CurPtr == BufferEnd) {
2159     BufferPtr = CurPtr;
2160     return false;
2161   }
2162 
2163   // Otherwise, eat the \n character.  We don't care if this is a \n\r or
2164   // \r\n sequence.  This is an efficiency hack (because we know the \n can't
2165   // contribute to another token), it isn't needed for correctness.  Note that
2166   // this is ok even in KeepWhitespaceMode, because we would have returned the
2167   /// comment above in that mode.
2168   ++CurPtr;
2169 
2170   // The next returned token is at the start of the line.
2171   Result.setFlag(Token::StartOfLine);
2172   TokAtPhysicalStartOfLine = true;
2173   // No leading whitespace seen so far.
2174   Result.clearFlag(Token::LeadingSpace);
2175   BufferPtr = CurPtr;
2176   return false;
2177 }
2178 
2179 /// If in save-comment mode, package up this Line comment in an appropriate
2180 /// way and return it.
2181 bool Lexer::SaveLineComment(Token &Result, const char *CurPtr) {
2182   // If we're not in a preprocessor directive, just return the // comment
2183   // directly.
2184   FormTokenWithChars(Result, CurPtr, tok::comment);
2185 
2186   if (!ParsingPreprocessorDirective || LexingRawMode)
2187     return true;
2188 
2189   // If this Line-style comment is in a macro definition, transmogrify it into
2190   // a C-style block comment.
2191   bool Invalid = false;
2192   std::string Spelling = PP->getSpelling(Result, &Invalid);
2193   if (Invalid)
2194     return true;
2195 
2196   assert(Spelling[0] == '/' && Spelling[1] == '/' && "Not line comment?");
2197   Spelling[1] = '*';   // Change prefix to "/*".
2198   Spelling += "*/";    // add suffix.
2199 
2200   Result.setKind(tok::comment);
2201   PP->CreateString(Spelling, Result,
2202                    Result.getLocation(), Result.getLocation());
2203   return true;
2204 }
2205 
2206 /// isBlockCommentEndOfEscapedNewLine - Return true if the specified newline
2207 /// character (either \\n or \\r) is part of an escaped newline sequence.  Issue
2208 /// a diagnostic if so.  We know that the newline is inside of a block comment.
2209 static bool isEndOfBlockCommentWithEscapedNewLine(const char *CurPtr,
2210                                                   Lexer *L) {
2211   assert(CurPtr[0] == '\n' || CurPtr[0] == '\r');
2212 
2213   // Back up off the newline.
2214   --CurPtr;
2215 
2216   // If this is a two-character newline sequence, skip the other character.
2217   if (CurPtr[0] == '\n' || CurPtr[0] == '\r') {
2218     // \n\n or \r\r -> not escaped newline.
2219     if (CurPtr[0] == CurPtr[1])
2220       return false;
2221     // \n\r or \r\n -> skip the newline.
2222     --CurPtr;
2223   }
2224 
2225   // If we have horizontal whitespace, skip over it.  We allow whitespace
2226   // between the slash and newline.
2227   bool HasSpace = false;
2228   while (isHorizontalWhitespace(*CurPtr) || *CurPtr == 0) {
2229     --CurPtr;
2230     HasSpace = true;
2231   }
2232 
2233   // If we have a slash, we know this is an escaped newline.
2234   if (*CurPtr == '\\') {
2235     if (CurPtr[-1] != '*') return false;
2236   } else {
2237     // It isn't a slash, is it the ?? / trigraph?
2238     if (CurPtr[0] != '/' || CurPtr[-1] != '?' || CurPtr[-2] != '?' ||
2239         CurPtr[-3] != '*')
2240       return false;
2241 
2242     // This is the trigraph ending the comment.  Emit a stern warning!
2243     CurPtr -= 2;
2244 
2245     // If no trigraphs are enabled, warn that we ignored this trigraph and
2246     // ignore this * character.
2247     if (!L->getLangOpts().Trigraphs) {
2248       if (!L->isLexingRawMode())
2249         L->Diag(CurPtr, diag::trigraph_ignored_block_comment);
2250       return false;
2251     }
2252     if (!L->isLexingRawMode())
2253       L->Diag(CurPtr, diag::trigraph_ends_block_comment);
2254   }
2255 
2256   // Warn about having an escaped newline between the */ characters.
2257   if (!L->isLexingRawMode())
2258     L->Diag(CurPtr, diag::escaped_newline_block_comment_end);
2259 
2260   // If there was space between the backslash and newline, warn about it.
2261   if (HasSpace && !L->isLexingRawMode())
2262     L->Diag(CurPtr, diag::backslash_newline_space);
2263 
2264   return true;
2265 }
2266 
2267 #ifdef __SSE2__
2268 #include <emmintrin.h>
2269 #elif __ALTIVEC__
2270 #include <altivec.h>
2271 #undef bool
2272 #endif
2273 
2274 /// We have just read from input the / and * characters that started a comment.
2275 /// Read until we find the * and / characters that terminate the comment.
2276 /// Note that we don't bother decoding trigraphs or escaped newlines in block
2277 /// comments, because they cannot cause the comment to end.  The only thing
2278 /// that can happen is the comment could end with an escaped newline between
2279 /// the terminating * and /.
2280 ///
2281 /// If we're in KeepCommentMode or any CommentHandler has inserted
2282 /// some tokens, this will store the first token and return true.
2283 bool Lexer::SkipBlockComment(Token &Result, const char *CurPtr,
2284                              bool &TokAtPhysicalStartOfLine) {
2285   // Scan one character past where we should, looking for a '/' character.  Once
2286   // we find it, check to see if it was preceded by a *.  This common
2287   // optimization helps people who like to put a lot of * characters in their
2288   // comments.
2289 
2290   // The first character we get with newlines and trigraphs skipped to handle
2291   // the degenerate /*/ case below correctly if the * has an escaped newline
2292   // after it.
2293   unsigned CharSize;
2294   unsigned char C = getCharAndSize(CurPtr, CharSize);
2295   CurPtr += CharSize;
2296   if (C == 0 && CurPtr == BufferEnd+1) {
2297     if (!isLexingRawMode())
2298       Diag(BufferPtr, diag::err_unterminated_block_comment);
2299     --CurPtr;
2300 
2301     // KeepWhitespaceMode should return this broken comment as a token.  Since
2302     // it isn't a well formed comment, just return it as an 'unknown' token.
2303     if (isKeepWhitespaceMode()) {
2304       FormTokenWithChars(Result, CurPtr, tok::unknown);
2305       return true;
2306     }
2307 
2308     BufferPtr = CurPtr;
2309     return false;
2310   }
2311 
2312   // Check to see if the first character after the '/*' is another /.  If so,
2313   // then this slash does not end the block comment, it is part of it.
2314   if (C == '/')
2315     C = *CurPtr++;
2316 
2317   while (1) {
2318     // Skip over all non-interesting characters until we find end of buffer or a
2319     // (probably ending) '/' character.
2320     if (CurPtr + 24 < BufferEnd &&
2321         // If there is a code-completion point avoid the fast scan because it
2322         // doesn't check for '\0'.
2323         !(PP && PP->getCodeCompletionFileLoc() == FileLoc)) {
2324       // While not aligned to a 16-byte boundary.
2325       while (C != '/' && ((intptr_t)CurPtr & 0x0F) != 0)
2326         C = *CurPtr++;
2327 
2328       if (C == '/') goto FoundSlash;
2329 
2330 #ifdef __SSE2__
2331       __m128i Slashes = _mm_set1_epi8('/');
2332       while (CurPtr+16 <= BufferEnd) {
2333         int cmp = _mm_movemask_epi8(_mm_cmpeq_epi8(*(const __m128i*)CurPtr,
2334                                     Slashes));
2335         if (cmp != 0) {
2336           // Adjust the pointer to point directly after the first slash. It's
2337           // not necessary to set C here, it will be overwritten at the end of
2338           // the outer loop.
2339           CurPtr += llvm::countTrailingZeros<unsigned>(cmp) + 1;
2340           goto FoundSlash;
2341         }
2342         CurPtr += 16;
2343       }
2344 #elif __ALTIVEC__
2345       __vector unsigned char Slashes = {
2346         '/', '/', '/', '/',  '/', '/', '/', '/',
2347         '/', '/', '/', '/',  '/', '/', '/', '/'
2348       };
2349       while (CurPtr+16 <= BufferEnd &&
2350              !vec_any_eq(*(const vector unsigned char*)CurPtr, Slashes))
2351         CurPtr += 16;
2352 #else
2353       // Scan for '/' quickly.  Many block comments are very large.
2354       while (CurPtr[0] != '/' &&
2355              CurPtr[1] != '/' &&
2356              CurPtr[2] != '/' &&
2357              CurPtr[3] != '/' &&
2358              CurPtr+4 < BufferEnd) {
2359         CurPtr += 4;
2360       }
2361 #endif
2362 
2363       // It has to be one of the bytes scanned, increment to it and read one.
2364       C = *CurPtr++;
2365     }
2366 
2367     // Loop to scan the remainder.
2368     while (C != '/' && C != '\0')
2369       C = *CurPtr++;
2370 
2371     if (C == '/') {
2372   FoundSlash:
2373       if (CurPtr[-2] == '*')  // We found the final */.  We're done!
2374         break;
2375 
2376       if ((CurPtr[-2] == '\n' || CurPtr[-2] == '\r')) {
2377         if (isEndOfBlockCommentWithEscapedNewLine(CurPtr-2, this)) {
2378           // We found the final */, though it had an escaped newline between the
2379           // * and /.  We're done!
2380           break;
2381         }
2382       }
2383       if (CurPtr[0] == '*' && CurPtr[1] != '/') {
2384         // If this is a /* inside of the comment, emit a warning.  Don't do this
2385         // if this is a /*/, which will end the comment.  This misses cases with
2386         // embedded escaped newlines, but oh well.
2387         if (!isLexingRawMode())
2388           Diag(CurPtr-1, diag::warn_nested_block_comment);
2389       }
2390     } else if (C == 0 && CurPtr == BufferEnd+1) {
2391       if (!isLexingRawMode())
2392         Diag(BufferPtr, diag::err_unterminated_block_comment);
2393       // Note: the user probably forgot a */.  We could continue immediately
2394       // after the /*, but this would involve lexing a lot of what really is the
2395       // comment, which surely would confuse the parser.
2396       --CurPtr;
2397 
2398       // KeepWhitespaceMode should return this broken comment as a token.  Since
2399       // it isn't a well formed comment, just return it as an 'unknown' token.
2400       if (isKeepWhitespaceMode()) {
2401         FormTokenWithChars(Result, CurPtr, tok::unknown);
2402         return true;
2403       }
2404 
2405       BufferPtr = CurPtr;
2406       return false;
2407     } else if (C == '\0' && isCodeCompletionPoint(CurPtr-1)) {
2408       PP->CodeCompleteNaturalLanguage();
2409       cutOffLexing();
2410       return false;
2411     }
2412 
2413     C = *CurPtr++;
2414   }
2415 
2416   // Notify comment handlers about the comment unless we're in a #if 0 block.
2417   if (PP && !isLexingRawMode() &&
2418       PP->HandleComment(Result, SourceRange(getSourceLocation(BufferPtr),
2419                                             getSourceLocation(CurPtr)))) {
2420     BufferPtr = CurPtr;
2421     return true; // A token has to be returned.
2422   }
2423 
2424   // If we are returning comments as tokens, return this comment as a token.
2425   if (inKeepCommentMode()) {
2426     FormTokenWithChars(Result, CurPtr, tok::comment);
2427     return true;
2428   }
2429 
2430   // It is common for the tokens immediately after a /**/ comment to be
2431   // whitespace.  Instead of going through the big switch, handle it
2432   // efficiently now.  This is safe even in KeepWhitespaceMode because we would
2433   // have already returned above with the comment as a token.
2434   if (isHorizontalWhitespace(*CurPtr)) {
2435     SkipWhitespace(Result, CurPtr+1, TokAtPhysicalStartOfLine);
2436     return false;
2437   }
2438 
2439   // Otherwise, just return so that the next character will be lexed as a token.
2440   BufferPtr = CurPtr;
2441   Result.setFlag(Token::LeadingSpace);
2442   return false;
2443 }
2444 
2445 //===----------------------------------------------------------------------===//
2446 // Primary Lexing Entry Points
2447 //===----------------------------------------------------------------------===//
2448 
2449 /// ReadToEndOfLine - Read the rest of the current preprocessor line as an
2450 /// uninterpreted string.  This switches the lexer out of directive mode.
2451 void Lexer::ReadToEndOfLine(SmallVectorImpl<char> *Result) {
2452   assert(ParsingPreprocessorDirective && ParsingFilename == false &&
2453          "Must be in a preprocessing directive!");
2454   Token Tmp;
2455 
2456   // CurPtr - Cache BufferPtr in an automatic variable.
2457   const char *CurPtr = BufferPtr;
2458   while (1) {
2459     char Char = getAndAdvanceChar(CurPtr, Tmp);
2460     switch (Char) {
2461     default:
2462       if (Result)
2463         Result->push_back(Char);
2464       break;
2465     case 0:  // Null.
2466       // Found end of file?
2467       if (CurPtr-1 != BufferEnd) {
2468         if (isCodeCompletionPoint(CurPtr-1)) {
2469           PP->CodeCompleteNaturalLanguage();
2470           cutOffLexing();
2471           return;
2472         }
2473 
2474         // Nope, normal character, continue.
2475         if (Result)
2476           Result->push_back(Char);
2477         break;
2478       }
2479       // FALL THROUGH.
2480     case '\r':
2481     case '\n':
2482       // Okay, we found the end of the line. First, back up past the \0, \r, \n.
2483       assert(CurPtr[-1] == Char && "Trigraphs for newline?");
2484       BufferPtr = CurPtr-1;
2485 
2486       // Next, lex the character, which should handle the EOD transition.
2487       Lex(Tmp);
2488       if (Tmp.is(tok::code_completion)) {
2489         if (PP)
2490           PP->CodeCompleteNaturalLanguage();
2491         Lex(Tmp);
2492       }
2493       assert(Tmp.is(tok::eod) && "Unexpected token!");
2494 
2495       // Finally, we're done;
2496       return;
2497     }
2498   }
2499 }
2500 
2501 /// LexEndOfFile - CurPtr points to the end of this file.  Handle this
2502 /// condition, reporting diagnostics and handling other edge cases as required.
2503 /// This returns true if Result contains a token, false if PP.Lex should be
2504 /// called again.
2505 bool Lexer::LexEndOfFile(Token &Result, const char *CurPtr) {
2506   // If we hit the end of the file while parsing a preprocessor directive,
2507   // end the preprocessor directive first.  The next token returned will
2508   // then be the end of file.
2509   if (ParsingPreprocessorDirective) {
2510     // Done parsing the "line".
2511     ParsingPreprocessorDirective = false;
2512     // Update the location of token as well as BufferPtr.
2513     FormTokenWithChars(Result, CurPtr, tok::eod);
2514 
2515     // Restore comment saving mode, in case it was disabled for directive.
2516     if (PP)
2517       resetExtendedTokenMode();
2518     return true;  // Have a token.
2519   }
2520 
2521   // If we are in raw mode, return this event as an EOF token.  Let the caller
2522   // that put us in raw mode handle the event.
2523   if (isLexingRawMode()) {
2524     Result.startToken();
2525     BufferPtr = BufferEnd;
2526     FormTokenWithChars(Result, BufferEnd, tok::eof);
2527     return true;
2528   }
2529 
2530   // Issue diagnostics for unterminated #if and missing newline.
2531 
2532   // If we are in a #if directive, emit an error.
2533   while (!ConditionalStack.empty()) {
2534     if (PP->getCodeCompletionFileLoc() != FileLoc)
2535       PP->Diag(ConditionalStack.back().IfLoc,
2536                diag::err_pp_unterminated_conditional);
2537     ConditionalStack.pop_back();
2538   }
2539 
2540   // C99 5.1.1.2p2: If the file is non-empty and didn't end in a newline, issue
2541   // a pedwarn.
2542   if (CurPtr != BufferStart && (CurPtr[-1] != '\n' && CurPtr[-1] != '\r')) {
2543     DiagnosticsEngine &Diags = PP->getDiagnostics();
2544     SourceLocation EndLoc = getSourceLocation(BufferEnd);
2545     unsigned DiagID;
2546 
2547     if (LangOpts.CPlusPlus11) {
2548       // C++11 [lex.phases] 2.2 p2
2549       // Prefer the C++98 pedantic compatibility warning over the generic,
2550       // non-extension, user-requested "missing newline at EOF" warning.
2551       if (!Diags.isIgnored(diag::warn_cxx98_compat_no_newline_eof, EndLoc)) {
2552         DiagID = diag::warn_cxx98_compat_no_newline_eof;
2553       } else {
2554         DiagID = diag::warn_no_newline_eof;
2555       }
2556     } else {
2557       DiagID = diag::ext_no_newline_eof;
2558     }
2559 
2560     Diag(BufferEnd, DiagID)
2561       << FixItHint::CreateInsertion(EndLoc, "\n");
2562   }
2563 
2564   BufferPtr = CurPtr;
2565 
2566   // Finally, let the preprocessor handle this.
2567   return PP->HandleEndOfFile(Result, isPragmaLexer());
2568 }
2569 
2570 /// isNextPPTokenLParen - Return 1 if the next unexpanded token lexed from
2571 /// the specified lexer will return a tok::l_paren token, 0 if it is something
2572 /// else and 2 if there are no more tokens in the buffer controlled by the
2573 /// lexer.
2574 unsigned Lexer::isNextPPTokenLParen() {
2575   assert(!LexingRawMode && "How can we expand a macro from a skipping buffer?");
2576 
2577   // Switch to 'skipping' mode.  This will ensure that we can lex a token
2578   // without emitting diagnostics, disables macro expansion, and will cause EOF
2579   // to return an EOF token instead of popping the include stack.
2580   LexingRawMode = true;
2581 
2582   // Save state that can be changed while lexing so that we can restore it.
2583   const char *TmpBufferPtr = BufferPtr;
2584   bool inPPDirectiveMode = ParsingPreprocessorDirective;
2585   bool atStartOfLine = IsAtStartOfLine;
2586   bool atPhysicalStartOfLine = IsAtPhysicalStartOfLine;
2587   bool leadingSpace = HasLeadingSpace;
2588 
2589   Token Tok;
2590   Lex(Tok);
2591 
2592   // Restore state that may have changed.
2593   BufferPtr = TmpBufferPtr;
2594   ParsingPreprocessorDirective = inPPDirectiveMode;
2595   HasLeadingSpace = leadingSpace;
2596   IsAtStartOfLine = atStartOfLine;
2597   IsAtPhysicalStartOfLine = atPhysicalStartOfLine;
2598 
2599   // Restore the lexer back to non-skipping mode.
2600   LexingRawMode = false;
2601 
2602   if (Tok.is(tok::eof))
2603     return 2;
2604   return Tok.is(tok::l_paren);
2605 }
2606 
2607 /// \brief Find the end of a version control conflict marker.
2608 static const char *FindConflictEnd(const char *CurPtr, const char *BufferEnd,
2609                                    ConflictMarkerKind CMK) {
2610   const char *Terminator = CMK == CMK_Perforce ? "<<<<\n" : ">>>>>>>";
2611   size_t TermLen = CMK == CMK_Perforce ? 5 : 7;
2612   StringRef RestOfBuffer(CurPtr+TermLen, BufferEnd-CurPtr-TermLen);
2613   size_t Pos = RestOfBuffer.find(Terminator);
2614   while (Pos != StringRef::npos) {
2615     // Must occur at start of line.
2616     if (Pos == 0 ||
2617         (RestOfBuffer[Pos - 1] != '\r' && RestOfBuffer[Pos - 1] != '\n')) {
2618       RestOfBuffer = RestOfBuffer.substr(Pos+TermLen);
2619       Pos = RestOfBuffer.find(Terminator);
2620       continue;
2621     }
2622     return RestOfBuffer.data()+Pos;
2623   }
2624   return nullptr;
2625 }
2626 
2627 /// IsStartOfConflictMarker - If the specified pointer is the start of a version
2628 /// control conflict marker like '<<<<<<<', recognize it as such, emit an error
2629 /// and recover nicely.  This returns true if it is a conflict marker and false
2630 /// if not.
2631 bool Lexer::IsStartOfConflictMarker(const char *CurPtr) {
2632   // Only a conflict marker if it starts at the beginning of a line.
2633   if (CurPtr != BufferStart &&
2634       CurPtr[-1] != '\n' && CurPtr[-1] != '\r')
2635     return false;
2636 
2637   // Check to see if we have <<<<<<< or >>>>.
2638   if ((BufferEnd-CurPtr < 8 || StringRef(CurPtr, 7) != "<<<<<<<") &&
2639       (BufferEnd-CurPtr < 6 || StringRef(CurPtr, 5) != ">>>> "))
2640     return false;
2641 
2642   // If we have a situation where we don't care about conflict markers, ignore
2643   // it.
2644   if (CurrentConflictMarkerState || isLexingRawMode())
2645     return false;
2646 
2647   ConflictMarkerKind Kind = *CurPtr == '<' ? CMK_Normal : CMK_Perforce;
2648 
2649   // Check to see if there is an ending marker somewhere in the buffer at the
2650   // start of a line to terminate this conflict marker.
2651   if (FindConflictEnd(CurPtr, BufferEnd, Kind)) {
2652     // We found a match.  We are really in a conflict marker.
2653     // Diagnose this, and ignore to the end of line.
2654     Diag(CurPtr, diag::err_conflict_marker);
2655     CurrentConflictMarkerState = Kind;
2656 
2657     // Skip ahead to the end of line.  We know this exists because the
2658     // end-of-conflict marker starts with \r or \n.
2659     while (*CurPtr != '\r' && *CurPtr != '\n') {
2660       assert(CurPtr != BufferEnd && "Didn't find end of line");
2661       ++CurPtr;
2662     }
2663     BufferPtr = CurPtr;
2664     return true;
2665   }
2666 
2667   // No end of conflict marker found.
2668   return false;
2669 }
2670 
2671 
2672 /// HandleEndOfConflictMarker - If this is a '====' or '||||' or '>>>>', or if
2673 /// it is '<<<<' and the conflict marker started with a '>>>>' marker, then it
2674 /// is the end of a conflict marker.  Handle it by ignoring up until the end of
2675 /// the line.  This returns true if it is a conflict marker and false if not.
2676 bool Lexer::HandleEndOfConflictMarker(const char *CurPtr) {
2677   // Only a conflict marker if it starts at the beginning of a line.
2678   if (CurPtr != BufferStart &&
2679       CurPtr[-1] != '\n' && CurPtr[-1] != '\r')
2680     return false;
2681 
2682   // If we have a situation where we don't care about conflict markers, ignore
2683   // it.
2684   if (!CurrentConflictMarkerState || isLexingRawMode())
2685     return false;
2686 
2687   // Check to see if we have the marker (4 characters in a row).
2688   for (unsigned i = 1; i != 4; ++i)
2689     if (CurPtr[i] != CurPtr[0])
2690       return false;
2691 
2692   // If we do have it, search for the end of the conflict marker.  This could
2693   // fail if it got skipped with a '#if 0' or something.  Note that CurPtr might
2694   // be the end of conflict marker.
2695   if (const char *End = FindConflictEnd(CurPtr, BufferEnd,
2696                                         CurrentConflictMarkerState)) {
2697     CurPtr = End;
2698 
2699     // Skip ahead to the end of line.
2700     while (CurPtr != BufferEnd && *CurPtr != '\r' && *CurPtr != '\n')
2701       ++CurPtr;
2702 
2703     BufferPtr = CurPtr;
2704 
2705     // No longer in the conflict marker.
2706     CurrentConflictMarkerState = CMK_None;
2707     return true;
2708   }
2709 
2710   return false;
2711 }
2712 
2713 bool Lexer::isCodeCompletionPoint(const char *CurPtr) const {
2714   if (PP && PP->isCodeCompletionEnabled()) {
2715     SourceLocation Loc = FileLoc.getLocWithOffset(CurPtr-BufferStart);
2716     return Loc == PP->getCodeCompletionLoc();
2717   }
2718 
2719   return false;
2720 }
2721 
2722 uint32_t Lexer::tryReadUCN(const char *&StartPtr, const char *SlashLoc,
2723                            Token *Result) {
2724   unsigned CharSize;
2725   char Kind = getCharAndSize(StartPtr, CharSize);
2726 
2727   unsigned NumHexDigits;
2728   if (Kind == 'u')
2729     NumHexDigits = 4;
2730   else if (Kind == 'U')
2731     NumHexDigits = 8;
2732   else
2733     return 0;
2734 
2735   if (!LangOpts.CPlusPlus && !LangOpts.C99) {
2736     if (Result && !isLexingRawMode())
2737       Diag(SlashLoc, diag::warn_ucn_not_valid_in_c89);
2738     return 0;
2739   }
2740 
2741   const char *CurPtr = StartPtr + CharSize;
2742   const char *KindLoc = &CurPtr[-1];
2743 
2744   uint32_t CodePoint = 0;
2745   for (unsigned i = 0; i < NumHexDigits; ++i) {
2746     char C = getCharAndSize(CurPtr, CharSize);
2747 
2748     unsigned Value = llvm::hexDigitValue(C);
2749     if (Value == -1U) {
2750       if (Result && !isLexingRawMode()) {
2751         if (i == 0) {
2752           Diag(BufferPtr, diag::warn_ucn_escape_no_digits)
2753             << StringRef(KindLoc, 1);
2754         } else {
2755           Diag(BufferPtr, diag::warn_ucn_escape_incomplete);
2756 
2757           // If the user wrote \U1234, suggest a fixit to \u.
2758           if (i == 4 && NumHexDigits == 8) {
2759             CharSourceRange URange = makeCharRange(*this, KindLoc, KindLoc + 1);
2760             Diag(KindLoc, diag::note_ucn_four_not_eight)
2761               << FixItHint::CreateReplacement(URange, "u");
2762           }
2763         }
2764       }
2765 
2766       return 0;
2767     }
2768 
2769     CodePoint <<= 4;
2770     CodePoint += Value;
2771 
2772     CurPtr += CharSize;
2773   }
2774 
2775   if (Result) {
2776     Result->setFlag(Token::HasUCN);
2777     if (CurPtr - StartPtr == (ptrdiff_t)NumHexDigits + 2)
2778       StartPtr = CurPtr;
2779     else
2780       while (StartPtr != CurPtr)
2781         (void)getAndAdvanceChar(StartPtr, *Result);
2782   } else {
2783     StartPtr = CurPtr;
2784   }
2785 
2786   // Don't apply C family restrictions to UCNs in assembly mode
2787   if (LangOpts.AsmPreprocessor)
2788     return CodePoint;
2789 
2790   // C99 6.4.3p2: A universal character name shall not specify a character whose
2791   //   short identifier is less than 00A0 other than 0024 ($), 0040 (@), or
2792   //   0060 (`), nor one in the range D800 through DFFF inclusive.)
2793   // C++11 [lex.charset]p2: If the hexadecimal value for a
2794   //   universal-character-name corresponds to a surrogate code point (in the
2795   //   range 0xD800-0xDFFF, inclusive), the program is ill-formed. Additionally,
2796   //   if the hexadecimal value for a universal-character-name outside the
2797   //   c-char-sequence, s-char-sequence, or r-char-sequence of a character or
2798   //   string literal corresponds to a control character (in either of the
2799   //   ranges 0x00-0x1F or 0x7F-0x9F, both inclusive) or to a character in the
2800   //   basic source character set, the program is ill-formed.
2801   if (CodePoint < 0xA0) {
2802     if (CodePoint == 0x24 || CodePoint == 0x40 || CodePoint == 0x60)
2803       return CodePoint;
2804 
2805     // We don't use isLexingRawMode() here because we need to warn about bad
2806     // UCNs even when skipping preprocessing tokens in a #if block.
2807     if (Result && PP) {
2808       if (CodePoint < 0x20 || CodePoint >= 0x7F)
2809         Diag(BufferPtr, diag::err_ucn_control_character);
2810       else {
2811         char C = static_cast<char>(CodePoint);
2812         Diag(BufferPtr, diag::err_ucn_escape_basic_scs) << StringRef(&C, 1);
2813       }
2814     }
2815 
2816     return 0;
2817 
2818   } else if (CodePoint >= 0xD800 && CodePoint <= 0xDFFF) {
2819     // C++03 allows UCNs representing surrogate characters. C99 and C++11 don't.
2820     // We don't use isLexingRawMode() here because we need to diagnose bad
2821     // UCNs even when skipping preprocessing tokens in a #if block.
2822     if (Result && PP) {
2823       if (LangOpts.CPlusPlus && !LangOpts.CPlusPlus11)
2824         Diag(BufferPtr, diag::warn_ucn_escape_surrogate);
2825       else
2826         Diag(BufferPtr, diag::err_ucn_escape_invalid);
2827     }
2828     return 0;
2829   }
2830 
2831   return CodePoint;
2832 }
2833 
2834 bool Lexer::CheckUnicodeWhitespace(Token &Result, uint32_t C,
2835                                    const char *CurPtr) {
2836   static const llvm::sys::UnicodeCharSet UnicodeWhitespaceChars(
2837       UnicodeWhitespaceCharRanges);
2838   if (!isLexingRawMode() && !PP->isPreprocessedOutput() &&
2839       UnicodeWhitespaceChars.contains(C)) {
2840     Diag(BufferPtr, diag::ext_unicode_whitespace)
2841       << makeCharRange(*this, BufferPtr, CurPtr);
2842 
2843     Result.setFlag(Token::LeadingSpace);
2844     return true;
2845   }
2846   return false;
2847 }
2848 
2849 bool Lexer::LexUnicode(Token &Result, uint32_t C, const char *CurPtr) {
2850   if (isAllowedIDChar(C, LangOpts) && isAllowedInitiallyIDChar(C, LangOpts)) {
2851     if (!isLexingRawMode() && !ParsingPreprocessorDirective &&
2852         !PP->isPreprocessedOutput()) {
2853       maybeDiagnoseIDCharCompat(PP->getDiagnostics(), C,
2854                                 makeCharRange(*this, BufferPtr, CurPtr),
2855                                 /*IsFirst=*/true);
2856     }
2857 
2858     MIOpt.ReadToken();
2859     return LexIdentifier(Result, CurPtr);
2860   }
2861 
2862   if (!isLexingRawMode() && !ParsingPreprocessorDirective &&
2863       !PP->isPreprocessedOutput() &&
2864       !isASCII(*BufferPtr) && !isAllowedIDChar(C, LangOpts)) {
2865     // Non-ASCII characters tend to creep into source code unintentionally.
2866     // Instead of letting the parser complain about the unknown token,
2867     // just drop the character.
2868     // Note that we can /only/ do this when the non-ASCII character is actually
2869     // spelled as Unicode, not written as a UCN. The standard requires that
2870     // we not throw away any possible preprocessor tokens, but there's a
2871     // loophole in the mapping of Unicode characters to basic character set
2872     // characters that allows us to map these particular characters to, say,
2873     // whitespace.
2874     Diag(BufferPtr, diag::err_non_ascii)
2875       << FixItHint::CreateRemoval(makeCharRange(*this, BufferPtr, CurPtr));
2876 
2877     BufferPtr = CurPtr;
2878     return false;
2879   }
2880 
2881   // Otherwise, we have an explicit UCN or a character that's unlikely to show
2882   // up by accident.
2883   MIOpt.ReadToken();
2884   FormTokenWithChars(Result, CurPtr, tok::unknown);
2885   return true;
2886 }
2887 
2888 void Lexer::PropagateLineStartLeadingSpaceInfo(Token &Result) {
2889   IsAtStartOfLine = Result.isAtStartOfLine();
2890   HasLeadingSpace = Result.hasLeadingSpace();
2891   HasLeadingEmptyMacro = Result.hasLeadingEmptyMacro();
2892   // Note that this doesn't affect IsAtPhysicalStartOfLine.
2893 }
2894 
2895 bool Lexer::Lex(Token &Result) {
2896   // Start a new token.
2897   Result.startToken();
2898 
2899   // Set up misc whitespace flags for LexTokenInternal.
2900   if (IsAtStartOfLine) {
2901     Result.setFlag(Token::StartOfLine);
2902     IsAtStartOfLine = false;
2903   }
2904 
2905   if (HasLeadingSpace) {
2906     Result.setFlag(Token::LeadingSpace);
2907     HasLeadingSpace = false;
2908   }
2909 
2910   if (HasLeadingEmptyMacro) {
2911     Result.setFlag(Token::LeadingEmptyMacro);
2912     HasLeadingEmptyMacro = false;
2913   }
2914 
2915   bool atPhysicalStartOfLine = IsAtPhysicalStartOfLine;
2916   IsAtPhysicalStartOfLine = false;
2917   bool isRawLex = isLexingRawMode();
2918   (void) isRawLex;
2919   bool returnedToken = LexTokenInternal(Result, atPhysicalStartOfLine);
2920   // (After the LexTokenInternal call, the lexer might be destroyed.)
2921   assert((returnedToken || !isRawLex) && "Raw lex must succeed");
2922   return returnedToken;
2923 }
2924 
2925 /// LexTokenInternal - This implements a simple C family lexer.  It is an
2926 /// extremely performance critical piece of code.  This assumes that the buffer
2927 /// has a null character at the end of the file.  This returns a preprocessing
2928 /// token, not a normal token, as such, it is an internal interface.  It assumes
2929 /// that the Flags of result have been cleared before calling this.
2930 bool Lexer::LexTokenInternal(Token &Result, bool TokAtPhysicalStartOfLine) {
2931 LexNextToken:
2932   // New token, can't need cleaning yet.
2933   Result.clearFlag(Token::NeedsCleaning);
2934   Result.setIdentifierInfo(nullptr);
2935 
2936   // CurPtr - Cache BufferPtr in an automatic variable.
2937   const char *CurPtr = BufferPtr;
2938 
2939   // Small amounts of horizontal whitespace is very common between tokens.
2940   if ((*CurPtr == ' ') || (*CurPtr == '\t')) {
2941     ++CurPtr;
2942     while ((*CurPtr == ' ') || (*CurPtr == '\t'))
2943       ++CurPtr;
2944 
2945     // If we are keeping whitespace and other tokens, just return what we just
2946     // skipped.  The next lexer invocation will return the token after the
2947     // whitespace.
2948     if (isKeepWhitespaceMode()) {
2949       FormTokenWithChars(Result, CurPtr, tok::unknown);
2950       // FIXME: The next token will not have LeadingSpace set.
2951       return true;
2952     }
2953 
2954     BufferPtr = CurPtr;
2955     Result.setFlag(Token::LeadingSpace);
2956   }
2957 
2958   unsigned SizeTmp, SizeTmp2;   // Temporaries for use in cases below.
2959 
2960   // Read a character, advancing over it.
2961   char Char = getAndAdvanceChar(CurPtr, Result);
2962   tok::TokenKind Kind;
2963 
2964   switch (Char) {
2965   case 0:  // Null.
2966     // Found end of file?
2967     if (CurPtr-1 == BufferEnd)
2968       return LexEndOfFile(Result, CurPtr-1);
2969 
2970     // Check if we are performing code completion.
2971     if (isCodeCompletionPoint(CurPtr-1)) {
2972       // Return the code-completion token.
2973       Result.startToken();
2974       FormTokenWithChars(Result, CurPtr, tok::code_completion);
2975       return true;
2976     }
2977 
2978     if (!isLexingRawMode())
2979       Diag(CurPtr-1, diag::null_in_file);
2980     Result.setFlag(Token::LeadingSpace);
2981     if (SkipWhitespace(Result, CurPtr, TokAtPhysicalStartOfLine))
2982       return true; // KeepWhitespaceMode
2983 
2984     // We know the lexer hasn't changed, so just try again with this lexer.
2985     // (We manually eliminate the tail call to avoid recursion.)
2986     goto LexNextToken;
2987 
2988   case 26:  // DOS & CP/M EOF: "^Z".
2989     // If we're in Microsoft extensions mode, treat this as end of file.
2990     if (LangOpts.MicrosoftExt) {
2991       if (!isLexingRawMode())
2992         Diag(CurPtr-1, diag::ext_ctrl_z_eof_microsoft);
2993       return LexEndOfFile(Result, CurPtr-1);
2994     }
2995 
2996     // If Microsoft extensions are disabled, this is just random garbage.
2997     Kind = tok::unknown;
2998     break;
2999 
3000   case '\n':
3001   case '\r':
3002     // If we are inside a preprocessor directive and we see the end of line,
3003     // we know we are done with the directive, so return an EOD token.
3004     if (ParsingPreprocessorDirective) {
3005       // Done parsing the "line".
3006       ParsingPreprocessorDirective = false;
3007 
3008       // Restore comment saving mode, in case it was disabled for directive.
3009       if (PP)
3010         resetExtendedTokenMode();
3011 
3012       // Since we consumed a newline, we are back at the start of a line.
3013       IsAtStartOfLine = true;
3014       IsAtPhysicalStartOfLine = true;
3015 
3016       Kind = tok::eod;
3017       break;
3018     }
3019 
3020     // No leading whitespace seen so far.
3021     Result.clearFlag(Token::LeadingSpace);
3022 
3023     if (SkipWhitespace(Result, CurPtr, TokAtPhysicalStartOfLine))
3024       return true; // KeepWhitespaceMode
3025 
3026     // We only saw whitespace, so just try again with this lexer.
3027     // (We manually eliminate the tail call to avoid recursion.)
3028     goto LexNextToken;
3029   case ' ':
3030   case '\t':
3031   case '\f':
3032   case '\v':
3033   SkipHorizontalWhitespace:
3034     Result.setFlag(Token::LeadingSpace);
3035     if (SkipWhitespace(Result, CurPtr, TokAtPhysicalStartOfLine))
3036       return true; // KeepWhitespaceMode
3037 
3038   SkipIgnoredUnits:
3039     CurPtr = BufferPtr;
3040 
3041     // If the next token is obviously a // or /* */ comment, skip it efficiently
3042     // too (without going through the big switch stmt).
3043     if (CurPtr[0] == '/' && CurPtr[1] == '/' && !inKeepCommentMode() &&
3044         LangOpts.LineComment &&
3045         (LangOpts.CPlusPlus || !LangOpts.TraditionalCPP)) {
3046       if (SkipLineComment(Result, CurPtr+2, TokAtPhysicalStartOfLine))
3047         return true; // There is a token to return.
3048       goto SkipIgnoredUnits;
3049     } else if (CurPtr[0] == '/' && CurPtr[1] == '*' && !inKeepCommentMode()) {
3050       if (SkipBlockComment(Result, CurPtr+2, TokAtPhysicalStartOfLine))
3051         return true; // There is a token to return.
3052       goto SkipIgnoredUnits;
3053     } else if (isHorizontalWhitespace(*CurPtr)) {
3054       goto SkipHorizontalWhitespace;
3055     }
3056     // We only saw whitespace, so just try again with this lexer.
3057     // (We manually eliminate the tail call to avoid recursion.)
3058     goto LexNextToken;
3059 
3060   // C99 6.4.4.1: Integer Constants.
3061   // C99 6.4.4.2: Floating Constants.
3062   case '0': case '1': case '2': case '3': case '4':
3063   case '5': case '6': case '7': case '8': case '9':
3064     // Notify MIOpt that we read a non-whitespace/non-comment token.
3065     MIOpt.ReadToken();
3066     return LexNumericConstant(Result, CurPtr);
3067 
3068   case 'u':   // Identifier (uber) or C11/C++11 UTF-8 or UTF-16 string literal
3069     // Notify MIOpt that we read a non-whitespace/non-comment token.
3070     MIOpt.ReadToken();
3071 
3072     if (LangOpts.CPlusPlus11 || LangOpts.C11) {
3073       Char = getCharAndSize(CurPtr, SizeTmp);
3074 
3075       // UTF-16 string literal
3076       if (Char == '"')
3077         return LexStringLiteral(Result, ConsumeChar(CurPtr, SizeTmp, Result),
3078                                 tok::utf16_string_literal);
3079 
3080       // UTF-16 character constant
3081       if (Char == '\'')
3082         return LexCharConstant(Result, ConsumeChar(CurPtr, SizeTmp, Result),
3083                                tok::utf16_char_constant);
3084 
3085       // UTF-16 raw string literal
3086       if (Char == 'R' && LangOpts.CPlusPlus11 &&
3087           getCharAndSize(CurPtr + SizeTmp, SizeTmp2) == '"')
3088         return LexRawStringLiteral(Result,
3089                                ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3090                                            SizeTmp2, Result),
3091                                tok::utf16_string_literal);
3092 
3093       if (Char == '8') {
3094         char Char2 = getCharAndSize(CurPtr + SizeTmp, SizeTmp2);
3095 
3096         // UTF-8 string literal
3097         if (Char2 == '"')
3098           return LexStringLiteral(Result,
3099                                ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3100                                            SizeTmp2, Result),
3101                                tok::utf8_string_literal);
3102         if (Char2 == '\'' && LangOpts.CPlusPlus1z)
3103           return LexCharConstant(
3104               Result, ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3105                                   SizeTmp2, Result),
3106               tok::utf8_char_constant);
3107 
3108         if (Char2 == 'R' && LangOpts.CPlusPlus11) {
3109           unsigned SizeTmp3;
3110           char Char3 = getCharAndSize(CurPtr + SizeTmp + SizeTmp2, SizeTmp3);
3111           // UTF-8 raw string literal
3112           if (Char3 == '"') {
3113             return LexRawStringLiteral(Result,
3114                    ConsumeChar(ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3115                                            SizeTmp2, Result),
3116                                SizeTmp3, Result),
3117                    tok::utf8_string_literal);
3118           }
3119         }
3120       }
3121     }
3122 
3123     // treat u like the start of an identifier.
3124     return LexIdentifier(Result, CurPtr);
3125 
3126   case 'U':   // Identifier (Uber) or C11/C++11 UTF-32 string literal
3127     // Notify MIOpt that we read a non-whitespace/non-comment token.
3128     MIOpt.ReadToken();
3129 
3130     if (LangOpts.CPlusPlus11 || LangOpts.C11) {
3131       Char = getCharAndSize(CurPtr, SizeTmp);
3132 
3133       // UTF-32 string literal
3134       if (Char == '"')
3135         return LexStringLiteral(Result, ConsumeChar(CurPtr, SizeTmp, Result),
3136                                 tok::utf32_string_literal);
3137 
3138       // UTF-32 character constant
3139       if (Char == '\'')
3140         return LexCharConstant(Result, ConsumeChar(CurPtr, SizeTmp, Result),
3141                                tok::utf32_char_constant);
3142 
3143       // UTF-32 raw string literal
3144       if (Char == 'R' && LangOpts.CPlusPlus11 &&
3145           getCharAndSize(CurPtr + SizeTmp, SizeTmp2) == '"')
3146         return LexRawStringLiteral(Result,
3147                                ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3148                                            SizeTmp2, Result),
3149                                tok::utf32_string_literal);
3150     }
3151 
3152     // treat U like the start of an identifier.
3153     return LexIdentifier(Result, CurPtr);
3154 
3155   case 'R': // Identifier or C++0x raw string literal
3156     // Notify MIOpt that we read a non-whitespace/non-comment token.
3157     MIOpt.ReadToken();
3158 
3159     if (LangOpts.CPlusPlus11) {
3160       Char = getCharAndSize(CurPtr, SizeTmp);
3161 
3162       if (Char == '"')
3163         return LexRawStringLiteral(Result,
3164                                    ConsumeChar(CurPtr, SizeTmp, Result),
3165                                    tok::string_literal);
3166     }
3167 
3168     // treat R like the start of an identifier.
3169     return LexIdentifier(Result, CurPtr);
3170 
3171   case 'L':   // Identifier (Loony) or wide literal (L'x' or L"xyz").
3172     // Notify MIOpt that we read a non-whitespace/non-comment token.
3173     MIOpt.ReadToken();
3174     Char = getCharAndSize(CurPtr, SizeTmp);
3175 
3176     // Wide string literal.
3177     if (Char == '"')
3178       return LexStringLiteral(Result, ConsumeChar(CurPtr, SizeTmp, Result),
3179                               tok::wide_string_literal);
3180 
3181     // Wide raw string literal.
3182     if (LangOpts.CPlusPlus11 && Char == 'R' &&
3183         getCharAndSize(CurPtr + SizeTmp, SizeTmp2) == '"')
3184       return LexRawStringLiteral(Result,
3185                                ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3186                                            SizeTmp2, Result),
3187                                tok::wide_string_literal);
3188 
3189     // Wide character constant.
3190     if (Char == '\'')
3191       return LexCharConstant(Result, ConsumeChar(CurPtr, SizeTmp, Result),
3192                              tok::wide_char_constant);
3193     // FALL THROUGH, treating L like the start of an identifier.
3194 
3195   // C99 6.4.2: Identifiers.
3196   case 'A': case 'B': case 'C': case 'D': case 'E': case 'F': case 'G':
3197   case 'H': case 'I': case 'J': case 'K':    /*'L'*/case 'M': case 'N':
3198   case 'O': case 'P': case 'Q':    /*'R'*/case 'S': case 'T':    /*'U'*/
3199   case 'V': case 'W': case 'X': case 'Y': case 'Z':
3200   case 'a': case 'b': case 'c': case 'd': case 'e': case 'f': case 'g':
3201   case 'h': case 'i': case 'j': case 'k': case 'l': case 'm': case 'n':
3202   case 'o': case 'p': case 'q': case 'r': case 's': case 't':    /*'u'*/
3203   case 'v': case 'w': case 'x': case 'y': case 'z':
3204   case '_':
3205     // Notify MIOpt that we read a non-whitespace/non-comment token.
3206     MIOpt.ReadToken();
3207     return LexIdentifier(Result, CurPtr);
3208 
3209   case '$':   // $ in identifiers.
3210     if (LangOpts.DollarIdents) {
3211       if (!isLexingRawMode())
3212         Diag(CurPtr-1, diag::ext_dollar_in_identifier);
3213       // Notify MIOpt that we read a non-whitespace/non-comment token.
3214       MIOpt.ReadToken();
3215       return LexIdentifier(Result, CurPtr);
3216     }
3217 
3218     Kind = tok::unknown;
3219     break;
3220 
3221   // C99 6.4.4: Character Constants.
3222   case '\'':
3223     // Notify MIOpt that we read a non-whitespace/non-comment token.
3224     MIOpt.ReadToken();
3225     return LexCharConstant(Result, CurPtr, tok::char_constant);
3226 
3227   // C99 6.4.5: String Literals.
3228   case '"':
3229     // Notify MIOpt that we read a non-whitespace/non-comment token.
3230     MIOpt.ReadToken();
3231     return LexStringLiteral(Result, CurPtr, tok::string_literal);
3232 
3233   // C99 6.4.6: Punctuators.
3234   case '?':
3235     Kind = tok::question;
3236     break;
3237   case '[':
3238     Kind = tok::l_square;
3239     break;
3240   case ']':
3241     Kind = tok::r_square;
3242     break;
3243   case '(':
3244     Kind = tok::l_paren;
3245     break;
3246   case ')':
3247     Kind = tok::r_paren;
3248     break;
3249   case '{':
3250     Kind = tok::l_brace;
3251     break;
3252   case '}':
3253     Kind = tok::r_brace;
3254     break;
3255   case '.':
3256     Char = getCharAndSize(CurPtr, SizeTmp);
3257     if (Char >= '0' && Char <= '9') {
3258       // Notify MIOpt that we read a non-whitespace/non-comment token.
3259       MIOpt.ReadToken();
3260 
3261       return LexNumericConstant(Result, ConsumeChar(CurPtr, SizeTmp, Result));
3262     } else if (LangOpts.CPlusPlus && Char == '*') {
3263       Kind = tok::periodstar;
3264       CurPtr += SizeTmp;
3265     } else if (Char == '.' &&
3266                getCharAndSize(CurPtr+SizeTmp, SizeTmp2) == '.') {
3267       Kind = tok::ellipsis;
3268       CurPtr = ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3269                            SizeTmp2, Result);
3270     } else {
3271       Kind = tok::period;
3272     }
3273     break;
3274   case '&':
3275     Char = getCharAndSize(CurPtr, SizeTmp);
3276     if (Char == '&') {
3277       Kind = tok::ampamp;
3278       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3279     } else if (Char == '=') {
3280       Kind = tok::ampequal;
3281       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3282     } else {
3283       Kind = tok::amp;
3284     }
3285     break;
3286   case '*':
3287     if (getCharAndSize(CurPtr, SizeTmp) == '=') {
3288       Kind = tok::starequal;
3289       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3290     } else {
3291       Kind = tok::star;
3292     }
3293     break;
3294   case '+':
3295     Char = getCharAndSize(CurPtr, SizeTmp);
3296     if (Char == '+') {
3297       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3298       Kind = tok::plusplus;
3299     } else if (Char == '=') {
3300       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3301       Kind = tok::plusequal;
3302     } else {
3303       Kind = tok::plus;
3304     }
3305     break;
3306   case '-':
3307     Char = getCharAndSize(CurPtr, SizeTmp);
3308     if (Char == '-') {      // --
3309       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3310       Kind = tok::minusminus;
3311     } else if (Char == '>' && LangOpts.CPlusPlus &&
3312                getCharAndSize(CurPtr+SizeTmp, SizeTmp2) == '*') {  // C++ ->*
3313       CurPtr = ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3314                            SizeTmp2, Result);
3315       Kind = tok::arrowstar;
3316     } else if (Char == '>') {   // ->
3317       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3318       Kind = tok::arrow;
3319     } else if (Char == '=') {   // -=
3320       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3321       Kind = tok::minusequal;
3322     } else {
3323       Kind = tok::minus;
3324     }
3325     break;
3326   case '~':
3327     Kind = tok::tilde;
3328     break;
3329   case '!':
3330     if (getCharAndSize(CurPtr, SizeTmp) == '=') {
3331       Kind = tok::exclaimequal;
3332       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3333     } else {
3334       Kind = tok::exclaim;
3335     }
3336     break;
3337   case '/':
3338     // 6.4.9: Comments
3339     Char = getCharAndSize(CurPtr, SizeTmp);
3340     if (Char == '/') {         // Line comment.
3341       // Even if Line comments are disabled (e.g. in C89 mode), we generally
3342       // want to lex this as a comment.  There is one problem with this though,
3343       // that in one particular corner case, this can change the behavior of the
3344       // resultant program.  For example, In  "foo //**/ bar", C89 would lex
3345       // this as "foo / bar" and langauges with Line comments would lex it as
3346       // "foo".  Check to see if the character after the second slash is a '*'.
3347       // If so, we will lex that as a "/" instead of the start of a comment.
3348       // However, we never do this if we are just preprocessing.
3349       bool TreatAsComment = LangOpts.LineComment &&
3350                             (LangOpts.CPlusPlus || !LangOpts.TraditionalCPP);
3351       if (!TreatAsComment)
3352         if (!(PP && PP->isPreprocessedOutput()))
3353           TreatAsComment = getCharAndSize(CurPtr+SizeTmp, SizeTmp2) != '*';
3354 
3355       if (TreatAsComment) {
3356         if (SkipLineComment(Result, ConsumeChar(CurPtr, SizeTmp, Result),
3357                             TokAtPhysicalStartOfLine))
3358           return true; // There is a token to return.
3359 
3360         // It is common for the tokens immediately after a // comment to be
3361         // whitespace (indentation for the next line).  Instead of going through
3362         // the big switch, handle it efficiently now.
3363         goto SkipIgnoredUnits;
3364       }
3365     }
3366 
3367     if (Char == '*') {  // /**/ comment.
3368       if (SkipBlockComment(Result, ConsumeChar(CurPtr, SizeTmp, Result),
3369                            TokAtPhysicalStartOfLine))
3370         return true; // There is a token to return.
3371 
3372       // We only saw whitespace, so just try again with this lexer.
3373       // (We manually eliminate the tail call to avoid recursion.)
3374       goto LexNextToken;
3375     }
3376 
3377     if (Char == '=') {
3378       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3379       Kind = tok::slashequal;
3380     } else {
3381       Kind = tok::slash;
3382     }
3383     break;
3384   case '%':
3385     Char = getCharAndSize(CurPtr, SizeTmp);
3386     if (Char == '=') {
3387       Kind = tok::percentequal;
3388       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3389     } else if (LangOpts.Digraphs && Char == '>') {
3390       Kind = tok::r_brace;                             // '%>' -> '}'
3391       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3392     } else if (LangOpts.Digraphs && Char == ':') {
3393       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3394       Char = getCharAndSize(CurPtr, SizeTmp);
3395       if (Char == '%' && getCharAndSize(CurPtr+SizeTmp, SizeTmp2) == ':') {
3396         Kind = tok::hashhash;                          // '%:%:' -> '##'
3397         CurPtr = ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3398                              SizeTmp2, Result);
3399       } else if (Char == '@' && LangOpts.MicrosoftExt) {// %:@ -> #@ -> Charize
3400         CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3401         if (!isLexingRawMode())
3402           Diag(BufferPtr, diag::ext_charize_microsoft);
3403         Kind = tok::hashat;
3404       } else {                                         // '%:' -> '#'
3405         // We parsed a # character.  If this occurs at the start of the line,
3406         // it's actually the start of a preprocessing directive.  Callback to
3407         // the preprocessor to handle it.
3408         // TODO: -fpreprocessed mode??
3409         if (TokAtPhysicalStartOfLine && !LexingRawMode && !Is_PragmaLexer)
3410           goto HandleDirective;
3411 
3412         Kind = tok::hash;
3413       }
3414     } else {
3415       Kind = tok::percent;
3416     }
3417     break;
3418   case '<':
3419     Char = getCharAndSize(CurPtr, SizeTmp);
3420     if (ParsingFilename) {
3421       return LexAngledStringLiteral(Result, CurPtr);
3422     } else if (Char == '<') {
3423       char After = getCharAndSize(CurPtr+SizeTmp, SizeTmp2);
3424       if (After == '=') {
3425         Kind = tok::lesslessequal;
3426         CurPtr = ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3427                              SizeTmp2, Result);
3428       } else if (After == '<' && IsStartOfConflictMarker(CurPtr-1)) {
3429         // If this is actually a '<<<<<<<' version control conflict marker,
3430         // recognize it as such and recover nicely.
3431         goto LexNextToken;
3432       } else if (After == '<' && HandleEndOfConflictMarker(CurPtr-1)) {
3433         // If this is '<<<<' and we're in a Perforce-style conflict marker,
3434         // ignore it.
3435         goto LexNextToken;
3436       } else if (LangOpts.CUDA && After == '<') {
3437         Kind = tok::lesslessless;
3438         CurPtr = ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3439                              SizeTmp2, Result);
3440       } else {
3441         CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3442         Kind = tok::lessless;
3443       }
3444     } else if (Char == '=') {
3445       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3446       Kind = tok::lessequal;
3447     } else if (LangOpts.Digraphs && Char == ':') {     // '<:' -> '['
3448       if (LangOpts.CPlusPlus11 &&
3449           getCharAndSize(CurPtr + SizeTmp, SizeTmp2) == ':') {
3450         // C++0x [lex.pptoken]p3:
3451         //  Otherwise, if the next three characters are <:: and the subsequent
3452         //  character is neither : nor >, the < is treated as a preprocessor
3453         //  token by itself and not as the first character of the alternative
3454         //  token <:.
3455         unsigned SizeTmp3;
3456         char After = getCharAndSize(CurPtr + SizeTmp + SizeTmp2, SizeTmp3);
3457         if (After != ':' && After != '>') {
3458           Kind = tok::less;
3459           if (!isLexingRawMode())
3460             Diag(BufferPtr, diag::warn_cxx98_compat_less_colon_colon);
3461           break;
3462         }
3463       }
3464 
3465       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3466       Kind = tok::l_square;
3467     } else if (LangOpts.Digraphs && Char == '%') {     // '<%' -> '{'
3468       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3469       Kind = tok::l_brace;
3470     } else {
3471       Kind = tok::less;
3472     }
3473     break;
3474   case '>':
3475     Char = getCharAndSize(CurPtr, SizeTmp);
3476     if (Char == '=') {
3477       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3478       Kind = tok::greaterequal;
3479     } else if (Char == '>') {
3480       char After = getCharAndSize(CurPtr+SizeTmp, SizeTmp2);
3481       if (After == '=') {
3482         CurPtr = ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3483                              SizeTmp2, Result);
3484         Kind = tok::greatergreaterequal;
3485       } else if (After == '>' && IsStartOfConflictMarker(CurPtr-1)) {
3486         // If this is actually a '>>>>' conflict marker, recognize it as such
3487         // and recover nicely.
3488         goto LexNextToken;
3489       } else if (After == '>' && HandleEndOfConflictMarker(CurPtr-1)) {
3490         // If this is '>>>>>>>' and we're in a conflict marker, ignore it.
3491         goto LexNextToken;
3492       } else if (LangOpts.CUDA && After == '>') {
3493         Kind = tok::greatergreatergreater;
3494         CurPtr = ConsumeChar(ConsumeChar(CurPtr, SizeTmp, Result),
3495                              SizeTmp2, Result);
3496       } else {
3497         CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3498         Kind = tok::greatergreater;
3499       }
3500 
3501     } else {
3502       Kind = tok::greater;
3503     }
3504     break;
3505   case '^':
3506     Char = getCharAndSize(CurPtr, SizeTmp);
3507     if (Char == '=') {
3508       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3509       Kind = tok::caretequal;
3510     } else if (LangOpts.OpenCL && Char == '^') {
3511       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3512       Kind = tok::caretcaret;
3513     } else {
3514       Kind = tok::caret;
3515     }
3516     break;
3517   case '|':
3518     Char = getCharAndSize(CurPtr, SizeTmp);
3519     if (Char == '=') {
3520       Kind = tok::pipeequal;
3521       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3522     } else if (Char == '|') {
3523       // If this is '|||||||' and we're in a conflict marker, ignore it.
3524       if (CurPtr[1] == '|' && HandleEndOfConflictMarker(CurPtr-1))
3525         goto LexNextToken;
3526       Kind = tok::pipepipe;
3527       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3528     } else {
3529       Kind = tok::pipe;
3530     }
3531     break;
3532   case ':':
3533     Char = getCharAndSize(CurPtr, SizeTmp);
3534     if (LangOpts.Digraphs && Char == '>') {
3535       Kind = tok::r_square; // ':>' -> ']'
3536       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3537     } else if (LangOpts.CPlusPlus && Char == ':') {
3538       Kind = tok::coloncolon;
3539       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3540     } else {
3541       Kind = tok::colon;
3542     }
3543     break;
3544   case ';':
3545     Kind = tok::semi;
3546     break;
3547   case '=':
3548     Char = getCharAndSize(CurPtr, SizeTmp);
3549     if (Char == '=') {
3550       // If this is '====' and we're in a conflict marker, ignore it.
3551       if (CurPtr[1] == '=' && HandleEndOfConflictMarker(CurPtr-1))
3552         goto LexNextToken;
3553 
3554       Kind = tok::equalequal;
3555       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3556     } else {
3557       Kind = tok::equal;
3558     }
3559     break;
3560   case ',':
3561     Kind = tok::comma;
3562     break;
3563   case '#':
3564     Char = getCharAndSize(CurPtr, SizeTmp);
3565     if (Char == '#') {
3566       Kind = tok::hashhash;
3567       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3568     } else if (Char == '@' && LangOpts.MicrosoftExt) {  // #@ -> Charize
3569       Kind = tok::hashat;
3570       if (!isLexingRawMode())
3571         Diag(BufferPtr, diag::ext_charize_microsoft);
3572       CurPtr = ConsumeChar(CurPtr, SizeTmp, Result);
3573     } else {
3574       // We parsed a # character.  If this occurs at the start of the line,
3575       // it's actually the start of a preprocessing directive.  Callback to
3576       // the preprocessor to handle it.
3577       // TODO: -fpreprocessed mode??
3578       if (TokAtPhysicalStartOfLine && !LexingRawMode && !Is_PragmaLexer)
3579         goto HandleDirective;
3580 
3581       Kind = tok::hash;
3582     }
3583     break;
3584 
3585   case '@':
3586     // Objective C support.
3587     if (CurPtr[-1] == '@' && LangOpts.ObjC1)
3588       Kind = tok::at;
3589     else
3590       Kind = tok::unknown;
3591     break;
3592 
3593   // UCNs (C99 6.4.3, C++11 [lex.charset]p2)
3594   case '\\':
3595     if (uint32_t CodePoint = tryReadUCN(CurPtr, BufferPtr, &Result)) {
3596       if (CheckUnicodeWhitespace(Result, CodePoint, CurPtr)) {
3597         if (SkipWhitespace(Result, CurPtr, TokAtPhysicalStartOfLine))
3598           return true; // KeepWhitespaceMode
3599 
3600         // We only saw whitespace, so just try again with this lexer.
3601         // (We manually eliminate the tail call to avoid recursion.)
3602         goto LexNextToken;
3603       }
3604 
3605       return LexUnicode(Result, CodePoint, CurPtr);
3606     }
3607 
3608     Kind = tok::unknown;
3609     break;
3610 
3611   default: {
3612     if (isASCII(Char)) {
3613       Kind = tok::unknown;
3614       break;
3615     }
3616 
3617     UTF32 CodePoint;
3618 
3619     // We can't just reset CurPtr to BufferPtr because BufferPtr may point to
3620     // an escaped newline.
3621     --CurPtr;
3622     ConversionResult Status =
3623         llvm::convertUTF8Sequence((const UTF8 **)&CurPtr,
3624                                   (const UTF8 *)BufferEnd,
3625                                   &CodePoint,
3626                                   strictConversion);
3627     if (Status == conversionOK) {
3628       if (CheckUnicodeWhitespace(Result, CodePoint, CurPtr)) {
3629         if (SkipWhitespace(Result, CurPtr, TokAtPhysicalStartOfLine))
3630           return true; // KeepWhitespaceMode
3631 
3632         // We only saw whitespace, so just try again with this lexer.
3633         // (We manually eliminate the tail call to avoid recursion.)
3634         goto LexNextToken;
3635       }
3636       return LexUnicode(Result, CodePoint, CurPtr);
3637     }
3638 
3639     if (isLexingRawMode() || ParsingPreprocessorDirective ||
3640         PP->isPreprocessedOutput()) {
3641       ++CurPtr;
3642       Kind = tok::unknown;
3643       break;
3644     }
3645 
3646     // Non-ASCII characters tend to creep into source code unintentionally.
3647     // Instead of letting the parser complain about the unknown token,
3648     // just diagnose the invalid UTF-8, then drop the character.
3649     Diag(CurPtr, diag::err_invalid_utf8);
3650 
3651     BufferPtr = CurPtr+1;
3652     // We're pretending the character didn't exist, so just try again with
3653     // this lexer.
3654     // (We manually eliminate the tail call to avoid recursion.)
3655     goto LexNextToken;
3656   }
3657   }
3658 
3659   // Notify MIOpt that we read a non-whitespace/non-comment token.
3660   MIOpt.ReadToken();
3661 
3662   // Update the location of token as well as BufferPtr.
3663   FormTokenWithChars(Result, CurPtr, Kind);
3664   return true;
3665 
3666 HandleDirective:
3667   // We parsed a # character and it's the start of a preprocessing directive.
3668 
3669   FormTokenWithChars(Result, CurPtr, tok::hash);
3670   PP->HandleDirective(Result);
3671 
3672   if (PP->hadModuleLoaderFatalFailure()) {
3673     // With a fatal failure in the module loader, we abort parsing.
3674     assert(Result.is(tok::eof) && "Preprocessor did not set tok:eof");
3675     return true;
3676   }
3677 
3678   // We parsed the directive; lex a token with the new state.
3679   return false;
3680 }
3681