xref: /llvm-project-15.0.7/clang/lib/Sema/Sema.cpp (revision 7e82e019)
1 //===--- Sema.cpp - AST Builder and Semantic Analysis Implementation ------===//
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 actions class which performs semantic analysis and
11 // builds an AST out of a parse stream.
12 //
13 //===----------------------------------------------------------------------===//
14 
15 #include "clang/Sema/SemaInternal.h"
16 #include "clang/AST/ASTContext.h"
17 #include "clang/AST/ASTDiagnostic.h"
18 #include "clang/AST/DeclCXX.h"
19 #include "clang/AST/DeclFriend.h"
20 #include "clang/AST/DeclObjC.h"
21 #include "clang/AST/Expr.h"
22 #include "clang/AST/ExprCXX.h"
23 #include "clang/AST/StmtCXX.h"
24 #include "clang/Basic/DiagnosticOptions.h"
25 #include "clang/Basic/FileManager.h"
26 #include "clang/Basic/PartialDiagnostic.h"
27 #include "clang/Basic/TargetInfo.h"
28 #include "clang/Lex/HeaderSearch.h"
29 #include "clang/Lex/Preprocessor.h"
30 #include "clang/Sema/CXXFieldCollector.h"
31 #include "clang/Sema/DelayedDiagnostic.h"
32 #include "clang/Sema/ExternalSemaSource.h"
33 #include "clang/Sema/MultiplexExternalSemaSource.h"
34 #include "clang/Sema/ObjCMethodList.h"
35 #include "clang/Sema/PrettyDeclStackTrace.h"
36 #include "clang/Sema/Scope.h"
37 #include "clang/Sema/ScopeInfo.h"
38 #include "clang/Sema/SemaConsumer.h"
39 #include "clang/Sema/TemplateDeduction.h"
40 #include "llvm/ADT/APFloat.h"
41 #include "llvm/ADT/DenseMap.h"
42 #include "llvm/ADT/SmallSet.h"
43 using namespace clang;
44 using namespace sema;
45 
46 SourceLocation Sema::getLocForEndOfToken(SourceLocation Loc, unsigned Offset) {
47   return Lexer::getLocForEndOfToken(Loc, Offset, SourceMgr, LangOpts);
48 }
49 
50 ModuleLoader &Sema::getModuleLoader() const { return PP.getModuleLoader(); }
51 
52 PrintingPolicy Sema::getPrintingPolicy(const ASTContext &Context,
53                                        const Preprocessor &PP) {
54   PrintingPolicy Policy = Context.getPrintingPolicy();
55   Policy.Bool = Context.getLangOpts().Bool;
56   if (!Policy.Bool) {
57     if (const MacroInfo *
58           BoolMacro = PP.getMacroInfo(&Context.Idents.get("bool"))) {
59       Policy.Bool = BoolMacro->isObjectLike() &&
60         BoolMacro->getNumTokens() == 1 &&
61         BoolMacro->getReplacementToken(0).is(tok::kw__Bool);
62     }
63   }
64 
65   return Policy;
66 }
67 
68 void Sema::ActOnTranslationUnitScope(Scope *S) {
69   TUScope = S;
70   PushDeclContext(S, Context.getTranslationUnitDecl());
71 }
72 
73 Sema::Sema(Preprocessor &pp, ASTContext &ctxt, ASTConsumer &consumer,
74            TranslationUnitKind TUKind,
75            CodeCompleteConsumer *CodeCompleter)
76   : ExternalSource(nullptr),
77     isMultiplexExternalSource(false), FPFeatures(pp.getLangOpts()),
78     LangOpts(pp.getLangOpts()), PP(pp), Context(ctxt), Consumer(consumer),
79     Diags(PP.getDiagnostics()), SourceMgr(PP.getSourceManager()),
80     CollectStats(false), CodeCompleter(CodeCompleter),
81     CurContext(nullptr), OriginalLexicalContext(nullptr),
82     PackContext(nullptr), MSStructPragmaOn(false),
83     MSPointerToMemberRepresentationMethod(
84         LangOpts.getMSPointerToMemberRepresentationMethod()),
85     VtorDispModeStack(1, MSVtorDispAttr::Mode(LangOpts.VtorDispMode)),
86     DataSegStack(nullptr), BSSSegStack(nullptr), ConstSegStack(nullptr),
87     CodeSegStack(nullptr), CurInitSeg(nullptr), VisContext(nullptr),
88     IsBuildingRecoveryCallExpr(false),
89     ExprNeedsCleanups(false), LateTemplateParser(nullptr),
90     LateTemplateParserCleanup(nullptr),
91     OpaqueParser(nullptr), IdResolver(pp), StdInitializerList(nullptr),
92     CXXTypeInfoDecl(nullptr), MSVCGuidDecl(nullptr),
93     NSNumberDecl(nullptr), NSValueDecl(nullptr),
94     NSStringDecl(nullptr), StringWithUTF8StringMethod(nullptr),
95     ValueWithBytesObjCTypeMethod(nullptr),
96     NSArrayDecl(nullptr), ArrayWithObjectsMethod(nullptr),
97     NSDictionaryDecl(nullptr), DictionaryWithObjectsMethod(nullptr),
98     MSAsmLabelNameCounter(0),
99     GlobalNewDeleteDeclared(false),
100     TUKind(TUKind),
101     NumSFINAEErrors(0),
102     CachedFakeTopLevelModule(nullptr),
103     AccessCheckingSFINAE(false), InNonInstantiationSFINAEContext(false),
104     NonInstantiationEntries(0), ArgumentPackSubstitutionIndex(-1),
105     CurrentInstantiationScope(nullptr), DisableTypoCorrection(false),
106     TyposCorrected(0), AnalysisWarnings(*this), ThreadSafetyDeclCache(nullptr),
107     VarDataSharingAttributesStack(nullptr), CurScope(nullptr),
108     Ident_super(nullptr), Ident___float128(nullptr)
109 {
110   TUScope = nullptr;
111 
112   LoadedExternalKnownNamespaces = false;
113   for (unsigned I = 0; I != NSAPI::NumNSNumberLiteralMethods; ++I)
114     NSNumberLiteralMethods[I] = nullptr;
115 
116   if (getLangOpts().ObjC1)
117     NSAPIObj.reset(new NSAPI(Context));
118 
119   if (getLangOpts().CPlusPlus)
120     FieldCollector.reset(new CXXFieldCollector());
121 
122   // Tell diagnostics how to render things from the AST library.
123   Diags.SetArgToStringFn(&FormatASTNodeDiagnosticArgument, &Context);
124 
125   ExprEvalContexts.emplace_back(PotentiallyEvaluated, 0, false, nullptr, false);
126 
127   FunctionScopes.push_back(new FunctionScopeInfo(Diags));
128 
129   // Initilization of data sharing attributes stack for OpenMP
130   InitDataSharingAttributesStack();
131 }
132 
133 void Sema::addImplicitTypedef(StringRef Name, QualType T) {
134   DeclarationName DN = &Context.Idents.get(Name);
135   if (IdResolver.begin(DN) == IdResolver.end())
136     PushOnScopeChains(Context.buildImplicitTypedef(T, Name), TUScope);
137 }
138 
139 void Sema::Initialize() {
140   if (SemaConsumer *SC = dyn_cast<SemaConsumer>(&Consumer))
141     SC->InitializeSema(*this);
142 
143   // Tell the external Sema source about this Sema object.
144   if (ExternalSemaSource *ExternalSema
145       = dyn_cast_or_null<ExternalSemaSource>(Context.getExternalSource()))
146     ExternalSema->InitializeSema(*this);
147 
148   // This needs to happen after ExternalSemaSource::InitializeSema(this) or we
149   // will not be able to merge any duplicate __va_list_tag decls correctly.
150   VAListTagName = PP.getIdentifierInfo("__va_list_tag");
151 
152   if (!TUScope)
153     return;
154 
155   // Initialize predefined 128-bit integer types, if needed.
156   if (Context.getTargetInfo().hasInt128Type()) {
157     // If either of the 128-bit integer types are unavailable to name lookup,
158     // define them now.
159     DeclarationName Int128 = &Context.Idents.get("__int128_t");
160     if (IdResolver.begin(Int128) == IdResolver.end())
161       PushOnScopeChains(Context.getInt128Decl(), TUScope);
162 
163     DeclarationName UInt128 = &Context.Idents.get("__uint128_t");
164     if (IdResolver.begin(UInt128) == IdResolver.end())
165       PushOnScopeChains(Context.getUInt128Decl(), TUScope);
166   }
167 
168 
169   // Initialize predefined Objective-C types:
170   if (getLangOpts().ObjC1) {
171     // If 'SEL' does not yet refer to any declarations, make it refer to the
172     // predefined 'SEL'.
173     DeclarationName SEL = &Context.Idents.get("SEL");
174     if (IdResolver.begin(SEL) == IdResolver.end())
175       PushOnScopeChains(Context.getObjCSelDecl(), TUScope);
176 
177     // If 'id' does not yet refer to any declarations, make it refer to the
178     // predefined 'id'.
179     DeclarationName Id = &Context.Idents.get("id");
180     if (IdResolver.begin(Id) == IdResolver.end())
181       PushOnScopeChains(Context.getObjCIdDecl(), TUScope);
182 
183     // Create the built-in typedef for 'Class'.
184     DeclarationName Class = &Context.Idents.get("Class");
185     if (IdResolver.begin(Class) == IdResolver.end())
186       PushOnScopeChains(Context.getObjCClassDecl(), TUScope);
187 
188     // Create the built-in forward declaratino for 'Protocol'.
189     DeclarationName Protocol = &Context.Idents.get("Protocol");
190     if (IdResolver.begin(Protocol) == IdResolver.end())
191       PushOnScopeChains(Context.getObjCProtocolDecl(), TUScope);
192   }
193 
194   // Create the internal type for the *StringMakeConstantString builtins.
195   DeclarationName ConstantString = &Context.Idents.get("__NSConstantString");
196   if (IdResolver.begin(ConstantString) == IdResolver.end())
197     PushOnScopeChains(Context.getCFConstantStringDecl(), TUScope);
198 
199   // Initialize Microsoft "predefined C++ types".
200   if (getLangOpts().MSVCCompat) {
201     if (getLangOpts().CPlusPlus &&
202         IdResolver.begin(&Context.Idents.get("type_info")) == IdResolver.end())
203       PushOnScopeChains(Context.buildImplicitRecord("type_info", TTK_Class),
204                         TUScope);
205 
206     addImplicitTypedef("size_t", Context.getSizeType());
207   }
208 
209   // Initialize predefined OpenCL types.
210   if (getLangOpts().OpenCL) {
211     addImplicitTypedef("image1d_t", Context.OCLImage1dTy);
212     addImplicitTypedef("image1d_array_t", Context.OCLImage1dArrayTy);
213     addImplicitTypedef("image1d_buffer_t", Context.OCLImage1dBufferTy);
214     addImplicitTypedef("image2d_t", Context.OCLImage2dTy);
215     addImplicitTypedef("image2d_array_t", Context.OCLImage2dArrayTy);
216     addImplicitTypedef("image3d_t", Context.OCLImage3dTy);
217     addImplicitTypedef("sampler_t", Context.OCLSamplerTy);
218     addImplicitTypedef("event_t", Context.OCLEventTy);
219     if (getLangOpts().OpenCLVersion >= 200) {
220       addImplicitTypedef("image2d_depth_t", Context.OCLImage2dDepthTy);
221       addImplicitTypedef("image2d_array_depth_t",
222                          Context.OCLImage2dArrayDepthTy);
223       addImplicitTypedef("image2d_msaa_t", Context.OCLImage2dMSAATy);
224       addImplicitTypedef("image2d_array_msaa_t", Context.OCLImage2dArrayMSAATy);
225       addImplicitTypedef("image2d_msaa_depth_t", Context.OCLImage2dMSAADepthTy);
226       addImplicitTypedef("image2d_array_msaa_depth_t",
227                          Context.OCLImage2dArrayMSAADepthTy);
228       addImplicitTypedef("clk_event_t", Context.OCLClkEventTy);
229       addImplicitTypedef("queue_t", Context.OCLQueueTy);
230       addImplicitTypedef("ndrange_t", Context.OCLNDRangeTy);
231       addImplicitTypedef("reserve_id_t", Context.OCLReserveIDTy);
232       addImplicitTypedef("atomic_int", Context.getAtomicType(Context.IntTy));
233       addImplicitTypedef("atomic_uint",
234                          Context.getAtomicType(Context.UnsignedIntTy));
235       addImplicitTypedef("atomic_long", Context.getAtomicType(Context.LongTy));
236       addImplicitTypedef("atomic_ulong",
237                          Context.getAtomicType(Context.UnsignedLongTy));
238       addImplicitTypedef("atomic_float",
239                          Context.getAtomicType(Context.FloatTy));
240       addImplicitTypedef("atomic_double",
241                          Context.getAtomicType(Context.DoubleTy));
242       // OpenCLC v2.0, s6.13.11.6 requires that atomic_flag is implemented as
243       // 32-bit integer and OpenCLC v2.0, s6.1.1 int is always 32-bit wide.
244       addImplicitTypedef("atomic_flag", Context.getAtomicType(Context.IntTy));
245       addImplicitTypedef("atomic_intptr_t",
246                          Context.getAtomicType(Context.getIntPtrType()));
247       addImplicitTypedef("atomic_uintptr_t",
248                          Context.getAtomicType(Context.getUIntPtrType()));
249       addImplicitTypedef("atomic_size_t",
250                          Context.getAtomicType(Context.getSizeType()));
251       addImplicitTypedef("atomic_ptrdiff_t",
252                          Context.getAtomicType(Context.getPointerDiffType()));
253     }
254   }
255 
256   if (Context.getTargetInfo().hasBuiltinMSVaList()) {
257     DeclarationName MSVaList = &Context.Idents.get("__builtin_ms_va_list");
258     if (IdResolver.begin(MSVaList) == IdResolver.end())
259       PushOnScopeChains(Context.getBuiltinMSVaListDecl(), TUScope);
260   }
261 
262   DeclarationName BuiltinVaList = &Context.Idents.get("__builtin_va_list");
263   if (IdResolver.begin(BuiltinVaList) == IdResolver.end())
264     PushOnScopeChains(Context.getBuiltinVaListDecl(), TUScope);
265 }
266 
267 Sema::~Sema() {
268   llvm::DeleteContainerSeconds(LateParsedTemplateMap);
269   if (PackContext) FreePackedContext();
270   if (VisContext) FreeVisContext();
271   // Kill all the active scopes.
272   for (unsigned I = 1, E = FunctionScopes.size(); I != E; ++I)
273     delete FunctionScopes[I];
274   if (FunctionScopes.size() == 1)
275     delete FunctionScopes[0];
276 
277   // Tell the SemaConsumer to forget about us; we're going out of scope.
278   if (SemaConsumer *SC = dyn_cast<SemaConsumer>(&Consumer))
279     SC->ForgetSema();
280 
281   // Detach from the external Sema source.
282   if (ExternalSemaSource *ExternalSema
283         = dyn_cast_or_null<ExternalSemaSource>(Context.getExternalSource()))
284     ExternalSema->ForgetSema();
285 
286   // If Sema's ExternalSource is the multiplexer - we own it.
287   if (isMultiplexExternalSource)
288     delete ExternalSource;
289 
290   threadSafety::threadSafetyCleanup(ThreadSafetyDeclCache);
291 
292   // Destroys data sharing attributes stack for OpenMP
293   DestroyDataSharingAttributesStack();
294 
295   assert(DelayedTypos.empty() && "Uncorrected typos!");
296 }
297 
298 /// makeUnavailableInSystemHeader - There is an error in the current
299 /// context.  If we're still in a system header, and we can plausibly
300 /// make the relevant declaration unavailable instead of erroring, do
301 /// so and return true.
302 bool Sema::makeUnavailableInSystemHeader(SourceLocation loc,
303                                       UnavailableAttr::ImplicitReason reason) {
304   // If we're not in a function, it's an error.
305   FunctionDecl *fn = dyn_cast<FunctionDecl>(CurContext);
306   if (!fn) return false;
307 
308   // If we're in template instantiation, it's an error.
309   if (!ActiveTemplateInstantiations.empty())
310     return false;
311 
312   // If that function's not in a system header, it's an error.
313   if (!Context.getSourceManager().isInSystemHeader(loc))
314     return false;
315 
316   // If the function is already unavailable, it's not an error.
317   if (fn->hasAttr<UnavailableAttr>()) return true;
318 
319   fn->addAttr(UnavailableAttr::CreateImplicit(Context, "", reason, loc));
320   return true;
321 }
322 
323 ASTMutationListener *Sema::getASTMutationListener() const {
324   return getASTConsumer().GetASTMutationListener();
325 }
326 
327 ///\brief Registers an external source. If an external source already exists,
328 /// creates a multiplex external source and appends to it.
329 ///
330 ///\param[in] E - A non-null external sema source.
331 ///
332 void Sema::addExternalSource(ExternalSemaSource *E) {
333   assert(E && "Cannot use with NULL ptr");
334 
335   if (!ExternalSource) {
336     ExternalSource = E;
337     return;
338   }
339 
340   if (isMultiplexExternalSource)
341     static_cast<MultiplexExternalSemaSource*>(ExternalSource)->addSource(*E);
342   else {
343     ExternalSource = new MultiplexExternalSemaSource(*ExternalSource, *E);
344     isMultiplexExternalSource = true;
345   }
346 }
347 
348 /// \brief Print out statistics about the semantic analysis.
349 void Sema::PrintStats() const {
350   llvm::errs() << "\n*** Semantic Analysis Stats:\n";
351   llvm::errs() << NumSFINAEErrors << " SFINAE diagnostics trapped.\n";
352 
353   BumpAlloc.PrintStats();
354   AnalysisWarnings.PrintStats();
355 }
356 
357 void Sema::diagnoseNullableToNonnullConversion(QualType DstType,
358                                                QualType SrcType,
359                                                SourceLocation Loc) {
360   Optional<NullabilityKind> ExprNullability = SrcType->getNullability(Context);
361   if (!ExprNullability || *ExprNullability != NullabilityKind::Nullable)
362     return;
363 
364   Optional<NullabilityKind> TypeNullability = DstType->getNullability(Context);
365   if (!TypeNullability || *TypeNullability != NullabilityKind::NonNull)
366     return;
367 
368   Diag(Loc, diag::warn_nullability_lost) << SrcType << DstType;
369 }
370 
371 /// ImpCastExprToType - If Expr is not of type 'Type', insert an implicit cast.
372 /// If there is already an implicit cast, merge into the existing one.
373 /// The result is of the given category.
374 ExprResult Sema::ImpCastExprToType(Expr *E, QualType Ty,
375                                    CastKind Kind, ExprValueKind VK,
376                                    const CXXCastPath *BasePath,
377                                    CheckedConversionKind CCK) {
378 #ifndef NDEBUG
379   if (VK == VK_RValue && !E->isRValue()) {
380     switch (Kind) {
381     default:
382       llvm_unreachable("can't implicitly cast lvalue to rvalue with this cast "
383                        "kind");
384     case CK_LValueToRValue:
385     case CK_ArrayToPointerDecay:
386     case CK_FunctionToPointerDecay:
387     case CK_ToVoid:
388       break;
389     }
390   }
391   assert((VK == VK_RValue || !E->isRValue()) && "can't cast rvalue to lvalue");
392 #endif
393 
394   diagnoseNullableToNonnullConversion(Ty, E->getType(), E->getLocStart());
395 
396   QualType ExprTy = Context.getCanonicalType(E->getType());
397   QualType TypeTy = Context.getCanonicalType(Ty);
398 
399   if (ExprTy == TypeTy)
400     return E;
401 
402   if (ImplicitCastExpr *ImpCast = dyn_cast<ImplicitCastExpr>(E)) {
403     if (ImpCast->getCastKind() == Kind && (!BasePath || BasePath->empty())) {
404       ImpCast->setType(Ty);
405       ImpCast->setValueKind(VK);
406       return E;
407     }
408   }
409 
410   return ImplicitCastExpr::Create(Context, Ty, Kind, E, BasePath, VK);
411 }
412 
413 /// ScalarTypeToBooleanCastKind - Returns the cast kind corresponding
414 /// to the conversion from scalar type ScalarTy to the Boolean type.
415 CastKind Sema::ScalarTypeToBooleanCastKind(QualType ScalarTy) {
416   switch (ScalarTy->getScalarTypeKind()) {
417   case Type::STK_Bool: return CK_NoOp;
418   case Type::STK_CPointer: return CK_PointerToBoolean;
419   case Type::STK_BlockPointer: return CK_PointerToBoolean;
420   case Type::STK_ObjCObjectPointer: return CK_PointerToBoolean;
421   case Type::STK_MemberPointer: return CK_MemberPointerToBoolean;
422   case Type::STK_Integral: return CK_IntegralToBoolean;
423   case Type::STK_Floating: return CK_FloatingToBoolean;
424   case Type::STK_IntegralComplex: return CK_IntegralComplexToBoolean;
425   case Type::STK_FloatingComplex: return CK_FloatingComplexToBoolean;
426   }
427   return CK_Invalid;
428 }
429 
430 /// \brief Used to prune the decls of Sema's UnusedFileScopedDecls vector.
431 static bool ShouldRemoveFromUnused(Sema *SemaRef, const DeclaratorDecl *D) {
432   if (D->getMostRecentDecl()->isUsed())
433     return true;
434 
435   if (D->isExternallyVisible())
436     return true;
437 
438   if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(D)) {
439     // UnusedFileScopedDecls stores the first declaration.
440     // The declaration may have become definition so check again.
441     const FunctionDecl *DeclToCheck;
442     if (FD->hasBody(DeclToCheck))
443       return !SemaRef->ShouldWarnIfUnusedFileScopedDecl(DeclToCheck);
444 
445     // Later redecls may add new information resulting in not having to warn,
446     // so check again.
447     DeclToCheck = FD->getMostRecentDecl();
448     if (DeclToCheck != FD)
449       return !SemaRef->ShouldWarnIfUnusedFileScopedDecl(DeclToCheck);
450   }
451 
452   if (const VarDecl *VD = dyn_cast<VarDecl>(D)) {
453     // If a variable usable in constant expressions is referenced,
454     // don't warn if it isn't used: if the value of a variable is required
455     // for the computation of a constant expression, it doesn't make sense to
456     // warn even if the variable isn't odr-used.  (isReferenced doesn't
457     // precisely reflect that, but it's a decent approximation.)
458     if (VD->isReferenced() &&
459         VD->isUsableInConstantExpressions(SemaRef->Context))
460       return true;
461 
462     // UnusedFileScopedDecls stores the first declaration.
463     // The declaration may have become definition so check again.
464     const VarDecl *DeclToCheck = VD->getDefinition();
465     if (DeclToCheck)
466       return !SemaRef->ShouldWarnIfUnusedFileScopedDecl(DeclToCheck);
467 
468     // Later redecls may add new information resulting in not having to warn,
469     // so check again.
470     DeclToCheck = VD->getMostRecentDecl();
471     if (DeclToCheck != VD)
472       return !SemaRef->ShouldWarnIfUnusedFileScopedDecl(DeclToCheck);
473   }
474 
475   return false;
476 }
477 
478 /// Obtains a sorted list of functions that are undefined but ODR-used.
479 void Sema::getUndefinedButUsed(
480     SmallVectorImpl<std::pair<NamedDecl *, SourceLocation> > &Undefined) {
481   for (llvm::DenseMap<NamedDecl *, SourceLocation>::iterator
482          I = UndefinedButUsed.begin(), E = UndefinedButUsed.end();
483        I != E; ++I) {
484     NamedDecl *ND = I->first;
485 
486     // Ignore attributes that have become invalid.
487     if (ND->isInvalidDecl()) continue;
488 
489     // __attribute__((weakref)) is basically a definition.
490     if (ND->hasAttr<WeakRefAttr>()) continue;
491 
492     if (FunctionDecl *FD = dyn_cast<FunctionDecl>(ND)) {
493       if (FD->isDefined())
494         continue;
495       if (FD->isExternallyVisible() &&
496           !FD->getMostRecentDecl()->isInlined())
497         continue;
498     } else {
499       if (cast<VarDecl>(ND)->hasDefinition() != VarDecl::DeclarationOnly)
500         continue;
501       if (ND->isExternallyVisible())
502         continue;
503     }
504 
505     Undefined.push_back(std::make_pair(ND, I->second));
506   }
507 
508   // Sort (in order of use site) so that we're not dependent on the iteration
509   // order through an llvm::DenseMap.
510   SourceManager &SM = Context.getSourceManager();
511   std::sort(Undefined.begin(), Undefined.end(),
512             [&SM](const std::pair<NamedDecl *, SourceLocation> &l,
513                   const std::pair<NamedDecl *, SourceLocation> &r) {
514     if (l.second.isValid() && !r.second.isValid())
515       return true;
516     if (!l.second.isValid() && r.second.isValid())
517       return false;
518     if (l.second != r.second)
519       return SM.isBeforeInTranslationUnit(l.second, r.second);
520     return SM.isBeforeInTranslationUnit(l.first->getLocation(),
521                                         r.first->getLocation());
522   });
523 }
524 
525 /// checkUndefinedButUsed - Check for undefined objects with internal linkage
526 /// or that are inline.
527 static void checkUndefinedButUsed(Sema &S) {
528   if (S.UndefinedButUsed.empty()) return;
529 
530   // Collect all the still-undefined entities with internal linkage.
531   SmallVector<std::pair<NamedDecl *, SourceLocation>, 16> Undefined;
532   S.getUndefinedButUsed(Undefined);
533   if (Undefined.empty()) return;
534 
535   for (SmallVectorImpl<std::pair<NamedDecl *, SourceLocation> >::iterator
536          I = Undefined.begin(), E = Undefined.end(); I != E; ++I) {
537     NamedDecl *ND = I->first;
538 
539     if (ND->hasAttr<DLLImportAttr>() || ND->hasAttr<DLLExportAttr>()) {
540       // An exported function will always be emitted when defined, so even if
541       // the function is inline, it doesn't have to be emitted in this TU. An
542       // imported function implies that it has been exported somewhere else.
543       continue;
544     }
545 
546     if (!ND->isExternallyVisible()) {
547       S.Diag(ND->getLocation(), diag::warn_undefined_internal)
548         << isa<VarDecl>(ND) << ND;
549     } else {
550       assert(cast<FunctionDecl>(ND)->getMostRecentDecl()->isInlined() &&
551              "used object requires definition but isn't inline or internal?");
552       S.Diag(ND->getLocation(), diag::warn_undefined_inline) << ND;
553     }
554     if (I->second.isValid())
555       S.Diag(I->second, diag::note_used_here);
556   }
557 }
558 
559 void Sema::LoadExternalWeakUndeclaredIdentifiers() {
560   if (!ExternalSource)
561     return;
562 
563   SmallVector<std::pair<IdentifierInfo *, WeakInfo>, 4> WeakIDs;
564   ExternalSource->ReadWeakUndeclaredIdentifiers(WeakIDs);
565   for (auto &WeakID : WeakIDs)
566     WeakUndeclaredIdentifiers.insert(WeakID);
567 }
568 
569 
570 typedef llvm::DenseMap<const CXXRecordDecl*, bool> RecordCompleteMap;
571 
572 /// \brief Returns true, if all methods and nested classes of the given
573 /// CXXRecordDecl are defined in this translation unit.
574 ///
575 /// Should only be called from ActOnEndOfTranslationUnit so that all
576 /// definitions are actually read.
577 static bool MethodsAndNestedClassesComplete(const CXXRecordDecl *RD,
578                                             RecordCompleteMap &MNCComplete) {
579   RecordCompleteMap::iterator Cache = MNCComplete.find(RD);
580   if (Cache != MNCComplete.end())
581     return Cache->second;
582   if (!RD->isCompleteDefinition())
583     return false;
584   bool Complete = true;
585   for (DeclContext::decl_iterator I = RD->decls_begin(),
586                                   E = RD->decls_end();
587        I != E && Complete; ++I) {
588     if (const CXXMethodDecl *M = dyn_cast<CXXMethodDecl>(*I))
589       Complete = M->isDefined() || (M->isPure() && !isa<CXXDestructorDecl>(M));
590     else if (const FunctionTemplateDecl *F = dyn_cast<FunctionTemplateDecl>(*I))
591       // If the template function is marked as late template parsed at this
592       // point, it has not been instantiated and therefore we have not
593       // performed semantic analysis on it yet, so we cannot know if the type
594       // can be considered complete.
595       Complete = !F->getTemplatedDecl()->isLateTemplateParsed() &&
596                   F->getTemplatedDecl()->isDefined();
597     else if (const CXXRecordDecl *R = dyn_cast<CXXRecordDecl>(*I)) {
598       if (R->isInjectedClassName())
599         continue;
600       if (R->hasDefinition())
601         Complete = MethodsAndNestedClassesComplete(R->getDefinition(),
602                                                    MNCComplete);
603       else
604         Complete = false;
605     }
606   }
607   MNCComplete[RD] = Complete;
608   return Complete;
609 }
610 
611 /// \brief Returns true, if the given CXXRecordDecl is fully defined in this
612 /// translation unit, i.e. all methods are defined or pure virtual and all
613 /// friends, friend functions and nested classes are fully defined in this
614 /// translation unit.
615 ///
616 /// Should only be called from ActOnEndOfTranslationUnit so that all
617 /// definitions are actually read.
618 static bool IsRecordFullyDefined(const CXXRecordDecl *RD,
619                                  RecordCompleteMap &RecordsComplete,
620                                  RecordCompleteMap &MNCComplete) {
621   RecordCompleteMap::iterator Cache = RecordsComplete.find(RD);
622   if (Cache != RecordsComplete.end())
623     return Cache->second;
624   bool Complete = MethodsAndNestedClassesComplete(RD, MNCComplete);
625   for (CXXRecordDecl::friend_iterator I = RD->friend_begin(),
626                                       E = RD->friend_end();
627        I != E && Complete; ++I) {
628     // Check if friend classes and methods are complete.
629     if (TypeSourceInfo *TSI = (*I)->getFriendType()) {
630       // Friend classes are available as the TypeSourceInfo of the FriendDecl.
631       if (CXXRecordDecl *FriendD = TSI->getType()->getAsCXXRecordDecl())
632         Complete = MethodsAndNestedClassesComplete(FriendD, MNCComplete);
633       else
634         Complete = false;
635     } else {
636       // Friend functions are available through the NamedDecl of FriendDecl.
637       if (const FunctionDecl *FD =
638           dyn_cast<FunctionDecl>((*I)->getFriendDecl()))
639         Complete = FD->isDefined();
640       else
641         // This is a template friend, give up.
642         Complete = false;
643     }
644   }
645   RecordsComplete[RD] = Complete;
646   return Complete;
647 }
648 
649 void Sema::emitAndClearUnusedLocalTypedefWarnings() {
650   if (ExternalSource)
651     ExternalSource->ReadUnusedLocalTypedefNameCandidates(
652         UnusedLocalTypedefNameCandidates);
653   for (const TypedefNameDecl *TD : UnusedLocalTypedefNameCandidates) {
654     if (TD->isReferenced())
655       continue;
656     Diag(TD->getLocation(), diag::warn_unused_local_typedef)
657         << isa<TypeAliasDecl>(TD) << TD->getDeclName();
658   }
659   UnusedLocalTypedefNameCandidates.clear();
660 }
661 
662 /// ActOnEndOfTranslationUnit - This is called at the very end of the
663 /// translation unit when EOF is reached and all but the top-level scope is
664 /// popped.
665 void Sema::ActOnEndOfTranslationUnit() {
666   assert(DelayedDiagnostics.getCurrentPool() == nullptr
667          && "reached end of translation unit with a pool attached?");
668 
669   // If code completion is enabled, don't perform any end-of-translation-unit
670   // work.
671   if (PP.isCodeCompletionEnabled())
672     return;
673 
674   // Complete translation units and modules define vtables and perform implicit
675   // instantiations. PCH files do not.
676   if (TUKind != TU_Prefix) {
677     DiagnoseUseOfUnimplementedSelectors();
678 
679     // If DefinedUsedVTables ends up marking any virtual member functions it
680     // might lead to more pending template instantiations, which we then need
681     // to instantiate.
682     DefineUsedVTables();
683 
684     // C++: Perform implicit template instantiations.
685     //
686     // FIXME: When we perform these implicit instantiations, we do not
687     // carefully keep track of the point of instantiation (C++ [temp.point]).
688     // This means that name lookup that occurs within the template
689     // instantiation will always happen at the end of the translation unit,
690     // so it will find some names that are not required to be found. This is
691     // valid, but we could do better by diagnosing if an instantiation uses a
692     // name that was not visible at its first point of instantiation.
693     if (ExternalSource) {
694       // Load pending instantiations from the external source.
695       SmallVector<PendingImplicitInstantiation, 4> Pending;
696       ExternalSource->ReadPendingInstantiations(Pending);
697       PendingInstantiations.insert(PendingInstantiations.begin(),
698                                    Pending.begin(), Pending.end());
699     }
700     PerformPendingInstantiations();
701 
702     if (LateTemplateParserCleanup)
703       LateTemplateParserCleanup(OpaqueParser);
704 
705     CheckDelayedMemberExceptionSpecs();
706   }
707 
708   // All delayed member exception specs should be checked or we end up accepting
709   // incompatible declarations.
710   // FIXME: This is wrong for TUKind == TU_Prefix. In that case, we need to
711   // write out the lists to the AST file (if any).
712   assert(DelayedDefaultedMemberExceptionSpecs.empty());
713   assert(DelayedExceptionSpecChecks.empty());
714 
715   // All dllexport classes should have been processed already.
716   assert(DelayedDllExportClasses.empty());
717 
718   // Remove file scoped decls that turned out to be used.
719   UnusedFileScopedDecls.erase(
720       std::remove_if(UnusedFileScopedDecls.begin(nullptr, true),
721                      UnusedFileScopedDecls.end(),
722                      std::bind1st(std::ptr_fun(ShouldRemoveFromUnused), this)),
723       UnusedFileScopedDecls.end());
724 
725   if (TUKind == TU_Prefix) {
726     // Translation unit prefixes don't need any of the checking below.
727     TUScope = nullptr;
728     return;
729   }
730 
731   // Check for #pragma weak identifiers that were never declared
732   LoadExternalWeakUndeclaredIdentifiers();
733   for (auto WeakID : WeakUndeclaredIdentifiers) {
734     if (WeakID.second.getUsed())
735       continue;
736 
737     Decl *PrevDecl = LookupSingleName(TUScope, WeakID.first, SourceLocation(),
738                                       LookupOrdinaryName);
739     if (PrevDecl != nullptr &&
740         !(isa<FunctionDecl>(PrevDecl) || isa<VarDecl>(PrevDecl)))
741       Diag(WeakID.second.getLocation(), diag::warn_attribute_wrong_decl_type)
742           << "'weak'" << ExpectedVariableOrFunction;
743     else
744       Diag(WeakID.second.getLocation(), diag::warn_weak_identifier_undeclared)
745           << WeakID.first;
746   }
747 
748   if (LangOpts.CPlusPlus11 &&
749       !Diags.isIgnored(diag::warn_delegating_ctor_cycle, SourceLocation()))
750     CheckDelegatingCtorCycles();
751 
752   if (TUKind == TU_Module) {
753     // If we are building a module, resolve all of the exported declarations
754     // now.
755     if (Module *CurrentModule = PP.getCurrentModule()) {
756       ModuleMap &ModMap = PP.getHeaderSearchInfo().getModuleMap();
757 
758       SmallVector<Module *, 2> Stack;
759       Stack.push_back(CurrentModule);
760       while (!Stack.empty()) {
761         Module *Mod = Stack.pop_back_val();
762 
763         // Resolve the exported declarations and conflicts.
764         // FIXME: Actually complain, once we figure out how to teach the
765         // diagnostic client to deal with complaints in the module map at this
766         // point.
767         ModMap.resolveExports(Mod, /*Complain=*/false);
768         ModMap.resolveUses(Mod, /*Complain=*/false);
769         ModMap.resolveConflicts(Mod, /*Complain=*/false);
770 
771         // Queue the submodules, so their exports will also be resolved.
772         Stack.append(Mod->submodule_begin(), Mod->submodule_end());
773       }
774     }
775 
776     // Warnings emitted in ActOnEndOfTranslationUnit() should be emitted for
777     // modules when they are built, not every time they are used.
778     emitAndClearUnusedLocalTypedefWarnings();
779 
780     // Modules don't need any of the checking below.
781     TUScope = nullptr;
782     return;
783   }
784 
785   // C99 6.9.2p2:
786   //   A declaration of an identifier for an object that has file
787   //   scope without an initializer, and without a storage-class
788   //   specifier or with the storage-class specifier static,
789   //   constitutes a tentative definition. If a translation unit
790   //   contains one or more tentative definitions for an identifier,
791   //   and the translation unit contains no external definition for
792   //   that identifier, then the behavior is exactly as if the
793   //   translation unit contains a file scope declaration of that
794   //   identifier, with the composite type as of the end of the
795   //   translation unit, with an initializer equal to 0.
796   llvm::SmallSet<VarDecl *, 32> Seen;
797   for (TentativeDefinitionsType::iterator
798             T = TentativeDefinitions.begin(ExternalSource),
799          TEnd = TentativeDefinitions.end();
800        T != TEnd; ++T)
801   {
802     VarDecl *VD = (*T)->getActingDefinition();
803 
804     // If the tentative definition was completed, getActingDefinition() returns
805     // null. If we've already seen this variable before, insert()'s second
806     // return value is false.
807     if (!VD || VD->isInvalidDecl() || !Seen.insert(VD).second)
808       continue;
809 
810     if (const IncompleteArrayType *ArrayT
811         = Context.getAsIncompleteArrayType(VD->getType())) {
812       // Set the length of the array to 1 (C99 6.9.2p5).
813       Diag(VD->getLocation(), diag::warn_tentative_incomplete_array);
814       llvm::APInt One(Context.getTypeSize(Context.getSizeType()), true);
815       QualType T = Context.getConstantArrayType(ArrayT->getElementType(),
816                                                 One, ArrayType::Normal, 0);
817       VD->setType(T);
818     } else if (RequireCompleteType(VD->getLocation(), VD->getType(),
819                                    diag::err_tentative_def_incomplete_type))
820       VD->setInvalidDecl();
821 
822     CheckCompleteVariableDeclaration(VD);
823 
824     // Notify the consumer that we've completed a tentative definition.
825     if (!VD->isInvalidDecl())
826       Consumer.CompleteTentativeDefinition(VD);
827 
828   }
829 
830   // If there were errors, disable 'unused' warnings since they will mostly be
831   // noise.
832   if (!Diags.hasErrorOccurred()) {
833     // Output warning for unused file scoped decls.
834     for (UnusedFileScopedDeclsType::iterator
835            I = UnusedFileScopedDecls.begin(ExternalSource),
836            E = UnusedFileScopedDecls.end(); I != E; ++I) {
837       if (ShouldRemoveFromUnused(this, *I))
838         continue;
839 
840       if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(*I)) {
841         const FunctionDecl *DiagD;
842         if (!FD->hasBody(DiagD))
843           DiagD = FD;
844         if (DiagD->isDeleted())
845           continue; // Deleted functions are supposed to be unused.
846         if (DiagD->isReferenced()) {
847           if (isa<CXXMethodDecl>(DiagD))
848             Diag(DiagD->getLocation(), diag::warn_unneeded_member_function)
849                   << DiagD->getDeclName();
850           else {
851             if (FD->getStorageClass() == SC_Static &&
852                 !FD->isInlineSpecified() &&
853                 !SourceMgr.isInMainFile(
854                    SourceMgr.getExpansionLoc(FD->getLocation())))
855               Diag(DiagD->getLocation(),
856                    diag::warn_unneeded_static_internal_decl)
857                   << DiagD->getDeclName();
858             else
859               Diag(DiagD->getLocation(), diag::warn_unneeded_internal_decl)
860                    << /*function*/0 << DiagD->getDeclName();
861           }
862         } else {
863           Diag(DiagD->getLocation(),
864                isa<CXXMethodDecl>(DiagD) ? diag::warn_unused_member_function
865                                          : diag::warn_unused_function)
866                 << DiagD->getDeclName();
867         }
868       } else {
869         const VarDecl *DiagD = cast<VarDecl>(*I)->getDefinition();
870         if (!DiagD)
871           DiagD = cast<VarDecl>(*I);
872         if (DiagD->isReferenced()) {
873           Diag(DiagD->getLocation(), diag::warn_unneeded_internal_decl)
874                 << /*variable*/1 << DiagD->getDeclName();
875         } else if (DiagD->getType().isConstQualified()) {
876           Diag(DiagD->getLocation(), diag::warn_unused_const_variable)
877               << DiagD->getDeclName();
878         } else {
879           Diag(DiagD->getLocation(), diag::warn_unused_variable)
880               << DiagD->getDeclName();
881         }
882       }
883     }
884 
885     if (ExternalSource)
886       ExternalSource->ReadUndefinedButUsed(UndefinedButUsed);
887     checkUndefinedButUsed(*this);
888 
889     emitAndClearUnusedLocalTypedefWarnings();
890   }
891 
892   if (!Diags.isIgnored(diag::warn_unused_private_field, SourceLocation())) {
893     RecordCompleteMap RecordsComplete;
894     RecordCompleteMap MNCComplete;
895     for (NamedDeclSetType::iterator I = UnusedPrivateFields.begin(),
896          E = UnusedPrivateFields.end(); I != E; ++I) {
897       const NamedDecl *D = *I;
898       const CXXRecordDecl *RD = dyn_cast<CXXRecordDecl>(D->getDeclContext());
899       if (RD && !RD->isUnion() &&
900           IsRecordFullyDefined(RD, RecordsComplete, MNCComplete)) {
901         Diag(D->getLocation(), diag::warn_unused_private_field)
902               << D->getDeclName();
903       }
904     }
905   }
906 
907   if (!Diags.isIgnored(diag::warn_mismatched_delete_new, SourceLocation())) {
908     if (ExternalSource)
909       ExternalSource->ReadMismatchingDeleteExpressions(DeleteExprs);
910     for (const auto &DeletedFieldInfo : DeleteExprs) {
911       for (const auto &DeleteExprLoc : DeletedFieldInfo.second) {
912         AnalyzeDeleteExprMismatch(DeletedFieldInfo.first, DeleteExprLoc.first,
913                                   DeleteExprLoc.second);
914       }
915     }
916   }
917 
918   // Check we've noticed that we're no longer parsing the initializer for every
919   // variable. If we miss cases, then at best we have a performance issue and
920   // at worst a rejects-valid bug.
921   assert(ParsingInitForAutoVars.empty() &&
922          "Didn't unmark var as having its initializer parsed");
923 
924   TUScope = nullptr;
925 }
926 
927 
928 //===----------------------------------------------------------------------===//
929 // Helper functions.
930 //===----------------------------------------------------------------------===//
931 
932 DeclContext *Sema::getFunctionLevelDeclContext() {
933   DeclContext *DC = CurContext;
934 
935   while (true) {
936     if (isa<BlockDecl>(DC) || isa<EnumDecl>(DC) || isa<CapturedDecl>(DC)) {
937       DC = DC->getParent();
938     } else if (isa<CXXMethodDecl>(DC) &&
939                cast<CXXMethodDecl>(DC)->getOverloadedOperator() == OO_Call &&
940                cast<CXXRecordDecl>(DC->getParent())->isLambda()) {
941       DC = DC->getParent()->getParent();
942     }
943     else break;
944   }
945 
946   return DC;
947 }
948 
949 /// getCurFunctionDecl - If inside of a function body, this returns a pointer
950 /// to the function decl for the function being parsed.  If we're currently
951 /// in a 'block', this returns the containing context.
952 FunctionDecl *Sema::getCurFunctionDecl() {
953   DeclContext *DC = getFunctionLevelDeclContext();
954   return dyn_cast<FunctionDecl>(DC);
955 }
956 
957 ObjCMethodDecl *Sema::getCurMethodDecl() {
958   DeclContext *DC = getFunctionLevelDeclContext();
959   while (isa<RecordDecl>(DC))
960     DC = DC->getParent();
961   return dyn_cast<ObjCMethodDecl>(DC);
962 }
963 
964 NamedDecl *Sema::getCurFunctionOrMethodDecl() {
965   DeclContext *DC = getFunctionLevelDeclContext();
966   if (isa<ObjCMethodDecl>(DC) || isa<FunctionDecl>(DC))
967     return cast<NamedDecl>(DC);
968   return nullptr;
969 }
970 
971 void Sema::EmitCurrentDiagnostic(unsigned DiagID) {
972   // FIXME: It doesn't make sense to me that DiagID is an incoming argument here
973   // and yet we also use the current diag ID on the DiagnosticsEngine. This has
974   // been made more painfully obvious by the refactor that introduced this
975   // function, but it is possible that the incoming argument can be
976   // eliminnated. If it truly cannot be (for example, there is some reentrancy
977   // issue I am not seeing yet), then there should at least be a clarifying
978   // comment somewhere.
979   if (Optional<TemplateDeductionInfo*> Info = isSFINAEContext()) {
980     switch (DiagnosticIDs::getDiagnosticSFINAEResponse(
981               Diags.getCurrentDiagID())) {
982     case DiagnosticIDs::SFINAE_Report:
983       // We'll report the diagnostic below.
984       break;
985 
986     case DiagnosticIDs::SFINAE_SubstitutionFailure:
987       // Count this failure so that we know that template argument deduction
988       // has failed.
989       ++NumSFINAEErrors;
990 
991       // Make a copy of this suppressed diagnostic and store it with the
992       // template-deduction information.
993       if (*Info && !(*Info)->hasSFINAEDiagnostic()) {
994         Diagnostic DiagInfo(&Diags);
995         (*Info)->addSFINAEDiagnostic(DiagInfo.getLocation(),
996                        PartialDiagnostic(DiagInfo, Context.getDiagAllocator()));
997       }
998 
999       Diags.setLastDiagnosticIgnored();
1000       Diags.Clear();
1001       return;
1002 
1003     case DiagnosticIDs::SFINAE_AccessControl: {
1004       // Per C++ Core Issue 1170, access control is part of SFINAE.
1005       // Additionally, the AccessCheckingSFINAE flag can be used to temporarily
1006       // make access control a part of SFINAE for the purposes of checking
1007       // type traits.
1008       if (!AccessCheckingSFINAE && !getLangOpts().CPlusPlus11)
1009         break;
1010 
1011       SourceLocation Loc = Diags.getCurrentDiagLoc();
1012 
1013       // Suppress this diagnostic.
1014       ++NumSFINAEErrors;
1015 
1016       // Make a copy of this suppressed diagnostic and store it with the
1017       // template-deduction information.
1018       if (*Info && !(*Info)->hasSFINAEDiagnostic()) {
1019         Diagnostic DiagInfo(&Diags);
1020         (*Info)->addSFINAEDiagnostic(DiagInfo.getLocation(),
1021                        PartialDiagnostic(DiagInfo, Context.getDiagAllocator()));
1022       }
1023 
1024       Diags.setLastDiagnosticIgnored();
1025       Diags.Clear();
1026 
1027       // Now the diagnostic state is clear, produce a C++98 compatibility
1028       // warning.
1029       Diag(Loc, diag::warn_cxx98_compat_sfinae_access_control);
1030 
1031       // The last diagnostic which Sema produced was ignored. Suppress any
1032       // notes attached to it.
1033       Diags.setLastDiagnosticIgnored();
1034       return;
1035     }
1036 
1037     case DiagnosticIDs::SFINAE_Suppress:
1038       // Make a copy of this suppressed diagnostic and store it with the
1039       // template-deduction information;
1040       if (*Info) {
1041         Diagnostic DiagInfo(&Diags);
1042         (*Info)->addSuppressedDiagnostic(DiagInfo.getLocation(),
1043                        PartialDiagnostic(DiagInfo, Context.getDiagAllocator()));
1044       }
1045 
1046       // Suppress this diagnostic.
1047       Diags.setLastDiagnosticIgnored();
1048       Diags.Clear();
1049       return;
1050     }
1051   }
1052 
1053   // Set up the context's printing policy based on our current state.
1054   Context.setPrintingPolicy(getPrintingPolicy());
1055 
1056   // Emit the diagnostic.
1057   if (!Diags.EmitCurrentDiagnostic())
1058     return;
1059 
1060   // If this is not a note, and we're in a template instantiation
1061   // that is different from the last template instantiation where
1062   // we emitted an error, print a template instantiation
1063   // backtrace.
1064   if (!DiagnosticIDs::isBuiltinNote(DiagID) &&
1065       !ActiveTemplateInstantiations.empty() &&
1066       ActiveTemplateInstantiations.back()
1067         != LastTemplateInstantiationErrorContext) {
1068     PrintInstantiationStack();
1069     LastTemplateInstantiationErrorContext = ActiveTemplateInstantiations.back();
1070   }
1071 }
1072 
1073 Sema::SemaDiagnosticBuilder
1074 Sema::Diag(SourceLocation Loc, const PartialDiagnostic& PD) {
1075   SemaDiagnosticBuilder Builder(Diag(Loc, PD.getDiagID()));
1076   PD.Emit(Builder);
1077 
1078   return Builder;
1079 }
1080 
1081 /// \brief Looks through the macro-expansion chain for the given
1082 /// location, looking for a macro expansion with the given name.
1083 /// If one is found, returns true and sets the location to that
1084 /// expansion loc.
1085 bool Sema::findMacroSpelling(SourceLocation &locref, StringRef name) {
1086   SourceLocation loc = locref;
1087   if (!loc.isMacroID()) return false;
1088 
1089   // There's no good way right now to look at the intermediate
1090   // expansions, so just jump to the expansion location.
1091   loc = getSourceManager().getExpansionLoc(loc);
1092 
1093   // If that's written with the name, stop here.
1094   SmallVector<char, 16> buffer;
1095   if (getPreprocessor().getSpelling(loc, buffer) == name) {
1096     locref = loc;
1097     return true;
1098   }
1099   return false;
1100 }
1101 
1102 /// \brief Determines the active Scope associated with the given declaration
1103 /// context.
1104 ///
1105 /// This routine maps a declaration context to the active Scope object that
1106 /// represents that declaration context in the parser. It is typically used
1107 /// from "scope-less" code (e.g., template instantiation, lazy creation of
1108 /// declarations) that injects a name for name-lookup purposes and, therefore,
1109 /// must update the Scope.
1110 ///
1111 /// \returns The scope corresponding to the given declaraion context, or NULL
1112 /// if no such scope is open.
1113 Scope *Sema::getScopeForContext(DeclContext *Ctx) {
1114 
1115   if (!Ctx)
1116     return nullptr;
1117 
1118   Ctx = Ctx->getPrimaryContext();
1119   for (Scope *S = getCurScope(); S; S = S->getParent()) {
1120     // Ignore scopes that cannot have declarations. This is important for
1121     // out-of-line definitions of static class members.
1122     if (S->getFlags() & (Scope::DeclScope | Scope::TemplateParamScope))
1123       if (DeclContext *Entity = S->getEntity())
1124         if (Ctx == Entity->getPrimaryContext())
1125           return S;
1126   }
1127 
1128   return nullptr;
1129 }
1130 
1131 /// \brief Enter a new function scope
1132 void Sema::PushFunctionScope() {
1133   if (FunctionScopes.size() == 1) {
1134     // Use the "top" function scope rather than having to allocate
1135     // memory for a new scope.
1136     FunctionScopes.back()->Clear();
1137     FunctionScopes.push_back(FunctionScopes.back());
1138     return;
1139   }
1140 
1141   FunctionScopes.push_back(new FunctionScopeInfo(getDiagnostics()));
1142 }
1143 
1144 void Sema::PushBlockScope(Scope *BlockScope, BlockDecl *Block) {
1145   FunctionScopes.push_back(new BlockScopeInfo(getDiagnostics(),
1146                                               BlockScope, Block));
1147 }
1148 
1149 LambdaScopeInfo *Sema::PushLambdaScope() {
1150   LambdaScopeInfo *const LSI = new LambdaScopeInfo(getDiagnostics());
1151   FunctionScopes.push_back(LSI);
1152   return LSI;
1153 }
1154 
1155 void Sema::RecordParsingTemplateParameterDepth(unsigned Depth) {
1156   if (LambdaScopeInfo *const LSI = getCurLambda()) {
1157     LSI->AutoTemplateParameterDepth = Depth;
1158     return;
1159   }
1160   llvm_unreachable(
1161       "Remove assertion if intentionally called in a non-lambda context.");
1162 }
1163 
1164 void Sema::PopFunctionScopeInfo(const AnalysisBasedWarnings::Policy *WP,
1165                                 const Decl *D, const BlockExpr *blkExpr) {
1166   FunctionScopeInfo *Scope = FunctionScopes.pop_back_val();
1167   assert(!FunctionScopes.empty() && "mismatched push/pop!");
1168 
1169   // Issue any analysis-based warnings.
1170   if (WP && D)
1171     AnalysisWarnings.IssueWarnings(*WP, Scope, D, blkExpr);
1172   else
1173     for (const auto &PUD : Scope->PossiblyUnreachableDiags)
1174       Diag(PUD.Loc, PUD.PD);
1175 
1176   if (FunctionScopes.back() != Scope)
1177     delete Scope;
1178 }
1179 
1180 void Sema::PushCompoundScope() {
1181   getCurFunction()->CompoundScopes.push_back(CompoundScopeInfo());
1182 }
1183 
1184 void Sema::PopCompoundScope() {
1185   FunctionScopeInfo *CurFunction = getCurFunction();
1186   assert(!CurFunction->CompoundScopes.empty() && "mismatched push/pop");
1187 
1188   CurFunction->CompoundScopes.pop_back();
1189 }
1190 
1191 /// \brief Determine whether any errors occurred within this function/method/
1192 /// block.
1193 bool Sema::hasAnyUnrecoverableErrorsInThisFunction() const {
1194   return getCurFunction()->ErrorTrap.hasUnrecoverableErrorOccurred();
1195 }
1196 
1197 BlockScopeInfo *Sema::getCurBlock() {
1198   if (FunctionScopes.empty())
1199     return nullptr;
1200 
1201   auto CurBSI = dyn_cast<BlockScopeInfo>(FunctionScopes.back());
1202   if (CurBSI && CurBSI->TheDecl &&
1203       !CurBSI->TheDecl->Encloses(CurContext)) {
1204     // We have switched contexts due to template instantiation.
1205     assert(!ActiveTemplateInstantiations.empty());
1206     return nullptr;
1207   }
1208 
1209   return CurBSI;
1210 }
1211 
1212 LambdaScopeInfo *Sema::getCurLambda() {
1213   if (FunctionScopes.empty())
1214     return nullptr;
1215 
1216   auto CurLSI = dyn_cast<LambdaScopeInfo>(FunctionScopes.back());
1217   if (CurLSI && CurLSI->Lambda &&
1218       !CurLSI->Lambda->Encloses(CurContext)) {
1219     // We have switched contexts due to template instantiation.
1220     assert(!ActiveTemplateInstantiations.empty());
1221     return nullptr;
1222   }
1223 
1224   return CurLSI;
1225 }
1226 // We have a generic lambda if we parsed auto parameters, or we have
1227 // an associated template parameter list.
1228 LambdaScopeInfo *Sema::getCurGenericLambda() {
1229   if (LambdaScopeInfo *LSI =  getCurLambda()) {
1230     return (LSI->AutoTemplateParams.size() ||
1231                     LSI->GLTemplateParameterList) ? LSI : nullptr;
1232   }
1233   return nullptr;
1234 }
1235 
1236 
1237 void Sema::ActOnComment(SourceRange Comment) {
1238   if (!LangOpts.RetainCommentsFromSystemHeaders &&
1239       SourceMgr.isInSystemHeader(Comment.getBegin()))
1240     return;
1241   RawComment RC(SourceMgr, Comment, false,
1242                 LangOpts.CommentOpts.ParseAllComments);
1243   if (RC.isAlmostTrailingComment()) {
1244     SourceRange MagicMarkerRange(Comment.getBegin(),
1245                                  Comment.getBegin().getLocWithOffset(3));
1246     StringRef MagicMarkerText;
1247     switch (RC.getKind()) {
1248     case RawComment::RCK_OrdinaryBCPL:
1249       MagicMarkerText = "///<";
1250       break;
1251     case RawComment::RCK_OrdinaryC:
1252       MagicMarkerText = "/**<";
1253       break;
1254     default:
1255       llvm_unreachable("if this is an almost Doxygen comment, "
1256                        "it should be ordinary");
1257     }
1258     Diag(Comment.getBegin(), diag::warn_not_a_doxygen_trailing_member_comment) <<
1259       FixItHint::CreateReplacement(MagicMarkerRange, MagicMarkerText);
1260   }
1261   Context.addComment(RC);
1262 }
1263 
1264 // Pin this vtable to this file.
1265 ExternalSemaSource::~ExternalSemaSource() {}
1266 
1267 void ExternalSemaSource::ReadMethodPool(Selector Sel) { }
1268 
1269 void ExternalSemaSource::ReadKnownNamespaces(
1270                            SmallVectorImpl<NamespaceDecl *> &Namespaces) {
1271 }
1272 
1273 void ExternalSemaSource::ReadUndefinedButUsed(
1274                        llvm::DenseMap<NamedDecl *, SourceLocation> &Undefined) {
1275 }
1276 
1277 void ExternalSemaSource::ReadMismatchingDeleteExpressions(llvm::MapVector<
1278     FieldDecl *, llvm::SmallVector<std::pair<SourceLocation, bool>, 4>> &) {}
1279 
1280 void PrettyDeclStackTraceEntry::print(raw_ostream &OS) const {
1281   SourceLocation Loc = this->Loc;
1282   if (!Loc.isValid() && TheDecl) Loc = TheDecl->getLocation();
1283   if (Loc.isValid()) {
1284     Loc.print(OS, S.getSourceManager());
1285     OS << ": ";
1286   }
1287   OS << Message;
1288 
1289   if (TheDecl && isa<NamedDecl>(TheDecl)) {
1290     std::string Name = cast<NamedDecl>(TheDecl)->getNameAsString();
1291     if (!Name.empty())
1292       OS << " '" << Name << '\'';
1293   }
1294 
1295   OS << '\n';
1296 }
1297 
1298 /// \brief Figure out if an expression could be turned into a call.
1299 ///
1300 /// Use this when trying to recover from an error where the programmer may have
1301 /// written just the name of a function instead of actually calling it.
1302 ///
1303 /// \param E - The expression to examine.
1304 /// \param ZeroArgCallReturnTy - If the expression can be turned into a call
1305 ///  with no arguments, this parameter is set to the type returned by such a
1306 ///  call; otherwise, it is set to an empty QualType.
1307 /// \param OverloadSet - If the expression is an overloaded function
1308 ///  name, this parameter is populated with the decls of the various overloads.
1309 bool Sema::tryExprAsCall(Expr &E, QualType &ZeroArgCallReturnTy,
1310                          UnresolvedSetImpl &OverloadSet) {
1311   ZeroArgCallReturnTy = QualType();
1312   OverloadSet.clear();
1313 
1314   const OverloadExpr *Overloads = nullptr;
1315   bool IsMemExpr = false;
1316   if (E.getType() == Context.OverloadTy) {
1317     OverloadExpr::FindResult FR = OverloadExpr::find(const_cast<Expr*>(&E));
1318 
1319     // Ignore overloads that are pointer-to-member constants.
1320     if (FR.HasFormOfMemberPointer)
1321       return false;
1322 
1323     Overloads = FR.Expression;
1324   } else if (E.getType() == Context.BoundMemberTy) {
1325     Overloads = dyn_cast<UnresolvedMemberExpr>(E.IgnoreParens());
1326     IsMemExpr = true;
1327   }
1328 
1329   bool Ambiguous = false;
1330 
1331   if (Overloads) {
1332     for (OverloadExpr::decls_iterator it = Overloads->decls_begin(),
1333          DeclsEnd = Overloads->decls_end(); it != DeclsEnd; ++it) {
1334       OverloadSet.addDecl(*it);
1335 
1336       // Check whether the function is a non-template, non-member which takes no
1337       // arguments.
1338       if (IsMemExpr)
1339         continue;
1340       if (const FunctionDecl *OverloadDecl
1341             = dyn_cast<FunctionDecl>((*it)->getUnderlyingDecl())) {
1342         if (OverloadDecl->getMinRequiredArguments() == 0) {
1343           if (!ZeroArgCallReturnTy.isNull() && !Ambiguous) {
1344             ZeroArgCallReturnTy = QualType();
1345             Ambiguous = true;
1346           } else
1347             ZeroArgCallReturnTy = OverloadDecl->getReturnType();
1348         }
1349       }
1350     }
1351 
1352     // If it's not a member, use better machinery to try to resolve the call
1353     if (!IsMemExpr)
1354       return !ZeroArgCallReturnTy.isNull();
1355   }
1356 
1357   // Attempt to call the member with no arguments - this will correctly handle
1358   // member templates with defaults/deduction of template arguments, overloads
1359   // with default arguments, etc.
1360   if (IsMemExpr && !E.isTypeDependent()) {
1361     bool Suppress = getDiagnostics().getSuppressAllDiagnostics();
1362     getDiagnostics().setSuppressAllDiagnostics(true);
1363     ExprResult R = BuildCallToMemberFunction(nullptr, &E, SourceLocation(),
1364                                              None, SourceLocation());
1365     getDiagnostics().setSuppressAllDiagnostics(Suppress);
1366     if (R.isUsable()) {
1367       ZeroArgCallReturnTy = R.get()->getType();
1368       return true;
1369     }
1370     return false;
1371   }
1372 
1373   if (const DeclRefExpr *DeclRef = dyn_cast<DeclRefExpr>(E.IgnoreParens())) {
1374     if (const FunctionDecl *Fun = dyn_cast<FunctionDecl>(DeclRef->getDecl())) {
1375       if (Fun->getMinRequiredArguments() == 0)
1376         ZeroArgCallReturnTy = Fun->getReturnType();
1377       return true;
1378     }
1379   }
1380 
1381   // We don't have an expression that's convenient to get a FunctionDecl from,
1382   // but we can at least check if the type is "function of 0 arguments".
1383   QualType ExprTy = E.getType();
1384   const FunctionType *FunTy = nullptr;
1385   QualType PointeeTy = ExprTy->getPointeeType();
1386   if (!PointeeTy.isNull())
1387     FunTy = PointeeTy->getAs<FunctionType>();
1388   if (!FunTy)
1389     FunTy = ExprTy->getAs<FunctionType>();
1390 
1391   if (const FunctionProtoType *FPT =
1392       dyn_cast_or_null<FunctionProtoType>(FunTy)) {
1393     if (FPT->getNumParams() == 0)
1394       ZeroArgCallReturnTy = FunTy->getReturnType();
1395     return true;
1396   }
1397   return false;
1398 }
1399 
1400 /// \brief Give notes for a set of overloads.
1401 ///
1402 /// A companion to tryExprAsCall. In cases when the name that the programmer
1403 /// wrote was an overloaded function, we may be able to make some guesses about
1404 /// plausible overloads based on their return types; such guesses can be handed
1405 /// off to this method to be emitted as notes.
1406 ///
1407 /// \param Overloads - The overloads to note.
1408 /// \param FinalNoteLoc - If we've suppressed printing some overloads due to
1409 ///  -fshow-overloads=best, this is the location to attach to the note about too
1410 ///  many candidates. Typically this will be the location of the original
1411 ///  ill-formed expression.
1412 static void noteOverloads(Sema &S, const UnresolvedSetImpl &Overloads,
1413                           const SourceLocation FinalNoteLoc) {
1414   int ShownOverloads = 0;
1415   int SuppressedOverloads = 0;
1416   for (UnresolvedSetImpl::iterator It = Overloads.begin(),
1417        DeclsEnd = Overloads.end(); It != DeclsEnd; ++It) {
1418     // FIXME: Magic number for max shown overloads stolen from
1419     // OverloadCandidateSet::NoteCandidates.
1420     if (ShownOverloads >= 4 && S.Diags.getShowOverloads() == Ovl_Best) {
1421       ++SuppressedOverloads;
1422       continue;
1423     }
1424 
1425     NamedDecl *Fn = (*It)->getUnderlyingDecl();
1426     S.Diag(Fn->getLocation(), diag::note_possible_target_of_call);
1427     ++ShownOverloads;
1428   }
1429 
1430   if (SuppressedOverloads)
1431     S.Diag(FinalNoteLoc, diag::note_ovl_too_many_candidates)
1432       << SuppressedOverloads;
1433 }
1434 
1435 static void notePlausibleOverloads(Sema &S, SourceLocation Loc,
1436                                    const UnresolvedSetImpl &Overloads,
1437                                    bool (*IsPlausibleResult)(QualType)) {
1438   if (!IsPlausibleResult)
1439     return noteOverloads(S, Overloads, Loc);
1440 
1441   UnresolvedSet<2> PlausibleOverloads;
1442   for (OverloadExpr::decls_iterator It = Overloads.begin(),
1443          DeclsEnd = Overloads.end(); It != DeclsEnd; ++It) {
1444     const FunctionDecl *OverloadDecl = cast<FunctionDecl>(*It);
1445     QualType OverloadResultTy = OverloadDecl->getReturnType();
1446     if (IsPlausibleResult(OverloadResultTy))
1447       PlausibleOverloads.addDecl(It.getDecl());
1448   }
1449   noteOverloads(S, PlausibleOverloads, Loc);
1450 }
1451 
1452 /// Determine whether the given expression can be called by just
1453 /// putting parentheses after it.  Notably, expressions with unary
1454 /// operators can't be because the unary operator will start parsing
1455 /// outside the call.
1456 static bool IsCallableWithAppend(Expr *E) {
1457   E = E->IgnoreImplicit();
1458   return (!isa<CStyleCastExpr>(E) &&
1459           !isa<UnaryOperator>(E) &&
1460           !isa<BinaryOperator>(E) &&
1461           !isa<CXXOperatorCallExpr>(E));
1462 }
1463 
1464 bool Sema::tryToRecoverWithCall(ExprResult &E, const PartialDiagnostic &PD,
1465                                 bool ForceComplain,
1466                                 bool (*IsPlausibleResult)(QualType)) {
1467   SourceLocation Loc = E.get()->getExprLoc();
1468   SourceRange Range = E.get()->getSourceRange();
1469 
1470   QualType ZeroArgCallTy;
1471   UnresolvedSet<4> Overloads;
1472   if (tryExprAsCall(*E.get(), ZeroArgCallTy, Overloads) &&
1473       !ZeroArgCallTy.isNull() &&
1474       (!IsPlausibleResult || IsPlausibleResult(ZeroArgCallTy))) {
1475     // At this point, we know E is potentially callable with 0
1476     // arguments and that it returns something of a reasonable type,
1477     // so we can emit a fixit and carry on pretending that E was
1478     // actually a CallExpr.
1479     SourceLocation ParenInsertionLoc = getLocForEndOfToken(Range.getEnd());
1480     Diag(Loc, PD)
1481       << /*zero-arg*/ 1 << Range
1482       << (IsCallableWithAppend(E.get())
1483           ? FixItHint::CreateInsertion(ParenInsertionLoc, "()")
1484           : FixItHint());
1485     notePlausibleOverloads(*this, Loc, Overloads, IsPlausibleResult);
1486 
1487     // FIXME: Try this before emitting the fixit, and suppress diagnostics
1488     // while doing so.
1489     E = ActOnCallExpr(nullptr, E.get(), Range.getEnd(), None,
1490                       Range.getEnd().getLocWithOffset(1));
1491     return true;
1492   }
1493 
1494   if (!ForceComplain) return false;
1495 
1496   Diag(Loc, PD) << /*not zero-arg*/ 0 << Range;
1497   notePlausibleOverloads(*this, Loc, Overloads, IsPlausibleResult);
1498   E = ExprError();
1499   return true;
1500 }
1501 
1502 IdentifierInfo *Sema::getSuperIdentifier() const {
1503   if (!Ident_super)
1504     Ident_super = &Context.Idents.get("super");
1505   return Ident_super;
1506 }
1507 
1508 IdentifierInfo *Sema::getFloat128Identifier() const {
1509   if (!Ident___float128)
1510     Ident___float128 = &Context.Idents.get("__float128");
1511   return Ident___float128;
1512 }
1513 
1514 void Sema::PushCapturedRegionScope(Scope *S, CapturedDecl *CD, RecordDecl *RD,
1515                                    CapturedRegionKind K) {
1516   CapturingScopeInfo *CSI = new CapturedRegionScopeInfo(
1517       getDiagnostics(), S, CD, RD, CD->getContextParam(), K);
1518   CSI->ReturnType = Context.VoidTy;
1519   FunctionScopes.push_back(CSI);
1520 }
1521 
1522 CapturedRegionScopeInfo *Sema::getCurCapturedRegion() {
1523   if (FunctionScopes.empty())
1524     return nullptr;
1525 
1526   return dyn_cast<CapturedRegionScopeInfo>(FunctionScopes.back());
1527 }
1528 
1529 const llvm::MapVector<FieldDecl *, Sema::DeleteLocs> &
1530 Sema::getMismatchingDeleteExpressions() const {
1531   return DeleteExprs;
1532 }
1533