1 //===--- LiteralSupport.cpp - Code to parse and process literals ----------===//
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 NumericLiteralParser, CharLiteralParser, and
11 // StringLiteralParser interfaces.
12 //
13 //===----------------------------------------------------------------------===//
14 
15 #include "clang/Lex/LiteralSupport.h"
16 #include "clang/Basic/CharInfo.h"
17 #include "clang/Basic/TargetInfo.h"
18 #include "clang/Lex/LexDiagnostic.h"
19 #include "clang/Lex/Preprocessor.h"
20 #include "llvm/ADT/StringExtras.h"
21 #include "llvm/Support/ConvertUTF.h"
22 #include "llvm/Support/ErrorHandling.h"
23 
24 using namespace clang;
25 
26 static unsigned getCharWidth(tok::TokenKind kind, const TargetInfo &Target) {
27   switch (kind) {
28   default: llvm_unreachable("Unknown token type!");
29   case tok::char_constant:
30   case tok::string_literal:
31   case tok::utf8_char_constant:
32   case tok::utf8_string_literal:
33     return Target.getCharWidth();
34   case tok::wide_char_constant:
35   case tok::wide_string_literal:
36     return Target.getWCharWidth();
37   case tok::utf16_char_constant:
38   case tok::utf16_string_literal:
39     return Target.getChar16Width();
40   case tok::utf32_char_constant:
41   case tok::utf32_string_literal:
42     return Target.getChar32Width();
43   }
44 }
45 
46 static CharSourceRange MakeCharSourceRange(const LangOptions &Features,
47                                            FullSourceLoc TokLoc,
48                                            const char *TokBegin,
49                                            const char *TokRangeBegin,
50                                            const char *TokRangeEnd) {
51   SourceLocation Begin =
52     Lexer::AdvanceToTokenCharacter(TokLoc, TokRangeBegin - TokBegin,
53                                    TokLoc.getManager(), Features);
54   SourceLocation End =
55     Lexer::AdvanceToTokenCharacter(Begin, TokRangeEnd - TokRangeBegin,
56                                    TokLoc.getManager(), Features);
57   return CharSourceRange::getCharRange(Begin, End);
58 }
59 
60 /// \brief Produce a diagnostic highlighting some portion of a literal.
61 ///
62 /// Emits the diagnostic \p DiagID, highlighting the range of characters from
63 /// \p TokRangeBegin (inclusive) to \p TokRangeEnd (exclusive), which must be
64 /// a substring of a spelling buffer for the token beginning at \p TokBegin.
65 static DiagnosticBuilder Diag(DiagnosticsEngine *Diags,
66                               const LangOptions &Features, FullSourceLoc TokLoc,
67                               const char *TokBegin, const char *TokRangeBegin,
68                               const char *TokRangeEnd, unsigned DiagID) {
69   SourceLocation Begin =
70     Lexer::AdvanceToTokenCharacter(TokLoc, TokRangeBegin - TokBegin,
71                                    TokLoc.getManager(), Features);
72   return Diags->Report(Begin, DiagID) <<
73     MakeCharSourceRange(Features, TokLoc, TokBegin, TokRangeBegin, TokRangeEnd);
74 }
75 
76 /// ProcessCharEscape - Parse a standard C escape sequence, which can occur in
77 /// either a character or a string literal.
78 static unsigned ProcessCharEscape(const char *ThisTokBegin,
79                                   const char *&ThisTokBuf,
80                                   const char *ThisTokEnd, bool &HadError,
81                                   FullSourceLoc Loc, unsigned CharWidth,
82                                   DiagnosticsEngine *Diags,
83                                   const LangOptions &Features) {
84   const char *EscapeBegin = ThisTokBuf;
85 
86   // Skip the '\' char.
87   ++ThisTokBuf;
88 
89   // We know that this character can't be off the end of the buffer, because
90   // that would have been \", which would not have been the end of string.
91   unsigned ResultChar = *ThisTokBuf++;
92   switch (ResultChar) {
93   // These map to themselves.
94   case '\\': case '\'': case '"': case '?': break;
95 
96     // These have fixed mappings.
97   case 'a':
98     // TODO: K&R: the meaning of '\\a' is different in traditional C
99     ResultChar = 7;
100     break;
101   case 'b':
102     ResultChar = 8;
103     break;
104   case 'e':
105     if (Diags)
106       Diag(Diags, Features, Loc, ThisTokBegin, EscapeBegin, ThisTokBuf,
107            diag::ext_nonstandard_escape) << "e";
108     ResultChar = 27;
109     break;
110   case 'E':
111     if (Diags)
112       Diag(Diags, Features, Loc, ThisTokBegin, EscapeBegin, ThisTokBuf,
113            diag::ext_nonstandard_escape) << "E";
114     ResultChar = 27;
115     break;
116   case 'f':
117     ResultChar = 12;
118     break;
119   case 'n':
120     ResultChar = 10;
121     break;
122   case 'r':
123     ResultChar = 13;
124     break;
125   case 't':
126     ResultChar = 9;
127     break;
128   case 'v':
129     ResultChar = 11;
130     break;
131   case 'x': { // Hex escape.
132     ResultChar = 0;
133     if (ThisTokBuf == ThisTokEnd || !isHexDigit(*ThisTokBuf)) {
134       if (Diags)
135         Diag(Diags, Features, Loc, ThisTokBegin, EscapeBegin, ThisTokBuf,
136              diag::err_hex_escape_no_digits) << "x";
137       HadError = 1;
138       break;
139     }
140 
141     // Hex escapes are a maximal series of hex digits.
142     bool Overflow = false;
143     for (; ThisTokBuf != ThisTokEnd; ++ThisTokBuf) {
144       int CharVal = llvm::hexDigitValue(ThisTokBuf[0]);
145       if (CharVal == -1) break;
146       // About to shift out a digit?
147       if (ResultChar & 0xF0000000)
148         Overflow = true;
149       ResultChar <<= 4;
150       ResultChar |= CharVal;
151     }
152 
153     // See if any bits will be truncated when evaluated as a character.
154     if (CharWidth != 32 && (ResultChar >> CharWidth) != 0) {
155       Overflow = true;
156       ResultChar &= ~0U >> (32-CharWidth);
157     }
158 
159     // Check for overflow.
160     if (Overflow && Diags)   // Too many digits to fit in
161       Diag(Diags, Features, Loc, ThisTokBegin, EscapeBegin, ThisTokBuf,
162            diag::err_hex_escape_too_large);
163     break;
164   }
165   case '0': case '1': case '2': case '3':
166   case '4': case '5': case '6': case '7': {
167     // Octal escapes.
168     --ThisTokBuf;
169     ResultChar = 0;
170 
171     // Octal escapes are a series of octal digits with maximum length 3.
172     // "\0123" is a two digit sequence equal to "\012" "3".
173     unsigned NumDigits = 0;
174     do {
175       ResultChar <<= 3;
176       ResultChar |= *ThisTokBuf++ - '0';
177       ++NumDigits;
178     } while (ThisTokBuf != ThisTokEnd && NumDigits < 3 &&
179              ThisTokBuf[0] >= '0' && ThisTokBuf[0] <= '7');
180 
181     // Check for overflow.  Reject '\777', but not L'\777'.
182     if (CharWidth != 32 && (ResultChar >> CharWidth) != 0) {
183       if (Diags)
184         Diag(Diags, Features, Loc, ThisTokBegin, EscapeBegin, ThisTokBuf,
185              diag::err_octal_escape_too_large);
186       ResultChar &= ~0U >> (32-CharWidth);
187     }
188     break;
189   }
190 
191     // Otherwise, these are not valid escapes.
192   case '(': case '{': case '[': case '%':
193     // GCC accepts these as extensions.  We warn about them as such though.
194     if (Diags)
195       Diag(Diags, Features, Loc, ThisTokBegin, EscapeBegin, ThisTokBuf,
196            diag::ext_nonstandard_escape)
197         << std::string(1, ResultChar);
198     break;
199   default:
200     if (!Diags)
201       break;
202 
203     if (isPrintable(ResultChar))
204       Diag(Diags, Features, Loc, ThisTokBegin, EscapeBegin, ThisTokBuf,
205            diag::ext_unknown_escape)
206         << std::string(1, ResultChar);
207     else
208       Diag(Diags, Features, Loc, ThisTokBegin, EscapeBegin, ThisTokBuf,
209            diag::ext_unknown_escape)
210         << "x" + llvm::utohexstr(ResultChar);
211     break;
212   }
213 
214   return ResultChar;
215 }
216 
217 static void appendCodePoint(unsigned Codepoint,
218                             llvm::SmallVectorImpl<char> &Str) {
219   char ResultBuf[4];
220   char *ResultPtr = ResultBuf;
221   bool Res = llvm::ConvertCodePointToUTF8(Codepoint, ResultPtr);
222   (void)Res;
223   assert(Res && "Unexpected conversion failure");
224   Str.append(ResultBuf, ResultPtr);
225 }
226 
227 void clang::expandUCNs(SmallVectorImpl<char> &Buf, StringRef Input) {
228   for (StringRef::iterator I = Input.begin(), E = Input.end(); I != E; ++I) {
229     if (*I != '\\') {
230       Buf.push_back(*I);
231       continue;
232     }
233 
234     ++I;
235     assert(*I == 'u' || *I == 'U');
236 
237     unsigned NumHexDigits;
238     if (*I == 'u')
239       NumHexDigits = 4;
240     else
241       NumHexDigits = 8;
242 
243     assert(I + NumHexDigits <= E);
244 
245     uint32_t CodePoint = 0;
246     for (++I; NumHexDigits != 0; ++I, --NumHexDigits) {
247       unsigned Value = llvm::hexDigitValue(*I);
248       assert(Value != -1U);
249 
250       CodePoint <<= 4;
251       CodePoint += Value;
252     }
253 
254     appendCodePoint(CodePoint, Buf);
255     --I;
256   }
257 }
258 
259 /// ProcessUCNEscape - Read the Universal Character Name, check constraints and
260 /// return the UTF32.
261 static bool ProcessUCNEscape(const char *ThisTokBegin, const char *&ThisTokBuf,
262                              const char *ThisTokEnd,
263                              uint32_t &UcnVal, unsigned short &UcnLen,
264                              FullSourceLoc Loc, DiagnosticsEngine *Diags,
265                              const LangOptions &Features,
266                              bool in_char_string_literal = false) {
267   const char *UcnBegin = ThisTokBuf;
268 
269   // Skip the '\u' char's.
270   ThisTokBuf += 2;
271 
272   if (ThisTokBuf == ThisTokEnd || !isHexDigit(*ThisTokBuf)) {
273     if (Diags)
274       Diag(Diags, Features, Loc, ThisTokBegin, UcnBegin, ThisTokBuf,
275            diag::err_hex_escape_no_digits) << StringRef(&ThisTokBuf[-1], 1);
276     return false;
277   }
278   UcnLen = (ThisTokBuf[-1] == 'u' ? 4 : 8);
279   unsigned short UcnLenSave = UcnLen;
280   for (; ThisTokBuf != ThisTokEnd && UcnLenSave; ++ThisTokBuf, UcnLenSave--) {
281     int CharVal = llvm::hexDigitValue(ThisTokBuf[0]);
282     if (CharVal == -1) break;
283     UcnVal <<= 4;
284     UcnVal |= CharVal;
285   }
286   // If we didn't consume the proper number of digits, there is a problem.
287   if (UcnLenSave) {
288     if (Diags)
289       Diag(Diags, Features, Loc, ThisTokBegin, UcnBegin, ThisTokBuf,
290            diag::err_ucn_escape_incomplete);
291     return false;
292   }
293 
294   // Check UCN constraints (C99 6.4.3p2) [C++11 lex.charset p2]
295   if ((0xD800 <= UcnVal && UcnVal <= 0xDFFF) || // surrogate codepoints
296       UcnVal > 0x10FFFF) {                      // maximum legal UTF32 value
297     if (Diags)
298       Diag(Diags, Features, Loc, ThisTokBegin, UcnBegin, ThisTokBuf,
299            diag::err_ucn_escape_invalid);
300     return false;
301   }
302 
303   // C++11 allows UCNs that refer to control characters and basic source
304   // characters inside character and string literals
305   if (UcnVal < 0xa0 &&
306       (UcnVal != 0x24 && UcnVal != 0x40 && UcnVal != 0x60)) {  // $, @, `
307     bool IsError = (!Features.CPlusPlus11 || !in_char_string_literal);
308     if (Diags) {
309       char BasicSCSChar = UcnVal;
310       if (UcnVal >= 0x20 && UcnVal < 0x7f)
311         Diag(Diags, Features, Loc, ThisTokBegin, UcnBegin, ThisTokBuf,
312              IsError ? diag::err_ucn_escape_basic_scs :
313                        diag::warn_cxx98_compat_literal_ucn_escape_basic_scs)
314             << StringRef(&BasicSCSChar, 1);
315       else
316         Diag(Diags, Features, Loc, ThisTokBegin, UcnBegin, ThisTokBuf,
317              IsError ? diag::err_ucn_control_character :
318                        diag::warn_cxx98_compat_literal_ucn_control_character);
319     }
320     if (IsError)
321       return false;
322   }
323 
324   if (!Features.CPlusPlus && !Features.C99 && Diags)
325     Diag(Diags, Features, Loc, ThisTokBegin, UcnBegin, ThisTokBuf,
326          diag::warn_ucn_not_valid_in_c89_literal);
327 
328   return true;
329 }
330 
331 /// MeasureUCNEscape - Determine the number of bytes within the resulting string
332 /// which this UCN will occupy.
333 static int MeasureUCNEscape(const char *ThisTokBegin, const char *&ThisTokBuf,
334                             const char *ThisTokEnd, unsigned CharByteWidth,
335                             const LangOptions &Features, bool &HadError) {
336   // UTF-32: 4 bytes per escape.
337   if (CharByteWidth == 4)
338     return 4;
339 
340   uint32_t UcnVal = 0;
341   unsigned short UcnLen = 0;
342   FullSourceLoc Loc;
343 
344   if (!ProcessUCNEscape(ThisTokBegin, ThisTokBuf, ThisTokEnd, UcnVal,
345                         UcnLen, Loc, nullptr, Features, true)) {
346     HadError = true;
347     return 0;
348   }
349 
350   // UTF-16: 2 bytes for BMP, 4 bytes otherwise.
351   if (CharByteWidth == 2)
352     return UcnVal <= 0xFFFF ? 2 : 4;
353 
354   // UTF-8.
355   if (UcnVal < 0x80)
356     return 1;
357   if (UcnVal < 0x800)
358     return 2;
359   if (UcnVal < 0x10000)
360     return 3;
361   return 4;
362 }
363 
364 /// EncodeUCNEscape - Read the Universal Character Name, check constraints and
365 /// convert the UTF32 to UTF8 or UTF16. This is a subroutine of
366 /// StringLiteralParser. When we decide to implement UCN's for identifiers,
367 /// we will likely rework our support for UCN's.
368 static void EncodeUCNEscape(const char *ThisTokBegin, const char *&ThisTokBuf,
369                             const char *ThisTokEnd,
370                             char *&ResultBuf, bool &HadError,
371                             FullSourceLoc Loc, unsigned CharByteWidth,
372                             DiagnosticsEngine *Diags,
373                             const LangOptions &Features) {
374   typedef uint32_t UTF32;
375   UTF32 UcnVal = 0;
376   unsigned short UcnLen = 0;
377   if (!ProcessUCNEscape(ThisTokBegin, ThisTokBuf, ThisTokEnd, UcnVal, UcnLen,
378                         Loc, Diags, Features, true)) {
379     HadError = true;
380     return;
381   }
382 
383   assert((CharByteWidth == 1 || CharByteWidth == 2 || CharByteWidth == 4) &&
384          "only character widths of 1, 2, or 4 bytes supported");
385 
386   (void)UcnLen;
387   assert((UcnLen== 4 || UcnLen== 8) && "only ucn length of 4 or 8 supported");
388 
389   if (CharByteWidth == 4) {
390     // FIXME: Make the type of the result buffer correct instead of
391     // using reinterpret_cast.
392     UTF32 *ResultPtr = reinterpret_cast<UTF32*>(ResultBuf);
393     *ResultPtr = UcnVal;
394     ResultBuf += 4;
395     return;
396   }
397 
398   if (CharByteWidth == 2) {
399     // FIXME: Make the type of the result buffer correct instead of
400     // using reinterpret_cast.
401     UTF16 *ResultPtr = reinterpret_cast<UTF16*>(ResultBuf);
402 
403     if (UcnVal <= (UTF32)0xFFFF) {
404       *ResultPtr = UcnVal;
405       ResultBuf += 2;
406       return;
407     }
408 
409     // Convert to UTF16.
410     UcnVal -= 0x10000;
411     *ResultPtr     = 0xD800 + (UcnVal >> 10);
412     *(ResultPtr+1) = 0xDC00 + (UcnVal & 0x3FF);
413     ResultBuf += 4;
414     return;
415   }
416 
417   assert(CharByteWidth == 1 && "UTF-8 encoding is only for 1 byte characters");
418 
419   // Now that we've parsed/checked the UCN, we convert from UTF32->UTF8.
420   // The conversion below was inspired by:
421   //   http://www.unicode.org/Public/PROGRAMS/CVTUTF/ConvertUTF.c
422   // First, we determine how many bytes the result will require.
423   typedef uint8_t UTF8;
424 
425   unsigned short bytesToWrite = 0;
426   if (UcnVal < (UTF32)0x80)
427     bytesToWrite = 1;
428   else if (UcnVal < (UTF32)0x800)
429     bytesToWrite = 2;
430   else if (UcnVal < (UTF32)0x10000)
431     bytesToWrite = 3;
432   else
433     bytesToWrite = 4;
434 
435   const unsigned byteMask = 0xBF;
436   const unsigned byteMark = 0x80;
437 
438   // Once the bits are split out into bytes of UTF8, this is a mask OR-ed
439   // into the first byte, depending on how many bytes follow.
440   static const UTF8 firstByteMark[5] = {
441     0x00, 0x00, 0xC0, 0xE0, 0xF0
442   };
443   // Finally, we write the bytes into ResultBuf.
444   ResultBuf += bytesToWrite;
445   switch (bytesToWrite) { // note: everything falls through.
446   case 4: *--ResultBuf = (UTF8)((UcnVal | byteMark) & byteMask); UcnVal >>= 6;
447   case 3: *--ResultBuf = (UTF8)((UcnVal | byteMark) & byteMask); UcnVal >>= 6;
448   case 2: *--ResultBuf = (UTF8)((UcnVal | byteMark) & byteMask); UcnVal >>= 6;
449   case 1: *--ResultBuf = (UTF8) (UcnVal | firstByteMark[bytesToWrite]);
450   }
451   // Update the buffer.
452   ResultBuf += bytesToWrite;
453 }
454 
455 
456 ///       integer-constant: [C99 6.4.4.1]
457 ///         decimal-constant integer-suffix
458 ///         octal-constant integer-suffix
459 ///         hexadecimal-constant integer-suffix
460 ///         binary-literal integer-suffix [GNU, C++1y]
461 ///       user-defined-integer-literal: [C++11 lex.ext]
462 ///         decimal-literal ud-suffix
463 ///         octal-literal ud-suffix
464 ///         hexadecimal-literal ud-suffix
465 ///         binary-literal ud-suffix [GNU, C++1y]
466 ///       decimal-constant:
467 ///         nonzero-digit
468 ///         decimal-constant digit
469 ///       octal-constant:
470 ///         0
471 ///         octal-constant octal-digit
472 ///       hexadecimal-constant:
473 ///         hexadecimal-prefix hexadecimal-digit
474 ///         hexadecimal-constant hexadecimal-digit
475 ///       hexadecimal-prefix: one of
476 ///         0x 0X
477 ///       binary-literal:
478 ///         0b binary-digit
479 ///         0B binary-digit
480 ///         binary-literal binary-digit
481 ///       integer-suffix:
482 ///         unsigned-suffix [long-suffix]
483 ///         unsigned-suffix [long-long-suffix]
484 ///         long-suffix [unsigned-suffix]
485 ///         long-long-suffix [unsigned-sufix]
486 ///       nonzero-digit:
487 ///         1 2 3 4 5 6 7 8 9
488 ///       octal-digit:
489 ///         0 1 2 3 4 5 6 7
490 ///       hexadecimal-digit:
491 ///         0 1 2 3 4 5 6 7 8 9
492 ///         a b c d e f
493 ///         A B C D E F
494 ///       binary-digit:
495 ///         0
496 ///         1
497 ///       unsigned-suffix: one of
498 ///         u U
499 ///       long-suffix: one of
500 ///         l L
501 ///       long-long-suffix: one of
502 ///         ll LL
503 ///
504 ///       floating-constant: [C99 6.4.4.2]
505 ///         TODO: add rules...
506 ///
507 NumericLiteralParser::NumericLiteralParser(StringRef TokSpelling,
508                                            SourceLocation TokLoc,
509                                            Preprocessor &PP)
510   : PP(PP), ThisTokBegin(TokSpelling.begin()), ThisTokEnd(TokSpelling.end()) {
511 
512   // This routine assumes that the range begin/end matches the regex for integer
513   // and FP constants (specifically, the 'pp-number' regex), and assumes that
514   // the byte at "*end" is both valid and not part of the regex.  Because of
515   // this, it doesn't have to check for 'overscan' in various places.
516   assert(!isPreprocessingNumberBody(*ThisTokEnd) && "didn't maximally munch?");
517 
518   s = DigitsBegin = ThisTokBegin;
519   saw_exponent = false;
520   saw_period = false;
521   saw_ud_suffix = false;
522   isLong = false;
523   isUnsigned = false;
524   isLongLong = false;
525   isFloat = false;
526   isImaginary = false;
527   MicrosoftInteger = 0;
528   hadError = false;
529 
530   if (*s == '0') { // parse radix
531     ParseNumberStartingWithZero(TokLoc);
532     if (hadError)
533       return;
534   } else { // the first digit is non-zero
535     radix = 10;
536     s = SkipDigits(s);
537     if (s == ThisTokEnd) {
538       // Done.
539     } else if (isHexDigit(*s) && !(*s == 'e' || *s == 'E')) {
540       PP.Diag(PP.AdvanceToTokenCharacter(TokLoc, s - ThisTokBegin),
541               diag::err_invalid_decimal_digit) << StringRef(s, 1);
542       hadError = true;
543       return;
544     } else if (*s == '.') {
545       checkSeparator(TokLoc, s, CSK_AfterDigits);
546       s++;
547       saw_period = true;
548       checkSeparator(TokLoc, s, CSK_BeforeDigits);
549       s = SkipDigits(s);
550     }
551     if ((*s == 'e' || *s == 'E')) { // exponent
552       checkSeparator(TokLoc, s, CSK_AfterDigits);
553       const char *Exponent = s;
554       s++;
555       saw_exponent = true;
556       if (*s == '+' || *s == '-')  s++; // sign
557       checkSeparator(TokLoc, s, CSK_BeforeDigits);
558       const char *first_non_digit = SkipDigits(s);
559       if (first_non_digit != s) {
560         s = first_non_digit;
561       } else {
562         PP.Diag(PP.AdvanceToTokenCharacter(TokLoc, Exponent - ThisTokBegin),
563                 diag::err_exponent_has_no_digits);
564         hadError = true;
565         return;
566       }
567     }
568   }
569 
570   SuffixBegin = s;
571   checkSeparator(TokLoc, s, CSK_AfterDigits);
572 
573   // Parse the suffix.  At this point we can classify whether we have an FP or
574   // integer constant.
575   bool isFPConstant = isFloatingLiteral();
576   const char *ImaginarySuffixLoc = nullptr;
577 
578   // Loop over all of the characters of the suffix.  If we see something bad,
579   // we break out of the loop.
580   for (; s != ThisTokEnd; ++s) {
581     switch (*s) {
582     case 'f':      // FP Suffix for "float"
583     case 'F':
584       if (!isFPConstant) break;  // Error for integer constant.
585       if (isFloat || isLong) break; // FF, LF invalid.
586       isFloat = true;
587       continue;  // Success.
588     case 'u':
589     case 'U':
590       if (isFPConstant) break;  // Error for floating constant.
591       if (isUnsigned) break;    // Cannot be repeated.
592       isUnsigned = true;
593       continue;  // Success.
594     case 'l':
595     case 'L':
596       if (isLong || isLongLong) break;  // Cannot be repeated.
597       if (isFloat) break;               // LF invalid.
598 
599       // Check for long long.  The L's need to be adjacent and the same case.
600       if (s[1] == s[0]) {
601         assert(s + 1 < ThisTokEnd && "didn't maximally munch?");
602         if (isFPConstant) break;        // long long invalid for floats.
603         isLongLong = true;
604         ++s;  // Eat both of them.
605       } else {
606         isLong = true;
607       }
608       continue;  // Success.
609     case 'i':
610     case 'I':
611       if (PP.getLangOpts().MicrosoftExt) {
612         if (isLong || isLongLong || MicrosoftInteger)
613           break;
614 
615         if (!isFPConstant) {
616           // Allow i8, i16, i32, and i64.
617           switch (s[1]) {
618           case '8':
619             s += 2; // i8 suffix
620             MicrosoftInteger = 8;
621             break;
622           case '1':
623             if (s[2] == '6') {
624               s += 3; // i16 suffix
625               MicrosoftInteger = 16;
626             }
627             break;
628           case '3':
629             if (s[2] == '2') {
630               s += 3; // i32 suffix
631               MicrosoftInteger = 32;
632             }
633             break;
634           case '6':
635             if (s[2] == '4') {
636               s += 3; // i64 suffix
637               MicrosoftInteger = 64;
638             }
639             break;
640           default:
641             break;
642           }
643         }
644         if (MicrosoftInteger) {
645           assert(s <= ThisTokEnd && "didn't maximally munch?");
646           break;
647         }
648       }
649       // "i", "if", and "il" are user-defined suffixes in C++1y.
650       if (*s == 'i' && PP.getLangOpts().CPlusPlus14)
651         break;
652       // fall through.
653     case 'j':
654     case 'J':
655       if (isImaginary) break;   // Cannot be repeated.
656       isImaginary = true;
657       ImaginarySuffixLoc = s;
658       continue;  // Success.
659     }
660     // If we reached here, there was an error or a ud-suffix.
661     break;
662   }
663 
664   if (s != ThisTokEnd) {
665     // FIXME: Don't bother expanding UCNs if !tok.hasUCN().
666     expandUCNs(UDSuffixBuf, StringRef(SuffixBegin, ThisTokEnd - SuffixBegin));
667     if (isValidUDSuffix(PP.getLangOpts(), UDSuffixBuf)) {
668       // Any suffix pieces we might have parsed are actually part of the
669       // ud-suffix.
670       isLong = false;
671       isUnsigned = false;
672       isLongLong = false;
673       isFloat = false;
674       isImaginary = false;
675       MicrosoftInteger = 0;
676 
677       saw_ud_suffix = true;
678       return;
679     }
680 
681     // Report an error if there are any.
682     PP.Diag(PP.AdvanceToTokenCharacter(TokLoc, SuffixBegin - ThisTokBegin),
683             isFPConstant ? diag::err_invalid_suffix_float_constant :
684                            diag::err_invalid_suffix_integer_constant)
685       << StringRef(SuffixBegin, ThisTokEnd-SuffixBegin);
686     hadError = true;
687     return;
688   }
689 
690   if (isImaginary) {
691     PP.Diag(PP.AdvanceToTokenCharacter(TokLoc,
692                                        ImaginarySuffixLoc - ThisTokBegin),
693             diag::ext_imaginary_constant);
694   }
695 }
696 
697 /// Determine whether a suffix is a valid ud-suffix. We avoid treating reserved
698 /// suffixes as ud-suffixes, because the diagnostic experience is better if we
699 /// treat it as an invalid suffix.
700 bool NumericLiteralParser::isValidUDSuffix(const LangOptions &LangOpts,
701                                            StringRef Suffix) {
702   if (!LangOpts.CPlusPlus11 || Suffix.empty())
703     return false;
704 
705   // By C++11 [lex.ext]p10, ud-suffixes starting with an '_' are always valid.
706   if (Suffix[0] == '_')
707     return true;
708 
709   // In C++11, there are no library suffixes.
710   if (!LangOpts.CPlusPlus14)
711     return false;
712 
713   // In C++1y, "s", "h", "min", "ms", "us", and "ns" are used in the library.
714   // Per tweaked N3660, "il", "i", and "if" are also used in the library.
715   return llvm::StringSwitch<bool>(Suffix)
716       .Cases("h", "min", "s", true)
717       .Cases("ms", "us", "ns", true)
718       .Cases("il", "i", "if", true)
719       .Default(false);
720 }
721 
722 void NumericLiteralParser::checkSeparator(SourceLocation TokLoc,
723                                           const char *Pos,
724                                           CheckSeparatorKind IsAfterDigits) {
725   if (IsAfterDigits == CSK_AfterDigits) {
726     if (Pos == ThisTokBegin)
727       return;
728     --Pos;
729   } else if (Pos == ThisTokEnd)
730     return;
731 
732   if (isDigitSeparator(*Pos))
733     PP.Diag(PP.AdvanceToTokenCharacter(TokLoc, Pos - ThisTokBegin),
734             diag::err_digit_separator_not_between_digits)
735       << IsAfterDigits;
736 }
737 
738 /// ParseNumberStartingWithZero - This method is called when the first character
739 /// of the number is found to be a zero.  This means it is either an octal
740 /// number (like '04') or a hex number ('0x123a') a binary number ('0b1010') or
741 /// a floating point number (01239.123e4).  Eat the prefix, determining the
742 /// radix etc.
743 void NumericLiteralParser::ParseNumberStartingWithZero(SourceLocation TokLoc) {
744   assert(s[0] == '0' && "Invalid method call");
745   s++;
746 
747   int c1 = s[0];
748 
749   // Handle a hex number like 0x1234.
750   if ((c1 == 'x' || c1 == 'X') && (isHexDigit(s[1]) || s[1] == '.')) {
751     s++;
752     assert(s < ThisTokEnd && "didn't maximally munch?");
753     radix = 16;
754     DigitsBegin = s;
755     s = SkipHexDigits(s);
756     bool noSignificand = (s == DigitsBegin);
757     if (s == ThisTokEnd) {
758       // Done.
759     } else if (*s == '.') {
760       s++;
761       saw_period = true;
762       const char *floatDigitsBegin = s;
763       checkSeparator(TokLoc, s, CSK_BeforeDigits);
764       s = SkipHexDigits(s);
765       noSignificand &= (floatDigitsBegin == s);
766     }
767 
768     if (noSignificand) {
769       PP.Diag(PP.AdvanceToTokenCharacter(TokLoc, s - ThisTokBegin),
770         diag::err_hexconstant_requires_digits);
771       hadError = true;
772       return;
773     }
774 
775     // A binary exponent can appear with or with a '.'. If dotted, the
776     // binary exponent is required.
777     if (*s == 'p' || *s == 'P') {
778       checkSeparator(TokLoc, s, CSK_AfterDigits);
779       const char *Exponent = s;
780       s++;
781       saw_exponent = true;
782       if (*s == '+' || *s == '-')  s++; // sign
783       const char *first_non_digit = SkipDigits(s);
784       if (first_non_digit == s) {
785         PP.Diag(PP.AdvanceToTokenCharacter(TokLoc, Exponent-ThisTokBegin),
786                 diag::err_exponent_has_no_digits);
787         hadError = true;
788         return;
789       }
790       checkSeparator(TokLoc, s, CSK_BeforeDigits);
791       s = first_non_digit;
792 
793       if (!PP.getLangOpts().HexFloats)
794         PP.Diag(TokLoc, diag::ext_hexconstant_invalid);
795     } else if (saw_period) {
796       PP.Diag(PP.AdvanceToTokenCharacter(TokLoc, s-ThisTokBegin),
797               diag::err_hexconstant_requires_exponent);
798       hadError = true;
799     }
800     return;
801   }
802 
803   // Handle simple binary numbers 0b01010
804   if ((c1 == 'b' || c1 == 'B') && (s[1] == '0' || s[1] == '1')) {
805     // 0b101010 is a C++1y / GCC extension.
806     PP.Diag(TokLoc,
807             PP.getLangOpts().CPlusPlus14
808               ? diag::warn_cxx11_compat_binary_literal
809               : PP.getLangOpts().CPlusPlus
810                 ? diag::ext_binary_literal_cxx14
811                 : diag::ext_binary_literal);
812     ++s;
813     assert(s < ThisTokEnd && "didn't maximally munch?");
814     radix = 2;
815     DigitsBegin = s;
816     s = SkipBinaryDigits(s);
817     if (s == ThisTokEnd) {
818       // Done.
819     } else if (isHexDigit(*s)) {
820       PP.Diag(PP.AdvanceToTokenCharacter(TokLoc, s-ThisTokBegin),
821               diag::err_invalid_binary_digit) << StringRef(s, 1);
822       hadError = true;
823     }
824     // Other suffixes will be diagnosed by the caller.
825     return;
826   }
827 
828   // For now, the radix is set to 8. If we discover that we have a
829   // floating point constant, the radix will change to 10. Octal floating
830   // point constants are not permitted (only decimal and hexadecimal).
831   radix = 8;
832   DigitsBegin = s;
833   s = SkipOctalDigits(s);
834   if (s == ThisTokEnd)
835     return; // Done, simple octal number like 01234
836 
837   // If we have some other non-octal digit that *is* a decimal digit, see if
838   // this is part of a floating point number like 094.123 or 09e1.
839   if (isDigit(*s)) {
840     const char *EndDecimal = SkipDigits(s);
841     if (EndDecimal[0] == '.' || EndDecimal[0] == 'e' || EndDecimal[0] == 'E') {
842       s = EndDecimal;
843       radix = 10;
844     }
845   }
846 
847   // If we have a hex digit other than 'e' (which denotes a FP exponent) then
848   // the code is using an incorrect base.
849   if (isHexDigit(*s) && *s != 'e' && *s != 'E') {
850     PP.Diag(PP.AdvanceToTokenCharacter(TokLoc, s-ThisTokBegin),
851             diag::err_invalid_octal_digit) << StringRef(s, 1);
852     hadError = true;
853     return;
854   }
855 
856   if (*s == '.') {
857     s++;
858     radix = 10;
859     saw_period = true;
860     checkSeparator(TokLoc, s, CSK_BeforeDigits);
861     s = SkipDigits(s); // Skip suffix.
862   }
863   if (*s == 'e' || *s == 'E') { // exponent
864     checkSeparator(TokLoc, s, CSK_AfterDigits);
865     const char *Exponent = s;
866     s++;
867     radix = 10;
868     saw_exponent = true;
869     if (*s == '+' || *s == '-')  s++; // sign
870     const char *first_non_digit = SkipDigits(s);
871     if (first_non_digit != s) {
872       checkSeparator(TokLoc, s, CSK_BeforeDigits);
873       s = first_non_digit;
874     } else {
875       PP.Diag(PP.AdvanceToTokenCharacter(TokLoc, Exponent-ThisTokBegin),
876               diag::err_exponent_has_no_digits);
877       hadError = true;
878       return;
879     }
880   }
881 }
882 
883 static bool alwaysFitsInto64Bits(unsigned Radix, unsigned NumDigits) {
884   switch (Radix) {
885   case 2:
886     return NumDigits <= 64;
887   case 8:
888     return NumDigits <= 64 / 3; // Digits are groups of 3 bits.
889   case 10:
890     return NumDigits <= 19; // floor(log10(2^64))
891   case 16:
892     return NumDigits <= 64 / 4; // Digits are groups of 4 bits.
893   default:
894     llvm_unreachable("impossible Radix");
895   }
896 }
897 
898 /// GetIntegerValue - Convert this numeric literal value to an APInt that
899 /// matches Val's input width.  If there is an overflow, set Val to the low bits
900 /// of the result and return true.  Otherwise, return false.
901 bool NumericLiteralParser::GetIntegerValue(llvm::APInt &Val) {
902   // Fast path: Compute a conservative bound on the maximum number of
903   // bits per digit in this radix. If we can't possibly overflow a
904   // uint64 based on that bound then do the simple conversion to
905   // integer. This avoids the expensive overflow checking below, and
906   // handles the common cases that matter (small decimal integers and
907   // hex/octal values which don't overflow).
908   const unsigned NumDigits = SuffixBegin - DigitsBegin;
909   if (alwaysFitsInto64Bits(radix, NumDigits)) {
910     uint64_t N = 0;
911     for (const char *Ptr = DigitsBegin; Ptr != SuffixBegin; ++Ptr)
912       if (!isDigitSeparator(*Ptr))
913         N = N * radix + llvm::hexDigitValue(*Ptr);
914 
915     // This will truncate the value to Val's input width. Simply check
916     // for overflow by comparing.
917     Val = N;
918     return Val.getZExtValue() != N;
919   }
920 
921   Val = 0;
922   const char *Ptr = DigitsBegin;
923 
924   llvm::APInt RadixVal(Val.getBitWidth(), radix);
925   llvm::APInt CharVal(Val.getBitWidth(), 0);
926   llvm::APInt OldVal = Val;
927 
928   bool OverflowOccurred = false;
929   while (Ptr < SuffixBegin) {
930     if (isDigitSeparator(*Ptr)) {
931       ++Ptr;
932       continue;
933     }
934 
935     unsigned C = llvm::hexDigitValue(*Ptr++);
936 
937     // If this letter is out of bound for this radix, reject it.
938     assert(C < radix && "NumericLiteralParser ctor should have rejected this");
939 
940     CharVal = C;
941 
942     // Add the digit to the value in the appropriate radix.  If adding in digits
943     // made the value smaller, then this overflowed.
944     OldVal = Val;
945 
946     // Multiply by radix, did overflow occur on the multiply?
947     Val *= RadixVal;
948     OverflowOccurred |= Val.udiv(RadixVal) != OldVal;
949 
950     // Add value, did overflow occur on the value?
951     //   (a + b) ult b  <=> overflow
952     Val += CharVal;
953     OverflowOccurred |= Val.ult(CharVal);
954   }
955   return OverflowOccurred;
956 }
957 
958 llvm::APFloat::opStatus
959 NumericLiteralParser::GetFloatValue(llvm::APFloat &Result) {
960   using llvm::APFloat;
961 
962   unsigned n = std::min(SuffixBegin - ThisTokBegin, ThisTokEnd - ThisTokBegin);
963 
964   llvm::SmallString<16> Buffer;
965   StringRef Str(ThisTokBegin, n);
966   if (Str.find('\'') != StringRef::npos) {
967     Buffer.reserve(n);
968     std::remove_copy_if(Str.begin(), Str.end(), std::back_inserter(Buffer),
969                         &isDigitSeparator);
970     Str = Buffer;
971   }
972 
973   return Result.convertFromString(Str, APFloat::rmNearestTiesToEven);
974 }
975 
976 
977 /// \verbatim
978 ///       user-defined-character-literal: [C++11 lex.ext]
979 ///         character-literal ud-suffix
980 ///       ud-suffix:
981 ///         identifier
982 ///       character-literal: [C++11 lex.ccon]
983 ///         ' c-char-sequence '
984 ///         u' c-char-sequence '
985 ///         U' c-char-sequence '
986 ///         L' c-char-sequence '
987 ///       c-char-sequence:
988 ///         c-char
989 ///         c-char-sequence c-char
990 ///       c-char:
991 ///         any member of the source character set except the single-quote ',
992 ///           backslash \, or new-line character
993 ///         escape-sequence
994 ///         universal-character-name
995 ///       escape-sequence:
996 ///         simple-escape-sequence
997 ///         octal-escape-sequence
998 ///         hexadecimal-escape-sequence
999 ///       simple-escape-sequence:
1000 ///         one of \' \" \? \\ \a \b \f \n \r \t \v
1001 ///       octal-escape-sequence:
1002 ///         \ octal-digit
1003 ///         \ octal-digit octal-digit
1004 ///         \ octal-digit octal-digit octal-digit
1005 ///       hexadecimal-escape-sequence:
1006 ///         \x hexadecimal-digit
1007 ///         hexadecimal-escape-sequence hexadecimal-digit
1008 ///       universal-character-name: [C++11 lex.charset]
1009 ///         \u hex-quad
1010 ///         \U hex-quad hex-quad
1011 ///       hex-quad:
1012 ///         hex-digit hex-digit hex-digit hex-digit
1013 /// \endverbatim
1014 ///
1015 CharLiteralParser::CharLiteralParser(const char *begin, const char *end,
1016                                      SourceLocation Loc, Preprocessor &PP,
1017                                      tok::TokenKind kind) {
1018   // At this point we know that the character matches the regex "(L|u|U)?'.*'".
1019   HadError = false;
1020 
1021   Kind = kind;
1022 
1023   const char *TokBegin = begin;
1024 
1025   // Skip over wide character determinant.
1026   if (Kind != tok::char_constant)
1027     ++begin;
1028   if (Kind == tok::utf8_char_constant)
1029     ++begin;
1030 
1031   // Skip over the entry quote.
1032   assert(begin[0] == '\'' && "Invalid token lexed");
1033   ++begin;
1034 
1035   // Remove an optional ud-suffix.
1036   if (end[-1] != '\'') {
1037     const char *UDSuffixEnd = end;
1038     do {
1039       --end;
1040     } while (end[-1] != '\'');
1041     // FIXME: Don't bother with this if !tok.hasUCN().
1042     expandUCNs(UDSuffixBuf, StringRef(end, UDSuffixEnd - end));
1043     UDSuffixOffset = end - TokBegin;
1044   }
1045 
1046   // Trim the ending quote.
1047   assert(end != begin && "Invalid token lexed");
1048   --end;
1049 
1050   // FIXME: The "Value" is an uint64_t so we can handle char literals of
1051   // up to 64-bits.
1052   // FIXME: This extensively assumes that 'char' is 8-bits.
1053   assert(PP.getTargetInfo().getCharWidth() == 8 &&
1054          "Assumes char is 8 bits");
1055   assert(PP.getTargetInfo().getIntWidth() <= 64 &&
1056          (PP.getTargetInfo().getIntWidth() & 7) == 0 &&
1057          "Assumes sizeof(int) on target is <= 64 and a multiple of char");
1058   assert(PP.getTargetInfo().getWCharWidth() <= 64 &&
1059          "Assumes sizeof(wchar) on target is <= 64");
1060 
1061   SmallVector<uint32_t, 4> codepoint_buffer;
1062   codepoint_buffer.resize(end - begin);
1063   uint32_t *buffer_begin = &codepoint_buffer.front();
1064   uint32_t *buffer_end = buffer_begin + codepoint_buffer.size();
1065 
1066   // Unicode escapes representing characters that cannot be correctly
1067   // represented in a single code unit are disallowed in character literals
1068   // by this implementation.
1069   uint32_t largest_character_for_kind;
1070   if (tok::wide_char_constant == Kind) {
1071     largest_character_for_kind =
1072         0xFFFFFFFFu >> (32-PP.getTargetInfo().getWCharWidth());
1073   } else if (tok::utf8_char_constant == Kind) {
1074     largest_character_for_kind = 0x7F;
1075   } else if (tok::utf16_char_constant == Kind) {
1076     largest_character_for_kind = 0xFFFF;
1077   } else if (tok::utf32_char_constant == Kind) {
1078     largest_character_for_kind = 0x10FFFF;
1079   } else {
1080     largest_character_for_kind = 0x7Fu;
1081   }
1082 
1083   while (begin != end) {
1084     // Is this a span of non-escape characters?
1085     if (begin[0] != '\\') {
1086       char const *start = begin;
1087       do {
1088         ++begin;
1089       } while (begin != end && *begin != '\\');
1090 
1091       char const *tmp_in_start = start;
1092       uint32_t *tmp_out_start = buffer_begin;
1093       ConversionResult res =
1094           ConvertUTF8toUTF32(reinterpret_cast<UTF8 const **>(&start),
1095                              reinterpret_cast<UTF8 const *>(begin),
1096                              &buffer_begin, buffer_end, strictConversion);
1097       if (res != conversionOK) {
1098         // If we see bad encoding for unprefixed character literals, warn and
1099         // simply copy the byte values, for compatibility with gcc and
1100         // older versions of clang.
1101         bool NoErrorOnBadEncoding = isAscii();
1102         unsigned Msg = diag::err_bad_character_encoding;
1103         if (NoErrorOnBadEncoding)
1104           Msg = diag::warn_bad_character_encoding;
1105         PP.Diag(Loc, Msg);
1106         if (NoErrorOnBadEncoding) {
1107           start = tmp_in_start;
1108           buffer_begin = tmp_out_start;
1109           for (; start != begin; ++start, ++buffer_begin)
1110             *buffer_begin = static_cast<uint8_t>(*start);
1111         } else {
1112           HadError = true;
1113         }
1114       } else {
1115         for (; tmp_out_start < buffer_begin; ++tmp_out_start) {
1116           if (*tmp_out_start > largest_character_for_kind) {
1117             HadError = true;
1118             PP.Diag(Loc, diag::err_character_too_large);
1119           }
1120         }
1121       }
1122 
1123       continue;
1124     }
1125     // Is this a Universal Character Name escape?
1126     if (begin[1] == 'u' || begin[1] == 'U') {
1127       unsigned short UcnLen = 0;
1128       if (!ProcessUCNEscape(TokBegin, begin, end, *buffer_begin, UcnLen,
1129                             FullSourceLoc(Loc, PP.getSourceManager()),
1130                             &PP.getDiagnostics(), PP.getLangOpts(), true)) {
1131         HadError = true;
1132       } else if (*buffer_begin > largest_character_for_kind) {
1133         HadError = true;
1134         PP.Diag(Loc, diag::err_character_too_large);
1135       }
1136 
1137       ++buffer_begin;
1138       continue;
1139     }
1140     unsigned CharWidth = getCharWidth(Kind, PP.getTargetInfo());
1141     uint64_t result =
1142       ProcessCharEscape(TokBegin, begin, end, HadError,
1143                         FullSourceLoc(Loc,PP.getSourceManager()),
1144                         CharWidth, &PP.getDiagnostics(), PP.getLangOpts());
1145     *buffer_begin++ = result;
1146   }
1147 
1148   unsigned NumCharsSoFar = buffer_begin - &codepoint_buffer.front();
1149 
1150   if (NumCharsSoFar > 1) {
1151     if (isWide())
1152       PP.Diag(Loc, diag::warn_extraneous_char_constant);
1153     else if (isAscii() && NumCharsSoFar == 4)
1154       PP.Diag(Loc, diag::ext_four_char_character_literal);
1155     else if (isAscii())
1156       PP.Diag(Loc, diag::ext_multichar_character_literal);
1157     else
1158       PP.Diag(Loc, diag::err_multichar_utf_character_literal);
1159     IsMultiChar = true;
1160   } else {
1161     IsMultiChar = false;
1162   }
1163 
1164   llvm::APInt LitVal(PP.getTargetInfo().getIntWidth(), 0);
1165 
1166   // Narrow character literals act as though their value is concatenated
1167   // in this implementation, but warn on overflow.
1168   bool multi_char_too_long = false;
1169   if (isAscii() && isMultiChar()) {
1170     LitVal = 0;
1171     for (size_t i = 0; i < NumCharsSoFar; ++i) {
1172       // check for enough leading zeros to shift into
1173       multi_char_too_long |= (LitVal.countLeadingZeros() < 8);
1174       LitVal <<= 8;
1175       LitVal = LitVal + (codepoint_buffer[i] & 0xFF);
1176     }
1177   } else if (NumCharsSoFar > 0) {
1178     // otherwise just take the last character
1179     LitVal = buffer_begin[-1];
1180   }
1181 
1182   if (!HadError && multi_char_too_long) {
1183     PP.Diag(Loc, diag::warn_char_constant_too_large);
1184   }
1185 
1186   // Transfer the value from APInt to uint64_t
1187   Value = LitVal.getZExtValue();
1188 
1189   // If this is a single narrow character, sign extend it (e.g. '\xFF' is "-1")
1190   // if 'char' is signed for this target (C99 6.4.4.4p10).  Note that multiple
1191   // character constants are not sign extended in the this implementation:
1192   // '\xFF\xFF' = 65536 and '\x0\xFF' = 255, which matches GCC.
1193   if (isAscii() && NumCharsSoFar == 1 && (Value & 128) &&
1194       PP.getLangOpts().CharIsSigned)
1195     Value = (signed char)Value;
1196 }
1197 
1198 /// \verbatim
1199 ///       string-literal: [C++0x lex.string]
1200 ///         encoding-prefix " [s-char-sequence] "
1201 ///         encoding-prefix R raw-string
1202 ///       encoding-prefix:
1203 ///         u8
1204 ///         u
1205 ///         U
1206 ///         L
1207 ///       s-char-sequence:
1208 ///         s-char
1209 ///         s-char-sequence s-char
1210 ///       s-char:
1211 ///         any member of the source character set except the double-quote ",
1212 ///           backslash \, or new-line character
1213 ///         escape-sequence
1214 ///         universal-character-name
1215 ///       raw-string:
1216 ///         " d-char-sequence ( r-char-sequence ) d-char-sequence "
1217 ///       r-char-sequence:
1218 ///         r-char
1219 ///         r-char-sequence r-char
1220 ///       r-char:
1221 ///         any member of the source character set, except a right parenthesis )
1222 ///           followed by the initial d-char-sequence (which may be empty)
1223 ///           followed by a double quote ".
1224 ///       d-char-sequence:
1225 ///         d-char
1226 ///         d-char-sequence d-char
1227 ///       d-char:
1228 ///         any member of the basic source character set except:
1229 ///           space, the left parenthesis (, the right parenthesis ),
1230 ///           the backslash \, and the control characters representing horizontal
1231 ///           tab, vertical tab, form feed, and newline.
1232 ///       escape-sequence: [C++0x lex.ccon]
1233 ///         simple-escape-sequence
1234 ///         octal-escape-sequence
1235 ///         hexadecimal-escape-sequence
1236 ///       simple-escape-sequence:
1237 ///         one of \' \" \? \\ \a \b \f \n \r \t \v
1238 ///       octal-escape-sequence:
1239 ///         \ octal-digit
1240 ///         \ octal-digit octal-digit
1241 ///         \ octal-digit octal-digit octal-digit
1242 ///       hexadecimal-escape-sequence:
1243 ///         \x hexadecimal-digit
1244 ///         hexadecimal-escape-sequence hexadecimal-digit
1245 ///       universal-character-name:
1246 ///         \u hex-quad
1247 ///         \U hex-quad hex-quad
1248 ///       hex-quad:
1249 ///         hex-digit hex-digit hex-digit hex-digit
1250 /// \endverbatim
1251 ///
1252 StringLiteralParser::
1253 StringLiteralParser(ArrayRef<Token> StringToks,
1254                     Preprocessor &PP, bool Complain)
1255   : SM(PP.getSourceManager()), Features(PP.getLangOpts()),
1256     Target(PP.getTargetInfo()), Diags(Complain ? &PP.getDiagnostics() :nullptr),
1257     MaxTokenLength(0), SizeBound(0), CharByteWidth(0), Kind(tok::unknown),
1258     ResultPtr(ResultBuf.data()), hadError(false), Pascal(false) {
1259   init(StringToks);
1260 }
1261 
1262 void StringLiteralParser::init(ArrayRef<Token> StringToks){
1263   // The literal token may have come from an invalid source location (e.g. due
1264   // to a PCH error), in which case the token length will be 0.
1265   if (StringToks.empty() || StringToks[0].getLength() < 2)
1266     return DiagnoseLexingError(SourceLocation());
1267 
1268   // Scan all of the string portions, remember the max individual token length,
1269   // computing a bound on the concatenated string length, and see whether any
1270   // piece is a wide-string.  If any of the string portions is a wide-string
1271   // literal, the result is a wide-string literal [C99 6.4.5p4].
1272   assert(!StringToks.empty() && "expected at least one token");
1273   MaxTokenLength = StringToks[0].getLength();
1274   assert(StringToks[0].getLength() >= 2 && "literal token is invalid!");
1275   SizeBound = StringToks[0].getLength()-2;  // -2 for "".
1276   Kind = StringToks[0].getKind();
1277 
1278   hadError = false;
1279 
1280   // Implement Translation Phase #6: concatenation of string literals
1281   /// (C99 5.1.1.2p1).  The common case is only one string fragment.
1282   for (unsigned i = 1; i != StringToks.size(); ++i) {
1283     if (StringToks[i].getLength() < 2)
1284       return DiagnoseLexingError(StringToks[i].getLocation());
1285 
1286     // The string could be shorter than this if it needs cleaning, but this is a
1287     // reasonable bound, which is all we need.
1288     assert(StringToks[i].getLength() >= 2 && "literal token is invalid!");
1289     SizeBound += StringToks[i].getLength()-2;  // -2 for "".
1290 
1291     // Remember maximum string piece length.
1292     if (StringToks[i].getLength() > MaxTokenLength)
1293       MaxTokenLength = StringToks[i].getLength();
1294 
1295     // Remember if we see any wide or utf-8/16/32 strings.
1296     // Also check for illegal concatenations.
1297     if (StringToks[i].isNot(Kind) && StringToks[i].isNot(tok::string_literal)) {
1298       if (isAscii()) {
1299         Kind = StringToks[i].getKind();
1300       } else {
1301         if (Diags)
1302           Diags->Report(StringToks[i].getLocation(),
1303                         diag::err_unsupported_string_concat);
1304         hadError = true;
1305       }
1306     }
1307   }
1308 
1309   // Include space for the null terminator.
1310   ++SizeBound;
1311 
1312   // TODO: K&R warning: "traditional C rejects string constant concatenation"
1313 
1314   // Get the width in bytes of char/wchar_t/char16_t/char32_t
1315   CharByteWidth = getCharWidth(Kind, Target);
1316   assert((CharByteWidth & 7) == 0 && "Assumes character size is byte multiple");
1317   CharByteWidth /= 8;
1318 
1319   // The output buffer size needs to be large enough to hold wide characters.
1320   // This is a worst-case assumption which basically corresponds to L"" "long".
1321   SizeBound *= CharByteWidth;
1322 
1323   // Size the temporary buffer to hold the result string data.
1324   ResultBuf.resize(SizeBound);
1325 
1326   // Likewise, but for each string piece.
1327   SmallString<512> TokenBuf;
1328   TokenBuf.resize(MaxTokenLength);
1329 
1330   // Loop over all the strings, getting their spelling, and expanding them to
1331   // wide strings as appropriate.
1332   ResultPtr = &ResultBuf[0];   // Next byte to fill in.
1333 
1334   Pascal = false;
1335 
1336   SourceLocation UDSuffixTokLoc;
1337 
1338   for (unsigned i = 0, e = StringToks.size(); i != e; ++i) {
1339     const char *ThisTokBuf = &TokenBuf[0];
1340     // Get the spelling of the token, which eliminates trigraphs, etc.  We know
1341     // that ThisTokBuf points to a buffer that is big enough for the whole token
1342     // and 'spelled' tokens can only shrink.
1343     bool StringInvalid = false;
1344     unsigned ThisTokLen =
1345       Lexer::getSpelling(StringToks[i], ThisTokBuf, SM, Features,
1346                          &StringInvalid);
1347     if (StringInvalid)
1348       return DiagnoseLexingError(StringToks[i].getLocation());
1349 
1350     const char *ThisTokBegin = ThisTokBuf;
1351     const char *ThisTokEnd = ThisTokBuf+ThisTokLen;
1352 
1353     // Remove an optional ud-suffix.
1354     if (ThisTokEnd[-1] != '"') {
1355       const char *UDSuffixEnd = ThisTokEnd;
1356       do {
1357         --ThisTokEnd;
1358       } while (ThisTokEnd[-1] != '"');
1359 
1360       StringRef UDSuffix(ThisTokEnd, UDSuffixEnd - ThisTokEnd);
1361 
1362       if (UDSuffixBuf.empty()) {
1363         if (StringToks[i].hasUCN())
1364           expandUCNs(UDSuffixBuf, UDSuffix);
1365         else
1366           UDSuffixBuf.assign(UDSuffix);
1367         UDSuffixToken = i;
1368         UDSuffixOffset = ThisTokEnd - ThisTokBuf;
1369         UDSuffixTokLoc = StringToks[i].getLocation();
1370       } else {
1371         SmallString<32> ExpandedUDSuffix;
1372         if (StringToks[i].hasUCN()) {
1373           expandUCNs(ExpandedUDSuffix, UDSuffix);
1374           UDSuffix = ExpandedUDSuffix;
1375         }
1376 
1377         // C++11 [lex.ext]p8: At the end of phase 6, if a string literal is the
1378         // result of a concatenation involving at least one user-defined-string-
1379         // literal, all the participating user-defined-string-literals shall
1380         // have the same ud-suffix.
1381         if (UDSuffixBuf != UDSuffix) {
1382           if (Diags) {
1383             SourceLocation TokLoc = StringToks[i].getLocation();
1384             Diags->Report(TokLoc, diag::err_string_concat_mixed_suffix)
1385               << UDSuffixBuf << UDSuffix
1386               << SourceRange(UDSuffixTokLoc, UDSuffixTokLoc)
1387               << SourceRange(TokLoc, TokLoc);
1388           }
1389           hadError = true;
1390         }
1391       }
1392     }
1393 
1394     // Strip the end quote.
1395     --ThisTokEnd;
1396 
1397     // TODO: Input character set mapping support.
1398 
1399     // Skip marker for wide or unicode strings.
1400     if (ThisTokBuf[0] == 'L' || ThisTokBuf[0] == 'u' || ThisTokBuf[0] == 'U') {
1401       ++ThisTokBuf;
1402       // Skip 8 of u8 marker for utf8 strings.
1403       if (ThisTokBuf[0] == '8')
1404         ++ThisTokBuf;
1405     }
1406 
1407     // Check for raw string
1408     if (ThisTokBuf[0] == 'R') {
1409       ThisTokBuf += 2; // skip R"
1410 
1411       const char *Prefix = ThisTokBuf;
1412       while (ThisTokBuf[0] != '(')
1413         ++ThisTokBuf;
1414       ++ThisTokBuf; // skip '('
1415 
1416       // Remove same number of characters from the end
1417       ThisTokEnd -= ThisTokBuf - Prefix;
1418       assert(ThisTokEnd >= ThisTokBuf && "malformed raw string literal");
1419 
1420       // Copy the string over
1421       if (CopyStringFragment(StringToks[i], ThisTokBegin,
1422                              StringRef(ThisTokBuf, ThisTokEnd - ThisTokBuf)))
1423         hadError = true;
1424     } else {
1425       if (ThisTokBuf[0] != '"') {
1426         // The file may have come from PCH and then changed after loading the
1427         // PCH; Fail gracefully.
1428         return DiagnoseLexingError(StringToks[i].getLocation());
1429       }
1430       ++ThisTokBuf; // skip "
1431 
1432       // Check if this is a pascal string
1433       if (Features.PascalStrings && ThisTokBuf + 1 != ThisTokEnd &&
1434           ThisTokBuf[0] == '\\' && ThisTokBuf[1] == 'p') {
1435 
1436         // If the \p sequence is found in the first token, we have a pascal string
1437         // Otherwise, if we already have a pascal string, ignore the first \p
1438         if (i == 0) {
1439           ++ThisTokBuf;
1440           Pascal = true;
1441         } else if (Pascal)
1442           ThisTokBuf += 2;
1443       }
1444 
1445       while (ThisTokBuf != ThisTokEnd) {
1446         // Is this a span of non-escape characters?
1447         if (ThisTokBuf[0] != '\\') {
1448           const char *InStart = ThisTokBuf;
1449           do {
1450             ++ThisTokBuf;
1451           } while (ThisTokBuf != ThisTokEnd && ThisTokBuf[0] != '\\');
1452 
1453           // Copy the character span over.
1454           if (CopyStringFragment(StringToks[i], ThisTokBegin,
1455                                  StringRef(InStart, ThisTokBuf - InStart)))
1456             hadError = true;
1457           continue;
1458         }
1459         // Is this a Universal Character Name escape?
1460         if (ThisTokBuf[1] == 'u' || ThisTokBuf[1] == 'U') {
1461           EncodeUCNEscape(ThisTokBegin, ThisTokBuf, ThisTokEnd,
1462                           ResultPtr, hadError,
1463                           FullSourceLoc(StringToks[i].getLocation(), SM),
1464                           CharByteWidth, Diags, Features);
1465           continue;
1466         }
1467         // Otherwise, this is a non-UCN escape character.  Process it.
1468         unsigned ResultChar =
1469           ProcessCharEscape(ThisTokBegin, ThisTokBuf, ThisTokEnd, hadError,
1470                             FullSourceLoc(StringToks[i].getLocation(), SM),
1471                             CharByteWidth*8, Diags, Features);
1472 
1473         if (CharByteWidth == 4) {
1474           // FIXME: Make the type of the result buffer correct instead of
1475           // using reinterpret_cast.
1476           UTF32 *ResultWidePtr = reinterpret_cast<UTF32*>(ResultPtr);
1477           *ResultWidePtr = ResultChar;
1478           ResultPtr += 4;
1479         } else if (CharByteWidth == 2) {
1480           // FIXME: Make the type of the result buffer correct instead of
1481           // using reinterpret_cast.
1482           UTF16 *ResultWidePtr = reinterpret_cast<UTF16*>(ResultPtr);
1483           *ResultWidePtr = ResultChar & 0xFFFF;
1484           ResultPtr += 2;
1485         } else {
1486           assert(CharByteWidth == 1 && "Unexpected char width");
1487           *ResultPtr++ = ResultChar & 0xFF;
1488         }
1489       }
1490     }
1491   }
1492 
1493   if (Pascal) {
1494     if (CharByteWidth == 4) {
1495       // FIXME: Make the type of the result buffer correct instead of
1496       // using reinterpret_cast.
1497       UTF32 *ResultWidePtr = reinterpret_cast<UTF32*>(ResultBuf.data());
1498       ResultWidePtr[0] = GetNumStringChars() - 1;
1499     } else if (CharByteWidth == 2) {
1500       // FIXME: Make the type of the result buffer correct instead of
1501       // using reinterpret_cast.
1502       UTF16 *ResultWidePtr = reinterpret_cast<UTF16*>(ResultBuf.data());
1503       ResultWidePtr[0] = GetNumStringChars() - 1;
1504     } else {
1505       assert(CharByteWidth == 1 && "Unexpected char width");
1506       ResultBuf[0] = GetNumStringChars() - 1;
1507     }
1508 
1509     // Verify that pascal strings aren't too large.
1510     if (GetStringLength() > 256) {
1511       if (Diags)
1512         Diags->Report(StringToks.front().getLocation(),
1513                       diag::err_pascal_string_too_long)
1514           << SourceRange(StringToks.front().getLocation(),
1515                          StringToks.back().getLocation());
1516       hadError = true;
1517       return;
1518     }
1519   } else if (Diags) {
1520     // Complain if this string literal has too many characters.
1521     unsigned MaxChars = Features.CPlusPlus? 65536 : Features.C99 ? 4095 : 509;
1522 
1523     if (GetNumStringChars() > MaxChars)
1524       Diags->Report(StringToks.front().getLocation(),
1525                     diag::ext_string_too_long)
1526         << GetNumStringChars() << MaxChars
1527         << (Features.CPlusPlus ? 2 : Features.C99 ? 1 : 0)
1528         << SourceRange(StringToks.front().getLocation(),
1529                        StringToks.back().getLocation());
1530   }
1531 }
1532 
1533 static const char *resyncUTF8(const char *Err, const char *End) {
1534   if (Err == End)
1535     return End;
1536   End = Err + std::min<unsigned>(getNumBytesForUTF8(*Err), End-Err);
1537   while (++Err != End && (*Err & 0xC0) == 0x80)
1538     ;
1539   return Err;
1540 }
1541 
1542 /// \brief This function copies from Fragment, which is a sequence of bytes
1543 /// within Tok's contents (which begin at TokBegin) into ResultPtr.
1544 /// Performs widening for multi-byte characters.
1545 bool StringLiteralParser::CopyStringFragment(const Token &Tok,
1546                                              const char *TokBegin,
1547                                              StringRef Fragment) {
1548   const UTF8 *ErrorPtrTmp;
1549   if (ConvertUTF8toWide(CharByteWidth, Fragment, ResultPtr, ErrorPtrTmp))
1550     return false;
1551 
1552   // If we see bad encoding for unprefixed string literals, warn and
1553   // simply copy the byte values, for compatibility with gcc and older
1554   // versions of clang.
1555   bool NoErrorOnBadEncoding = isAscii();
1556   if (NoErrorOnBadEncoding) {
1557     memcpy(ResultPtr, Fragment.data(), Fragment.size());
1558     ResultPtr += Fragment.size();
1559   }
1560 
1561   if (Diags) {
1562     const char *ErrorPtr = reinterpret_cast<const char *>(ErrorPtrTmp);
1563 
1564     FullSourceLoc SourceLoc(Tok.getLocation(), SM);
1565     const DiagnosticBuilder &Builder =
1566       Diag(Diags, Features, SourceLoc, TokBegin,
1567            ErrorPtr, resyncUTF8(ErrorPtr, Fragment.end()),
1568            NoErrorOnBadEncoding ? diag::warn_bad_string_encoding
1569                                 : diag::err_bad_string_encoding);
1570 
1571     const char *NextStart = resyncUTF8(ErrorPtr, Fragment.end());
1572     StringRef NextFragment(NextStart, Fragment.end()-NextStart);
1573 
1574     // Decode into a dummy buffer.
1575     SmallString<512> Dummy;
1576     Dummy.reserve(Fragment.size() * CharByteWidth);
1577     char *Ptr = Dummy.data();
1578 
1579     while (!ConvertUTF8toWide(CharByteWidth, NextFragment, Ptr, ErrorPtrTmp)) {
1580       const char *ErrorPtr = reinterpret_cast<const char *>(ErrorPtrTmp);
1581       NextStart = resyncUTF8(ErrorPtr, Fragment.end());
1582       Builder << MakeCharSourceRange(Features, SourceLoc, TokBegin,
1583                                      ErrorPtr, NextStart);
1584       NextFragment = StringRef(NextStart, Fragment.end()-NextStart);
1585     }
1586   }
1587   return !NoErrorOnBadEncoding;
1588 }
1589 
1590 void StringLiteralParser::DiagnoseLexingError(SourceLocation Loc) {
1591   hadError = true;
1592   if (Diags)
1593     Diags->Report(Loc, diag::err_lexing_string);
1594 }
1595 
1596 /// getOffsetOfStringByte - This function returns the offset of the
1597 /// specified byte of the string data represented by Token.  This handles
1598 /// advancing over escape sequences in the string.
1599 unsigned StringLiteralParser::getOffsetOfStringByte(const Token &Tok,
1600                                                     unsigned ByteNo) const {
1601   // Get the spelling of the token.
1602   SmallString<32> SpellingBuffer;
1603   SpellingBuffer.resize(Tok.getLength());
1604 
1605   bool StringInvalid = false;
1606   const char *SpellingPtr = &SpellingBuffer[0];
1607   unsigned TokLen = Lexer::getSpelling(Tok, SpellingPtr, SM, Features,
1608                                        &StringInvalid);
1609   if (StringInvalid)
1610     return 0;
1611 
1612   const char *SpellingStart = SpellingPtr;
1613   const char *SpellingEnd = SpellingPtr+TokLen;
1614 
1615   // Handle UTF-8 strings just like narrow strings.
1616   if (SpellingPtr[0] == 'u' && SpellingPtr[1] == '8')
1617     SpellingPtr += 2;
1618 
1619   assert(SpellingPtr[0] != 'L' && SpellingPtr[0] != 'u' &&
1620          SpellingPtr[0] != 'U' && "Doesn't handle wide or utf strings yet");
1621 
1622   // For raw string literals, this is easy.
1623   if (SpellingPtr[0] == 'R') {
1624     assert(SpellingPtr[1] == '"' && "Should be a raw string literal!");
1625     // Skip 'R"'.
1626     SpellingPtr += 2;
1627     while (*SpellingPtr != '(') {
1628       ++SpellingPtr;
1629       assert(SpellingPtr < SpellingEnd && "Missing ( for raw string literal");
1630     }
1631     // Skip '('.
1632     ++SpellingPtr;
1633     return SpellingPtr - SpellingStart + ByteNo;
1634   }
1635 
1636   // Skip over the leading quote
1637   assert(SpellingPtr[0] == '"' && "Should be a string literal!");
1638   ++SpellingPtr;
1639 
1640   // Skip over bytes until we find the offset we're looking for.
1641   while (ByteNo) {
1642     assert(SpellingPtr < SpellingEnd && "Didn't find byte offset!");
1643 
1644     // Step over non-escapes simply.
1645     if (*SpellingPtr != '\\') {
1646       ++SpellingPtr;
1647       --ByteNo;
1648       continue;
1649     }
1650 
1651     // Otherwise, this is an escape character.  Advance over it.
1652     bool HadError = false;
1653     if (SpellingPtr[1] == 'u' || SpellingPtr[1] == 'U') {
1654       const char *EscapePtr = SpellingPtr;
1655       unsigned Len = MeasureUCNEscape(SpellingStart, SpellingPtr, SpellingEnd,
1656                                       1, Features, HadError);
1657       if (Len > ByteNo) {
1658         // ByteNo is somewhere within the escape sequence.
1659         SpellingPtr = EscapePtr;
1660         break;
1661       }
1662       ByteNo -= Len;
1663     } else {
1664       ProcessCharEscape(SpellingStart, SpellingPtr, SpellingEnd, HadError,
1665                         FullSourceLoc(Tok.getLocation(), SM),
1666                         CharByteWidth*8, Diags, Features);
1667       --ByteNo;
1668     }
1669     assert(!HadError && "This method isn't valid on erroneous strings");
1670   }
1671 
1672   return SpellingPtr-SpellingStart;
1673 }
1674