1 //===--- MacroExpansion.cpp - Top level Macro Expansion -------------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file implements the top level handling of macro expansion for the
13 //===----------------------------------------------------------------------===//
15 #include "clang/Lex/Preprocessor.h"
16 #include "clang/Basic/Attributes.h"
17 #include "clang/Basic/FileManager.h"
18 #include "clang/Basic/SourceManager.h"
19 #include "clang/Basic/TargetInfo.h"
20 #include "clang/Lex/CodeCompletionHandler.h"
21 #include "clang/Lex/ExternalPreprocessorSource.h"
22 #include "clang/Lex/LexDiagnostic.h"
23 #include "clang/Lex/MacroArgs.h"
24 #include "clang/Lex/MacroInfo.h"
25 #include "llvm/ADT/STLExtras.h"
26 #include "llvm/ADT/SmallString.h"
27 #include "llvm/ADT/StringSwitch.h"
28 #include "llvm/Config/llvm-config.h"
29 #include "llvm/Support/ErrorHandling.h"
30 #include "llvm/Support/Format.h"
31 #include "llvm/Support/raw_ostream.h"
34 using namespace clang;
37 Preprocessor::getLocalMacroDirectiveHistory(const IdentifierInfo *II) const {
38 if (!II->hadMacroDefinition())
40 auto Pos = CurSubmoduleState->Macros.find(II);
41 return Pos == CurSubmoduleState->Macros.end() ? nullptr
42 : Pos->second.getLatest();
45 void Preprocessor::appendMacroDirective(IdentifierInfo *II, MacroDirective *MD){
46 assert(MD && "MacroDirective should be non-zero!");
47 assert(!MD->getPrevious() && "Already attached to a MacroDirective history.");
49 MacroState &StoredMD = CurSubmoduleState->Macros[II];
50 auto *OldMD = StoredMD.getLatest();
51 MD->setPrevious(OldMD);
52 StoredMD.setLatest(MD);
53 StoredMD.overrideActiveModuleMacros(*this, II);
55 // Set up the identifier as having associated macro history.
56 II->setHasMacroDefinition(true);
57 if (!MD->isDefined() && LeafModuleMacros.find(II) == LeafModuleMacros.end())
58 II->setHasMacroDefinition(false);
60 II->setChangedSinceDeserialization();
63 void Preprocessor::setLoadedMacroDirective(IdentifierInfo *II,
66 MacroState &StoredMD = CurSubmoduleState->Macros[II];
67 assert(!StoredMD.getLatest() &&
68 "the macro history was modified before initializing it from a pch");
70 // Setup the identifier as having associated macro history.
71 II->setHasMacroDefinition(true);
72 if (!MD->isDefined() && LeafModuleMacros.find(II) == LeafModuleMacros.end())
73 II->setHasMacroDefinition(false);
76 ModuleMacro *Preprocessor::addModuleMacro(Module *Mod, IdentifierInfo *II,
78 ArrayRef<ModuleMacro *> Overrides,
80 llvm::FoldingSetNodeID ID;
81 ModuleMacro::Profile(ID, Mod, II);
84 if (auto *MM = ModuleMacros.FindNodeOrInsertPos(ID, InsertPos)) {
89 auto *MM = ModuleMacro::create(*this, Mod, II, Macro, Overrides);
90 ModuleMacros.InsertNode(MM, InsertPos);
92 // Each overridden macro is now overridden by one more macro.
94 for (auto *O : Overrides) {
95 HidAny |= (O->NumOverriddenBy == 0);
99 // If we were the first overrider for any macro, it's no longer a leaf.
100 auto &LeafMacros = LeafModuleMacros[II];
102 LeafMacros.erase(std::remove_if(LeafMacros.begin(), LeafMacros.end(),
103 [](ModuleMacro *MM) {
104 return MM->NumOverriddenBy != 0;
109 // The new macro is always a leaf macro.
110 LeafMacros.push_back(MM);
111 // The identifier now has defined macros (that may or may not be visible).
112 II->setHasMacroDefinition(true);
118 ModuleMacro *Preprocessor::getModuleMacro(Module *Mod, IdentifierInfo *II) {
119 llvm::FoldingSetNodeID ID;
120 ModuleMacro::Profile(ID, Mod, II);
123 return ModuleMacros.FindNodeOrInsertPos(ID, InsertPos);
126 void Preprocessor::updateModuleMacroInfo(const IdentifierInfo *II,
127 ModuleMacroInfo &Info) {
128 assert(Info.ActiveModuleMacrosGeneration !=
129 CurSubmoduleState->VisibleModules.getGeneration() &&
130 "don't need to update this macro name info");
131 Info.ActiveModuleMacrosGeneration =
132 CurSubmoduleState->VisibleModules.getGeneration();
134 auto Leaf = LeafModuleMacros.find(II);
135 if (Leaf == LeafModuleMacros.end()) {
136 // No imported macros at all: nothing to do.
140 Info.ActiveModuleMacros.clear();
142 // Every macro that's locally overridden is overridden by a visible macro.
143 llvm::DenseMap<ModuleMacro *, int> NumHiddenOverrides;
144 for (auto *O : Info.OverriddenMacros)
145 NumHiddenOverrides[O] = -1;
147 // Collect all macros that are not overridden by a visible macro.
148 llvm::SmallVector<ModuleMacro *, 16> Worklist(Leaf->second.begin(),
150 while (!Worklist.empty()) {
151 auto *MM = Worklist.pop_back_val();
152 if (CurSubmoduleState->VisibleModules.isVisible(MM->getOwningModule())) {
153 // We only care about collecting definitions; undefinitions only act
154 // to override other definitions.
155 if (MM->getMacroInfo())
156 Info.ActiveModuleMacros.push_back(MM);
158 for (auto *O : MM->overrides())
159 if ((unsigned)++NumHiddenOverrides[O] == O->getNumOverridingMacros())
160 Worklist.push_back(O);
163 // Our reverse postorder walk found the macros in reverse order.
164 std::reverse(Info.ActiveModuleMacros.begin(), Info.ActiveModuleMacros.end());
166 // Determine whether the macro name is ambiguous.
167 MacroInfo *MI = nullptr;
168 bool IsSystemMacro = true;
169 bool IsAmbiguous = false;
170 if (auto *MD = Info.MD) {
171 while (MD && isa<VisibilityMacroDirective>(MD))
172 MD = MD->getPrevious();
173 if (auto *DMD = dyn_cast_or_null<DefMacroDirective>(MD)) {
175 IsSystemMacro &= SourceMgr.isInSystemHeader(DMD->getLocation());
178 for (auto *Active : Info.ActiveModuleMacros) {
179 auto *NewMI = Active->getMacroInfo();
181 // Before marking the macro as ambiguous, check if this is a case where
182 // both macros are in system headers. If so, we trust that the system
183 // did not get it wrong. This also handles cases where Clang's own
184 // headers have a different spelling of certain system macros:
185 // #define LONG_MAX __LONG_MAX__ (clang's limits.h)
186 // #define LONG_MAX 0x7fffffffffffffffL (system's limits.h)
188 // FIXME: Remove the defined-in-system-headers check. clang's limits.h
189 // overrides the system limits.h's macros, so there's no conflict here.
190 if (MI && NewMI != MI &&
191 !MI->isIdenticalTo(*NewMI, *this, /*Syntactically=*/true))
193 IsSystemMacro &= Active->getOwningModule()->IsSystem ||
194 SourceMgr.isInSystemHeader(NewMI->getDefinitionLoc());
197 Info.IsAmbiguous = IsAmbiguous && !IsSystemMacro;
200 void Preprocessor::dumpMacroInfo(const IdentifierInfo *II) {
201 ArrayRef<ModuleMacro*> Leaf;
202 auto LeafIt = LeafModuleMacros.find(II);
203 if (LeafIt != LeafModuleMacros.end())
204 Leaf = LeafIt->second;
205 const MacroState *State = nullptr;
206 auto Pos = CurSubmoduleState->Macros.find(II);
207 if (Pos != CurSubmoduleState->Macros.end())
208 State = &Pos->second;
210 llvm::errs() << "MacroState " << State << " " << II->getNameStart();
211 if (State && State->isAmbiguous(*this, II))
212 llvm::errs() << " ambiguous";
213 if (State && !State->getOverriddenMacros().empty()) {
214 llvm::errs() << " overrides";
215 for (auto *O : State->getOverriddenMacros())
216 llvm::errs() << " " << O->getOwningModule()->getFullModuleName();
218 llvm::errs() << "\n";
220 // Dump local macro directives.
221 for (auto *MD = State ? State->getLatest() : nullptr; MD;
222 MD = MD->getPrevious()) {
227 // Dump module macros.
228 llvm::DenseSet<ModuleMacro*> Active;
229 for (auto *MM : State ? State->getActiveModuleMacros(*this, II) : None)
231 llvm::DenseSet<ModuleMacro*> Visited;
232 llvm::SmallVector<ModuleMacro *, 16> Worklist(Leaf.begin(), Leaf.end());
233 while (!Worklist.empty()) {
234 auto *MM = Worklist.pop_back_val();
235 llvm::errs() << " ModuleMacro " << MM << " "
236 << MM->getOwningModule()->getFullModuleName();
237 if (!MM->getMacroInfo())
238 llvm::errs() << " undef";
240 if (Active.count(MM))
241 llvm::errs() << " active";
242 else if (!CurSubmoduleState->VisibleModules.isVisible(
243 MM->getOwningModule()))
244 llvm::errs() << " hidden";
245 else if (MM->getMacroInfo())
246 llvm::errs() << " overridden";
248 if (!MM->overrides().empty()) {
249 llvm::errs() << " overrides";
250 for (auto *O : MM->overrides()) {
251 llvm::errs() << " " << O->getOwningModule()->getFullModuleName();
252 if (Visited.insert(O).second)
253 Worklist.push_back(O);
256 llvm::errs() << "\n";
257 if (auto *MI = MM->getMacroInfo()) {
260 llvm::errs() << "\n";
265 /// RegisterBuiltinMacro - Register the specified identifier in the identifier
266 /// table and mark it as a builtin macro to be expanded.
267 static IdentifierInfo *RegisterBuiltinMacro(Preprocessor &PP, const char *Name){
268 // Get the identifier.
269 IdentifierInfo *Id = PP.getIdentifierInfo(Name);
271 // Mark it as being a macro that is builtin.
272 MacroInfo *MI = PP.AllocateMacroInfo(SourceLocation());
273 MI->setIsBuiltinMacro();
274 PP.appendDefMacroDirective(Id, MI);
279 /// RegisterBuiltinMacros - Register builtin macros, such as __LINE__ with the
280 /// identifier table.
281 void Preprocessor::RegisterBuiltinMacros() {
282 Ident__LINE__ = RegisterBuiltinMacro(*this, "__LINE__");
283 Ident__FILE__ = RegisterBuiltinMacro(*this, "__FILE__");
284 Ident__DATE__ = RegisterBuiltinMacro(*this, "__DATE__");
285 Ident__TIME__ = RegisterBuiltinMacro(*this, "__TIME__");
286 Ident__COUNTER__ = RegisterBuiltinMacro(*this, "__COUNTER__");
287 Ident_Pragma = RegisterBuiltinMacro(*this, "_Pragma");
289 // C++ Standing Document Extensions.
290 if (LangOpts.CPlusPlus)
291 Ident__has_cpp_attribute =
292 RegisterBuiltinMacro(*this, "__has_cpp_attribute");
294 Ident__has_cpp_attribute = nullptr;
297 Ident__BASE_FILE__ = RegisterBuiltinMacro(*this, "__BASE_FILE__");
298 Ident__INCLUDE_LEVEL__ = RegisterBuiltinMacro(*this, "__INCLUDE_LEVEL__");
299 Ident__TIMESTAMP__ = RegisterBuiltinMacro(*this, "__TIMESTAMP__");
301 // Microsoft Extensions.
302 if (LangOpts.MicrosoftExt) {
303 Ident__identifier = RegisterBuiltinMacro(*this, "__identifier");
304 Ident__pragma = RegisterBuiltinMacro(*this, "__pragma");
306 Ident__identifier = nullptr;
307 Ident__pragma = nullptr;
311 Ident__has_feature = RegisterBuiltinMacro(*this, "__has_feature");
312 Ident__has_extension = RegisterBuiltinMacro(*this, "__has_extension");
313 Ident__has_builtin = RegisterBuiltinMacro(*this, "__has_builtin");
314 Ident__has_attribute = RegisterBuiltinMacro(*this, "__has_attribute");
315 Ident__has_declspec = RegisterBuiltinMacro(*this, "__has_declspec_attribute");
316 Ident__has_include = RegisterBuiltinMacro(*this, "__has_include");
317 Ident__has_include_next = RegisterBuiltinMacro(*this, "__has_include_next");
318 Ident__has_warning = RegisterBuiltinMacro(*this, "__has_warning");
319 Ident__is_identifier = RegisterBuiltinMacro(*this, "__is_identifier");
322 if (LangOpts.Modules) {
323 Ident__building_module = RegisterBuiltinMacro(*this, "__building_module");
326 if (!LangOpts.CurrentModule.empty())
327 Ident__MODULE__ = RegisterBuiltinMacro(*this, "__MODULE__");
329 Ident__MODULE__ = nullptr;
331 Ident__building_module = nullptr;
332 Ident__MODULE__ = nullptr;
336 /// isTrivialSingleTokenExpansion - Return true if MI, which has a single token
337 /// in its expansion, currently expands to that token literally.
338 static bool isTrivialSingleTokenExpansion(const MacroInfo *MI,
339 const IdentifierInfo *MacroIdent,
341 IdentifierInfo *II = MI->getReplacementToken(0).getIdentifierInfo();
343 // If the token isn't an identifier, it's always literally expanded.
344 if (!II) return true;
346 // If the information about this identifier is out of date, update it from
347 // the external source.
348 if (II->isOutOfDate())
349 PP.getExternalSource()->updateOutOfDateIdentifier(*II);
351 // If the identifier is a macro, and if that macro is enabled, it may be
352 // expanded so it's not a trivial expansion.
353 if (auto *ExpansionMI = PP.getMacroInfo(II))
354 if (ExpansionMI->isEnabled() &&
355 // Fast expanding "#define X X" is ok, because X would be disabled.
359 // If this is an object-like macro invocation, it is safe to trivially expand
361 if (MI->isObjectLike()) return true;
363 // If this is a function-like macro invocation, it's safe to trivially expand
364 // as long as the identifier is not a macro argument.
365 return std::find(MI->arg_begin(), MI->arg_end(), II) == MI->arg_end();
370 /// isNextPPTokenLParen - Determine whether the next preprocessor token to be
371 /// lexed is a '('. If so, consume the token and return true, if not, this
372 /// method should have no observable side-effect on the lexed tokens.
373 bool Preprocessor::isNextPPTokenLParen() {
374 // Do some quick tests for rejection cases.
377 Val = CurLexer->isNextPPTokenLParen();
378 else if (CurPTHLexer)
379 Val = CurPTHLexer->isNextPPTokenLParen();
381 Val = CurTokenLexer->isNextTokenLParen();
384 // We have run off the end. If it's a source file we don't
385 // examine enclosing ones (C99 5.1.1.2p4). Otherwise walk up the
389 for (unsigned i = IncludeMacroStack.size(); i != 0; --i) {
390 IncludeStackInfo &Entry = IncludeMacroStack[i-1];
392 Val = Entry.TheLexer->isNextPPTokenLParen();
393 else if (Entry.ThePTHLexer)
394 Val = Entry.ThePTHLexer->isNextPPTokenLParen();
396 Val = Entry.TheTokenLexer->isNextTokenLParen();
401 // Ran off the end of a source file?
402 if (Entry.ThePPLexer)
407 // Okay, if we know that the token is a '(', lex it and return. Otherwise we
408 // have found something that isn't a '(' or we found the end of the
409 // translation unit. In either case, return false.
413 /// HandleMacroExpandedIdentifier - If an identifier token is read that is to be
414 /// expanded as a macro, handle it and return the next token as 'Identifier'.
415 bool Preprocessor::HandleMacroExpandedIdentifier(Token &Identifier,
416 const MacroDefinition &M) {
417 MacroInfo *MI = M.getMacroInfo();
419 // If this is a macro expansion in the "#if !defined(x)" line for the file,
420 // then the macro could expand to different things in other contexts, we need
421 // to disable the optimization in this case.
422 if (CurPPLexer) CurPPLexer->MIOpt.ExpandedMacro();
424 // If this is a builtin macro, like __LINE__ or _Pragma, handle it specially.
425 if (MI->isBuiltinMacro()) {
427 Callbacks->MacroExpands(Identifier, M, Identifier.getLocation(),
429 ExpandBuiltinMacro(Identifier);
433 /// Args - If this is a function-like macro expansion, this contains,
434 /// for each macro argument, the list of tokens that were provided to the
436 MacroArgs *Args = nullptr;
438 // Remember where the end of the expansion occurred. For an object-like
439 // macro, this is the identifier. For a function-like macro, this is the ')'.
440 SourceLocation ExpansionEnd = Identifier.getLocation();
442 // If this is a function-like macro, read the arguments.
443 if (MI->isFunctionLike()) {
444 // Remember that we are now parsing the arguments to a macro invocation.
445 // Preprocessor directives used inside macro arguments are not portable, and
446 // this enables the warning.
448 Args = ReadFunctionLikeMacroArgs(Identifier, MI, ExpansionEnd);
450 // Finished parsing args.
453 // If there was an error parsing the arguments, bail out.
454 if (!Args) return true;
456 ++NumFnMacroExpanded;
461 // Notice that this macro has been used.
464 // Remember where the token is expanded.
465 SourceLocation ExpandLoc = Identifier.getLocation();
466 SourceRange ExpansionRange(ExpandLoc, ExpansionEnd);
470 // We can have macro expansion inside a conditional directive while
471 // reading the function macro arguments. To ensure, in that case, that
472 // MacroExpands callbacks still happen in source order, queue this
473 // callback to have it happen after the function macro callback.
474 DelayedMacroExpandsCallbacks.push_back(
475 MacroExpandsInfo(Identifier, M, ExpansionRange));
477 Callbacks->MacroExpands(Identifier, M, ExpansionRange, Args);
478 if (!DelayedMacroExpandsCallbacks.empty()) {
479 for (unsigned i=0, e = DelayedMacroExpandsCallbacks.size(); i!=e; ++i) {
480 MacroExpandsInfo &Info = DelayedMacroExpandsCallbacks[i];
481 // FIXME: We lose macro args info with delayed callback.
482 Callbacks->MacroExpands(Info.Tok, Info.MD, Info.Range,
485 DelayedMacroExpandsCallbacks.clear();
490 // If the macro definition is ambiguous, complain.
491 if (M.isAmbiguous()) {
492 Diag(Identifier, diag::warn_pp_ambiguous_macro)
493 << Identifier.getIdentifierInfo();
494 Diag(MI->getDefinitionLoc(), diag::note_pp_ambiguous_macro_chosen)
495 << Identifier.getIdentifierInfo();
496 M.forAllDefinitions([&](const MacroInfo *OtherMI) {
498 Diag(OtherMI->getDefinitionLoc(), diag::note_pp_ambiguous_macro_other)
499 << Identifier.getIdentifierInfo();
503 // If we started lexing a macro, enter the macro expansion body.
505 // If this macro expands to no tokens, don't bother to push it onto the
506 // expansion stack, only to take it right back off.
507 if (MI->getNumTokens() == 0) {
508 // No need for arg info.
509 if (Args) Args->destroy(*this);
511 // Propagate whitespace info as if we had pushed, then popped,
513 Identifier.setFlag(Token::LeadingEmptyMacro);
514 PropagateLineStartLeadingSpaceInfo(Identifier);
515 ++NumFastMacroExpanded;
517 } else if (MI->getNumTokens() == 1 &&
518 isTrivialSingleTokenExpansion(MI, Identifier.getIdentifierInfo(),
520 // Otherwise, if this macro expands into a single trivially-expanded
521 // token: expand it now. This handles common cases like
524 // No need for arg info.
525 if (Args) Args->destroy(*this);
527 // Propagate the isAtStartOfLine/hasLeadingSpace markers of the macro
528 // identifier to the expanded token.
529 bool isAtStartOfLine = Identifier.isAtStartOfLine();
530 bool hasLeadingSpace = Identifier.hasLeadingSpace();
532 // Replace the result token.
533 Identifier = MI->getReplacementToken(0);
535 // Restore the StartOfLine/LeadingSpace markers.
536 Identifier.setFlagValue(Token::StartOfLine , isAtStartOfLine);
537 Identifier.setFlagValue(Token::LeadingSpace, hasLeadingSpace);
539 // Update the tokens location to include both its expansion and physical
542 SourceMgr.createExpansionLoc(Identifier.getLocation(), ExpandLoc,
543 ExpansionEnd,Identifier.getLength());
544 Identifier.setLocation(Loc);
546 // If this is a disabled macro or #define X X, we must mark the result as
548 if (IdentifierInfo *NewII = Identifier.getIdentifierInfo()) {
549 if (MacroInfo *NewMI = getMacroInfo(NewII))
550 if (!NewMI->isEnabled() || NewMI == MI) {
551 Identifier.setFlag(Token::DisableExpand);
552 // Don't warn for "#define X X" like "#define bool bool" from
554 if (NewMI != MI || MI->isFunctionLike())
555 Diag(Identifier, diag::pp_disabled_macro_expansion);
559 // Since this is not an identifier token, it can't be macro expanded, so
561 ++NumFastMacroExpanded;
565 // Start expanding the macro.
566 EnterMacro(Identifier, ExpansionEnd, MI, Args);
575 /// CheckMatchedBrackets - Returns true if the braces and parentheses in the
576 /// token vector are properly nested.
577 static bool CheckMatchedBrackets(const SmallVectorImpl<Token> &Tokens) {
578 SmallVector<Bracket, 8> Brackets;
579 for (SmallVectorImpl<Token>::const_iterator I = Tokens.begin(),
582 if (I->is(tok::l_paren)) {
583 Brackets.push_back(Paren);
584 } else if (I->is(tok::r_paren)) {
585 if (Brackets.empty() || Brackets.back() == Brace)
588 } else if (I->is(tok::l_brace)) {
589 Brackets.push_back(Brace);
590 } else if (I->is(tok::r_brace)) {
591 if (Brackets.empty() || Brackets.back() == Paren)
596 if (!Brackets.empty())
601 /// GenerateNewArgTokens - Returns true if OldTokens can be converted to a new
602 /// vector of tokens in NewTokens. The new number of arguments will be placed
603 /// in NumArgs and the ranges which need to surrounded in parentheses will be
605 /// Returns false if the token stream cannot be changed. If this is because
606 /// of an initializer list starting a macro argument, the range of those
607 /// initializer lists will be place in InitLists.
608 static bool GenerateNewArgTokens(Preprocessor &PP,
609 SmallVectorImpl<Token> &OldTokens,
610 SmallVectorImpl<Token> &NewTokens,
612 SmallVectorImpl<SourceRange> &ParenHints,
613 SmallVectorImpl<SourceRange> &InitLists) {
614 if (!CheckMatchedBrackets(OldTokens))
617 // Once it is known that the brackets are matched, only a simple count of the
621 // First token of a new macro argument.
622 SmallVectorImpl<Token>::iterator ArgStartIterator = OldTokens.begin();
624 // First closing brace in a new macro argument. Used to generate
625 // SourceRanges for InitLists.
626 SmallVectorImpl<Token>::iterator ClosingBrace = OldTokens.end();
629 // Set to true when a macro separator token is found inside a braced list.
630 // If true, the fixed argument spans multiple old arguments and ParenHints
632 bool FoundSeparatorToken = false;
633 for (SmallVectorImpl<Token>::iterator I = OldTokens.begin(),
636 if (I->is(tok::l_brace)) {
638 } else if (I->is(tok::r_brace)) {
640 if (Braces == 0 && ClosingBrace == E && FoundSeparatorToken)
642 } else if (I->is(tok::eof)) {
643 // EOF token is used to separate macro arguments
645 // Assume comma separator is actually braced list separator and change
646 // it back to a comma.
647 FoundSeparatorToken = true;
648 I->setKind(tok::comma);
650 } else { // Braces == 0
651 // Separator token still separates arguments.
654 // If the argument starts with a brace, it can't be fixed with
655 // parentheses. A different diagnostic will be given.
656 if (FoundSeparatorToken && ArgStartIterator->is(tok::l_brace)) {
658 SourceRange(ArgStartIterator->getLocation(),
659 PP.getLocForEndOfToken(ClosingBrace->getLocation())));
664 if (FoundSeparatorToken) {
665 TempToken.startToken();
666 TempToken.setKind(tok::l_paren);
667 TempToken.setLocation(ArgStartIterator->getLocation());
668 TempToken.setLength(0);
669 NewTokens.push_back(TempToken);
672 // Copy over argument tokens
673 NewTokens.insert(NewTokens.end(), ArgStartIterator, I);
675 // Add right paren and store the paren locations in ParenHints
676 if (FoundSeparatorToken) {
677 SourceLocation Loc = PP.getLocForEndOfToken((I - 1)->getLocation());
678 TempToken.startToken();
679 TempToken.setKind(tok::r_paren);
680 TempToken.setLocation(Loc);
681 TempToken.setLength(0);
682 NewTokens.push_back(TempToken);
683 ParenHints.push_back(SourceRange(ArgStartIterator->getLocation(),
687 // Copy separator token
688 NewTokens.push_back(*I);
691 ArgStartIterator = I + 1;
692 FoundSeparatorToken = false;
697 return !ParenHints.empty() && InitLists.empty();
700 /// ReadFunctionLikeMacroArgs - After reading "MACRO" and knowing that the next
701 /// token is the '(' of the macro, this method is invoked to read all of the
702 /// actual arguments specified for the macro invocation. This returns null on
704 MacroArgs *Preprocessor::ReadFunctionLikeMacroArgs(Token &MacroName,
706 SourceLocation &MacroEnd) {
707 // The number of fixed arguments to parse.
708 unsigned NumFixedArgsLeft = MI->getNumArgs();
709 bool isVariadic = MI->isVariadic();
711 // Outer loop, while there are more arguments, keep reading them.
714 // Read arguments as unexpanded tokens. This avoids issues, e.g., where
715 // an argument value in a macro could expand to ',' or '(' or ')'.
716 LexUnexpandedToken(Tok);
717 assert(Tok.is(tok::l_paren) && "Error computing l-paren-ness?");
719 // ArgTokens - Build up a list of tokens that make up each argument. Each
720 // argument is separated by an EOF token. Use a SmallVector so we can avoid
721 // heap allocations in the common case.
722 SmallVector<Token, 64> ArgTokens;
723 bool ContainsCodeCompletionTok = false;
725 SourceLocation TooManyArgsLoc;
727 unsigned NumActuals = 0;
728 while (Tok.isNot(tok::r_paren)) {
729 if (ContainsCodeCompletionTok && Tok.isOneOf(tok::eof, tok::eod))
732 assert(Tok.isOneOf(tok::l_paren, tok::comma) &&
733 "only expect argument separators here");
735 unsigned ArgTokenStart = ArgTokens.size();
736 SourceLocation ArgStartLoc = Tok.getLocation();
738 // C99 6.10.3p11: Keep track of the number of l_parens we have seen. Note
739 // that we already consumed the first one.
740 unsigned NumParens = 0;
743 // Read arguments as unexpanded tokens. This avoids issues, e.g., where
744 // an argument value in a macro could expand to ',' or '(' or ')'.
745 LexUnexpandedToken(Tok);
747 if (Tok.isOneOf(tok::eof, tok::eod)) { // "#if f(<eof>" & "#if f(\n"
748 if (!ContainsCodeCompletionTok) {
749 Diag(MacroName, diag::err_unterm_macro_invoc);
750 Diag(MI->getDefinitionLoc(), diag::note_macro_here)
751 << MacroName.getIdentifierInfo();
752 // Do not lose the EOF/EOD. Return it to the client.
756 // Do not lose the EOF/EOD.
757 Token *Toks = new Token[1];
759 EnterTokenStream(Toks, 1, true, true);
762 } else if (Tok.is(tok::r_paren)) {
763 // If we found the ) token, the macro arg list is done.
764 if (NumParens-- == 0) {
765 MacroEnd = Tok.getLocation();
768 } else if (Tok.is(tok::l_paren)) {
770 } else if (Tok.is(tok::comma) && NumParens == 0 &&
771 !(Tok.getFlags() & Token::IgnoredComma)) {
772 // In Microsoft-compatibility mode, single commas from nested macro
773 // expansions should not be considered as argument separators. We test
774 // for this with the IgnoredComma token flag above.
776 // Comma ends this argument if there are more fixed arguments expected.
777 // However, if this is a variadic macro, and this is part of the
778 // variadic part, then the comma is just an argument token.
779 if (!isVariadic) break;
780 if (NumFixedArgsLeft > 1)
782 } else if (Tok.is(tok::comment) && !KeepMacroComments) {
783 // If this is a comment token in the argument list and we're just in
784 // -C mode (not -CC mode), discard the comment.
786 } else if (!Tok.isAnnotation() && Tok.getIdentifierInfo() != nullptr) {
787 // Reading macro arguments can cause macros that we are currently
788 // expanding from to be popped off the expansion stack. Doing so causes
789 // them to be reenabled for expansion. Here we record whether any
790 // identifiers we lex as macro arguments correspond to disabled macros.
791 // If so, we mark the token as noexpand. This is a subtle aspect of
793 if (MacroInfo *MI = getMacroInfo(Tok.getIdentifierInfo()))
794 if (!MI->isEnabled())
795 Tok.setFlag(Token::DisableExpand);
796 } else if (Tok.is(tok::code_completion)) {
797 ContainsCodeCompletionTok = true;
799 CodeComplete->CodeCompleteMacroArgument(MacroName.getIdentifierInfo(),
801 // Don't mark that we reached the code-completion point because the
802 // parser is going to handle the token and there will be another
803 // code-completion callback.
806 ArgTokens.push_back(Tok);
809 // If this was an empty argument list foo(), don't add this as an empty
811 if (ArgTokens.empty() && Tok.getKind() == tok::r_paren)
814 // If this is not a variadic macro, and too many args were specified, emit
816 if (!isVariadic && NumFixedArgsLeft == 0 && TooManyArgsLoc.isInvalid()) {
817 if (ArgTokens.size() != ArgTokenStart)
818 TooManyArgsLoc = ArgTokens[ArgTokenStart].getLocation();
820 TooManyArgsLoc = ArgStartLoc;
823 // Empty arguments are standard in C99 and C++0x, and are supported as an
824 // extension in other modes.
825 if (ArgTokens.size() == ArgTokenStart && !LangOpts.C99)
826 Diag(Tok, LangOpts.CPlusPlus11 ?
827 diag::warn_cxx98_compat_empty_fnmacro_arg :
828 diag::ext_empty_fnmacro_arg);
830 // Add a marker EOF token to the end of the token list for this argument.
833 EOFTok.setKind(tok::eof);
834 EOFTok.setLocation(Tok.getLocation());
836 ArgTokens.push_back(EOFTok);
838 if (!ContainsCodeCompletionTok && NumFixedArgsLeft != 0)
842 // Okay, we either found the r_paren. Check to see if we parsed too few
844 unsigned MinArgsExpected = MI->getNumArgs();
846 // If this is not a variadic macro, and too many args were specified, emit
848 if (!isVariadic && NumActuals > MinArgsExpected &&
849 !ContainsCodeCompletionTok) {
850 // Emit the diagnostic at the macro name in case there is a missing ).
851 // Emitting it at the , could be far away from the macro name.
852 Diag(TooManyArgsLoc, diag::err_too_many_args_in_macro_invoc);
853 Diag(MI->getDefinitionLoc(), diag::note_macro_here)
854 << MacroName.getIdentifierInfo();
856 // Commas from braced initializer lists will be treated as argument
857 // separators inside macros. Attempt to correct for this with parentheses.
858 // TODO: See if this can be generalized to angle brackets for templates
859 // inside macro arguments.
861 SmallVector<Token, 4> FixedArgTokens;
862 unsigned FixedNumArgs = 0;
863 SmallVector<SourceRange, 4> ParenHints, InitLists;
864 if (!GenerateNewArgTokens(*this, ArgTokens, FixedArgTokens, FixedNumArgs,
865 ParenHints, InitLists)) {
866 if (!InitLists.empty()) {
867 DiagnosticBuilder DB =
869 diag::note_init_list_at_beginning_of_macro_argument);
870 for (const SourceRange &Range : InitLists)
875 if (FixedNumArgs != MinArgsExpected)
878 DiagnosticBuilder DB = Diag(MacroName, diag::note_suggest_parens_for_macro);
879 for (const SourceRange &ParenLocation : ParenHints) {
880 DB << FixItHint::CreateInsertion(ParenLocation.getBegin(), "(");
881 DB << FixItHint::CreateInsertion(ParenLocation.getEnd(), ")");
883 ArgTokens.swap(FixedArgTokens);
884 NumActuals = FixedNumArgs;
887 // See MacroArgs instance var for description of this.
888 bool isVarargsElided = false;
890 if (ContainsCodeCompletionTok) {
891 // Recover from not-fully-formed macro invocation during code-completion.
894 EOFTok.setKind(tok::eof);
895 EOFTok.setLocation(Tok.getLocation());
897 for (; NumActuals < MinArgsExpected; ++NumActuals)
898 ArgTokens.push_back(EOFTok);
901 if (NumActuals < MinArgsExpected) {
902 // There are several cases where too few arguments is ok, handle them now.
903 if (NumActuals == 0 && MinArgsExpected == 1) {
904 // #define A(X) or #define A(...) ---> A()
906 // If there is exactly one argument, and that argument is missing,
907 // then we have an empty "()" argument empty list. This is fine, even if
908 // the macro expects one argument (the argument is just empty).
909 isVarargsElided = MI->isVariadic();
910 } else if (MI->isVariadic() &&
911 (NumActuals+1 == MinArgsExpected || // A(x, ...) -> A(X)
912 (NumActuals == 0 && MinArgsExpected == 2))) {// A(x,...) -> A()
913 // Varargs where the named vararg parameter is missing: OK as extension.
917 // If the macro contains the comma pasting extension, the diagnostic
918 // is suppressed; we know we'll get another diagnostic later.
919 if (!MI->hasCommaPasting()) {
920 Diag(Tok, diag::ext_missing_varargs_arg);
921 Diag(MI->getDefinitionLoc(), diag::note_macro_here)
922 << MacroName.getIdentifierInfo();
925 // Remember this occurred, allowing us to elide the comma when used for
927 // #define A(x, foo...) blah(a, ## foo)
928 // #define B(x, ...) blah(a, ## __VA_ARGS__)
929 // #define C(...) blah(a, ## __VA_ARGS__)
931 isVarargsElided = true;
932 } else if (!ContainsCodeCompletionTok) {
933 // Otherwise, emit the error.
934 Diag(Tok, diag::err_too_few_args_in_macro_invoc);
935 Diag(MI->getDefinitionLoc(), diag::note_macro_here)
936 << MacroName.getIdentifierInfo();
940 // Add a marker EOF token to the end of the token list for this argument.
941 SourceLocation EndLoc = Tok.getLocation();
943 Tok.setKind(tok::eof);
944 Tok.setLocation(EndLoc);
946 ArgTokens.push_back(Tok);
948 // If we expect two arguments, add both as empty.
949 if (NumActuals == 0 && MinArgsExpected == 2)
950 ArgTokens.push_back(Tok);
952 } else if (NumActuals > MinArgsExpected && !MI->isVariadic() &&
953 !ContainsCodeCompletionTok) {
954 // Emit the diagnostic at the macro name in case there is a missing ).
955 // Emitting it at the , could be far away from the macro name.
956 Diag(MacroName, diag::err_too_many_args_in_macro_invoc);
957 Diag(MI->getDefinitionLoc(), diag::note_macro_here)
958 << MacroName.getIdentifierInfo();
962 return MacroArgs::create(MI, ArgTokens, isVarargsElided, *this);
965 /// \brief Keeps macro expanded tokens for TokenLexers.
967 /// Works like a stack; a TokenLexer adds the macro expanded tokens that is
968 /// going to lex in the cache and when it finishes the tokens are removed
969 /// from the end of the cache.
970 Token *Preprocessor::cacheMacroExpandedTokens(TokenLexer *tokLexer,
971 ArrayRef<Token> tokens) {
976 size_t newIndex = MacroExpandedTokens.size();
977 bool cacheNeedsToGrow = tokens.size() >
978 MacroExpandedTokens.capacity()-MacroExpandedTokens.size();
979 MacroExpandedTokens.append(tokens.begin(), tokens.end());
981 if (cacheNeedsToGrow) {
982 // Go through all the TokenLexers whose 'Tokens' pointer points in the
983 // buffer and update the pointers to the (potential) new buffer array.
984 for (unsigned i = 0, e = MacroExpandingLexersStack.size(); i != e; ++i) {
985 TokenLexer *prevLexer;
987 std::tie(prevLexer, tokIndex) = MacroExpandingLexersStack[i];
988 prevLexer->Tokens = MacroExpandedTokens.data() + tokIndex;
992 MacroExpandingLexersStack.push_back(std::make_pair(tokLexer, newIndex));
993 return MacroExpandedTokens.data() + newIndex;
996 void Preprocessor::removeCachedMacroExpandedTokensOfLastLexer() {
997 assert(!MacroExpandingLexersStack.empty());
998 size_t tokIndex = MacroExpandingLexersStack.back().second;
999 assert(tokIndex < MacroExpandedTokens.size());
1000 // Pop the cached macro expanded tokens from the end.
1001 MacroExpandedTokens.resize(tokIndex);
1002 MacroExpandingLexersStack.pop_back();
1005 /// ComputeDATE_TIME - Compute the current time, enter it into the specified
1006 /// scratch buffer, then return DATELoc/TIMELoc locations with the position of
1007 /// the identifier tokens inserted.
1008 static void ComputeDATE_TIME(SourceLocation &DATELoc, SourceLocation &TIMELoc,
1010 time_t TT = time(nullptr);
1011 struct tm *TM = localtime(&TT);
1013 static const char * const Months[] = {
1014 "Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"
1018 SmallString<32> TmpBuffer;
1019 llvm::raw_svector_ostream TmpStream(TmpBuffer);
1020 TmpStream << llvm::format("\"%s %2d %4d\"", Months[TM->tm_mon],
1021 TM->tm_mday, TM->tm_year + 1900);
1023 TmpTok.startToken();
1024 PP.CreateString(TmpStream.str(), TmpTok);
1025 DATELoc = TmpTok.getLocation();
1029 SmallString<32> TmpBuffer;
1030 llvm::raw_svector_ostream TmpStream(TmpBuffer);
1031 TmpStream << llvm::format("\"%02d:%02d:%02d\"",
1032 TM->tm_hour, TM->tm_min, TM->tm_sec);
1034 TmpTok.startToken();
1035 PP.CreateString(TmpStream.str(), TmpTok);
1036 TIMELoc = TmpTok.getLocation();
1041 /// HasFeature - Return true if we recognize and implement the feature
1042 /// specified by the identifier as a standard language feature.
1043 static bool HasFeature(const Preprocessor &PP, const IdentifierInfo *II) {
1044 const LangOptions &LangOpts = PP.getLangOpts();
1045 StringRef Feature = II->getName();
1047 // Normalize the feature name, __foo__ becomes foo.
1048 if (Feature.startswith("__") && Feature.endswith("__") && Feature.size() >= 4)
1049 Feature = Feature.substr(2, Feature.size() - 4);
1051 return llvm::StringSwitch<bool>(Feature)
1052 .Case("address_sanitizer",
1053 LangOpts.Sanitize.hasOneOf(SanitizerKind::Address |
1054 SanitizerKind::KernelAddress))
1055 .Case("assume_nonnull", true)
1056 .Case("attribute_analyzer_noreturn", true)
1057 .Case("attribute_availability", true)
1058 .Case("attribute_availability_with_message", true)
1059 .Case("attribute_availability_app_extension", true)
1060 .Case("attribute_cf_returns_not_retained", true)
1061 .Case("attribute_cf_returns_retained", true)
1062 .Case("attribute_cf_returns_on_parameters", true)
1063 .Case("attribute_deprecated_with_message", true)
1064 .Case("attribute_ext_vector_type", true)
1065 .Case("attribute_ns_returns_not_retained", true)
1066 .Case("attribute_ns_returns_retained", true)
1067 .Case("attribute_ns_consumes_self", true)
1068 .Case("attribute_ns_consumed", true)
1069 .Case("attribute_cf_consumed", true)
1070 .Case("attribute_objc_ivar_unused", true)
1071 .Case("attribute_objc_method_family", true)
1072 .Case("attribute_overloadable", true)
1073 .Case("attribute_unavailable_with_message", true)
1074 .Case("attribute_unused_on_fields", true)
1075 .Case("blocks", LangOpts.Blocks)
1076 .Case("c_thread_safety_attributes", true)
1077 .Case("cxx_exceptions", LangOpts.CXXExceptions)
1078 .Case("cxx_rtti", LangOpts.RTTI)
1079 .Case("enumerator_attributes", true)
1080 .Case("nullability", true)
1081 .Case("memory_sanitizer", LangOpts.Sanitize.has(SanitizerKind::Memory))
1082 .Case("thread_sanitizer", LangOpts.Sanitize.has(SanitizerKind::Thread))
1083 .Case("dataflow_sanitizer", LangOpts.Sanitize.has(SanitizerKind::DataFlow))
1084 // Objective-C features
1085 .Case("objc_arr", LangOpts.ObjCAutoRefCount) // FIXME: REMOVE?
1086 .Case("objc_arc", LangOpts.ObjCAutoRefCount)
1087 .Case("objc_arc_weak", LangOpts.ObjCARCWeak)
1088 .Case("objc_default_synthesize_properties", LangOpts.ObjC2)
1089 .Case("objc_fixed_enum", LangOpts.ObjC2)
1090 .Case("objc_instancetype", LangOpts.ObjC2)
1091 .Case("objc_kindof", LangOpts.ObjC2)
1092 .Case("objc_modules", LangOpts.ObjC2 && LangOpts.Modules)
1093 .Case("objc_nonfragile_abi", LangOpts.ObjCRuntime.isNonFragile())
1094 .Case("objc_property_explicit_atomic",
1095 true) // Does clang support explicit "atomic" keyword?
1096 .Case("objc_protocol_qualifier_mangling", true)
1097 .Case("objc_weak_class", LangOpts.ObjCRuntime.hasWeakClassImport())
1098 .Case("ownership_holds", true)
1099 .Case("ownership_returns", true)
1100 .Case("ownership_takes", true)
1101 .Case("objc_bool", true)
1102 .Case("objc_subscripting", LangOpts.ObjCRuntime.isNonFragile())
1103 .Case("objc_array_literals", LangOpts.ObjC2)
1104 .Case("objc_dictionary_literals", LangOpts.ObjC2)
1105 .Case("objc_boxed_expressions", LangOpts.ObjC2)
1106 .Case("objc_boxed_nsvalue_expressions", LangOpts.ObjC2)
1107 .Case("arc_cf_code_audited", true)
1108 .Case("objc_bridge_id", true)
1109 .Case("objc_bridge_id_on_typedefs", true)
1110 .Case("objc_generics", LangOpts.ObjC2)
1111 .Case("objc_generics_variance", LangOpts.ObjC2)
1113 .Case("c_alignas", LangOpts.C11)
1114 .Case("c_alignof", LangOpts.C11)
1115 .Case("c_atomic", LangOpts.C11)
1116 .Case("c_generic_selections", LangOpts.C11)
1117 .Case("c_static_assert", LangOpts.C11)
1118 .Case("c_thread_local",
1119 LangOpts.C11 && PP.getTargetInfo().isTLSSupported())
1121 .Case("cxx_access_control_sfinae", LangOpts.CPlusPlus11)
1122 .Case("cxx_alias_templates", LangOpts.CPlusPlus11)
1123 .Case("cxx_alignas", LangOpts.CPlusPlus11)
1124 .Case("cxx_alignof", LangOpts.CPlusPlus11)
1125 .Case("cxx_atomic", LangOpts.CPlusPlus11)
1126 .Case("cxx_attributes", LangOpts.CPlusPlus11)
1127 .Case("cxx_auto_type", LangOpts.CPlusPlus11)
1128 .Case("cxx_constexpr", LangOpts.CPlusPlus11)
1129 .Case("cxx_decltype", LangOpts.CPlusPlus11)
1130 .Case("cxx_decltype_incomplete_return_types", LangOpts.CPlusPlus11)
1131 .Case("cxx_default_function_template_args", LangOpts.CPlusPlus11)
1132 .Case("cxx_defaulted_functions", LangOpts.CPlusPlus11)
1133 .Case("cxx_delegating_constructors", LangOpts.CPlusPlus11)
1134 .Case("cxx_deleted_functions", LangOpts.CPlusPlus11)
1135 .Case("cxx_explicit_conversions", LangOpts.CPlusPlus11)
1136 .Case("cxx_generalized_initializers", LangOpts.CPlusPlus11)
1137 .Case("cxx_implicit_moves", LangOpts.CPlusPlus11)
1138 .Case("cxx_inheriting_constructors", LangOpts.CPlusPlus11)
1139 .Case("cxx_inline_namespaces", LangOpts.CPlusPlus11)
1140 .Case("cxx_lambdas", LangOpts.CPlusPlus11)
1141 .Case("cxx_local_type_template_args", LangOpts.CPlusPlus11)
1142 .Case("cxx_nonstatic_member_init", LangOpts.CPlusPlus11)
1143 .Case("cxx_noexcept", LangOpts.CPlusPlus11)
1144 .Case("cxx_nullptr", LangOpts.CPlusPlus11)
1145 .Case("cxx_override_control", LangOpts.CPlusPlus11)
1146 .Case("cxx_range_for", LangOpts.CPlusPlus11)
1147 .Case("cxx_raw_string_literals", LangOpts.CPlusPlus11)
1148 .Case("cxx_reference_qualified_functions", LangOpts.CPlusPlus11)
1149 .Case("cxx_rvalue_references", LangOpts.CPlusPlus11)
1150 .Case("cxx_strong_enums", LangOpts.CPlusPlus11)
1151 .Case("cxx_static_assert", LangOpts.CPlusPlus11)
1152 .Case("cxx_thread_local",
1153 LangOpts.CPlusPlus11 && PP.getTargetInfo().isTLSSupported())
1154 .Case("cxx_trailing_return", LangOpts.CPlusPlus11)
1155 .Case("cxx_unicode_literals", LangOpts.CPlusPlus11)
1156 .Case("cxx_unrestricted_unions", LangOpts.CPlusPlus11)
1157 .Case("cxx_user_literals", LangOpts.CPlusPlus11)
1158 .Case("cxx_variadic_templates", LangOpts.CPlusPlus11)
1160 .Case("cxx_aggregate_nsdmi", LangOpts.CPlusPlus14)
1161 .Case("cxx_binary_literals", LangOpts.CPlusPlus14)
1162 .Case("cxx_contextual_conversions", LangOpts.CPlusPlus14)
1163 .Case("cxx_decltype_auto", LangOpts.CPlusPlus14)
1164 .Case("cxx_generic_lambdas", LangOpts.CPlusPlus14)
1165 .Case("cxx_init_captures", LangOpts.CPlusPlus14)
1166 .Case("cxx_relaxed_constexpr", LangOpts.CPlusPlus14)
1167 .Case("cxx_return_type_deduction", LangOpts.CPlusPlus14)
1168 .Case("cxx_variable_templates", LangOpts.CPlusPlus14)
1170 //.Case("cxx_runtime_arrays", LangOpts.CPlusPlusTSArrays)
1171 //.Case("cxx_concepts", LangOpts.CPlusPlusTSConcepts)
1172 // FIXME: Should this be __has_feature or __has_extension?
1173 //.Case("raw_invocation_type", LangOpts.CPlusPlus)
1175 .Case("has_nothrow_assign", LangOpts.CPlusPlus)
1176 .Case("has_nothrow_copy", LangOpts.CPlusPlus)
1177 .Case("has_nothrow_constructor", LangOpts.CPlusPlus)
1178 .Case("has_trivial_assign", LangOpts.CPlusPlus)
1179 .Case("has_trivial_copy", LangOpts.CPlusPlus)
1180 .Case("has_trivial_constructor", LangOpts.CPlusPlus)
1181 .Case("has_trivial_destructor", LangOpts.CPlusPlus)
1182 .Case("has_virtual_destructor", LangOpts.CPlusPlus)
1183 .Case("is_abstract", LangOpts.CPlusPlus)
1184 .Case("is_base_of", LangOpts.CPlusPlus)
1185 .Case("is_class", LangOpts.CPlusPlus)
1186 .Case("is_constructible", LangOpts.CPlusPlus)
1187 .Case("is_convertible_to", LangOpts.CPlusPlus)
1188 .Case("is_empty", LangOpts.CPlusPlus)
1189 .Case("is_enum", LangOpts.CPlusPlus)
1190 .Case("is_final", LangOpts.CPlusPlus)
1191 .Case("is_literal", LangOpts.CPlusPlus)
1192 .Case("is_standard_layout", LangOpts.CPlusPlus)
1193 .Case("is_pod", LangOpts.CPlusPlus)
1194 .Case("is_polymorphic", LangOpts.CPlusPlus)
1195 .Case("is_sealed", LangOpts.MicrosoftExt)
1196 .Case("is_trivial", LangOpts.CPlusPlus)
1197 .Case("is_trivially_assignable", LangOpts.CPlusPlus)
1198 .Case("is_trivially_constructible", LangOpts.CPlusPlus)
1199 .Case("is_trivially_copyable", LangOpts.CPlusPlus)
1200 .Case("is_union", LangOpts.CPlusPlus)
1201 .Case("modules", LangOpts.Modules)
1202 .Case("safe_stack", LangOpts.Sanitize.has(SanitizerKind::SafeStack))
1203 .Case("tls", PP.getTargetInfo().isTLSSupported())
1204 .Case("underlying_type", LangOpts.CPlusPlus)
1208 /// HasExtension - Return true if we recognize and implement the feature
1209 /// specified by the identifier, either as an extension or a standard language
1211 static bool HasExtension(const Preprocessor &PP, const IdentifierInfo *II) {
1212 if (HasFeature(PP, II))
1215 // If the use of an extension results in an error diagnostic, extensions are
1216 // effectively unavailable, so just return false here.
1217 if (PP.getDiagnostics().getExtensionHandlingBehavior() >=
1218 diag::Severity::Error)
1221 const LangOptions &LangOpts = PP.getLangOpts();
1222 StringRef Extension = II->getName();
1224 // Normalize the extension name, __foo__ becomes foo.
1225 if (Extension.startswith("__") && Extension.endswith("__") &&
1226 Extension.size() >= 4)
1227 Extension = Extension.substr(2, Extension.size() - 4);
1229 // Because we inherit the feature list from HasFeature, this string switch
1230 // must be less restrictive than HasFeature's.
1231 return llvm::StringSwitch<bool>(Extension)
1232 // C11 features supported by other languages as extensions.
1233 .Case("c_alignas", true)
1234 .Case("c_alignof", true)
1235 .Case("c_atomic", true)
1236 .Case("c_generic_selections", true)
1237 .Case("c_static_assert", true)
1238 .Case("c_thread_local", PP.getTargetInfo().isTLSSupported())
1239 // C++11 features supported by other languages as extensions.
1240 .Case("cxx_atomic", LangOpts.CPlusPlus)
1241 .Case("cxx_deleted_functions", LangOpts.CPlusPlus)
1242 .Case("cxx_explicit_conversions", LangOpts.CPlusPlus)
1243 .Case("cxx_inline_namespaces", LangOpts.CPlusPlus)
1244 .Case("cxx_local_type_template_args", LangOpts.CPlusPlus)
1245 .Case("cxx_nonstatic_member_init", LangOpts.CPlusPlus)
1246 .Case("cxx_override_control", LangOpts.CPlusPlus)
1247 .Case("cxx_range_for", LangOpts.CPlusPlus)
1248 .Case("cxx_reference_qualified_functions", LangOpts.CPlusPlus)
1249 .Case("cxx_rvalue_references", LangOpts.CPlusPlus)
1250 .Case("cxx_variadic_templates", LangOpts.CPlusPlus)
1251 // C++1y features supported by other languages as extensions.
1252 .Case("cxx_binary_literals", true)
1253 .Case("cxx_init_captures", LangOpts.CPlusPlus11)
1254 .Case("cxx_variable_templates", LangOpts.CPlusPlus)
1258 /// EvaluateHasIncludeCommon - Process a '__has_include("path")'
1259 /// or '__has_include_next("path")' expression.
1260 /// Returns true if successful.
1261 static bool EvaluateHasIncludeCommon(Token &Tok,
1262 IdentifierInfo *II, Preprocessor &PP,
1263 const DirectoryLookup *LookupFrom,
1264 const FileEntry *LookupFromFile) {
1265 // Save the location of the current token. If a '(' is later found, use
1266 // that location. If not, use the end of this location instead.
1267 SourceLocation LParenLoc = Tok.getLocation();
1269 // These expressions are only allowed within a preprocessor directive.
1270 if (!PP.isParsingIfOrElifDirective()) {
1271 PP.Diag(LParenLoc, diag::err_pp_directive_required) << II->getName();
1272 // Return a valid identifier token.
1273 assert(Tok.is(tok::identifier));
1274 Tok.setIdentifierInfo(II);
1279 PP.LexNonComment(Tok);
1281 // Ensure we have a '('.
1282 if (Tok.isNot(tok::l_paren)) {
1283 // No '(', use end of last token.
1284 LParenLoc = PP.getLocForEndOfToken(LParenLoc);
1285 PP.Diag(LParenLoc, diag::err_pp_expected_after) << II << tok::l_paren;
1286 // If the next token looks like a filename or the start of one,
1287 // assume it is and process it as such.
1288 if (!Tok.is(tok::angle_string_literal) && !Tok.is(tok::string_literal) &&
1292 // Save '(' location for possible missing ')' message.
1293 LParenLoc = Tok.getLocation();
1295 if (PP.getCurrentLexer()) {
1296 // Get the file name.
1297 PP.getCurrentLexer()->LexIncludeFilename(Tok);
1299 // We're in a macro, so we can't use LexIncludeFilename; just
1300 // grab the next token.
1305 // Reserve a buffer to get the spelling.
1306 SmallString<128> FilenameBuffer;
1308 SourceLocation EndLoc;
1310 switch (Tok.getKind()) {
1312 // If the token kind is EOD, the error has already been diagnosed.
1315 case tok::angle_string_literal:
1316 case tok::string_literal: {
1317 bool Invalid = false;
1318 Filename = PP.getSpelling(Tok, FilenameBuffer, &Invalid);
1325 // This could be a <foo/bar.h> file coming from a macro expansion. In this
1326 // case, glue the tokens together into FilenameBuffer and interpret those.
1327 FilenameBuffer.push_back('<');
1328 if (PP.ConcatenateIncludeName(FilenameBuffer, EndLoc)) {
1329 // Let the caller know a <eod> was found by changing the Token kind.
1330 Tok.setKind(tok::eod);
1331 return false; // Found <eod> but no ">"? Diagnostic already emitted.
1333 Filename = FilenameBuffer;
1336 PP.Diag(Tok.getLocation(), diag::err_pp_expects_filename);
1340 SourceLocation FilenameLoc = Tok.getLocation();
1343 PP.LexNonComment(Tok);
1345 // Ensure we have a trailing ).
1346 if (Tok.isNot(tok::r_paren)) {
1347 PP.Diag(PP.getLocForEndOfToken(FilenameLoc), diag::err_pp_expected_after)
1348 << II << tok::r_paren;
1349 PP.Diag(LParenLoc, diag::note_matching) << tok::l_paren;
1353 bool isAngled = PP.GetIncludeFilenameSpelling(Tok.getLocation(), Filename);
1354 // If GetIncludeFilenameSpelling set the start ptr to null, there was an
1356 if (Filename.empty())
1359 // Search include directories.
1360 const DirectoryLookup *CurDir;
1361 const FileEntry *File =
1362 PP.LookupFile(FilenameLoc, Filename, isAngled, LookupFrom, LookupFromFile,
1363 CurDir, nullptr, nullptr, nullptr);
1365 // Get the result value. A result of true means the file exists.
1366 return File != nullptr;
1369 /// EvaluateHasInclude - Process a '__has_include("path")' expression.
1370 /// Returns true if successful.
1371 static bool EvaluateHasInclude(Token &Tok, IdentifierInfo *II,
1373 return EvaluateHasIncludeCommon(Tok, II, PP, nullptr, nullptr);
1376 /// EvaluateHasIncludeNext - Process '__has_include_next("path")' expression.
1377 /// Returns true if successful.
1378 static bool EvaluateHasIncludeNext(Token &Tok,
1379 IdentifierInfo *II, Preprocessor &PP) {
1380 // __has_include_next is like __has_include, except that we start
1381 // searching after the current found directory. If we can't do this,
1382 // issue a diagnostic.
1383 // FIXME: Factor out duplication with
1384 // Preprocessor::HandleIncludeNextDirective.
1385 const DirectoryLookup *Lookup = PP.GetCurDirLookup();
1386 const FileEntry *LookupFromFile = nullptr;
1387 if (PP.isInPrimaryFile()) {
1389 PP.Diag(Tok, diag::pp_include_next_in_primary);
1390 } else if (PP.getCurrentSubmodule()) {
1391 // Start looking up in the directory *after* the one in which the current
1392 // file would be found, if any.
1393 assert(PP.getCurrentLexer() && "#include_next directive in macro?");
1394 LookupFromFile = PP.getCurrentLexer()->getFileEntry();
1396 } else if (!Lookup) {
1397 PP.Diag(Tok, diag::pp_include_next_absolute_path);
1399 // Start looking up in the next directory.
1403 return EvaluateHasIncludeCommon(Tok, II, PP, Lookup, LookupFromFile);
1406 /// \brief Process __building_module(identifier) expression.
1407 /// \returns true if we are building the named module, false otherwise.
1408 static bool EvaluateBuildingModule(Token &Tok,
1409 IdentifierInfo *II, Preprocessor &PP) {
1411 PP.LexNonComment(Tok);
1413 // Ensure we have a '('.
1414 if (Tok.isNot(tok::l_paren)) {
1415 PP.Diag(Tok.getLocation(), diag::err_pp_expected_after) << II
1420 // Save '(' location for possible missing ')' message.
1421 SourceLocation LParenLoc = Tok.getLocation();
1423 // Get the module name.
1424 PP.LexNonComment(Tok);
1426 // Ensure that we have an identifier.
1427 if (Tok.isNot(tok::identifier)) {
1428 PP.Diag(Tok.getLocation(), diag::err_expected_id_building_module);
1433 = Tok.getIdentifierInfo()->getName() == PP.getLangOpts().CurrentModule;
1436 PP.LexNonComment(Tok);
1438 // Ensure we have a trailing ).
1439 if (Tok.isNot(tok::r_paren)) {
1440 PP.Diag(Tok.getLocation(), diag::err_pp_expected_after) << II
1442 PP.Diag(LParenLoc, diag::note_matching) << tok::l_paren;
1449 /// ExpandBuiltinMacro - If an identifier token is read that is to be expanded
1450 /// as a builtin macro, handle it and return the next token as 'Tok'.
1451 void Preprocessor::ExpandBuiltinMacro(Token &Tok) {
1452 // Figure out which token this is.
1453 IdentifierInfo *II = Tok.getIdentifierInfo();
1454 assert(II && "Can't be a macro without id info!");
1456 // If this is an _Pragma or Microsoft __pragma directive, expand it,
1457 // invoke the pragma handler, then lex the token after it.
1458 if (II == Ident_Pragma)
1459 return Handle_Pragma(Tok);
1460 else if (II == Ident__pragma) // in non-MS mode this is null
1461 return HandleMicrosoft__pragma(Tok);
1463 ++NumBuiltinMacroExpanded;
1465 SmallString<128> TmpBuffer;
1466 llvm::raw_svector_ostream OS(TmpBuffer);
1468 // Set up the return result.
1469 Tok.setIdentifierInfo(nullptr);
1470 Tok.clearFlag(Token::NeedsCleaning);
1472 if (II == Ident__LINE__) {
1473 // C99 6.10.8: "__LINE__: The presumed line number (within the current
1474 // source file) of the current source line (an integer constant)". This can
1475 // be affected by #line.
1476 SourceLocation Loc = Tok.getLocation();
1478 // Advance to the location of the first _, this might not be the first byte
1479 // of the token if it starts with an escaped newline.
1480 Loc = AdvanceToTokenCharacter(Loc, 0);
1482 // One wrinkle here is that GCC expands __LINE__ to location of the *end* of
1483 // a macro expansion. This doesn't matter for object-like macros, but
1484 // can matter for a function-like macro that expands to contain __LINE__.
1485 // Skip down through expansion points until we find a file loc for the
1486 // end of the expansion history.
1487 Loc = SourceMgr.getExpansionRange(Loc).second;
1488 PresumedLoc PLoc = SourceMgr.getPresumedLoc(Loc);
1490 // __LINE__ expands to a simple numeric value.
1491 OS << (PLoc.isValid()? PLoc.getLine() : 1);
1492 Tok.setKind(tok::numeric_constant);
1493 } else if (II == Ident__FILE__ || II == Ident__BASE_FILE__) {
1494 // C99 6.10.8: "__FILE__: The presumed name of the current source file (a
1495 // character string literal)". This can be affected by #line.
1496 PresumedLoc PLoc = SourceMgr.getPresumedLoc(Tok.getLocation());
1498 // __BASE_FILE__ is a GNU extension that returns the top of the presumed
1499 // #include stack instead of the current file.
1500 if (II == Ident__BASE_FILE__ && PLoc.isValid()) {
1501 SourceLocation NextLoc = PLoc.getIncludeLoc();
1502 while (NextLoc.isValid()) {
1503 PLoc = SourceMgr.getPresumedLoc(NextLoc);
1504 if (PLoc.isInvalid())
1507 NextLoc = PLoc.getIncludeLoc();
1511 // Escape this filename. Turn '\' -> '\\' '"' -> '\"'
1512 SmallString<128> FN;
1513 if (PLoc.isValid()) {
1514 FN += PLoc.getFilename();
1515 Lexer::Stringify(FN);
1516 OS << '"' << FN << '"';
1518 Tok.setKind(tok::string_literal);
1519 } else if (II == Ident__DATE__) {
1520 Diag(Tok.getLocation(), diag::warn_pp_date_time);
1521 if (!DATELoc.isValid())
1522 ComputeDATE_TIME(DATELoc, TIMELoc, *this);
1523 Tok.setKind(tok::string_literal);
1524 Tok.setLength(strlen("\"Mmm dd yyyy\""));
1525 Tok.setLocation(SourceMgr.createExpansionLoc(DATELoc, Tok.getLocation(),
1529 } else if (II == Ident__TIME__) {
1530 Diag(Tok.getLocation(), diag::warn_pp_date_time);
1531 if (!TIMELoc.isValid())
1532 ComputeDATE_TIME(DATELoc, TIMELoc, *this);
1533 Tok.setKind(tok::string_literal);
1534 Tok.setLength(strlen("\"hh:mm:ss\""));
1535 Tok.setLocation(SourceMgr.createExpansionLoc(TIMELoc, Tok.getLocation(),
1539 } else if (II == Ident__INCLUDE_LEVEL__) {
1540 // Compute the presumed include depth of this token. This can be affected
1541 // by GNU line markers.
1544 PresumedLoc PLoc = SourceMgr.getPresumedLoc(Tok.getLocation());
1545 if (PLoc.isValid()) {
1546 PLoc = SourceMgr.getPresumedLoc(PLoc.getIncludeLoc());
1547 for (; PLoc.isValid(); ++Depth)
1548 PLoc = SourceMgr.getPresumedLoc(PLoc.getIncludeLoc());
1551 // __INCLUDE_LEVEL__ expands to a simple numeric value.
1553 Tok.setKind(tok::numeric_constant);
1554 } else if (II == Ident__TIMESTAMP__) {
1555 Diag(Tok.getLocation(), diag::warn_pp_date_time);
1556 // MSVC, ICC, GCC, VisualAge C++ extension. The generated string should be
1557 // of the form "Ddd Mmm dd hh::mm::ss yyyy", which is returned by asctime.
1559 // Get the file that we are lexing out of. If we're currently lexing from
1560 // a macro, dig into the include stack.
1561 const FileEntry *CurFile = nullptr;
1562 PreprocessorLexer *TheLexer = getCurrentFileLexer();
1565 CurFile = SourceMgr.getFileEntryForID(TheLexer->getFileID());
1569 time_t TT = CurFile->getModificationTime();
1570 struct tm *TM = localtime(&TT);
1571 Result = asctime(TM);
1573 Result = "??? ??? ?? ??:??:?? ????\n";
1575 // Surround the string with " and strip the trailing newline.
1576 OS << '"' << StringRef(Result).drop_back() << '"';
1577 Tok.setKind(tok::string_literal);
1578 } else if (II == Ident__COUNTER__) {
1579 // __COUNTER__ expands to a simple numeric value.
1580 OS << CounterValue++;
1581 Tok.setKind(tok::numeric_constant);
1582 } else if (II == Ident__has_feature ||
1583 II == Ident__has_extension ||
1584 II == Ident__has_builtin ||
1585 II == Ident__is_identifier ||
1586 II == Ident__has_attribute ||
1587 II == Ident__has_declspec ||
1588 II == Ident__has_cpp_attribute) {
1589 // The argument to these builtins should be a parenthesized identifier.
1590 SourceLocation StartLoc = Tok.getLocation();
1592 bool IsValid = false;
1593 IdentifierInfo *FeatureII = nullptr;
1594 IdentifierInfo *ScopeII = nullptr;
1597 LexUnexpandedToken(Tok);
1598 if (Tok.is(tok::l_paren)) {
1599 // Read the identifier
1600 LexUnexpandedToken(Tok);
1601 if ((FeatureII = Tok.getIdentifierInfo())) {
1602 // If we're checking __has_cpp_attribute, it is possible to receive a
1603 // scope token. Read the "::", if it's available.
1604 LexUnexpandedToken(Tok);
1605 bool IsScopeValid = true;
1606 if (II == Ident__has_cpp_attribute && Tok.is(tok::coloncolon)) {
1607 LexUnexpandedToken(Tok);
1608 // The first thing we read was not the feature, it was the scope.
1609 ScopeII = FeatureII;
1610 if ((FeatureII = Tok.getIdentifierInfo()))
1611 LexUnexpandedToken(Tok);
1613 IsScopeValid = false;
1615 // Read the closing paren.
1616 if (IsScopeValid && Tok.is(tok::r_paren))
1619 // Eat tokens until ')'.
1620 while (Tok.isNot(tok::r_paren) && Tok.isNot(tok::eod) &&
1621 Tok.isNot(tok::eof))
1622 LexUnexpandedToken(Tok);
1627 Diag(StartLoc, diag::err_feature_check_malformed);
1628 else if (II == Ident__is_identifier)
1629 Value = FeatureII->getTokenID() == tok::identifier;
1630 else if (II == Ident__has_builtin) {
1631 // Check for a builtin is trivial.
1632 Value = FeatureII->getBuiltinID() != 0;
1633 } else if (II == Ident__has_attribute)
1634 Value = hasAttribute(AttrSyntax::GNU, nullptr, FeatureII,
1635 getTargetInfo().getTriple(), getLangOpts());
1636 else if (II == Ident__has_cpp_attribute)
1637 Value = hasAttribute(AttrSyntax::CXX, ScopeII, FeatureII,
1638 getTargetInfo().getTriple(), getLangOpts());
1639 else if (II == Ident__has_declspec)
1640 Value = hasAttribute(AttrSyntax::Declspec, nullptr, FeatureII,
1641 getTargetInfo().getTriple(), getLangOpts());
1642 else if (II == Ident__has_extension)
1643 Value = HasExtension(*this, FeatureII);
1645 assert(II == Ident__has_feature && "Must be feature check");
1646 Value = HasFeature(*this, FeatureII);
1652 Tok.setKind(tok::numeric_constant);
1653 } else if (II == Ident__has_include ||
1654 II == Ident__has_include_next) {
1655 // The argument to these two builtins should be a parenthesized
1656 // file name string literal using angle brackets (<>) or
1657 // double-quotes ("").
1659 if (II == Ident__has_include)
1660 Value = EvaluateHasInclude(Tok, II, *this);
1662 Value = EvaluateHasIncludeNext(Tok, II, *this);
1664 if (Tok.isNot(tok::r_paren))
1667 Tok.setKind(tok::numeric_constant);
1668 } else if (II == Ident__has_warning) {
1669 // The argument should be a parenthesized string literal.
1670 // The argument to these builtins should be a parenthesized identifier.
1671 SourceLocation StartLoc = Tok.getLocation();
1672 bool IsValid = false;
1675 LexUnexpandedToken(Tok);
1677 if (Tok.isNot(tok::l_paren)) {
1678 Diag(StartLoc, diag::err_warning_check_malformed);
1682 LexUnexpandedToken(Tok);
1683 std::string WarningName;
1684 SourceLocation StrStartLoc = Tok.getLocation();
1685 if (!FinishLexStringLiteral(Tok, WarningName, "'__has_warning'",
1686 /*MacroExpansion=*/false)) {
1687 // Eat tokens until ')'.
1688 while (Tok.isNot(tok::r_paren) && Tok.isNot(tok::eod) &&
1689 Tok.isNot(tok::eof))
1690 LexUnexpandedToken(Tok);
1694 // Is the end a ')'?
1695 if (!(IsValid = Tok.is(tok::r_paren))) {
1696 Diag(StartLoc, diag::err_warning_check_malformed);
1700 // FIXME: Should we accept "-R..." flags here, or should that be handled
1701 // by a separate __has_remark?
1702 if (WarningName.size() < 3 || WarningName[0] != '-' ||
1703 WarningName[1] != 'W') {
1704 Diag(StrStartLoc, diag::warn_has_warning_invalid_option);
1708 // Finally, check if the warning flags maps to a diagnostic group.
1709 // We construct a SmallVector here to talk to getDiagnosticIDs().
1710 // Although we don't use the result, this isn't a hot path, and not
1711 // worth special casing.
1712 SmallVector<diag::kind, 10> Diags;
1713 Value = !getDiagnostics().getDiagnosticIDs()->
1714 getDiagnosticsInGroup(diag::Flavor::WarningOrError,
1715 WarningName.substr(2), Diags);
1721 Tok.setKind(tok::numeric_constant);
1722 } else if (II == Ident__building_module) {
1723 // The argument to this builtin should be an identifier. The
1724 // builtin evaluates to 1 when that identifier names the module we are
1725 // currently building.
1726 OS << (int)EvaluateBuildingModule(Tok, II, *this);
1727 Tok.setKind(tok::numeric_constant);
1728 } else if (II == Ident__MODULE__) {
1729 // The current module as an identifier.
1730 OS << getLangOpts().CurrentModule;
1731 IdentifierInfo *ModuleII = getIdentifierInfo(getLangOpts().CurrentModule);
1732 Tok.setIdentifierInfo(ModuleII);
1733 Tok.setKind(ModuleII->getTokenID());
1734 } else if (II == Ident__identifier) {
1735 SourceLocation Loc = Tok.getLocation();
1737 // We're expecting '__identifier' '(' identifier ')'. Try to recover
1738 // if the parens are missing.
1740 if (Tok.isNot(tok::l_paren)) {
1741 // No '(', use end of last token.
1742 Diag(getLocForEndOfToken(Loc), diag::err_pp_expected_after)
1743 << II << tok::l_paren;
1744 // If the next token isn't valid as our argument, we can't recover.
1745 if (!Tok.isAnnotation() && Tok.getIdentifierInfo())
1746 Tok.setKind(tok::identifier);
1750 SourceLocation LParenLoc = Tok.getLocation();
1753 if (!Tok.isAnnotation() && Tok.getIdentifierInfo())
1754 Tok.setKind(tok::identifier);
1756 Diag(Tok.getLocation(), diag::err_pp_identifier_arg_not_identifier)
1758 // Don't walk past anything that's not a real token.
1759 if (Tok.isOneOf(tok::eof, tok::eod) || Tok.isAnnotation())
1763 // Discard the ')', preserving 'Tok' as our result.
1765 LexNonComment(RParen);
1766 if (RParen.isNot(tok::r_paren)) {
1767 Diag(getLocForEndOfToken(Tok.getLocation()), diag::err_pp_expected_after)
1768 << Tok.getKind() << tok::r_paren;
1769 Diag(LParenLoc, diag::note_matching) << tok::l_paren;
1773 llvm_unreachable("Unknown identifier!");
1775 CreateString(OS.str(), Tok, Tok.getLocation(), Tok.getLocation());
1778 void Preprocessor::markMacroAsUsed(MacroInfo *MI) {
1779 // If the 'used' status changed, and the macro requires 'unused' warning,
1780 // remove its SourceLocation from the warn-for-unused-macro locations.
1781 if (MI->isWarnIfUnused() && !MI->isUsed())
1782 WarnUnusedMacroLocs.erase(MI->getDefinitionLoc());
1783 MI->setIsUsed(true);