1 //===--- SemaOverload.cpp - C++ Overloading -------------------------------===//
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 provides Sema routines for C++ overloading.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "clang/Sema/Overload.h"
15 #include "clang/AST/ASTContext.h"
16 #include "clang/AST/CXXInheritance.h"
17 #include "clang/AST/DeclObjC.h"
18 #include "clang/AST/Expr.h"
19 #include "clang/AST/ExprCXX.h"
20 #include "clang/AST/ExprObjC.h"
21 #include "clang/AST/TypeOrdering.h"
22 #include "clang/Basic/Diagnostic.h"
23 #include "clang/Basic/DiagnosticOptions.h"
24 #include "clang/Basic/PartialDiagnostic.h"
25 #include "clang/Basic/TargetInfo.h"
26 #include "clang/Sema/Initialization.h"
27 #include "clang/Sema/Lookup.h"
28 #include "clang/Sema/SemaInternal.h"
29 #include "clang/Sema/Template.h"
30 #include "clang/Sema/TemplateDeduction.h"
31 #include "llvm/ADT/DenseSet.h"
32 #include "llvm/ADT/Optional.h"
33 #include "llvm/ADT/STLExtras.h"
34 #include "llvm/ADT/SmallPtrSet.h"
35 #include "llvm/ADT/SmallString.h"
36 #include <algorithm>
37 #include <cstdlib>
38 
39 using namespace clang;
40 using namespace sema;
41 
42 static bool functionHasPassObjectSizeParams(const FunctionDecl *FD) {
43   return llvm::any_of(FD->parameters(), [](const ParmVarDecl *P) {
44     return P->hasAttr<PassObjectSizeAttr>();
45   });
46 }
47 
48 /// A convenience routine for creating a decayed reference to a function.
49 static ExprResult
50 CreateFunctionRefExpr(Sema &S, FunctionDecl *Fn, NamedDecl *FoundDecl,
51                       const Expr *Base, bool HadMultipleCandidates,
52                       SourceLocation Loc = SourceLocation(),
53                       const DeclarationNameLoc &LocInfo = DeclarationNameLoc()){
54   if (S.DiagnoseUseOfDecl(FoundDecl, Loc))
55     return ExprError();
56   // If FoundDecl is different from Fn (such as if one is a template
57   // and the other a specialization), make sure DiagnoseUseOfDecl is
58   // called on both.
59   // FIXME: This would be more comprehensively addressed by modifying
60   // DiagnoseUseOfDecl to accept both the FoundDecl and the decl
61   // being used.
62   if (FoundDecl != Fn && S.DiagnoseUseOfDecl(Fn, Loc))
63     return ExprError();
64   if (auto *FPT = Fn->getType()->getAs<FunctionProtoType>())
65     S.ResolveExceptionSpec(Loc, FPT);
66   DeclRefExpr *DRE = new (S.Context) DeclRefExpr(Fn, false, Fn->getType(),
67                                                  VK_LValue, Loc, LocInfo);
68   if (HadMultipleCandidates)
69     DRE->setHadMultipleCandidates(true);
70 
71   S.MarkDeclRefReferenced(DRE, Base);
72   return S.ImpCastExprToType(DRE, S.Context.getPointerType(DRE->getType()),
73                              CK_FunctionToPointerDecay);
74 }
75 
76 static bool IsStandardConversion(Sema &S, Expr* From, QualType ToType,
77                                  bool InOverloadResolution,
78                                  StandardConversionSequence &SCS,
79                                  bool CStyle,
80                                  bool AllowObjCWritebackConversion);
81 
82 static bool IsTransparentUnionStandardConversion(Sema &S, Expr* From,
83                                                  QualType &ToType,
84                                                  bool InOverloadResolution,
85                                                  StandardConversionSequence &SCS,
86                                                  bool CStyle);
87 static OverloadingResult
88 IsUserDefinedConversion(Sema &S, Expr *From, QualType ToType,
89                         UserDefinedConversionSequence& User,
90                         OverloadCandidateSet& Conversions,
91                         bool AllowExplicit,
92                         bool AllowObjCConversionOnExplicit);
93 
94 
95 static ImplicitConversionSequence::CompareKind
96 CompareStandardConversionSequences(Sema &S, SourceLocation Loc,
97                                    const StandardConversionSequence& SCS1,
98                                    const StandardConversionSequence& SCS2);
99 
100 static ImplicitConversionSequence::CompareKind
101 CompareQualificationConversions(Sema &S,
102                                 const StandardConversionSequence& SCS1,
103                                 const StandardConversionSequence& SCS2);
104 
105 static ImplicitConversionSequence::CompareKind
106 CompareDerivedToBaseConversions(Sema &S, SourceLocation Loc,
107                                 const StandardConversionSequence& SCS1,
108                                 const StandardConversionSequence& SCS2);
109 
110 /// GetConversionRank - Retrieve the implicit conversion rank
111 /// corresponding to the given implicit conversion kind.
112 ImplicitConversionRank clang::GetConversionRank(ImplicitConversionKind Kind) {
113   static const ImplicitConversionRank
114     Rank[(int)ICK_Num_Conversion_Kinds] = {
115     ICR_Exact_Match,
116     ICR_Exact_Match,
117     ICR_Exact_Match,
118     ICR_Exact_Match,
119     ICR_Exact_Match,
120     ICR_Exact_Match,
121     ICR_Promotion,
122     ICR_Promotion,
123     ICR_Promotion,
124     ICR_Conversion,
125     ICR_Conversion,
126     ICR_Conversion,
127     ICR_Conversion,
128     ICR_Conversion,
129     ICR_Conversion,
130     ICR_Conversion,
131     ICR_Conversion,
132     ICR_Conversion,
133     ICR_Conversion,
134     ICR_OCL_Scalar_Widening,
135     ICR_Complex_Real_Conversion,
136     ICR_Conversion,
137     ICR_Conversion,
138     ICR_Writeback_Conversion,
139     ICR_Exact_Match, // NOTE(gbiv): This may not be completely right --
140                      // it was omitted by the patch that added
141                      // ICK_Zero_Event_Conversion
142     ICR_C_Conversion,
143     ICR_C_Conversion_Extension
144   };
145   return Rank[(int)Kind];
146 }
147 
148 /// GetImplicitConversionName - Return the name of this kind of
149 /// implicit conversion.
150 static const char* GetImplicitConversionName(ImplicitConversionKind Kind) {
151   static const char* const Name[(int)ICK_Num_Conversion_Kinds] = {
152     "No conversion",
153     "Lvalue-to-rvalue",
154     "Array-to-pointer",
155     "Function-to-pointer",
156     "Function pointer conversion",
157     "Qualification",
158     "Integral promotion",
159     "Floating point promotion",
160     "Complex promotion",
161     "Integral conversion",
162     "Floating conversion",
163     "Complex conversion",
164     "Floating-integral conversion",
165     "Pointer conversion",
166     "Pointer-to-member conversion",
167     "Boolean conversion",
168     "Compatible-types conversion",
169     "Derived-to-base conversion",
170     "Vector conversion",
171     "Vector splat",
172     "Complex-real conversion",
173     "Block Pointer conversion",
174     "Transparent Union Conversion",
175     "Writeback conversion",
176     "OpenCL Zero Event Conversion",
177     "C specific type conversion",
178     "Incompatible pointer conversion"
179   };
180   return Name[Kind];
181 }
182 
183 /// StandardConversionSequence - Set the standard conversion
184 /// sequence to the identity conversion.
185 void StandardConversionSequence::setAsIdentityConversion() {
186   First = ICK_Identity;
187   Second = ICK_Identity;
188   Third = ICK_Identity;
189   DeprecatedStringLiteralToCharPtr = false;
190   QualificationIncludesObjCLifetime = false;
191   ReferenceBinding = false;
192   DirectBinding = false;
193   IsLvalueReference = true;
194   BindsToFunctionLvalue = false;
195   BindsToRvalue = false;
196   BindsImplicitObjectArgumentWithoutRefQualifier = false;
197   ObjCLifetimeConversionBinding = false;
198   CopyConstructor = nullptr;
199 }
200 
201 /// getRank - Retrieve the rank of this standard conversion sequence
202 /// (C++ 13.3.3.1.1p3). The rank is the largest rank of each of the
203 /// implicit conversions.
204 ImplicitConversionRank StandardConversionSequence::getRank() const {
205   ImplicitConversionRank Rank = ICR_Exact_Match;
206   if  (GetConversionRank(First) > Rank)
207     Rank = GetConversionRank(First);
208   if  (GetConversionRank(Second) > Rank)
209     Rank = GetConversionRank(Second);
210   if  (GetConversionRank(Third) > Rank)
211     Rank = GetConversionRank(Third);
212   return Rank;
213 }
214 
215 /// isPointerConversionToBool - Determines whether this conversion is
216 /// a conversion of a pointer or pointer-to-member to bool. This is
217 /// used as part of the ranking of standard conversion sequences
218 /// (C++ 13.3.3.2p4).
219 bool StandardConversionSequence::isPointerConversionToBool() const {
220   // Note that FromType has not necessarily been transformed by the
221   // array-to-pointer or function-to-pointer implicit conversions, so
222   // check for their presence as well as checking whether FromType is
223   // a pointer.
224   if (getToType(1)->isBooleanType() &&
225       (getFromType()->isPointerType() ||
226        getFromType()->isObjCObjectPointerType() ||
227        getFromType()->isBlockPointerType() ||
228        getFromType()->isNullPtrType() ||
229        First == ICK_Array_To_Pointer || First == ICK_Function_To_Pointer))
230     return true;
231 
232   return false;
233 }
234 
235 /// isPointerConversionToVoidPointer - Determines whether this
236 /// conversion is a conversion of a pointer to a void pointer. This is
237 /// used as part of the ranking of standard conversion sequences (C++
238 /// 13.3.3.2p4).
239 bool
240 StandardConversionSequence::
241 isPointerConversionToVoidPointer(ASTContext& Context) const {
242   QualType FromType = getFromType();
243   QualType ToType = getToType(1);
244 
245   // Note that FromType has not necessarily been transformed by the
246   // array-to-pointer implicit conversion, so check for its presence
247   // and redo the conversion to get a pointer.
248   if (First == ICK_Array_To_Pointer)
249     FromType = Context.getArrayDecayedType(FromType);
250 
251   if (Second == ICK_Pointer_Conversion && FromType->isAnyPointerType())
252     if (const PointerType* ToPtrType = ToType->getAs<PointerType>())
253       return ToPtrType->getPointeeType()->isVoidType();
254 
255   return false;
256 }
257 
258 /// Skip any implicit casts which could be either part of a narrowing conversion
259 /// or after one in an implicit conversion.
260 static const Expr *IgnoreNarrowingConversion(const Expr *Converted) {
261   while (const ImplicitCastExpr *ICE = dyn_cast<ImplicitCastExpr>(Converted)) {
262     switch (ICE->getCastKind()) {
263     case CK_NoOp:
264     case CK_IntegralCast:
265     case CK_IntegralToBoolean:
266     case CK_IntegralToFloating:
267     case CK_BooleanToSignedIntegral:
268     case CK_FloatingToIntegral:
269     case CK_FloatingToBoolean:
270     case CK_FloatingCast:
271       Converted = ICE->getSubExpr();
272       continue;
273 
274     default:
275       return Converted;
276     }
277   }
278 
279   return Converted;
280 }
281 
282 /// Check if this standard conversion sequence represents a narrowing
283 /// conversion, according to C++11 [dcl.init.list]p7.
284 ///
285 /// \param Ctx  The AST context.
286 /// \param Converted  The result of applying this standard conversion sequence.
287 /// \param ConstantValue  If this is an NK_Constant_Narrowing conversion, the
288 ///        value of the expression prior to the narrowing conversion.
289 /// \param ConstantType  If this is an NK_Constant_Narrowing conversion, the
290 ///        type of the expression prior to the narrowing conversion.
291 NarrowingKind
292 StandardConversionSequence::getNarrowingKind(ASTContext &Ctx,
293                                              const Expr *Converted,
294                                              APValue &ConstantValue,
295                                              QualType &ConstantType) const {
296   assert(Ctx.getLangOpts().CPlusPlus && "narrowing check outside C++");
297 
298   // C++11 [dcl.init.list]p7:
299   //   A narrowing conversion is an implicit conversion ...
300   QualType FromType = getToType(0);
301   QualType ToType = getToType(1);
302 
303   // A conversion to an enumeration type is narrowing if the conversion to
304   // the underlying type is narrowing. This only arises for expressions of
305   // the form 'Enum{init}'.
306   if (auto *ET = ToType->getAs<EnumType>())
307     ToType = ET->getDecl()->getIntegerType();
308 
309   switch (Second) {
310   // 'bool' is an integral type; dispatch to the right place to handle it.
311   case ICK_Boolean_Conversion:
312     if (FromType->isRealFloatingType())
313       goto FloatingIntegralConversion;
314     if (FromType->isIntegralOrUnscopedEnumerationType())
315       goto IntegralConversion;
316     // Boolean conversions can be from pointers and pointers to members
317     // [conv.bool], and those aren't considered narrowing conversions.
318     return NK_Not_Narrowing;
319 
320   // -- from a floating-point type to an integer type, or
321   //
322   // -- from an integer type or unscoped enumeration type to a floating-point
323   //    type, except where the source is a constant expression and the actual
324   //    value after conversion will fit into the target type and will produce
325   //    the original value when converted back to the original type, or
326   case ICK_Floating_Integral:
327   FloatingIntegralConversion:
328     if (FromType->isRealFloatingType() && ToType->isIntegralType(Ctx)) {
329       return NK_Type_Narrowing;
330     } else if (FromType->isIntegralType(Ctx) && ToType->isRealFloatingType()) {
331       llvm::APSInt IntConstantValue;
332       const Expr *Initializer = IgnoreNarrowingConversion(Converted);
333       assert(Initializer && "Unknown conversion expression");
334 
335       // If it's value-dependent, we can't tell whether it's narrowing.
336       if (Initializer->isValueDependent())
337         return NK_Dependent_Narrowing;
338 
339       if (Initializer->isIntegerConstantExpr(IntConstantValue, Ctx)) {
340         // Convert the integer to the floating type.
341         llvm::APFloat Result(Ctx.getFloatTypeSemantics(ToType));
342         Result.convertFromAPInt(IntConstantValue, IntConstantValue.isSigned(),
343                                 llvm::APFloat::rmNearestTiesToEven);
344         // And back.
345         llvm::APSInt ConvertedValue = IntConstantValue;
346         bool ignored;
347         Result.convertToInteger(ConvertedValue,
348                                 llvm::APFloat::rmTowardZero, &ignored);
349         // If the resulting value is different, this was a narrowing conversion.
350         if (IntConstantValue != ConvertedValue) {
351           ConstantValue = APValue(IntConstantValue);
352           ConstantType = Initializer->getType();
353           return NK_Constant_Narrowing;
354         }
355       } else {
356         // Variables are always narrowings.
357         return NK_Variable_Narrowing;
358       }
359     }
360     return NK_Not_Narrowing;
361 
362   // -- from long double to double or float, or from double to float, except
363   //    where the source is a constant expression and the actual value after
364   //    conversion is within the range of values that can be represented (even
365   //    if it cannot be represented exactly), or
366   case ICK_Floating_Conversion:
367     if (FromType->isRealFloatingType() && ToType->isRealFloatingType() &&
368         Ctx.getFloatingTypeOrder(FromType, ToType) == 1) {
369       // FromType is larger than ToType.
370       const Expr *Initializer = IgnoreNarrowingConversion(Converted);
371 
372       // If it's value-dependent, we can't tell whether it's narrowing.
373       if (Initializer->isValueDependent())
374         return NK_Dependent_Narrowing;
375 
376       if (Initializer->isCXX11ConstantExpr(Ctx, &ConstantValue)) {
377         // Constant!
378         assert(ConstantValue.isFloat());
379         llvm::APFloat FloatVal = ConstantValue.getFloat();
380         // Convert the source value into the target type.
381         bool ignored;
382         llvm::APFloat::opStatus ConvertStatus = FloatVal.convert(
383           Ctx.getFloatTypeSemantics(ToType),
384           llvm::APFloat::rmNearestTiesToEven, &ignored);
385         // If there was no overflow, the source value is within the range of
386         // values that can be represented.
387         if (ConvertStatus & llvm::APFloat::opOverflow) {
388           ConstantType = Initializer->getType();
389           return NK_Constant_Narrowing;
390         }
391       } else {
392         return NK_Variable_Narrowing;
393       }
394     }
395     return NK_Not_Narrowing;
396 
397   // -- from an integer type or unscoped enumeration type to an integer type
398   //    that cannot represent all the values of the original type, except where
399   //    the source is a constant expression and the actual value after
400   //    conversion will fit into the target type and will produce the original
401   //    value when converted back to the original type.
402   case ICK_Integral_Conversion:
403   IntegralConversion: {
404     assert(FromType->isIntegralOrUnscopedEnumerationType());
405     assert(ToType->isIntegralOrUnscopedEnumerationType());
406     const bool FromSigned = FromType->isSignedIntegerOrEnumerationType();
407     const unsigned FromWidth = Ctx.getIntWidth(FromType);
408     const bool ToSigned = ToType->isSignedIntegerOrEnumerationType();
409     const unsigned ToWidth = Ctx.getIntWidth(ToType);
410 
411     if (FromWidth > ToWidth ||
412         (FromWidth == ToWidth && FromSigned != ToSigned) ||
413         (FromSigned && !ToSigned)) {
414       // Not all values of FromType can be represented in ToType.
415       llvm::APSInt InitializerValue;
416       const Expr *Initializer = IgnoreNarrowingConversion(Converted);
417 
418       // If it's value-dependent, we can't tell whether it's narrowing.
419       if (Initializer->isValueDependent())
420         return NK_Dependent_Narrowing;
421 
422       if (!Initializer->isIntegerConstantExpr(InitializerValue, Ctx)) {
423         // Such conversions on variables are always narrowing.
424         return NK_Variable_Narrowing;
425       }
426       bool Narrowing = false;
427       if (FromWidth < ToWidth) {
428         // Negative -> unsigned is narrowing. Otherwise, more bits is never
429         // narrowing.
430         if (InitializerValue.isSigned() && InitializerValue.isNegative())
431           Narrowing = true;
432       } else {
433         // Add a bit to the InitializerValue so we don't have to worry about
434         // signed vs. unsigned comparisons.
435         InitializerValue = InitializerValue.extend(
436           InitializerValue.getBitWidth() + 1);
437         // Convert the initializer to and from the target width and signed-ness.
438         llvm::APSInt ConvertedValue = InitializerValue;
439         ConvertedValue = ConvertedValue.trunc(ToWidth);
440         ConvertedValue.setIsSigned(ToSigned);
441         ConvertedValue = ConvertedValue.extend(InitializerValue.getBitWidth());
442         ConvertedValue.setIsSigned(InitializerValue.isSigned());
443         // If the result is different, this was a narrowing conversion.
444         if (ConvertedValue != InitializerValue)
445           Narrowing = true;
446       }
447       if (Narrowing) {
448         ConstantType = Initializer->getType();
449         ConstantValue = APValue(InitializerValue);
450         return NK_Constant_Narrowing;
451       }
452     }
453     return NK_Not_Narrowing;
454   }
455 
456   default:
457     // Other kinds of conversions are not narrowings.
458     return NK_Not_Narrowing;
459   }
460 }
461 
462 /// dump - Print this standard conversion sequence to standard
463 /// error. Useful for debugging overloading issues.
464 LLVM_DUMP_METHOD void StandardConversionSequence::dump() const {
465   raw_ostream &OS = llvm::errs();
466   bool PrintedSomething = false;
467   if (First != ICK_Identity) {
468     OS << GetImplicitConversionName(First);
469     PrintedSomething = true;
470   }
471 
472   if (Second != ICK_Identity) {
473     if (PrintedSomething) {
474       OS << " -> ";
475     }
476     OS << GetImplicitConversionName(Second);
477 
478     if (CopyConstructor) {
479       OS << " (by copy constructor)";
480     } else if (DirectBinding) {
481       OS << " (direct reference binding)";
482     } else if (ReferenceBinding) {
483       OS << " (reference binding)";
484     }
485     PrintedSomething = true;
486   }
487 
488   if (Third != ICK_Identity) {
489     if (PrintedSomething) {
490       OS << " -> ";
491     }
492     OS << GetImplicitConversionName(Third);
493     PrintedSomething = true;
494   }
495 
496   if (!PrintedSomething) {
497     OS << "No conversions required";
498   }
499 }
500 
501 /// dump - Print this user-defined conversion sequence to standard
502 /// error. Useful for debugging overloading issues.
503 void UserDefinedConversionSequence::dump() const {
504   raw_ostream &OS = llvm::errs();
505   if (Before.First || Before.Second || Before.Third) {
506     Before.dump();
507     OS << " -> ";
508   }
509   if (ConversionFunction)
510     OS << '\'' << *ConversionFunction << '\'';
511   else
512     OS << "aggregate initialization";
513   if (After.First || After.Second || After.Third) {
514     OS << " -> ";
515     After.dump();
516   }
517 }
518 
519 /// dump - Print this implicit conversion sequence to standard
520 /// error. Useful for debugging overloading issues.
521 void ImplicitConversionSequence::dump() const {
522   raw_ostream &OS = llvm::errs();
523   if (isStdInitializerListElement())
524     OS << "Worst std::initializer_list element conversion: ";
525   switch (ConversionKind) {
526   case StandardConversion:
527     OS << "Standard conversion: ";
528     Standard.dump();
529     break;
530   case UserDefinedConversion:
531     OS << "User-defined conversion: ";
532     UserDefined.dump();
533     break;
534   case EllipsisConversion:
535     OS << "Ellipsis conversion";
536     break;
537   case AmbiguousConversion:
538     OS << "Ambiguous conversion";
539     break;
540   case BadConversion:
541     OS << "Bad conversion";
542     break;
543   }
544 
545   OS << "\n";
546 }
547 
548 void AmbiguousConversionSequence::construct() {
549   new (&conversions()) ConversionSet();
550 }
551 
552 void AmbiguousConversionSequence::destruct() {
553   conversions().~ConversionSet();
554 }
555 
556 void
557 AmbiguousConversionSequence::copyFrom(const AmbiguousConversionSequence &O) {
558   FromTypePtr = O.FromTypePtr;
559   ToTypePtr = O.ToTypePtr;
560   new (&conversions()) ConversionSet(O.conversions());
561 }
562 
563 namespace {
564   // Structure used by DeductionFailureInfo to store
565   // template argument information.
566   struct DFIArguments {
567     TemplateArgument FirstArg;
568     TemplateArgument SecondArg;
569   };
570   // Structure used by DeductionFailureInfo to store
571   // template parameter and template argument information.
572   struct DFIParamWithArguments : DFIArguments {
573     TemplateParameter Param;
574   };
575   // Structure used by DeductionFailureInfo to store template argument
576   // information and the index of the problematic call argument.
577   struct DFIDeducedMismatchArgs : DFIArguments {
578     TemplateArgumentList *TemplateArgs;
579     unsigned CallArgIndex;
580   };
581 }
582 
583 /// \brief Convert from Sema's representation of template deduction information
584 /// to the form used in overload-candidate information.
585 DeductionFailureInfo
586 clang::MakeDeductionFailureInfo(ASTContext &Context,
587                                 Sema::TemplateDeductionResult TDK,
588                                 TemplateDeductionInfo &Info) {
589   DeductionFailureInfo Result;
590   Result.Result = static_cast<unsigned>(TDK);
591   Result.HasDiagnostic = false;
592   switch (TDK) {
593   case Sema::TDK_Invalid:
594   case Sema::TDK_InstantiationDepth:
595   case Sema::TDK_TooManyArguments:
596   case Sema::TDK_TooFewArguments:
597   case Sema::TDK_MiscellaneousDeductionFailure:
598   case Sema::TDK_CUDATargetMismatch:
599     Result.Data = nullptr;
600     break;
601 
602   case Sema::TDK_Incomplete:
603   case Sema::TDK_InvalidExplicitArguments:
604     Result.Data = Info.Param.getOpaqueValue();
605     break;
606 
607   case Sema::TDK_DeducedMismatch:
608   case Sema::TDK_DeducedMismatchNested: {
609     // FIXME: Should allocate from normal heap so that we can free this later.
610     auto *Saved = new (Context) DFIDeducedMismatchArgs;
611     Saved->FirstArg = Info.FirstArg;
612     Saved->SecondArg = Info.SecondArg;
613     Saved->TemplateArgs = Info.take();
614     Saved->CallArgIndex = Info.CallArgIndex;
615     Result.Data = Saved;
616     break;
617   }
618 
619   case Sema::TDK_NonDeducedMismatch: {
620     // FIXME: Should allocate from normal heap so that we can free this later.
621     DFIArguments *Saved = new (Context) DFIArguments;
622     Saved->FirstArg = Info.FirstArg;
623     Saved->SecondArg = Info.SecondArg;
624     Result.Data = Saved;
625     break;
626   }
627 
628   case Sema::TDK_Inconsistent:
629   case Sema::TDK_Underqualified: {
630     // FIXME: Should allocate from normal heap so that we can free this later.
631     DFIParamWithArguments *Saved = new (Context) DFIParamWithArguments;
632     Saved->Param = Info.Param;
633     Saved->FirstArg = Info.FirstArg;
634     Saved->SecondArg = Info.SecondArg;
635     Result.Data = Saved;
636     break;
637   }
638 
639   case Sema::TDK_SubstitutionFailure:
640     Result.Data = Info.take();
641     if (Info.hasSFINAEDiagnostic()) {
642       PartialDiagnosticAt *Diag = new (Result.Diagnostic) PartialDiagnosticAt(
643           SourceLocation(), PartialDiagnostic::NullDiagnostic());
644       Info.takeSFINAEDiagnostic(*Diag);
645       Result.HasDiagnostic = true;
646     }
647     break;
648 
649   case Sema::TDK_Success:
650   case Sema::TDK_NonDependentConversionFailure:
651     llvm_unreachable("not a deduction failure");
652   }
653 
654   return Result;
655 }
656 
657 void DeductionFailureInfo::Destroy() {
658   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
659   case Sema::TDK_Success:
660   case Sema::TDK_Invalid:
661   case Sema::TDK_InstantiationDepth:
662   case Sema::TDK_Incomplete:
663   case Sema::TDK_TooManyArguments:
664   case Sema::TDK_TooFewArguments:
665   case Sema::TDK_InvalidExplicitArguments:
666   case Sema::TDK_CUDATargetMismatch:
667   case Sema::TDK_NonDependentConversionFailure:
668     break;
669 
670   case Sema::TDK_Inconsistent:
671   case Sema::TDK_Underqualified:
672   case Sema::TDK_DeducedMismatch:
673   case Sema::TDK_DeducedMismatchNested:
674   case Sema::TDK_NonDeducedMismatch:
675     // FIXME: Destroy the data?
676     Data = nullptr;
677     break;
678 
679   case Sema::TDK_SubstitutionFailure:
680     // FIXME: Destroy the template argument list?
681     Data = nullptr;
682     if (PartialDiagnosticAt *Diag = getSFINAEDiagnostic()) {
683       Diag->~PartialDiagnosticAt();
684       HasDiagnostic = false;
685     }
686     break;
687 
688   // Unhandled
689   case Sema::TDK_MiscellaneousDeductionFailure:
690     break;
691   }
692 }
693 
694 PartialDiagnosticAt *DeductionFailureInfo::getSFINAEDiagnostic() {
695   if (HasDiagnostic)
696     return static_cast<PartialDiagnosticAt*>(static_cast<void*>(Diagnostic));
697   return nullptr;
698 }
699 
700 TemplateParameter DeductionFailureInfo::getTemplateParameter() {
701   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
702   case Sema::TDK_Success:
703   case Sema::TDK_Invalid:
704   case Sema::TDK_InstantiationDepth:
705   case Sema::TDK_TooManyArguments:
706   case Sema::TDK_TooFewArguments:
707   case Sema::TDK_SubstitutionFailure:
708   case Sema::TDK_DeducedMismatch:
709   case Sema::TDK_DeducedMismatchNested:
710   case Sema::TDK_NonDeducedMismatch:
711   case Sema::TDK_CUDATargetMismatch:
712   case Sema::TDK_NonDependentConversionFailure:
713     return TemplateParameter();
714 
715   case Sema::TDK_Incomplete:
716   case Sema::TDK_InvalidExplicitArguments:
717     return TemplateParameter::getFromOpaqueValue(Data);
718 
719   case Sema::TDK_Inconsistent:
720   case Sema::TDK_Underqualified:
721     return static_cast<DFIParamWithArguments*>(Data)->Param;
722 
723   // Unhandled
724   case Sema::TDK_MiscellaneousDeductionFailure:
725     break;
726   }
727 
728   return TemplateParameter();
729 }
730 
731 TemplateArgumentList *DeductionFailureInfo::getTemplateArgumentList() {
732   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
733   case Sema::TDK_Success:
734   case Sema::TDK_Invalid:
735   case Sema::TDK_InstantiationDepth:
736   case Sema::TDK_TooManyArguments:
737   case Sema::TDK_TooFewArguments:
738   case Sema::TDK_Incomplete:
739   case Sema::TDK_InvalidExplicitArguments:
740   case Sema::TDK_Inconsistent:
741   case Sema::TDK_Underqualified:
742   case Sema::TDK_NonDeducedMismatch:
743   case Sema::TDK_CUDATargetMismatch:
744   case Sema::TDK_NonDependentConversionFailure:
745     return nullptr;
746 
747   case Sema::TDK_DeducedMismatch:
748   case Sema::TDK_DeducedMismatchNested:
749     return static_cast<DFIDeducedMismatchArgs*>(Data)->TemplateArgs;
750 
751   case Sema::TDK_SubstitutionFailure:
752     return static_cast<TemplateArgumentList*>(Data);
753 
754   // Unhandled
755   case Sema::TDK_MiscellaneousDeductionFailure:
756     break;
757   }
758 
759   return nullptr;
760 }
761 
762 const TemplateArgument *DeductionFailureInfo::getFirstArg() {
763   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
764   case Sema::TDK_Success:
765   case Sema::TDK_Invalid:
766   case Sema::TDK_InstantiationDepth:
767   case Sema::TDK_Incomplete:
768   case Sema::TDK_TooManyArguments:
769   case Sema::TDK_TooFewArguments:
770   case Sema::TDK_InvalidExplicitArguments:
771   case Sema::TDK_SubstitutionFailure:
772   case Sema::TDK_CUDATargetMismatch:
773   case Sema::TDK_NonDependentConversionFailure:
774     return nullptr;
775 
776   case Sema::TDK_Inconsistent:
777   case Sema::TDK_Underqualified:
778   case Sema::TDK_DeducedMismatch:
779   case Sema::TDK_DeducedMismatchNested:
780   case Sema::TDK_NonDeducedMismatch:
781     return &static_cast<DFIArguments*>(Data)->FirstArg;
782 
783   // Unhandled
784   case Sema::TDK_MiscellaneousDeductionFailure:
785     break;
786   }
787 
788   return nullptr;
789 }
790 
791 const TemplateArgument *DeductionFailureInfo::getSecondArg() {
792   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
793   case Sema::TDK_Success:
794   case Sema::TDK_Invalid:
795   case Sema::TDK_InstantiationDepth:
796   case Sema::TDK_Incomplete:
797   case Sema::TDK_TooManyArguments:
798   case Sema::TDK_TooFewArguments:
799   case Sema::TDK_InvalidExplicitArguments:
800   case Sema::TDK_SubstitutionFailure:
801   case Sema::TDK_CUDATargetMismatch:
802   case Sema::TDK_NonDependentConversionFailure:
803     return nullptr;
804 
805   case Sema::TDK_Inconsistent:
806   case Sema::TDK_Underqualified:
807   case Sema::TDK_DeducedMismatch:
808   case Sema::TDK_DeducedMismatchNested:
809   case Sema::TDK_NonDeducedMismatch:
810     return &static_cast<DFIArguments*>(Data)->SecondArg;
811 
812   // Unhandled
813   case Sema::TDK_MiscellaneousDeductionFailure:
814     break;
815   }
816 
817   return nullptr;
818 }
819 
820 llvm::Optional<unsigned> DeductionFailureInfo::getCallArgIndex() {
821   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
822   case Sema::TDK_DeducedMismatch:
823   case Sema::TDK_DeducedMismatchNested:
824     return static_cast<DFIDeducedMismatchArgs*>(Data)->CallArgIndex;
825 
826   default:
827     return llvm::None;
828   }
829 }
830 
831 void OverloadCandidateSet::destroyCandidates() {
832   for (iterator i = begin(), e = end(); i != e; ++i) {
833     for (auto &C : i->Conversions)
834       C.~ImplicitConversionSequence();
835     if (!i->Viable && i->FailureKind == ovl_fail_bad_deduction)
836       i->DeductionFailure.Destroy();
837   }
838 }
839 
840 void OverloadCandidateSet::clear(CandidateSetKind CSK) {
841   destroyCandidates();
842   SlabAllocator.Reset();
843   NumInlineBytesUsed = 0;
844   Candidates.clear();
845   Functions.clear();
846   Kind = CSK;
847 }
848 
849 namespace {
850   class UnbridgedCastsSet {
851     struct Entry {
852       Expr **Addr;
853       Expr *Saved;
854     };
855     SmallVector<Entry, 2> Entries;
856 
857   public:
858     void save(Sema &S, Expr *&E) {
859       assert(E->hasPlaceholderType(BuiltinType::ARCUnbridgedCast));
860       Entry entry = { &E, E };
861       Entries.push_back(entry);
862       E = S.stripARCUnbridgedCast(E);
863     }
864 
865     void restore() {
866       for (SmallVectorImpl<Entry>::iterator
867              i = Entries.begin(), e = Entries.end(); i != e; ++i)
868         *i->Addr = i->Saved;
869     }
870   };
871 }
872 
873 /// checkPlaceholderForOverload - Do any interesting placeholder-like
874 /// preprocessing on the given expression.
875 ///
876 /// \param unbridgedCasts a collection to which to add unbridged casts;
877 ///   without this, they will be immediately diagnosed as errors
878 ///
879 /// Return true on unrecoverable error.
880 static bool
881 checkPlaceholderForOverload(Sema &S, Expr *&E,
882                             UnbridgedCastsSet *unbridgedCasts = nullptr) {
883   if (const BuiltinType *placeholder =  E->getType()->getAsPlaceholderType()) {
884     // We can't handle overloaded expressions here because overload
885     // resolution might reasonably tweak them.
886     if (placeholder->getKind() == BuiltinType::Overload) return false;
887 
888     // If the context potentially accepts unbridged ARC casts, strip
889     // the unbridged cast and add it to the collection for later restoration.
890     if (placeholder->getKind() == BuiltinType::ARCUnbridgedCast &&
891         unbridgedCasts) {
892       unbridgedCasts->save(S, E);
893       return false;
894     }
895 
896     // Go ahead and check everything else.
897     ExprResult result = S.CheckPlaceholderExpr(E);
898     if (result.isInvalid())
899       return true;
900 
901     E = result.get();
902     return false;
903   }
904 
905   // Nothing to do.
906   return false;
907 }
908 
909 /// checkArgPlaceholdersForOverload - Check a set of call operands for
910 /// placeholders.
911 static bool checkArgPlaceholdersForOverload(Sema &S,
912                                             MultiExprArg Args,
913                                             UnbridgedCastsSet &unbridged) {
914   for (unsigned i = 0, e = Args.size(); i != e; ++i)
915     if (checkPlaceholderForOverload(S, Args[i], &unbridged))
916       return true;
917 
918   return false;
919 }
920 
921 /// Determine whether the given New declaration is an overload of the
922 /// declarations in Old. This routine returns Ovl_Match or Ovl_NonFunction if
923 /// New and Old cannot be overloaded, e.g., if New has the same signature as
924 /// some function in Old (C++ 1.3.10) or if the Old declarations aren't
925 /// functions (or function templates) at all. When it does return Ovl_Match or
926 /// Ovl_NonFunction, MatchedDecl will point to the decl that New cannot be
927 /// overloaded with. This decl may be a UsingShadowDecl on top of the underlying
928 /// declaration.
929 ///
930 /// Example: Given the following input:
931 ///
932 ///   void f(int, float); // #1
933 ///   void f(int, int); // #2
934 ///   int f(int, int); // #3
935 ///
936 /// When we process #1, there is no previous declaration of "f", so IsOverload
937 /// will not be used.
938 ///
939 /// When we process #2, Old contains only the FunctionDecl for #1. By comparing
940 /// the parameter types, we see that #1 and #2 are overloaded (since they have
941 /// different signatures), so this routine returns Ovl_Overload; MatchedDecl is
942 /// unchanged.
943 ///
944 /// When we process #3, Old is an overload set containing #1 and #2. We compare
945 /// the signatures of #3 to #1 (they're overloaded, so we do nothing) and then
946 /// #3 to #2. Since the signatures of #3 and #2 are identical (return types of
947 /// functions are not part of the signature), IsOverload returns Ovl_Match and
948 /// MatchedDecl will be set to point to the FunctionDecl for #2.
949 ///
950 /// 'NewIsUsingShadowDecl' indicates that 'New' is being introduced into a class
951 /// by a using declaration. The rules for whether to hide shadow declarations
952 /// ignore some properties which otherwise figure into a function template's
953 /// signature.
954 Sema::OverloadKind
955 Sema::CheckOverload(Scope *S, FunctionDecl *New, const LookupResult &Old,
956                     NamedDecl *&Match, bool NewIsUsingDecl) {
957   for (LookupResult::iterator I = Old.begin(), E = Old.end();
958          I != E; ++I) {
959     NamedDecl *OldD = *I;
960 
961     bool OldIsUsingDecl = false;
962     if (isa<UsingShadowDecl>(OldD)) {
963       OldIsUsingDecl = true;
964 
965       // We can always introduce two using declarations into the same
966       // context, even if they have identical signatures.
967       if (NewIsUsingDecl) continue;
968 
969       OldD = cast<UsingShadowDecl>(OldD)->getTargetDecl();
970     }
971 
972     // A using-declaration does not conflict with another declaration
973     // if one of them is hidden.
974     if ((OldIsUsingDecl || NewIsUsingDecl) && !isVisible(*I))
975       continue;
976 
977     // If either declaration was introduced by a using declaration,
978     // we'll need to use slightly different rules for matching.
979     // Essentially, these rules are the normal rules, except that
980     // function templates hide function templates with different
981     // return types or template parameter lists.
982     bool UseMemberUsingDeclRules =
983       (OldIsUsingDecl || NewIsUsingDecl) && CurContext->isRecord() &&
984       !New->getFriendObjectKind();
985 
986     if (FunctionDecl *OldF = OldD->getAsFunction()) {
987       if (!IsOverload(New, OldF, UseMemberUsingDeclRules)) {
988         if (UseMemberUsingDeclRules && OldIsUsingDecl) {
989           HideUsingShadowDecl(S, cast<UsingShadowDecl>(*I));
990           continue;
991         }
992 
993         if (!isa<FunctionTemplateDecl>(OldD) &&
994             !shouldLinkPossiblyHiddenDecl(*I, New))
995           continue;
996 
997         Match = *I;
998         return Ovl_Match;
999       }
1000     } else if (isa<UsingDecl>(OldD) || isa<UsingPackDecl>(OldD)) {
1001       // We can overload with these, which can show up when doing
1002       // redeclaration checks for UsingDecls.
1003       assert(Old.getLookupKind() == LookupUsingDeclName);
1004     } else if (isa<TagDecl>(OldD)) {
1005       // We can always overload with tags by hiding them.
1006     } else if (auto *UUD = dyn_cast<UnresolvedUsingValueDecl>(OldD)) {
1007       // Optimistically assume that an unresolved using decl will
1008       // overload; if it doesn't, we'll have to diagnose during
1009       // template instantiation.
1010       //
1011       // Exception: if the scope is dependent and this is not a class
1012       // member, the using declaration can only introduce an enumerator.
1013       if (UUD->getQualifier()->isDependent() && !UUD->isCXXClassMember()) {
1014         Match = *I;
1015         return Ovl_NonFunction;
1016       }
1017     } else {
1018       // (C++ 13p1):
1019       //   Only function declarations can be overloaded; object and type
1020       //   declarations cannot be overloaded.
1021       Match = *I;
1022       return Ovl_NonFunction;
1023     }
1024   }
1025 
1026   return Ovl_Overload;
1027 }
1028 
1029 bool Sema::IsOverload(FunctionDecl *New, FunctionDecl *Old,
1030                       bool UseMemberUsingDeclRules, bool ConsiderCudaAttrs) {
1031   // C++ [basic.start.main]p2: This function shall not be overloaded.
1032   if (New->isMain())
1033     return false;
1034 
1035   // MSVCRT user defined entry points cannot be overloaded.
1036   if (New->isMSVCRTEntryPoint())
1037     return false;
1038 
1039   FunctionTemplateDecl *OldTemplate = Old->getDescribedFunctionTemplate();
1040   FunctionTemplateDecl *NewTemplate = New->getDescribedFunctionTemplate();
1041 
1042   // C++ [temp.fct]p2:
1043   //   A function template can be overloaded with other function templates
1044   //   and with normal (non-template) functions.
1045   if ((OldTemplate == nullptr) != (NewTemplate == nullptr))
1046     return true;
1047 
1048   // Is the function New an overload of the function Old?
1049   QualType OldQType = Context.getCanonicalType(Old->getType());
1050   QualType NewQType = Context.getCanonicalType(New->getType());
1051 
1052   // Compare the signatures (C++ 1.3.10) of the two functions to
1053   // determine whether they are overloads. If we find any mismatch
1054   // in the signature, they are overloads.
1055 
1056   // If either of these functions is a K&R-style function (no
1057   // prototype), then we consider them to have matching signatures.
1058   if (isa<FunctionNoProtoType>(OldQType.getTypePtr()) ||
1059       isa<FunctionNoProtoType>(NewQType.getTypePtr()))
1060     return false;
1061 
1062   const FunctionProtoType *OldType = cast<FunctionProtoType>(OldQType);
1063   const FunctionProtoType *NewType = cast<FunctionProtoType>(NewQType);
1064 
1065   // The signature of a function includes the types of its
1066   // parameters (C++ 1.3.10), which includes the presence or absence
1067   // of the ellipsis; see C++ DR 357).
1068   if (OldQType != NewQType &&
1069       (OldType->getNumParams() != NewType->getNumParams() ||
1070        OldType->isVariadic() != NewType->isVariadic() ||
1071        !FunctionParamTypesAreEqual(OldType, NewType)))
1072     return true;
1073 
1074   // C++ [temp.over.link]p4:
1075   //   The signature of a function template consists of its function
1076   //   signature, its return type and its template parameter list. The names
1077   //   of the template parameters are significant only for establishing the
1078   //   relationship between the template parameters and the rest of the
1079   //   signature.
1080   //
1081   // We check the return type and template parameter lists for function
1082   // templates first; the remaining checks follow.
1083   //
1084   // However, we don't consider either of these when deciding whether
1085   // a member introduced by a shadow declaration is hidden.
1086   if (!UseMemberUsingDeclRules && NewTemplate &&
1087       (!TemplateParameterListsAreEqual(NewTemplate->getTemplateParameters(),
1088                                        OldTemplate->getTemplateParameters(),
1089                                        false, TPL_TemplateMatch) ||
1090        OldType->getReturnType() != NewType->getReturnType()))
1091     return true;
1092 
1093   // If the function is a class member, its signature includes the
1094   // cv-qualifiers (if any) and ref-qualifier (if any) on the function itself.
1095   //
1096   // As part of this, also check whether one of the member functions
1097   // is static, in which case they are not overloads (C++
1098   // 13.1p2). While not part of the definition of the signature,
1099   // this check is important to determine whether these functions
1100   // can be overloaded.
1101   CXXMethodDecl *OldMethod = dyn_cast<CXXMethodDecl>(Old);
1102   CXXMethodDecl *NewMethod = dyn_cast<CXXMethodDecl>(New);
1103   if (OldMethod && NewMethod &&
1104       !OldMethod->isStatic() && !NewMethod->isStatic()) {
1105     if (OldMethod->getRefQualifier() != NewMethod->getRefQualifier()) {
1106       if (!UseMemberUsingDeclRules &&
1107           (OldMethod->getRefQualifier() == RQ_None ||
1108            NewMethod->getRefQualifier() == RQ_None)) {
1109         // C++0x [over.load]p2:
1110         //   - Member function declarations with the same name and the same
1111         //     parameter-type-list as well as member function template
1112         //     declarations with the same name, the same parameter-type-list, and
1113         //     the same template parameter lists cannot be overloaded if any of
1114         //     them, but not all, have a ref-qualifier (8.3.5).
1115         Diag(NewMethod->getLocation(), diag::err_ref_qualifier_overload)
1116           << NewMethod->getRefQualifier() << OldMethod->getRefQualifier();
1117         Diag(OldMethod->getLocation(), diag::note_previous_declaration);
1118       }
1119       return true;
1120     }
1121 
1122     // We may not have applied the implicit const for a constexpr member
1123     // function yet (because we haven't yet resolved whether this is a static
1124     // or non-static member function). Add it now, on the assumption that this
1125     // is a redeclaration of OldMethod.
1126     unsigned OldQuals = OldMethod->getTypeQualifiers();
1127     unsigned NewQuals = NewMethod->getTypeQualifiers();
1128     if (!getLangOpts().CPlusPlus14 && NewMethod->isConstexpr() &&
1129         !isa<CXXConstructorDecl>(NewMethod))
1130       NewQuals |= Qualifiers::Const;
1131 
1132     // We do not allow overloading based off of '__restrict'.
1133     OldQuals &= ~Qualifiers::Restrict;
1134     NewQuals &= ~Qualifiers::Restrict;
1135     if (OldQuals != NewQuals)
1136       return true;
1137   }
1138 
1139   // Though pass_object_size is placed on parameters and takes an argument, we
1140   // consider it to be a function-level modifier for the sake of function
1141   // identity. Either the function has one or more parameters with
1142   // pass_object_size or it doesn't.
1143   if (functionHasPassObjectSizeParams(New) !=
1144       functionHasPassObjectSizeParams(Old))
1145     return true;
1146 
1147   // enable_if attributes are an order-sensitive part of the signature.
1148   for (specific_attr_iterator<EnableIfAttr>
1149          NewI = New->specific_attr_begin<EnableIfAttr>(),
1150          NewE = New->specific_attr_end<EnableIfAttr>(),
1151          OldI = Old->specific_attr_begin<EnableIfAttr>(),
1152          OldE = Old->specific_attr_end<EnableIfAttr>();
1153        NewI != NewE || OldI != OldE; ++NewI, ++OldI) {
1154     if (NewI == NewE || OldI == OldE)
1155       return true;
1156     llvm::FoldingSetNodeID NewID, OldID;
1157     NewI->getCond()->Profile(NewID, Context, true);
1158     OldI->getCond()->Profile(OldID, Context, true);
1159     if (NewID != OldID)
1160       return true;
1161   }
1162 
1163   if (getLangOpts().CUDA && ConsiderCudaAttrs) {
1164     // Don't allow overloading of destructors.  (In theory we could, but it
1165     // would be a giant change to clang.)
1166     if (isa<CXXDestructorDecl>(New))
1167       return false;
1168 
1169     CUDAFunctionTarget NewTarget = IdentifyCUDATarget(New),
1170                        OldTarget = IdentifyCUDATarget(Old);
1171     if (NewTarget == CFT_InvalidTarget)
1172       return false;
1173 
1174     assert((OldTarget != CFT_InvalidTarget) && "Unexpected invalid target.");
1175 
1176     // Allow overloading of functions with same signature and different CUDA
1177     // target attributes.
1178     return NewTarget != OldTarget;
1179   }
1180 
1181   // The signatures match; this is not an overload.
1182   return false;
1183 }
1184 
1185 /// \brief Checks availability of the function depending on the current
1186 /// function context. Inside an unavailable function, unavailability is ignored.
1187 ///
1188 /// \returns true if \arg FD is unavailable and current context is inside
1189 /// an available function, false otherwise.
1190 bool Sema::isFunctionConsideredUnavailable(FunctionDecl *FD) {
1191   if (!FD->isUnavailable())
1192     return false;
1193 
1194   // Walk up the context of the caller.
1195   Decl *C = cast<Decl>(CurContext);
1196   do {
1197     if (C->isUnavailable())
1198       return false;
1199   } while ((C = cast_or_null<Decl>(C->getDeclContext())));
1200   return true;
1201 }
1202 
1203 /// \brief Tries a user-defined conversion from From to ToType.
1204 ///
1205 /// Produces an implicit conversion sequence for when a standard conversion
1206 /// is not an option. See TryImplicitConversion for more information.
1207 static ImplicitConversionSequence
1208 TryUserDefinedConversion(Sema &S, Expr *From, QualType ToType,
1209                          bool SuppressUserConversions,
1210                          bool AllowExplicit,
1211                          bool InOverloadResolution,
1212                          bool CStyle,
1213                          bool AllowObjCWritebackConversion,
1214                          bool AllowObjCConversionOnExplicit) {
1215   ImplicitConversionSequence ICS;
1216 
1217   if (SuppressUserConversions) {
1218     // We're not in the case above, so there is no conversion that
1219     // we can perform.
1220     ICS.setBad(BadConversionSequence::no_conversion, From, ToType);
1221     return ICS;
1222   }
1223 
1224   // Attempt user-defined conversion.
1225   OverloadCandidateSet Conversions(From->getExprLoc(),
1226                                    OverloadCandidateSet::CSK_Normal);
1227   switch (IsUserDefinedConversion(S, From, ToType, ICS.UserDefined,
1228                                   Conversions, AllowExplicit,
1229                                   AllowObjCConversionOnExplicit)) {
1230   case OR_Success:
1231   case OR_Deleted:
1232     ICS.setUserDefined();
1233     // C++ [over.ics.user]p4:
1234     //   A conversion of an expression of class type to the same class
1235     //   type is given Exact Match rank, and a conversion of an
1236     //   expression of class type to a base class of that type is
1237     //   given Conversion rank, in spite of the fact that a copy
1238     //   constructor (i.e., a user-defined conversion function) is
1239     //   called for those cases.
1240     if (CXXConstructorDecl *Constructor
1241           = dyn_cast<CXXConstructorDecl>(ICS.UserDefined.ConversionFunction)) {
1242       QualType FromCanon
1243         = S.Context.getCanonicalType(From->getType().getUnqualifiedType());
1244       QualType ToCanon
1245         = S.Context.getCanonicalType(ToType).getUnqualifiedType();
1246       if (Constructor->isCopyConstructor() &&
1247           (FromCanon == ToCanon ||
1248            S.IsDerivedFrom(From->getLocStart(), FromCanon, ToCanon))) {
1249         // Turn this into a "standard" conversion sequence, so that it
1250         // gets ranked with standard conversion sequences.
1251         DeclAccessPair Found = ICS.UserDefined.FoundConversionFunction;
1252         ICS.setStandard();
1253         ICS.Standard.setAsIdentityConversion();
1254         ICS.Standard.setFromType(From->getType());
1255         ICS.Standard.setAllToTypes(ToType);
1256         ICS.Standard.CopyConstructor = Constructor;
1257         ICS.Standard.FoundCopyConstructor = Found;
1258         if (ToCanon != FromCanon)
1259           ICS.Standard.Second = ICK_Derived_To_Base;
1260       }
1261     }
1262     break;
1263 
1264   case OR_Ambiguous:
1265     ICS.setAmbiguous();
1266     ICS.Ambiguous.setFromType(From->getType());
1267     ICS.Ambiguous.setToType(ToType);
1268     for (OverloadCandidateSet::iterator Cand = Conversions.begin();
1269          Cand != Conversions.end(); ++Cand)
1270       if (Cand->Viable)
1271         ICS.Ambiguous.addConversion(Cand->FoundDecl, Cand->Function);
1272     break;
1273 
1274     // Fall through.
1275   case OR_No_Viable_Function:
1276     ICS.setBad(BadConversionSequence::no_conversion, From, ToType);
1277     break;
1278   }
1279 
1280   return ICS;
1281 }
1282 
1283 /// TryImplicitConversion - Attempt to perform an implicit conversion
1284 /// from the given expression (Expr) to the given type (ToType). This
1285 /// function returns an implicit conversion sequence that can be used
1286 /// to perform the initialization. Given
1287 ///
1288 ///   void f(float f);
1289 ///   void g(int i) { f(i); }
1290 ///
1291 /// this routine would produce an implicit conversion sequence to
1292 /// describe the initialization of f from i, which will be a standard
1293 /// conversion sequence containing an lvalue-to-rvalue conversion (C++
1294 /// 4.1) followed by a floating-integral conversion (C++ 4.9).
1295 //
1296 /// Note that this routine only determines how the conversion can be
1297 /// performed; it does not actually perform the conversion. As such,
1298 /// it will not produce any diagnostics if no conversion is available,
1299 /// but will instead return an implicit conversion sequence of kind
1300 /// "BadConversion".
1301 ///
1302 /// If @p SuppressUserConversions, then user-defined conversions are
1303 /// not permitted.
1304 /// If @p AllowExplicit, then explicit user-defined conversions are
1305 /// permitted.
1306 ///
1307 /// \param AllowObjCWritebackConversion Whether we allow the Objective-C
1308 /// writeback conversion, which allows __autoreleasing id* parameters to
1309 /// be initialized with __strong id* or __weak id* arguments.
1310 static ImplicitConversionSequence
1311 TryImplicitConversion(Sema &S, Expr *From, QualType ToType,
1312                       bool SuppressUserConversions,
1313                       bool AllowExplicit,
1314                       bool InOverloadResolution,
1315                       bool CStyle,
1316                       bool AllowObjCWritebackConversion,
1317                       bool AllowObjCConversionOnExplicit) {
1318   ImplicitConversionSequence ICS;
1319   if (IsStandardConversion(S, From, ToType, InOverloadResolution,
1320                            ICS.Standard, CStyle, AllowObjCWritebackConversion)){
1321     ICS.setStandard();
1322     return ICS;
1323   }
1324 
1325   if (!S.getLangOpts().CPlusPlus) {
1326     ICS.setBad(BadConversionSequence::no_conversion, From, ToType);
1327     return ICS;
1328   }
1329 
1330   // C++ [over.ics.user]p4:
1331   //   A conversion of an expression of class type to the same class
1332   //   type is given Exact Match rank, and a conversion of an
1333   //   expression of class type to a base class of that type is
1334   //   given Conversion rank, in spite of the fact that a copy/move
1335   //   constructor (i.e., a user-defined conversion function) is
1336   //   called for those cases.
1337   QualType FromType = From->getType();
1338   if (ToType->getAs<RecordType>() && FromType->getAs<RecordType>() &&
1339       (S.Context.hasSameUnqualifiedType(FromType, ToType) ||
1340        S.IsDerivedFrom(From->getLocStart(), FromType, ToType))) {
1341     ICS.setStandard();
1342     ICS.Standard.setAsIdentityConversion();
1343     ICS.Standard.setFromType(FromType);
1344     ICS.Standard.setAllToTypes(ToType);
1345 
1346     // We don't actually check at this point whether there is a valid
1347     // copy/move constructor, since overloading just assumes that it
1348     // exists. When we actually perform initialization, we'll find the
1349     // appropriate constructor to copy the returned object, if needed.
1350     ICS.Standard.CopyConstructor = nullptr;
1351 
1352     // Determine whether this is considered a derived-to-base conversion.
1353     if (!S.Context.hasSameUnqualifiedType(FromType, ToType))
1354       ICS.Standard.Second = ICK_Derived_To_Base;
1355 
1356     return ICS;
1357   }
1358 
1359   return TryUserDefinedConversion(S, From, ToType, SuppressUserConversions,
1360                                   AllowExplicit, InOverloadResolution, CStyle,
1361                                   AllowObjCWritebackConversion,
1362                                   AllowObjCConversionOnExplicit);
1363 }
1364 
1365 ImplicitConversionSequence
1366 Sema::TryImplicitConversion(Expr *From, QualType ToType,
1367                             bool SuppressUserConversions,
1368                             bool AllowExplicit,
1369                             bool InOverloadResolution,
1370                             bool CStyle,
1371                             bool AllowObjCWritebackConversion) {
1372   return ::TryImplicitConversion(*this, From, ToType,
1373                                  SuppressUserConversions, AllowExplicit,
1374                                  InOverloadResolution, CStyle,
1375                                  AllowObjCWritebackConversion,
1376                                  /*AllowObjCConversionOnExplicit=*/false);
1377 }
1378 
1379 /// PerformImplicitConversion - Perform an implicit conversion of the
1380 /// expression From to the type ToType. Returns the
1381 /// converted expression. Flavor is the kind of conversion we're
1382 /// performing, used in the error message. If @p AllowExplicit,
1383 /// explicit user-defined conversions are permitted.
1384 ExprResult
1385 Sema::PerformImplicitConversion(Expr *From, QualType ToType,
1386                                 AssignmentAction Action, bool AllowExplicit) {
1387   ImplicitConversionSequence ICS;
1388   return PerformImplicitConversion(From, ToType, Action, AllowExplicit, ICS);
1389 }
1390 
1391 ExprResult
1392 Sema::PerformImplicitConversion(Expr *From, QualType ToType,
1393                                 AssignmentAction Action, bool AllowExplicit,
1394                                 ImplicitConversionSequence& ICS) {
1395   if (checkPlaceholderForOverload(*this, From))
1396     return ExprError();
1397 
1398   // Objective-C ARC: Determine whether we will allow the writeback conversion.
1399   bool AllowObjCWritebackConversion
1400     = getLangOpts().ObjCAutoRefCount &&
1401       (Action == AA_Passing || Action == AA_Sending);
1402   if (getLangOpts().ObjC1)
1403     CheckObjCBridgeRelatedConversions(From->getLocStart(),
1404                                       ToType, From->getType(), From);
1405   ICS = ::TryImplicitConversion(*this, From, ToType,
1406                                 /*SuppressUserConversions=*/false,
1407                                 AllowExplicit,
1408                                 /*InOverloadResolution=*/false,
1409                                 /*CStyle=*/false,
1410                                 AllowObjCWritebackConversion,
1411                                 /*AllowObjCConversionOnExplicit=*/false);
1412   return PerformImplicitConversion(From, ToType, ICS, Action);
1413 }
1414 
1415 /// \brief Determine whether the conversion from FromType to ToType is a valid
1416 /// conversion that strips "noexcept" or "noreturn" off the nested function
1417 /// type.
1418 bool Sema::IsFunctionConversion(QualType FromType, QualType ToType,
1419                                 QualType &ResultTy) {
1420   if (Context.hasSameUnqualifiedType(FromType, ToType))
1421     return false;
1422 
1423   // Permit the conversion F(t __attribute__((noreturn))) -> F(t)
1424   //                    or F(t noexcept) -> F(t)
1425   // where F adds one of the following at most once:
1426   //   - a pointer
1427   //   - a member pointer
1428   //   - a block pointer
1429   // Changes here need matching changes in FindCompositePointerType.
1430   CanQualType CanTo = Context.getCanonicalType(ToType);
1431   CanQualType CanFrom = Context.getCanonicalType(FromType);
1432   Type::TypeClass TyClass = CanTo->getTypeClass();
1433   if (TyClass != CanFrom->getTypeClass()) return false;
1434   if (TyClass != Type::FunctionProto && TyClass != Type::FunctionNoProto) {
1435     if (TyClass == Type::Pointer) {
1436       CanTo = CanTo.getAs<PointerType>()->getPointeeType();
1437       CanFrom = CanFrom.getAs<PointerType>()->getPointeeType();
1438     } else if (TyClass == Type::BlockPointer) {
1439       CanTo = CanTo.getAs<BlockPointerType>()->getPointeeType();
1440       CanFrom = CanFrom.getAs<BlockPointerType>()->getPointeeType();
1441     } else if (TyClass == Type::MemberPointer) {
1442       auto ToMPT = CanTo.getAs<MemberPointerType>();
1443       auto FromMPT = CanFrom.getAs<MemberPointerType>();
1444       // A function pointer conversion cannot change the class of the function.
1445       if (ToMPT->getClass() != FromMPT->getClass())
1446         return false;
1447       CanTo = ToMPT->getPointeeType();
1448       CanFrom = FromMPT->getPointeeType();
1449     } else {
1450       return false;
1451     }
1452 
1453     TyClass = CanTo->getTypeClass();
1454     if (TyClass != CanFrom->getTypeClass()) return false;
1455     if (TyClass != Type::FunctionProto && TyClass != Type::FunctionNoProto)
1456       return false;
1457   }
1458 
1459   const auto *FromFn = cast<FunctionType>(CanFrom);
1460   FunctionType::ExtInfo FromEInfo = FromFn->getExtInfo();
1461 
1462   const auto *ToFn = cast<FunctionType>(CanTo);
1463   FunctionType::ExtInfo ToEInfo = ToFn->getExtInfo();
1464 
1465   bool Changed = false;
1466 
1467   // Drop 'noreturn' if not present in target type.
1468   if (FromEInfo.getNoReturn() && !ToEInfo.getNoReturn()) {
1469     FromFn = Context.adjustFunctionType(FromFn, FromEInfo.withNoReturn(false));
1470     Changed = true;
1471   }
1472 
1473   // Drop 'noexcept' if not present in target type.
1474   if (const auto *FromFPT = dyn_cast<FunctionProtoType>(FromFn)) {
1475     const auto *ToFPT = cast<FunctionProtoType>(ToFn);
1476     if (FromFPT->isNothrow(Context) && !ToFPT->isNothrow(Context)) {
1477       FromFn = cast<FunctionType>(
1478           Context.getFunctionType(FromFPT->getReturnType(),
1479                                   FromFPT->getParamTypes(),
1480                                   FromFPT->getExtProtoInfo().withExceptionSpec(
1481                                       FunctionProtoType::ExceptionSpecInfo()))
1482                  .getTypePtr());
1483       Changed = true;
1484     }
1485 
1486     // Convert FromFPT's ExtParameterInfo if necessary. The conversion is valid
1487     // only if the ExtParameterInfo lists of the two function prototypes can be
1488     // merged and the merged list is identical to ToFPT's ExtParameterInfo list.
1489     SmallVector<FunctionProtoType::ExtParameterInfo, 4> NewParamInfos;
1490     bool CanUseToFPT, CanUseFromFPT;
1491     if (Context.mergeExtParameterInfo(ToFPT, FromFPT, CanUseToFPT,
1492                                       CanUseFromFPT, NewParamInfos) &&
1493         CanUseToFPT && !CanUseFromFPT) {
1494       FunctionProtoType::ExtProtoInfo ExtInfo = FromFPT->getExtProtoInfo();
1495       ExtInfo.ExtParameterInfos =
1496           NewParamInfos.empty() ? nullptr : NewParamInfos.data();
1497       QualType QT = Context.getFunctionType(FromFPT->getReturnType(),
1498                                             FromFPT->getParamTypes(), ExtInfo);
1499       FromFn = QT->getAs<FunctionType>();
1500       Changed = true;
1501     }
1502   }
1503 
1504   if (!Changed)
1505     return false;
1506 
1507   assert(QualType(FromFn, 0).isCanonical());
1508   if (QualType(FromFn, 0) != CanTo) return false;
1509 
1510   ResultTy = ToType;
1511   return true;
1512 }
1513 
1514 /// \brief Determine whether the conversion from FromType to ToType is a valid
1515 /// vector conversion.
1516 ///
1517 /// \param ICK Will be set to the vector conversion kind, if this is a vector
1518 /// conversion.
1519 static bool IsVectorConversion(Sema &S, QualType FromType,
1520                                QualType ToType, ImplicitConversionKind &ICK) {
1521   // We need at least one of these types to be a vector type to have a vector
1522   // conversion.
1523   if (!ToType->isVectorType() && !FromType->isVectorType())
1524     return false;
1525 
1526   // Identical types require no conversions.
1527   if (S.Context.hasSameUnqualifiedType(FromType, ToType))
1528     return false;
1529 
1530   // There are no conversions between extended vector types, only identity.
1531   if (ToType->isExtVectorType()) {
1532     // There are no conversions between extended vector types other than the
1533     // identity conversion.
1534     if (FromType->isExtVectorType())
1535       return false;
1536 
1537     // Vector splat from any arithmetic type to a vector.
1538     if (FromType->isArithmeticType()) {
1539       ICK = ICK_Vector_Splat;
1540       return true;
1541     }
1542   }
1543 
1544   // We can perform the conversion between vector types in the following cases:
1545   // 1)vector types are equivalent AltiVec and GCC vector types
1546   // 2)lax vector conversions are permitted and the vector types are of the
1547   //   same size
1548   if (ToType->isVectorType() && FromType->isVectorType()) {
1549     if (S.Context.areCompatibleVectorTypes(FromType, ToType) ||
1550         S.isLaxVectorConversion(FromType, ToType)) {
1551       ICK = ICK_Vector_Conversion;
1552       return true;
1553     }
1554   }
1555 
1556   return false;
1557 }
1558 
1559 static bool tryAtomicConversion(Sema &S, Expr *From, QualType ToType,
1560                                 bool InOverloadResolution,
1561                                 StandardConversionSequence &SCS,
1562                                 bool CStyle);
1563 
1564 /// IsStandardConversion - Determines whether there is a standard
1565 /// conversion sequence (C++ [conv], C++ [over.ics.scs]) from the
1566 /// expression From to the type ToType. Standard conversion sequences
1567 /// only consider non-class types; for conversions that involve class
1568 /// types, use TryImplicitConversion. If a conversion exists, SCS will
1569 /// contain the standard conversion sequence required to perform this
1570 /// conversion and this routine will return true. Otherwise, this
1571 /// routine will return false and the value of SCS is unspecified.
1572 static bool IsStandardConversion(Sema &S, Expr* From, QualType ToType,
1573                                  bool InOverloadResolution,
1574                                  StandardConversionSequence &SCS,
1575                                  bool CStyle,
1576                                  bool AllowObjCWritebackConversion) {
1577   QualType FromType = From->getType();
1578 
1579   // Standard conversions (C++ [conv])
1580   SCS.setAsIdentityConversion();
1581   SCS.IncompatibleObjC = false;
1582   SCS.setFromType(FromType);
1583   SCS.CopyConstructor = nullptr;
1584 
1585   // There are no standard conversions for class types in C++, so
1586   // abort early. When overloading in C, however, we do permit them.
1587   if (S.getLangOpts().CPlusPlus &&
1588       (FromType->isRecordType() || ToType->isRecordType()))
1589     return false;
1590 
1591   // The first conversion can be an lvalue-to-rvalue conversion,
1592   // array-to-pointer conversion, or function-to-pointer conversion
1593   // (C++ 4p1).
1594 
1595   if (FromType == S.Context.OverloadTy) {
1596     DeclAccessPair AccessPair;
1597     if (FunctionDecl *Fn
1598           = S.ResolveAddressOfOverloadedFunction(From, ToType, false,
1599                                                  AccessPair)) {
1600       // We were able to resolve the address of the overloaded function,
1601       // so we can convert to the type of that function.
1602       FromType = Fn->getType();
1603       SCS.setFromType(FromType);
1604 
1605       // we can sometimes resolve &foo<int> regardless of ToType, so check
1606       // if the type matches (identity) or we are converting to bool
1607       if (!S.Context.hasSameUnqualifiedType(
1608                       S.ExtractUnqualifiedFunctionType(ToType), FromType)) {
1609         QualType resultTy;
1610         // if the function type matches except for [[noreturn]], it's ok
1611         if (!S.IsFunctionConversion(FromType,
1612               S.ExtractUnqualifiedFunctionType(ToType), resultTy))
1613           // otherwise, only a boolean conversion is standard
1614           if (!ToType->isBooleanType())
1615             return false;
1616       }
1617 
1618       // Check if the "from" expression is taking the address of an overloaded
1619       // function and recompute the FromType accordingly. Take advantage of the
1620       // fact that non-static member functions *must* have such an address-of
1621       // expression.
1622       CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn);
1623       if (Method && !Method->isStatic()) {
1624         assert(isa<UnaryOperator>(From->IgnoreParens()) &&
1625                "Non-unary operator on non-static member address");
1626         assert(cast<UnaryOperator>(From->IgnoreParens())->getOpcode()
1627                == UO_AddrOf &&
1628                "Non-address-of operator on non-static member address");
1629         const Type *ClassType
1630           = S.Context.getTypeDeclType(Method->getParent()).getTypePtr();
1631         FromType = S.Context.getMemberPointerType(FromType, ClassType);
1632       } else if (isa<UnaryOperator>(From->IgnoreParens())) {
1633         assert(cast<UnaryOperator>(From->IgnoreParens())->getOpcode() ==
1634                UO_AddrOf &&
1635                "Non-address-of operator for overloaded function expression");
1636         FromType = S.Context.getPointerType(FromType);
1637       }
1638 
1639       // Check that we've computed the proper type after overload resolution.
1640       // FIXME: FixOverloadedFunctionReference has side-effects; we shouldn't
1641       // be calling it from within an NDEBUG block.
1642       assert(S.Context.hasSameType(
1643         FromType,
1644         S.FixOverloadedFunctionReference(From, AccessPair, Fn)->getType()));
1645     } else {
1646       return false;
1647     }
1648   }
1649   // Lvalue-to-rvalue conversion (C++11 4.1):
1650   //   A glvalue (3.10) of a non-function, non-array type T can
1651   //   be converted to a prvalue.
1652   bool argIsLValue = From->isGLValue();
1653   if (argIsLValue &&
1654       !FromType->isFunctionType() && !FromType->isArrayType() &&
1655       S.Context.getCanonicalType(FromType) != S.Context.OverloadTy) {
1656     SCS.First = ICK_Lvalue_To_Rvalue;
1657 
1658     // C11 6.3.2.1p2:
1659     //   ... if the lvalue has atomic type, the value has the non-atomic version
1660     //   of the type of the lvalue ...
1661     if (const AtomicType *Atomic = FromType->getAs<AtomicType>())
1662       FromType = Atomic->getValueType();
1663 
1664     // If T is a non-class type, the type of the rvalue is the
1665     // cv-unqualified version of T. Otherwise, the type of the rvalue
1666     // is T (C++ 4.1p1). C++ can't get here with class types; in C, we
1667     // just strip the qualifiers because they don't matter.
1668     FromType = FromType.getUnqualifiedType();
1669   } else if (FromType->isArrayType()) {
1670     // Array-to-pointer conversion (C++ 4.2)
1671     SCS.First = ICK_Array_To_Pointer;
1672 
1673     // An lvalue or rvalue of type "array of N T" or "array of unknown
1674     // bound of T" can be converted to an rvalue of type "pointer to
1675     // T" (C++ 4.2p1).
1676     FromType = S.Context.getArrayDecayedType(FromType);
1677 
1678     if (S.IsStringLiteralToNonConstPointerConversion(From, ToType)) {
1679       // This conversion is deprecated in C++03 (D.4)
1680       SCS.DeprecatedStringLiteralToCharPtr = true;
1681 
1682       // For the purpose of ranking in overload resolution
1683       // (13.3.3.1.1), this conversion is considered an
1684       // array-to-pointer conversion followed by a qualification
1685       // conversion (4.4). (C++ 4.2p2)
1686       SCS.Second = ICK_Identity;
1687       SCS.Third = ICK_Qualification;
1688       SCS.QualificationIncludesObjCLifetime = false;
1689       SCS.setAllToTypes(FromType);
1690       return true;
1691     }
1692   } else if (FromType->isFunctionType() && argIsLValue) {
1693     // Function-to-pointer conversion (C++ 4.3).
1694     SCS.First = ICK_Function_To_Pointer;
1695 
1696     if (auto *DRE = dyn_cast<DeclRefExpr>(From->IgnoreParenCasts()))
1697       if (auto *FD = dyn_cast<FunctionDecl>(DRE->getDecl()))
1698         if (!S.checkAddressOfFunctionIsAvailable(FD))
1699           return false;
1700 
1701     // An lvalue of function type T can be converted to an rvalue of
1702     // type "pointer to T." The result is a pointer to the
1703     // function. (C++ 4.3p1).
1704     FromType = S.Context.getPointerType(FromType);
1705   } else {
1706     // We don't require any conversions for the first step.
1707     SCS.First = ICK_Identity;
1708   }
1709   SCS.setToType(0, FromType);
1710 
1711   // The second conversion can be an integral promotion, floating
1712   // point promotion, integral conversion, floating point conversion,
1713   // floating-integral conversion, pointer conversion,
1714   // pointer-to-member conversion, or boolean conversion (C++ 4p1).
1715   // For overloading in C, this can also be a "compatible-type"
1716   // conversion.
1717   bool IncompatibleObjC = false;
1718   ImplicitConversionKind SecondICK = ICK_Identity;
1719   if (S.Context.hasSameUnqualifiedType(FromType, ToType)) {
1720     // The unqualified versions of the types are the same: there's no
1721     // conversion to do.
1722     SCS.Second = ICK_Identity;
1723   } else if (S.IsIntegralPromotion(From, FromType, ToType)) {
1724     // Integral promotion (C++ 4.5).
1725     SCS.Second = ICK_Integral_Promotion;
1726     FromType = ToType.getUnqualifiedType();
1727   } else if (S.IsFloatingPointPromotion(FromType, ToType)) {
1728     // Floating point promotion (C++ 4.6).
1729     SCS.Second = ICK_Floating_Promotion;
1730     FromType = ToType.getUnqualifiedType();
1731   } else if (S.IsComplexPromotion(FromType, ToType)) {
1732     // Complex promotion (Clang extension)
1733     SCS.Second = ICK_Complex_Promotion;
1734     FromType = ToType.getUnqualifiedType();
1735   } else if (ToType->isBooleanType() &&
1736              (FromType->isArithmeticType() ||
1737               FromType->isAnyPointerType() ||
1738               FromType->isBlockPointerType() ||
1739               FromType->isMemberPointerType() ||
1740               FromType->isNullPtrType())) {
1741     // Boolean conversions (C++ 4.12).
1742     SCS.Second = ICK_Boolean_Conversion;
1743     FromType = S.Context.BoolTy;
1744   } else if (FromType->isIntegralOrUnscopedEnumerationType() &&
1745              ToType->isIntegralType(S.Context)) {
1746     // Integral conversions (C++ 4.7).
1747     SCS.Second = ICK_Integral_Conversion;
1748     FromType = ToType.getUnqualifiedType();
1749   } else if (FromType->isAnyComplexType() && ToType->isAnyComplexType()) {
1750     // Complex conversions (C99 6.3.1.6)
1751     SCS.Second = ICK_Complex_Conversion;
1752     FromType = ToType.getUnqualifiedType();
1753   } else if ((FromType->isAnyComplexType() && ToType->isArithmeticType()) ||
1754              (ToType->isAnyComplexType() && FromType->isArithmeticType())) {
1755     // Complex-real conversions (C99 6.3.1.7)
1756     SCS.Second = ICK_Complex_Real;
1757     FromType = ToType.getUnqualifiedType();
1758   } else if (FromType->isRealFloatingType() && ToType->isRealFloatingType()) {
1759     // FIXME: disable conversions between long double and __float128 if
1760     // their representation is different until there is back end support
1761     // We of course allow this conversion if long double is really double.
1762     if (&S.Context.getFloatTypeSemantics(FromType) !=
1763         &S.Context.getFloatTypeSemantics(ToType)) {
1764       bool Float128AndLongDouble = ((FromType == S.Context.Float128Ty &&
1765                                     ToType == S.Context.LongDoubleTy) ||
1766                                    (FromType == S.Context.LongDoubleTy &&
1767                                     ToType == S.Context.Float128Ty));
1768       if (Float128AndLongDouble &&
1769           (&S.Context.getFloatTypeSemantics(S.Context.LongDoubleTy) !=
1770            &llvm::APFloat::IEEEdouble()))
1771         return false;
1772     }
1773     // Floating point conversions (C++ 4.8).
1774     SCS.Second = ICK_Floating_Conversion;
1775     FromType = ToType.getUnqualifiedType();
1776   } else if ((FromType->isRealFloatingType() &&
1777               ToType->isIntegralType(S.Context)) ||
1778              (FromType->isIntegralOrUnscopedEnumerationType() &&
1779               ToType->isRealFloatingType())) {
1780     // Floating-integral conversions (C++ 4.9).
1781     SCS.Second = ICK_Floating_Integral;
1782     FromType = ToType.getUnqualifiedType();
1783   } else if (S.IsBlockPointerConversion(FromType, ToType, FromType)) {
1784     SCS.Second = ICK_Block_Pointer_Conversion;
1785   } else if (AllowObjCWritebackConversion &&
1786              S.isObjCWritebackConversion(FromType, ToType, FromType)) {
1787     SCS.Second = ICK_Writeback_Conversion;
1788   } else if (S.IsPointerConversion(From, FromType, ToType, InOverloadResolution,
1789                                    FromType, IncompatibleObjC)) {
1790     // Pointer conversions (C++ 4.10).
1791     SCS.Second = ICK_Pointer_Conversion;
1792     SCS.IncompatibleObjC = IncompatibleObjC;
1793     FromType = FromType.getUnqualifiedType();
1794   } else if (S.IsMemberPointerConversion(From, FromType, ToType,
1795                                          InOverloadResolution, FromType)) {
1796     // Pointer to member conversions (4.11).
1797     SCS.Second = ICK_Pointer_Member;
1798   } else if (IsVectorConversion(S, FromType, ToType, SecondICK)) {
1799     SCS.Second = SecondICK;
1800     FromType = ToType.getUnqualifiedType();
1801   } else if (!S.getLangOpts().CPlusPlus &&
1802              S.Context.typesAreCompatible(ToType, FromType)) {
1803     // Compatible conversions (Clang extension for C function overloading)
1804     SCS.Second = ICK_Compatible_Conversion;
1805     FromType = ToType.getUnqualifiedType();
1806   } else if (IsTransparentUnionStandardConversion(S, From, ToType,
1807                                              InOverloadResolution,
1808                                              SCS, CStyle)) {
1809     SCS.Second = ICK_TransparentUnionConversion;
1810     FromType = ToType;
1811   } else if (tryAtomicConversion(S, From, ToType, InOverloadResolution, SCS,
1812                                  CStyle)) {
1813     // tryAtomicConversion has updated the standard conversion sequence
1814     // appropriately.
1815     return true;
1816   } else if (ToType->isEventT() &&
1817              From->isIntegerConstantExpr(S.getASTContext()) &&
1818              From->EvaluateKnownConstInt(S.getASTContext()) == 0) {
1819     SCS.Second = ICK_Zero_Event_Conversion;
1820     FromType = ToType;
1821   } else if (ToType->isQueueT() &&
1822              From->isIntegerConstantExpr(S.getASTContext()) &&
1823              (From->EvaluateKnownConstInt(S.getASTContext()) == 0)) {
1824     SCS.Second = ICK_Zero_Queue_Conversion;
1825     FromType = ToType;
1826   } else {
1827     // No second conversion required.
1828     SCS.Second = ICK_Identity;
1829   }
1830   SCS.setToType(1, FromType);
1831 
1832   // The third conversion can be a function pointer conversion or a
1833   // qualification conversion (C++ [conv.fctptr], [conv.qual]).
1834   bool ObjCLifetimeConversion;
1835   if (S.IsFunctionConversion(FromType, ToType, FromType)) {
1836     // Function pointer conversions (removing 'noexcept') including removal of
1837     // 'noreturn' (Clang extension).
1838     SCS.Third = ICK_Function_Conversion;
1839   } else if (S.IsQualificationConversion(FromType, ToType, CStyle,
1840                                          ObjCLifetimeConversion)) {
1841     SCS.Third = ICK_Qualification;
1842     SCS.QualificationIncludesObjCLifetime = ObjCLifetimeConversion;
1843     FromType = ToType;
1844   } else {
1845     // No conversion required
1846     SCS.Third = ICK_Identity;
1847   }
1848 
1849   // C++ [over.best.ics]p6:
1850   //   [...] Any difference in top-level cv-qualification is
1851   //   subsumed by the initialization itself and does not constitute
1852   //   a conversion. [...]
1853   QualType CanonFrom = S.Context.getCanonicalType(FromType);
1854   QualType CanonTo = S.Context.getCanonicalType(ToType);
1855   if (CanonFrom.getLocalUnqualifiedType()
1856                                      == CanonTo.getLocalUnqualifiedType() &&
1857       CanonFrom.getLocalQualifiers() != CanonTo.getLocalQualifiers()) {
1858     FromType = ToType;
1859     CanonFrom = CanonTo;
1860   }
1861 
1862   SCS.setToType(2, FromType);
1863 
1864   if (CanonFrom == CanonTo)
1865     return true;
1866 
1867   // If we have not converted the argument type to the parameter type,
1868   // this is a bad conversion sequence, unless we're resolving an overload in C.
1869   if (S.getLangOpts().CPlusPlus || !InOverloadResolution)
1870     return false;
1871 
1872   ExprResult ER = ExprResult{From};
1873   Sema::AssignConvertType Conv =
1874       S.CheckSingleAssignmentConstraints(ToType, ER,
1875                                          /*Diagnose=*/false,
1876                                          /*DiagnoseCFAudited=*/false,
1877                                          /*ConvertRHS=*/false);
1878   ImplicitConversionKind SecondConv;
1879   switch (Conv) {
1880   case Sema::Compatible:
1881     SecondConv = ICK_C_Only_Conversion;
1882     break;
1883   // For our purposes, discarding qualifiers is just as bad as using an
1884   // incompatible pointer. Note that an IncompatiblePointer conversion can drop
1885   // qualifiers, as well.
1886   case Sema::CompatiblePointerDiscardsQualifiers:
1887   case Sema::IncompatiblePointer:
1888   case Sema::IncompatiblePointerSign:
1889     SecondConv = ICK_Incompatible_Pointer_Conversion;
1890     break;
1891   default:
1892     return false;
1893   }
1894 
1895   // First can only be an lvalue conversion, so we pretend that this was the
1896   // second conversion. First should already be valid from earlier in the
1897   // function.
1898   SCS.Second = SecondConv;
1899   SCS.setToType(1, ToType);
1900 
1901   // Third is Identity, because Second should rank us worse than any other
1902   // conversion. This could also be ICK_Qualification, but it's simpler to just
1903   // lump everything in with the second conversion, and we don't gain anything
1904   // from making this ICK_Qualification.
1905   SCS.Third = ICK_Identity;
1906   SCS.setToType(2, ToType);
1907   return true;
1908 }
1909 
1910 static bool
1911 IsTransparentUnionStandardConversion(Sema &S, Expr* From,
1912                                      QualType &ToType,
1913                                      bool InOverloadResolution,
1914                                      StandardConversionSequence &SCS,
1915                                      bool CStyle) {
1916 
1917   const RecordType *UT = ToType->getAsUnionType();
1918   if (!UT || !UT->getDecl()->hasAttr<TransparentUnionAttr>())
1919     return false;
1920   // The field to initialize within the transparent union.
1921   RecordDecl *UD = UT->getDecl();
1922   // It's compatible if the expression matches any of the fields.
1923   for (const auto *it : UD->fields()) {
1924     if (IsStandardConversion(S, From, it->getType(), InOverloadResolution, SCS,
1925                              CStyle, /*ObjCWritebackConversion=*/false)) {
1926       ToType = it->getType();
1927       return true;
1928     }
1929   }
1930   return false;
1931 }
1932 
1933 /// IsIntegralPromotion - Determines whether the conversion from the
1934 /// expression From (whose potentially-adjusted type is FromType) to
1935 /// ToType is an integral promotion (C++ 4.5). If so, returns true and
1936 /// sets PromotedType to the promoted type.
1937 bool Sema::IsIntegralPromotion(Expr *From, QualType FromType, QualType ToType) {
1938   const BuiltinType *To = ToType->getAs<BuiltinType>();
1939   // All integers are built-in.
1940   if (!To) {
1941     return false;
1942   }
1943 
1944   // An rvalue of type char, signed char, unsigned char, short int, or
1945   // unsigned short int can be converted to an rvalue of type int if
1946   // int can represent all the values of the source type; otherwise,
1947   // the source rvalue can be converted to an rvalue of type unsigned
1948   // int (C++ 4.5p1).
1949   if (FromType->isPromotableIntegerType() && !FromType->isBooleanType() &&
1950       !FromType->isEnumeralType()) {
1951     if (// We can promote any signed, promotable integer type to an int
1952         (FromType->isSignedIntegerType() ||
1953          // We can promote any unsigned integer type whose size is
1954          // less than int to an int.
1955          Context.getTypeSize(FromType) < Context.getTypeSize(ToType))) {
1956       return To->getKind() == BuiltinType::Int;
1957     }
1958 
1959     return To->getKind() == BuiltinType::UInt;
1960   }
1961 
1962   // C++11 [conv.prom]p3:
1963   //   A prvalue of an unscoped enumeration type whose underlying type is not
1964   //   fixed (7.2) can be converted to an rvalue a prvalue of the first of the
1965   //   following types that can represent all the values of the enumeration
1966   //   (i.e., the values in the range bmin to bmax as described in 7.2): int,
1967   //   unsigned int, long int, unsigned long int, long long int, or unsigned
1968   //   long long int. If none of the types in that list can represent all the
1969   //   values of the enumeration, an rvalue a prvalue of an unscoped enumeration
1970   //   type can be converted to an rvalue a prvalue of the extended integer type
1971   //   with lowest integer conversion rank (4.13) greater than the rank of long
1972   //   long in which all the values of the enumeration can be represented. If
1973   //   there are two such extended types, the signed one is chosen.
1974   // C++11 [conv.prom]p4:
1975   //   A prvalue of an unscoped enumeration type whose underlying type is fixed
1976   //   can be converted to a prvalue of its underlying type. Moreover, if
1977   //   integral promotion can be applied to its underlying type, a prvalue of an
1978   //   unscoped enumeration type whose underlying type is fixed can also be
1979   //   converted to a prvalue of the promoted underlying type.
1980   if (const EnumType *FromEnumType = FromType->getAs<EnumType>()) {
1981     // C++0x 7.2p9: Note that this implicit enum to int conversion is not
1982     // provided for a scoped enumeration.
1983     if (FromEnumType->getDecl()->isScoped())
1984       return false;
1985 
1986     // We can perform an integral promotion to the underlying type of the enum,
1987     // even if that's not the promoted type. Note that the check for promoting
1988     // the underlying type is based on the type alone, and does not consider
1989     // the bitfield-ness of the actual source expression.
1990     if (FromEnumType->getDecl()->isFixed()) {
1991       QualType Underlying = FromEnumType->getDecl()->getIntegerType();
1992       return Context.hasSameUnqualifiedType(Underlying, ToType) ||
1993              IsIntegralPromotion(nullptr, Underlying, ToType);
1994     }
1995 
1996     // We have already pre-calculated the promotion type, so this is trivial.
1997     if (ToType->isIntegerType() &&
1998         isCompleteType(From->getLocStart(), FromType))
1999       return Context.hasSameUnqualifiedType(
2000           ToType, FromEnumType->getDecl()->getPromotionType());
2001   }
2002 
2003   // C++0x [conv.prom]p2:
2004   //   A prvalue of type char16_t, char32_t, or wchar_t (3.9.1) can be converted
2005   //   to an rvalue a prvalue of the first of the following types that can
2006   //   represent all the values of its underlying type: int, unsigned int,
2007   //   long int, unsigned long int, long long int, or unsigned long long int.
2008   //   If none of the types in that list can represent all the values of its
2009   //   underlying type, an rvalue a prvalue of type char16_t, char32_t,
2010   //   or wchar_t can be converted to an rvalue a prvalue of its underlying
2011   //   type.
2012   if (FromType->isAnyCharacterType() && !FromType->isCharType() &&
2013       ToType->isIntegerType()) {
2014     // Determine whether the type we're converting from is signed or
2015     // unsigned.
2016     bool FromIsSigned = FromType->isSignedIntegerType();
2017     uint64_t FromSize = Context.getTypeSize(FromType);
2018 
2019     // The types we'll try to promote to, in the appropriate
2020     // order. Try each of these types.
2021     QualType PromoteTypes[6] = {
2022       Context.IntTy, Context.UnsignedIntTy,
2023       Context.LongTy, Context.UnsignedLongTy ,
2024       Context.LongLongTy, Context.UnsignedLongLongTy
2025     };
2026     for (int Idx = 0; Idx < 6; ++Idx) {
2027       uint64_t ToSize = Context.getTypeSize(PromoteTypes[Idx]);
2028       if (FromSize < ToSize ||
2029           (FromSize == ToSize &&
2030            FromIsSigned == PromoteTypes[Idx]->isSignedIntegerType())) {
2031         // We found the type that we can promote to. If this is the
2032         // type we wanted, we have a promotion. Otherwise, no
2033         // promotion.
2034         return Context.hasSameUnqualifiedType(ToType, PromoteTypes[Idx]);
2035       }
2036     }
2037   }
2038 
2039   // An rvalue for an integral bit-field (9.6) can be converted to an
2040   // rvalue of type int if int can represent all the values of the
2041   // bit-field; otherwise, it can be converted to unsigned int if
2042   // unsigned int can represent all the values of the bit-field. If
2043   // the bit-field is larger yet, no integral promotion applies to
2044   // it. If the bit-field has an enumerated type, it is treated as any
2045   // other value of that type for promotion purposes (C++ 4.5p3).
2046   // FIXME: We should delay checking of bit-fields until we actually perform the
2047   // conversion.
2048   if (From) {
2049     if (FieldDecl *MemberDecl = From->getSourceBitField()) {
2050       llvm::APSInt BitWidth;
2051       if (FromType->isIntegralType(Context) &&
2052           MemberDecl->getBitWidth()->isIntegerConstantExpr(BitWidth, Context)) {
2053         llvm::APSInt ToSize(BitWidth.getBitWidth(), BitWidth.isUnsigned());
2054         ToSize = Context.getTypeSize(ToType);
2055 
2056         // Are we promoting to an int from a bitfield that fits in an int?
2057         if (BitWidth < ToSize ||
2058             (FromType->isSignedIntegerType() && BitWidth <= ToSize)) {
2059           return To->getKind() == BuiltinType::Int;
2060         }
2061 
2062         // Are we promoting to an unsigned int from an unsigned bitfield
2063         // that fits into an unsigned int?
2064         if (FromType->isUnsignedIntegerType() && BitWidth <= ToSize) {
2065           return To->getKind() == BuiltinType::UInt;
2066         }
2067 
2068         return false;
2069       }
2070     }
2071   }
2072 
2073   // An rvalue of type bool can be converted to an rvalue of type int,
2074   // with false becoming zero and true becoming one (C++ 4.5p4).
2075   if (FromType->isBooleanType() && To->getKind() == BuiltinType::Int) {
2076     return true;
2077   }
2078 
2079   return false;
2080 }
2081 
2082 /// IsFloatingPointPromotion - Determines whether the conversion from
2083 /// FromType to ToType is a floating point promotion (C++ 4.6). If so,
2084 /// returns true and sets PromotedType to the promoted type.
2085 bool Sema::IsFloatingPointPromotion(QualType FromType, QualType ToType) {
2086   if (const BuiltinType *FromBuiltin = FromType->getAs<BuiltinType>())
2087     if (const BuiltinType *ToBuiltin = ToType->getAs<BuiltinType>()) {
2088       /// An rvalue of type float can be converted to an rvalue of type
2089       /// double. (C++ 4.6p1).
2090       if (FromBuiltin->getKind() == BuiltinType::Float &&
2091           ToBuiltin->getKind() == BuiltinType::Double)
2092         return true;
2093 
2094       // C99 6.3.1.5p1:
2095       //   When a float is promoted to double or long double, or a
2096       //   double is promoted to long double [...].
2097       if (!getLangOpts().CPlusPlus &&
2098           (FromBuiltin->getKind() == BuiltinType::Float ||
2099            FromBuiltin->getKind() == BuiltinType::Double) &&
2100           (ToBuiltin->getKind() == BuiltinType::LongDouble ||
2101            ToBuiltin->getKind() == BuiltinType::Float128))
2102         return true;
2103 
2104       // Half can be promoted to float.
2105       if (!getLangOpts().NativeHalfType &&
2106            FromBuiltin->getKind() == BuiltinType::Half &&
2107           ToBuiltin->getKind() == BuiltinType::Float)
2108         return true;
2109     }
2110 
2111   return false;
2112 }
2113 
2114 /// \brief Determine if a conversion is a complex promotion.
2115 ///
2116 /// A complex promotion is defined as a complex -> complex conversion
2117 /// where the conversion between the underlying real types is a
2118 /// floating-point or integral promotion.
2119 bool Sema::IsComplexPromotion(QualType FromType, QualType ToType) {
2120   const ComplexType *FromComplex = FromType->getAs<ComplexType>();
2121   if (!FromComplex)
2122     return false;
2123 
2124   const ComplexType *ToComplex = ToType->getAs<ComplexType>();
2125   if (!ToComplex)
2126     return false;
2127 
2128   return IsFloatingPointPromotion(FromComplex->getElementType(),
2129                                   ToComplex->getElementType()) ||
2130     IsIntegralPromotion(nullptr, FromComplex->getElementType(),
2131                         ToComplex->getElementType());
2132 }
2133 
2134 /// BuildSimilarlyQualifiedPointerType - In a pointer conversion from
2135 /// the pointer type FromPtr to a pointer to type ToPointee, with the
2136 /// same type qualifiers as FromPtr has on its pointee type. ToType,
2137 /// if non-empty, will be a pointer to ToType that may or may not have
2138 /// the right set of qualifiers on its pointee.
2139 ///
2140 static QualType
2141 BuildSimilarlyQualifiedPointerType(const Type *FromPtr,
2142                                    QualType ToPointee, QualType ToType,
2143                                    ASTContext &Context,
2144                                    bool StripObjCLifetime = false) {
2145   assert((FromPtr->getTypeClass() == Type::Pointer ||
2146           FromPtr->getTypeClass() == Type::ObjCObjectPointer) &&
2147          "Invalid similarly-qualified pointer type");
2148 
2149   /// Conversions to 'id' subsume cv-qualifier conversions.
2150   if (ToType->isObjCIdType() || ToType->isObjCQualifiedIdType())
2151     return ToType.getUnqualifiedType();
2152 
2153   QualType CanonFromPointee
2154     = Context.getCanonicalType(FromPtr->getPointeeType());
2155   QualType CanonToPointee = Context.getCanonicalType(ToPointee);
2156   Qualifiers Quals = CanonFromPointee.getQualifiers();
2157 
2158   if (StripObjCLifetime)
2159     Quals.removeObjCLifetime();
2160 
2161   // Exact qualifier match -> return the pointer type we're converting to.
2162   if (CanonToPointee.getLocalQualifiers() == Quals) {
2163     // ToType is exactly what we need. Return it.
2164     if (!ToType.isNull())
2165       return ToType.getUnqualifiedType();
2166 
2167     // Build a pointer to ToPointee. It has the right qualifiers
2168     // already.
2169     if (isa<ObjCObjectPointerType>(ToType))
2170       return Context.getObjCObjectPointerType(ToPointee);
2171     return Context.getPointerType(ToPointee);
2172   }
2173 
2174   // Just build a canonical type that has the right qualifiers.
2175   QualType QualifiedCanonToPointee
2176     = Context.getQualifiedType(CanonToPointee.getLocalUnqualifiedType(), Quals);
2177 
2178   if (isa<ObjCObjectPointerType>(ToType))
2179     return Context.getObjCObjectPointerType(QualifiedCanonToPointee);
2180   return Context.getPointerType(QualifiedCanonToPointee);
2181 }
2182 
2183 static bool isNullPointerConstantForConversion(Expr *Expr,
2184                                                bool InOverloadResolution,
2185                                                ASTContext &Context) {
2186   // Handle value-dependent integral null pointer constants correctly.
2187   // http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_active.html#903
2188   if (Expr->isValueDependent() && !Expr->isTypeDependent() &&
2189       Expr->getType()->isIntegerType() && !Expr->getType()->isEnumeralType())
2190     return !InOverloadResolution;
2191 
2192   return Expr->isNullPointerConstant(Context,
2193                     InOverloadResolution? Expr::NPC_ValueDependentIsNotNull
2194                                         : Expr::NPC_ValueDependentIsNull);
2195 }
2196 
2197 /// IsPointerConversion - Determines whether the conversion of the
2198 /// expression From, which has the (possibly adjusted) type FromType,
2199 /// can be converted to the type ToType via a pointer conversion (C++
2200 /// 4.10). If so, returns true and places the converted type (that
2201 /// might differ from ToType in its cv-qualifiers at some level) into
2202 /// ConvertedType.
2203 ///
2204 /// This routine also supports conversions to and from block pointers
2205 /// and conversions with Objective-C's 'id', 'id<protocols...>', and
2206 /// pointers to interfaces. FIXME: Once we've determined the
2207 /// appropriate overloading rules for Objective-C, we may want to
2208 /// split the Objective-C checks into a different routine; however,
2209 /// GCC seems to consider all of these conversions to be pointer
2210 /// conversions, so for now they live here. IncompatibleObjC will be
2211 /// set if the conversion is an allowed Objective-C conversion that
2212 /// should result in a warning.
2213 bool Sema::IsPointerConversion(Expr *From, QualType FromType, QualType ToType,
2214                                bool InOverloadResolution,
2215                                QualType& ConvertedType,
2216                                bool &IncompatibleObjC) {
2217   IncompatibleObjC = false;
2218   if (isObjCPointerConversion(FromType, ToType, ConvertedType,
2219                               IncompatibleObjC))
2220     return true;
2221 
2222   // Conversion from a null pointer constant to any Objective-C pointer type.
2223   if (ToType->isObjCObjectPointerType() &&
2224       isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2225     ConvertedType = ToType;
2226     return true;
2227   }
2228 
2229   // Blocks: Block pointers can be converted to void*.
2230   if (FromType->isBlockPointerType() && ToType->isPointerType() &&
2231       ToType->getAs<PointerType>()->getPointeeType()->isVoidType()) {
2232     ConvertedType = ToType;
2233     return true;
2234   }
2235   // Blocks: A null pointer constant can be converted to a block
2236   // pointer type.
2237   if (ToType->isBlockPointerType() &&
2238       isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2239     ConvertedType = ToType;
2240     return true;
2241   }
2242 
2243   // If the left-hand-side is nullptr_t, the right side can be a null
2244   // pointer constant.
2245   if (ToType->isNullPtrType() &&
2246       isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2247     ConvertedType = ToType;
2248     return true;
2249   }
2250 
2251   const PointerType* ToTypePtr = ToType->getAs<PointerType>();
2252   if (!ToTypePtr)
2253     return false;
2254 
2255   // A null pointer constant can be converted to a pointer type (C++ 4.10p1).
2256   if (isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2257     ConvertedType = ToType;
2258     return true;
2259   }
2260 
2261   // Beyond this point, both types need to be pointers
2262   // , including objective-c pointers.
2263   QualType ToPointeeType = ToTypePtr->getPointeeType();
2264   if (FromType->isObjCObjectPointerType() && ToPointeeType->isVoidType() &&
2265       !getLangOpts().ObjCAutoRefCount) {
2266     ConvertedType = BuildSimilarlyQualifiedPointerType(
2267                                       FromType->getAs<ObjCObjectPointerType>(),
2268                                                        ToPointeeType,
2269                                                        ToType, Context);
2270     return true;
2271   }
2272   const PointerType *FromTypePtr = FromType->getAs<PointerType>();
2273   if (!FromTypePtr)
2274     return false;
2275 
2276   QualType FromPointeeType = FromTypePtr->getPointeeType();
2277 
2278   // If the unqualified pointee types are the same, this can't be a
2279   // pointer conversion, so don't do all of the work below.
2280   if (Context.hasSameUnqualifiedType(FromPointeeType, ToPointeeType))
2281     return false;
2282 
2283   // An rvalue of type "pointer to cv T," where T is an object type,
2284   // can be converted to an rvalue of type "pointer to cv void" (C++
2285   // 4.10p2).
2286   if (FromPointeeType->isIncompleteOrObjectType() &&
2287       ToPointeeType->isVoidType()) {
2288     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2289                                                        ToPointeeType,
2290                                                        ToType, Context,
2291                                                    /*StripObjCLifetime=*/true);
2292     return true;
2293   }
2294 
2295   // MSVC allows implicit function to void* type conversion.
2296   if (getLangOpts().MSVCCompat && FromPointeeType->isFunctionType() &&
2297       ToPointeeType->isVoidType()) {
2298     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2299                                                        ToPointeeType,
2300                                                        ToType, Context);
2301     return true;
2302   }
2303 
2304   // When we're overloading in C, we allow a special kind of pointer
2305   // conversion for compatible-but-not-identical pointee types.
2306   if (!getLangOpts().CPlusPlus &&
2307       Context.typesAreCompatible(FromPointeeType, ToPointeeType)) {
2308     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2309                                                        ToPointeeType,
2310                                                        ToType, Context);
2311     return true;
2312   }
2313 
2314   // C++ [conv.ptr]p3:
2315   //
2316   //   An rvalue of type "pointer to cv D," where D is a class type,
2317   //   can be converted to an rvalue of type "pointer to cv B," where
2318   //   B is a base class (clause 10) of D. If B is an inaccessible
2319   //   (clause 11) or ambiguous (10.2) base class of D, a program that
2320   //   necessitates this conversion is ill-formed. The result of the
2321   //   conversion is a pointer to the base class sub-object of the
2322   //   derived class object. The null pointer value is converted to
2323   //   the null pointer value of the destination type.
2324   //
2325   // Note that we do not check for ambiguity or inaccessibility
2326   // here. That is handled by CheckPointerConversion.
2327   if (getLangOpts().CPlusPlus &&
2328       FromPointeeType->isRecordType() && ToPointeeType->isRecordType() &&
2329       !Context.hasSameUnqualifiedType(FromPointeeType, ToPointeeType) &&
2330       IsDerivedFrom(From->getLocStart(), FromPointeeType, ToPointeeType)) {
2331     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2332                                                        ToPointeeType,
2333                                                        ToType, Context);
2334     return true;
2335   }
2336 
2337   if (FromPointeeType->isVectorType() && ToPointeeType->isVectorType() &&
2338       Context.areCompatibleVectorTypes(FromPointeeType, ToPointeeType)) {
2339     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2340                                                        ToPointeeType,
2341                                                        ToType, Context);
2342     return true;
2343   }
2344 
2345   return false;
2346 }
2347 
2348 /// \brief Adopt the given qualifiers for the given type.
2349 static QualType AdoptQualifiers(ASTContext &Context, QualType T, Qualifiers Qs){
2350   Qualifiers TQs = T.getQualifiers();
2351 
2352   // Check whether qualifiers already match.
2353   if (TQs == Qs)
2354     return T;
2355 
2356   if (Qs.compatiblyIncludes(TQs))
2357     return Context.getQualifiedType(T, Qs);
2358 
2359   return Context.getQualifiedType(T.getUnqualifiedType(), Qs);
2360 }
2361 
2362 /// isObjCPointerConversion - Determines whether this is an
2363 /// Objective-C pointer conversion. Subroutine of IsPointerConversion,
2364 /// with the same arguments and return values.
2365 bool Sema::isObjCPointerConversion(QualType FromType, QualType ToType,
2366                                    QualType& ConvertedType,
2367                                    bool &IncompatibleObjC) {
2368   if (!getLangOpts().ObjC1)
2369     return false;
2370 
2371   // The set of qualifiers on the type we're converting from.
2372   Qualifiers FromQualifiers = FromType.getQualifiers();
2373 
2374   // First, we handle all conversions on ObjC object pointer types.
2375   const ObjCObjectPointerType* ToObjCPtr =
2376     ToType->getAs<ObjCObjectPointerType>();
2377   const ObjCObjectPointerType *FromObjCPtr =
2378     FromType->getAs<ObjCObjectPointerType>();
2379 
2380   if (ToObjCPtr && FromObjCPtr) {
2381     // If the pointee types are the same (ignoring qualifications),
2382     // then this is not a pointer conversion.
2383     if (Context.hasSameUnqualifiedType(ToObjCPtr->getPointeeType(),
2384                                        FromObjCPtr->getPointeeType()))
2385       return false;
2386 
2387     // Conversion between Objective-C pointers.
2388     if (Context.canAssignObjCInterfaces(ToObjCPtr, FromObjCPtr)) {
2389       const ObjCInterfaceType* LHS = ToObjCPtr->getInterfaceType();
2390       const ObjCInterfaceType* RHS = FromObjCPtr->getInterfaceType();
2391       if (getLangOpts().CPlusPlus && LHS && RHS &&
2392           !ToObjCPtr->getPointeeType().isAtLeastAsQualifiedAs(
2393                                                 FromObjCPtr->getPointeeType()))
2394         return false;
2395       ConvertedType = BuildSimilarlyQualifiedPointerType(FromObjCPtr,
2396                                                    ToObjCPtr->getPointeeType(),
2397                                                          ToType, Context);
2398       ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2399       return true;
2400     }
2401 
2402     if (Context.canAssignObjCInterfaces(FromObjCPtr, ToObjCPtr)) {
2403       // Okay: this is some kind of implicit downcast of Objective-C
2404       // interfaces, which is permitted. However, we're going to
2405       // complain about it.
2406       IncompatibleObjC = true;
2407       ConvertedType = BuildSimilarlyQualifiedPointerType(FromObjCPtr,
2408                                                    ToObjCPtr->getPointeeType(),
2409                                                          ToType, Context);
2410       ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2411       return true;
2412     }
2413   }
2414   // Beyond this point, both types need to be C pointers or block pointers.
2415   QualType ToPointeeType;
2416   if (const PointerType *ToCPtr = ToType->getAs<PointerType>())
2417     ToPointeeType = ToCPtr->getPointeeType();
2418   else if (const BlockPointerType *ToBlockPtr =
2419             ToType->getAs<BlockPointerType>()) {
2420     // Objective C++: We're able to convert from a pointer to any object
2421     // to a block pointer type.
2422     if (FromObjCPtr && FromObjCPtr->isObjCBuiltinType()) {
2423       ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2424       return true;
2425     }
2426     ToPointeeType = ToBlockPtr->getPointeeType();
2427   }
2428   else if (FromType->getAs<BlockPointerType>() &&
2429            ToObjCPtr && ToObjCPtr->isObjCBuiltinType()) {
2430     // Objective C++: We're able to convert from a block pointer type to a
2431     // pointer to any object.
2432     ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2433     return true;
2434   }
2435   else
2436     return false;
2437 
2438   QualType FromPointeeType;
2439   if (const PointerType *FromCPtr = FromType->getAs<PointerType>())
2440     FromPointeeType = FromCPtr->getPointeeType();
2441   else if (const BlockPointerType *FromBlockPtr =
2442            FromType->getAs<BlockPointerType>())
2443     FromPointeeType = FromBlockPtr->getPointeeType();
2444   else
2445     return false;
2446 
2447   // If we have pointers to pointers, recursively check whether this
2448   // is an Objective-C conversion.
2449   if (FromPointeeType->isPointerType() && ToPointeeType->isPointerType() &&
2450       isObjCPointerConversion(FromPointeeType, ToPointeeType, ConvertedType,
2451                               IncompatibleObjC)) {
2452     // We always complain about this conversion.
2453     IncompatibleObjC = true;
2454     ConvertedType = Context.getPointerType(ConvertedType);
2455     ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2456     return true;
2457   }
2458   // Allow conversion of pointee being objective-c pointer to another one;
2459   // as in I* to id.
2460   if (FromPointeeType->getAs<ObjCObjectPointerType>() &&
2461       ToPointeeType->getAs<ObjCObjectPointerType>() &&
2462       isObjCPointerConversion(FromPointeeType, ToPointeeType, ConvertedType,
2463                               IncompatibleObjC)) {
2464 
2465     ConvertedType = Context.getPointerType(ConvertedType);
2466     ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2467     return true;
2468   }
2469 
2470   // If we have pointers to functions or blocks, check whether the only
2471   // differences in the argument and result types are in Objective-C
2472   // pointer conversions. If so, we permit the conversion (but
2473   // complain about it).
2474   const FunctionProtoType *FromFunctionType
2475     = FromPointeeType->getAs<FunctionProtoType>();
2476   const FunctionProtoType *ToFunctionType
2477     = ToPointeeType->getAs<FunctionProtoType>();
2478   if (FromFunctionType && ToFunctionType) {
2479     // If the function types are exactly the same, this isn't an
2480     // Objective-C pointer conversion.
2481     if (Context.getCanonicalType(FromPointeeType)
2482           == Context.getCanonicalType(ToPointeeType))
2483       return false;
2484 
2485     // Perform the quick checks that will tell us whether these
2486     // function types are obviously different.
2487     if (FromFunctionType->getNumParams() != ToFunctionType->getNumParams() ||
2488         FromFunctionType->isVariadic() != ToFunctionType->isVariadic() ||
2489         FromFunctionType->getTypeQuals() != ToFunctionType->getTypeQuals())
2490       return false;
2491 
2492     bool HasObjCConversion = false;
2493     if (Context.getCanonicalType(FromFunctionType->getReturnType()) ==
2494         Context.getCanonicalType(ToFunctionType->getReturnType())) {
2495       // Okay, the types match exactly. Nothing to do.
2496     } else if (isObjCPointerConversion(FromFunctionType->getReturnType(),
2497                                        ToFunctionType->getReturnType(),
2498                                        ConvertedType, IncompatibleObjC)) {
2499       // Okay, we have an Objective-C pointer conversion.
2500       HasObjCConversion = true;
2501     } else {
2502       // Function types are too different. Abort.
2503       return false;
2504     }
2505 
2506     // Check argument types.
2507     for (unsigned ArgIdx = 0, NumArgs = FromFunctionType->getNumParams();
2508          ArgIdx != NumArgs; ++ArgIdx) {
2509       QualType FromArgType = FromFunctionType->getParamType(ArgIdx);
2510       QualType ToArgType = ToFunctionType->getParamType(ArgIdx);
2511       if (Context.getCanonicalType(FromArgType)
2512             == Context.getCanonicalType(ToArgType)) {
2513         // Okay, the types match exactly. Nothing to do.
2514       } else if (isObjCPointerConversion(FromArgType, ToArgType,
2515                                          ConvertedType, IncompatibleObjC)) {
2516         // Okay, we have an Objective-C pointer conversion.
2517         HasObjCConversion = true;
2518       } else {
2519         // Argument types are too different. Abort.
2520         return false;
2521       }
2522     }
2523 
2524     if (HasObjCConversion) {
2525       // We had an Objective-C conversion. Allow this pointer
2526       // conversion, but complain about it.
2527       ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2528       IncompatibleObjC = true;
2529       return true;
2530     }
2531   }
2532 
2533   return false;
2534 }
2535 
2536 /// \brief Determine whether this is an Objective-C writeback conversion,
2537 /// used for parameter passing when performing automatic reference counting.
2538 ///
2539 /// \param FromType The type we're converting form.
2540 ///
2541 /// \param ToType The type we're converting to.
2542 ///
2543 /// \param ConvertedType The type that will be produced after applying
2544 /// this conversion.
2545 bool Sema::isObjCWritebackConversion(QualType FromType, QualType ToType,
2546                                      QualType &ConvertedType) {
2547   if (!getLangOpts().ObjCAutoRefCount ||
2548       Context.hasSameUnqualifiedType(FromType, ToType))
2549     return false;
2550 
2551   // Parameter must be a pointer to __autoreleasing (with no other qualifiers).
2552   QualType ToPointee;
2553   if (const PointerType *ToPointer = ToType->getAs<PointerType>())
2554     ToPointee = ToPointer->getPointeeType();
2555   else
2556     return false;
2557 
2558   Qualifiers ToQuals = ToPointee.getQualifiers();
2559   if (!ToPointee->isObjCLifetimeType() ||
2560       ToQuals.getObjCLifetime() != Qualifiers::OCL_Autoreleasing ||
2561       !ToQuals.withoutObjCLifetime().empty())
2562     return false;
2563 
2564   // Argument must be a pointer to __strong to __weak.
2565   QualType FromPointee;
2566   if (const PointerType *FromPointer = FromType->getAs<PointerType>())
2567     FromPointee = FromPointer->getPointeeType();
2568   else
2569     return false;
2570 
2571   Qualifiers FromQuals = FromPointee.getQualifiers();
2572   if (!FromPointee->isObjCLifetimeType() ||
2573       (FromQuals.getObjCLifetime() != Qualifiers::OCL_Strong &&
2574        FromQuals.getObjCLifetime() != Qualifiers::OCL_Weak))
2575     return false;
2576 
2577   // Make sure that we have compatible qualifiers.
2578   FromQuals.setObjCLifetime(Qualifiers::OCL_Autoreleasing);
2579   if (!ToQuals.compatiblyIncludes(FromQuals))
2580     return false;
2581 
2582   // Remove qualifiers from the pointee type we're converting from; they
2583   // aren't used in the compatibility check belong, and we'll be adding back
2584   // qualifiers (with __autoreleasing) if the compatibility check succeeds.
2585   FromPointee = FromPointee.getUnqualifiedType();
2586 
2587   // The unqualified form of the pointee types must be compatible.
2588   ToPointee = ToPointee.getUnqualifiedType();
2589   bool IncompatibleObjC;
2590   if (Context.typesAreCompatible(FromPointee, ToPointee))
2591     FromPointee = ToPointee;
2592   else if (!isObjCPointerConversion(FromPointee, ToPointee, FromPointee,
2593                                     IncompatibleObjC))
2594     return false;
2595 
2596   /// \brief Construct the type we're converting to, which is a pointer to
2597   /// __autoreleasing pointee.
2598   FromPointee = Context.getQualifiedType(FromPointee, FromQuals);
2599   ConvertedType = Context.getPointerType(FromPointee);
2600   return true;
2601 }
2602 
2603 bool Sema::IsBlockPointerConversion(QualType FromType, QualType ToType,
2604                                     QualType& ConvertedType) {
2605   QualType ToPointeeType;
2606   if (const BlockPointerType *ToBlockPtr =
2607         ToType->getAs<BlockPointerType>())
2608     ToPointeeType = ToBlockPtr->getPointeeType();
2609   else
2610     return false;
2611 
2612   QualType FromPointeeType;
2613   if (const BlockPointerType *FromBlockPtr =
2614       FromType->getAs<BlockPointerType>())
2615     FromPointeeType = FromBlockPtr->getPointeeType();
2616   else
2617     return false;
2618   // We have pointer to blocks, check whether the only
2619   // differences in the argument and result types are in Objective-C
2620   // pointer conversions. If so, we permit the conversion.
2621 
2622   const FunctionProtoType *FromFunctionType
2623     = FromPointeeType->getAs<FunctionProtoType>();
2624   const FunctionProtoType *ToFunctionType
2625     = ToPointeeType->getAs<FunctionProtoType>();
2626 
2627   if (!FromFunctionType || !ToFunctionType)
2628     return false;
2629 
2630   if (Context.hasSameType(FromPointeeType, ToPointeeType))
2631     return true;
2632 
2633   // Perform the quick checks that will tell us whether these
2634   // function types are obviously different.
2635   if (FromFunctionType->getNumParams() != ToFunctionType->getNumParams() ||
2636       FromFunctionType->isVariadic() != ToFunctionType->isVariadic())
2637     return false;
2638 
2639   FunctionType::ExtInfo FromEInfo = FromFunctionType->getExtInfo();
2640   FunctionType::ExtInfo ToEInfo = ToFunctionType->getExtInfo();
2641   if (FromEInfo != ToEInfo)
2642     return false;
2643 
2644   bool IncompatibleObjC = false;
2645   if (Context.hasSameType(FromFunctionType->getReturnType(),
2646                           ToFunctionType->getReturnType())) {
2647     // Okay, the types match exactly. Nothing to do.
2648   } else {
2649     QualType RHS = FromFunctionType->getReturnType();
2650     QualType LHS = ToFunctionType->getReturnType();
2651     if ((!getLangOpts().CPlusPlus || !RHS->isRecordType()) &&
2652         !RHS.hasQualifiers() && LHS.hasQualifiers())
2653        LHS = LHS.getUnqualifiedType();
2654 
2655      if (Context.hasSameType(RHS,LHS)) {
2656        // OK exact match.
2657      } else if (isObjCPointerConversion(RHS, LHS,
2658                                         ConvertedType, IncompatibleObjC)) {
2659      if (IncompatibleObjC)
2660        return false;
2661      // Okay, we have an Objective-C pointer conversion.
2662      }
2663      else
2664        return false;
2665    }
2666 
2667    // Check argument types.
2668    for (unsigned ArgIdx = 0, NumArgs = FromFunctionType->getNumParams();
2669         ArgIdx != NumArgs; ++ArgIdx) {
2670      IncompatibleObjC = false;
2671      QualType FromArgType = FromFunctionType->getParamType(ArgIdx);
2672      QualType ToArgType = ToFunctionType->getParamType(ArgIdx);
2673      if (Context.hasSameType(FromArgType, ToArgType)) {
2674        // Okay, the types match exactly. Nothing to do.
2675      } else if (isObjCPointerConversion(ToArgType, FromArgType,
2676                                         ConvertedType, IncompatibleObjC)) {
2677        if (IncompatibleObjC)
2678          return false;
2679        // Okay, we have an Objective-C pointer conversion.
2680      } else
2681        // Argument types are too different. Abort.
2682        return false;
2683    }
2684 
2685    SmallVector<FunctionProtoType::ExtParameterInfo, 4> NewParamInfos;
2686    bool CanUseToFPT, CanUseFromFPT;
2687    if (!Context.mergeExtParameterInfo(ToFunctionType, FromFunctionType,
2688                                       CanUseToFPT, CanUseFromFPT,
2689                                       NewParamInfos))
2690      return false;
2691 
2692    ConvertedType = ToType;
2693    return true;
2694 }
2695 
2696 enum {
2697   ft_default,
2698   ft_different_class,
2699   ft_parameter_arity,
2700   ft_parameter_mismatch,
2701   ft_return_type,
2702   ft_qualifer_mismatch,
2703   ft_noexcept
2704 };
2705 
2706 /// Attempts to get the FunctionProtoType from a Type. Handles
2707 /// MemberFunctionPointers properly.
2708 static const FunctionProtoType *tryGetFunctionProtoType(QualType FromType) {
2709   if (auto *FPT = FromType->getAs<FunctionProtoType>())
2710     return FPT;
2711 
2712   if (auto *MPT = FromType->getAs<MemberPointerType>())
2713     return MPT->getPointeeType()->getAs<FunctionProtoType>();
2714 
2715   return nullptr;
2716 }
2717 
2718 /// HandleFunctionTypeMismatch - Gives diagnostic information for differeing
2719 /// function types.  Catches different number of parameter, mismatch in
2720 /// parameter types, and different return types.
2721 void Sema::HandleFunctionTypeMismatch(PartialDiagnostic &PDiag,
2722                                       QualType FromType, QualType ToType) {
2723   // If either type is not valid, include no extra info.
2724   if (FromType.isNull() || ToType.isNull()) {
2725     PDiag << ft_default;
2726     return;
2727   }
2728 
2729   // Get the function type from the pointers.
2730   if (FromType->isMemberPointerType() && ToType->isMemberPointerType()) {
2731     const MemberPointerType *FromMember = FromType->getAs<MemberPointerType>(),
2732                             *ToMember = ToType->getAs<MemberPointerType>();
2733     if (!Context.hasSameType(FromMember->getClass(), ToMember->getClass())) {
2734       PDiag << ft_different_class << QualType(ToMember->getClass(), 0)
2735             << QualType(FromMember->getClass(), 0);
2736       return;
2737     }
2738     FromType = FromMember->getPointeeType();
2739     ToType = ToMember->getPointeeType();
2740   }
2741 
2742   if (FromType->isPointerType())
2743     FromType = FromType->getPointeeType();
2744   if (ToType->isPointerType())
2745     ToType = ToType->getPointeeType();
2746 
2747   // Remove references.
2748   FromType = FromType.getNonReferenceType();
2749   ToType = ToType.getNonReferenceType();
2750 
2751   // Don't print extra info for non-specialized template functions.
2752   if (FromType->isInstantiationDependentType() &&
2753       !FromType->getAs<TemplateSpecializationType>()) {
2754     PDiag << ft_default;
2755     return;
2756   }
2757 
2758   // No extra info for same types.
2759   if (Context.hasSameType(FromType, ToType)) {
2760     PDiag << ft_default;
2761     return;
2762   }
2763 
2764   const FunctionProtoType *FromFunction = tryGetFunctionProtoType(FromType),
2765                           *ToFunction = tryGetFunctionProtoType(ToType);
2766 
2767   // Both types need to be function types.
2768   if (!FromFunction || !ToFunction) {
2769     PDiag << ft_default;
2770     return;
2771   }
2772 
2773   if (FromFunction->getNumParams() != ToFunction->getNumParams()) {
2774     PDiag << ft_parameter_arity << ToFunction->getNumParams()
2775           << FromFunction->getNumParams();
2776     return;
2777   }
2778 
2779   // Handle different parameter types.
2780   unsigned ArgPos;
2781   if (!FunctionParamTypesAreEqual(FromFunction, ToFunction, &ArgPos)) {
2782     PDiag << ft_parameter_mismatch << ArgPos + 1
2783           << ToFunction->getParamType(ArgPos)
2784           << FromFunction->getParamType(ArgPos);
2785     return;
2786   }
2787 
2788   // Handle different return type.
2789   if (!Context.hasSameType(FromFunction->getReturnType(),
2790                            ToFunction->getReturnType())) {
2791     PDiag << ft_return_type << ToFunction->getReturnType()
2792           << FromFunction->getReturnType();
2793     return;
2794   }
2795 
2796   unsigned FromQuals = FromFunction->getTypeQuals(),
2797            ToQuals = ToFunction->getTypeQuals();
2798   if (FromQuals != ToQuals) {
2799     PDiag << ft_qualifer_mismatch << ToQuals << FromQuals;
2800     return;
2801   }
2802 
2803   // Handle exception specification differences on canonical type (in C++17
2804   // onwards).
2805   if (cast<FunctionProtoType>(FromFunction->getCanonicalTypeUnqualified())
2806           ->isNothrow(Context) !=
2807       cast<FunctionProtoType>(ToFunction->getCanonicalTypeUnqualified())
2808           ->isNothrow(Context)) {
2809     PDiag << ft_noexcept;
2810     return;
2811   }
2812 
2813   // Unable to find a difference, so add no extra info.
2814   PDiag << ft_default;
2815 }
2816 
2817 /// FunctionParamTypesAreEqual - This routine checks two function proto types
2818 /// for equality of their argument types. Caller has already checked that
2819 /// they have same number of arguments.  If the parameters are different,
2820 /// ArgPos will have the parameter index of the first different parameter.
2821 bool Sema::FunctionParamTypesAreEqual(const FunctionProtoType *OldType,
2822                                       const FunctionProtoType *NewType,
2823                                       unsigned *ArgPos) {
2824   for (FunctionProtoType::param_type_iterator O = OldType->param_type_begin(),
2825                                               N = NewType->param_type_begin(),
2826                                               E = OldType->param_type_end();
2827        O && (O != E); ++O, ++N) {
2828     if (!Context.hasSameType(O->getUnqualifiedType(),
2829                              N->getUnqualifiedType())) {
2830       if (ArgPos)
2831         *ArgPos = O - OldType->param_type_begin();
2832       return false;
2833     }
2834   }
2835   return true;
2836 }
2837 
2838 /// CheckPointerConversion - Check the pointer conversion from the
2839 /// expression From to the type ToType. This routine checks for
2840 /// ambiguous or inaccessible derived-to-base pointer
2841 /// conversions for which IsPointerConversion has already returned
2842 /// true. It returns true and produces a diagnostic if there was an
2843 /// error, or returns false otherwise.
2844 bool Sema::CheckPointerConversion(Expr *From, QualType ToType,
2845                                   CastKind &Kind,
2846                                   CXXCastPath& BasePath,
2847                                   bool IgnoreBaseAccess,
2848                                   bool Diagnose) {
2849   QualType FromType = From->getType();
2850   bool IsCStyleOrFunctionalCast = IgnoreBaseAccess;
2851 
2852   Kind = CK_BitCast;
2853 
2854   if (Diagnose && !IsCStyleOrFunctionalCast && !FromType->isAnyPointerType() &&
2855       From->isNullPointerConstant(Context, Expr::NPC_ValueDependentIsNotNull) ==
2856           Expr::NPCK_ZeroExpression) {
2857     if (Context.hasSameUnqualifiedType(From->getType(), Context.BoolTy))
2858       DiagRuntimeBehavior(From->getExprLoc(), From,
2859                           PDiag(diag::warn_impcast_bool_to_null_pointer)
2860                             << ToType << From->getSourceRange());
2861     else if (!isUnevaluatedContext())
2862       Diag(From->getExprLoc(), diag::warn_non_literal_null_pointer)
2863         << ToType << From->getSourceRange();
2864   }
2865   if (const PointerType *ToPtrType = ToType->getAs<PointerType>()) {
2866     if (const PointerType *FromPtrType = FromType->getAs<PointerType>()) {
2867       QualType FromPointeeType = FromPtrType->getPointeeType(),
2868                ToPointeeType   = ToPtrType->getPointeeType();
2869 
2870       if (FromPointeeType->isRecordType() && ToPointeeType->isRecordType() &&
2871           !Context.hasSameUnqualifiedType(FromPointeeType, ToPointeeType)) {
2872         // We must have a derived-to-base conversion. Check an
2873         // ambiguous or inaccessible conversion.
2874         unsigned InaccessibleID = 0;
2875         unsigned AmbigiousID = 0;
2876         if (Diagnose) {
2877           InaccessibleID = diag::err_upcast_to_inaccessible_base;
2878           AmbigiousID = diag::err_ambiguous_derived_to_base_conv;
2879         }
2880         if (CheckDerivedToBaseConversion(
2881                 FromPointeeType, ToPointeeType, InaccessibleID, AmbigiousID,
2882                 From->getExprLoc(), From->getSourceRange(), DeclarationName(),
2883                 &BasePath, IgnoreBaseAccess))
2884           return true;
2885 
2886         // The conversion was successful.
2887         Kind = CK_DerivedToBase;
2888       }
2889 
2890       if (Diagnose && !IsCStyleOrFunctionalCast &&
2891           FromPointeeType->isFunctionType() && ToPointeeType->isVoidType()) {
2892         assert(getLangOpts().MSVCCompat &&
2893                "this should only be possible with MSVCCompat!");
2894         Diag(From->getExprLoc(), diag::ext_ms_impcast_fn_obj)
2895             << From->getSourceRange();
2896       }
2897     }
2898   } else if (const ObjCObjectPointerType *ToPtrType =
2899                ToType->getAs<ObjCObjectPointerType>()) {
2900     if (const ObjCObjectPointerType *FromPtrType =
2901           FromType->getAs<ObjCObjectPointerType>()) {
2902       // Objective-C++ conversions are always okay.
2903       // FIXME: We should have a different class of conversions for the
2904       // Objective-C++ implicit conversions.
2905       if (FromPtrType->isObjCBuiltinType() || ToPtrType->isObjCBuiltinType())
2906         return false;
2907     } else if (FromType->isBlockPointerType()) {
2908       Kind = CK_BlockPointerToObjCPointerCast;
2909     } else {
2910       Kind = CK_CPointerToObjCPointerCast;
2911     }
2912   } else if (ToType->isBlockPointerType()) {
2913     if (!FromType->isBlockPointerType())
2914       Kind = CK_AnyPointerToBlockPointerCast;
2915   }
2916 
2917   // We shouldn't fall into this case unless it's valid for other
2918   // reasons.
2919   if (From->isNullPointerConstant(Context, Expr::NPC_ValueDependentIsNull))
2920     Kind = CK_NullToPointer;
2921 
2922   return false;
2923 }
2924 
2925 /// IsMemberPointerConversion - Determines whether the conversion of the
2926 /// expression From, which has the (possibly adjusted) type FromType, can be
2927 /// converted to the type ToType via a member pointer conversion (C++ 4.11).
2928 /// If so, returns true and places the converted type (that might differ from
2929 /// ToType in its cv-qualifiers at some level) into ConvertedType.
2930 bool Sema::IsMemberPointerConversion(Expr *From, QualType FromType,
2931                                      QualType ToType,
2932                                      bool InOverloadResolution,
2933                                      QualType &ConvertedType) {
2934   const MemberPointerType *ToTypePtr = ToType->getAs<MemberPointerType>();
2935   if (!ToTypePtr)
2936     return false;
2937 
2938   // A null pointer constant can be converted to a member pointer (C++ 4.11p1)
2939   if (From->isNullPointerConstant(Context,
2940                     InOverloadResolution? Expr::NPC_ValueDependentIsNotNull
2941                                         : Expr::NPC_ValueDependentIsNull)) {
2942     ConvertedType = ToType;
2943     return true;
2944   }
2945 
2946   // Otherwise, both types have to be member pointers.
2947   const MemberPointerType *FromTypePtr = FromType->getAs<MemberPointerType>();
2948   if (!FromTypePtr)
2949     return false;
2950 
2951   // A pointer to member of B can be converted to a pointer to member of D,
2952   // where D is derived from B (C++ 4.11p2).
2953   QualType FromClass(FromTypePtr->getClass(), 0);
2954   QualType ToClass(ToTypePtr->getClass(), 0);
2955 
2956   if (!Context.hasSameUnqualifiedType(FromClass, ToClass) &&
2957       IsDerivedFrom(From->getLocStart(), ToClass, FromClass)) {
2958     ConvertedType = Context.getMemberPointerType(FromTypePtr->getPointeeType(),
2959                                                  ToClass.getTypePtr());
2960     return true;
2961   }
2962 
2963   return false;
2964 }
2965 
2966 /// CheckMemberPointerConversion - Check the member pointer conversion from the
2967 /// expression From to the type ToType. This routine checks for ambiguous or
2968 /// virtual or inaccessible base-to-derived member pointer conversions
2969 /// for which IsMemberPointerConversion has already returned true. It returns
2970 /// true and produces a diagnostic if there was an error, or returns false
2971 /// otherwise.
2972 bool Sema::CheckMemberPointerConversion(Expr *From, QualType ToType,
2973                                         CastKind &Kind,
2974                                         CXXCastPath &BasePath,
2975                                         bool IgnoreBaseAccess) {
2976   QualType FromType = From->getType();
2977   const MemberPointerType *FromPtrType = FromType->getAs<MemberPointerType>();
2978   if (!FromPtrType) {
2979     // This must be a null pointer to member pointer conversion
2980     assert(From->isNullPointerConstant(Context,
2981                                        Expr::NPC_ValueDependentIsNull) &&
2982            "Expr must be null pointer constant!");
2983     Kind = CK_NullToMemberPointer;
2984     return false;
2985   }
2986 
2987   const MemberPointerType *ToPtrType = ToType->getAs<MemberPointerType>();
2988   assert(ToPtrType && "No member pointer cast has a target type "
2989                       "that is not a member pointer.");
2990 
2991   QualType FromClass = QualType(FromPtrType->getClass(), 0);
2992   QualType ToClass   = QualType(ToPtrType->getClass(), 0);
2993 
2994   // FIXME: What about dependent types?
2995   assert(FromClass->isRecordType() && "Pointer into non-class.");
2996   assert(ToClass->isRecordType() && "Pointer into non-class.");
2997 
2998   CXXBasePaths Paths(/*FindAmbiguities=*/true, /*RecordPaths=*/true,
2999                      /*DetectVirtual=*/true);
3000   bool DerivationOkay =
3001       IsDerivedFrom(From->getLocStart(), ToClass, FromClass, Paths);
3002   assert(DerivationOkay &&
3003          "Should not have been called if derivation isn't OK.");
3004   (void)DerivationOkay;
3005 
3006   if (Paths.isAmbiguous(Context.getCanonicalType(FromClass).
3007                                   getUnqualifiedType())) {
3008     std::string PathDisplayStr = getAmbiguousPathsDisplayString(Paths);
3009     Diag(From->getExprLoc(), diag::err_ambiguous_memptr_conv)
3010       << 0 << FromClass << ToClass << PathDisplayStr << From->getSourceRange();
3011     return true;
3012   }
3013 
3014   if (const RecordType *VBase = Paths.getDetectedVirtual()) {
3015     Diag(From->getExprLoc(), diag::err_memptr_conv_via_virtual)
3016       << FromClass << ToClass << QualType(VBase, 0)
3017       << From->getSourceRange();
3018     return true;
3019   }
3020 
3021   if (!IgnoreBaseAccess)
3022     CheckBaseClassAccess(From->getExprLoc(), FromClass, ToClass,
3023                          Paths.front(),
3024                          diag::err_downcast_from_inaccessible_base);
3025 
3026   // Must be a base to derived member conversion.
3027   BuildBasePathArray(Paths, BasePath);
3028   Kind = CK_BaseToDerivedMemberPointer;
3029   return false;
3030 }
3031 
3032 /// Determine whether the lifetime conversion between the two given
3033 /// qualifiers sets is nontrivial.
3034 static bool isNonTrivialObjCLifetimeConversion(Qualifiers FromQuals,
3035                                                Qualifiers ToQuals) {
3036   // Converting anything to const __unsafe_unretained is trivial.
3037   if (ToQuals.hasConst() &&
3038       ToQuals.getObjCLifetime() == Qualifiers::OCL_ExplicitNone)
3039     return false;
3040 
3041   return true;
3042 }
3043 
3044 /// IsQualificationConversion - Determines whether the conversion from
3045 /// an rvalue of type FromType to ToType is a qualification conversion
3046 /// (C++ 4.4).
3047 ///
3048 /// \param ObjCLifetimeConversion Output parameter that will be set to indicate
3049 /// when the qualification conversion involves a change in the Objective-C
3050 /// object lifetime.
3051 bool
3052 Sema::IsQualificationConversion(QualType FromType, QualType ToType,
3053                                 bool CStyle, bool &ObjCLifetimeConversion) {
3054   FromType = Context.getCanonicalType(FromType);
3055   ToType = Context.getCanonicalType(ToType);
3056   ObjCLifetimeConversion = false;
3057 
3058   // If FromType and ToType are the same type, this is not a
3059   // qualification conversion.
3060   if (FromType.getUnqualifiedType() == ToType.getUnqualifiedType())
3061     return false;
3062 
3063   // (C++ 4.4p4):
3064   //   A conversion can add cv-qualifiers at levels other than the first
3065   //   in multi-level pointers, subject to the following rules: [...]
3066   bool PreviousToQualsIncludeConst = true;
3067   bool UnwrappedAnyPointer = false;
3068   while (Context.UnwrapSimilarPointerTypes(FromType, ToType)) {
3069     // Within each iteration of the loop, we check the qualifiers to
3070     // determine if this still looks like a qualification
3071     // conversion. Then, if all is well, we unwrap one more level of
3072     // pointers or pointers-to-members and do it all again
3073     // until there are no more pointers or pointers-to-members left to
3074     // unwrap.
3075     UnwrappedAnyPointer = true;
3076 
3077     Qualifiers FromQuals = FromType.getQualifiers();
3078     Qualifiers ToQuals = ToType.getQualifiers();
3079 
3080     // Ignore __unaligned qualifier if this type is void.
3081     if (ToType.getUnqualifiedType()->isVoidType())
3082       FromQuals.removeUnaligned();
3083 
3084     // Objective-C ARC:
3085     //   Check Objective-C lifetime conversions.
3086     if (FromQuals.getObjCLifetime() != ToQuals.getObjCLifetime() &&
3087         UnwrappedAnyPointer) {
3088       if (ToQuals.compatiblyIncludesObjCLifetime(FromQuals)) {
3089         if (isNonTrivialObjCLifetimeConversion(FromQuals, ToQuals))
3090           ObjCLifetimeConversion = true;
3091         FromQuals.removeObjCLifetime();
3092         ToQuals.removeObjCLifetime();
3093       } else {
3094         // Qualification conversions cannot cast between different
3095         // Objective-C lifetime qualifiers.
3096         return false;
3097       }
3098     }
3099 
3100     // Allow addition/removal of GC attributes but not changing GC attributes.
3101     if (FromQuals.getObjCGCAttr() != ToQuals.getObjCGCAttr() &&
3102         (!FromQuals.hasObjCGCAttr() || !ToQuals.hasObjCGCAttr())) {
3103       FromQuals.removeObjCGCAttr();
3104       ToQuals.removeObjCGCAttr();
3105     }
3106 
3107     //   -- for every j > 0, if const is in cv 1,j then const is in cv
3108     //      2,j, and similarly for volatile.
3109     if (!CStyle && !ToQuals.compatiblyIncludes(FromQuals))
3110       return false;
3111 
3112     //   -- if the cv 1,j and cv 2,j are different, then const is in
3113     //      every cv for 0 < k < j.
3114     if (!CStyle && FromQuals.getCVRQualifiers() != ToQuals.getCVRQualifiers()
3115         && !PreviousToQualsIncludeConst)
3116       return false;
3117 
3118     // Keep track of whether all prior cv-qualifiers in the "to" type
3119     // include const.
3120     PreviousToQualsIncludeConst
3121       = PreviousToQualsIncludeConst && ToQuals.hasConst();
3122   }
3123 
3124   // We are left with FromType and ToType being the pointee types
3125   // after unwrapping the original FromType and ToType the same number
3126   // of types. If we unwrapped any pointers, and if FromType and
3127   // ToType have the same unqualified type (since we checked
3128   // qualifiers above), then this is a qualification conversion.
3129   return UnwrappedAnyPointer && Context.hasSameUnqualifiedType(FromType,ToType);
3130 }
3131 
3132 /// \brief - Determine whether this is a conversion from a scalar type to an
3133 /// atomic type.
3134 ///
3135 /// If successful, updates \c SCS's second and third steps in the conversion
3136 /// sequence to finish the conversion.
3137 static bool tryAtomicConversion(Sema &S, Expr *From, QualType ToType,
3138                                 bool InOverloadResolution,
3139                                 StandardConversionSequence &SCS,
3140                                 bool CStyle) {
3141   const AtomicType *ToAtomic = ToType->getAs<AtomicType>();
3142   if (!ToAtomic)
3143     return false;
3144 
3145   StandardConversionSequence InnerSCS;
3146   if (!IsStandardConversion(S, From, ToAtomic->getValueType(),
3147                             InOverloadResolution, InnerSCS,
3148                             CStyle, /*AllowObjCWritebackConversion=*/false))
3149     return false;
3150 
3151   SCS.Second = InnerSCS.Second;
3152   SCS.setToType(1, InnerSCS.getToType(1));
3153   SCS.Third = InnerSCS.Third;
3154   SCS.QualificationIncludesObjCLifetime
3155     = InnerSCS.QualificationIncludesObjCLifetime;
3156   SCS.setToType(2, InnerSCS.getToType(2));
3157   return true;
3158 }
3159 
3160 static bool isFirstArgumentCompatibleWithType(ASTContext &Context,
3161                                               CXXConstructorDecl *Constructor,
3162                                               QualType Type) {
3163   const FunctionProtoType *CtorType =
3164       Constructor->getType()->getAs<FunctionProtoType>();
3165   if (CtorType->getNumParams() > 0) {
3166     QualType FirstArg = CtorType->getParamType(0);
3167     if (Context.hasSameUnqualifiedType(Type, FirstArg.getNonReferenceType()))
3168       return true;
3169   }
3170   return false;
3171 }
3172 
3173 static OverloadingResult
3174 IsInitializerListConstructorConversion(Sema &S, Expr *From, QualType ToType,
3175                                        CXXRecordDecl *To,
3176                                        UserDefinedConversionSequence &User,
3177                                        OverloadCandidateSet &CandidateSet,
3178                                        bool AllowExplicit) {
3179   CandidateSet.clear(OverloadCandidateSet::CSK_InitByUserDefinedConversion);
3180   for (auto *D : S.LookupConstructors(To)) {
3181     auto Info = getConstructorInfo(D);
3182     if (!Info)
3183       continue;
3184 
3185     bool Usable = !Info.Constructor->isInvalidDecl() &&
3186                   S.isInitListConstructor(Info.Constructor) &&
3187                   (AllowExplicit || !Info.Constructor->isExplicit());
3188     if (Usable) {
3189       // If the first argument is (a reference to) the target type,
3190       // suppress conversions.
3191       bool SuppressUserConversions = isFirstArgumentCompatibleWithType(
3192           S.Context, Info.Constructor, ToType);
3193       if (Info.ConstructorTmpl)
3194         S.AddTemplateOverloadCandidate(Info.ConstructorTmpl, Info.FoundDecl,
3195                                        /*ExplicitArgs*/ nullptr, From,
3196                                        CandidateSet, SuppressUserConversions);
3197       else
3198         S.AddOverloadCandidate(Info.Constructor, Info.FoundDecl, From,
3199                                CandidateSet, SuppressUserConversions);
3200     }
3201   }
3202 
3203   bool HadMultipleCandidates = (CandidateSet.size() > 1);
3204 
3205   OverloadCandidateSet::iterator Best;
3206   switch (auto Result =
3207             CandidateSet.BestViableFunction(S, From->getLocStart(),
3208                                             Best)) {
3209   case OR_Deleted:
3210   case OR_Success: {
3211     // Record the standard conversion we used and the conversion function.
3212     CXXConstructorDecl *Constructor = cast<CXXConstructorDecl>(Best->Function);
3213     QualType ThisType = Constructor->getThisType(S.Context);
3214     // Initializer lists don't have conversions as such.
3215     User.Before.setAsIdentityConversion();
3216     User.HadMultipleCandidates = HadMultipleCandidates;
3217     User.ConversionFunction = Constructor;
3218     User.FoundConversionFunction = Best->FoundDecl;
3219     User.After.setAsIdentityConversion();
3220     User.After.setFromType(ThisType->getAs<PointerType>()->getPointeeType());
3221     User.After.setAllToTypes(ToType);
3222     return Result;
3223   }
3224 
3225   case OR_No_Viable_Function:
3226     return OR_No_Viable_Function;
3227   case OR_Ambiguous:
3228     return OR_Ambiguous;
3229   }
3230 
3231   llvm_unreachable("Invalid OverloadResult!");
3232 }
3233 
3234 /// Determines whether there is a user-defined conversion sequence
3235 /// (C++ [over.ics.user]) that converts expression From to the type
3236 /// ToType. If such a conversion exists, User will contain the
3237 /// user-defined conversion sequence that performs such a conversion
3238 /// and this routine will return true. Otherwise, this routine returns
3239 /// false and User is unspecified.
3240 ///
3241 /// \param AllowExplicit  true if the conversion should consider C++0x
3242 /// "explicit" conversion functions as well as non-explicit conversion
3243 /// functions (C++0x [class.conv.fct]p2).
3244 ///
3245 /// \param AllowObjCConversionOnExplicit true if the conversion should
3246 /// allow an extra Objective-C pointer conversion on uses of explicit
3247 /// constructors. Requires \c AllowExplicit to also be set.
3248 static OverloadingResult
3249 IsUserDefinedConversion(Sema &S, Expr *From, QualType ToType,
3250                         UserDefinedConversionSequence &User,
3251                         OverloadCandidateSet &CandidateSet,
3252                         bool AllowExplicit,
3253                         bool AllowObjCConversionOnExplicit) {
3254   assert(AllowExplicit || !AllowObjCConversionOnExplicit);
3255   CandidateSet.clear(OverloadCandidateSet::CSK_InitByUserDefinedConversion);
3256 
3257   // Whether we will only visit constructors.
3258   bool ConstructorsOnly = false;
3259 
3260   // If the type we are conversion to is a class type, enumerate its
3261   // constructors.
3262   if (const RecordType *ToRecordType = ToType->getAs<RecordType>()) {
3263     // C++ [over.match.ctor]p1:
3264     //   When objects of class type are direct-initialized (8.5), or
3265     //   copy-initialized from an expression of the same or a
3266     //   derived class type (8.5), overload resolution selects the
3267     //   constructor. [...] For copy-initialization, the candidate
3268     //   functions are all the converting constructors (12.3.1) of
3269     //   that class. The argument list is the expression-list within
3270     //   the parentheses of the initializer.
3271     if (S.Context.hasSameUnqualifiedType(ToType, From->getType()) ||
3272         (From->getType()->getAs<RecordType>() &&
3273          S.IsDerivedFrom(From->getLocStart(), From->getType(), ToType)))
3274       ConstructorsOnly = true;
3275 
3276     if (!S.isCompleteType(From->getExprLoc(), ToType)) {
3277       // We're not going to find any constructors.
3278     } else if (CXXRecordDecl *ToRecordDecl
3279                  = dyn_cast<CXXRecordDecl>(ToRecordType->getDecl())) {
3280 
3281       Expr **Args = &From;
3282       unsigned NumArgs = 1;
3283       bool ListInitializing = false;
3284       if (InitListExpr *InitList = dyn_cast<InitListExpr>(From)) {
3285         // But first, see if there is an init-list-constructor that will work.
3286         OverloadingResult Result = IsInitializerListConstructorConversion(
3287             S, From, ToType, ToRecordDecl, User, CandidateSet, AllowExplicit);
3288         if (Result != OR_No_Viable_Function)
3289           return Result;
3290         // Never mind.
3291         CandidateSet.clear(
3292             OverloadCandidateSet::CSK_InitByUserDefinedConversion);
3293 
3294         // If we're list-initializing, we pass the individual elements as
3295         // arguments, not the entire list.
3296         Args = InitList->getInits();
3297         NumArgs = InitList->getNumInits();
3298         ListInitializing = true;
3299       }
3300 
3301       for (auto *D : S.LookupConstructors(ToRecordDecl)) {
3302         auto Info = getConstructorInfo(D);
3303         if (!Info)
3304           continue;
3305 
3306         bool Usable = !Info.Constructor->isInvalidDecl();
3307         if (ListInitializing)
3308           Usable = Usable && (AllowExplicit || !Info.Constructor->isExplicit());
3309         else
3310           Usable = Usable &&
3311                    Info.Constructor->isConvertingConstructor(AllowExplicit);
3312         if (Usable) {
3313           bool SuppressUserConversions = !ConstructorsOnly;
3314           if (SuppressUserConversions && ListInitializing) {
3315             SuppressUserConversions = false;
3316             if (NumArgs == 1) {
3317               // If the first argument is (a reference to) the target type,
3318               // suppress conversions.
3319               SuppressUserConversions = isFirstArgumentCompatibleWithType(
3320                   S.Context, Info.Constructor, ToType);
3321             }
3322           }
3323           if (Info.ConstructorTmpl)
3324             S.AddTemplateOverloadCandidate(
3325                 Info.ConstructorTmpl, Info.FoundDecl,
3326                 /*ExplicitArgs*/ nullptr, llvm::makeArrayRef(Args, NumArgs),
3327                 CandidateSet, SuppressUserConversions);
3328           else
3329             // Allow one user-defined conversion when user specifies a
3330             // From->ToType conversion via an static cast (c-style, etc).
3331             S.AddOverloadCandidate(Info.Constructor, Info.FoundDecl,
3332                                    llvm::makeArrayRef(Args, NumArgs),
3333                                    CandidateSet, SuppressUserConversions);
3334         }
3335       }
3336     }
3337   }
3338 
3339   // Enumerate conversion functions, if we're allowed to.
3340   if (ConstructorsOnly || isa<InitListExpr>(From)) {
3341   } else if (!S.isCompleteType(From->getLocStart(), From->getType())) {
3342     // No conversion functions from incomplete types.
3343   } else if (const RecordType *FromRecordType
3344                                    = From->getType()->getAs<RecordType>()) {
3345     if (CXXRecordDecl *FromRecordDecl
3346          = dyn_cast<CXXRecordDecl>(FromRecordType->getDecl())) {
3347       // Add all of the conversion functions as candidates.
3348       const auto &Conversions = FromRecordDecl->getVisibleConversionFunctions();
3349       for (auto I = Conversions.begin(), E = Conversions.end(); I != E; ++I) {
3350         DeclAccessPair FoundDecl = I.getPair();
3351         NamedDecl *D = FoundDecl.getDecl();
3352         CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(D->getDeclContext());
3353         if (isa<UsingShadowDecl>(D))
3354           D = cast<UsingShadowDecl>(D)->getTargetDecl();
3355 
3356         CXXConversionDecl *Conv;
3357         FunctionTemplateDecl *ConvTemplate;
3358         if ((ConvTemplate = dyn_cast<FunctionTemplateDecl>(D)))
3359           Conv = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
3360         else
3361           Conv = cast<CXXConversionDecl>(D);
3362 
3363         if (AllowExplicit || !Conv->isExplicit()) {
3364           if (ConvTemplate)
3365             S.AddTemplateConversionCandidate(ConvTemplate, FoundDecl,
3366                                              ActingContext, From, ToType,
3367                                              CandidateSet,
3368                                              AllowObjCConversionOnExplicit);
3369           else
3370             S.AddConversionCandidate(Conv, FoundDecl, ActingContext,
3371                                      From, ToType, CandidateSet,
3372                                      AllowObjCConversionOnExplicit);
3373         }
3374       }
3375     }
3376   }
3377 
3378   bool HadMultipleCandidates = (CandidateSet.size() > 1);
3379 
3380   OverloadCandidateSet::iterator Best;
3381   switch (auto Result = CandidateSet.BestViableFunction(S, From->getLocStart(),
3382                                                         Best)) {
3383   case OR_Success:
3384   case OR_Deleted:
3385     // Record the standard conversion we used and the conversion function.
3386     if (CXXConstructorDecl *Constructor
3387           = dyn_cast<CXXConstructorDecl>(Best->Function)) {
3388       // C++ [over.ics.user]p1:
3389       //   If the user-defined conversion is specified by a
3390       //   constructor (12.3.1), the initial standard conversion
3391       //   sequence converts the source type to the type required by
3392       //   the argument of the constructor.
3393       //
3394       QualType ThisType = Constructor->getThisType(S.Context);
3395       if (isa<InitListExpr>(From)) {
3396         // Initializer lists don't have conversions as such.
3397         User.Before.setAsIdentityConversion();
3398       } else {
3399         if (Best->Conversions[0].isEllipsis())
3400           User.EllipsisConversion = true;
3401         else {
3402           User.Before = Best->Conversions[0].Standard;
3403           User.EllipsisConversion = false;
3404         }
3405       }
3406       User.HadMultipleCandidates = HadMultipleCandidates;
3407       User.ConversionFunction = Constructor;
3408       User.FoundConversionFunction = Best->FoundDecl;
3409       User.After.setAsIdentityConversion();
3410       User.After.setFromType(ThisType->getAs<PointerType>()->getPointeeType());
3411       User.After.setAllToTypes(ToType);
3412       return Result;
3413     }
3414     if (CXXConversionDecl *Conversion
3415                  = dyn_cast<CXXConversionDecl>(Best->Function)) {
3416       // C++ [over.ics.user]p1:
3417       //
3418       //   [...] If the user-defined conversion is specified by a
3419       //   conversion function (12.3.2), the initial standard
3420       //   conversion sequence converts the source type to the
3421       //   implicit object parameter of the conversion function.
3422       User.Before = Best->Conversions[0].Standard;
3423       User.HadMultipleCandidates = HadMultipleCandidates;
3424       User.ConversionFunction = Conversion;
3425       User.FoundConversionFunction = Best->FoundDecl;
3426       User.EllipsisConversion = false;
3427 
3428       // C++ [over.ics.user]p2:
3429       //   The second standard conversion sequence converts the
3430       //   result of the user-defined conversion to the target type
3431       //   for the sequence. Since an implicit conversion sequence
3432       //   is an initialization, the special rules for
3433       //   initialization by user-defined conversion apply when
3434       //   selecting the best user-defined conversion for a
3435       //   user-defined conversion sequence (see 13.3.3 and
3436       //   13.3.3.1).
3437       User.After = Best->FinalConversion;
3438       return Result;
3439     }
3440     llvm_unreachable("Not a constructor or conversion function?");
3441 
3442   case OR_No_Viable_Function:
3443     return OR_No_Viable_Function;
3444 
3445   case OR_Ambiguous:
3446     return OR_Ambiguous;
3447   }
3448 
3449   llvm_unreachable("Invalid OverloadResult!");
3450 }
3451 
3452 bool
3453 Sema::DiagnoseMultipleUserDefinedConversion(Expr *From, QualType ToType) {
3454   ImplicitConversionSequence ICS;
3455   OverloadCandidateSet CandidateSet(From->getExprLoc(),
3456                                     OverloadCandidateSet::CSK_Normal);
3457   OverloadingResult OvResult =
3458     IsUserDefinedConversion(*this, From, ToType, ICS.UserDefined,
3459                             CandidateSet, false, false);
3460   if (OvResult == OR_Ambiguous)
3461     Diag(From->getLocStart(), diag::err_typecheck_ambiguous_condition)
3462         << From->getType() << ToType << From->getSourceRange();
3463   else if (OvResult == OR_No_Viable_Function && !CandidateSet.empty()) {
3464     if (!RequireCompleteType(From->getLocStart(), ToType,
3465                              diag::err_typecheck_nonviable_condition_incomplete,
3466                              From->getType(), From->getSourceRange()))
3467       Diag(From->getLocStart(), diag::err_typecheck_nonviable_condition)
3468           << false << From->getType() << From->getSourceRange() << ToType;
3469   } else
3470     return false;
3471   CandidateSet.NoteCandidates(*this, OCD_AllCandidates, From);
3472   return true;
3473 }
3474 
3475 /// \brief Compare the user-defined conversion functions or constructors
3476 /// of two user-defined conversion sequences to determine whether any ordering
3477 /// is possible.
3478 static ImplicitConversionSequence::CompareKind
3479 compareConversionFunctions(Sema &S, FunctionDecl *Function1,
3480                            FunctionDecl *Function2) {
3481   if (!S.getLangOpts().ObjC1 || !S.getLangOpts().CPlusPlus11)
3482     return ImplicitConversionSequence::Indistinguishable;
3483 
3484   // Objective-C++:
3485   //   If both conversion functions are implicitly-declared conversions from
3486   //   a lambda closure type to a function pointer and a block pointer,
3487   //   respectively, always prefer the conversion to a function pointer,
3488   //   because the function pointer is more lightweight and is more likely
3489   //   to keep code working.
3490   CXXConversionDecl *Conv1 = dyn_cast_or_null<CXXConversionDecl>(Function1);
3491   if (!Conv1)
3492     return ImplicitConversionSequence::Indistinguishable;
3493 
3494   CXXConversionDecl *Conv2 = dyn_cast<CXXConversionDecl>(Function2);
3495   if (!Conv2)
3496     return ImplicitConversionSequence::Indistinguishable;
3497 
3498   if (Conv1->getParent()->isLambda() && Conv2->getParent()->isLambda()) {
3499     bool Block1 = Conv1->getConversionType()->isBlockPointerType();
3500     bool Block2 = Conv2->getConversionType()->isBlockPointerType();
3501     if (Block1 != Block2)
3502       return Block1 ? ImplicitConversionSequence::Worse
3503                     : ImplicitConversionSequence::Better;
3504   }
3505 
3506   return ImplicitConversionSequence::Indistinguishable;
3507 }
3508 
3509 static bool hasDeprecatedStringLiteralToCharPtrConversion(
3510     const ImplicitConversionSequence &ICS) {
3511   return (ICS.isStandard() && ICS.Standard.DeprecatedStringLiteralToCharPtr) ||
3512          (ICS.isUserDefined() &&
3513           ICS.UserDefined.Before.DeprecatedStringLiteralToCharPtr);
3514 }
3515 
3516 /// CompareImplicitConversionSequences - Compare two implicit
3517 /// conversion sequences to determine whether one is better than the
3518 /// other or if they are indistinguishable (C++ 13.3.3.2).
3519 static ImplicitConversionSequence::CompareKind
3520 CompareImplicitConversionSequences(Sema &S, SourceLocation Loc,
3521                                    const ImplicitConversionSequence& ICS1,
3522                                    const ImplicitConversionSequence& ICS2)
3523 {
3524   // (C++ 13.3.3.2p2): When comparing the basic forms of implicit
3525   // conversion sequences (as defined in 13.3.3.1)
3526   //   -- a standard conversion sequence (13.3.3.1.1) is a better
3527   //      conversion sequence than a user-defined conversion sequence or
3528   //      an ellipsis conversion sequence, and
3529   //   -- a user-defined conversion sequence (13.3.3.1.2) is a better
3530   //      conversion sequence than an ellipsis conversion sequence
3531   //      (13.3.3.1.3).
3532   //
3533   // C++0x [over.best.ics]p10:
3534   //   For the purpose of ranking implicit conversion sequences as
3535   //   described in 13.3.3.2, the ambiguous conversion sequence is
3536   //   treated as a user-defined sequence that is indistinguishable
3537   //   from any other user-defined conversion sequence.
3538 
3539   // String literal to 'char *' conversion has been deprecated in C++03. It has
3540   // been removed from C++11. We still accept this conversion, if it happens at
3541   // the best viable function. Otherwise, this conversion is considered worse
3542   // than ellipsis conversion. Consider this as an extension; this is not in the
3543   // standard. For example:
3544   //
3545   // int &f(...);    // #1
3546   // void f(char*);  // #2
3547   // void g() { int &r = f("foo"); }
3548   //
3549   // In C++03, we pick #2 as the best viable function.
3550   // In C++11, we pick #1 as the best viable function, because ellipsis
3551   // conversion is better than string-literal to char* conversion (since there
3552   // is no such conversion in C++11). If there was no #1 at all or #1 couldn't
3553   // convert arguments, #2 would be the best viable function in C++11.
3554   // If the best viable function has this conversion, a warning will be issued
3555   // in C++03, or an ExtWarn (+SFINAE failure) will be issued in C++11.
3556 
3557   if (S.getLangOpts().CPlusPlus11 && !S.getLangOpts().WritableStrings &&
3558       hasDeprecatedStringLiteralToCharPtrConversion(ICS1) !=
3559       hasDeprecatedStringLiteralToCharPtrConversion(ICS2))
3560     return hasDeprecatedStringLiteralToCharPtrConversion(ICS1)
3561                ? ImplicitConversionSequence::Worse
3562                : ImplicitConversionSequence::Better;
3563 
3564   if (ICS1.getKindRank() < ICS2.getKindRank())
3565     return ImplicitConversionSequence::Better;
3566   if (ICS2.getKindRank() < ICS1.getKindRank())
3567     return ImplicitConversionSequence::Worse;
3568 
3569   // The following checks require both conversion sequences to be of
3570   // the same kind.
3571   if (ICS1.getKind() != ICS2.getKind())
3572     return ImplicitConversionSequence::Indistinguishable;
3573 
3574   ImplicitConversionSequence::CompareKind Result =
3575       ImplicitConversionSequence::Indistinguishable;
3576 
3577   // Two implicit conversion sequences of the same form are
3578   // indistinguishable conversion sequences unless one of the
3579   // following rules apply: (C++ 13.3.3.2p3):
3580 
3581   // List-initialization sequence L1 is a better conversion sequence than
3582   // list-initialization sequence L2 if:
3583   // - L1 converts to std::initializer_list<X> for some X and L2 does not, or,
3584   //   if not that,
3585   // - L1 converts to type "array of N1 T", L2 converts to type "array of N2 T",
3586   //   and N1 is smaller than N2.,
3587   // even if one of the other rules in this paragraph would otherwise apply.
3588   if (!ICS1.isBad()) {
3589     if (ICS1.isStdInitializerListElement() &&
3590         !ICS2.isStdInitializerListElement())
3591       return ImplicitConversionSequence::Better;
3592     if (!ICS1.isStdInitializerListElement() &&
3593         ICS2.isStdInitializerListElement())
3594       return ImplicitConversionSequence::Worse;
3595   }
3596 
3597   if (ICS1.isStandard())
3598     // Standard conversion sequence S1 is a better conversion sequence than
3599     // standard conversion sequence S2 if [...]
3600     Result = CompareStandardConversionSequences(S, Loc,
3601                                                 ICS1.Standard, ICS2.Standard);
3602   else if (ICS1.isUserDefined()) {
3603     // User-defined conversion sequence U1 is a better conversion
3604     // sequence than another user-defined conversion sequence U2 if
3605     // they contain the same user-defined conversion function or
3606     // constructor and if the second standard conversion sequence of
3607     // U1 is better than the second standard conversion sequence of
3608     // U2 (C++ 13.3.3.2p3).
3609     if (ICS1.UserDefined.ConversionFunction ==
3610           ICS2.UserDefined.ConversionFunction)
3611       Result = CompareStandardConversionSequences(S, Loc,
3612                                                   ICS1.UserDefined.After,
3613                                                   ICS2.UserDefined.After);
3614     else
3615       Result = compareConversionFunctions(S,
3616                                           ICS1.UserDefined.ConversionFunction,
3617                                           ICS2.UserDefined.ConversionFunction);
3618   }
3619 
3620   return Result;
3621 }
3622 
3623 static bool hasSimilarType(ASTContext &Context, QualType T1, QualType T2) {
3624   while (Context.UnwrapSimilarPointerTypes(T1, T2)) {
3625     Qualifiers Quals;
3626     T1 = Context.getUnqualifiedArrayType(T1, Quals);
3627     T2 = Context.getUnqualifiedArrayType(T2, Quals);
3628   }
3629 
3630   return Context.hasSameUnqualifiedType(T1, T2);
3631 }
3632 
3633 // Per 13.3.3.2p3, compare the given standard conversion sequences to
3634 // determine if one is a proper subset of the other.
3635 static ImplicitConversionSequence::CompareKind
3636 compareStandardConversionSubsets(ASTContext &Context,
3637                                  const StandardConversionSequence& SCS1,
3638                                  const StandardConversionSequence& SCS2) {
3639   ImplicitConversionSequence::CompareKind Result
3640     = ImplicitConversionSequence::Indistinguishable;
3641 
3642   // the identity conversion sequence is considered to be a subsequence of
3643   // any non-identity conversion sequence
3644   if (SCS1.isIdentityConversion() && !SCS2.isIdentityConversion())
3645     return ImplicitConversionSequence::Better;
3646   else if (!SCS1.isIdentityConversion() && SCS2.isIdentityConversion())
3647     return ImplicitConversionSequence::Worse;
3648 
3649   if (SCS1.Second != SCS2.Second) {
3650     if (SCS1.Second == ICK_Identity)
3651       Result = ImplicitConversionSequence::Better;
3652     else if (SCS2.Second == ICK_Identity)
3653       Result = ImplicitConversionSequence::Worse;
3654     else
3655       return ImplicitConversionSequence::Indistinguishable;
3656   } else if (!hasSimilarType(Context, SCS1.getToType(1), SCS2.getToType(1)))
3657     return ImplicitConversionSequence::Indistinguishable;
3658 
3659   if (SCS1.Third == SCS2.Third) {
3660     return Context.hasSameType(SCS1.getToType(2), SCS2.getToType(2))? Result
3661                              : ImplicitConversionSequence::Indistinguishable;
3662   }
3663 
3664   if (SCS1.Third == ICK_Identity)
3665     return Result == ImplicitConversionSequence::Worse
3666              ? ImplicitConversionSequence::Indistinguishable
3667              : ImplicitConversionSequence::Better;
3668 
3669   if (SCS2.Third == ICK_Identity)
3670     return Result == ImplicitConversionSequence::Better
3671              ? ImplicitConversionSequence::Indistinguishable
3672              : ImplicitConversionSequence::Worse;
3673 
3674   return ImplicitConversionSequence::Indistinguishable;
3675 }
3676 
3677 /// \brief Determine whether one of the given reference bindings is better
3678 /// than the other based on what kind of bindings they are.
3679 static bool
3680 isBetterReferenceBindingKind(const StandardConversionSequence &SCS1,
3681                              const StandardConversionSequence &SCS2) {
3682   // C++0x [over.ics.rank]p3b4:
3683   //   -- S1 and S2 are reference bindings (8.5.3) and neither refers to an
3684   //      implicit object parameter of a non-static member function declared
3685   //      without a ref-qualifier, and *either* S1 binds an rvalue reference
3686   //      to an rvalue and S2 binds an lvalue reference *or S1 binds an
3687   //      lvalue reference to a function lvalue and S2 binds an rvalue
3688   //      reference*.
3689   //
3690   // FIXME: Rvalue references. We're going rogue with the above edits,
3691   // because the semantics in the current C++0x working paper (N3225 at the
3692   // time of this writing) break the standard definition of std::forward
3693   // and std::reference_wrapper when dealing with references to functions.
3694   // Proposed wording changes submitted to CWG for consideration.
3695   if (SCS1.BindsImplicitObjectArgumentWithoutRefQualifier ||
3696       SCS2.BindsImplicitObjectArgumentWithoutRefQualifier)
3697     return false;
3698 
3699   return (!SCS1.IsLvalueReference && SCS1.BindsToRvalue &&
3700           SCS2.IsLvalueReference) ||
3701          (SCS1.IsLvalueReference && SCS1.BindsToFunctionLvalue &&
3702           !SCS2.IsLvalueReference && SCS2.BindsToFunctionLvalue);
3703 }
3704 
3705 /// CompareStandardConversionSequences - Compare two standard
3706 /// conversion sequences to determine whether one is better than the
3707 /// other or if they are indistinguishable (C++ 13.3.3.2p3).
3708 static ImplicitConversionSequence::CompareKind
3709 CompareStandardConversionSequences(Sema &S, SourceLocation Loc,
3710                                    const StandardConversionSequence& SCS1,
3711                                    const StandardConversionSequence& SCS2)
3712 {
3713   // Standard conversion sequence S1 is a better conversion sequence
3714   // than standard conversion sequence S2 if (C++ 13.3.3.2p3):
3715 
3716   //  -- S1 is a proper subsequence of S2 (comparing the conversion
3717   //     sequences in the canonical form defined by 13.3.3.1.1,
3718   //     excluding any Lvalue Transformation; the identity conversion
3719   //     sequence is considered to be a subsequence of any
3720   //     non-identity conversion sequence) or, if not that,
3721   if (ImplicitConversionSequence::CompareKind CK
3722         = compareStandardConversionSubsets(S.Context, SCS1, SCS2))
3723     return CK;
3724 
3725   //  -- the rank of S1 is better than the rank of S2 (by the rules
3726   //     defined below), or, if not that,
3727   ImplicitConversionRank Rank1 = SCS1.getRank();
3728   ImplicitConversionRank Rank2 = SCS2.getRank();
3729   if (Rank1 < Rank2)
3730     return ImplicitConversionSequence::Better;
3731   else if (Rank2 < Rank1)
3732     return ImplicitConversionSequence::Worse;
3733 
3734   // (C++ 13.3.3.2p4): Two conversion sequences with the same rank
3735   // are indistinguishable unless one of the following rules
3736   // applies:
3737 
3738   //   A conversion that is not a conversion of a pointer, or
3739   //   pointer to member, to bool is better than another conversion
3740   //   that is such a conversion.
3741   if (SCS1.isPointerConversionToBool() != SCS2.isPointerConversionToBool())
3742     return SCS2.isPointerConversionToBool()
3743              ? ImplicitConversionSequence::Better
3744              : ImplicitConversionSequence::Worse;
3745 
3746   // C++ [over.ics.rank]p4b2:
3747   //
3748   //   If class B is derived directly or indirectly from class A,
3749   //   conversion of B* to A* is better than conversion of B* to
3750   //   void*, and conversion of A* to void* is better than conversion
3751   //   of B* to void*.
3752   bool SCS1ConvertsToVoid
3753     = SCS1.isPointerConversionToVoidPointer(S.Context);
3754   bool SCS2ConvertsToVoid
3755     = SCS2.isPointerConversionToVoidPointer(S.Context);
3756   if (SCS1ConvertsToVoid != SCS2ConvertsToVoid) {
3757     // Exactly one of the conversion sequences is a conversion to
3758     // a void pointer; it's the worse conversion.
3759     return SCS2ConvertsToVoid ? ImplicitConversionSequence::Better
3760                               : ImplicitConversionSequence::Worse;
3761   } else if (!SCS1ConvertsToVoid && !SCS2ConvertsToVoid) {
3762     // Neither conversion sequence converts to a void pointer; compare
3763     // their derived-to-base conversions.
3764     if (ImplicitConversionSequence::CompareKind DerivedCK
3765           = CompareDerivedToBaseConversions(S, Loc, SCS1, SCS2))
3766       return DerivedCK;
3767   } else if (SCS1ConvertsToVoid && SCS2ConvertsToVoid &&
3768              !S.Context.hasSameType(SCS1.getFromType(), SCS2.getFromType())) {
3769     // Both conversion sequences are conversions to void
3770     // pointers. Compare the source types to determine if there's an
3771     // inheritance relationship in their sources.
3772     QualType FromType1 = SCS1.getFromType();
3773     QualType FromType2 = SCS2.getFromType();
3774 
3775     // Adjust the types we're converting from via the array-to-pointer
3776     // conversion, if we need to.
3777     if (SCS1.First == ICK_Array_To_Pointer)
3778       FromType1 = S.Context.getArrayDecayedType(FromType1);
3779     if (SCS2.First == ICK_Array_To_Pointer)
3780       FromType2 = S.Context.getArrayDecayedType(FromType2);
3781 
3782     QualType FromPointee1 = FromType1->getPointeeType().getUnqualifiedType();
3783     QualType FromPointee2 = FromType2->getPointeeType().getUnqualifiedType();
3784 
3785     if (S.IsDerivedFrom(Loc, FromPointee2, FromPointee1))
3786       return ImplicitConversionSequence::Better;
3787     else if (S.IsDerivedFrom(Loc, FromPointee1, FromPointee2))
3788       return ImplicitConversionSequence::Worse;
3789 
3790     // Objective-C++: If one interface is more specific than the
3791     // other, it is the better one.
3792     const ObjCObjectPointerType* FromObjCPtr1
3793       = FromType1->getAs<ObjCObjectPointerType>();
3794     const ObjCObjectPointerType* FromObjCPtr2
3795       = FromType2->getAs<ObjCObjectPointerType>();
3796     if (FromObjCPtr1 && FromObjCPtr2) {
3797       bool AssignLeft = S.Context.canAssignObjCInterfaces(FromObjCPtr1,
3798                                                           FromObjCPtr2);
3799       bool AssignRight = S.Context.canAssignObjCInterfaces(FromObjCPtr2,
3800                                                            FromObjCPtr1);
3801       if (AssignLeft != AssignRight) {
3802         return AssignLeft? ImplicitConversionSequence::Better
3803                          : ImplicitConversionSequence::Worse;
3804       }
3805     }
3806   }
3807 
3808   // Compare based on qualification conversions (C++ 13.3.3.2p3,
3809   // bullet 3).
3810   if (ImplicitConversionSequence::CompareKind QualCK
3811         = CompareQualificationConversions(S, SCS1, SCS2))
3812     return QualCK;
3813 
3814   if (SCS1.ReferenceBinding && SCS2.ReferenceBinding) {
3815     // Check for a better reference binding based on the kind of bindings.
3816     if (isBetterReferenceBindingKind(SCS1, SCS2))
3817       return ImplicitConversionSequence::Better;
3818     else if (isBetterReferenceBindingKind(SCS2, SCS1))
3819       return ImplicitConversionSequence::Worse;
3820 
3821     // C++ [over.ics.rank]p3b4:
3822     //   -- S1 and S2 are reference bindings (8.5.3), and the types to
3823     //      which the references refer are the same type except for
3824     //      top-level cv-qualifiers, and the type to which the reference
3825     //      initialized by S2 refers is more cv-qualified than the type
3826     //      to which the reference initialized by S1 refers.
3827     QualType T1 = SCS1.getToType(2);
3828     QualType T2 = SCS2.getToType(2);
3829     T1 = S.Context.getCanonicalType(T1);
3830     T2 = S.Context.getCanonicalType(T2);
3831     Qualifiers T1Quals, T2Quals;
3832     QualType UnqualT1 = S.Context.getUnqualifiedArrayType(T1, T1Quals);
3833     QualType UnqualT2 = S.Context.getUnqualifiedArrayType(T2, T2Quals);
3834     if (UnqualT1 == UnqualT2) {
3835       // Objective-C++ ARC: If the references refer to objects with different
3836       // lifetimes, prefer bindings that don't change lifetime.
3837       if (SCS1.ObjCLifetimeConversionBinding !=
3838                                           SCS2.ObjCLifetimeConversionBinding) {
3839         return SCS1.ObjCLifetimeConversionBinding
3840                                            ? ImplicitConversionSequence::Worse
3841                                            : ImplicitConversionSequence::Better;
3842       }
3843 
3844       // If the type is an array type, promote the element qualifiers to the
3845       // type for comparison.
3846       if (isa<ArrayType>(T1) && T1Quals)
3847         T1 = S.Context.getQualifiedType(UnqualT1, T1Quals);
3848       if (isa<ArrayType>(T2) && T2Quals)
3849         T2 = S.Context.getQualifiedType(UnqualT2, T2Quals);
3850       if (T2.isMoreQualifiedThan(T1))
3851         return ImplicitConversionSequence::Better;
3852       else if (T1.isMoreQualifiedThan(T2))
3853         return ImplicitConversionSequence::Worse;
3854     }
3855   }
3856 
3857   // In Microsoft mode, prefer an integral conversion to a
3858   // floating-to-integral conversion if the integral conversion
3859   // is between types of the same size.
3860   // For example:
3861   // void f(float);
3862   // void f(int);
3863   // int main {
3864   //    long a;
3865   //    f(a);
3866   // }
3867   // Here, MSVC will call f(int) instead of generating a compile error
3868   // as clang will do in standard mode.
3869   if (S.getLangOpts().MSVCCompat && SCS1.Second == ICK_Integral_Conversion &&
3870       SCS2.Second == ICK_Floating_Integral &&
3871       S.Context.getTypeSize(SCS1.getFromType()) ==
3872           S.Context.getTypeSize(SCS1.getToType(2)))
3873     return ImplicitConversionSequence::Better;
3874 
3875   return ImplicitConversionSequence::Indistinguishable;
3876 }
3877 
3878 /// CompareQualificationConversions - Compares two standard conversion
3879 /// sequences to determine whether they can be ranked based on their
3880 /// qualification conversions (C++ 13.3.3.2p3 bullet 3).
3881 static ImplicitConversionSequence::CompareKind
3882 CompareQualificationConversions(Sema &S,
3883                                 const StandardConversionSequence& SCS1,
3884                                 const StandardConversionSequence& SCS2) {
3885   // C++ 13.3.3.2p3:
3886   //  -- S1 and S2 differ only in their qualification conversion and
3887   //     yield similar types T1 and T2 (C++ 4.4), respectively, and the
3888   //     cv-qualification signature of type T1 is a proper subset of
3889   //     the cv-qualification signature of type T2, and S1 is not the
3890   //     deprecated string literal array-to-pointer conversion (4.2).
3891   if (SCS1.First != SCS2.First || SCS1.Second != SCS2.Second ||
3892       SCS1.Third != SCS2.Third || SCS1.Third != ICK_Qualification)
3893     return ImplicitConversionSequence::Indistinguishable;
3894 
3895   // FIXME: the example in the standard doesn't use a qualification
3896   // conversion (!)
3897   QualType T1 = SCS1.getToType(2);
3898   QualType T2 = SCS2.getToType(2);
3899   T1 = S.Context.getCanonicalType(T1);
3900   T2 = S.Context.getCanonicalType(T2);
3901   Qualifiers T1Quals, T2Quals;
3902   QualType UnqualT1 = S.Context.getUnqualifiedArrayType(T1, T1Quals);
3903   QualType UnqualT2 = S.Context.getUnqualifiedArrayType(T2, T2Quals);
3904 
3905   // If the types are the same, we won't learn anything by unwrapped
3906   // them.
3907   if (UnqualT1 == UnqualT2)
3908     return ImplicitConversionSequence::Indistinguishable;
3909 
3910   // If the type is an array type, promote the element qualifiers to the type
3911   // for comparison.
3912   if (isa<ArrayType>(T1) && T1Quals)
3913     T1 = S.Context.getQualifiedType(UnqualT1, T1Quals);
3914   if (isa<ArrayType>(T2) && T2Quals)
3915     T2 = S.Context.getQualifiedType(UnqualT2, T2Quals);
3916 
3917   ImplicitConversionSequence::CompareKind Result
3918     = ImplicitConversionSequence::Indistinguishable;
3919 
3920   // Objective-C++ ARC:
3921   //   Prefer qualification conversions not involving a change in lifetime
3922   //   to qualification conversions that do not change lifetime.
3923   if (SCS1.QualificationIncludesObjCLifetime !=
3924                                       SCS2.QualificationIncludesObjCLifetime) {
3925     Result = SCS1.QualificationIncludesObjCLifetime
3926                ? ImplicitConversionSequence::Worse
3927                : ImplicitConversionSequence::Better;
3928   }
3929 
3930   while (S.Context.UnwrapSimilarPointerTypes(T1, T2)) {
3931     // Within each iteration of the loop, we check the qualifiers to
3932     // determine if this still looks like a qualification
3933     // conversion. Then, if all is well, we unwrap one more level of
3934     // pointers or pointers-to-members and do it all again
3935     // until there are no more pointers or pointers-to-members left
3936     // to unwrap. This essentially mimics what
3937     // IsQualificationConversion does, but here we're checking for a
3938     // strict subset of qualifiers.
3939     if (T1.getCVRQualifiers() == T2.getCVRQualifiers())
3940       // The qualifiers are the same, so this doesn't tell us anything
3941       // about how the sequences rank.
3942       ;
3943     else if (T2.isMoreQualifiedThan(T1)) {
3944       // T1 has fewer qualifiers, so it could be the better sequence.
3945       if (Result == ImplicitConversionSequence::Worse)
3946         // Neither has qualifiers that are a subset of the other's
3947         // qualifiers.
3948         return ImplicitConversionSequence::Indistinguishable;
3949 
3950       Result = ImplicitConversionSequence::Better;
3951     } else if (T1.isMoreQualifiedThan(T2)) {
3952       // T2 has fewer qualifiers, so it could be the better sequence.
3953       if (Result == ImplicitConversionSequence::Better)
3954         // Neither has qualifiers that are a subset of the other's
3955         // qualifiers.
3956         return ImplicitConversionSequence::Indistinguishable;
3957 
3958       Result = ImplicitConversionSequence::Worse;
3959     } else {
3960       // Qualifiers are disjoint.
3961       return ImplicitConversionSequence::Indistinguishable;
3962     }
3963 
3964     // If the types after this point are equivalent, we're done.
3965     if (S.Context.hasSameUnqualifiedType(T1, T2))
3966       break;
3967   }
3968 
3969   // Check that the winning standard conversion sequence isn't using
3970   // the deprecated string literal array to pointer conversion.
3971   switch (Result) {
3972   case ImplicitConversionSequence::Better:
3973     if (SCS1.DeprecatedStringLiteralToCharPtr)
3974       Result = ImplicitConversionSequence::Indistinguishable;
3975     break;
3976 
3977   case ImplicitConversionSequence::Indistinguishable:
3978     break;
3979 
3980   case ImplicitConversionSequence::Worse:
3981     if (SCS2.DeprecatedStringLiteralToCharPtr)
3982       Result = ImplicitConversionSequence::Indistinguishable;
3983     break;
3984   }
3985 
3986   return Result;
3987 }
3988 
3989 /// CompareDerivedToBaseConversions - Compares two standard conversion
3990 /// sequences to determine whether they can be ranked based on their
3991 /// various kinds of derived-to-base conversions (C++
3992 /// [over.ics.rank]p4b3).  As part of these checks, we also look at
3993 /// conversions between Objective-C interface types.
3994 static ImplicitConversionSequence::CompareKind
3995 CompareDerivedToBaseConversions(Sema &S, SourceLocation Loc,
3996                                 const StandardConversionSequence& SCS1,
3997                                 const StandardConversionSequence& SCS2) {
3998   QualType FromType1 = SCS1.getFromType();
3999   QualType ToType1 = SCS1.getToType(1);
4000   QualType FromType2 = SCS2.getFromType();
4001   QualType ToType2 = SCS2.getToType(1);
4002 
4003   // Adjust the types we're converting from via the array-to-pointer
4004   // conversion, if we need to.
4005   if (SCS1.First == ICK_Array_To_Pointer)
4006     FromType1 = S.Context.getArrayDecayedType(FromType1);
4007   if (SCS2.First == ICK_Array_To_Pointer)
4008     FromType2 = S.Context.getArrayDecayedType(FromType2);
4009 
4010   // Canonicalize all of the types.
4011   FromType1 = S.Context.getCanonicalType(FromType1);
4012   ToType1 = S.Context.getCanonicalType(ToType1);
4013   FromType2 = S.Context.getCanonicalType(FromType2);
4014   ToType2 = S.Context.getCanonicalType(ToType2);
4015 
4016   // C++ [over.ics.rank]p4b3:
4017   //
4018   //   If class B is derived directly or indirectly from class A and
4019   //   class C is derived directly or indirectly from B,
4020   //
4021   // Compare based on pointer conversions.
4022   if (SCS1.Second == ICK_Pointer_Conversion &&
4023       SCS2.Second == ICK_Pointer_Conversion &&
4024       /*FIXME: Remove if Objective-C id conversions get their own rank*/
4025       FromType1->isPointerType() && FromType2->isPointerType() &&
4026       ToType1->isPointerType() && ToType2->isPointerType()) {
4027     QualType FromPointee1
4028       = FromType1->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
4029     QualType ToPointee1
4030       = ToType1->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
4031     QualType FromPointee2
4032       = FromType2->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
4033     QualType ToPointee2
4034       = ToType2->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
4035 
4036     //   -- conversion of C* to B* is better than conversion of C* to A*,
4037     if (FromPointee1 == FromPointee2 && ToPointee1 != ToPointee2) {
4038       if (S.IsDerivedFrom(Loc, ToPointee1, ToPointee2))
4039         return ImplicitConversionSequence::Better;
4040       else if (S.IsDerivedFrom(Loc, ToPointee2, ToPointee1))
4041         return ImplicitConversionSequence::Worse;
4042     }
4043 
4044     //   -- conversion of B* to A* is better than conversion of C* to A*,
4045     if (FromPointee1 != FromPointee2 && ToPointee1 == ToPointee2) {
4046       if (S.IsDerivedFrom(Loc, FromPointee2, FromPointee1))
4047         return ImplicitConversionSequence::Better;
4048       else if (S.IsDerivedFrom(Loc, FromPointee1, FromPointee2))
4049         return ImplicitConversionSequence::Worse;
4050     }
4051   } else if (SCS1.Second == ICK_Pointer_Conversion &&
4052              SCS2.Second == ICK_Pointer_Conversion) {
4053     const ObjCObjectPointerType *FromPtr1
4054       = FromType1->getAs<ObjCObjectPointerType>();
4055     const ObjCObjectPointerType *FromPtr2
4056       = FromType2->getAs<ObjCObjectPointerType>();
4057     const ObjCObjectPointerType *ToPtr1
4058       = ToType1->getAs<ObjCObjectPointerType>();
4059     const ObjCObjectPointerType *ToPtr2
4060       = ToType2->getAs<ObjCObjectPointerType>();
4061 
4062     if (FromPtr1 && FromPtr2 && ToPtr1 && ToPtr2) {
4063       // Apply the same conversion ranking rules for Objective-C pointer types
4064       // that we do for C++ pointers to class types. However, we employ the
4065       // Objective-C pseudo-subtyping relationship used for assignment of
4066       // Objective-C pointer types.
4067       bool FromAssignLeft
4068         = S.Context.canAssignObjCInterfaces(FromPtr1, FromPtr2);
4069       bool FromAssignRight
4070         = S.Context.canAssignObjCInterfaces(FromPtr2, FromPtr1);
4071       bool ToAssignLeft
4072         = S.Context.canAssignObjCInterfaces(ToPtr1, ToPtr2);
4073       bool ToAssignRight
4074         = S.Context.canAssignObjCInterfaces(ToPtr2, ToPtr1);
4075 
4076       // A conversion to an a non-id object pointer type or qualified 'id'
4077       // type is better than a conversion to 'id'.
4078       if (ToPtr1->isObjCIdType() &&
4079           (ToPtr2->isObjCQualifiedIdType() || ToPtr2->getInterfaceDecl()))
4080         return ImplicitConversionSequence::Worse;
4081       if (ToPtr2->isObjCIdType() &&
4082           (ToPtr1->isObjCQualifiedIdType() || ToPtr1->getInterfaceDecl()))
4083         return ImplicitConversionSequence::Better;
4084 
4085       // A conversion to a non-id object pointer type is better than a
4086       // conversion to a qualified 'id' type
4087       if (ToPtr1->isObjCQualifiedIdType() && ToPtr2->getInterfaceDecl())
4088         return ImplicitConversionSequence::Worse;
4089       if (ToPtr2->isObjCQualifiedIdType() && ToPtr1->getInterfaceDecl())
4090         return ImplicitConversionSequence::Better;
4091 
4092       // A conversion to an a non-Class object pointer type or qualified 'Class'
4093       // type is better than a conversion to 'Class'.
4094       if (ToPtr1->isObjCClassType() &&
4095           (ToPtr2->isObjCQualifiedClassType() || ToPtr2->getInterfaceDecl()))
4096         return ImplicitConversionSequence::Worse;
4097       if (ToPtr2->isObjCClassType() &&
4098           (ToPtr1->isObjCQualifiedClassType() || ToPtr1->getInterfaceDecl()))
4099         return ImplicitConversionSequence::Better;
4100 
4101       // A conversion to a non-Class object pointer type is better than a
4102       // conversion to a qualified 'Class' type.
4103       if (ToPtr1->isObjCQualifiedClassType() && ToPtr2->getInterfaceDecl())
4104         return ImplicitConversionSequence::Worse;
4105       if (ToPtr2->isObjCQualifiedClassType() && ToPtr1->getInterfaceDecl())
4106         return ImplicitConversionSequence::Better;
4107 
4108       //   -- "conversion of C* to B* is better than conversion of C* to A*,"
4109       if (S.Context.hasSameType(FromType1, FromType2) &&
4110           !FromPtr1->isObjCIdType() && !FromPtr1->isObjCClassType() &&
4111           (ToAssignLeft != ToAssignRight)) {
4112         if (FromPtr1->isSpecialized()) {
4113           // "conversion of B<A> * to B * is better than conversion of B * to
4114           // C *.
4115           bool IsFirstSame =
4116               FromPtr1->getInterfaceDecl() == ToPtr1->getInterfaceDecl();
4117           bool IsSecondSame =
4118               FromPtr1->getInterfaceDecl() == ToPtr2->getInterfaceDecl();
4119           if (IsFirstSame) {
4120             if (!IsSecondSame)
4121               return ImplicitConversionSequence::Better;
4122           } else if (IsSecondSame)
4123             return ImplicitConversionSequence::Worse;
4124         }
4125         return ToAssignLeft? ImplicitConversionSequence::Worse
4126                            : ImplicitConversionSequence::Better;
4127       }
4128 
4129       //   -- "conversion of B* to A* is better than conversion of C* to A*,"
4130       if (S.Context.hasSameUnqualifiedType(ToType1, ToType2) &&
4131           (FromAssignLeft != FromAssignRight))
4132         return FromAssignLeft? ImplicitConversionSequence::Better
4133         : ImplicitConversionSequence::Worse;
4134     }
4135   }
4136 
4137   // Ranking of member-pointer types.
4138   if (SCS1.Second == ICK_Pointer_Member && SCS2.Second == ICK_Pointer_Member &&
4139       FromType1->isMemberPointerType() && FromType2->isMemberPointerType() &&
4140       ToType1->isMemberPointerType() && ToType2->isMemberPointerType()) {
4141     const MemberPointerType * FromMemPointer1 =
4142                                         FromType1->getAs<MemberPointerType>();
4143     const MemberPointerType * ToMemPointer1 =
4144                                           ToType1->getAs<MemberPointerType>();
4145     const MemberPointerType * FromMemPointer2 =
4146                                           FromType2->getAs<MemberPointerType>();
4147     const MemberPointerType * ToMemPointer2 =
4148                                           ToType2->getAs<MemberPointerType>();
4149     const Type *FromPointeeType1 = FromMemPointer1->getClass();
4150     const Type *ToPointeeType1 = ToMemPointer1->getClass();
4151     const Type *FromPointeeType2 = FromMemPointer2->getClass();
4152     const Type *ToPointeeType2 = ToMemPointer2->getClass();
4153     QualType FromPointee1 = QualType(FromPointeeType1, 0).getUnqualifiedType();
4154     QualType ToPointee1 = QualType(ToPointeeType1, 0).getUnqualifiedType();
4155     QualType FromPointee2 = QualType(FromPointeeType2, 0).getUnqualifiedType();
4156     QualType ToPointee2 = QualType(ToPointeeType2, 0).getUnqualifiedType();
4157     // conversion of A::* to B::* is better than conversion of A::* to C::*,
4158     if (FromPointee1 == FromPointee2 && ToPointee1 != ToPointee2) {
4159       if (S.IsDerivedFrom(Loc, ToPointee1, ToPointee2))
4160         return ImplicitConversionSequence::Worse;
4161       else if (S.IsDerivedFrom(Loc, ToPointee2, ToPointee1))
4162         return ImplicitConversionSequence::Better;
4163     }
4164     // conversion of B::* to C::* is better than conversion of A::* to C::*
4165     if (ToPointee1 == ToPointee2 && FromPointee1 != FromPointee2) {
4166       if (S.IsDerivedFrom(Loc, FromPointee1, FromPointee2))
4167         return ImplicitConversionSequence::Better;
4168       else if (S.IsDerivedFrom(Loc, FromPointee2, FromPointee1))
4169         return ImplicitConversionSequence::Worse;
4170     }
4171   }
4172 
4173   if (SCS1.Second == ICK_Derived_To_Base) {
4174     //   -- conversion of C to B is better than conversion of C to A,
4175     //   -- binding of an expression of type C to a reference of type
4176     //      B& is better than binding an expression of type C to a
4177     //      reference of type A&,
4178     if (S.Context.hasSameUnqualifiedType(FromType1, FromType2) &&
4179         !S.Context.hasSameUnqualifiedType(ToType1, ToType2)) {
4180       if (S.IsDerivedFrom(Loc, ToType1, ToType2))
4181         return ImplicitConversionSequence::Better;
4182       else if (S.IsDerivedFrom(Loc, ToType2, ToType1))
4183         return ImplicitConversionSequence::Worse;
4184     }
4185 
4186     //   -- conversion of B to A is better than conversion of C to A.
4187     //   -- binding of an expression of type B to a reference of type
4188     //      A& is better than binding an expression of type C to a
4189     //      reference of type A&,
4190     if (!S.Context.hasSameUnqualifiedType(FromType1, FromType2) &&
4191         S.Context.hasSameUnqualifiedType(ToType1, ToType2)) {
4192       if (S.IsDerivedFrom(Loc, FromType2, FromType1))
4193         return ImplicitConversionSequence::Better;
4194       else if (S.IsDerivedFrom(Loc, FromType1, FromType2))
4195         return ImplicitConversionSequence::Worse;
4196     }
4197   }
4198 
4199   return ImplicitConversionSequence::Indistinguishable;
4200 }
4201 
4202 /// \brief Determine whether the given type is valid, e.g., it is not an invalid
4203 /// C++ class.
4204 static bool isTypeValid(QualType T) {
4205   if (CXXRecordDecl *Record = T->getAsCXXRecordDecl())
4206     return !Record->isInvalidDecl();
4207 
4208   return true;
4209 }
4210 
4211 /// CompareReferenceRelationship - Compare the two types T1 and T2 to
4212 /// determine whether they are reference-related,
4213 /// reference-compatible, reference-compatible with added
4214 /// qualification, or incompatible, for use in C++ initialization by
4215 /// reference (C++ [dcl.ref.init]p4). Neither type can be a reference
4216 /// type, and the first type (T1) is the pointee type of the reference
4217 /// type being initialized.
4218 Sema::ReferenceCompareResult
4219 Sema::CompareReferenceRelationship(SourceLocation Loc,
4220                                    QualType OrigT1, QualType OrigT2,
4221                                    bool &DerivedToBase,
4222                                    bool &ObjCConversion,
4223                                    bool &ObjCLifetimeConversion) {
4224   assert(!OrigT1->isReferenceType() &&
4225     "T1 must be the pointee type of the reference type");
4226   assert(!OrigT2->isReferenceType() && "T2 cannot be a reference type");
4227 
4228   QualType T1 = Context.getCanonicalType(OrigT1);
4229   QualType T2 = Context.getCanonicalType(OrigT2);
4230   Qualifiers T1Quals, T2Quals;
4231   QualType UnqualT1 = Context.getUnqualifiedArrayType(T1, T1Quals);
4232   QualType UnqualT2 = Context.getUnqualifiedArrayType(T2, T2Quals);
4233 
4234   // C++ [dcl.init.ref]p4:
4235   //   Given types "cv1 T1" and "cv2 T2," "cv1 T1" is
4236   //   reference-related to "cv2 T2" if T1 is the same type as T2, or
4237   //   T1 is a base class of T2.
4238   DerivedToBase = false;
4239   ObjCConversion = false;
4240   ObjCLifetimeConversion = false;
4241   QualType ConvertedT2;
4242   if (UnqualT1 == UnqualT2) {
4243     // Nothing to do.
4244   } else if (isCompleteType(Loc, OrigT2) &&
4245              isTypeValid(UnqualT1) && isTypeValid(UnqualT2) &&
4246              IsDerivedFrom(Loc, UnqualT2, UnqualT1))
4247     DerivedToBase = true;
4248   else if (UnqualT1->isObjCObjectOrInterfaceType() &&
4249            UnqualT2->isObjCObjectOrInterfaceType() &&
4250            Context.canBindObjCObjectType(UnqualT1, UnqualT2))
4251     ObjCConversion = true;
4252   else if (UnqualT2->isFunctionType() &&
4253            IsFunctionConversion(UnqualT2, UnqualT1, ConvertedT2))
4254     // C++1z [dcl.init.ref]p4:
4255     //   cv1 T1" is reference-compatible with "cv2 T2" if [...] T2 is "noexcept
4256     //   function" and T1 is "function"
4257     //
4258     // We extend this to also apply to 'noreturn', so allow any function
4259     // conversion between function types.
4260     return Ref_Compatible;
4261   else
4262     return Ref_Incompatible;
4263 
4264   // At this point, we know that T1 and T2 are reference-related (at
4265   // least).
4266 
4267   // If the type is an array type, promote the element qualifiers to the type
4268   // for comparison.
4269   if (isa<ArrayType>(T1) && T1Quals)
4270     T1 = Context.getQualifiedType(UnqualT1, T1Quals);
4271   if (isa<ArrayType>(T2) && T2Quals)
4272     T2 = Context.getQualifiedType(UnqualT2, T2Quals);
4273 
4274   // C++ [dcl.init.ref]p4:
4275   //   "cv1 T1" is reference-compatible with "cv2 T2" if T1 is
4276   //   reference-related to T2 and cv1 is the same cv-qualification
4277   //   as, or greater cv-qualification than, cv2. For purposes of
4278   //   overload resolution, cases for which cv1 is greater
4279   //   cv-qualification than cv2 are identified as
4280   //   reference-compatible with added qualification (see 13.3.3.2).
4281   //
4282   // Note that we also require equivalence of Objective-C GC and address-space
4283   // qualifiers when performing these computations, so that e.g., an int in
4284   // address space 1 is not reference-compatible with an int in address
4285   // space 2.
4286   if (T1Quals.getObjCLifetime() != T2Quals.getObjCLifetime() &&
4287       T1Quals.compatiblyIncludesObjCLifetime(T2Quals)) {
4288     if (isNonTrivialObjCLifetimeConversion(T2Quals, T1Quals))
4289       ObjCLifetimeConversion = true;
4290 
4291     T1Quals.removeObjCLifetime();
4292     T2Quals.removeObjCLifetime();
4293   }
4294 
4295   // MS compiler ignores __unaligned qualifier for references; do the same.
4296   T1Quals.removeUnaligned();
4297   T2Quals.removeUnaligned();
4298 
4299   if (T1Quals.compatiblyIncludes(T2Quals))
4300     return Ref_Compatible;
4301   else
4302     return Ref_Related;
4303 }
4304 
4305 /// \brief Look for a user-defined conversion to a value reference-compatible
4306 ///        with DeclType. Return true if something definite is found.
4307 static bool
4308 FindConversionForRefInit(Sema &S, ImplicitConversionSequence &ICS,
4309                          QualType DeclType, SourceLocation DeclLoc,
4310                          Expr *Init, QualType T2, bool AllowRvalues,
4311                          bool AllowExplicit) {
4312   assert(T2->isRecordType() && "Can only find conversions of record types.");
4313   CXXRecordDecl *T2RecordDecl
4314     = dyn_cast<CXXRecordDecl>(T2->getAs<RecordType>()->getDecl());
4315 
4316   OverloadCandidateSet CandidateSet(
4317       DeclLoc, OverloadCandidateSet::CSK_InitByUserDefinedConversion);
4318   const auto &Conversions = T2RecordDecl->getVisibleConversionFunctions();
4319   for (auto I = Conversions.begin(), E = Conversions.end(); I != E; ++I) {
4320     NamedDecl *D = *I;
4321     CXXRecordDecl *ActingDC = cast<CXXRecordDecl>(D->getDeclContext());
4322     if (isa<UsingShadowDecl>(D))
4323       D = cast<UsingShadowDecl>(D)->getTargetDecl();
4324 
4325     FunctionTemplateDecl *ConvTemplate
4326       = dyn_cast<FunctionTemplateDecl>(D);
4327     CXXConversionDecl *Conv;
4328     if (ConvTemplate)
4329       Conv = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
4330     else
4331       Conv = cast<CXXConversionDecl>(D);
4332 
4333     // If this is an explicit conversion, and we're not allowed to consider
4334     // explicit conversions, skip it.
4335     if (!AllowExplicit && Conv->isExplicit())
4336       continue;
4337 
4338     if (AllowRvalues) {
4339       bool DerivedToBase = false;
4340       bool ObjCConversion = false;
4341       bool ObjCLifetimeConversion = false;
4342 
4343       // If we are initializing an rvalue reference, don't permit conversion
4344       // functions that return lvalues.
4345       if (!ConvTemplate && DeclType->isRValueReferenceType()) {
4346         const ReferenceType *RefType
4347           = Conv->getConversionType()->getAs<LValueReferenceType>();
4348         if (RefType && !RefType->getPointeeType()->isFunctionType())
4349           continue;
4350       }
4351 
4352       if (!ConvTemplate &&
4353           S.CompareReferenceRelationship(
4354             DeclLoc,
4355             Conv->getConversionType().getNonReferenceType()
4356               .getUnqualifiedType(),
4357             DeclType.getNonReferenceType().getUnqualifiedType(),
4358             DerivedToBase, ObjCConversion, ObjCLifetimeConversion) ==
4359           Sema::Ref_Incompatible)
4360         continue;
4361     } else {
4362       // If the conversion function doesn't return a reference type,
4363       // it can't be considered for this conversion. An rvalue reference
4364       // is only acceptable if its referencee is a function type.
4365 
4366       const ReferenceType *RefType =
4367         Conv->getConversionType()->getAs<ReferenceType>();
4368       if (!RefType ||
4369           (!RefType->isLValueReferenceType() &&
4370            !RefType->getPointeeType()->isFunctionType()))
4371         continue;
4372     }
4373 
4374     if (ConvTemplate)
4375       S.AddTemplateConversionCandidate(ConvTemplate, I.getPair(), ActingDC,
4376                                        Init, DeclType, CandidateSet,
4377                                        /*AllowObjCConversionOnExplicit=*/false);
4378     else
4379       S.AddConversionCandidate(Conv, I.getPair(), ActingDC, Init,
4380                                DeclType, CandidateSet,
4381                                /*AllowObjCConversionOnExplicit=*/false);
4382   }
4383 
4384   bool HadMultipleCandidates = (CandidateSet.size() > 1);
4385 
4386   OverloadCandidateSet::iterator Best;
4387   switch (CandidateSet.BestViableFunction(S, DeclLoc, Best)) {
4388   case OR_Success:
4389     // C++ [over.ics.ref]p1:
4390     //
4391     //   [...] If the parameter binds directly to the result of
4392     //   applying a conversion function to the argument
4393     //   expression, the implicit conversion sequence is a
4394     //   user-defined conversion sequence (13.3.3.1.2), with the
4395     //   second standard conversion sequence either an identity
4396     //   conversion or, if the conversion function returns an
4397     //   entity of a type that is a derived class of the parameter
4398     //   type, a derived-to-base Conversion.
4399     if (!Best->FinalConversion.DirectBinding)
4400       return false;
4401 
4402     ICS.setUserDefined();
4403     ICS.UserDefined.Before = Best->Conversions[0].Standard;
4404     ICS.UserDefined.After = Best->FinalConversion;
4405     ICS.UserDefined.HadMultipleCandidates = HadMultipleCandidates;
4406     ICS.UserDefined.ConversionFunction = Best->Function;
4407     ICS.UserDefined.FoundConversionFunction = Best->FoundDecl;
4408     ICS.UserDefined.EllipsisConversion = false;
4409     assert(ICS.UserDefined.After.ReferenceBinding &&
4410            ICS.UserDefined.After.DirectBinding &&
4411            "Expected a direct reference binding!");
4412     return true;
4413 
4414   case OR_Ambiguous:
4415     ICS.setAmbiguous();
4416     for (OverloadCandidateSet::iterator Cand = CandidateSet.begin();
4417          Cand != CandidateSet.end(); ++Cand)
4418       if (Cand->Viable)
4419         ICS.Ambiguous.addConversion(Cand->FoundDecl, Cand->Function);
4420     return true;
4421 
4422   case OR_No_Viable_Function:
4423   case OR_Deleted:
4424     // There was no suitable conversion, or we found a deleted
4425     // conversion; continue with other checks.
4426     return false;
4427   }
4428 
4429   llvm_unreachable("Invalid OverloadResult!");
4430 }
4431 
4432 /// \brief Compute an implicit conversion sequence for reference
4433 /// initialization.
4434 static ImplicitConversionSequence
4435 TryReferenceInit(Sema &S, Expr *Init, QualType DeclType,
4436                  SourceLocation DeclLoc,
4437                  bool SuppressUserConversions,
4438                  bool AllowExplicit) {
4439   assert(DeclType->isReferenceType() && "Reference init needs a reference");
4440 
4441   // Most paths end in a failed conversion.
4442   ImplicitConversionSequence ICS;
4443   ICS.setBad(BadConversionSequence::no_conversion, Init, DeclType);
4444 
4445   QualType T1 = DeclType->getAs<ReferenceType>()->getPointeeType();
4446   QualType T2 = Init->getType();
4447 
4448   // If the initializer is the address of an overloaded function, try
4449   // to resolve the overloaded function. If all goes well, T2 is the
4450   // type of the resulting function.
4451   if (S.Context.getCanonicalType(T2) == S.Context.OverloadTy) {
4452     DeclAccessPair Found;
4453     if (FunctionDecl *Fn = S.ResolveAddressOfOverloadedFunction(Init, DeclType,
4454                                                                 false, Found))
4455       T2 = Fn->getType();
4456   }
4457 
4458   // Compute some basic properties of the types and the initializer.
4459   bool isRValRef = DeclType->isRValueReferenceType();
4460   bool DerivedToBase = false;
4461   bool ObjCConversion = false;
4462   bool ObjCLifetimeConversion = false;
4463   Expr::Classification InitCategory = Init->Classify(S.Context);
4464   Sema::ReferenceCompareResult RefRelationship
4465     = S.CompareReferenceRelationship(DeclLoc, T1, T2, DerivedToBase,
4466                                      ObjCConversion, ObjCLifetimeConversion);
4467 
4468 
4469   // C++0x [dcl.init.ref]p5:
4470   //   A reference to type "cv1 T1" is initialized by an expression
4471   //   of type "cv2 T2" as follows:
4472 
4473   //     -- If reference is an lvalue reference and the initializer expression
4474   if (!isRValRef) {
4475     //     -- is an lvalue (but is not a bit-field), and "cv1 T1" is
4476     //        reference-compatible with "cv2 T2," or
4477     //
4478     // Per C++ [over.ics.ref]p4, we don't check the bit-field property here.
4479     if (InitCategory.isLValue() && RefRelationship == Sema::Ref_Compatible) {
4480       // C++ [over.ics.ref]p1:
4481       //   When a parameter of reference type binds directly (8.5.3)
4482       //   to an argument expression, the implicit conversion sequence
4483       //   is the identity conversion, unless the argument expression
4484       //   has a type that is a derived class of the parameter type,
4485       //   in which case the implicit conversion sequence is a
4486       //   derived-to-base Conversion (13.3.3.1).
4487       ICS.setStandard();
4488       ICS.Standard.First = ICK_Identity;
4489       ICS.Standard.Second = DerivedToBase? ICK_Derived_To_Base
4490                          : ObjCConversion? ICK_Compatible_Conversion
4491                          : ICK_Identity;
4492       ICS.Standard.Third = ICK_Identity;
4493       ICS.Standard.FromTypePtr = T2.getAsOpaquePtr();
4494       ICS.Standard.setToType(0, T2);
4495       ICS.Standard.setToType(1, T1);
4496       ICS.Standard.setToType(2, T1);
4497       ICS.Standard.ReferenceBinding = true;
4498       ICS.Standard.DirectBinding = true;
4499       ICS.Standard.IsLvalueReference = !isRValRef;
4500       ICS.Standard.BindsToFunctionLvalue = T2->isFunctionType();
4501       ICS.Standard.BindsToRvalue = false;
4502       ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4503       ICS.Standard.ObjCLifetimeConversionBinding = ObjCLifetimeConversion;
4504       ICS.Standard.CopyConstructor = nullptr;
4505       ICS.Standard.DeprecatedStringLiteralToCharPtr = false;
4506 
4507       // Nothing more to do: the inaccessibility/ambiguity check for
4508       // derived-to-base conversions is suppressed when we're
4509       // computing the implicit conversion sequence (C++
4510       // [over.best.ics]p2).
4511       return ICS;
4512     }
4513 
4514     //       -- has a class type (i.e., T2 is a class type), where T1 is
4515     //          not reference-related to T2, and can be implicitly
4516     //          converted to an lvalue of type "cv3 T3," where "cv1 T1"
4517     //          is reference-compatible with "cv3 T3" 92) (this
4518     //          conversion is selected by enumerating the applicable
4519     //          conversion functions (13.3.1.6) and choosing the best
4520     //          one through overload resolution (13.3)),
4521     if (!SuppressUserConversions && T2->isRecordType() &&
4522         S.isCompleteType(DeclLoc, T2) &&
4523         RefRelationship == Sema::Ref_Incompatible) {
4524       if (FindConversionForRefInit(S, ICS, DeclType, DeclLoc,
4525                                    Init, T2, /*AllowRvalues=*/false,
4526                                    AllowExplicit))
4527         return ICS;
4528     }
4529   }
4530 
4531   //     -- Otherwise, the reference shall be an lvalue reference to a
4532   //        non-volatile const type (i.e., cv1 shall be const), or the reference
4533   //        shall be an rvalue reference.
4534   if (!isRValRef && (!T1.isConstQualified() || T1.isVolatileQualified()))
4535     return ICS;
4536 
4537   //       -- If the initializer expression
4538   //
4539   //            -- is an xvalue, class prvalue, array prvalue or function
4540   //               lvalue and "cv1 T1" is reference-compatible with "cv2 T2", or
4541   if (RefRelationship == Sema::Ref_Compatible &&
4542       (InitCategory.isXValue() ||
4543        (InitCategory.isPRValue() && (T2->isRecordType() || T2->isArrayType())) ||
4544        (InitCategory.isLValue() && T2->isFunctionType()))) {
4545     ICS.setStandard();
4546     ICS.Standard.First = ICK_Identity;
4547     ICS.Standard.Second = DerivedToBase? ICK_Derived_To_Base
4548                       : ObjCConversion? ICK_Compatible_Conversion
4549                       : ICK_Identity;
4550     ICS.Standard.Third = ICK_Identity;
4551     ICS.Standard.FromTypePtr = T2.getAsOpaquePtr();
4552     ICS.Standard.setToType(0, T2);
4553     ICS.Standard.setToType(1, T1);
4554     ICS.Standard.setToType(2, T1);
4555     ICS.Standard.ReferenceBinding = true;
4556     // In C++0x, this is always a direct binding. In C++98/03, it's a direct
4557     // binding unless we're binding to a class prvalue.
4558     // Note: Although xvalues wouldn't normally show up in C++98/03 code, we
4559     // allow the use of rvalue references in C++98/03 for the benefit of
4560     // standard library implementors; therefore, we need the xvalue check here.
4561     ICS.Standard.DirectBinding =
4562       S.getLangOpts().CPlusPlus11 ||
4563       !(InitCategory.isPRValue() || T2->isRecordType());
4564     ICS.Standard.IsLvalueReference = !isRValRef;
4565     ICS.Standard.BindsToFunctionLvalue = T2->isFunctionType();
4566     ICS.Standard.BindsToRvalue = InitCategory.isRValue();
4567     ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4568     ICS.Standard.ObjCLifetimeConversionBinding = ObjCLifetimeConversion;
4569     ICS.Standard.CopyConstructor = nullptr;
4570     ICS.Standard.DeprecatedStringLiteralToCharPtr = false;
4571     return ICS;
4572   }
4573 
4574   //            -- has a class type (i.e., T2 is a class type), where T1 is not
4575   //               reference-related to T2, and can be implicitly converted to
4576   //               an xvalue, class prvalue, or function lvalue of type
4577   //               "cv3 T3", where "cv1 T1" is reference-compatible with
4578   //               "cv3 T3",
4579   //
4580   //          then the reference is bound to the value of the initializer
4581   //          expression in the first case and to the result of the conversion
4582   //          in the second case (or, in either case, to an appropriate base
4583   //          class subobject).
4584   if (!SuppressUserConversions && RefRelationship == Sema::Ref_Incompatible &&
4585       T2->isRecordType() && S.isCompleteType(DeclLoc, T2) &&
4586       FindConversionForRefInit(S, ICS, DeclType, DeclLoc,
4587                                Init, T2, /*AllowRvalues=*/true,
4588                                AllowExplicit)) {
4589     // In the second case, if the reference is an rvalue reference
4590     // and the second standard conversion sequence of the
4591     // user-defined conversion sequence includes an lvalue-to-rvalue
4592     // conversion, the program is ill-formed.
4593     if (ICS.isUserDefined() && isRValRef &&
4594         ICS.UserDefined.After.First == ICK_Lvalue_To_Rvalue)
4595       ICS.setBad(BadConversionSequence::no_conversion, Init, DeclType);
4596 
4597     return ICS;
4598   }
4599 
4600   // A temporary of function type cannot be created; don't even try.
4601   if (T1->isFunctionType())
4602     return ICS;
4603 
4604   //       -- Otherwise, a temporary of type "cv1 T1" is created and
4605   //          initialized from the initializer expression using the
4606   //          rules for a non-reference copy initialization (8.5). The
4607   //          reference is then bound to the temporary. If T1 is
4608   //          reference-related to T2, cv1 must be the same
4609   //          cv-qualification as, or greater cv-qualification than,
4610   //          cv2; otherwise, the program is ill-formed.
4611   if (RefRelationship == Sema::Ref_Related) {
4612     // If cv1 == cv2 or cv1 is a greater cv-qualified than cv2, then
4613     // we would be reference-compatible or reference-compatible with
4614     // added qualification. But that wasn't the case, so the reference
4615     // initialization fails.
4616     //
4617     // Note that we only want to check address spaces and cvr-qualifiers here.
4618     // ObjC GC, lifetime and unaligned qualifiers aren't important.
4619     Qualifiers T1Quals = T1.getQualifiers();
4620     Qualifiers T2Quals = T2.getQualifiers();
4621     T1Quals.removeObjCGCAttr();
4622     T1Quals.removeObjCLifetime();
4623     T2Quals.removeObjCGCAttr();
4624     T2Quals.removeObjCLifetime();
4625     // MS compiler ignores __unaligned qualifier for references; do the same.
4626     T1Quals.removeUnaligned();
4627     T2Quals.removeUnaligned();
4628     if (!T1Quals.compatiblyIncludes(T2Quals))
4629       return ICS;
4630   }
4631 
4632   // If at least one of the types is a class type, the types are not
4633   // related, and we aren't allowed any user conversions, the
4634   // reference binding fails. This case is important for breaking
4635   // recursion, since TryImplicitConversion below will attempt to
4636   // create a temporary through the use of a copy constructor.
4637   if (SuppressUserConversions && RefRelationship == Sema::Ref_Incompatible &&
4638       (T1->isRecordType() || T2->isRecordType()))
4639     return ICS;
4640 
4641   // If T1 is reference-related to T2 and the reference is an rvalue
4642   // reference, the initializer expression shall not be an lvalue.
4643   if (RefRelationship >= Sema::Ref_Related &&
4644       isRValRef && Init->Classify(S.Context).isLValue())
4645     return ICS;
4646 
4647   // C++ [over.ics.ref]p2:
4648   //   When a parameter of reference type is not bound directly to
4649   //   an argument expression, the conversion sequence is the one
4650   //   required to convert the argument expression to the
4651   //   underlying type of the reference according to
4652   //   13.3.3.1. Conceptually, this conversion sequence corresponds
4653   //   to copy-initializing a temporary of the underlying type with
4654   //   the argument expression. Any difference in top-level
4655   //   cv-qualification is subsumed by the initialization itself
4656   //   and does not constitute a conversion.
4657   ICS = TryImplicitConversion(S, Init, T1, SuppressUserConversions,
4658                               /*AllowExplicit=*/false,
4659                               /*InOverloadResolution=*/false,
4660                               /*CStyle=*/false,
4661                               /*AllowObjCWritebackConversion=*/false,
4662                               /*AllowObjCConversionOnExplicit=*/false);
4663 
4664   // Of course, that's still a reference binding.
4665   if (ICS.isStandard()) {
4666     ICS.Standard.ReferenceBinding = true;
4667     ICS.Standard.IsLvalueReference = !isRValRef;
4668     ICS.Standard.BindsToFunctionLvalue = false;
4669     ICS.Standard.BindsToRvalue = true;
4670     ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4671     ICS.Standard.ObjCLifetimeConversionBinding = false;
4672   } else if (ICS.isUserDefined()) {
4673     const ReferenceType *LValRefType =
4674         ICS.UserDefined.ConversionFunction->getReturnType()
4675             ->getAs<LValueReferenceType>();
4676 
4677     // C++ [over.ics.ref]p3:
4678     //   Except for an implicit object parameter, for which see 13.3.1, a
4679     //   standard conversion sequence cannot be formed if it requires [...]
4680     //   binding an rvalue reference to an lvalue other than a function
4681     //   lvalue.
4682     // Note that the function case is not possible here.
4683     if (DeclType->isRValueReferenceType() && LValRefType) {
4684       // FIXME: This is the wrong BadConversionSequence. The problem is binding
4685       // an rvalue reference to a (non-function) lvalue, not binding an lvalue
4686       // reference to an rvalue!
4687       ICS.setBad(BadConversionSequence::lvalue_ref_to_rvalue, Init, DeclType);
4688       return ICS;
4689     }
4690 
4691     ICS.UserDefined.After.ReferenceBinding = true;
4692     ICS.UserDefined.After.IsLvalueReference = !isRValRef;
4693     ICS.UserDefined.After.BindsToFunctionLvalue = false;
4694     ICS.UserDefined.After.BindsToRvalue = !LValRefType;
4695     ICS.UserDefined.After.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4696     ICS.UserDefined.After.ObjCLifetimeConversionBinding = false;
4697   }
4698 
4699   return ICS;
4700 }
4701 
4702 static ImplicitConversionSequence
4703 TryCopyInitialization(Sema &S, Expr *From, QualType ToType,
4704                       bool SuppressUserConversions,
4705                       bool InOverloadResolution,
4706                       bool AllowObjCWritebackConversion,
4707                       bool AllowExplicit = false);
4708 
4709 /// TryListConversion - Try to copy-initialize a value of type ToType from the
4710 /// initializer list From.
4711 static ImplicitConversionSequence
4712 TryListConversion(Sema &S, InitListExpr *From, QualType ToType,
4713                   bool SuppressUserConversions,
4714                   bool InOverloadResolution,
4715                   bool AllowObjCWritebackConversion) {
4716   // C++11 [over.ics.list]p1:
4717   //   When an argument is an initializer list, it is not an expression and
4718   //   special rules apply for converting it to a parameter type.
4719 
4720   ImplicitConversionSequence Result;
4721   Result.setBad(BadConversionSequence::no_conversion, From, ToType);
4722 
4723   // We need a complete type for what follows. Incomplete types can never be
4724   // initialized from init lists.
4725   if (!S.isCompleteType(From->getLocStart(), ToType))
4726     return Result;
4727 
4728   // Per DR1467:
4729   //   If the parameter type is a class X and the initializer list has a single
4730   //   element of type cv U, where U is X or a class derived from X, the
4731   //   implicit conversion sequence is the one required to convert the element
4732   //   to the parameter type.
4733   //
4734   //   Otherwise, if the parameter type is a character array [... ]
4735   //   and the initializer list has a single element that is an
4736   //   appropriately-typed string literal (8.5.2 [dcl.init.string]), the
4737   //   implicit conversion sequence is the identity conversion.
4738   if (From->getNumInits() == 1) {
4739     if (ToType->isRecordType()) {
4740       QualType InitType = From->getInit(0)->getType();
4741       if (S.Context.hasSameUnqualifiedType(InitType, ToType) ||
4742           S.IsDerivedFrom(From->getLocStart(), InitType, ToType))
4743         return TryCopyInitialization(S, From->getInit(0), ToType,
4744                                      SuppressUserConversions,
4745                                      InOverloadResolution,
4746                                      AllowObjCWritebackConversion);
4747     }
4748     // FIXME: Check the other conditions here: array of character type,
4749     // initializer is a string literal.
4750     if (ToType->isArrayType()) {
4751       InitializedEntity Entity =
4752         InitializedEntity::InitializeParameter(S.Context, ToType,
4753                                                /*Consumed=*/false);
4754       if (S.CanPerformCopyInitialization(Entity, From)) {
4755         Result.setStandard();
4756         Result.Standard.setAsIdentityConversion();
4757         Result.Standard.setFromType(ToType);
4758         Result.Standard.setAllToTypes(ToType);
4759         return Result;
4760       }
4761     }
4762   }
4763 
4764   // C++14 [over.ics.list]p2: Otherwise, if the parameter type [...] (below).
4765   // C++11 [over.ics.list]p2:
4766   //   If the parameter type is std::initializer_list<X> or "array of X" and
4767   //   all the elements can be implicitly converted to X, the implicit
4768   //   conversion sequence is the worst conversion necessary to convert an
4769   //   element of the list to X.
4770   //
4771   // C++14 [over.ics.list]p3:
4772   //   Otherwise, if the parameter type is "array of N X", if the initializer
4773   //   list has exactly N elements or if it has fewer than N elements and X is
4774   //   default-constructible, and if all the elements of the initializer list
4775   //   can be implicitly converted to X, the implicit conversion sequence is
4776   //   the worst conversion necessary to convert an element of the list to X.
4777   //
4778   // FIXME: We're missing a lot of these checks.
4779   bool toStdInitializerList = false;
4780   QualType X;
4781   if (ToType->isArrayType())
4782     X = S.Context.getAsArrayType(ToType)->getElementType();
4783   else
4784     toStdInitializerList = S.isStdInitializerList(ToType, &X);
4785   if (!X.isNull()) {
4786     for (unsigned i = 0, e = From->getNumInits(); i < e; ++i) {
4787       Expr *Init = From->getInit(i);
4788       ImplicitConversionSequence ICS =
4789           TryCopyInitialization(S, Init, X, SuppressUserConversions,
4790                                 InOverloadResolution,
4791                                 AllowObjCWritebackConversion);
4792       // If a single element isn't convertible, fail.
4793       if (ICS.isBad()) {
4794         Result = ICS;
4795         break;
4796       }
4797       // Otherwise, look for the worst conversion.
4798       if (Result.isBad() ||
4799           CompareImplicitConversionSequences(S, From->getLocStart(), ICS,
4800                                              Result) ==
4801               ImplicitConversionSequence::Worse)
4802         Result = ICS;
4803     }
4804 
4805     // For an empty list, we won't have computed any conversion sequence.
4806     // Introduce the identity conversion sequence.
4807     if (From->getNumInits() == 0) {
4808       Result.setStandard();
4809       Result.Standard.setAsIdentityConversion();
4810       Result.Standard.setFromType(ToType);
4811       Result.Standard.setAllToTypes(ToType);
4812     }
4813 
4814     Result.setStdInitializerListElement(toStdInitializerList);
4815     return Result;
4816   }
4817 
4818   // C++14 [over.ics.list]p4:
4819   // C++11 [over.ics.list]p3:
4820   //   Otherwise, if the parameter is a non-aggregate class X and overload
4821   //   resolution chooses a single best constructor [...] the implicit
4822   //   conversion sequence is a user-defined conversion sequence. If multiple
4823   //   constructors are viable but none is better than the others, the
4824   //   implicit conversion sequence is a user-defined conversion sequence.
4825   if (ToType->isRecordType() && !ToType->isAggregateType()) {
4826     // This function can deal with initializer lists.
4827     return TryUserDefinedConversion(S, From, ToType, SuppressUserConversions,
4828                                     /*AllowExplicit=*/false,
4829                                     InOverloadResolution, /*CStyle=*/false,
4830                                     AllowObjCWritebackConversion,
4831                                     /*AllowObjCConversionOnExplicit=*/false);
4832   }
4833 
4834   // C++14 [over.ics.list]p5:
4835   // C++11 [over.ics.list]p4:
4836   //   Otherwise, if the parameter has an aggregate type which can be
4837   //   initialized from the initializer list [...] the implicit conversion
4838   //   sequence is a user-defined conversion sequence.
4839   if (ToType->isAggregateType()) {
4840     // Type is an aggregate, argument is an init list. At this point it comes
4841     // down to checking whether the initialization works.
4842     // FIXME: Find out whether this parameter is consumed or not.
4843     // FIXME: Expose SemaInit's aggregate initialization code so that we don't
4844     // need to call into the initialization code here; overload resolution
4845     // should not be doing that.
4846     InitializedEntity Entity =
4847         InitializedEntity::InitializeParameter(S.Context, ToType,
4848                                                /*Consumed=*/false);
4849     if (S.CanPerformCopyInitialization(Entity, From)) {
4850       Result.setUserDefined();
4851       Result.UserDefined.Before.setAsIdentityConversion();
4852       // Initializer lists don't have a type.
4853       Result.UserDefined.Before.setFromType(QualType());
4854       Result.UserDefined.Before.setAllToTypes(QualType());
4855 
4856       Result.UserDefined.After.setAsIdentityConversion();
4857       Result.UserDefined.After.setFromType(ToType);
4858       Result.UserDefined.After.setAllToTypes(ToType);
4859       Result.UserDefined.ConversionFunction = nullptr;
4860     }
4861     return Result;
4862   }
4863 
4864   // C++14 [over.ics.list]p6:
4865   // C++11 [over.ics.list]p5:
4866   //   Otherwise, if the parameter is a reference, see 13.3.3.1.4.
4867   if (ToType->isReferenceType()) {
4868     // The standard is notoriously unclear here, since 13.3.3.1.4 doesn't
4869     // mention initializer lists in any way. So we go by what list-
4870     // initialization would do and try to extrapolate from that.
4871 
4872     QualType T1 = ToType->getAs<ReferenceType>()->getPointeeType();
4873 
4874     // If the initializer list has a single element that is reference-related
4875     // to the parameter type, we initialize the reference from that.
4876     if (From->getNumInits() == 1) {
4877       Expr *Init = From->getInit(0);
4878 
4879       QualType T2 = Init->getType();
4880 
4881       // If the initializer is the address of an overloaded function, try
4882       // to resolve the overloaded function. If all goes well, T2 is the
4883       // type of the resulting function.
4884       if (S.Context.getCanonicalType(T2) == S.Context.OverloadTy) {
4885         DeclAccessPair Found;
4886         if (FunctionDecl *Fn = S.ResolveAddressOfOverloadedFunction(
4887                                    Init, ToType, false, Found))
4888           T2 = Fn->getType();
4889       }
4890 
4891       // Compute some basic properties of the types and the initializer.
4892       bool dummy1 = false;
4893       bool dummy2 = false;
4894       bool dummy3 = false;
4895       Sema::ReferenceCompareResult RefRelationship
4896         = S.CompareReferenceRelationship(From->getLocStart(), T1, T2, dummy1,
4897                                          dummy2, dummy3);
4898 
4899       if (RefRelationship >= Sema::Ref_Related) {
4900         return TryReferenceInit(S, Init, ToType, /*FIXME*/From->getLocStart(),
4901                                 SuppressUserConversions,
4902                                 /*AllowExplicit=*/false);
4903       }
4904     }
4905 
4906     // Otherwise, we bind the reference to a temporary created from the
4907     // initializer list.
4908     Result = TryListConversion(S, From, T1, SuppressUserConversions,
4909                                InOverloadResolution,
4910                                AllowObjCWritebackConversion);
4911     if (Result.isFailure())
4912       return Result;
4913     assert(!Result.isEllipsis() &&
4914            "Sub-initialization cannot result in ellipsis conversion.");
4915 
4916     // Can we even bind to a temporary?
4917     if (ToType->isRValueReferenceType() ||
4918         (T1.isConstQualified() && !T1.isVolatileQualified())) {
4919       StandardConversionSequence &SCS = Result.isStandard() ? Result.Standard :
4920                                             Result.UserDefined.After;
4921       SCS.ReferenceBinding = true;
4922       SCS.IsLvalueReference = ToType->isLValueReferenceType();
4923       SCS.BindsToRvalue = true;
4924       SCS.BindsToFunctionLvalue = false;
4925       SCS.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4926       SCS.ObjCLifetimeConversionBinding = false;
4927     } else
4928       Result.setBad(BadConversionSequence::lvalue_ref_to_rvalue,
4929                     From, ToType);
4930     return Result;
4931   }
4932 
4933   // C++14 [over.ics.list]p7:
4934   // C++11 [over.ics.list]p6:
4935   //   Otherwise, if the parameter type is not a class:
4936   if (!ToType->isRecordType()) {
4937     //    - if the initializer list has one element that is not itself an
4938     //      initializer list, the implicit conversion sequence is the one
4939     //      required to convert the element to the parameter type.
4940     unsigned NumInits = From->getNumInits();
4941     if (NumInits == 1 && !isa<InitListExpr>(From->getInit(0)))
4942       Result = TryCopyInitialization(S, From->getInit(0), ToType,
4943                                      SuppressUserConversions,
4944                                      InOverloadResolution,
4945                                      AllowObjCWritebackConversion);
4946     //    - if the initializer list has no elements, the implicit conversion
4947     //      sequence is the identity conversion.
4948     else if (NumInits == 0) {
4949       Result.setStandard();
4950       Result.Standard.setAsIdentityConversion();
4951       Result.Standard.setFromType(ToType);
4952       Result.Standard.setAllToTypes(ToType);
4953     }
4954     return Result;
4955   }
4956 
4957   // C++14 [over.ics.list]p8:
4958   // C++11 [over.ics.list]p7:
4959   //   In all cases other than those enumerated above, no conversion is possible
4960   return Result;
4961 }
4962 
4963 /// TryCopyInitialization - Try to copy-initialize a value of type
4964 /// ToType from the expression From. Return the implicit conversion
4965 /// sequence required to pass this argument, which may be a bad
4966 /// conversion sequence (meaning that the argument cannot be passed to
4967 /// a parameter of this type). If @p SuppressUserConversions, then we
4968 /// do not permit any user-defined conversion sequences.
4969 static ImplicitConversionSequence
4970 TryCopyInitialization(Sema &S, Expr *From, QualType ToType,
4971                       bool SuppressUserConversions,
4972                       bool InOverloadResolution,
4973                       bool AllowObjCWritebackConversion,
4974                       bool AllowExplicit) {
4975   if (InitListExpr *FromInitList = dyn_cast<InitListExpr>(From))
4976     return TryListConversion(S, FromInitList, ToType, SuppressUserConversions,
4977                              InOverloadResolution,AllowObjCWritebackConversion);
4978 
4979   if (ToType->isReferenceType())
4980     return TryReferenceInit(S, From, ToType,
4981                             /*FIXME:*/From->getLocStart(),
4982                             SuppressUserConversions,
4983                             AllowExplicit);
4984 
4985   return TryImplicitConversion(S, From, ToType,
4986                                SuppressUserConversions,
4987                                /*AllowExplicit=*/false,
4988                                InOverloadResolution,
4989                                /*CStyle=*/false,
4990                                AllowObjCWritebackConversion,
4991                                /*AllowObjCConversionOnExplicit=*/false);
4992 }
4993 
4994 static bool TryCopyInitialization(const CanQualType FromQTy,
4995                                   const CanQualType ToQTy,
4996                                   Sema &S,
4997                                   SourceLocation Loc,
4998                                   ExprValueKind FromVK) {
4999   OpaqueValueExpr TmpExpr(Loc, FromQTy, FromVK);
5000   ImplicitConversionSequence ICS =
5001     TryCopyInitialization(S, &TmpExpr, ToQTy, true, true, false);
5002 
5003   return !ICS.isBad();
5004 }
5005 
5006 /// TryObjectArgumentInitialization - Try to initialize the object
5007 /// parameter of the given member function (@c Method) from the
5008 /// expression @p From.
5009 static ImplicitConversionSequence
5010 TryObjectArgumentInitialization(Sema &S, SourceLocation Loc, QualType FromType,
5011                                 Expr::Classification FromClassification,
5012                                 CXXMethodDecl *Method,
5013                                 CXXRecordDecl *ActingContext) {
5014   QualType ClassType = S.Context.getTypeDeclType(ActingContext);
5015   // [class.dtor]p2: A destructor can be invoked for a const, volatile or
5016   //                 const volatile object.
5017   unsigned Quals = isa<CXXDestructorDecl>(Method) ?
5018     Qualifiers::Const | Qualifiers::Volatile : Method->getTypeQualifiers();
5019   QualType ImplicitParamType =  S.Context.getCVRQualifiedType(ClassType, Quals);
5020 
5021   // Set up the conversion sequence as a "bad" conversion, to allow us
5022   // to exit early.
5023   ImplicitConversionSequence ICS;
5024 
5025   // We need to have an object of class type.
5026   if (const PointerType *PT = FromType->getAs<PointerType>()) {
5027     FromType = PT->getPointeeType();
5028 
5029     // When we had a pointer, it's implicitly dereferenced, so we
5030     // better have an lvalue.
5031     assert(FromClassification.isLValue());
5032   }
5033 
5034   assert(FromType->isRecordType());
5035 
5036   // C++0x [over.match.funcs]p4:
5037   //   For non-static member functions, the type of the implicit object
5038   //   parameter is
5039   //
5040   //     - "lvalue reference to cv X" for functions declared without a
5041   //        ref-qualifier or with the & ref-qualifier
5042   //     - "rvalue reference to cv X" for functions declared with the &&
5043   //        ref-qualifier
5044   //
5045   // where X is the class of which the function is a member and cv is the
5046   // cv-qualification on the member function declaration.
5047   //
5048   // However, when finding an implicit conversion sequence for the argument, we
5049   // are not allowed to perform user-defined conversions
5050   // (C++ [over.match.funcs]p5). We perform a simplified version of
5051   // reference binding here, that allows class rvalues to bind to
5052   // non-constant references.
5053 
5054   // First check the qualifiers.
5055   QualType FromTypeCanon = S.Context.getCanonicalType(FromType);
5056   if (ImplicitParamType.getCVRQualifiers()
5057                                     != FromTypeCanon.getLocalCVRQualifiers() &&
5058       !ImplicitParamType.isAtLeastAsQualifiedAs(FromTypeCanon)) {
5059     ICS.setBad(BadConversionSequence::bad_qualifiers,
5060                FromType, ImplicitParamType);
5061     return ICS;
5062   }
5063 
5064   // Check that we have either the same type or a derived type. It
5065   // affects the conversion rank.
5066   QualType ClassTypeCanon = S.Context.getCanonicalType(ClassType);
5067   ImplicitConversionKind SecondKind;
5068   if (ClassTypeCanon == FromTypeCanon.getLocalUnqualifiedType()) {
5069     SecondKind = ICK_Identity;
5070   } else if (S.IsDerivedFrom(Loc, FromType, ClassType))
5071     SecondKind = ICK_Derived_To_Base;
5072   else {
5073     ICS.setBad(BadConversionSequence::unrelated_class,
5074                FromType, ImplicitParamType);
5075     return ICS;
5076   }
5077 
5078   // Check the ref-qualifier.
5079   switch (Method->getRefQualifier()) {
5080   case RQ_None:
5081     // Do nothing; we don't care about lvalueness or rvalueness.
5082     break;
5083 
5084   case RQ_LValue:
5085     if (!FromClassification.isLValue() && Quals != Qualifiers::Const) {
5086       // non-const lvalue reference cannot bind to an rvalue
5087       ICS.setBad(BadConversionSequence::lvalue_ref_to_rvalue, FromType,
5088                  ImplicitParamType);
5089       return ICS;
5090     }
5091     break;
5092 
5093   case RQ_RValue:
5094     if (!FromClassification.isRValue()) {
5095       // rvalue reference cannot bind to an lvalue
5096       ICS.setBad(BadConversionSequence::rvalue_ref_to_lvalue, FromType,
5097                  ImplicitParamType);
5098       return ICS;
5099     }
5100     break;
5101   }
5102 
5103   // Success. Mark this as a reference binding.
5104   ICS.setStandard();
5105   ICS.Standard.setAsIdentityConversion();
5106   ICS.Standard.Second = SecondKind;
5107   ICS.Standard.setFromType(FromType);
5108   ICS.Standard.setAllToTypes(ImplicitParamType);
5109   ICS.Standard.ReferenceBinding = true;
5110   ICS.Standard.DirectBinding = true;
5111   ICS.Standard.IsLvalueReference = Method->getRefQualifier() != RQ_RValue;
5112   ICS.Standard.BindsToFunctionLvalue = false;
5113   ICS.Standard.BindsToRvalue = FromClassification.isRValue();
5114   ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier
5115     = (Method->getRefQualifier() == RQ_None);
5116   return ICS;
5117 }
5118 
5119 /// PerformObjectArgumentInitialization - Perform initialization of
5120 /// the implicit object parameter for the given Method with the given
5121 /// expression.
5122 ExprResult
5123 Sema::PerformObjectArgumentInitialization(Expr *From,
5124                                           NestedNameSpecifier *Qualifier,
5125                                           NamedDecl *FoundDecl,
5126                                           CXXMethodDecl *Method) {
5127   QualType FromRecordType, DestType;
5128   QualType ImplicitParamRecordType  =
5129     Method->getThisType(Context)->getAs<PointerType>()->getPointeeType();
5130 
5131   Expr::Classification FromClassification;
5132   if (const PointerType *PT = From->getType()->getAs<PointerType>()) {
5133     FromRecordType = PT->getPointeeType();
5134     DestType = Method->getThisType(Context);
5135     FromClassification = Expr::Classification::makeSimpleLValue();
5136   } else {
5137     FromRecordType = From->getType();
5138     DestType = ImplicitParamRecordType;
5139     FromClassification = From->Classify(Context);
5140   }
5141 
5142   // Note that we always use the true parent context when performing
5143   // the actual argument initialization.
5144   ImplicitConversionSequence ICS = TryObjectArgumentInitialization(
5145       *this, From->getLocStart(), From->getType(), FromClassification, Method,
5146       Method->getParent());
5147   if (ICS.isBad()) {
5148     if (ICS.Bad.Kind == BadConversionSequence::bad_qualifiers) {
5149       Qualifiers FromQs = FromRecordType.getQualifiers();
5150       Qualifiers ToQs = DestType.getQualifiers();
5151       unsigned CVR = FromQs.getCVRQualifiers() & ~ToQs.getCVRQualifiers();
5152       if (CVR) {
5153         Diag(From->getLocStart(),
5154              diag::err_member_function_call_bad_cvr)
5155           << Method->getDeclName() << FromRecordType << (CVR - 1)
5156           << From->getSourceRange();
5157         Diag(Method->getLocation(), diag::note_previous_decl)
5158           << Method->getDeclName();
5159         return ExprError();
5160       }
5161     }
5162 
5163     return Diag(From->getLocStart(),
5164                 diag::err_implicit_object_parameter_init)
5165        << ImplicitParamRecordType << FromRecordType << From->getSourceRange();
5166   }
5167 
5168   if (ICS.Standard.Second == ICK_Derived_To_Base) {
5169     ExprResult FromRes =
5170       PerformObjectMemberConversion(From, Qualifier, FoundDecl, Method);
5171     if (FromRes.isInvalid())
5172       return ExprError();
5173     From = FromRes.get();
5174   }
5175 
5176   if (!Context.hasSameType(From->getType(), DestType))
5177     From = ImpCastExprToType(From, DestType, CK_NoOp,
5178                              From->getValueKind()).get();
5179   return From;
5180 }
5181 
5182 /// TryContextuallyConvertToBool - Attempt to contextually convert the
5183 /// expression From to bool (C++0x [conv]p3).
5184 static ImplicitConversionSequence
5185 TryContextuallyConvertToBool(Sema &S, Expr *From) {
5186   return TryImplicitConversion(S, From, S.Context.BoolTy,
5187                                /*SuppressUserConversions=*/false,
5188                                /*AllowExplicit=*/true,
5189                                /*InOverloadResolution=*/false,
5190                                /*CStyle=*/false,
5191                                /*AllowObjCWritebackConversion=*/false,
5192                                /*AllowObjCConversionOnExplicit=*/false);
5193 }
5194 
5195 /// PerformContextuallyConvertToBool - Perform a contextual conversion
5196 /// of the expression From to bool (C++0x [conv]p3).
5197 ExprResult Sema::PerformContextuallyConvertToBool(Expr *From) {
5198   if (checkPlaceholderForOverload(*this, From))
5199     return ExprError();
5200 
5201   ImplicitConversionSequence ICS = TryContextuallyConvertToBool(*this, From);
5202   if (!ICS.isBad())
5203     return PerformImplicitConversion(From, Context.BoolTy, ICS, AA_Converting);
5204 
5205   if (!DiagnoseMultipleUserDefinedConversion(From, Context.BoolTy))
5206     return Diag(From->getLocStart(),
5207                 diag::err_typecheck_bool_condition)
5208                   << From->getType() << From->getSourceRange();
5209   return ExprError();
5210 }
5211 
5212 /// Check that the specified conversion is permitted in a converted constant
5213 /// expression, according to C++11 [expr.const]p3. Return true if the conversion
5214 /// is acceptable.
5215 static bool CheckConvertedConstantConversions(Sema &S,
5216                                               StandardConversionSequence &SCS) {
5217   // Since we know that the target type is an integral or unscoped enumeration
5218   // type, most conversion kinds are impossible. All possible First and Third
5219   // conversions are fine.
5220   switch (SCS.Second) {
5221   case ICK_Identity:
5222   case ICK_Function_Conversion:
5223   case ICK_Integral_Promotion:
5224   case ICK_Integral_Conversion: // Narrowing conversions are checked elsewhere.
5225   case ICK_Zero_Queue_Conversion:
5226     return true;
5227 
5228   case ICK_Boolean_Conversion:
5229     // Conversion from an integral or unscoped enumeration type to bool is
5230     // classified as ICK_Boolean_Conversion, but it's also arguably an integral
5231     // conversion, so we allow it in a converted constant expression.
5232     //
5233     // FIXME: Per core issue 1407, we should not allow this, but that breaks
5234     // a lot of popular code. We should at least add a warning for this
5235     // (non-conforming) extension.
5236     return SCS.getFromType()->isIntegralOrUnscopedEnumerationType() &&
5237            SCS.getToType(2)->isBooleanType();
5238 
5239   case ICK_Pointer_Conversion:
5240   case ICK_Pointer_Member:
5241     // C++1z: null pointer conversions and null member pointer conversions are
5242     // only permitted if the source type is std::nullptr_t.
5243     return SCS.getFromType()->isNullPtrType();
5244 
5245   case ICK_Floating_Promotion:
5246   case ICK_Complex_Promotion:
5247   case ICK_Floating_Conversion:
5248   case ICK_Complex_Conversion:
5249   case ICK_Floating_Integral:
5250   case ICK_Compatible_Conversion:
5251   case ICK_Derived_To_Base:
5252   case ICK_Vector_Conversion:
5253   case ICK_Vector_Splat:
5254   case ICK_Complex_Real:
5255   case ICK_Block_Pointer_Conversion:
5256   case ICK_TransparentUnionConversion:
5257   case ICK_Writeback_Conversion:
5258   case ICK_Zero_Event_Conversion:
5259   case ICK_C_Only_Conversion:
5260   case ICK_Incompatible_Pointer_Conversion:
5261     return false;
5262 
5263   case ICK_Lvalue_To_Rvalue:
5264   case ICK_Array_To_Pointer:
5265   case ICK_Function_To_Pointer:
5266     llvm_unreachable("found a first conversion kind in Second");
5267 
5268   case ICK_Qualification:
5269     llvm_unreachable("found a third conversion kind in Second");
5270 
5271   case ICK_Num_Conversion_Kinds:
5272     break;
5273   }
5274 
5275   llvm_unreachable("unknown conversion kind");
5276 }
5277 
5278 /// CheckConvertedConstantExpression - Check that the expression From is a
5279 /// converted constant expression of type T, perform the conversion and produce
5280 /// the converted expression, per C++11 [expr.const]p3.
5281 static ExprResult CheckConvertedConstantExpression(Sema &S, Expr *From,
5282                                                    QualType T, APValue &Value,
5283                                                    Sema::CCEKind CCE,
5284                                                    bool RequireInt) {
5285   assert(S.getLangOpts().CPlusPlus11 &&
5286          "converted constant expression outside C++11");
5287 
5288   if (checkPlaceholderForOverload(S, From))
5289     return ExprError();
5290 
5291   // C++1z [expr.const]p3:
5292   //  A converted constant expression of type T is an expression,
5293   //  implicitly converted to type T, where the converted
5294   //  expression is a constant expression and the implicit conversion
5295   //  sequence contains only [... list of conversions ...].
5296   // C++1z [stmt.if]p2:
5297   //  If the if statement is of the form if constexpr, the value of the
5298   //  condition shall be a contextually converted constant expression of type
5299   //  bool.
5300   ImplicitConversionSequence ICS =
5301       CCE == Sema::CCEK_ConstexprIf
5302           ? TryContextuallyConvertToBool(S, From)
5303           : TryCopyInitialization(S, From, T,
5304                                   /*SuppressUserConversions=*/false,
5305                                   /*InOverloadResolution=*/false,
5306                                   /*AllowObjcWritebackConversion=*/false,
5307                                   /*AllowExplicit=*/false);
5308   StandardConversionSequence *SCS = nullptr;
5309   switch (ICS.getKind()) {
5310   case ImplicitConversionSequence::StandardConversion:
5311     SCS = &ICS.Standard;
5312     break;
5313   case ImplicitConversionSequence::UserDefinedConversion:
5314     // We are converting to a non-class type, so the Before sequence
5315     // must be trivial.
5316     SCS = &ICS.UserDefined.After;
5317     break;
5318   case ImplicitConversionSequence::AmbiguousConversion:
5319   case ImplicitConversionSequence::BadConversion:
5320     if (!S.DiagnoseMultipleUserDefinedConversion(From, T))
5321       return S.Diag(From->getLocStart(),
5322                     diag::err_typecheck_converted_constant_expression)
5323                 << From->getType() << From->getSourceRange() << T;
5324     return ExprError();
5325 
5326   case ImplicitConversionSequence::EllipsisConversion:
5327     llvm_unreachable("ellipsis conversion in converted constant expression");
5328   }
5329 
5330   // Check that we would only use permitted conversions.
5331   if (!CheckConvertedConstantConversions(S, *SCS)) {
5332     return S.Diag(From->getLocStart(),
5333                   diag::err_typecheck_converted_constant_expression_disallowed)
5334              << From->getType() << From->getSourceRange() << T;
5335   }
5336   // [...] and where the reference binding (if any) binds directly.
5337   if (SCS->ReferenceBinding && !SCS->DirectBinding) {
5338     return S.Diag(From->getLocStart(),
5339                   diag::err_typecheck_converted_constant_expression_indirect)
5340              << From->getType() << From->getSourceRange() << T;
5341   }
5342 
5343   ExprResult Result =
5344       S.PerformImplicitConversion(From, T, ICS, Sema::AA_Converting);
5345   if (Result.isInvalid())
5346     return Result;
5347 
5348   // Check for a narrowing implicit conversion.
5349   APValue PreNarrowingValue;
5350   QualType PreNarrowingType;
5351   switch (SCS->getNarrowingKind(S.Context, Result.get(), PreNarrowingValue,
5352                                 PreNarrowingType)) {
5353   case NK_Dependent_Narrowing:
5354     // Implicit conversion to a narrower type, but the expression is
5355     // value-dependent so we can't tell whether it's actually narrowing.
5356   case NK_Variable_Narrowing:
5357     // Implicit conversion to a narrower type, and the value is not a constant
5358     // expression. We'll diagnose this in a moment.
5359   case NK_Not_Narrowing:
5360     break;
5361 
5362   case NK_Constant_Narrowing:
5363     S.Diag(From->getLocStart(), diag::ext_cce_narrowing)
5364       << CCE << /*Constant*/1
5365       << PreNarrowingValue.getAsString(S.Context, PreNarrowingType) << T;
5366     break;
5367 
5368   case NK_Type_Narrowing:
5369     S.Diag(From->getLocStart(), diag::ext_cce_narrowing)
5370       << CCE << /*Constant*/0 << From->getType() << T;
5371     break;
5372   }
5373 
5374   if (Result.get()->isValueDependent()) {
5375     Value = APValue();
5376     return Result;
5377   }
5378 
5379   // Check the expression is a constant expression.
5380   SmallVector<PartialDiagnosticAt, 8> Notes;
5381   Expr::EvalResult Eval;
5382   Eval.Diag = &Notes;
5383 
5384   if ((T->isReferenceType()
5385            ? !Result.get()->EvaluateAsLValue(Eval, S.Context)
5386            : !Result.get()->EvaluateAsRValue(Eval, S.Context)) ||
5387       (RequireInt && !Eval.Val.isInt())) {
5388     // The expression can't be folded, so we can't keep it at this position in
5389     // the AST.
5390     Result = ExprError();
5391   } else {
5392     Value = Eval.Val;
5393 
5394     if (Notes.empty()) {
5395       // It's a constant expression.
5396       return Result;
5397     }
5398   }
5399 
5400   // It's not a constant expression. Produce an appropriate diagnostic.
5401   if (Notes.size() == 1 &&
5402       Notes[0].second.getDiagID() == diag::note_invalid_subexpr_in_const_expr)
5403     S.Diag(Notes[0].first, diag::err_expr_not_cce) << CCE;
5404   else {
5405     S.Diag(From->getLocStart(), diag::err_expr_not_cce)
5406       << CCE << From->getSourceRange();
5407     for (unsigned I = 0; I < Notes.size(); ++I)
5408       S.Diag(Notes[I].first, Notes[I].second);
5409   }
5410   return ExprError();
5411 }
5412 
5413 ExprResult Sema::CheckConvertedConstantExpression(Expr *From, QualType T,
5414                                                   APValue &Value, CCEKind CCE) {
5415   return ::CheckConvertedConstantExpression(*this, From, T, Value, CCE, false);
5416 }
5417 
5418 ExprResult Sema::CheckConvertedConstantExpression(Expr *From, QualType T,
5419                                                   llvm::APSInt &Value,
5420                                                   CCEKind CCE) {
5421   assert(T->isIntegralOrEnumerationType() && "unexpected converted const type");
5422 
5423   APValue V;
5424   auto R = ::CheckConvertedConstantExpression(*this, From, T, V, CCE, true);
5425   if (!R.isInvalid() && !R.get()->isValueDependent())
5426     Value = V.getInt();
5427   return R;
5428 }
5429 
5430 
5431 /// dropPointerConversions - If the given standard conversion sequence
5432 /// involves any pointer conversions, remove them.  This may change
5433 /// the result type of the conversion sequence.
5434 static void dropPointerConversion(StandardConversionSequence &SCS) {
5435   if (SCS.Second == ICK_Pointer_Conversion) {
5436     SCS.Second = ICK_Identity;
5437     SCS.Third = ICK_Identity;
5438     SCS.ToTypePtrs[2] = SCS.ToTypePtrs[1] = SCS.ToTypePtrs[0];
5439   }
5440 }
5441 
5442 /// TryContextuallyConvertToObjCPointer - Attempt to contextually
5443 /// convert the expression From to an Objective-C pointer type.
5444 static ImplicitConversionSequence
5445 TryContextuallyConvertToObjCPointer(Sema &S, Expr *From) {
5446   // Do an implicit conversion to 'id'.
5447   QualType Ty = S.Context.getObjCIdType();
5448   ImplicitConversionSequence ICS
5449     = TryImplicitConversion(S, From, Ty,
5450                             // FIXME: Are these flags correct?
5451                             /*SuppressUserConversions=*/false,
5452                             /*AllowExplicit=*/true,
5453                             /*InOverloadResolution=*/false,
5454                             /*CStyle=*/false,
5455                             /*AllowObjCWritebackConversion=*/false,
5456                             /*AllowObjCConversionOnExplicit=*/true);
5457 
5458   // Strip off any final conversions to 'id'.
5459   switch (ICS.getKind()) {
5460   case ImplicitConversionSequence::BadConversion:
5461   case ImplicitConversionSequence::AmbiguousConversion:
5462   case ImplicitConversionSequence::EllipsisConversion:
5463     break;
5464 
5465   case ImplicitConversionSequence::UserDefinedConversion:
5466     dropPointerConversion(ICS.UserDefined.After);
5467     break;
5468 
5469   case ImplicitConversionSequence::StandardConversion:
5470     dropPointerConversion(ICS.Standard);
5471     break;
5472   }
5473 
5474   return ICS;
5475 }
5476 
5477 /// PerformContextuallyConvertToObjCPointer - Perform a contextual
5478 /// conversion of the expression From to an Objective-C pointer type.
5479 /// Returns a valid but null ExprResult if no conversion sequence exists.
5480 ExprResult Sema::PerformContextuallyConvertToObjCPointer(Expr *From) {
5481   if (checkPlaceholderForOverload(*this, From))
5482     return ExprError();
5483 
5484   QualType Ty = Context.getObjCIdType();
5485   ImplicitConversionSequence ICS =
5486     TryContextuallyConvertToObjCPointer(*this, From);
5487   if (!ICS.isBad())
5488     return PerformImplicitConversion(From, Ty, ICS, AA_Converting);
5489   return ExprResult();
5490 }
5491 
5492 /// Determine whether the provided type is an integral type, or an enumeration
5493 /// type of a permitted flavor.
5494 bool Sema::ICEConvertDiagnoser::match(QualType T) {
5495   return AllowScopedEnumerations ? T->isIntegralOrEnumerationType()
5496                                  : T->isIntegralOrUnscopedEnumerationType();
5497 }
5498 
5499 static ExprResult
5500 diagnoseAmbiguousConversion(Sema &SemaRef, SourceLocation Loc, Expr *From,
5501                             Sema::ContextualImplicitConverter &Converter,
5502                             QualType T, UnresolvedSetImpl &ViableConversions) {
5503 
5504   if (Converter.Suppress)
5505     return ExprError();
5506 
5507   Converter.diagnoseAmbiguous(SemaRef, Loc, T) << From->getSourceRange();
5508   for (unsigned I = 0, N = ViableConversions.size(); I != N; ++I) {
5509     CXXConversionDecl *Conv =
5510         cast<CXXConversionDecl>(ViableConversions[I]->getUnderlyingDecl());
5511     QualType ConvTy = Conv->getConversionType().getNonReferenceType();
5512     Converter.noteAmbiguous(SemaRef, Conv, ConvTy);
5513   }
5514   return From;
5515 }
5516 
5517 static bool
5518 diagnoseNoViableConversion(Sema &SemaRef, SourceLocation Loc, Expr *&From,
5519                            Sema::ContextualImplicitConverter &Converter,
5520                            QualType T, bool HadMultipleCandidates,
5521                            UnresolvedSetImpl &ExplicitConversions) {
5522   if (ExplicitConversions.size() == 1 && !Converter.Suppress) {
5523     DeclAccessPair Found = ExplicitConversions[0];
5524     CXXConversionDecl *Conversion =
5525         cast<CXXConversionDecl>(Found->getUnderlyingDecl());
5526 
5527     // The user probably meant to invoke the given explicit
5528     // conversion; use it.
5529     QualType ConvTy = Conversion->getConversionType().getNonReferenceType();
5530     std::string TypeStr;
5531     ConvTy.getAsStringInternal(TypeStr, SemaRef.getPrintingPolicy());
5532 
5533     Converter.diagnoseExplicitConv(SemaRef, Loc, T, ConvTy)
5534         << FixItHint::CreateInsertion(From->getLocStart(),
5535                                       "static_cast<" + TypeStr + ">(")
5536         << FixItHint::CreateInsertion(
5537                SemaRef.getLocForEndOfToken(From->getLocEnd()), ")");
5538     Converter.noteExplicitConv(SemaRef, Conversion, ConvTy);
5539 
5540     // If we aren't in a SFINAE context, build a call to the
5541     // explicit conversion function.
5542     if (SemaRef.isSFINAEContext())
5543       return true;
5544 
5545     SemaRef.CheckMemberOperatorAccess(From->getExprLoc(), From, nullptr, Found);
5546     ExprResult Result = SemaRef.BuildCXXMemberCallExpr(From, Found, Conversion,
5547                                                        HadMultipleCandidates);
5548     if (Result.isInvalid())
5549       return true;
5550     // Record usage of conversion in an implicit cast.
5551     From = ImplicitCastExpr::Create(SemaRef.Context, Result.get()->getType(),
5552                                     CK_UserDefinedConversion, Result.get(),
5553                                     nullptr, Result.get()->getValueKind());
5554   }
5555   return false;
5556 }
5557 
5558 static bool recordConversion(Sema &SemaRef, SourceLocation Loc, Expr *&From,
5559                              Sema::ContextualImplicitConverter &Converter,
5560                              QualType T, bool HadMultipleCandidates,
5561                              DeclAccessPair &Found) {
5562   CXXConversionDecl *Conversion =
5563       cast<CXXConversionDecl>(Found->getUnderlyingDecl());
5564   SemaRef.CheckMemberOperatorAccess(From->getExprLoc(), From, nullptr, Found);
5565 
5566   QualType ToType = Conversion->getConversionType().getNonReferenceType();
5567   if (!Converter.SuppressConversion) {
5568     if (SemaRef.isSFINAEContext())
5569       return true;
5570 
5571     Converter.diagnoseConversion(SemaRef, Loc, T, ToType)
5572         << From->getSourceRange();
5573   }
5574 
5575   ExprResult Result = SemaRef.BuildCXXMemberCallExpr(From, Found, Conversion,
5576                                                      HadMultipleCandidates);
5577   if (Result.isInvalid())
5578     return true;
5579   // Record usage of conversion in an implicit cast.
5580   From = ImplicitCastExpr::Create(SemaRef.Context, Result.get()->getType(),
5581                                   CK_UserDefinedConversion, Result.get(),
5582                                   nullptr, Result.get()->getValueKind());
5583   return false;
5584 }
5585 
5586 static ExprResult finishContextualImplicitConversion(
5587     Sema &SemaRef, SourceLocation Loc, Expr *From,
5588     Sema::ContextualImplicitConverter &Converter) {
5589   if (!Converter.match(From->getType()) && !Converter.Suppress)
5590     Converter.diagnoseNoMatch(SemaRef, Loc, From->getType())
5591         << From->getSourceRange();
5592 
5593   return SemaRef.DefaultLvalueConversion(From);
5594 }
5595 
5596 static void
5597 collectViableConversionCandidates(Sema &SemaRef, Expr *From, QualType ToType,
5598                                   UnresolvedSetImpl &ViableConversions,
5599                                   OverloadCandidateSet &CandidateSet) {
5600   for (unsigned I = 0, N = ViableConversions.size(); I != N; ++I) {
5601     DeclAccessPair FoundDecl = ViableConversions[I];
5602     NamedDecl *D = FoundDecl.getDecl();
5603     CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(D->getDeclContext());
5604     if (isa<UsingShadowDecl>(D))
5605       D = cast<UsingShadowDecl>(D)->getTargetDecl();
5606 
5607     CXXConversionDecl *Conv;
5608     FunctionTemplateDecl *ConvTemplate;
5609     if ((ConvTemplate = dyn_cast<FunctionTemplateDecl>(D)))
5610       Conv = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
5611     else
5612       Conv = cast<CXXConversionDecl>(D);
5613 
5614     if (ConvTemplate)
5615       SemaRef.AddTemplateConversionCandidate(
5616         ConvTemplate, FoundDecl, ActingContext, From, ToType, CandidateSet,
5617         /*AllowObjCConversionOnExplicit=*/false);
5618     else
5619       SemaRef.AddConversionCandidate(Conv, FoundDecl, ActingContext, From,
5620                                      ToType, CandidateSet,
5621                                      /*AllowObjCConversionOnExplicit=*/false);
5622   }
5623 }
5624 
5625 /// \brief Attempt to convert the given expression to a type which is accepted
5626 /// by the given converter.
5627 ///
5628 /// This routine will attempt to convert an expression of class type to a
5629 /// type accepted by the specified converter. In C++11 and before, the class
5630 /// must have a single non-explicit conversion function converting to a matching
5631 /// type. In C++1y, there can be multiple such conversion functions, but only
5632 /// one target type.
5633 ///
5634 /// \param Loc The source location of the construct that requires the
5635 /// conversion.
5636 ///
5637 /// \param From The expression we're converting from.
5638 ///
5639 /// \param Converter Used to control and diagnose the conversion process.
5640 ///
5641 /// \returns The expression, converted to an integral or enumeration type if
5642 /// successful.
5643 ExprResult Sema::PerformContextualImplicitConversion(
5644     SourceLocation Loc, Expr *From, ContextualImplicitConverter &Converter) {
5645   // We can't perform any more checking for type-dependent expressions.
5646   if (From->isTypeDependent())
5647     return From;
5648 
5649   // Process placeholders immediately.
5650   if (From->hasPlaceholderType()) {
5651     ExprResult result = CheckPlaceholderExpr(From);
5652     if (result.isInvalid())
5653       return result;
5654     From = result.get();
5655   }
5656 
5657   // If the expression already has a matching type, we're golden.
5658   QualType T = From->getType();
5659   if (Converter.match(T))
5660     return DefaultLvalueConversion(From);
5661 
5662   // FIXME: Check for missing '()' if T is a function type?
5663 
5664   // We can only perform contextual implicit conversions on objects of class
5665   // type.
5666   const RecordType *RecordTy = T->getAs<RecordType>();
5667   if (!RecordTy || !getLangOpts().CPlusPlus) {
5668     if (!Converter.Suppress)
5669       Converter.diagnoseNoMatch(*this, Loc, T) << From->getSourceRange();
5670     return From;
5671   }
5672 
5673   // We must have a complete class type.
5674   struct TypeDiagnoserPartialDiag : TypeDiagnoser {
5675     ContextualImplicitConverter &Converter;
5676     Expr *From;
5677 
5678     TypeDiagnoserPartialDiag(ContextualImplicitConverter &Converter, Expr *From)
5679         : Converter(Converter), From(From) {}
5680 
5681     void diagnose(Sema &S, SourceLocation Loc, QualType T) override {
5682       Converter.diagnoseIncomplete(S, Loc, T) << From->getSourceRange();
5683     }
5684   } IncompleteDiagnoser(Converter, From);
5685 
5686   if (Converter.Suppress ? !isCompleteType(Loc, T)
5687                          : RequireCompleteType(Loc, T, IncompleteDiagnoser))
5688     return From;
5689 
5690   // Look for a conversion to an integral or enumeration type.
5691   UnresolvedSet<4>
5692       ViableConversions; // These are *potentially* viable in C++1y.
5693   UnresolvedSet<4> ExplicitConversions;
5694   const auto &Conversions =
5695       cast<CXXRecordDecl>(RecordTy->getDecl())->getVisibleConversionFunctions();
5696 
5697   bool HadMultipleCandidates =
5698       (std::distance(Conversions.begin(), Conversions.end()) > 1);
5699 
5700   // To check that there is only one target type, in C++1y:
5701   QualType ToType;
5702   bool HasUniqueTargetType = true;
5703 
5704   // Collect explicit or viable (potentially in C++1y) conversions.
5705   for (auto I = Conversions.begin(), E = Conversions.end(); I != E; ++I) {
5706     NamedDecl *D = (*I)->getUnderlyingDecl();
5707     CXXConversionDecl *Conversion;
5708     FunctionTemplateDecl *ConvTemplate = dyn_cast<FunctionTemplateDecl>(D);
5709     if (ConvTemplate) {
5710       if (getLangOpts().CPlusPlus14)
5711         Conversion = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
5712       else
5713         continue; // C++11 does not consider conversion operator templates(?).
5714     } else
5715       Conversion = cast<CXXConversionDecl>(D);
5716 
5717     assert((!ConvTemplate || getLangOpts().CPlusPlus14) &&
5718            "Conversion operator templates are considered potentially "
5719            "viable in C++1y");
5720 
5721     QualType CurToType = Conversion->getConversionType().getNonReferenceType();
5722     if (Converter.match(CurToType) || ConvTemplate) {
5723 
5724       if (Conversion->isExplicit()) {
5725         // FIXME: For C++1y, do we need this restriction?
5726         // cf. diagnoseNoViableConversion()
5727         if (!ConvTemplate)
5728           ExplicitConversions.addDecl(I.getDecl(), I.getAccess());
5729       } else {
5730         if (!ConvTemplate && getLangOpts().CPlusPlus14) {
5731           if (ToType.isNull())
5732             ToType = CurToType.getUnqualifiedType();
5733           else if (HasUniqueTargetType &&
5734                    (CurToType.getUnqualifiedType() != ToType))
5735             HasUniqueTargetType = false;
5736         }
5737         ViableConversions.addDecl(I.getDecl(), I.getAccess());
5738       }
5739     }
5740   }
5741 
5742   if (getLangOpts().CPlusPlus14) {
5743     // C++1y [conv]p6:
5744     // ... An expression e of class type E appearing in such a context
5745     // is said to be contextually implicitly converted to a specified
5746     // type T and is well-formed if and only if e can be implicitly
5747     // converted to a type T that is determined as follows: E is searched
5748     // for conversion functions whose return type is cv T or reference to
5749     // cv T such that T is allowed by the context. There shall be
5750     // exactly one such T.
5751 
5752     // If no unique T is found:
5753     if (ToType.isNull()) {
5754       if (diagnoseNoViableConversion(*this, Loc, From, Converter, T,
5755                                      HadMultipleCandidates,
5756                                      ExplicitConversions))
5757         return ExprError();
5758       return finishContextualImplicitConversion(*this, Loc, From, Converter);
5759     }
5760 
5761     // If more than one unique Ts are found:
5762     if (!HasUniqueTargetType)
5763       return diagnoseAmbiguousConversion(*this, Loc, From, Converter, T,
5764                                          ViableConversions);
5765 
5766     // If one unique T is found:
5767     // First, build a candidate set from the previously recorded
5768     // potentially viable conversions.
5769     OverloadCandidateSet CandidateSet(Loc, OverloadCandidateSet::CSK_Normal);
5770     collectViableConversionCandidates(*this, From, ToType, ViableConversions,
5771                                       CandidateSet);
5772 
5773     // Then, perform overload resolution over the candidate set.
5774     OverloadCandidateSet::iterator Best;
5775     switch (CandidateSet.BestViableFunction(*this, Loc, Best)) {
5776     case OR_Success: {
5777       // Apply this conversion.
5778       DeclAccessPair Found =
5779           DeclAccessPair::make(Best->Function, Best->FoundDecl.getAccess());
5780       if (recordConversion(*this, Loc, From, Converter, T,
5781                            HadMultipleCandidates, Found))
5782         return ExprError();
5783       break;
5784     }
5785     case OR_Ambiguous:
5786       return diagnoseAmbiguousConversion(*this, Loc, From, Converter, T,
5787                                          ViableConversions);
5788     case OR_No_Viable_Function:
5789       if (diagnoseNoViableConversion(*this, Loc, From, Converter, T,
5790                                      HadMultipleCandidates,
5791                                      ExplicitConversions))
5792         return ExprError();
5793       LLVM_FALLTHROUGH;
5794     case OR_Deleted:
5795       // We'll complain below about a non-integral condition type.
5796       break;
5797     }
5798   } else {
5799     switch (ViableConversions.size()) {
5800     case 0: {
5801       if (diagnoseNoViableConversion(*this, Loc, From, Converter, T,
5802                                      HadMultipleCandidates,
5803                                      ExplicitConversions))
5804         return ExprError();
5805 
5806       // We'll complain below about a non-integral condition type.
5807       break;
5808     }
5809     case 1: {
5810       // Apply this conversion.
5811       DeclAccessPair Found = ViableConversions[0];
5812       if (recordConversion(*this, Loc, From, Converter, T,
5813                            HadMultipleCandidates, Found))
5814         return ExprError();
5815       break;
5816     }
5817     default:
5818       return diagnoseAmbiguousConversion(*this, Loc, From, Converter, T,
5819                                          ViableConversions);
5820     }
5821   }
5822 
5823   return finishContextualImplicitConversion(*this, Loc, From, Converter);
5824 }
5825 
5826 /// IsAcceptableNonMemberOperatorCandidate - Determine whether Fn is
5827 /// an acceptable non-member overloaded operator for a call whose
5828 /// arguments have types T1 (and, if non-empty, T2). This routine
5829 /// implements the check in C++ [over.match.oper]p3b2 concerning
5830 /// enumeration types.
5831 static bool IsAcceptableNonMemberOperatorCandidate(ASTContext &Context,
5832                                                    FunctionDecl *Fn,
5833                                                    ArrayRef<Expr *> Args) {
5834   QualType T1 = Args[0]->getType();
5835   QualType T2 = Args.size() > 1 ? Args[1]->getType() : QualType();
5836 
5837   if (T1->isDependentType() || (!T2.isNull() && T2->isDependentType()))
5838     return true;
5839 
5840   if (T1->isRecordType() || (!T2.isNull() && T2->isRecordType()))
5841     return true;
5842 
5843   const FunctionProtoType *Proto = Fn->getType()->getAs<FunctionProtoType>();
5844   if (Proto->getNumParams() < 1)
5845     return false;
5846 
5847   if (T1->isEnumeralType()) {
5848     QualType ArgType = Proto->getParamType(0).getNonReferenceType();
5849     if (Context.hasSameUnqualifiedType(T1, ArgType))
5850       return true;
5851   }
5852 
5853   if (Proto->getNumParams() < 2)
5854     return false;
5855 
5856   if (!T2.isNull() && T2->isEnumeralType()) {
5857     QualType ArgType = Proto->getParamType(1).getNonReferenceType();
5858     if (Context.hasSameUnqualifiedType(T2, ArgType))
5859       return true;
5860   }
5861 
5862   return false;
5863 }
5864 
5865 /// AddOverloadCandidate - Adds the given function to the set of
5866 /// candidate functions, using the given function call arguments.  If
5867 /// @p SuppressUserConversions, then don't allow user-defined
5868 /// conversions via constructors or conversion operators.
5869 ///
5870 /// \param PartialOverloading true if we are performing "partial" overloading
5871 /// based on an incomplete set of function arguments. This feature is used by
5872 /// code completion.
5873 void
5874 Sema::AddOverloadCandidate(FunctionDecl *Function,
5875                            DeclAccessPair FoundDecl,
5876                            ArrayRef<Expr *> Args,
5877                            OverloadCandidateSet &CandidateSet,
5878                            bool SuppressUserConversions,
5879                            bool PartialOverloading,
5880                            bool AllowExplicit,
5881                            ConversionSequenceList EarlyConversions) {
5882   const FunctionProtoType *Proto
5883     = dyn_cast<FunctionProtoType>(Function->getType()->getAs<FunctionType>());
5884   assert(Proto && "Functions without a prototype cannot be overloaded");
5885   assert(!Function->getDescribedFunctionTemplate() &&
5886          "Use AddTemplateOverloadCandidate for function templates");
5887 
5888   if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Function)) {
5889     if (!isa<CXXConstructorDecl>(Method)) {
5890       // If we get here, it's because we're calling a member function
5891       // that is named without a member access expression (e.g.,
5892       // "this->f") that was either written explicitly or created
5893       // implicitly. This can happen with a qualified call to a member
5894       // function, e.g., X::f(). We use an empty type for the implied
5895       // object argument (C++ [over.call.func]p3), and the acting context
5896       // is irrelevant.
5897       AddMethodCandidate(Method, FoundDecl, Method->getParent(), QualType(),
5898                          Expr::Classification::makeSimpleLValue(), Args,
5899                          CandidateSet, SuppressUserConversions,
5900                          PartialOverloading, EarlyConversions);
5901       return;
5902     }
5903     // We treat a constructor like a non-member function, since its object
5904     // argument doesn't participate in overload resolution.
5905   }
5906 
5907   if (!CandidateSet.isNewCandidate(Function))
5908     return;
5909 
5910   // C++ [over.match.oper]p3:
5911   //   if no operand has a class type, only those non-member functions in the
5912   //   lookup set that have a first parameter of type T1 or "reference to
5913   //   (possibly cv-qualified) T1", when T1 is an enumeration type, or (if there
5914   //   is a right operand) a second parameter of type T2 or "reference to
5915   //   (possibly cv-qualified) T2", when T2 is an enumeration type, are
5916   //   candidate functions.
5917   if (CandidateSet.getKind() == OverloadCandidateSet::CSK_Operator &&
5918       !IsAcceptableNonMemberOperatorCandidate(Context, Function, Args))
5919     return;
5920 
5921   // C++11 [class.copy]p11: [DR1402]
5922   //   A defaulted move constructor that is defined as deleted is ignored by
5923   //   overload resolution.
5924   CXXConstructorDecl *Constructor = dyn_cast<CXXConstructorDecl>(Function);
5925   if (Constructor && Constructor->isDefaulted() && Constructor->isDeleted() &&
5926       Constructor->isMoveConstructor())
5927     return;
5928 
5929   // Overload resolution is always an unevaluated context.
5930   EnterExpressionEvaluationContext Unevaluated(
5931       *this, Sema::ExpressionEvaluationContext::Unevaluated);
5932 
5933   // Add this candidate
5934   OverloadCandidate &Candidate =
5935       CandidateSet.addCandidate(Args.size(), EarlyConversions);
5936   Candidate.FoundDecl = FoundDecl;
5937   Candidate.Function = Function;
5938   Candidate.Viable = true;
5939   Candidate.IsSurrogate = false;
5940   Candidate.IgnoreObjectArgument = false;
5941   Candidate.ExplicitCallArguments = Args.size();
5942 
5943   if (Constructor) {
5944     // C++ [class.copy]p3:
5945     //   A member function template is never instantiated to perform the copy
5946     //   of a class object to an object of its class type.
5947     QualType ClassType = Context.getTypeDeclType(Constructor->getParent());
5948     if (Args.size() == 1 && Constructor->isSpecializationCopyingObject() &&
5949         (Context.hasSameUnqualifiedType(ClassType, Args[0]->getType()) ||
5950          IsDerivedFrom(Args[0]->getLocStart(), Args[0]->getType(),
5951                        ClassType))) {
5952       Candidate.Viable = false;
5953       Candidate.FailureKind = ovl_fail_illegal_constructor;
5954       return;
5955     }
5956 
5957     // C++ [over.match.funcs]p8: (proposed DR resolution)
5958     //   A constructor inherited from class type C that has a first parameter
5959     //   of type "reference to P" (including such a constructor instantiated
5960     //   from a template) is excluded from the set of candidate functions when
5961     //   constructing an object of type cv D if the argument list has exactly
5962     //   one argument and D is reference-related to P and P is reference-related
5963     //   to C.
5964     auto *Shadow = dyn_cast<ConstructorUsingShadowDecl>(FoundDecl.getDecl());
5965     if (Shadow && Args.size() == 1 && Constructor->getNumParams() >= 1 &&
5966         Constructor->getParamDecl(0)->getType()->isReferenceType()) {
5967       QualType P = Constructor->getParamDecl(0)->getType()->getPointeeType();
5968       QualType C = Context.getRecordType(Constructor->getParent());
5969       QualType D = Context.getRecordType(Shadow->getParent());
5970       SourceLocation Loc = Args.front()->getExprLoc();
5971       if ((Context.hasSameUnqualifiedType(P, C) || IsDerivedFrom(Loc, P, C)) &&
5972           (Context.hasSameUnqualifiedType(D, P) || IsDerivedFrom(Loc, D, P))) {
5973         Candidate.Viable = false;
5974         Candidate.FailureKind = ovl_fail_inhctor_slice;
5975         return;
5976       }
5977     }
5978   }
5979 
5980   unsigned NumParams = Proto->getNumParams();
5981 
5982   // (C++ 13.3.2p2): A candidate function having fewer than m
5983   // parameters is viable only if it has an ellipsis in its parameter
5984   // list (8.3.5).
5985   if (TooManyArguments(NumParams, Args.size(), PartialOverloading) &&
5986       !Proto->isVariadic()) {
5987     Candidate.Viable = false;
5988     Candidate.FailureKind = ovl_fail_too_many_arguments;
5989     return;
5990   }
5991 
5992   // (C++ 13.3.2p2): A candidate function having more than m parameters
5993   // is viable only if the (m+1)st parameter has a default argument
5994   // (8.3.6). For the purposes of overload resolution, the
5995   // parameter list is truncated on the right, so that there are
5996   // exactly m parameters.
5997   unsigned MinRequiredArgs = Function->getMinRequiredArguments();
5998   if (Args.size() < MinRequiredArgs && !PartialOverloading) {
5999     // Not enough arguments.
6000     Candidate.Viable = false;
6001     Candidate.FailureKind = ovl_fail_too_few_arguments;
6002     return;
6003   }
6004 
6005   // (CUDA B.1): Check for invalid calls between targets.
6006   if (getLangOpts().CUDA)
6007     if (const FunctionDecl *Caller = dyn_cast<FunctionDecl>(CurContext))
6008       // Skip the check for callers that are implicit members, because in this
6009       // case we may not yet know what the member's target is; the target is
6010       // inferred for the member automatically, based on the bases and fields of
6011       // the class.
6012       if (!Caller->isImplicit() && !IsAllowedCUDACall(Caller, Function)) {
6013         Candidate.Viable = false;
6014         Candidate.FailureKind = ovl_fail_bad_target;
6015         return;
6016       }
6017 
6018   // Determine the implicit conversion sequences for each of the
6019   // arguments.
6020   for (unsigned ArgIdx = 0; ArgIdx < Args.size(); ++ArgIdx) {
6021     if (Candidate.Conversions[ArgIdx].isInitialized()) {
6022       // We already formed a conversion sequence for this parameter during
6023       // template argument deduction.
6024     } else if (ArgIdx < NumParams) {
6025       // (C++ 13.3.2p3): for F to be a viable function, there shall
6026       // exist for each argument an implicit conversion sequence
6027       // (13.3.3.1) that converts that argument to the corresponding
6028       // parameter of F.
6029       QualType ParamType = Proto->getParamType(ArgIdx);
6030       Candidate.Conversions[ArgIdx]
6031         = TryCopyInitialization(*this, Args[ArgIdx], ParamType,
6032                                 SuppressUserConversions,
6033                                 /*InOverloadResolution=*/true,
6034                                 /*AllowObjCWritebackConversion=*/
6035                                   getLangOpts().ObjCAutoRefCount,
6036                                 AllowExplicit);
6037       if (Candidate.Conversions[ArgIdx].isBad()) {
6038         Candidate.Viable = false;
6039         Candidate.FailureKind = ovl_fail_bad_conversion;
6040         return;
6041       }
6042     } else {
6043       // (C++ 13.3.2p2): For the purposes of overload resolution, any
6044       // argument for which there is no corresponding parameter is
6045       // considered to ""match the ellipsis" (C+ 13.3.3.1.3).
6046       Candidate.Conversions[ArgIdx].setEllipsis();
6047     }
6048   }
6049 
6050   if (EnableIfAttr *FailedAttr = CheckEnableIf(Function, Args)) {
6051     Candidate.Viable = false;
6052     Candidate.FailureKind = ovl_fail_enable_if;
6053     Candidate.DeductionFailure.Data = FailedAttr;
6054     return;
6055   }
6056 
6057   if (LangOpts.OpenCL && isOpenCLDisabledDecl(Function)) {
6058     Candidate.Viable = false;
6059     Candidate.FailureKind = ovl_fail_ext_disabled;
6060     return;
6061   }
6062 }
6063 
6064 ObjCMethodDecl *
6065 Sema::SelectBestMethod(Selector Sel, MultiExprArg Args, bool IsInstance,
6066                        SmallVectorImpl<ObjCMethodDecl *> &Methods) {
6067   if (Methods.size() <= 1)
6068     return nullptr;
6069 
6070   for (unsigned b = 0, e = Methods.size(); b < e; b++) {
6071     bool Match = true;
6072     ObjCMethodDecl *Method = Methods[b];
6073     unsigned NumNamedArgs = Sel.getNumArgs();
6074     // Method might have more arguments than selector indicates. This is due
6075     // to addition of c-style arguments in method.
6076     if (Method->param_size() > NumNamedArgs)
6077       NumNamedArgs = Method->param_size();
6078     if (Args.size() < NumNamedArgs)
6079       continue;
6080 
6081     for (unsigned i = 0; i < NumNamedArgs; i++) {
6082       // We can't do any type-checking on a type-dependent argument.
6083       if (Args[i]->isTypeDependent()) {
6084         Match = false;
6085         break;
6086       }
6087 
6088       ParmVarDecl *param = Method->parameters()[i];
6089       Expr *argExpr = Args[i];
6090       assert(argExpr && "SelectBestMethod(): missing expression");
6091 
6092       // Strip the unbridged-cast placeholder expression off unless it's
6093       // a consumed argument.
6094       if (argExpr->hasPlaceholderType(BuiltinType::ARCUnbridgedCast) &&
6095           !param->hasAttr<CFConsumedAttr>())
6096         argExpr = stripARCUnbridgedCast(argExpr);
6097 
6098       // If the parameter is __unknown_anytype, move on to the next method.
6099       if (param->getType() == Context.UnknownAnyTy) {
6100         Match = false;
6101         break;
6102       }
6103 
6104       ImplicitConversionSequence ConversionState
6105         = TryCopyInitialization(*this, argExpr, param->getType(),
6106                                 /*SuppressUserConversions*/false,
6107                                 /*InOverloadResolution=*/true,
6108                                 /*AllowObjCWritebackConversion=*/
6109                                 getLangOpts().ObjCAutoRefCount,
6110                                 /*AllowExplicit*/false);
6111       // This function looks for a reasonably-exact match, so we consider
6112       // incompatible pointer conversions to be a failure here.
6113       if (ConversionState.isBad() ||
6114           (ConversionState.isStandard() &&
6115            ConversionState.Standard.Second ==
6116                ICK_Incompatible_Pointer_Conversion)) {
6117         Match = false;
6118         break;
6119       }
6120     }
6121     // Promote additional arguments to variadic methods.
6122     if (Match && Method->isVariadic()) {
6123       for (unsigned i = NumNamedArgs, e = Args.size(); i < e; ++i) {
6124         if (Args[i]->isTypeDependent()) {
6125           Match = false;
6126           break;
6127         }
6128         ExprResult Arg = DefaultVariadicArgumentPromotion(Args[i], VariadicMethod,
6129                                                           nullptr);
6130         if (Arg.isInvalid()) {
6131           Match = false;
6132           break;
6133         }
6134       }
6135     } else {
6136       // Check for extra arguments to non-variadic methods.
6137       if (Args.size() != NumNamedArgs)
6138         Match = false;
6139       else if (Match && NumNamedArgs == 0 && Methods.size() > 1) {
6140         // Special case when selectors have no argument. In this case, select
6141         // one with the most general result type of 'id'.
6142         for (unsigned b = 0, e = Methods.size(); b < e; b++) {
6143           QualType ReturnT = Methods[b]->getReturnType();
6144           if (ReturnT->isObjCIdType())
6145             return Methods[b];
6146         }
6147       }
6148     }
6149 
6150     if (Match)
6151       return Method;
6152   }
6153   return nullptr;
6154 }
6155 
6156 // specific_attr_iterator iterates over enable_if attributes in reverse, and
6157 // enable_if is order-sensitive. As a result, we need to reverse things
6158 // sometimes. Size of 4 elements is arbitrary.
6159 static SmallVector<EnableIfAttr *, 4>
6160 getOrderedEnableIfAttrs(const FunctionDecl *Function) {
6161   SmallVector<EnableIfAttr *, 4> Result;
6162   if (!Function->hasAttrs())
6163     return Result;
6164 
6165   const auto &FuncAttrs = Function->getAttrs();
6166   for (Attr *Attr : FuncAttrs)
6167     if (auto *EnableIf = dyn_cast<EnableIfAttr>(Attr))
6168       Result.push_back(EnableIf);
6169 
6170   std::reverse(Result.begin(), Result.end());
6171   return Result;
6172 }
6173 
6174 static bool
6175 convertArgsForAvailabilityChecks(Sema &S, FunctionDecl *Function, Expr *ThisArg,
6176                                  ArrayRef<Expr *> Args, Sema::SFINAETrap &Trap,
6177                                  bool MissingImplicitThis, Expr *&ConvertedThis,
6178                                  SmallVectorImpl<Expr *> &ConvertedArgs) {
6179   if (ThisArg) {
6180     CXXMethodDecl *Method = cast<CXXMethodDecl>(Function);
6181     assert(!isa<CXXConstructorDecl>(Method) &&
6182            "Shouldn't have `this` for ctors!");
6183     assert(!Method->isStatic() && "Shouldn't have `this` for static methods!");
6184     ExprResult R = S.PerformObjectArgumentInitialization(
6185         ThisArg, /*Qualifier=*/nullptr, Method, Method);
6186     if (R.isInvalid())
6187       return false;
6188     ConvertedThis = R.get();
6189   } else {
6190     if (auto *MD = dyn_cast<CXXMethodDecl>(Function)) {
6191       (void)MD;
6192       assert((MissingImplicitThis || MD->isStatic() ||
6193               isa<CXXConstructorDecl>(MD)) &&
6194              "Expected `this` for non-ctor instance methods");
6195     }
6196     ConvertedThis = nullptr;
6197   }
6198 
6199   // Ignore any variadic arguments. Converting them is pointless, since the
6200   // user can't refer to them in the function condition.
6201   unsigned ArgSizeNoVarargs = std::min(Function->param_size(), Args.size());
6202 
6203   // Convert the arguments.
6204   for (unsigned I = 0; I != ArgSizeNoVarargs; ++I) {
6205     ExprResult R;
6206     R = S.PerformCopyInitialization(InitializedEntity::InitializeParameter(
6207                                         S.Context, Function->getParamDecl(I)),
6208                                     SourceLocation(), Args[I]);
6209 
6210     if (R.isInvalid())
6211       return false;
6212 
6213     ConvertedArgs.push_back(R.get());
6214   }
6215 
6216   if (Trap.hasErrorOccurred())
6217     return false;
6218 
6219   // Push default arguments if needed.
6220   if (!Function->isVariadic() && Args.size() < Function->getNumParams()) {
6221     for (unsigned i = Args.size(), e = Function->getNumParams(); i != e; ++i) {
6222       ParmVarDecl *P = Function->getParamDecl(i);
6223       ExprResult R = S.PerformCopyInitialization(
6224           InitializedEntity::InitializeParameter(S.Context,
6225                                                  Function->getParamDecl(i)),
6226           SourceLocation(),
6227           P->hasUninstantiatedDefaultArg() ? P->getUninstantiatedDefaultArg()
6228                                            : P->getDefaultArg());
6229       if (R.isInvalid())
6230         return false;
6231       ConvertedArgs.push_back(R.get());
6232     }
6233 
6234     if (Trap.hasErrorOccurred())
6235       return false;
6236   }
6237   return true;
6238 }
6239 
6240 EnableIfAttr *Sema::CheckEnableIf(FunctionDecl *Function, ArrayRef<Expr *> Args,
6241                                   bool MissingImplicitThis) {
6242   SmallVector<EnableIfAttr *, 4> EnableIfAttrs =
6243       getOrderedEnableIfAttrs(Function);
6244   if (EnableIfAttrs.empty())
6245     return nullptr;
6246 
6247   SFINAETrap Trap(*this);
6248   SmallVector<Expr *, 16> ConvertedArgs;
6249   // FIXME: We should look into making enable_if late-parsed.
6250   Expr *DiscardedThis;
6251   if (!convertArgsForAvailabilityChecks(
6252           *this, Function, /*ThisArg=*/nullptr, Args, Trap,
6253           /*MissingImplicitThis=*/true, DiscardedThis, ConvertedArgs))
6254     return EnableIfAttrs[0];
6255 
6256   for (auto *EIA : EnableIfAttrs) {
6257     APValue Result;
6258     // FIXME: This doesn't consider value-dependent cases, because doing so is
6259     // very difficult. Ideally, we should handle them more gracefully.
6260     if (!EIA->getCond()->EvaluateWithSubstitution(
6261             Result, Context, Function, llvm::makeArrayRef(ConvertedArgs)))
6262       return EIA;
6263 
6264     if (!Result.isInt() || !Result.getInt().getBoolValue())
6265       return EIA;
6266   }
6267   return nullptr;
6268 }
6269 
6270 template <typename CheckFn>
6271 static bool diagnoseDiagnoseIfAttrsWith(Sema &S, const NamedDecl *ND,
6272                                         bool ArgDependent, SourceLocation Loc,
6273                                         CheckFn &&IsSuccessful) {
6274   SmallVector<const DiagnoseIfAttr *, 8> Attrs;
6275   for (const auto *DIA : ND->specific_attrs<DiagnoseIfAttr>()) {
6276     if (ArgDependent == DIA->getArgDependent())
6277       Attrs.push_back(DIA);
6278   }
6279 
6280   // Common case: No diagnose_if attributes, so we can quit early.
6281   if (Attrs.empty())
6282     return false;
6283 
6284   auto WarningBegin = std::stable_partition(
6285       Attrs.begin(), Attrs.end(),
6286       [](const DiagnoseIfAttr *DIA) { return DIA->isError(); });
6287 
6288   // Note that diagnose_if attributes are late-parsed, so they appear in the
6289   // correct order (unlike enable_if attributes).
6290   auto ErrAttr = llvm::find_if(llvm::make_range(Attrs.begin(), WarningBegin),
6291                                IsSuccessful);
6292   if (ErrAttr != WarningBegin) {
6293     const DiagnoseIfAttr *DIA = *ErrAttr;
6294     S.Diag(Loc, diag::err_diagnose_if_succeeded) << DIA->getMessage();
6295     S.Diag(DIA->getLocation(), diag::note_from_diagnose_if)
6296         << DIA->getParent() << DIA->getCond()->getSourceRange();
6297     return true;
6298   }
6299 
6300   for (const auto *DIA : llvm::make_range(WarningBegin, Attrs.end()))
6301     if (IsSuccessful(DIA)) {
6302       S.Diag(Loc, diag::warn_diagnose_if_succeeded) << DIA->getMessage();
6303       S.Diag(DIA->getLocation(), diag::note_from_diagnose_if)
6304           << DIA->getParent() << DIA->getCond()->getSourceRange();
6305     }
6306 
6307   return false;
6308 }
6309 
6310 bool Sema::diagnoseArgDependentDiagnoseIfAttrs(const FunctionDecl *Function,
6311                                                const Expr *ThisArg,
6312                                                ArrayRef<const Expr *> Args,
6313                                                SourceLocation Loc) {
6314   return diagnoseDiagnoseIfAttrsWith(
6315       *this, Function, /*ArgDependent=*/true, Loc,
6316       [&](const DiagnoseIfAttr *DIA) {
6317         APValue Result;
6318         // It's sane to use the same Args for any redecl of this function, since
6319         // EvaluateWithSubstitution only cares about the position of each
6320         // argument in the arg list, not the ParmVarDecl* it maps to.
6321         if (!DIA->getCond()->EvaluateWithSubstitution(
6322                 Result, Context, cast<FunctionDecl>(DIA->getParent()), Args, ThisArg))
6323           return false;
6324         return Result.isInt() && Result.getInt().getBoolValue();
6325       });
6326 }
6327 
6328 bool Sema::diagnoseArgIndependentDiagnoseIfAttrs(const NamedDecl *ND,
6329                                                  SourceLocation Loc) {
6330   return diagnoseDiagnoseIfAttrsWith(
6331       *this, ND, /*ArgDependent=*/false, Loc,
6332       [&](const DiagnoseIfAttr *DIA) {
6333         bool Result;
6334         return DIA->getCond()->EvaluateAsBooleanCondition(Result, Context) &&
6335                Result;
6336       });
6337 }
6338 
6339 /// \brief Add all of the function declarations in the given function set to
6340 /// the overload candidate set.
6341 void Sema::AddFunctionCandidates(const UnresolvedSetImpl &Fns,
6342                                  ArrayRef<Expr *> Args,
6343                                  OverloadCandidateSet& CandidateSet,
6344                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
6345                                  bool SuppressUserConversions,
6346                                  bool PartialOverloading,
6347                                  bool FirstArgumentIsBase) {
6348   for (UnresolvedSetIterator F = Fns.begin(), E = Fns.end(); F != E; ++F) {
6349     NamedDecl *D = F.getDecl()->getUnderlyingDecl();
6350     if (FunctionDecl *FD = dyn_cast<FunctionDecl>(D)) {
6351       ArrayRef<Expr *> FunctionArgs = Args;
6352       if (isa<CXXMethodDecl>(FD) && !cast<CXXMethodDecl>(FD)->isStatic()) {
6353         QualType ObjectType;
6354         Expr::Classification ObjectClassification;
6355         if (Args.size() > 0) {
6356           if (Expr *E = Args[0]) {
6357             // Use the explit base to restrict the lookup:
6358             ObjectType = E->getType();
6359             ObjectClassification = E->Classify(Context);
6360           } // .. else there is an implit base.
6361           FunctionArgs = Args.slice(1);
6362         }
6363         AddMethodCandidate(cast<CXXMethodDecl>(FD), F.getPair(),
6364                            cast<CXXMethodDecl>(FD)->getParent(), ObjectType,
6365                            ObjectClassification, FunctionArgs, CandidateSet,
6366                            SuppressUserConversions, PartialOverloading);
6367       } else {
6368         // Slice the first argument (which is the base) when we access
6369         // static method as non-static
6370         if (Args.size() > 0 && (!Args[0] || (FirstArgumentIsBase && isa<CXXMethodDecl>(FD) &&
6371                                              !isa<CXXConstructorDecl>(FD)))) {
6372           assert(cast<CXXMethodDecl>(FD)->isStatic());
6373           FunctionArgs = Args.slice(1);
6374         }
6375         AddOverloadCandidate(FD, F.getPair(), FunctionArgs, CandidateSet,
6376                              SuppressUserConversions, PartialOverloading);
6377       }
6378     } else {
6379       FunctionTemplateDecl *FunTmpl = cast<FunctionTemplateDecl>(D);
6380       if (isa<CXXMethodDecl>(FunTmpl->getTemplatedDecl()) &&
6381           !cast<CXXMethodDecl>(FunTmpl->getTemplatedDecl())->isStatic()) {
6382         QualType ObjectType;
6383         Expr::Classification ObjectClassification;
6384         if (Expr *E = Args[0]) {
6385           // Use the explit base to restrict the lookup:
6386           ObjectType = E->getType();
6387           ObjectClassification = E->Classify(Context);
6388         } // .. else there is an implit base.
6389         AddMethodTemplateCandidate(
6390             FunTmpl, F.getPair(),
6391             cast<CXXRecordDecl>(FunTmpl->getDeclContext()),
6392             ExplicitTemplateArgs, ObjectType, ObjectClassification,
6393             Args.slice(1), CandidateSet, SuppressUserConversions,
6394             PartialOverloading);
6395       } else {
6396         AddTemplateOverloadCandidate(FunTmpl, F.getPair(),
6397                                      ExplicitTemplateArgs, Args,
6398                                      CandidateSet, SuppressUserConversions,
6399                                      PartialOverloading);
6400       }
6401     }
6402   }
6403 }
6404 
6405 /// AddMethodCandidate - Adds a named decl (which is some kind of
6406 /// method) as a method candidate to the given overload set.
6407 void Sema::AddMethodCandidate(DeclAccessPair FoundDecl,
6408                               QualType ObjectType,
6409                               Expr::Classification ObjectClassification,
6410                               ArrayRef<Expr *> Args,
6411                               OverloadCandidateSet& CandidateSet,
6412                               bool SuppressUserConversions) {
6413   NamedDecl *Decl = FoundDecl.getDecl();
6414   CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(Decl->getDeclContext());
6415 
6416   if (isa<UsingShadowDecl>(Decl))
6417     Decl = cast<UsingShadowDecl>(Decl)->getTargetDecl();
6418 
6419   if (FunctionTemplateDecl *TD = dyn_cast<FunctionTemplateDecl>(Decl)) {
6420     assert(isa<CXXMethodDecl>(TD->getTemplatedDecl()) &&
6421            "Expected a member function template");
6422     AddMethodTemplateCandidate(TD, FoundDecl, ActingContext,
6423                                /*ExplicitArgs*/ nullptr, ObjectType,
6424                                ObjectClassification, Args, CandidateSet,
6425                                SuppressUserConversions);
6426   } else {
6427     AddMethodCandidate(cast<CXXMethodDecl>(Decl), FoundDecl, ActingContext,
6428                        ObjectType, ObjectClassification, Args, CandidateSet,
6429                        SuppressUserConversions);
6430   }
6431 }
6432 
6433 /// AddMethodCandidate - Adds the given C++ member function to the set
6434 /// of candidate functions, using the given function call arguments
6435 /// and the object argument (@c Object). For example, in a call
6436 /// @c o.f(a1,a2), @c Object will contain @c o and @c Args will contain
6437 /// both @c a1 and @c a2. If @p SuppressUserConversions, then don't
6438 /// allow user-defined conversions via constructors or conversion
6439 /// operators.
6440 void
6441 Sema::AddMethodCandidate(CXXMethodDecl *Method, DeclAccessPair FoundDecl,
6442                          CXXRecordDecl *ActingContext, QualType ObjectType,
6443                          Expr::Classification ObjectClassification,
6444                          ArrayRef<Expr *> Args,
6445                          OverloadCandidateSet &CandidateSet,
6446                          bool SuppressUserConversions,
6447                          bool PartialOverloading,
6448                          ConversionSequenceList EarlyConversions) {
6449   const FunctionProtoType *Proto
6450     = dyn_cast<FunctionProtoType>(Method->getType()->getAs<FunctionType>());
6451   assert(Proto && "Methods without a prototype cannot be overloaded");
6452   assert(!isa<CXXConstructorDecl>(Method) &&
6453          "Use AddOverloadCandidate for constructors");
6454 
6455   if (!CandidateSet.isNewCandidate(Method))
6456     return;
6457 
6458   // C++11 [class.copy]p23: [DR1402]
6459   //   A defaulted move assignment operator that is defined as deleted is
6460   //   ignored by overload resolution.
6461   if (Method->isDefaulted() && Method->isDeleted() &&
6462       Method->isMoveAssignmentOperator())
6463     return;
6464 
6465   // Overload resolution is always an unevaluated context.
6466   EnterExpressionEvaluationContext Unevaluated(
6467       *this, Sema::ExpressionEvaluationContext::Unevaluated);
6468 
6469   // Add this candidate
6470   OverloadCandidate &Candidate =
6471       CandidateSet.addCandidate(Args.size() + 1, EarlyConversions);
6472   Candidate.FoundDecl = FoundDecl;
6473   Candidate.Function = Method;
6474   Candidate.IsSurrogate = false;
6475   Candidate.IgnoreObjectArgument = false;
6476   Candidate.ExplicitCallArguments = Args.size();
6477 
6478   unsigned NumParams = Proto->getNumParams();
6479 
6480   // (C++ 13.3.2p2): A candidate function having fewer than m
6481   // parameters is viable only if it has an ellipsis in its parameter
6482   // list (8.3.5).
6483   if (TooManyArguments(NumParams, Args.size(), PartialOverloading) &&
6484       !Proto->isVariadic()) {
6485     Candidate.Viable = false;
6486     Candidate.FailureKind = ovl_fail_too_many_arguments;
6487     return;
6488   }
6489 
6490   // (C++ 13.3.2p2): A candidate function having more than m parameters
6491   // is viable only if the (m+1)st parameter has a default argument
6492   // (8.3.6). For the purposes of overload resolution, the
6493   // parameter list is truncated on the right, so that there are
6494   // exactly m parameters.
6495   unsigned MinRequiredArgs = Method->getMinRequiredArguments();
6496   if (Args.size() < MinRequiredArgs && !PartialOverloading) {
6497     // Not enough arguments.
6498     Candidate.Viable = false;
6499     Candidate.FailureKind = ovl_fail_too_few_arguments;
6500     return;
6501   }
6502 
6503   Candidate.Viable = true;
6504 
6505   if (Method->isStatic() || ObjectType.isNull())
6506     // The implicit object argument is ignored.
6507     Candidate.IgnoreObjectArgument = true;
6508   else {
6509     // Determine the implicit conversion sequence for the object
6510     // parameter.
6511     Candidate.Conversions[0] = TryObjectArgumentInitialization(
6512         *this, CandidateSet.getLocation(), ObjectType, ObjectClassification,
6513         Method, ActingContext);
6514     if (Candidate.Conversions[0].isBad()) {
6515       Candidate.Viable = false;
6516       Candidate.FailureKind = ovl_fail_bad_conversion;
6517       return;
6518     }
6519   }
6520 
6521   // (CUDA B.1): Check for invalid calls between targets.
6522   if (getLangOpts().CUDA)
6523     if (const FunctionDecl *Caller = dyn_cast<FunctionDecl>(CurContext))
6524       if (!IsAllowedCUDACall(Caller, Method)) {
6525         Candidate.Viable = false;
6526         Candidate.FailureKind = ovl_fail_bad_target;
6527         return;
6528       }
6529 
6530   // Determine the implicit conversion sequences for each of the
6531   // arguments.
6532   for (unsigned ArgIdx = 0; ArgIdx < Args.size(); ++ArgIdx) {
6533     if (Candidate.Conversions[ArgIdx + 1].isInitialized()) {
6534       // We already formed a conversion sequence for this parameter during
6535       // template argument deduction.
6536     } else if (ArgIdx < NumParams) {
6537       // (C++ 13.3.2p3): for F to be a viable function, there shall
6538       // exist for each argument an implicit conversion sequence
6539       // (13.3.3.1) that converts that argument to the corresponding
6540       // parameter of F.
6541       QualType ParamType = Proto->getParamType(ArgIdx);
6542       Candidate.Conversions[ArgIdx + 1]
6543         = TryCopyInitialization(*this, Args[ArgIdx], ParamType,
6544                                 SuppressUserConversions,
6545                                 /*InOverloadResolution=*/true,
6546                                 /*AllowObjCWritebackConversion=*/
6547                                   getLangOpts().ObjCAutoRefCount);
6548       if (Candidate.Conversions[ArgIdx + 1].isBad()) {
6549         Candidate.Viable = false;
6550         Candidate.FailureKind = ovl_fail_bad_conversion;
6551         return;
6552       }
6553     } else {
6554       // (C++ 13.3.2p2): For the purposes of overload resolution, any
6555       // argument for which there is no corresponding parameter is
6556       // considered to "match the ellipsis" (C+ 13.3.3.1.3).
6557       Candidate.Conversions[ArgIdx + 1].setEllipsis();
6558     }
6559   }
6560 
6561   if (EnableIfAttr *FailedAttr = CheckEnableIf(Method, Args, true)) {
6562     Candidate.Viable = false;
6563     Candidate.FailureKind = ovl_fail_enable_if;
6564     Candidate.DeductionFailure.Data = FailedAttr;
6565     return;
6566   }
6567 }
6568 
6569 /// \brief Add a C++ member function template as a candidate to the candidate
6570 /// set, using template argument deduction to produce an appropriate member
6571 /// function template specialization.
6572 void
6573 Sema::AddMethodTemplateCandidate(FunctionTemplateDecl *MethodTmpl,
6574                                  DeclAccessPair FoundDecl,
6575                                  CXXRecordDecl *ActingContext,
6576                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
6577                                  QualType ObjectType,
6578                                  Expr::Classification ObjectClassification,
6579                                  ArrayRef<Expr *> Args,
6580                                  OverloadCandidateSet& CandidateSet,
6581                                  bool SuppressUserConversions,
6582                                  bool PartialOverloading) {
6583   if (!CandidateSet.isNewCandidate(MethodTmpl))
6584     return;
6585 
6586   // C++ [over.match.funcs]p7:
6587   //   In each case where a candidate is a function template, candidate
6588   //   function template specializations are generated using template argument
6589   //   deduction (14.8.3, 14.8.2). Those candidates are then handled as
6590   //   candidate functions in the usual way.113) A given name can refer to one
6591   //   or more function templates and also to a set of overloaded non-template
6592   //   functions. In such a case, the candidate functions generated from each
6593   //   function template are combined with the set of non-template candidate
6594   //   functions.
6595   TemplateDeductionInfo Info(CandidateSet.getLocation());
6596   FunctionDecl *Specialization = nullptr;
6597   ConversionSequenceList Conversions;
6598   if (TemplateDeductionResult Result = DeduceTemplateArguments(
6599           MethodTmpl, ExplicitTemplateArgs, Args, Specialization, Info,
6600           PartialOverloading, [&](ArrayRef<QualType> ParamTypes) {
6601             return CheckNonDependentConversions(
6602                 MethodTmpl, ParamTypes, Args, CandidateSet, Conversions,
6603                 SuppressUserConversions, ActingContext, ObjectType,
6604                 ObjectClassification);
6605           })) {
6606     OverloadCandidate &Candidate =
6607         CandidateSet.addCandidate(Conversions.size(), Conversions);
6608     Candidate.FoundDecl = FoundDecl;
6609     Candidate.Function = MethodTmpl->getTemplatedDecl();
6610     Candidate.Viable = false;
6611     Candidate.IsSurrogate = false;
6612     Candidate.IgnoreObjectArgument =
6613         cast<CXXMethodDecl>(Candidate.Function)->isStatic() ||
6614         ObjectType.isNull();
6615     Candidate.ExplicitCallArguments = Args.size();
6616     if (Result == TDK_NonDependentConversionFailure)
6617       Candidate.FailureKind = ovl_fail_bad_conversion;
6618     else {
6619       Candidate.FailureKind = ovl_fail_bad_deduction;
6620       Candidate.DeductionFailure = MakeDeductionFailureInfo(Context, Result,
6621                                                             Info);
6622     }
6623     return;
6624   }
6625 
6626   // Add the function template specialization produced by template argument
6627   // deduction as a candidate.
6628   assert(Specialization && "Missing member function template specialization?");
6629   assert(isa<CXXMethodDecl>(Specialization) &&
6630          "Specialization is not a member function?");
6631   AddMethodCandidate(cast<CXXMethodDecl>(Specialization), FoundDecl,
6632                      ActingContext, ObjectType, ObjectClassification, Args,
6633                      CandidateSet, SuppressUserConversions, PartialOverloading,
6634                      Conversions);
6635 }
6636 
6637 /// \brief Add a C++ function template specialization as a candidate
6638 /// in the candidate set, using template argument deduction to produce
6639 /// an appropriate function template specialization.
6640 void
6641 Sema::AddTemplateOverloadCandidate(FunctionTemplateDecl *FunctionTemplate,
6642                                    DeclAccessPair FoundDecl,
6643                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
6644                                    ArrayRef<Expr *> Args,
6645                                    OverloadCandidateSet& CandidateSet,
6646                                    bool SuppressUserConversions,
6647                                    bool PartialOverloading) {
6648   if (!CandidateSet.isNewCandidate(FunctionTemplate))
6649     return;
6650 
6651   // C++ [over.match.funcs]p7:
6652   //   In each case where a candidate is a function template, candidate
6653   //   function template specializations are generated using template argument
6654   //   deduction (14.8.3, 14.8.2). Those candidates are then handled as
6655   //   candidate functions in the usual way.113) A given name can refer to one
6656   //   or more function templates and also to a set of overloaded non-template
6657   //   functions. In such a case, the candidate functions generated from each
6658   //   function template are combined with the set of non-template candidate
6659   //   functions.
6660   TemplateDeductionInfo Info(CandidateSet.getLocation());
6661   FunctionDecl *Specialization = nullptr;
6662   ConversionSequenceList Conversions;
6663   if (TemplateDeductionResult Result = DeduceTemplateArguments(
6664           FunctionTemplate, ExplicitTemplateArgs, Args, Specialization, Info,
6665           PartialOverloading, [&](ArrayRef<QualType> ParamTypes) {
6666             return CheckNonDependentConversions(FunctionTemplate, ParamTypes,
6667                                                 Args, CandidateSet, Conversions,
6668                                                 SuppressUserConversions);
6669           })) {
6670     OverloadCandidate &Candidate =
6671         CandidateSet.addCandidate(Conversions.size(), Conversions);
6672     Candidate.FoundDecl = FoundDecl;
6673     Candidate.Function = FunctionTemplate->getTemplatedDecl();
6674     Candidate.Viable = false;
6675     Candidate.IsSurrogate = false;
6676     // Ignore the object argument if there is one, since we don't have an object
6677     // type.
6678     Candidate.IgnoreObjectArgument =
6679         isa<CXXMethodDecl>(Candidate.Function) &&
6680         !isa<CXXConstructorDecl>(Candidate.Function);
6681     Candidate.ExplicitCallArguments = Args.size();
6682     if (Result == TDK_NonDependentConversionFailure)
6683       Candidate.FailureKind = ovl_fail_bad_conversion;
6684     else {
6685       Candidate.FailureKind = ovl_fail_bad_deduction;
6686       Candidate.DeductionFailure = MakeDeductionFailureInfo(Context, Result,
6687                                                             Info);
6688     }
6689     return;
6690   }
6691 
6692   // Add the function template specialization produced by template argument
6693   // deduction as a candidate.
6694   assert(Specialization && "Missing function template specialization?");
6695   AddOverloadCandidate(Specialization, FoundDecl, Args, CandidateSet,
6696                        SuppressUserConversions, PartialOverloading,
6697                        /*AllowExplicit*/false, Conversions);
6698 }
6699 
6700 /// Check that implicit conversion sequences can be formed for each argument
6701 /// whose corresponding parameter has a non-dependent type, per DR1391's
6702 /// [temp.deduct.call]p10.
6703 bool Sema::CheckNonDependentConversions(
6704     FunctionTemplateDecl *FunctionTemplate, ArrayRef<QualType> ParamTypes,
6705     ArrayRef<Expr *> Args, OverloadCandidateSet &CandidateSet,
6706     ConversionSequenceList &Conversions, bool SuppressUserConversions,
6707     CXXRecordDecl *ActingContext, QualType ObjectType,
6708     Expr::Classification ObjectClassification) {
6709   // FIXME: The cases in which we allow explicit conversions for constructor
6710   // arguments never consider calling a constructor template. It's not clear
6711   // that is correct.
6712   const bool AllowExplicit = false;
6713 
6714   auto *FD = FunctionTemplate->getTemplatedDecl();
6715   auto *Method = dyn_cast<CXXMethodDecl>(FD);
6716   bool HasThisConversion = Method && !isa<CXXConstructorDecl>(Method);
6717   unsigned ThisConversions = HasThisConversion ? 1 : 0;
6718 
6719   Conversions =
6720       CandidateSet.allocateConversionSequences(ThisConversions + Args.size());
6721 
6722   // Overload resolution is always an unevaluated context.
6723   EnterExpressionEvaluationContext Unevaluated(
6724       *this, Sema::ExpressionEvaluationContext::Unevaluated);
6725 
6726   // For a method call, check the 'this' conversion here too. DR1391 doesn't
6727   // require that, but this check should never result in a hard error, and
6728   // overload resolution is permitted to sidestep instantiations.
6729   if (HasThisConversion && !cast<CXXMethodDecl>(FD)->isStatic() &&
6730       !ObjectType.isNull()) {
6731     Conversions[0] = TryObjectArgumentInitialization(
6732         *this, CandidateSet.getLocation(), ObjectType, ObjectClassification,
6733         Method, ActingContext);
6734     if (Conversions[0].isBad())
6735       return true;
6736   }
6737 
6738   for (unsigned I = 0, N = std::min(ParamTypes.size(), Args.size()); I != N;
6739        ++I) {
6740     QualType ParamType = ParamTypes[I];
6741     if (!ParamType->isDependentType()) {
6742       Conversions[ThisConversions + I]
6743         = TryCopyInitialization(*this, Args[I], ParamType,
6744                                 SuppressUserConversions,
6745                                 /*InOverloadResolution=*/true,
6746                                 /*AllowObjCWritebackConversion=*/
6747                                   getLangOpts().ObjCAutoRefCount,
6748                                 AllowExplicit);
6749       if (Conversions[ThisConversions + I].isBad())
6750         return true;
6751     }
6752   }
6753 
6754   return false;
6755 }
6756 
6757 /// Determine whether this is an allowable conversion from the result
6758 /// of an explicit conversion operator to the expected type, per C++
6759 /// [over.match.conv]p1 and [over.match.ref]p1.
6760 ///
6761 /// \param ConvType The return type of the conversion function.
6762 ///
6763 /// \param ToType The type we are converting to.
6764 ///
6765 /// \param AllowObjCPointerConversion Allow a conversion from one
6766 /// Objective-C pointer to another.
6767 ///
6768 /// \returns true if the conversion is allowable, false otherwise.
6769 static bool isAllowableExplicitConversion(Sema &S,
6770                                           QualType ConvType, QualType ToType,
6771                                           bool AllowObjCPointerConversion) {
6772   QualType ToNonRefType = ToType.getNonReferenceType();
6773 
6774   // Easy case: the types are the same.
6775   if (S.Context.hasSameUnqualifiedType(ConvType, ToNonRefType))
6776     return true;
6777 
6778   // Allow qualification conversions.
6779   bool ObjCLifetimeConversion;
6780   if (S.IsQualificationConversion(ConvType, ToNonRefType, /*CStyle*/false,
6781                                   ObjCLifetimeConversion))
6782     return true;
6783 
6784   // If we're not allowed to consider Objective-C pointer conversions,
6785   // we're done.
6786   if (!AllowObjCPointerConversion)
6787     return false;
6788 
6789   // Is this an Objective-C pointer conversion?
6790   bool IncompatibleObjC = false;
6791   QualType ConvertedType;
6792   return S.isObjCPointerConversion(ConvType, ToNonRefType, ConvertedType,
6793                                    IncompatibleObjC);
6794 }
6795 
6796 /// AddConversionCandidate - Add a C++ conversion function as a
6797 /// candidate in the candidate set (C++ [over.match.conv],
6798 /// C++ [over.match.copy]). From is the expression we're converting from,
6799 /// and ToType is the type that we're eventually trying to convert to
6800 /// (which may or may not be the same type as the type that the
6801 /// conversion function produces).
6802 void
6803 Sema::AddConversionCandidate(CXXConversionDecl *Conversion,
6804                              DeclAccessPair FoundDecl,
6805                              CXXRecordDecl *ActingContext,
6806                              Expr *From, QualType ToType,
6807                              OverloadCandidateSet& CandidateSet,
6808                              bool AllowObjCConversionOnExplicit,
6809                              bool AllowResultConversion) {
6810   assert(!Conversion->getDescribedFunctionTemplate() &&
6811          "Conversion function templates use AddTemplateConversionCandidate");
6812   QualType ConvType = Conversion->getConversionType().getNonReferenceType();
6813   if (!CandidateSet.isNewCandidate(Conversion))
6814     return;
6815 
6816   // If the conversion function has an undeduced return type, trigger its
6817   // deduction now.
6818   if (getLangOpts().CPlusPlus14 && ConvType->isUndeducedType()) {
6819     if (DeduceReturnType(Conversion, From->getExprLoc()))
6820       return;
6821     ConvType = Conversion->getConversionType().getNonReferenceType();
6822   }
6823 
6824   // If we don't allow any conversion of the result type, ignore conversion
6825   // functions that don't convert to exactly (possibly cv-qualified) T.
6826   if (!AllowResultConversion &&
6827       !Context.hasSameUnqualifiedType(Conversion->getConversionType(), ToType))
6828     return;
6829 
6830   // Per C++ [over.match.conv]p1, [over.match.ref]p1, an explicit conversion
6831   // operator is only a candidate if its return type is the target type or
6832   // can be converted to the target type with a qualification conversion.
6833   if (Conversion->isExplicit() &&
6834       !isAllowableExplicitConversion(*this, ConvType, ToType,
6835                                      AllowObjCConversionOnExplicit))
6836     return;
6837 
6838   // Overload resolution is always an unevaluated context.
6839   EnterExpressionEvaluationContext Unevaluated(
6840       *this, Sema::ExpressionEvaluationContext::Unevaluated);
6841 
6842   // Add this candidate
6843   OverloadCandidate &Candidate = CandidateSet.addCandidate(1);
6844   Candidate.FoundDecl = FoundDecl;
6845   Candidate.Function = Conversion;
6846   Candidate.IsSurrogate = false;
6847   Candidate.IgnoreObjectArgument = false;
6848   Candidate.FinalConversion.setAsIdentityConversion();
6849   Candidate.FinalConversion.setFromType(ConvType);
6850   Candidate.FinalConversion.setAllToTypes(ToType);
6851   Candidate.Viable = true;
6852   Candidate.ExplicitCallArguments = 1;
6853 
6854   // C++ [over.match.funcs]p4:
6855   //   For conversion functions, the function is considered to be a member of
6856   //   the class of the implicit implied object argument for the purpose of
6857   //   defining the type of the implicit object parameter.
6858   //
6859   // Determine the implicit conversion sequence for the implicit
6860   // object parameter.
6861   QualType ImplicitParamType = From->getType();
6862   if (const PointerType *FromPtrType = ImplicitParamType->getAs<PointerType>())
6863     ImplicitParamType = FromPtrType->getPointeeType();
6864   CXXRecordDecl *ConversionContext
6865     = cast<CXXRecordDecl>(ImplicitParamType->getAs<RecordType>()->getDecl());
6866 
6867   Candidate.Conversions[0] = TryObjectArgumentInitialization(
6868       *this, CandidateSet.getLocation(), From->getType(),
6869       From->Classify(Context), Conversion, ConversionContext);
6870 
6871   if (Candidate.Conversions[0].isBad()) {
6872     Candidate.Viable = false;
6873     Candidate.FailureKind = ovl_fail_bad_conversion;
6874     return;
6875   }
6876 
6877   // We won't go through a user-defined type conversion function to convert a
6878   // derived to base as such conversions are given Conversion Rank. They only
6879   // go through a copy constructor. 13.3.3.1.2-p4 [over.ics.user]
6880   QualType FromCanon
6881     = Context.getCanonicalType(From->getType().getUnqualifiedType());
6882   QualType ToCanon = Context.getCanonicalType(ToType).getUnqualifiedType();
6883   if (FromCanon == ToCanon ||
6884       IsDerivedFrom(CandidateSet.getLocation(), FromCanon, ToCanon)) {
6885     Candidate.Viable = false;
6886     Candidate.FailureKind = ovl_fail_trivial_conversion;
6887     return;
6888   }
6889 
6890   // To determine what the conversion from the result of calling the
6891   // conversion function to the type we're eventually trying to
6892   // convert to (ToType), we need to synthesize a call to the
6893   // conversion function and attempt copy initialization from it. This
6894   // makes sure that we get the right semantics with respect to
6895   // lvalues/rvalues and the type. Fortunately, we can allocate this
6896   // call on the stack and we don't need its arguments to be
6897   // well-formed.
6898   DeclRefExpr ConversionRef(Conversion, false, Conversion->getType(),
6899                             VK_LValue, From->getLocStart());
6900   ImplicitCastExpr ConversionFn(ImplicitCastExpr::OnStack,
6901                                 Context.getPointerType(Conversion->getType()),
6902                                 CK_FunctionToPointerDecay,
6903                                 &ConversionRef, VK_RValue);
6904 
6905   QualType ConversionType = Conversion->getConversionType();
6906   if (!isCompleteType(From->getLocStart(), ConversionType)) {
6907     Candidate.Viable = false;
6908     Candidate.FailureKind = ovl_fail_bad_final_conversion;
6909     return;
6910   }
6911 
6912   ExprValueKind VK = Expr::getValueKindForType(ConversionType);
6913 
6914   // Note that it is safe to allocate CallExpr on the stack here because
6915   // there are 0 arguments (i.e., nothing is allocated using ASTContext's
6916   // allocator).
6917   QualType CallResultType = ConversionType.getNonLValueExprType(Context);
6918   CallExpr Call(Context, &ConversionFn, None, CallResultType, VK,
6919                 From->getLocStart());
6920   ImplicitConversionSequence ICS =
6921     TryCopyInitialization(*this, &Call, ToType,
6922                           /*SuppressUserConversions=*/true,
6923                           /*InOverloadResolution=*/false,
6924                           /*AllowObjCWritebackConversion=*/false);
6925 
6926   switch (ICS.getKind()) {
6927   case ImplicitConversionSequence::StandardConversion:
6928     Candidate.FinalConversion = ICS.Standard;
6929 
6930     // C++ [over.ics.user]p3:
6931     //   If the user-defined conversion is specified by a specialization of a
6932     //   conversion function template, the second standard conversion sequence
6933     //   shall have exact match rank.
6934     if (Conversion->getPrimaryTemplate() &&
6935         GetConversionRank(ICS.Standard.Second) != ICR_Exact_Match) {
6936       Candidate.Viable = false;
6937       Candidate.FailureKind = ovl_fail_final_conversion_not_exact;
6938       return;
6939     }
6940 
6941     // C++0x [dcl.init.ref]p5:
6942     //    In the second case, if the reference is an rvalue reference and
6943     //    the second standard conversion sequence of the user-defined
6944     //    conversion sequence includes an lvalue-to-rvalue conversion, the
6945     //    program is ill-formed.
6946     if (ToType->isRValueReferenceType() &&
6947         ICS.Standard.First == ICK_Lvalue_To_Rvalue) {
6948       Candidate.Viable = false;
6949       Candidate.FailureKind = ovl_fail_bad_final_conversion;
6950       return;
6951     }
6952     break;
6953 
6954   case ImplicitConversionSequence::BadConversion:
6955     Candidate.Viable = false;
6956     Candidate.FailureKind = ovl_fail_bad_final_conversion;
6957     return;
6958 
6959   default:
6960     llvm_unreachable(
6961            "Can only end up with a standard conversion sequence or failure");
6962   }
6963 
6964   if (EnableIfAttr *FailedAttr = CheckEnableIf(Conversion, None)) {
6965     Candidate.Viable = false;
6966     Candidate.FailureKind = ovl_fail_enable_if;
6967     Candidate.DeductionFailure.Data = FailedAttr;
6968     return;
6969   }
6970 }
6971 
6972 /// \brief Adds a conversion function template specialization
6973 /// candidate to the overload set, using template argument deduction
6974 /// to deduce the template arguments of the conversion function
6975 /// template from the type that we are converting to (C++
6976 /// [temp.deduct.conv]).
6977 void
6978 Sema::AddTemplateConversionCandidate(FunctionTemplateDecl *FunctionTemplate,
6979                                      DeclAccessPair FoundDecl,
6980                                      CXXRecordDecl *ActingDC,
6981                                      Expr *From, QualType ToType,
6982                                      OverloadCandidateSet &CandidateSet,
6983                                      bool AllowObjCConversionOnExplicit,
6984                                      bool AllowResultConversion) {
6985   assert(isa<CXXConversionDecl>(FunctionTemplate->getTemplatedDecl()) &&
6986          "Only conversion function templates permitted here");
6987 
6988   if (!CandidateSet.isNewCandidate(FunctionTemplate))
6989     return;
6990 
6991   TemplateDeductionInfo Info(CandidateSet.getLocation());
6992   CXXConversionDecl *Specialization = nullptr;
6993   if (TemplateDeductionResult Result
6994         = DeduceTemplateArguments(FunctionTemplate, ToType,
6995                                   Specialization, Info)) {
6996     OverloadCandidate &Candidate = CandidateSet.addCandidate();
6997     Candidate.FoundDecl = FoundDecl;
6998     Candidate.Function = FunctionTemplate->getTemplatedDecl();
6999     Candidate.Viable = false;
7000     Candidate.FailureKind = ovl_fail_bad_deduction;
7001     Candidate.IsSurrogate = false;
7002     Candidate.IgnoreObjectArgument = false;
7003     Candidate.ExplicitCallArguments = 1;
7004     Candidate.DeductionFailure = MakeDeductionFailureInfo(Context, Result,
7005                                                           Info);
7006     return;
7007   }
7008 
7009   // Add the conversion function template specialization produced by
7010   // template argument deduction as a candidate.
7011   assert(Specialization && "Missing function template specialization?");
7012   AddConversionCandidate(Specialization, FoundDecl, ActingDC, From, ToType,
7013                          CandidateSet, AllowObjCConversionOnExplicit,
7014                          AllowResultConversion);
7015 }
7016 
7017 /// AddSurrogateCandidate - Adds a "surrogate" candidate function that
7018 /// converts the given @c Object to a function pointer via the
7019 /// conversion function @c Conversion, and then attempts to call it
7020 /// with the given arguments (C++ [over.call.object]p2-4). Proto is
7021 /// the type of function that we'll eventually be calling.
7022 void Sema::AddSurrogateCandidate(CXXConversionDecl *Conversion,
7023                                  DeclAccessPair FoundDecl,
7024                                  CXXRecordDecl *ActingContext,
7025                                  const FunctionProtoType *Proto,
7026                                  Expr *Object,
7027                                  ArrayRef<Expr *> Args,
7028                                  OverloadCandidateSet& CandidateSet) {
7029   if (!CandidateSet.isNewCandidate(Conversion))
7030     return;
7031 
7032   // Overload resolution is always an unevaluated context.
7033   EnterExpressionEvaluationContext Unevaluated(
7034       *this, Sema::ExpressionEvaluationContext::Unevaluated);
7035 
7036   OverloadCandidate &Candidate = CandidateSet.addCandidate(Args.size() + 1);
7037   Candidate.FoundDecl = FoundDecl;
7038   Candidate.Function = nullptr;
7039   Candidate.Surrogate = Conversion;
7040   Candidate.Viable = true;
7041   Candidate.IsSurrogate = true;
7042   Candidate.IgnoreObjectArgument = false;
7043   Candidate.ExplicitCallArguments = Args.size();
7044 
7045   // Determine the implicit conversion sequence for the implicit
7046   // object parameter.
7047   ImplicitConversionSequence ObjectInit = TryObjectArgumentInitialization(
7048       *this, CandidateSet.getLocation(), Object->getType(),
7049       Object->Classify(Context), Conversion, ActingContext);
7050   if (ObjectInit.isBad()) {
7051     Candidate.Viable = false;
7052     Candidate.FailureKind = ovl_fail_bad_conversion;
7053     Candidate.Conversions[0] = ObjectInit;
7054     return;
7055   }
7056 
7057   // The first conversion is actually a user-defined conversion whose
7058   // first conversion is ObjectInit's standard conversion (which is
7059   // effectively a reference binding). Record it as such.
7060   Candidate.Conversions[0].setUserDefined();
7061   Candidate.Conversions[0].UserDefined.Before = ObjectInit.Standard;
7062   Candidate.Conversions[0].UserDefined.EllipsisConversion = false;
7063   Candidate.Conversions[0].UserDefined.HadMultipleCandidates = false;
7064   Candidate.Conversions[0].UserDefined.ConversionFunction = Conversion;
7065   Candidate.Conversions[0].UserDefined.FoundConversionFunction = FoundDecl;
7066   Candidate.Conversions[0].UserDefined.After
7067     = Candidate.Conversions[0].UserDefined.Before;
7068   Candidate.Conversions[0].UserDefined.After.setAsIdentityConversion();
7069 
7070   // Find the
7071   unsigned NumParams = Proto->getNumParams();
7072 
7073   // (C++ 13.3.2p2): A candidate function having fewer than m
7074   // parameters is viable only if it has an ellipsis in its parameter
7075   // list (8.3.5).
7076   if (Args.size() > NumParams && !Proto->isVariadic()) {
7077     Candidate.Viable = false;
7078     Candidate.FailureKind = ovl_fail_too_many_arguments;
7079     return;
7080   }
7081 
7082   // Function types don't have any default arguments, so just check if
7083   // we have enough arguments.
7084   if (Args.size() < NumParams) {
7085     // Not enough arguments.
7086     Candidate.Viable = false;
7087     Candidate.FailureKind = ovl_fail_too_few_arguments;
7088     return;
7089   }
7090 
7091   // Determine the implicit conversion sequences for each of the
7092   // arguments.
7093   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7094     if (ArgIdx < NumParams) {
7095       // (C++ 13.3.2p3): for F to be a viable function, there shall
7096       // exist for each argument an implicit conversion sequence
7097       // (13.3.3.1) that converts that argument to the corresponding
7098       // parameter of F.
7099       QualType ParamType = Proto->getParamType(ArgIdx);
7100       Candidate.Conversions[ArgIdx + 1]
7101         = TryCopyInitialization(*this, Args[ArgIdx], ParamType,
7102                                 /*SuppressUserConversions=*/false,
7103                                 /*InOverloadResolution=*/false,
7104                                 /*AllowObjCWritebackConversion=*/
7105                                   getLangOpts().ObjCAutoRefCount);
7106       if (Candidate.Conversions[ArgIdx + 1].isBad()) {
7107         Candidate.Viable = false;
7108         Candidate.FailureKind = ovl_fail_bad_conversion;
7109         return;
7110       }
7111     } else {
7112       // (C++ 13.3.2p2): For the purposes of overload resolution, any
7113       // argument for which there is no corresponding parameter is
7114       // considered to ""match the ellipsis" (C+ 13.3.3.1.3).
7115       Candidate.Conversions[ArgIdx + 1].setEllipsis();
7116     }
7117   }
7118 
7119   if (EnableIfAttr *FailedAttr = CheckEnableIf(Conversion, None)) {
7120     Candidate.Viable = false;
7121     Candidate.FailureKind = ovl_fail_enable_if;
7122     Candidate.DeductionFailure.Data = FailedAttr;
7123     return;
7124   }
7125 }
7126 
7127 /// \brief Add overload candidates for overloaded operators that are
7128 /// member functions.
7129 ///
7130 /// Add the overloaded operator candidates that are member functions
7131 /// for the operator Op that was used in an operator expression such
7132 /// as "x Op y". , Args/NumArgs provides the operator arguments, and
7133 /// CandidateSet will store the added overload candidates. (C++
7134 /// [over.match.oper]).
7135 void Sema::AddMemberOperatorCandidates(OverloadedOperatorKind Op,
7136                                        SourceLocation OpLoc,
7137                                        ArrayRef<Expr *> Args,
7138                                        OverloadCandidateSet& CandidateSet,
7139                                        SourceRange OpRange) {
7140   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(Op);
7141 
7142   // C++ [over.match.oper]p3:
7143   //   For a unary operator @ with an operand of a type whose
7144   //   cv-unqualified version is T1, and for a binary operator @ with
7145   //   a left operand of a type whose cv-unqualified version is T1 and
7146   //   a right operand of a type whose cv-unqualified version is T2,
7147   //   three sets of candidate functions, designated member
7148   //   candidates, non-member candidates and built-in candidates, are
7149   //   constructed as follows:
7150   QualType T1 = Args[0]->getType();
7151 
7152   //     -- If T1 is a complete class type or a class currently being
7153   //        defined, the set of member candidates is the result of the
7154   //        qualified lookup of T1::operator@ (13.3.1.1.1); otherwise,
7155   //        the set of member candidates is empty.
7156   if (const RecordType *T1Rec = T1->getAs<RecordType>()) {
7157     // Complete the type if it can be completed.
7158     if (!isCompleteType(OpLoc, T1) && !T1Rec->isBeingDefined())
7159       return;
7160     // If the type is neither complete nor being defined, bail out now.
7161     if (!T1Rec->getDecl()->getDefinition())
7162       return;
7163 
7164     LookupResult Operators(*this, OpName, OpLoc, LookupOrdinaryName);
7165     LookupQualifiedName(Operators, T1Rec->getDecl());
7166     Operators.suppressDiagnostics();
7167 
7168     for (LookupResult::iterator Oper = Operators.begin(),
7169                              OperEnd = Operators.end();
7170          Oper != OperEnd;
7171          ++Oper)
7172       AddMethodCandidate(Oper.getPair(), Args[0]->getType(),
7173                          Args[0]->Classify(Context), Args.slice(1),
7174                          CandidateSet, /*SuppressUserConversions=*/false);
7175   }
7176 }
7177 
7178 /// AddBuiltinCandidate - Add a candidate for a built-in
7179 /// operator. ResultTy and ParamTys are the result and parameter types
7180 /// of the built-in candidate, respectively. Args and NumArgs are the
7181 /// arguments being passed to the candidate. IsAssignmentOperator
7182 /// should be true when this built-in candidate is an assignment
7183 /// operator. NumContextualBoolArguments is the number of arguments
7184 /// (at the beginning of the argument list) that will be contextually
7185 /// converted to bool.
7186 void Sema::AddBuiltinCandidate(QualType *ParamTys, ArrayRef<Expr *> Args,
7187                                OverloadCandidateSet& CandidateSet,
7188                                bool IsAssignmentOperator,
7189                                unsigned NumContextualBoolArguments) {
7190   // Overload resolution is always an unevaluated context.
7191   EnterExpressionEvaluationContext Unevaluated(
7192       *this, Sema::ExpressionEvaluationContext::Unevaluated);
7193 
7194   // Add this candidate
7195   OverloadCandidate &Candidate = CandidateSet.addCandidate(Args.size());
7196   Candidate.FoundDecl = DeclAccessPair::make(nullptr, AS_none);
7197   Candidate.Function = nullptr;
7198   Candidate.IsSurrogate = false;
7199   Candidate.IgnoreObjectArgument = false;
7200   std::copy(ParamTys, ParamTys + Args.size(), Candidate.BuiltinParamTypes);
7201 
7202   // Determine the implicit conversion sequences for each of the
7203   // arguments.
7204   Candidate.Viable = true;
7205   Candidate.ExplicitCallArguments = Args.size();
7206   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7207     // C++ [over.match.oper]p4:
7208     //   For the built-in assignment operators, conversions of the
7209     //   left operand are restricted as follows:
7210     //     -- no temporaries are introduced to hold the left operand, and
7211     //     -- no user-defined conversions are applied to the left
7212     //        operand to achieve a type match with the left-most
7213     //        parameter of a built-in candidate.
7214     //
7215     // We block these conversions by turning off user-defined
7216     // conversions, since that is the only way that initialization of
7217     // a reference to a non-class type can occur from something that
7218     // is not of the same type.
7219     if (ArgIdx < NumContextualBoolArguments) {
7220       assert(ParamTys[ArgIdx] == Context.BoolTy &&
7221              "Contextual conversion to bool requires bool type");
7222       Candidate.Conversions[ArgIdx]
7223         = TryContextuallyConvertToBool(*this, Args[ArgIdx]);
7224     } else {
7225       Candidate.Conversions[ArgIdx]
7226         = TryCopyInitialization(*this, Args[ArgIdx], ParamTys[ArgIdx],
7227                                 ArgIdx == 0 && IsAssignmentOperator,
7228                                 /*InOverloadResolution=*/false,
7229                                 /*AllowObjCWritebackConversion=*/
7230                                   getLangOpts().ObjCAutoRefCount);
7231     }
7232     if (Candidate.Conversions[ArgIdx].isBad()) {
7233       Candidate.Viable = false;
7234       Candidate.FailureKind = ovl_fail_bad_conversion;
7235       break;
7236     }
7237   }
7238 }
7239 
7240 namespace {
7241 
7242 /// BuiltinCandidateTypeSet - A set of types that will be used for the
7243 /// candidate operator functions for built-in operators (C++
7244 /// [over.built]). The types are separated into pointer types and
7245 /// enumeration types.
7246 class BuiltinCandidateTypeSet  {
7247   /// TypeSet - A set of types.
7248   typedef llvm::SetVector<QualType, SmallVector<QualType, 8>,
7249                           llvm::SmallPtrSet<QualType, 8>> TypeSet;
7250 
7251   /// PointerTypes - The set of pointer types that will be used in the
7252   /// built-in candidates.
7253   TypeSet PointerTypes;
7254 
7255   /// MemberPointerTypes - The set of member pointer types that will be
7256   /// used in the built-in candidates.
7257   TypeSet MemberPointerTypes;
7258 
7259   /// EnumerationTypes - The set of enumeration types that will be
7260   /// used in the built-in candidates.
7261   TypeSet EnumerationTypes;
7262 
7263   /// \brief The set of vector types that will be used in the built-in
7264   /// candidates.
7265   TypeSet VectorTypes;
7266 
7267   /// \brief A flag indicating non-record types are viable candidates
7268   bool HasNonRecordTypes;
7269 
7270   /// \brief A flag indicating whether either arithmetic or enumeration types
7271   /// were present in the candidate set.
7272   bool HasArithmeticOrEnumeralTypes;
7273 
7274   /// \brief A flag indicating whether the nullptr type was present in the
7275   /// candidate set.
7276   bool HasNullPtrType;
7277 
7278   /// Sema - The semantic analysis instance where we are building the
7279   /// candidate type set.
7280   Sema &SemaRef;
7281 
7282   /// Context - The AST context in which we will build the type sets.
7283   ASTContext &Context;
7284 
7285   bool AddPointerWithMoreQualifiedTypeVariants(QualType Ty,
7286                                                const Qualifiers &VisibleQuals);
7287   bool AddMemberPointerWithMoreQualifiedTypeVariants(QualType Ty);
7288 
7289 public:
7290   /// iterator - Iterates through the types that are part of the set.
7291   typedef TypeSet::iterator iterator;
7292 
7293   BuiltinCandidateTypeSet(Sema &SemaRef)
7294     : HasNonRecordTypes(false),
7295       HasArithmeticOrEnumeralTypes(false),
7296       HasNullPtrType(false),
7297       SemaRef(SemaRef),
7298       Context(SemaRef.Context) { }
7299 
7300   void AddTypesConvertedFrom(QualType Ty,
7301                              SourceLocation Loc,
7302                              bool AllowUserConversions,
7303                              bool AllowExplicitConversions,
7304                              const Qualifiers &VisibleTypeConversionsQuals);
7305 
7306   /// pointer_begin - First pointer type found;
7307   iterator pointer_begin() { return PointerTypes.begin(); }
7308 
7309   /// pointer_end - Past the last pointer type found;
7310   iterator pointer_end() { return PointerTypes.end(); }
7311 
7312   /// member_pointer_begin - First member pointer type found;
7313   iterator member_pointer_begin() { return MemberPointerTypes.begin(); }
7314 
7315   /// member_pointer_end - Past the last member pointer type found;
7316   iterator member_pointer_end() { return MemberPointerTypes.end(); }
7317 
7318   /// enumeration_begin - First enumeration type found;
7319   iterator enumeration_begin() { return EnumerationTypes.begin(); }
7320 
7321   /// enumeration_end - Past the last enumeration type found;
7322   iterator enumeration_end() { return EnumerationTypes.end(); }
7323 
7324   iterator vector_begin() { return VectorTypes.begin(); }
7325   iterator vector_end() { return VectorTypes.end(); }
7326 
7327   bool hasNonRecordTypes() { return HasNonRecordTypes; }
7328   bool hasArithmeticOrEnumeralTypes() { return HasArithmeticOrEnumeralTypes; }
7329   bool hasNullPtrType() const { return HasNullPtrType; }
7330 };
7331 
7332 } // end anonymous namespace
7333 
7334 /// AddPointerWithMoreQualifiedTypeVariants - Add the pointer type @p Ty to
7335 /// the set of pointer types along with any more-qualified variants of
7336 /// that type. For example, if @p Ty is "int const *", this routine
7337 /// will add "int const *", "int const volatile *", "int const
7338 /// restrict *", and "int const volatile restrict *" to the set of
7339 /// pointer types. Returns true if the add of @p Ty itself succeeded,
7340 /// false otherwise.
7341 ///
7342 /// FIXME: what to do about extended qualifiers?
7343 bool
7344 BuiltinCandidateTypeSet::AddPointerWithMoreQualifiedTypeVariants(QualType Ty,
7345                                              const Qualifiers &VisibleQuals) {
7346 
7347   // Insert this type.
7348   if (!PointerTypes.insert(Ty))
7349     return false;
7350 
7351   QualType PointeeTy;
7352   const PointerType *PointerTy = Ty->getAs<PointerType>();
7353   bool buildObjCPtr = false;
7354   if (!PointerTy) {
7355     const ObjCObjectPointerType *PTy = Ty->castAs<ObjCObjectPointerType>();
7356     PointeeTy = PTy->getPointeeType();
7357     buildObjCPtr = true;
7358   } else {
7359     PointeeTy = PointerTy->getPointeeType();
7360   }
7361 
7362   // Don't add qualified variants of arrays. For one, they're not allowed
7363   // (the qualifier would sink to the element type), and for another, the
7364   // only overload situation where it matters is subscript or pointer +- int,
7365   // and those shouldn't have qualifier variants anyway.
7366   if (PointeeTy->isArrayType())
7367     return true;
7368 
7369   unsigned BaseCVR = PointeeTy.getCVRQualifiers();
7370   bool hasVolatile = VisibleQuals.hasVolatile();
7371   bool hasRestrict = VisibleQuals.hasRestrict();
7372 
7373   // Iterate through all strict supersets of BaseCVR.
7374   for (unsigned CVR = BaseCVR+1; CVR <= Qualifiers::CVRMask; ++CVR) {
7375     if ((CVR | BaseCVR) != CVR) continue;
7376     // Skip over volatile if no volatile found anywhere in the types.
7377     if ((CVR & Qualifiers::Volatile) && !hasVolatile) continue;
7378 
7379     // Skip over restrict if no restrict found anywhere in the types, or if
7380     // the type cannot be restrict-qualified.
7381     if ((CVR & Qualifiers::Restrict) &&
7382         (!hasRestrict ||
7383          (!(PointeeTy->isAnyPointerType() || PointeeTy->isReferenceType()))))
7384       continue;
7385 
7386     // Build qualified pointee type.
7387     QualType QPointeeTy = Context.getCVRQualifiedType(PointeeTy, CVR);
7388 
7389     // Build qualified pointer type.
7390     QualType QPointerTy;
7391     if (!buildObjCPtr)
7392       QPointerTy = Context.getPointerType(QPointeeTy);
7393     else
7394       QPointerTy = Context.getObjCObjectPointerType(QPointeeTy);
7395 
7396     // Insert qualified pointer type.
7397     PointerTypes.insert(QPointerTy);
7398   }
7399 
7400   return true;
7401 }
7402 
7403 /// AddMemberPointerWithMoreQualifiedTypeVariants - Add the pointer type @p Ty
7404 /// to the set of pointer types along with any more-qualified variants of
7405 /// that type. For example, if @p Ty is "int const *", this routine
7406 /// will add "int const *", "int const volatile *", "int const
7407 /// restrict *", and "int const volatile restrict *" to the set of
7408 /// pointer types. Returns true if the add of @p Ty itself succeeded,
7409 /// false otherwise.
7410 ///
7411 /// FIXME: what to do about extended qualifiers?
7412 bool
7413 BuiltinCandidateTypeSet::AddMemberPointerWithMoreQualifiedTypeVariants(
7414     QualType Ty) {
7415   // Insert this type.
7416   if (!MemberPointerTypes.insert(Ty))
7417     return false;
7418 
7419   const MemberPointerType *PointerTy = Ty->getAs<MemberPointerType>();
7420   assert(PointerTy && "type was not a member pointer type!");
7421 
7422   QualType PointeeTy = PointerTy->getPointeeType();
7423   // Don't add qualified variants of arrays. For one, they're not allowed
7424   // (the qualifier would sink to the element type), and for another, the
7425   // only overload situation where it matters is subscript or pointer +- int,
7426   // and those shouldn't have qualifier variants anyway.
7427   if (PointeeTy->isArrayType())
7428     return true;
7429   const Type *ClassTy = PointerTy->getClass();
7430 
7431   // Iterate through all strict supersets of the pointee type's CVR
7432   // qualifiers.
7433   unsigned BaseCVR = PointeeTy.getCVRQualifiers();
7434   for (unsigned CVR = BaseCVR+1; CVR <= Qualifiers::CVRMask; ++CVR) {
7435     if ((CVR | BaseCVR) != CVR) continue;
7436 
7437     QualType QPointeeTy = Context.getCVRQualifiedType(PointeeTy, CVR);
7438     MemberPointerTypes.insert(
7439       Context.getMemberPointerType(QPointeeTy, ClassTy));
7440   }
7441 
7442   return true;
7443 }
7444 
7445 /// AddTypesConvertedFrom - Add each of the types to which the type @p
7446 /// Ty can be implicit converted to the given set of @p Types. We're
7447 /// primarily interested in pointer types and enumeration types. We also
7448 /// take member pointer types, for the conditional operator.
7449 /// AllowUserConversions is true if we should look at the conversion
7450 /// functions of a class type, and AllowExplicitConversions if we
7451 /// should also include the explicit conversion functions of a class
7452 /// type.
7453 void
7454 BuiltinCandidateTypeSet::AddTypesConvertedFrom(QualType Ty,
7455                                                SourceLocation Loc,
7456                                                bool AllowUserConversions,
7457                                                bool AllowExplicitConversions,
7458                                                const Qualifiers &VisibleQuals) {
7459   // Only deal with canonical types.
7460   Ty = Context.getCanonicalType(Ty);
7461 
7462   // Look through reference types; they aren't part of the type of an
7463   // expression for the purposes of conversions.
7464   if (const ReferenceType *RefTy = Ty->getAs<ReferenceType>())
7465     Ty = RefTy->getPointeeType();
7466 
7467   // If we're dealing with an array type, decay to the pointer.
7468   if (Ty->isArrayType())
7469     Ty = SemaRef.Context.getArrayDecayedType(Ty);
7470 
7471   // Otherwise, we don't care about qualifiers on the type.
7472   Ty = Ty.getLocalUnqualifiedType();
7473 
7474   // Flag if we ever add a non-record type.
7475   const RecordType *TyRec = Ty->getAs<RecordType>();
7476   HasNonRecordTypes = HasNonRecordTypes || !TyRec;
7477 
7478   // Flag if we encounter an arithmetic type.
7479   HasArithmeticOrEnumeralTypes =
7480     HasArithmeticOrEnumeralTypes || Ty->isArithmeticType();
7481 
7482   if (Ty->isObjCIdType() || Ty->isObjCClassType())
7483     PointerTypes.insert(Ty);
7484   else if (Ty->getAs<PointerType>() || Ty->getAs<ObjCObjectPointerType>()) {
7485     // Insert our type, and its more-qualified variants, into the set
7486     // of types.
7487     if (!AddPointerWithMoreQualifiedTypeVariants(Ty, VisibleQuals))
7488       return;
7489   } else if (Ty->isMemberPointerType()) {
7490     // Member pointers are far easier, since the pointee can't be converted.
7491     if (!AddMemberPointerWithMoreQualifiedTypeVariants(Ty))
7492       return;
7493   } else if (Ty->isEnumeralType()) {
7494     HasArithmeticOrEnumeralTypes = true;
7495     EnumerationTypes.insert(Ty);
7496   } else if (Ty->isVectorType()) {
7497     // We treat vector types as arithmetic types in many contexts as an
7498     // extension.
7499     HasArithmeticOrEnumeralTypes = true;
7500     VectorTypes.insert(Ty);
7501   } else if (Ty->isNullPtrType()) {
7502     HasNullPtrType = true;
7503   } else if (AllowUserConversions && TyRec) {
7504     // No conversion functions in incomplete types.
7505     if (!SemaRef.isCompleteType(Loc, Ty))
7506       return;
7507 
7508     CXXRecordDecl *ClassDecl = cast<CXXRecordDecl>(TyRec->getDecl());
7509     for (NamedDecl *D : ClassDecl->getVisibleConversionFunctions()) {
7510       if (isa<UsingShadowDecl>(D))
7511         D = cast<UsingShadowDecl>(D)->getTargetDecl();
7512 
7513       // Skip conversion function templates; they don't tell us anything
7514       // about which builtin types we can convert to.
7515       if (isa<FunctionTemplateDecl>(D))
7516         continue;
7517 
7518       CXXConversionDecl *Conv = cast<CXXConversionDecl>(D);
7519       if (AllowExplicitConversions || !Conv->isExplicit()) {
7520         AddTypesConvertedFrom(Conv->getConversionType(), Loc, false, false,
7521                               VisibleQuals);
7522       }
7523     }
7524   }
7525 }
7526 
7527 /// \brief Helper function for AddBuiltinOperatorCandidates() that adds
7528 /// the volatile- and non-volatile-qualified assignment operators for the
7529 /// given type to the candidate set.
7530 static void AddBuiltinAssignmentOperatorCandidates(Sema &S,
7531                                                    QualType T,
7532                                                    ArrayRef<Expr *> Args,
7533                                     OverloadCandidateSet &CandidateSet) {
7534   QualType ParamTypes[2];
7535 
7536   // T& operator=(T&, T)
7537   ParamTypes[0] = S.Context.getLValueReferenceType(T);
7538   ParamTypes[1] = T;
7539   S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
7540                         /*IsAssignmentOperator=*/true);
7541 
7542   if (!S.Context.getCanonicalType(T).isVolatileQualified()) {
7543     // volatile T& operator=(volatile T&, T)
7544     ParamTypes[0]
7545       = S.Context.getLValueReferenceType(S.Context.getVolatileType(T));
7546     ParamTypes[1] = T;
7547     S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
7548                           /*IsAssignmentOperator=*/true);
7549   }
7550 }
7551 
7552 /// CollectVRQualifiers - This routine returns Volatile/Restrict qualifiers,
7553 /// if any, found in visible type conversion functions found in ArgExpr's type.
7554 static  Qualifiers CollectVRQualifiers(ASTContext &Context, Expr* ArgExpr) {
7555     Qualifiers VRQuals;
7556     const RecordType *TyRec;
7557     if (const MemberPointerType *RHSMPType =
7558         ArgExpr->getType()->getAs<MemberPointerType>())
7559       TyRec = RHSMPType->getClass()->getAs<RecordType>();
7560     else
7561       TyRec = ArgExpr->getType()->getAs<RecordType>();
7562     if (!TyRec) {
7563       // Just to be safe, assume the worst case.
7564       VRQuals.addVolatile();
7565       VRQuals.addRestrict();
7566       return VRQuals;
7567     }
7568 
7569     CXXRecordDecl *ClassDecl = cast<CXXRecordDecl>(TyRec->getDecl());
7570     if (!ClassDecl->hasDefinition())
7571       return VRQuals;
7572 
7573     for (NamedDecl *D : ClassDecl->getVisibleConversionFunctions()) {
7574       if (isa<UsingShadowDecl>(D))
7575         D = cast<UsingShadowDecl>(D)->getTargetDecl();
7576       if (CXXConversionDecl *Conv = dyn_cast<CXXConversionDecl>(D)) {
7577         QualType CanTy = Context.getCanonicalType(Conv->getConversionType());
7578         if (const ReferenceType *ResTypeRef = CanTy->getAs<ReferenceType>())
7579           CanTy = ResTypeRef->getPointeeType();
7580         // Need to go down the pointer/mempointer chain and add qualifiers
7581         // as see them.
7582         bool done = false;
7583         while (!done) {
7584           if (CanTy.isRestrictQualified())
7585             VRQuals.addRestrict();
7586           if (const PointerType *ResTypePtr = CanTy->getAs<PointerType>())
7587             CanTy = ResTypePtr->getPointeeType();
7588           else if (const MemberPointerType *ResTypeMPtr =
7589                 CanTy->getAs<MemberPointerType>())
7590             CanTy = ResTypeMPtr->getPointeeType();
7591           else
7592             done = true;
7593           if (CanTy.isVolatileQualified())
7594             VRQuals.addVolatile();
7595           if (VRQuals.hasRestrict() && VRQuals.hasVolatile())
7596             return VRQuals;
7597         }
7598       }
7599     }
7600     return VRQuals;
7601 }
7602 
7603 namespace {
7604 
7605 /// \brief Helper class to manage the addition of builtin operator overload
7606 /// candidates. It provides shared state and utility methods used throughout
7607 /// the process, as well as a helper method to add each group of builtin
7608 /// operator overloads from the standard to a candidate set.
7609 class BuiltinOperatorOverloadBuilder {
7610   // Common instance state available to all overload candidate addition methods.
7611   Sema &S;
7612   ArrayRef<Expr *> Args;
7613   Qualifiers VisibleTypeConversionsQuals;
7614   bool HasArithmeticOrEnumeralCandidateType;
7615   SmallVectorImpl<BuiltinCandidateTypeSet> &CandidateTypes;
7616   OverloadCandidateSet &CandidateSet;
7617 
7618   static constexpr int ArithmeticTypesCap = 24;
7619   SmallVector<CanQualType, ArithmeticTypesCap> ArithmeticTypes;
7620 
7621   // Define some indices used to iterate over the arithemetic types in
7622   // ArithmeticTypes.  The "promoted arithmetic types" are the arithmetic
7623   // types are that preserved by promotion (C++ [over.built]p2).
7624   unsigned FirstIntegralType,
7625            LastIntegralType;
7626   unsigned FirstPromotedIntegralType,
7627            LastPromotedIntegralType;
7628   unsigned FirstPromotedArithmeticType,
7629            LastPromotedArithmeticType;
7630   unsigned NumArithmeticTypes;
7631 
7632   void InitArithmeticTypes() {
7633     // Start of promoted types.
7634     FirstPromotedArithmeticType = 0;
7635     ArithmeticTypes.push_back(S.Context.FloatTy);
7636     ArithmeticTypes.push_back(S.Context.DoubleTy);
7637     ArithmeticTypes.push_back(S.Context.LongDoubleTy);
7638     if (S.Context.getTargetInfo().hasFloat128Type())
7639       ArithmeticTypes.push_back(S.Context.Float128Ty);
7640 
7641     // Start of integral types.
7642     FirstIntegralType = ArithmeticTypes.size();
7643     FirstPromotedIntegralType = ArithmeticTypes.size();
7644     ArithmeticTypes.push_back(S.Context.IntTy);
7645     ArithmeticTypes.push_back(S.Context.LongTy);
7646     ArithmeticTypes.push_back(S.Context.LongLongTy);
7647     if (S.Context.getTargetInfo().hasInt128Type())
7648       ArithmeticTypes.push_back(S.Context.Int128Ty);
7649     ArithmeticTypes.push_back(S.Context.UnsignedIntTy);
7650     ArithmeticTypes.push_back(S.Context.UnsignedLongTy);
7651     ArithmeticTypes.push_back(S.Context.UnsignedLongLongTy);
7652     if (S.Context.getTargetInfo().hasInt128Type())
7653       ArithmeticTypes.push_back(S.Context.UnsignedInt128Ty);
7654     LastPromotedIntegralType = ArithmeticTypes.size();
7655     LastPromotedArithmeticType = ArithmeticTypes.size();
7656     // End of promoted types.
7657 
7658     ArithmeticTypes.push_back(S.Context.BoolTy);
7659     ArithmeticTypes.push_back(S.Context.CharTy);
7660     ArithmeticTypes.push_back(S.Context.WCharTy);
7661     ArithmeticTypes.push_back(S.Context.Char16Ty);
7662     ArithmeticTypes.push_back(S.Context.Char32Ty);
7663     ArithmeticTypes.push_back(S.Context.SignedCharTy);
7664     ArithmeticTypes.push_back(S.Context.ShortTy);
7665     ArithmeticTypes.push_back(S.Context.UnsignedCharTy);
7666     ArithmeticTypes.push_back(S.Context.UnsignedShortTy);
7667     LastIntegralType = ArithmeticTypes.size();
7668     NumArithmeticTypes = ArithmeticTypes.size();
7669     // End of integral types.
7670     // FIXME: What about complex? What about half?
7671 
7672     assert(ArithmeticTypes.size() <= ArithmeticTypesCap &&
7673            "Enough inline storage for all arithmetic types.");
7674   }
7675 
7676   /// \brief Helper method to factor out the common pattern of adding overloads
7677   /// for '++' and '--' builtin operators.
7678   void addPlusPlusMinusMinusStyleOverloads(QualType CandidateTy,
7679                                            bool HasVolatile,
7680                                            bool HasRestrict) {
7681     QualType ParamTypes[2] = {
7682       S.Context.getLValueReferenceType(CandidateTy),
7683       S.Context.IntTy
7684     };
7685 
7686     // Non-volatile version.
7687     S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
7688 
7689     // Use a heuristic to reduce number of builtin candidates in the set:
7690     // add volatile version only if there are conversions to a volatile type.
7691     if (HasVolatile) {
7692       ParamTypes[0] =
7693         S.Context.getLValueReferenceType(
7694           S.Context.getVolatileType(CandidateTy));
7695       S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
7696     }
7697 
7698     // Add restrict version only if there are conversions to a restrict type
7699     // and our candidate type is a non-restrict-qualified pointer.
7700     if (HasRestrict && CandidateTy->isAnyPointerType() &&
7701         !CandidateTy.isRestrictQualified()) {
7702       ParamTypes[0]
7703         = S.Context.getLValueReferenceType(
7704             S.Context.getCVRQualifiedType(CandidateTy, Qualifiers::Restrict));
7705       S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
7706 
7707       if (HasVolatile) {
7708         ParamTypes[0]
7709           = S.Context.getLValueReferenceType(
7710               S.Context.getCVRQualifiedType(CandidateTy,
7711                                             (Qualifiers::Volatile |
7712                                              Qualifiers::Restrict)));
7713         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
7714       }
7715     }
7716 
7717   }
7718 
7719 public:
7720   BuiltinOperatorOverloadBuilder(
7721     Sema &S, ArrayRef<Expr *> Args,
7722     Qualifiers VisibleTypeConversionsQuals,
7723     bool HasArithmeticOrEnumeralCandidateType,
7724     SmallVectorImpl<BuiltinCandidateTypeSet> &CandidateTypes,
7725     OverloadCandidateSet &CandidateSet)
7726     : S(S), Args(Args),
7727       VisibleTypeConversionsQuals(VisibleTypeConversionsQuals),
7728       HasArithmeticOrEnumeralCandidateType(
7729         HasArithmeticOrEnumeralCandidateType),
7730       CandidateTypes(CandidateTypes),
7731       CandidateSet(CandidateSet) {
7732 
7733     InitArithmeticTypes();
7734   }
7735 
7736   // C++ [over.built]p3:
7737   //
7738   //   For every pair (T, VQ), where T is an arithmetic type, and VQ
7739   //   is either volatile or empty, there exist candidate operator
7740   //   functions of the form
7741   //
7742   //       VQ T&      operator++(VQ T&);
7743   //       T          operator++(VQ T&, int);
7744   //
7745   // C++ [over.built]p4:
7746   //
7747   //   For every pair (T, VQ), where T is an arithmetic type other
7748   //   than bool, and VQ is either volatile or empty, there exist
7749   //   candidate operator functions of the form
7750   //
7751   //       VQ T&      operator--(VQ T&);
7752   //       T          operator--(VQ T&, int);
7753   void addPlusPlusMinusMinusArithmeticOverloads(OverloadedOperatorKind Op) {
7754     if (!HasArithmeticOrEnumeralCandidateType)
7755       return;
7756 
7757     for (unsigned Arith = (Op == OO_PlusPlus? 0 : 1);
7758          Arith < NumArithmeticTypes; ++Arith) {
7759       addPlusPlusMinusMinusStyleOverloads(
7760         ArithmeticTypes[Arith],
7761         VisibleTypeConversionsQuals.hasVolatile(),
7762         VisibleTypeConversionsQuals.hasRestrict());
7763     }
7764   }
7765 
7766   // C++ [over.built]p5:
7767   //
7768   //   For every pair (T, VQ), where T is a cv-qualified or
7769   //   cv-unqualified object type, and VQ is either volatile or
7770   //   empty, there exist candidate operator functions of the form
7771   //
7772   //       T*VQ&      operator++(T*VQ&);
7773   //       T*VQ&      operator--(T*VQ&);
7774   //       T*         operator++(T*VQ&, int);
7775   //       T*         operator--(T*VQ&, int);
7776   void addPlusPlusMinusMinusPointerOverloads() {
7777     for (BuiltinCandidateTypeSet::iterator
7778               Ptr = CandidateTypes[0].pointer_begin(),
7779            PtrEnd = CandidateTypes[0].pointer_end();
7780          Ptr != PtrEnd; ++Ptr) {
7781       // Skip pointer types that aren't pointers to object types.
7782       if (!(*Ptr)->getPointeeType()->isObjectType())
7783         continue;
7784 
7785       addPlusPlusMinusMinusStyleOverloads(*Ptr,
7786         (!(*Ptr).isVolatileQualified() &&
7787          VisibleTypeConversionsQuals.hasVolatile()),
7788         (!(*Ptr).isRestrictQualified() &&
7789          VisibleTypeConversionsQuals.hasRestrict()));
7790     }
7791   }
7792 
7793   // C++ [over.built]p6:
7794   //   For every cv-qualified or cv-unqualified object type T, there
7795   //   exist candidate operator functions of the form
7796   //
7797   //       T&         operator*(T*);
7798   //
7799   // C++ [over.built]p7:
7800   //   For every function type T that does not have cv-qualifiers or a
7801   //   ref-qualifier, there exist candidate operator functions of the form
7802   //       T&         operator*(T*);
7803   void addUnaryStarPointerOverloads() {
7804     for (BuiltinCandidateTypeSet::iterator
7805               Ptr = CandidateTypes[0].pointer_begin(),
7806            PtrEnd = CandidateTypes[0].pointer_end();
7807          Ptr != PtrEnd; ++Ptr) {
7808       QualType ParamTy = *Ptr;
7809       QualType PointeeTy = ParamTy->getPointeeType();
7810       if (!PointeeTy->isObjectType() && !PointeeTy->isFunctionType())
7811         continue;
7812 
7813       if (const FunctionProtoType *Proto =PointeeTy->getAs<FunctionProtoType>())
7814         if (Proto->getTypeQuals() || Proto->getRefQualifier())
7815           continue;
7816 
7817       S.AddBuiltinCandidate(&ParamTy, Args, CandidateSet);
7818     }
7819   }
7820 
7821   // C++ [over.built]p9:
7822   //  For every promoted arithmetic type T, there exist candidate
7823   //  operator functions of the form
7824   //
7825   //       T         operator+(T);
7826   //       T         operator-(T);
7827   void addUnaryPlusOrMinusArithmeticOverloads() {
7828     if (!HasArithmeticOrEnumeralCandidateType)
7829       return;
7830 
7831     for (unsigned Arith = FirstPromotedArithmeticType;
7832          Arith < LastPromotedArithmeticType; ++Arith) {
7833       QualType ArithTy = ArithmeticTypes[Arith];
7834       S.AddBuiltinCandidate(&ArithTy, Args, CandidateSet);
7835     }
7836 
7837     // Extension: We also add these operators for vector types.
7838     for (BuiltinCandidateTypeSet::iterator
7839               Vec = CandidateTypes[0].vector_begin(),
7840            VecEnd = CandidateTypes[0].vector_end();
7841          Vec != VecEnd; ++Vec) {
7842       QualType VecTy = *Vec;
7843       S.AddBuiltinCandidate(&VecTy, Args, CandidateSet);
7844     }
7845   }
7846 
7847   // C++ [over.built]p8:
7848   //   For every type T, there exist candidate operator functions of
7849   //   the form
7850   //
7851   //       T*         operator+(T*);
7852   void addUnaryPlusPointerOverloads() {
7853     for (BuiltinCandidateTypeSet::iterator
7854               Ptr = CandidateTypes[0].pointer_begin(),
7855            PtrEnd = CandidateTypes[0].pointer_end();
7856          Ptr != PtrEnd; ++Ptr) {
7857       QualType ParamTy = *Ptr;
7858       S.AddBuiltinCandidate(&ParamTy, Args, CandidateSet);
7859     }
7860   }
7861 
7862   // C++ [over.built]p10:
7863   //   For every promoted integral type T, there exist candidate
7864   //   operator functions of the form
7865   //
7866   //        T         operator~(T);
7867   void addUnaryTildePromotedIntegralOverloads() {
7868     if (!HasArithmeticOrEnumeralCandidateType)
7869       return;
7870 
7871     for (unsigned Int = FirstPromotedIntegralType;
7872          Int < LastPromotedIntegralType; ++Int) {
7873       QualType IntTy = ArithmeticTypes[Int];
7874       S.AddBuiltinCandidate(&IntTy, Args, CandidateSet);
7875     }
7876 
7877     // Extension: We also add this operator for vector types.
7878     for (BuiltinCandidateTypeSet::iterator
7879               Vec = CandidateTypes[0].vector_begin(),
7880            VecEnd = CandidateTypes[0].vector_end();
7881          Vec != VecEnd; ++Vec) {
7882       QualType VecTy = *Vec;
7883       S.AddBuiltinCandidate(&VecTy, Args, CandidateSet);
7884     }
7885   }
7886 
7887   // C++ [over.match.oper]p16:
7888   //   For every pointer to member type T or type std::nullptr_t, there
7889   //   exist candidate operator functions of the form
7890   //
7891   //        bool operator==(T,T);
7892   //        bool operator!=(T,T);
7893   void addEqualEqualOrNotEqualMemberPointerOrNullptrOverloads() {
7894     /// Set of (canonical) types that we've already handled.
7895     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7896 
7897     for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7898       for (BuiltinCandidateTypeSet::iterator
7899                 MemPtr = CandidateTypes[ArgIdx].member_pointer_begin(),
7900              MemPtrEnd = CandidateTypes[ArgIdx].member_pointer_end();
7901            MemPtr != MemPtrEnd;
7902            ++MemPtr) {
7903         // Don't add the same builtin candidate twice.
7904         if (!AddedTypes.insert(S.Context.getCanonicalType(*MemPtr)).second)
7905           continue;
7906 
7907         QualType ParamTypes[2] = { *MemPtr, *MemPtr };
7908         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
7909       }
7910 
7911       if (CandidateTypes[ArgIdx].hasNullPtrType()) {
7912         CanQualType NullPtrTy = S.Context.getCanonicalType(S.Context.NullPtrTy);
7913         if (AddedTypes.insert(NullPtrTy).second) {
7914           QualType ParamTypes[2] = { NullPtrTy, NullPtrTy };
7915           S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
7916         }
7917       }
7918     }
7919   }
7920 
7921   // C++ [over.built]p15:
7922   //
7923   //   For every T, where T is an enumeration type or a pointer type,
7924   //   there exist candidate operator functions of the form
7925   //
7926   //        bool       operator<(T, T);
7927   //        bool       operator>(T, T);
7928   //        bool       operator<=(T, T);
7929   //        bool       operator>=(T, T);
7930   //        bool       operator==(T, T);
7931   //        bool       operator!=(T, T);
7932   void addRelationalPointerOrEnumeralOverloads() {
7933     // C++ [over.match.oper]p3:
7934     //   [...]the built-in candidates include all of the candidate operator
7935     //   functions defined in 13.6 that, compared to the given operator, [...]
7936     //   do not have the same parameter-type-list as any non-template non-member
7937     //   candidate.
7938     //
7939     // Note that in practice, this only affects enumeration types because there
7940     // aren't any built-in candidates of record type, and a user-defined operator
7941     // must have an operand of record or enumeration type. Also, the only other
7942     // overloaded operator with enumeration arguments, operator=,
7943     // cannot be overloaded for enumeration types, so this is the only place
7944     // where we must suppress candidates like this.
7945     llvm::DenseSet<std::pair<CanQualType, CanQualType> >
7946       UserDefinedBinaryOperators;
7947 
7948     for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7949       if (CandidateTypes[ArgIdx].enumeration_begin() !=
7950           CandidateTypes[ArgIdx].enumeration_end()) {
7951         for (OverloadCandidateSet::iterator C = CandidateSet.begin(),
7952                                          CEnd = CandidateSet.end();
7953              C != CEnd; ++C) {
7954           if (!C->Viable || !C->Function || C->Function->getNumParams() != 2)
7955             continue;
7956 
7957           if (C->Function->isFunctionTemplateSpecialization())
7958             continue;
7959 
7960           QualType FirstParamType =
7961             C->Function->getParamDecl(0)->getType().getUnqualifiedType();
7962           QualType SecondParamType =
7963             C->Function->getParamDecl(1)->getType().getUnqualifiedType();
7964 
7965           // Skip if either parameter isn't of enumeral type.
7966           if (!FirstParamType->isEnumeralType() ||
7967               !SecondParamType->isEnumeralType())
7968             continue;
7969 
7970           // Add this operator to the set of known user-defined operators.
7971           UserDefinedBinaryOperators.insert(
7972             std::make_pair(S.Context.getCanonicalType(FirstParamType),
7973                            S.Context.getCanonicalType(SecondParamType)));
7974         }
7975       }
7976     }
7977 
7978     /// Set of (canonical) types that we've already handled.
7979     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7980 
7981     for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7982       for (BuiltinCandidateTypeSet::iterator
7983                 Ptr = CandidateTypes[ArgIdx].pointer_begin(),
7984              PtrEnd = CandidateTypes[ArgIdx].pointer_end();
7985            Ptr != PtrEnd; ++Ptr) {
7986         // Don't add the same builtin candidate twice.
7987         if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)).second)
7988           continue;
7989 
7990         QualType ParamTypes[2] = { *Ptr, *Ptr };
7991         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
7992       }
7993       for (BuiltinCandidateTypeSet::iterator
7994                 Enum = CandidateTypes[ArgIdx].enumeration_begin(),
7995              EnumEnd = CandidateTypes[ArgIdx].enumeration_end();
7996            Enum != EnumEnd; ++Enum) {
7997         CanQualType CanonType = S.Context.getCanonicalType(*Enum);
7998 
7999         // Don't add the same builtin candidate twice, or if a user defined
8000         // candidate exists.
8001         if (!AddedTypes.insert(CanonType).second ||
8002             UserDefinedBinaryOperators.count(std::make_pair(CanonType,
8003                                                             CanonType)))
8004           continue;
8005 
8006         QualType ParamTypes[2] = { *Enum, *Enum };
8007         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
8008       }
8009     }
8010   }
8011 
8012   // C++ [over.built]p13:
8013   //
8014   //   For every cv-qualified or cv-unqualified object type T
8015   //   there exist candidate operator functions of the form
8016   //
8017   //      T*         operator+(T*, ptrdiff_t);
8018   //      T&         operator[](T*, ptrdiff_t);    [BELOW]
8019   //      T*         operator-(T*, ptrdiff_t);
8020   //      T*         operator+(ptrdiff_t, T*);
8021   //      T&         operator[](ptrdiff_t, T*);    [BELOW]
8022   //
8023   // C++ [over.built]p14:
8024   //
8025   //   For every T, where T is a pointer to object type, there
8026   //   exist candidate operator functions of the form
8027   //
8028   //      ptrdiff_t  operator-(T, T);
8029   void addBinaryPlusOrMinusPointerOverloads(OverloadedOperatorKind Op) {
8030     /// Set of (canonical) types that we've already handled.
8031     llvm::SmallPtrSet<QualType, 8> AddedTypes;
8032 
8033     for (int Arg = 0; Arg < 2; ++Arg) {
8034       QualType AsymmetricParamTypes[2] = {
8035         S.Context.getPointerDiffType(),
8036         S.Context.getPointerDiffType(),
8037       };
8038       for (BuiltinCandidateTypeSet::iterator
8039                 Ptr = CandidateTypes[Arg].pointer_begin(),
8040              PtrEnd = CandidateTypes[Arg].pointer_end();
8041            Ptr != PtrEnd; ++Ptr) {
8042         QualType PointeeTy = (*Ptr)->getPointeeType();
8043         if (!PointeeTy->isObjectType())
8044           continue;
8045 
8046         AsymmetricParamTypes[Arg] = *Ptr;
8047         if (Arg == 0 || Op == OO_Plus) {
8048           // operator+(T*, ptrdiff_t) or operator-(T*, ptrdiff_t)
8049           // T* operator+(ptrdiff_t, T*);
8050           S.AddBuiltinCandidate(AsymmetricParamTypes, Args, CandidateSet);
8051         }
8052         if (Op == OO_Minus) {
8053           // ptrdiff_t operator-(T, T);
8054           if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)).second)
8055             continue;
8056 
8057           QualType ParamTypes[2] = { *Ptr, *Ptr };
8058           S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
8059         }
8060       }
8061     }
8062   }
8063 
8064   // C++ [over.built]p12:
8065   //
8066   //   For every pair of promoted arithmetic types L and R, there
8067   //   exist candidate operator functions of the form
8068   //
8069   //        LR         operator*(L, R);
8070   //        LR         operator/(L, R);
8071   //        LR         operator+(L, R);
8072   //        LR         operator-(L, R);
8073   //        bool       operator<(L, R);
8074   //        bool       operator>(L, R);
8075   //        bool       operator<=(L, R);
8076   //        bool       operator>=(L, R);
8077   //        bool       operator==(L, R);
8078   //        bool       operator!=(L, R);
8079   //
8080   //   where LR is the result of the usual arithmetic conversions
8081   //   between types L and R.
8082   //
8083   // C++ [over.built]p24:
8084   //
8085   //   For every pair of promoted arithmetic types L and R, there exist
8086   //   candidate operator functions of the form
8087   //
8088   //        LR       operator?(bool, L, R);
8089   //
8090   //   where LR is the result of the usual arithmetic conversions
8091   //   between types L and R.
8092   // Our candidates ignore the first parameter.
8093   void addGenericBinaryArithmeticOverloads() {
8094     if (!HasArithmeticOrEnumeralCandidateType)
8095       return;
8096 
8097     for (unsigned Left = FirstPromotedArithmeticType;
8098          Left < LastPromotedArithmeticType; ++Left) {
8099       for (unsigned Right = FirstPromotedArithmeticType;
8100            Right < LastPromotedArithmeticType; ++Right) {
8101         QualType LandR[2] = { ArithmeticTypes[Left],
8102                               ArithmeticTypes[Right] };
8103         S.AddBuiltinCandidate(LandR, Args, CandidateSet);
8104       }
8105     }
8106 
8107     // Extension: Add the binary operators ==, !=, <, <=, >=, >, *, /, and the
8108     // conditional operator for vector types.
8109     for (BuiltinCandidateTypeSet::iterator
8110               Vec1 = CandidateTypes[0].vector_begin(),
8111            Vec1End = CandidateTypes[0].vector_end();
8112          Vec1 != Vec1End; ++Vec1) {
8113       for (BuiltinCandidateTypeSet::iterator
8114                 Vec2 = CandidateTypes[1].vector_begin(),
8115              Vec2End = CandidateTypes[1].vector_end();
8116            Vec2 != Vec2End; ++Vec2) {
8117         QualType LandR[2] = { *Vec1, *Vec2 };
8118         S.AddBuiltinCandidate(LandR, Args, CandidateSet);
8119       }
8120     }
8121   }
8122 
8123   // C++ [over.built]p17:
8124   //
8125   //   For every pair of promoted integral types L and R, there
8126   //   exist candidate operator functions of the form
8127   //
8128   //      LR         operator%(L, R);
8129   //      LR         operator&(L, R);
8130   //      LR         operator^(L, R);
8131   //      LR         operator|(L, R);
8132   //      L          operator<<(L, R);
8133   //      L          operator>>(L, R);
8134   //
8135   //   where LR is the result of the usual arithmetic conversions
8136   //   between types L and R.
8137   void addBinaryBitwiseArithmeticOverloads(OverloadedOperatorKind Op) {
8138     if (!HasArithmeticOrEnumeralCandidateType)
8139       return;
8140 
8141     for (unsigned Left = FirstPromotedIntegralType;
8142          Left < LastPromotedIntegralType; ++Left) {
8143       for (unsigned Right = FirstPromotedIntegralType;
8144            Right < LastPromotedIntegralType; ++Right) {
8145         QualType LandR[2] = { ArithmeticTypes[Left],
8146                               ArithmeticTypes[Right] };
8147         S.AddBuiltinCandidate(LandR, Args, CandidateSet);
8148       }
8149     }
8150   }
8151 
8152   // C++ [over.built]p20:
8153   //
8154   //   For every pair (T, VQ), where T is an enumeration or
8155   //   pointer to member type and VQ is either volatile or
8156   //   empty, there exist candidate operator functions of the form
8157   //
8158   //        VQ T&      operator=(VQ T&, T);
8159   void addAssignmentMemberPointerOrEnumeralOverloads() {
8160     /// Set of (canonical) types that we've already handled.
8161     llvm::SmallPtrSet<QualType, 8> AddedTypes;
8162 
8163     for (unsigned ArgIdx = 0; ArgIdx < 2; ++ArgIdx) {
8164       for (BuiltinCandidateTypeSet::iterator
8165                 Enum = CandidateTypes[ArgIdx].enumeration_begin(),
8166              EnumEnd = CandidateTypes[ArgIdx].enumeration_end();
8167            Enum != EnumEnd; ++Enum) {
8168         if (!AddedTypes.insert(S.Context.getCanonicalType(*Enum)).second)
8169           continue;
8170 
8171         AddBuiltinAssignmentOperatorCandidates(S, *Enum, Args, CandidateSet);
8172       }
8173 
8174       for (BuiltinCandidateTypeSet::iterator
8175                 MemPtr = CandidateTypes[ArgIdx].member_pointer_begin(),
8176              MemPtrEnd = CandidateTypes[ArgIdx].member_pointer_end();
8177            MemPtr != MemPtrEnd; ++MemPtr) {
8178         if (!AddedTypes.insert(S.Context.getCanonicalType(*MemPtr)).second)
8179           continue;
8180 
8181         AddBuiltinAssignmentOperatorCandidates(S, *MemPtr, Args, CandidateSet);
8182       }
8183     }
8184   }
8185 
8186   // C++ [over.built]p19:
8187   //
8188   //   For every pair (T, VQ), where T is any type and VQ is either
8189   //   volatile or empty, there exist candidate operator functions
8190   //   of the form
8191   //
8192   //        T*VQ&      operator=(T*VQ&, T*);
8193   //
8194   // C++ [over.built]p21:
8195   //
8196   //   For every pair (T, VQ), where T is a cv-qualified or
8197   //   cv-unqualified object type and VQ is either volatile or
8198   //   empty, there exist candidate operator functions of the form
8199   //
8200   //        T*VQ&      operator+=(T*VQ&, ptrdiff_t);
8201   //        T*VQ&      operator-=(T*VQ&, ptrdiff_t);
8202   void addAssignmentPointerOverloads(bool isEqualOp) {
8203     /// Set of (canonical) types that we've already handled.
8204     llvm::SmallPtrSet<QualType, 8> AddedTypes;
8205 
8206     for (BuiltinCandidateTypeSet::iterator
8207               Ptr = CandidateTypes[0].pointer_begin(),
8208            PtrEnd = CandidateTypes[0].pointer_end();
8209          Ptr != PtrEnd; ++Ptr) {
8210       // If this is operator=, keep track of the builtin candidates we added.
8211       if (isEqualOp)
8212         AddedTypes.insert(S.Context.getCanonicalType(*Ptr));
8213       else if (!(*Ptr)->getPointeeType()->isObjectType())
8214         continue;
8215 
8216       // non-volatile version
8217       QualType ParamTypes[2] = {
8218         S.Context.getLValueReferenceType(*Ptr),
8219         isEqualOp ? *Ptr : S.Context.getPointerDiffType(),
8220       };
8221       S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8222                             /*IsAssigmentOperator=*/ isEqualOp);
8223 
8224       bool NeedVolatile = !(*Ptr).isVolatileQualified() &&
8225                           VisibleTypeConversionsQuals.hasVolatile();
8226       if (NeedVolatile) {
8227         // volatile version
8228         ParamTypes[0] =
8229           S.Context.getLValueReferenceType(S.Context.getVolatileType(*Ptr));
8230         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8231                               /*IsAssigmentOperator=*/isEqualOp);
8232       }
8233 
8234       if (!(*Ptr).isRestrictQualified() &&
8235           VisibleTypeConversionsQuals.hasRestrict()) {
8236         // restrict version
8237         ParamTypes[0]
8238           = S.Context.getLValueReferenceType(S.Context.getRestrictType(*Ptr));
8239         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8240                               /*IsAssigmentOperator=*/isEqualOp);
8241 
8242         if (NeedVolatile) {
8243           // volatile restrict version
8244           ParamTypes[0]
8245             = S.Context.getLValueReferenceType(
8246                 S.Context.getCVRQualifiedType(*Ptr,
8247                                               (Qualifiers::Volatile |
8248                                                Qualifiers::Restrict)));
8249           S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8250                                 /*IsAssigmentOperator=*/isEqualOp);
8251         }
8252       }
8253     }
8254 
8255     if (isEqualOp) {
8256       for (BuiltinCandidateTypeSet::iterator
8257                 Ptr = CandidateTypes[1].pointer_begin(),
8258              PtrEnd = CandidateTypes[1].pointer_end();
8259            Ptr != PtrEnd; ++Ptr) {
8260         // Make sure we don't add the same candidate twice.
8261         if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)).second)
8262           continue;
8263 
8264         QualType ParamTypes[2] = {
8265           S.Context.getLValueReferenceType(*Ptr),
8266           *Ptr,
8267         };
8268 
8269         // non-volatile version
8270         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8271                               /*IsAssigmentOperator=*/true);
8272 
8273         bool NeedVolatile = !(*Ptr).isVolatileQualified() &&
8274                            VisibleTypeConversionsQuals.hasVolatile();
8275         if (NeedVolatile) {
8276           // volatile version
8277           ParamTypes[0] =
8278             S.Context.getLValueReferenceType(S.Context.getVolatileType(*Ptr));
8279           S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8280                                 /*IsAssigmentOperator=*/true);
8281         }
8282 
8283         if (!(*Ptr).isRestrictQualified() &&
8284             VisibleTypeConversionsQuals.hasRestrict()) {
8285           // restrict version
8286           ParamTypes[0]
8287             = S.Context.getLValueReferenceType(S.Context.getRestrictType(*Ptr));
8288           S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8289                                 /*IsAssigmentOperator=*/true);
8290 
8291           if (NeedVolatile) {
8292             // volatile restrict version
8293             ParamTypes[0]
8294               = S.Context.getLValueReferenceType(
8295                   S.Context.getCVRQualifiedType(*Ptr,
8296                                                 (Qualifiers::Volatile |
8297                                                  Qualifiers::Restrict)));
8298             S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8299                                   /*IsAssigmentOperator=*/true);
8300           }
8301         }
8302       }
8303     }
8304   }
8305 
8306   // C++ [over.built]p18:
8307   //
8308   //   For every triple (L, VQ, R), where L is an arithmetic type,
8309   //   VQ is either volatile or empty, and R is a promoted
8310   //   arithmetic type, there exist candidate operator functions of
8311   //   the form
8312   //
8313   //        VQ L&      operator=(VQ L&, R);
8314   //        VQ L&      operator*=(VQ L&, R);
8315   //        VQ L&      operator/=(VQ L&, R);
8316   //        VQ L&      operator+=(VQ L&, R);
8317   //        VQ L&      operator-=(VQ L&, R);
8318   void addAssignmentArithmeticOverloads(bool isEqualOp) {
8319     if (!HasArithmeticOrEnumeralCandidateType)
8320       return;
8321 
8322     for (unsigned Left = 0; Left < NumArithmeticTypes; ++Left) {
8323       for (unsigned Right = FirstPromotedArithmeticType;
8324            Right < LastPromotedArithmeticType; ++Right) {
8325         QualType ParamTypes[2];
8326         ParamTypes[1] = ArithmeticTypes[Right];
8327 
8328         // Add this built-in operator as a candidate (VQ is empty).
8329         ParamTypes[0] =
8330           S.Context.getLValueReferenceType(ArithmeticTypes[Left]);
8331         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8332                               /*IsAssigmentOperator=*/isEqualOp);
8333 
8334         // Add this built-in operator as a candidate (VQ is 'volatile').
8335         if (VisibleTypeConversionsQuals.hasVolatile()) {
8336           ParamTypes[0] =
8337             S.Context.getVolatileType(ArithmeticTypes[Left]);
8338           ParamTypes[0] = S.Context.getLValueReferenceType(ParamTypes[0]);
8339           S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8340                                 /*IsAssigmentOperator=*/isEqualOp);
8341         }
8342       }
8343     }
8344 
8345     // Extension: Add the binary operators =, +=, -=, *=, /= for vector types.
8346     for (BuiltinCandidateTypeSet::iterator
8347               Vec1 = CandidateTypes[0].vector_begin(),
8348            Vec1End = CandidateTypes[0].vector_end();
8349          Vec1 != Vec1End; ++Vec1) {
8350       for (BuiltinCandidateTypeSet::iterator
8351                 Vec2 = CandidateTypes[1].vector_begin(),
8352              Vec2End = CandidateTypes[1].vector_end();
8353            Vec2 != Vec2End; ++Vec2) {
8354         QualType ParamTypes[2];
8355         ParamTypes[1] = *Vec2;
8356         // Add this built-in operator as a candidate (VQ is empty).
8357         ParamTypes[0] = S.Context.getLValueReferenceType(*Vec1);
8358         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8359                               /*IsAssigmentOperator=*/isEqualOp);
8360 
8361         // Add this built-in operator as a candidate (VQ is 'volatile').
8362         if (VisibleTypeConversionsQuals.hasVolatile()) {
8363           ParamTypes[0] = S.Context.getVolatileType(*Vec1);
8364           ParamTypes[0] = S.Context.getLValueReferenceType(ParamTypes[0]);
8365           S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8366                                 /*IsAssigmentOperator=*/isEqualOp);
8367         }
8368       }
8369     }
8370   }
8371 
8372   // C++ [over.built]p22:
8373   //
8374   //   For every triple (L, VQ, R), where L is an integral type, VQ
8375   //   is either volatile or empty, and R is a promoted integral
8376   //   type, there exist candidate operator functions of the form
8377   //
8378   //        VQ L&       operator%=(VQ L&, R);
8379   //        VQ L&       operator<<=(VQ L&, R);
8380   //        VQ L&       operator>>=(VQ L&, R);
8381   //        VQ L&       operator&=(VQ L&, R);
8382   //        VQ L&       operator^=(VQ L&, R);
8383   //        VQ L&       operator|=(VQ L&, R);
8384   void addAssignmentIntegralOverloads() {
8385     if (!HasArithmeticOrEnumeralCandidateType)
8386       return;
8387 
8388     for (unsigned Left = FirstIntegralType; Left < LastIntegralType; ++Left) {
8389       for (unsigned Right = FirstPromotedIntegralType;
8390            Right < LastPromotedIntegralType; ++Right) {
8391         QualType ParamTypes[2];
8392         ParamTypes[1] = ArithmeticTypes[Right];
8393 
8394         // Add this built-in operator as a candidate (VQ is empty).
8395         ParamTypes[0] =
8396           S.Context.getLValueReferenceType(ArithmeticTypes[Left]);
8397         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
8398         if (VisibleTypeConversionsQuals.hasVolatile()) {
8399           // Add this built-in operator as a candidate (VQ is 'volatile').
8400           ParamTypes[0] = ArithmeticTypes[Left];
8401           ParamTypes[0] = S.Context.getVolatileType(ParamTypes[0]);
8402           ParamTypes[0] = S.Context.getLValueReferenceType(ParamTypes[0]);
8403           S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
8404         }
8405       }
8406     }
8407   }
8408 
8409   // C++ [over.operator]p23:
8410   //
8411   //   There also exist candidate operator functions of the form
8412   //
8413   //        bool        operator!(bool);
8414   //        bool        operator&&(bool, bool);
8415   //        bool        operator||(bool, bool);
8416   void addExclaimOverload() {
8417     QualType ParamTy = S.Context.BoolTy;
8418     S.AddBuiltinCandidate(&ParamTy, Args, CandidateSet,
8419                           /*IsAssignmentOperator=*/false,
8420                           /*NumContextualBoolArguments=*/1);
8421   }
8422   void addAmpAmpOrPipePipeOverload() {
8423     QualType ParamTypes[2] = { S.Context.BoolTy, S.Context.BoolTy };
8424     S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet,
8425                           /*IsAssignmentOperator=*/false,
8426                           /*NumContextualBoolArguments=*/2);
8427   }
8428 
8429   // C++ [over.built]p13:
8430   //
8431   //   For every cv-qualified or cv-unqualified object type T there
8432   //   exist candidate operator functions of the form
8433   //
8434   //        T*         operator+(T*, ptrdiff_t);     [ABOVE]
8435   //        T&         operator[](T*, ptrdiff_t);
8436   //        T*         operator-(T*, ptrdiff_t);     [ABOVE]
8437   //        T*         operator+(ptrdiff_t, T*);     [ABOVE]
8438   //        T&         operator[](ptrdiff_t, T*);
8439   void addSubscriptOverloads() {
8440     for (BuiltinCandidateTypeSet::iterator
8441               Ptr = CandidateTypes[0].pointer_begin(),
8442            PtrEnd = CandidateTypes[0].pointer_end();
8443          Ptr != PtrEnd; ++Ptr) {
8444       QualType ParamTypes[2] = { *Ptr, S.Context.getPointerDiffType() };
8445       QualType PointeeType = (*Ptr)->getPointeeType();
8446       if (!PointeeType->isObjectType())
8447         continue;
8448 
8449       // T& operator[](T*, ptrdiff_t)
8450       S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
8451     }
8452 
8453     for (BuiltinCandidateTypeSet::iterator
8454               Ptr = CandidateTypes[1].pointer_begin(),
8455            PtrEnd = CandidateTypes[1].pointer_end();
8456          Ptr != PtrEnd; ++Ptr) {
8457       QualType ParamTypes[2] = { S.Context.getPointerDiffType(), *Ptr };
8458       QualType PointeeType = (*Ptr)->getPointeeType();
8459       if (!PointeeType->isObjectType())
8460         continue;
8461 
8462       // T& operator[](ptrdiff_t, T*)
8463       S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
8464     }
8465   }
8466 
8467   // C++ [over.built]p11:
8468   //    For every quintuple (C1, C2, T, CV1, CV2), where C2 is a class type,
8469   //    C1 is the same type as C2 or is a derived class of C2, T is an object
8470   //    type or a function type, and CV1 and CV2 are cv-qualifier-seqs,
8471   //    there exist candidate operator functions of the form
8472   //
8473   //      CV12 T& operator->*(CV1 C1*, CV2 T C2::*);
8474   //
8475   //    where CV12 is the union of CV1 and CV2.
8476   void addArrowStarOverloads() {
8477     for (BuiltinCandidateTypeSet::iterator
8478              Ptr = CandidateTypes[0].pointer_begin(),
8479            PtrEnd = CandidateTypes[0].pointer_end();
8480          Ptr != PtrEnd; ++Ptr) {
8481       QualType C1Ty = (*Ptr);
8482       QualType C1;
8483       QualifierCollector Q1;
8484       C1 = QualType(Q1.strip(C1Ty->getPointeeType()), 0);
8485       if (!isa<RecordType>(C1))
8486         continue;
8487       // heuristic to reduce number of builtin candidates in the set.
8488       // Add volatile/restrict version only if there are conversions to a
8489       // volatile/restrict type.
8490       if (!VisibleTypeConversionsQuals.hasVolatile() && Q1.hasVolatile())
8491         continue;
8492       if (!VisibleTypeConversionsQuals.hasRestrict() && Q1.hasRestrict())
8493         continue;
8494       for (BuiltinCandidateTypeSet::iterator
8495                 MemPtr = CandidateTypes[1].member_pointer_begin(),
8496              MemPtrEnd = CandidateTypes[1].member_pointer_end();
8497            MemPtr != MemPtrEnd; ++MemPtr) {
8498         const MemberPointerType *mptr = cast<MemberPointerType>(*MemPtr);
8499         QualType C2 = QualType(mptr->getClass(), 0);
8500         C2 = C2.getUnqualifiedType();
8501         if (C1 != C2 && !S.IsDerivedFrom(CandidateSet.getLocation(), C1, C2))
8502           break;
8503         QualType ParamTypes[2] = { *Ptr, *MemPtr };
8504         // build CV12 T&
8505         QualType T = mptr->getPointeeType();
8506         if (!VisibleTypeConversionsQuals.hasVolatile() &&
8507             T.isVolatileQualified())
8508           continue;
8509         if (!VisibleTypeConversionsQuals.hasRestrict() &&
8510             T.isRestrictQualified())
8511           continue;
8512         T = Q1.apply(S.Context, T);
8513         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
8514       }
8515     }
8516   }
8517 
8518   // Note that we don't consider the first argument, since it has been
8519   // contextually converted to bool long ago. The candidates below are
8520   // therefore added as binary.
8521   //
8522   // C++ [over.built]p25:
8523   //   For every type T, where T is a pointer, pointer-to-member, or scoped
8524   //   enumeration type, there exist candidate operator functions of the form
8525   //
8526   //        T        operator?(bool, T, T);
8527   //
8528   void addConditionalOperatorOverloads() {
8529     /// Set of (canonical) types that we've already handled.
8530     llvm::SmallPtrSet<QualType, 8> AddedTypes;
8531 
8532     for (unsigned ArgIdx = 0; ArgIdx < 2; ++ArgIdx) {
8533       for (BuiltinCandidateTypeSet::iterator
8534                 Ptr = CandidateTypes[ArgIdx].pointer_begin(),
8535              PtrEnd = CandidateTypes[ArgIdx].pointer_end();
8536            Ptr != PtrEnd; ++Ptr) {
8537         if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)).second)
8538           continue;
8539 
8540         QualType ParamTypes[2] = { *Ptr, *Ptr };
8541         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
8542       }
8543 
8544       for (BuiltinCandidateTypeSet::iterator
8545                 MemPtr = CandidateTypes[ArgIdx].member_pointer_begin(),
8546              MemPtrEnd = CandidateTypes[ArgIdx].member_pointer_end();
8547            MemPtr != MemPtrEnd; ++MemPtr) {
8548         if (!AddedTypes.insert(S.Context.getCanonicalType(*MemPtr)).second)
8549           continue;
8550 
8551         QualType ParamTypes[2] = { *MemPtr, *MemPtr };
8552         S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
8553       }
8554 
8555       if (S.getLangOpts().CPlusPlus11) {
8556         for (BuiltinCandidateTypeSet::iterator
8557                   Enum = CandidateTypes[ArgIdx].enumeration_begin(),
8558                EnumEnd = CandidateTypes[ArgIdx].enumeration_end();
8559              Enum != EnumEnd; ++Enum) {
8560           if (!(*Enum)->getAs<EnumType>()->getDecl()->isScoped())
8561             continue;
8562 
8563           if (!AddedTypes.insert(S.Context.getCanonicalType(*Enum)).second)
8564             continue;
8565 
8566           QualType ParamTypes[2] = { *Enum, *Enum };
8567           S.AddBuiltinCandidate(ParamTypes, Args, CandidateSet);
8568         }
8569       }
8570     }
8571   }
8572 };
8573 
8574 } // end anonymous namespace
8575 
8576 /// AddBuiltinOperatorCandidates - Add the appropriate built-in
8577 /// operator overloads to the candidate set (C++ [over.built]), based
8578 /// on the operator @p Op and the arguments given. For example, if the
8579 /// operator is a binary '+', this routine might add "int
8580 /// operator+(int, int)" to cover integer addition.
8581 void Sema::AddBuiltinOperatorCandidates(OverloadedOperatorKind Op,
8582                                         SourceLocation OpLoc,
8583                                         ArrayRef<Expr *> Args,
8584                                         OverloadCandidateSet &CandidateSet) {
8585   // Find all of the types that the arguments can convert to, but only
8586   // if the operator we're looking at has built-in operator candidates
8587   // that make use of these types. Also record whether we encounter non-record
8588   // candidate types or either arithmetic or enumeral candidate types.
8589   Qualifiers VisibleTypeConversionsQuals;
8590   VisibleTypeConversionsQuals.addConst();
8591   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx)
8592     VisibleTypeConversionsQuals += CollectVRQualifiers(Context, Args[ArgIdx]);
8593 
8594   bool HasNonRecordCandidateType = false;
8595   bool HasArithmeticOrEnumeralCandidateType = false;
8596   SmallVector<BuiltinCandidateTypeSet, 2> CandidateTypes;
8597   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
8598     CandidateTypes.emplace_back(*this);
8599     CandidateTypes[ArgIdx].AddTypesConvertedFrom(Args[ArgIdx]->getType(),
8600                                                  OpLoc,
8601                                                  true,
8602                                                  (Op == OO_Exclaim ||
8603                                                   Op == OO_AmpAmp ||
8604                                                   Op == OO_PipePipe),
8605                                                  VisibleTypeConversionsQuals);
8606     HasNonRecordCandidateType = HasNonRecordCandidateType ||
8607         CandidateTypes[ArgIdx].hasNonRecordTypes();
8608     HasArithmeticOrEnumeralCandidateType =
8609         HasArithmeticOrEnumeralCandidateType ||
8610         CandidateTypes[ArgIdx].hasArithmeticOrEnumeralTypes();
8611   }
8612 
8613   // Exit early when no non-record types have been added to the candidate set
8614   // for any of the arguments to the operator.
8615   //
8616   // We can't exit early for !, ||, or &&, since there we have always have
8617   // 'bool' overloads.
8618   if (!HasNonRecordCandidateType &&
8619       !(Op == OO_Exclaim || Op == OO_AmpAmp || Op == OO_PipePipe))
8620     return;
8621 
8622   // Setup an object to manage the common state for building overloads.
8623   BuiltinOperatorOverloadBuilder OpBuilder(*this, Args,
8624                                            VisibleTypeConversionsQuals,
8625                                            HasArithmeticOrEnumeralCandidateType,
8626                                            CandidateTypes, CandidateSet);
8627 
8628   // Dispatch over the operation to add in only those overloads which apply.
8629   switch (Op) {
8630   case OO_None:
8631   case NUM_OVERLOADED_OPERATORS:
8632     llvm_unreachable("Expected an overloaded operator");
8633 
8634   case OO_New:
8635   case OO_Delete:
8636   case OO_Array_New:
8637   case OO_Array_Delete:
8638   case OO_Call:
8639     llvm_unreachable(
8640                     "Special operators don't use AddBuiltinOperatorCandidates");
8641 
8642   case OO_Comma:
8643   case OO_Arrow:
8644   case OO_Coawait:
8645     // C++ [over.match.oper]p3:
8646     //   -- For the operator ',', the unary operator '&', the
8647     //      operator '->', or the operator 'co_await', the
8648     //      built-in candidates set is empty.
8649     break;
8650 
8651   case OO_Plus: // '+' is either unary or binary
8652     if (Args.size() == 1)
8653       OpBuilder.addUnaryPlusPointerOverloads();
8654     LLVM_FALLTHROUGH;
8655 
8656   case OO_Minus: // '-' is either unary or binary
8657     if (Args.size() == 1) {
8658       OpBuilder.addUnaryPlusOrMinusArithmeticOverloads();
8659     } else {
8660       OpBuilder.addBinaryPlusOrMinusPointerOverloads(Op);
8661       OpBuilder.addGenericBinaryArithmeticOverloads();
8662     }
8663     break;
8664 
8665   case OO_Star: // '*' is either unary or binary
8666     if (Args.size() == 1)
8667       OpBuilder.addUnaryStarPointerOverloads();
8668     else
8669       OpBuilder.addGenericBinaryArithmeticOverloads();
8670     break;
8671 
8672   case OO_Slash:
8673     OpBuilder.addGenericBinaryArithmeticOverloads();
8674     break;
8675 
8676   case OO_PlusPlus:
8677   case OO_MinusMinus:
8678     OpBuilder.addPlusPlusMinusMinusArithmeticOverloads(Op);
8679     OpBuilder.addPlusPlusMinusMinusPointerOverloads();
8680     break;
8681 
8682   case OO_EqualEqual:
8683   case OO_ExclaimEqual:
8684     OpBuilder.addEqualEqualOrNotEqualMemberPointerOrNullptrOverloads();
8685     LLVM_FALLTHROUGH;
8686 
8687   case OO_Less:
8688   case OO_Greater:
8689   case OO_LessEqual:
8690   case OO_GreaterEqual:
8691     OpBuilder.addRelationalPointerOrEnumeralOverloads();
8692     OpBuilder.addGenericBinaryArithmeticOverloads();
8693     break;
8694 
8695   case OO_Spaceship:
8696     llvm_unreachable("<=> expressions not supported yet");
8697 
8698   case OO_Percent:
8699   case OO_Caret:
8700   case OO_Pipe:
8701   case OO_LessLess:
8702   case OO_GreaterGreater:
8703     OpBuilder.addBinaryBitwiseArithmeticOverloads(Op);
8704     break;
8705 
8706   case OO_Amp: // '&' is either unary or binary
8707     if (Args.size() == 1)
8708       // C++ [over.match.oper]p3:
8709       //   -- For the operator ',', the unary operator '&', or the
8710       //      operator '->', the built-in candidates set is empty.
8711       break;
8712 
8713     OpBuilder.addBinaryBitwiseArithmeticOverloads(Op);
8714     break;
8715 
8716   case OO_Tilde:
8717     OpBuilder.addUnaryTildePromotedIntegralOverloads();
8718     break;
8719 
8720   case OO_Equal:
8721     OpBuilder.addAssignmentMemberPointerOrEnumeralOverloads();
8722     LLVM_FALLTHROUGH;
8723 
8724   case OO_PlusEqual:
8725   case OO_MinusEqual:
8726     OpBuilder.addAssignmentPointerOverloads(Op == OO_Equal);
8727     LLVM_FALLTHROUGH;
8728 
8729   case OO_StarEqual:
8730   case OO_SlashEqual:
8731     OpBuilder.addAssignmentArithmeticOverloads(Op == OO_Equal);
8732     break;
8733 
8734   case OO_PercentEqual:
8735   case OO_LessLessEqual:
8736   case OO_GreaterGreaterEqual:
8737   case OO_AmpEqual:
8738   case OO_CaretEqual:
8739   case OO_PipeEqual:
8740     OpBuilder.addAssignmentIntegralOverloads();
8741     break;
8742 
8743   case OO_Exclaim:
8744     OpBuilder.addExclaimOverload();
8745     break;
8746 
8747   case OO_AmpAmp:
8748   case OO_PipePipe:
8749     OpBuilder.addAmpAmpOrPipePipeOverload();
8750     break;
8751 
8752   case OO_Subscript:
8753     OpBuilder.addSubscriptOverloads();
8754     break;
8755 
8756   case OO_ArrowStar:
8757     OpBuilder.addArrowStarOverloads();
8758     break;
8759 
8760   case OO_Conditional:
8761     OpBuilder.addConditionalOperatorOverloads();
8762     OpBuilder.addGenericBinaryArithmeticOverloads();
8763     break;
8764   }
8765 }
8766 
8767 /// \brief Add function candidates found via argument-dependent lookup
8768 /// to the set of overloading candidates.
8769 ///
8770 /// This routine performs argument-dependent name lookup based on the
8771 /// given function name (which may also be an operator name) and adds
8772 /// all of the overload candidates found by ADL to the overload
8773 /// candidate set (C++ [basic.lookup.argdep]).
8774 void
8775 Sema::AddArgumentDependentLookupCandidates(DeclarationName Name,
8776                                            SourceLocation Loc,
8777                                            ArrayRef<Expr *> Args,
8778                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
8779                                            OverloadCandidateSet& CandidateSet,
8780                                            bool PartialOverloading) {
8781   ADLResult Fns;
8782 
8783   // FIXME: This approach for uniquing ADL results (and removing
8784   // redundant candidates from the set) relies on pointer-equality,
8785   // which means we need to key off the canonical decl.  However,
8786   // always going back to the canonical decl might not get us the
8787   // right set of default arguments.  What default arguments are
8788   // we supposed to consider on ADL candidates, anyway?
8789 
8790   // FIXME: Pass in the explicit template arguments?
8791   ArgumentDependentLookup(Name, Loc, Args, Fns);
8792 
8793   // Erase all of the candidates we already knew about.
8794   for (OverloadCandidateSet::iterator Cand = CandidateSet.begin(),
8795                                    CandEnd = CandidateSet.end();
8796        Cand != CandEnd; ++Cand)
8797     if (Cand->Function) {
8798       Fns.erase(Cand->Function);
8799       if (FunctionTemplateDecl *FunTmpl = Cand->Function->getPrimaryTemplate())
8800         Fns.erase(FunTmpl);
8801     }
8802 
8803   // For each of the ADL candidates we found, add it to the overload
8804   // set.
8805   for (ADLResult::iterator I = Fns.begin(), E = Fns.end(); I != E; ++I) {
8806     DeclAccessPair FoundDecl = DeclAccessPair::make(*I, AS_none);
8807     if (FunctionDecl *FD = dyn_cast<FunctionDecl>(*I)) {
8808       if (ExplicitTemplateArgs)
8809         continue;
8810 
8811       AddOverloadCandidate(FD, FoundDecl, Args, CandidateSet, false,
8812                            PartialOverloading);
8813     } else
8814       AddTemplateOverloadCandidate(cast<FunctionTemplateDecl>(*I),
8815                                    FoundDecl, ExplicitTemplateArgs,
8816                                    Args, CandidateSet, PartialOverloading);
8817   }
8818 }
8819 
8820 namespace {
8821 enum class Comparison { Equal, Better, Worse };
8822 }
8823 
8824 /// Compares the enable_if attributes of two FunctionDecls, for the purposes of
8825 /// overload resolution.
8826 ///
8827 /// Cand1's set of enable_if attributes are said to be "better" than Cand2's iff
8828 /// Cand1's first N enable_if attributes have precisely the same conditions as
8829 /// Cand2's first N enable_if attributes (where N = the number of enable_if
8830 /// attributes on Cand2), and Cand1 has more than N enable_if attributes.
8831 ///
8832 /// Note that you can have a pair of candidates such that Cand1's enable_if
8833 /// attributes are worse than Cand2's, and Cand2's enable_if attributes are
8834 /// worse than Cand1's.
8835 static Comparison compareEnableIfAttrs(const Sema &S, const FunctionDecl *Cand1,
8836                                        const FunctionDecl *Cand2) {
8837   // Common case: One (or both) decls don't have enable_if attrs.
8838   bool Cand1Attr = Cand1->hasAttr<EnableIfAttr>();
8839   bool Cand2Attr = Cand2->hasAttr<EnableIfAttr>();
8840   if (!Cand1Attr || !Cand2Attr) {
8841     if (Cand1Attr == Cand2Attr)
8842       return Comparison::Equal;
8843     return Cand1Attr ? Comparison::Better : Comparison::Worse;
8844   }
8845 
8846   // FIXME: The next several lines are just
8847   // specific_attr_iterator<EnableIfAttr> but going in declaration order,
8848   // instead of reverse order which is how they're stored in the AST.
8849   auto Cand1Attrs = getOrderedEnableIfAttrs(Cand1);
8850   auto Cand2Attrs = getOrderedEnableIfAttrs(Cand2);
8851 
8852   // It's impossible for Cand1 to be better than (or equal to) Cand2 if Cand1
8853   // has fewer enable_if attributes than Cand2.
8854   if (Cand1Attrs.size() < Cand2Attrs.size())
8855     return Comparison::Worse;
8856 
8857   auto Cand1I = Cand1Attrs.begin();
8858   llvm::FoldingSetNodeID Cand1ID, Cand2ID;
8859   for (auto &Cand2A : Cand2Attrs) {
8860     Cand1ID.clear();
8861     Cand2ID.clear();
8862 
8863     auto &Cand1A = *Cand1I++;
8864     Cand1A->getCond()->Profile(Cand1ID, S.getASTContext(), true);
8865     Cand2A->getCond()->Profile(Cand2ID, S.getASTContext(), true);
8866     if (Cand1ID != Cand2ID)
8867       return Comparison::Worse;
8868   }
8869 
8870   return Cand1I == Cand1Attrs.end() ? Comparison::Equal : Comparison::Better;
8871 }
8872 
8873 /// isBetterOverloadCandidate - Determines whether the first overload
8874 /// candidate is a better candidate than the second (C++ 13.3.3p1).
8875 bool clang::isBetterOverloadCandidate(
8876     Sema &S, const OverloadCandidate &Cand1, const OverloadCandidate &Cand2,
8877     SourceLocation Loc, OverloadCandidateSet::CandidateSetKind Kind) {
8878   // Define viable functions to be better candidates than non-viable
8879   // functions.
8880   if (!Cand2.Viable)
8881     return Cand1.Viable;
8882   else if (!Cand1.Viable)
8883     return false;
8884 
8885   // C++ [over.match.best]p1:
8886   //
8887   //   -- if F is a static member function, ICS1(F) is defined such
8888   //      that ICS1(F) is neither better nor worse than ICS1(G) for
8889   //      any function G, and, symmetrically, ICS1(G) is neither
8890   //      better nor worse than ICS1(F).
8891   unsigned StartArg = 0;
8892   if (Cand1.IgnoreObjectArgument || Cand2.IgnoreObjectArgument)
8893     StartArg = 1;
8894 
8895   auto IsIllFormedConversion = [&](const ImplicitConversionSequence &ICS) {
8896     // We don't allow incompatible pointer conversions in C++.
8897     if (!S.getLangOpts().CPlusPlus)
8898       return ICS.isStandard() &&
8899              ICS.Standard.Second == ICK_Incompatible_Pointer_Conversion;
8900 
8901     // The only ill-formed conversion we allow in C++ is the string literal to
8902     // char* conversion, which is only considered ill-formed after C++11.
8903     return S.getLangOpts().CPlusPlus11 && !S.getLangOpts().WritableStrings &&
8904            hasDeprecatedStringLiteralToCharPtrConversion(ICS);
8905   };
8906 
8907   // Define functions that don't require ill-formed conversions for a given
8908   // argument to be better candidates than functions that do.
8909   unsigned NumArgs = Cand1.Conversions.size();
8910   assert(Cand2.Conversions.size() == NumArgs && "Overload candidate mismatch");
8911   bool HasBetterConversion = false;
8912   for (unsigned ArgIdx = StartArg; ArgIdx < NumArgs; ++ArgIdx) {
8913     bool Cand1Bad = IsIllFormedConversion(Cand1.Conversions[ArgIdx]);
8914     bool Cand2Bad = IsIllFormedConversion(Cand2.Conversions[ArgIdx]);
8915     if (Cand1Bad != Cand2Bad) {
8916       if (Cand1Bad)
8917         return false;
8918       HasBetterConversion = true;
8919     }
8920   }
8921 
8922   if (HasBetterConversion)
8923     return true;
8924 
8925   // C++ [over.match.best]p1:
8926   //   A viable function F1 is defined to be a better function than another
8927   //   viable function F2 if for all arguments i, ICSi(F1) is not a worse
8928   //   conversion sequence than ICSi(F2), and then...
8929   for (unsigned ArgIdx = StartArg; ArgIdx < NumArgs; ++ArgIdx) {
8930     switch (CompareImplicitConversionSequences(S, Loc,
8931                                                Cand1.Conversions[ArgIdx],
8932                                                Cand2.Conversions[ArgIdx])) {
8933     case ImplicitConversionSequence::Better:
8934       // Cand1 has a better conversion sequence.
8935       HasBetterConversion = true;
8936       break;
8937 
8938     case ImplicitConversionSequence::Worse:
8939       // Cand1 can't be better than Cand2.
8940       return false;
8941 
8942     case ImplicitConversionSequence::Indistinguishable:
8943       // Do nothing.
8944       break;
8945     }
8946   }
8947 
8948   //    -- for some argument j, ICSj(F1) is a better conversion sequence than
8949   //       ICSj(F2), or, if not that,
8950   if (HasBetterConversion)
8951     return true;
8952 
8953   //   -- the context is an initialization by user-defined conversion
8954   //      (see 8.5, 13.3.1.5) and the standard conversion sequence
8955   //      from the return type of F1 to the destination type (i.e.,
8956   //      the type of the entity being initialized) is a better
8957   //      conversion sequence than the standard conversion sequence
8958   //      from the return type of F2 to the destination type.
8959   if (Kind == OverloadCandidateSet::CSK_InitByUserDefinedConversion &&
8960       Cand1.Function && Cand2.Function &&
8961       isa<CXXConversionDecl>(Cand1.Function) &&
8962       isa<CXXConversionDecl>(Cand2.Function)) {
8963     // First check whether we prefer one of the conversion functions over the
8964     // other. This only distinguishes the results in non-standard, extension
8965     // cases such as the conversion from a lambda closure type to a function
8966     // pointer or block.
8967     ImplicitConversionSequence::CompareKind Result =
8968         compareConversionFunctions(S, Cand1.Function, Cand2.Function);
8969     if (Result == ImplicitConversionSequence::Indistinguishable)
8970       Result = CompareStandardConversionSequences(S, Loc,
8971                                                   Cand1.FinalConversion,
8972                                                   Cand2.FinalConversion);
8973 
8974     if (Result != ImplicitConversionSequence::Indistinguishable)
8975       return Result == ImplicitConversionSequence::Better;
8976 
8977     // FIXME: Compare kind of reference binding if conversion functions
8978     // convert to a reference type used in direct reference binding, per
8979     // C++14 [over.match.best]p1 section 2 bullet 3.
8980   }
8981 
8982   // FIXME: Work around a defect in the C++17 guaranteed copy elision wording,
8983   // as combined with the resolution to CWG issue 243.
8984   //
8985   // When the context is initialization by constructor ([over.match.ctor] or
8986   // either phase of [over.match.list]), a constructor is preferred over
8987   // a conversion function.
8988   if (Kind == OverloadCandidateSet::CSK_InitByConstructor && NumArgs == 1 &&
8989       Cand1.Function && Cand2.Function &&
8990       isa<CXXConstructorDecl>(Cand1.Function) !=
8991           isa<CXXConstructorDecl>(Cand2.Function))
8992     return isa<CXXConstructorDecl>(Cand1.Function);
8993 
8994   //    -- F1 is a non-template function and F2 is a function template
8995   //       specialization, or, if not that,
8996   bool Cand1IsSpecialization = Cand1.Function &&
8997                                Cand1.Function->getPrimaryTemplate();
8998   bool Cand2IsSpecialization = Cand2.Function &&
8999                                Cand2.Function->getPrimaryTemplate();
9000   if (Cand1IsSpecialization != Cand2IsSpecialization)
9001     return Cand2IsSpecialization;
9002 
9003   //   -- F1 and F2 are function template specializations, and the function
9004   //      template for F1 is more specialized than the template for F2
9005   //      according to the partial ordering rules described in 14.5.5.2, or,
9006   //      if not that,
9007   if (Cand1IsSpecialization && Cand2IsSpecialization) {
9008     if (FunctionTemplateDecl *BetterTemplate
9009           = S.getMoreSpecializedTemplate(Cand1.Function->getPrimaryTemplate(),
9010                                          Cand2.Function->getPrimaryTemplate(),
9011                                          Loc,
9012                        isa<CXXConversionDecl>(Cand1.Function)? TPOC_Conversion
9013                                                              : TPOC_Call,
9014                                          Cand1.ExplicitCallArguments,
9015                                          Cand2.ExplicitCallArguments))
9016       return BetterTemplate == Cand1.Function->getPrimaryTemplate();
9017   }
9018 
9019   // FIXME: Work around a defect in the C++17 inheriting constructor wording.
9020   // A derived-class constructor beats an (inherited) base class constructor.
9021   bool Cand1IsInherited =
9022       dyn_cast_or_null<ConstructorUsingShadowDecl>(Cand1.FoundDecl.getDecl());
9023   bool Cand2IsInherited =
9024       dyn_cast_or_null<ConstructorUsingShadowDecl>(Cand2.FoundDecl.getDecl());
9025   if (Cand1IsInherited != Cand2IsInherited)
9026     return Cand2IsInherited;
9027   else if (Cand1IsInherited) {
9028     assert(Cand2IsInherited);
9029     auto *Cand1Class = cast<CXXRecordDecl>(Cand1.Function->getDeclContext());
9030     auto *Cand2Class = cast<CXXRecordDecl>(Cand2.Function->getDeclContext());
9031     if (Cand1Class->isDerivedFrom(Cand2Class))
9032       return true;
9033     if (Cand2Class->isDerivedFrom(Cand1Class))
9034       return false;
9035     // Inherited from sibling base classes: still ambiguous.
9036   }
9037 
9038   // Check C++17 tie-breakers for deduction guides.
9039   {
9040     auto *Guide1 = dyn_cast_or_null<CXXDeductionGuideDecl>(Cand1.Function);
9041     auto *Guide2 = dyn_cast_or_null<CXXDeductionGuideDecl>(Cand2.Function);
9042     if (Guide1 && Guide2) {
9043       //  -- F1 is generated from a deduction-guide and F2 is not
9044       if (Guide1->isImplicit() != Guide2->isImplicit())
9045         return Guide2->isImplicit();
9046 
9047       //  -- F1 is the copy deduction candidate(16.3.1.8) and F2 is not
9048       if (Guide1->isCopyDeductionCandidate())
9049         return true;
9050     }
9051   }
9052 
9053   // Check for enable_if value-based overload resolution.
9054   if (Cand1.Function && Cand2.Function) {
9055     Comparison Cmp = compareEnableIfAttrs(S, Cand1.Function, Cand2.Function);
9056     if (Cmp != Comparison::Equal)
9057       return Cmp == Comparison::Better;
9058   }
9059 
9060   if (S.getLangOpts().CUDA && Cand1.Function && Cand2.Function) {
9061     FunctionDecl *Caller = dyn_cast<FunctionDecl>(S.CurContext);
9062     return S.IdentifyCUDAPreference(Caller, Cand1.Function) >
9063            S.IdentifyCUDAPreference(Caller, Cand2.Function);
9064   }
9065 
9066   bool HasPS1 = Cand1.Function != nullptr &&
9067                 functionHasPassObjectSizeParams(Cand1.Function);
9068   bool HasPS2 = Cand2.Function != nullptr &&
9069                 functionHasPassObjectSizeParams(Cand2.Function);
9070   return HasPS1 != HasPS2 && HasPS1;
9071 }
9072 
9073 /// Determine whether two declarations are "equivalent" for the purposes of
9074 /// name lookup and overload resolution. This applies when the same internal/no
9075 /// linkage entity is defined by two modules (probably by textually including
9076 /// the same header). In such a case, we don't consider the declarations to
9077 /// declare the same entity, but we also don't want lookups with both
9078 /// declarations visible to be ambiguous in some cases (this happens when using
9079 /// a modularized libstdc++).
9080 bool Sema::isEquivalentInternalLinkageDeclaration(const NamedDecl *A,
9081                                                   const NamedDecl *B) {
9082   auto *VA = dyn_cast_or_null<ValueDecl>(A);
9083   auto *VB = dyn_cast_or_null<ValueDecl>(B);
9084   if (!VA || !VB)
9085     return false;
9086 
9087   // The declarations must be declaring the same name as an internal linkage
9088   // entity in different modules.
9089   if (!VA->getDeclContext()->getRedeclContext()->Equals(
9090           VB->getDeclContext()->getRedeclContext()) ||
9091       getOwningModule(const_cast<ValueDecl *>(VA)) ==
9092           getOwningModule(const_cast<ValueDecl *>(VB)) ||
9093       VA->isExternallyVisible() || VB->isExternallyVisible())
9094     return false;
9095 
9096   // Check that the declarations appear to be equivalent.
9097   //
9098   // FIXME: Checking the type isn't really enough to resolve the ambiguity.
9099   // For constants and functions, we should check the initializer or body is
9100   // the same. For non-constant variables, we shouldn't allow it at all.
9101   if (Context.hasSameType(VA->getType(), VB->getType()))
9102     return true;
9103 
9104   // Enum constants within unnamed enumerations will have different types, but
9105   // may still be similar enough to be interchangeable for our purposes.
9106   if (auto *EA = dyn_cast<EnumConstantDecl>(VA)) {
9107     if (auto *EB = dyn_cast<EnumConstantDecl>(VB)) {
9108       // Only handle anonymous enums. If the enumerations were named and
9109       // equivalent, they would have been merged to the same type.
9110       auto *EnumA = cast<EnumDecl>(EA->getDeclContext());
9111       auto *EnumB = cast<EnumDecl>(EB->getDeclContext());
9112       if (EnumA->hasNameForLinkage() || EnumB->hasNameForLinkage() ||
9113           !Context.hasSameType(EnumA->getIntegerType(),
9114                                EnumB->getIntegerType()))
9115         return false;
9116       // Allow this only if the value is the same for both enumerators.
9117       return llvm::APSInt::isSameValue(EA->getInitVal(), EB->getInitVal());
9118     }
9119   }
9120 
9121   // Nothing else is sufficiently similar.
9122   return false;
9123 }
9124 
9125 void Sema::diagnoseEquivalentInternalLinkageDeclarations(
9126     SourceLocation Loc, const NamedDecl *D, ArrayRef<const NamedDecl *> Equiv) {
9127   Diag(Loc, diag::ext_equivalent_internal_linkage_decl_in_modules) << D;
9128 
9129   Module *M = getOwningModule(const_cast<NamedDecl*>(D));
9130   Diag(D->getLocation(), diag::note_equivalent_internal_linkage_decl)
9131       << !M << (M ? M->getFullModuleName() : "");
9132 
9133   for (auto *E : Equiv) {
9134     Module *M = getOwningModule(const_cast<NamedDecl*>(E));
9135     Diag(E->getLocation(), diag::note_equivalent_internal_linkage_decl)
9136         << !M << (M ? M->getFullModuleName() : "");
9137   }
9138 }
9139 
9140 /// \brief Computes the best viable function (C++ 13.3.3)
9141 /// within an overload candidate set.
9142 ///
9143 /// \param Loc The location of the function name (or operator symbol) for
9144 /// which overload resolution occurs.
9145 ///
9146 /// \param Best If overload resolution was successful or found a deleted
9147 /// function, \p Best points to the candidate function found.
9148 ///
9149 /// \returns The result of overload resolution.
9150 OverloadingResult
9151 OverloadCandidateSet::BestViableFunction(Sema &S, SourceLocation Loc,
9152                                          iterator &Best) {
9153   llvm::SmallVector<OverloadCandidate *, 16> Candidates;
9154   std::transform(begin(), end(), std::back_inserter(Candidates),
9155                  [](OverloadCandidate &Cand) { return &Cand; });
9156 
9157   // [CUDA] HD->H or HD->D calls are technically not allowed by CUDA but
9158   // are accepted by both clang and NVCC. However, during a particular
9159   // compilation mode only one call variant is viable. We need to
9160   // exclude non-viable overload candidates from consideration based
9161   // only on their host/device attributes. Specifically, if one
9162   // candidate call is WrongSide and the other is SameSide, we ignore
9163   // the WrongSide candidate.
9164   if (S.getLangOpts().CUDA) {
9165     const FunctionDecl *Caller = dyn_cast<FunctionDecl>(S.CurContext);
9166     bool ContainsSameSideCandidate =
9167         llvm::any_of(Candidates, [&](OverloadCandidate *Cand) {
9168           return Cand->Function &&
9169                  S.IdentifyCUDAPreference(Caller, Cand->Function) ==
9170                      Sema::CFP_SameSide;
9171         });
9172     if (ContainsSameSideCandidate) {
9173       auto IsWrongSideCandidate = [&](OverloadCandidate *Cand) {
9174         return Cand->Function &&
9175                S.IdentifyCUDAPreference(Caller, Cand->Function) ==
9176                    Sema::CFP_WrongSide;
9177       };
9178       llvm::erase_if(Candidates, IsWrongSideCandidate);
9179     }
9180   }
9181 
9182   // Find the best viable function.
9183   Best = end();
9184   for (auto *Cand : Candidates)
9185     if (Cand->Viable)
9186       if (Best == end() ||
9187           isBetterOverloadCandidate(S, *Cand, *Best, Loc, Kind))
9188         Best = Cand;
9189 
9190   // If we didn't find any viable functions, abort.
9191   if (Best == end())
9192     return OR_No_Viable_Function;
9193 
9194   llvm::SmallVector<const NamedDecl *, 4> EquivalentCands;
9195 
9196   // Make sure that this function is better than every other viable
9197   // function. If not, we have an ambiguity.
9198   for (auto *Cand : Candidates) {
9199     if (Cand->Viable && Cand != Best &&
9200         !isBetterOverloadCandidate(S, *Best, *Cand, Loc, Kind)) {
9201       if (S.isEquivalentInternalLinkageDeclaration(Best->Function,
9202                                                    Cand->Function)) {
9203         EquivalentCands.push_back(Cand->Function);
9204         continue;
9205       }
9206 
9207       Best = end();
9208       return OR_Ambiguous;
9209     }
9210   }
9211 
9212   // Best is the best viable function.
9213   if (Best->Function &&
9214       (Best->Function->isDeleted() ||
9215        S.isFunctionConsideredUnavailable(Best->Function)))
9216     return OR_Deleted;
9217 
9218   if (!EquivalentCands.empty())
9219     S.diagnoseEquivalentInternalLinkageDeclarations(Loc, Best->Function,
9220                                                     EquivalentCands);
9221 
9222   return OR_Success;
9223 }
9224 
9225 namespace {
9226 
9227 enum OverloadCandidateKind {
9228   oc_function,
9229   oc_method,
9230   oc_constructor,
9231   oc_function_template,
9232   oc_method_template,
9233   oc_constructor_template,
9234   oc_implicit_default_constructor,
9235   oc_implicit_copy_constructor,
9236   oc_implicit_move_constructor,
9237   oc_implicit_copy_assignment,
9238   oc_implicit_move_assignment,
9239   oc_inherited_constructor,
9240   oc_inherited_constructor_template
9241 };
9242 
9243 static OverloadCandidateKind
9244 ClassifyOverloadCandidate(Sema &S, NamedDecl *Found, FunctionDecl *Fn,
9245                           std::string &Description) {
9246   bool isTemplate = false;
9247 
9248   if (FunctionTemplateDecl *FunTmpl = Fn->getPrimaryTemplate()) {
9249     isTemplate = true;
9250     Description = S.getTemplateArgumentBindingsText(
9251       FunTmpl->getTemplateParameters(), *Fn->getTemplateSpecializationArgs());
9252   }
9253 
9254   if (CXXConstructorDecl *Ctor = dyn_cast<CXXConstructorDecl>(Fn)) {
9255     if (!Ctor->isImplicit()) {
9256       if (isa<ConstructorUsingShadowDecl>(Found))
9257         return isTemplate ? oc_inherited_constructor_template
9258                           : oc_inherited_constructor;
9259       else
9260         return isTemplate ? oc_constructor_template : oc_constructor;
9261     }
9262 
9263     if (Ctor->isDefaultConstructor())
9264       return oc_implicit_default_constructor;
9265 
9266     if (Ctor->isMoveConstructor())
9267       return oc_implicit_move_constructor;
9268 
9269     assert(Ctor->isCopyConstructor() &&
9270            "unexpected sort of implicit constructor");
9271     return oc_implicit_copy_constructor;
9272   }
9273 
9274   if (CXXMethodDecl *Meth = dyn_cast<CXXMethodDecl>(Fn)) {
9275     // This actually gets spelled 'candidate function' for now, but
9276     // it doesn't hurt to split it out.
9277     if (!Meth->isImplicit())
9278       return isTemplate ? oc_method_template : oc_method;
9279 
9280     if (Meth->isMoveAssignmentOperator())
9281       return oc_implicit_move_assignment;
9282 
9283     if (Meth->isCopyAssignmentOperator())
9284       return oc_implicit_copy_assignment;
9285 
9286     assert(isa<CXXConversionDecl>(Meth) && "expected conversion");
9287     return oc_method;
9288   }
9289 
9290   return isTemplate ? oc_function_template : oc_function;
9291 }
9292 
9293 void MaybeEmitInheritedConstructorNote(Sema &S, Decl *FoundDecl) {
9294   // FIXME: It'd be nice to only emit a note once per using-decl per overload
9295   // set.
9296   if (auto *Shadow = dyn_cast<ConstructorUsingShadowDecl>(FoundDecl))
9297     S.Diag(FoundDecl->getLocation(),
9298            diag::note_ovl_candidate_inherited_constructor)
9299       << Shadow->getNominatedBaseClass();
9300 }
9301 
9302 } // end anonymous namespace
9303 
9304 static bool isFunctionAlwaysEnabled(const ASTContext &Ctx,
9305                                     const FunctionDecl *FD) {
9306   for (auto *EnableIf : FD->specific_attrs<EnableIfAttr>()) {
9307     bool AlwaysTrue;
9308     if (!EnableIf->getCond()->EvaluateAsBooleanCondition(AlwaysTrue, Ctx))
9309       return false;
9310     if (!AlwaysTrue)
9311       return false;
9312   }
9313   return true;
9314 }
9315 
9316 /// \brief Returns true if we can take the address of the function.
9317 ///
9318 /// \param Complain - If true, we'll emit a diagnostic
9319 /// \param InOverloadResolution - For the purposes of emitting a diagnostic, are
9320 ///   we in overload resolution?
9321 /// \param Loc - The location of the statement we're complaining about. Ignored
9322 ///   if we're not complaining, or if we're in overload resolution.
9323 static bool checkAddressOfFunctionIsAvailable(Sema &S, const FunctionDecl *FD,
9324                                               bool Complain,
9325                                               bool InOverloadResolution,
9326                                               SourceLocation Loc) {
9327   if (!isFunctionAlwaysEnabled(S.Context, FD)) {
9328     if (Complain) {
9329       if (InOverloadResolution)
9330         S.Diag(FD->getLocStart(),
9331                diag::note_addrof_ovl_candidate_disabled_by_enable_if_attr);
9332       else
9333         S.Diag(Loc, diag::err_addrof_function_disabled_by_enable_if_attr) << FD;
9334     }
9335     return false;
9336   }
9337 
9338   auto I = llvm::find_if(FD->parameters(), [](const ParmVarDecl *P) {
9339     return P->hasAttr<PassObjectSizeAttr>();
9340   });
9341   if (I == FD->param_end())
9342     return true;
9343 
9344   if (Complain) {
9345     // Add one to ParamNo because it's user-facing
9346     unsigned ParamNo = std::distance(FD->param_begin(), I) + 1;
9347     if (InOverloadResolution)
9348       S.Diag(FD->getLocation(),
9349              diag::note_ovl_candidate_has_pass_object_size_params)
9350           << ParamNo;
9351     else
9352       S.Diag(Loc, diag::err_address_of_function_with_pass_object_size_params)
9353           << FD << ParamNo;
9354   }
9355   return false;
9356 }
9357 
9358 static bool checkAddressOfCandidateIsAvailable(Sema &S,
9359                                                const FunctionDecl *FD) {
9360   return checkAddressOfFunctionIsAvailable(S, FD, /*Complain=*/true,
9361                                            /*InOverloadResolution=*/true,
9362                                            /*Loc=*/SourceLocation());
9363 }
9364 
9365 bool Sema::checkAddressOfFunctionIsAvailable(const FunctionDecl *Function,
9366                                              bool Complain,
9367                                              SourceLocation Loc) {
9368   return ::checkAddressOfFunctionIsAvailable(*this, Function, Complain,
9369                                              /*InOverloadResolution=*/false,
9370                                              Loc);
9371 }
9372 
9373 // Notes the location of an overload candidate.
9374 void Sema::NoteOverloadCandidate(NamedDecl *Found, FunctionDecl *Fn,
9375                                  QualType DestType, bool TakingAddress) {
9376   if (TakingAddress && !checkAddressOfCandidateIsAvailable(*this, Fn))
9377     return;
9378 
9379   std::string FnDesc;
9380   OverloadCandidateKind K = ClassifyOverloadCandidate(*this, Found, Fn, FnDesc);
9381   PartialDiagnostic PD = PDiag(diag::note_ovl_candidate)
9382                              << (unsigned) K << Fn << FnDesc;
9383 
9384   HandleFunctionTypeMismatch(PD, Fn->getType(), DestType);
9385   Diag(Fn->getLocation(), PD);
9386   MaybeEmitInheritedConstructorNote(*this, Found);
9387 }
9388 
9389 // Notes the location of all overload candidates designated through
9390 // OverloadedExpr
9391 void Sema::NoteAllOverloadCandidates(Expr *OverloadedExpr, QualType DestType,
9392                                      bool TakingAddress) {
9393   assert(OverloadedExpr->getType() == Context.OverloadTy);
9394 
9395   OverloadExpr::FindResult Ovl = OverloadExpr::find(OverloadedExpr);
9396   OverloadExpr *OvlExpr = Ovl.Expression;
9397 
9398   for (UnresolvedSetIterator I = OvlExpr->decls_begin(),
9399                             IEnd = OvlExpr->decls_end();
9400        I != IEnd; ++I) {
9401     if (FunctionTemplateDecl *FunTmpl =
9402                 dyn_cast<FunctionTemplateDecl>((*I)->getUnderlyingDecl()) ) {
9403       NoteOverloadCandidate(*I, FunTmpl->getTemplatedDecl(), DestType,
9404                             TakingAddress);
9405     } else if (FunctionDecl *Fun
9406                       = dyn_cast<FunctionDecl>((*I)->getUnderlyingDecl()) ) {
9407       NoteOverloadCandidate(*I, Fun, DestType, TakingAddress);
9408     }
9409   }
9410 }
9411 
9412 /// Diagnoses an ambiguous conversion.  The partial diagnostic is the
9413 /// "lead" diagnostic; it will be given two arguments, the source and
9414 /// target types of the conversion.
9415 void ImplicitConversionSequence::DiagnoseAmbiguousConversion(
9416                                  Sema &S,
9417                                  SourceLocation CaretLoc,
9418                                  const PartialDiagnostic &PDiag) const {
9419   S.Diag(CaretLoc, PDiag)
9420     << Ambiguous.getFromType() << Ambiguous.getToType();
9421   // FIXME: The note limiting machinery is borrowed from
9422   // OverloadCandidateSet::NoteCandidates; there's an opportunity for
9423   // refactoring here.
9424   const OverloadsShown ShowOverloads = S.Diags.getShowOverloads();
9425   unsigned CandsShown = 0;
9426   AmbiguousConversionSequence::const_iterator I, E;
9427   for (I = Ambiguous.begin(), E = Ambiguous.end(); I != E; ++I) {
9428     if (CandsShown >= 4 && ShowOverloads == Ovl_Best)
9429       break;
9430     ++CandsShown;
9431     S.NoteOverloadCandidate(I->first, I->second);
9432   }
9433   if (I != E)
9434     S.Diag(SourceLocation(), diag::note_ovl_too_many_candidates) << int(E - I);
9435 }
9436 
9437 static void DiagnoseBadConversion(Sema &S, OverloadCandidate *Cand,
9438                                   unsigned I, bool TakingCandidateAddress) {
9439   const ImplicitConversionSequence &Conv = Cand->Conversions[I];
9440   assert(Conv.isBad());
9441   assert(Cand->Function && "for now, candidate must be a function");
9442   FunctionDecl *Fn = Cand->Function;
9443 
9444   // There's a conversion slot for the object argument if this is a
9445   // non-constructor method.  Note that 'I' corresponds the
9446   // conversion-slot index.
9447   bool isObjectArgument = false;
9448   if (isa<CXXMethodDecl>(Fn) && !isa<CXXConstructorDecl>(Fn)) {
9449     if (I == 0)
9450       isObjectArgument = true;
9451     else
9452       I--;
9453   }
9454 
9455   std::string FnDesc;
9456   OverloadCandidateKind FnKind =
9457       ClassifyOverloadCandidate(S, Cand->FoundDecl, Fn, FnDesc);
9458 
9459   Expr *FromExpr = Conv.Bad.FromExpr;
9460   QualType FromTy = Conv.Bad.getFromType();
9461   QualType ToTy = Conv.Bad.getToType();
9462 
9463   if (FromTy == S.Context.OverloadTy) {
9464     assert(FromExpr && "overload set argument came from implicit argument?");
9465     Expr *E = FromExpr->IgnoreParens();
9466     if (isa<UnaryOperator>(E))
9467       E = cast<UnaryOperator>(E)->getSubExpr()->IgnoreParens();
9468     DeclarationName Name = cast<OverloadExpr>(E)->getName();
9469 
9470     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_overload)
9471       << (unsigned) FnKind << FnDesc
9472       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9473       << ToTy << Name << I+1;
9474     MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9475     return;
9476   }
9477 
9478   // Do some hand-waving analysis to see if the non-viability is due
9479   // to a qualifier mismatch.
9480   CanQualType CFromTy = S.Context.getCanonicalType(FromTy);
9481   CanQualType CToTy = S.Context.getCanonicalType(ToTy);
9482   if (CanQual<ReferenceType> RT = CToTy->getAs<ReferenceType>())
9483     CToTy = RT->getPointeeType();
9484   else {
9485     // TODO: detect and diagnose the full richness of const mismatches.
9486     if (CanQual<PointerType> FromPT = CFromTy->getAs<PointerType>())
9487       if (CanQual<PointerType> ToPT = CToTy->getAs<PointerType>()) {
9488         CFromTy = FromPT->getPointeeType();
9489         CToTy = ToPT->getPointeeType();
9490       }
9491   }
9492 
9493   if (CToTy.getUnqualifiedType() == CFromTy.getUnqualifiedType() &&
9494       !CToTy.isAtLeastAsQualifiedAs(CFromTy)) {
9495     Qualifiers FromQs = CFromTy.getQualifiers();
9496     Qualifiers ToQs = CToTy.getQualifiers();
9497 
9498     if (FromQs.getAddressSpace() != ToQs.getAddressSpace()) {
9499       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_addrspace)
9500         << (unsigned) FnKind << FnDesc
9501         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9502         << FromTy
9503         << FromQs.getAddressSpaceAttributePrintValue()
9504         << ToQs.getAddressSpaceAttributePrintValue()
9505         << (unsigned) isObjectArgument << I+1;
9506       MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9507       return;
9508     }
9509 
9510     if (FromQs.getObjCLifetime() != ToQs.getObjCLifetime()) {
9511       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_ownership)
9512         << (unsigned) FnKind << FnDesc
9513         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9514         << FromTy
9515         << FromQs.getObjCLifetime() << ToQs.getObjCLifetime()
9516         << (unsigned) isObjectArgument << I+1;
9517       MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9518       return;
9519     }
9520 
9521     if (FromQs.getObjCGCAttr() != ToQs.getObjCGCAttr()) {
9522       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_gc)
9523       << (unsigned) FnKind << FnDesc
9524       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9525       << FromTy
9526       << FromQs.getObjCGCAttr() << ToQs.getObjCGCAttr()
9527       << (unsigned) isObjectArgument << I+1;
9528       MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9529       return;
9530     }
9531 
9532     if (FromQs.hasUnaligned() != ToQs.hasUnaligned()) {
9533       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_unaligned)
9534         << (unsigned) FnKind << FnDesc
9535         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9536         << FromTy << FromQs.hasUnaligned() << I+1;
9537       MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9538       return;
9539     }
9540 
9541     unsigned CVR = FromQs.getCVRQualifiers() & ~ToQs.getCVRQualifiers();
9542     assert(CVR && "unexpected qualifiers mismatch");
9543 
9544     if (isObjectArgument) {
9545       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_cvr_this)
9546         << (unsigned) FnKind << FnDesc
9547         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9548         << FromTy << (CVR - 1);
9549     } else {
9550       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_cvr)
9551         << (unsigned) FnKind << FnDesc
9552         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9553         << FromTy << (CVR - 1) << I+1;
9554     }
9555     MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9556     return;
9557   }
9558 
9559   // Special diagnostic for failure to convert an initializer list, since
9560   // telling the user that it has type void is not useful.
9561   if (FromExpr && isa<InitListExpr>(FromExpr)) {
9562     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_list_argument)
9563       << (unsigned) FnKind << FnDesc
9564       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9565       << FromTy << ToTy << (unsigned) isObjectArgument << I+1;
9566     MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9567     return;
9568   }
9569 
9570   // Diagnose references or pointers to incomplete types differently,
9571   // since it's far from impossible that the incompleteness triggered
9572   // the failure.
9573   QualType TempFromTy = FromTy.getNonReferenceType();
9574   if (const PointerType *PTy = TempFromTy->getAs<PointerType>())
9575     TempFromTy = PTy->getPointeeType();
9576   if (TempFromTy->isIncompleteType()) {
9577     // Emit the generic diagnostic and, optionally, add the hints to it.
9578     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_conv_incomplete)
9579       << (unsigned) FnKind << FnDesc
9580       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9581       << FromTy << ToTy << (unsigned) isObjectArgument << I+1
9582       << (unsigned) (Cand->Fix.Kind);
9583 
9584     MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9585     return;
9586   }
9587 
9588   // Diagnose base -> derived pointer conversions.
9589   unsigned BaseToDerivedConversion = 0;
9590   if (const PointerType *FromPtrTy = FromTy->getAs<PointerType>()) {
9591     if (const PointerType *ToPtrTy = ToTy->getAs<PointerType>()) {
9592       if (ToPtrTy->getPointeeType().isAtLeastAsQualifiedAs(
9593                                                FromPtrTy->getPointeeType()) &&
9594           !FromPtrTy->getPointeeType()->isIncompleteType() &&
9595           !ToPtrTy->getPointeeType()->isIncompleteType() &&
9596           S.IsDerivedFrom(SourceLocation(), ToPtrTy->getPointeeType(),
9597                           FromPtrTy->getPointeeType()))
9598         BaseToDerivedConversion = 1;
9599     }
9600   } else if (const ObjCObjectPointerType *FromPtrTy
9601                                     = FromTy->getAs<ObjCObjectPointerType>()) {
9602     if (const ObjCObjectPointerType *ToPtrTy
9603                                         = ToTy->getAs<ObjCObjectPointerType>())
9604       if (const ObjCInterfaceDecl *FromIface = FromPtrTy->getInterfaceDecl())
9605         if (const ObjCInterfaceDecl *ToIface = ToPtrTy->getInterfaceDecl())
9606           if (ToPtrTy->getPointeeType().isAtLeastAsQualifiedAs(
9607                                                 FromPtrTy->getPointeeType()) &&
9608               FromIface->isSuperClassOf(ToIface))
9609             BaseToDerivedConversion = 2;
9610   } else if (const ReferenceType *ToRefTy = ToTy->getAs<ReferenceType>()) {
9611     if (ToRefTy->getPointeeType().isAtLeastAsQualifiedAs(FromTy) &&
9612         !FromTy->isIncompleteType() &&
9613         !ToRefTy->getPointeeType()->isIncompleteType() &&
9614         S.IsDerivedFrom(SourceLocation(), ToRefTy->getPointeeType(), FromTy)) {
9615       BaseToDerivedConversion = 3;
9616     } else if (ToTy->isLValueReferenceType() && !FromExpr->isLValue() &&
9617                ToTy.getNonReferenceType().getCanonicalType() ==
9618                FromTy.getNonReferenceType().getCanonicalType()) {
9619       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_lvalue)
9620         << (unsigned) FnKind << FnDesc
9621         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9622         << (unsigned) isObjectArgument << I + 1;
9623       MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9624       return;
9625     }
9626   }
9627 
9628   if (BaseToDerivedConversion) {
9629     S.Diag(Fn->getLocation(),
9630            diag::note_ovl_candidate_bad_base_to_derived_conv)
9631       << (unsigned) FnKind << FnDesc
9632       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9633       << (BaseToDerivedConversion - 1)
9634       << FromTy << ToTy << I+1;
9635     MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9636     return;
9637   }
9638 
9639   if (isa<ObjCObjectPointerType>(CFromTy) &&
9640       isa<PointerType>(CToTy)) {
9641       Qualifiers FromQs = CFromTy.getQualifiers();
9642       Qualifiers ToQs = CToTy.getQualifiers();
9643       if (FromQs.getObjCLifetime() != ToQs.getObjCLifetime()) {
9644         S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_arc_conv)
9645         << (unsigned) FnKind << FnDesc
9646         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9647         << FromTy << ToTy << (unsigned) isObjectArgument << I+1;
9648         MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9649         return;
9650       }
9651   }
9652 
9653   if (TakingCandidateAddress &&
9654       !checkAddressOfCandidateIsAvailable(S, Cand->Function))
9655     return;
9656 
9657   // Emit the generic diagnostic and, optionally, add the hints to it.
9658   PartialDiagnostic FDiag = S.PDiag(diag::note_ovl_candidate_bad_conv);
9659   FDiag << (unsigned) FnKind << FnDesc
9660     << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
9661     << FromTy << ToTy << (unsigned) isObjectArgument << I + 1
9662     << (unsigned) (Cand->Fix.Kind);
9663 
9664   // If we can fix the conversion, suggest the FixIts.
9665   for (std::vector<FixItHint>::iterator HI = Cand->Fix.Hints.begin(),
9666        HE = Cand->Fix.Hints.end(); HI != HE; ++HI)
9667     FDiag << *HI;
9668   S.Diag(Fn->getLocation(), FDiag);
9669 
9670   MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
9671 }
9672 
9673 /// Additional arity mismatch diagnosis specific to a function overload
9674 /// candidates. This is not covered by the more general DiagnoseArityMismatch()
9675 /// over a candidate in any candidate set.
9676 static bool CheckArityMismatch(Sema &S, OverloadCandidate *Cand,
9677                                unsigned NumArgs) {
9678   FunctionDecl *Fn = Cand->Function;
9679   unsigned MinParams = Fn->getMinRequiredArguments();
9680 
9681   // With invalid overloaded operators, it's possible that we think we
9682   // have an arity mismatch when in fact it looks like we have the
9683   // right number of arguments, because only overloaded operators have
9684   // the weird behavior of overloading member and non-member functions.
9685   // Just don't report anything.
9686   if (Fn->isInvalidDecl() &&
9687       Fn->getDeclName().getNameKind() == DeclarationName::CXXOperatorName)
9688     return true;
9689 
9690   if (NumArgs < MinParams) {
9691     assert((Cand->FailureKind == ovl_fail_too_few_arguments) ||
9692            (Cand->FailureKind == ovl_fail_bad_deduction &&
9693             Cand->DeductionFailure.Result == Sema::TDK_TooFewArguments));
9694   } else {
9695     assert((Cand->FailureKind == ovl_fail_too_many_arguments) ||
9696            (Cand->FailureKind == ovl_fail_bad_deduction &&
9697             Cand->DeductionFailure.Result == Sema::TDK_TooManyArguments));
9698   }
9699 
9700   return false;
9701 }
9702 
9703 /// General arity mismatch diagnosis over a candidate in a candidate set.
9704 static void DiagnoseArityMismatch(Sema &S, NamedDecl *Found, Decl *D,
9705                                   unsigned NumFormalArgs) {
9706   assert(isa<FunctionDecl>(D) &&
9707       "The templated declaration should at least be a function"
9708       " when diagnosing bad template argument deduction due to too many"
9709       " or too few arguments");
9710 
9711   FunctionDecl *Fn = cast<FunctionDecl>(D);
9712 
9713   // TODO: treat calls to a missing default constructor as a special case
9714   const FunctionProtoType *FnTy = Fn->getType()->getAs<FunctionProtoType>();
9715   unsigned MinParams = Fn->getMinRequiredArguments();
9716 
9717   // at least / at most / exactly
9718   unsigned mode, modeCount;
9719   if (NumFormalArgs < MinParams) {
9720     if (MinParams != FnTy->getNumParams() || FnTy->isVariadic() ||
9721         FnTy->isTemplateVariadic())
9722       mode = 0; // "at least"
9723     else
9724       mode = 2; // "exactly"
9725     modeCount = MinParams;
9726   } else {
9727     if (MinParams != FnTy->getNumParams())
9728       mode = 1; // "at most"
9729     else
9730       mode = 2; // "exactly"
9731     modeCount = FnTy->getNumParams();
9732   }
9733 
9734   std::string Description;
9735   OverloadCandidateKind FnKind =
9736       ClassifyOverloadCandidate(S, Found, Fn, Description);
9737 
9738   if (modeCount == 1 && Fn->getParamDecl(0)->getDeclName())
9739     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_arity_one)
9740       << (unsigned) FnKind << (Fn->getDescribedFunctionTemplate() != nullptr)
9741       << mode << Fn->getParamDecl(0) << NumFormalArgs;
9742   else
9743     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_arity)
9744       << (unsigned) FnKind << (Fn->getDescribedFunctionTemplate() != nullptr)
9745       << mode << modeCount << NumFormalArgs;
9746   MaybeEmitInheritedConstructorNote(S, Found);
9747 }
9748 
9749 /// Arity mismatch diagnosis specific to a function overload candidate.
9750 static void DiagnoseArityMismatch(Sema &S, OverloadCandidate *Cand,
9751                                   unsigned NumFormalArgs) {
9752   if (!CheckArityMismatch(S, Cand, NumFormalArgs))
9753     DiagnoseArityMismatch(S, Cand->FoundDecl, Cand->Function, NumFormalArgs);
9754 }
9755 
9756 static TemplateDecl *getDescribedTemplate(Decl *Templated) {
9757   if (TemplateDecl *TD = Templated->getDescribedTemplate())
9758     return TD;
9759   llvm_unreachable("Unsupported: Getting the described template declaration"
9760                    " for bad deduction diagnosis");
9761 }
9762 
9763 /// Diagnose a failed template-argument deduction.
9764 static void DiagnoseBadDeduction(Sema &S, NamedDecl *Found, Decl *Templated,
9765                                  DeductionFailureInfo &DeductionFailure,
9766                                  unsigned NumArgs,
9767                                  bool TakingCandidateAddress) {
9768   TemplateParameter Param = DeductionFailure.getTemplateParameter();
9769   NamedDecl *ParamD;
9770   (ParamD = Param.dyn_cast<TemplateTypeParmDecl*>()) ||
9771   (ParamD = Param.dyn_cast<NonTypeTemplateParmDecl*>()) ||
9772   (ParamD = Param.dyn_cast<TemplateTemplateParmDecl*>());
9773   switch (DeductionFailure.Result) {
9774   case Sema::TDK_Success:
9775     llvm_unreachable("TDK_success while diagnosing bad deduction");
9776 
9777   case Sema::TDK_Incomplete: {
9778     assert(ParamD && "no parameter found for incomplete deduction result");
9779     S.Diag(Templated->getLocation(),
9780            diag::note_ovl_candidate_incomplete_deduction)
9781         << ParamD->getDeclName();
9782     MaybeEmitInheritedConstructorNote(S, Found);
9783     return;
9784   }
9785 
9786   case Sema::TDK_Underqualified: {
9787     assert(ParamD && "no parameter found for bad qualifiers deduction result");
9788     TemplateTypeParmDecl *TParam = cast<TemplateTypeParmDecl>(ParamD);
9789 
9790     QualType Param = DeductionFailure.getFirstArg()->getAsType();
9791 
9792     // Param will have been canonicalized, but it should just be a
9793     // qualified version of ParamD, so move the qualifiers to that.
9794     QualifierCollector Qs;
9795     Qs.strip(Param);
9796     QualType NonCanonParam = Qs.apply(S.Context, TParam->getTypeForDecl());
9797     assert(S.Context.hasSameType(Param, NonCanonParam));
9798 
9799     // Arg has also been canonicalized, but there's nothing we can do
9800     // about that.  It also doesn't matter as much, because it won't
9801     // have any template parameters in it (because deduction isn't
9802     // done on dependent types).
9803     QualType Arg = DeductionFailure.getSecondArg()->getAsType();
9804 
9805     S.Diag(Templated->getLocation(), diag::note_ovl_candidate_underqualified)
9806         << ParamD->getDeclName() << Arg << NonCanonParam;
9807     MaybeEmitInheritedConstructorNote(S, Found);
9808     return;
9809   }
9810 
9811   case Sema::TDK_Inconsistent: {
9812     assert(ParamD && "no parameter found for inconsistent deduction result");
9813     int which = 0;
9814     if (isa<TemplateTypeParmDecl>(ParamD))
9815       which = 0;
9816     else if (isa<NonTypeTemplateParmDecl>(ParamD)) {
9817       // Deduction might have failed because we deduced arguments of two
9818       // different types for a non-type template parameter.
9819       // FIXME: Use a different TDK value for this.
9820       QualType T1 =
9821           DeductionFailure.getFirstArg()->getNonTypeTemplateArgumentType();
9822       QualType T2 =
9823           DeductionFailure.getSecondArg()->getNonTypeTemplateArgumentType();
9824       if (!S.Context.hasSameType(T1, T2)) {
9825         S.Diag(Templated->getLocation(),
9826                diag::note_ovl_candidate_inconsistent_deduction_types)
9827           << ParamD->getDeclName() << *DeductionFailure.getFirstArg() << T1
9828           << *DeductionFailure.getSecondArg() << T2;
9829         MaybeEmitInheritedConstructorNote(S, Found);
9830         return;
9831       }
9832 
9833       which = 1;
9834     } else {
9835       which = 2;
9836     }
9837 
9838     S.Diag(Templated->getLocation(),
9839            diag::note_ovl_candidate_inconsistent_deduction)
9840         << which << ParamD->getDeclName() << *DeductionFailure.getFirstArg()
9841         << *DeductionFailure.getSecondArg();
9842     MaybeEmitInheritedConstructorNote(S, Found);
9843     return;
9844   }
9845 
9846   case Sema::TDK_InvalidExplicitArguments:
9847     assert(ParamD && "no parameter found for invalid explicit arguments");
9848     if (ParamD->getDeclName())
9849       S.Diag(Templated->getLocation(),
9850              diag::note_ovl_candidate_explicit_arg_mismatch_named)
9851           << ParamD->getDeclName();
9852     else {
9853       int index = 0;
9854       if (TemplateTypeParmDecl *TTP = dyn_cast<TemplateTypeParmDecl>(ParamD))
9855         index = TTP->getIndex();
9856       else if (NonTypeTemplateParmDecl *NTTP
9857                                   = dyn_cast<NonTypeTemplateParmDecl>(ParamD))
9858         index = NTTP->getIndex();
9859       else
9860         index = cast<TemplateTemplateParmDecl>(ParamD)->getIndex();
9861       S.Diag(Templated->getLocation(),
9862              diag::note_ovl_candidate_explicit_arg_mismatch_unnamed)
9863           << (index + 1);
9864     }
9865     MaybeEmitInheritedConstructorNote(S, Found);
9866     return;
9867 
9868   case Sema::TDK_TooManyArguments:
9869   case Sema::TDK_TooFewArguments:
9870     DiagnoseArityMismatch(S, Found, Templated, NumArgs);
9871     return;
9872 
9873   case Sema::TDK_InstantiationDepth:
9874     S.Diag(Templated->getLocation(),
9875            diag::note_ovl_candidate_instantiation_depth);
9876     MaybeEmitInheritedConstructorNote(S, Found);
9877     return;
9878 
9879   case Sema::TDK_SubstitutionFailure: {
9880     // Format the template argument list into the argument string.
9881     SmallString<128> TemplateArgString;
9882     if (TemplateArgumentList *Args =
9883             DeductionFailure.getTemplateArgumentList()) {
9884       TemplateArgString = " ";
9885       TemplateArgString += S.getTemplateArgumentBindingsText(
9886           getDescribedTemplate(Templated)->getTemplateParameters(), *Args);
9887     }
9888 
9889     // If this candidate was disabled by enable_if, say so.
9890     PartialDiagnosticAt *PDiag = DeductionFailure.getSFINAEDiagnostic();
9891     if (PDiag && PDiag->second.getDiagID() ==
9892           diag::err_typename_nested_not_found_enable_if) {
9893       // FIXME: Use the source range of the condition, and the fully-qualified
9894       //        name of the enable_if template. These are both present in PDiag.
9895       S.Diag(PDiag->first, diag::note_ovl_candidate_disabled_by_enable_if)
9896         << "'enable_if'" << TemplateArgString;
9897       return;
9898     }
9899 
9900     // We found a specific requirement that disabled the enable_if.
9901     if (PDiag && PDiag->second.getDiagID() ==
9902         diag::err_typename_nested_not_found_requirement) {
9903       S.Diag(Templated->getLocation(),
9904              diag::note_ovl_candidate_disabled_by_requirement)
9905         << PDiag->second.getStringArg(0) << TemplateArgString;
9906       return;
9907     }
9908 
9909     // Format the SFINAE diagnostic into the argument string.
9910     // FIXME: Add a general mechanism to include a PartialDiagnostic *'s
9911     //        formatted message in another diagnostic.
9912     SmallString<128> SFINAEArgString;
9913     SourceRange R;
9914     if (PDiag) {
9915       SFINAEArgString = ": ";
9916       R = SourceRange(PDiag->first, PDiag->first);
9917       PDiag->second.EmitToString(S.getDiagnostics(), SFINAEArgString);
9918     }
9919 
9920     S.Diag(Templated->getLocation(),
9921            diag::note_ovl_candidate_substitution_failure)
9922         << TemplateArgString << SFINAEArgString << R;
9923     MaybeEmitInheritedConstructorNote(S, Found);
9924     return;
9925   }
9926 
9927   case Sema::TDK_DeducedMismatch:
9928   case Sema::TDK_DeducedMismatchNested: {
9929     // Format the template argument list into the argument string.
9930     SmallString<128> TemplateArgString;
9931     if (TemplateArgumentList *Args =
9932             DeductionFailure.getTemplateArgumentList()) {
9933       TemplateArgString = " ";
9934       TemplateArgString += S.getTemplateArgumentBindingsText(
9935           getDescribedTemplate(Templated)->getTemplateParameters(), *Args);
9936     }
9937 
9938     S.Diag(Templated->getLocation(), diag::note_ovl_candidate_deduced_mismatch)
9939         << (*DeductionFailure.getCallArgIndex() + 1)
9940         << *DeductionFailure.getFirstArg() << *DeductionFailure.getSecondArg()
9941         << TemplateArgString
9942         << (DeductionFailure.Result == Sema::TDK_DeducedMismatchNested);
9943     break;
9944   }
9945 
9946   case Sema::TDK_NonDeducedMismatch: {
9947     // FIXME: Provide a source location to indicate what we couldn't match.
9948     TemplateArgument FirstTA = *DeductionFailure.getFirstArg();
9949     TemplateArgument SecondTA = *DeductionFailure.getSecondArg();
9950     if (FirstTA.getKind() == TemplateArgument::Template &&
9951         SecondTA.getKind() == TemplateArgument::Template) {
9952       TemplateName FirstTN = FirstTA.getAsTemplate();
9953       TemplateName SecondTN = SecondTA.getAsTemplate();
9954       if (FirstTN.getKind() == TemplateName::Template &&
9955           SecondTN.getKind() == TemplateName::Template) {
9956         if (FirstTN.getAsTemplateDecl()->getName() ==
9957             SecondTN.getAsTemplateDecl()->getName()) {
9958           // FIXME: This fixes a bad diagnostic where both templates are named
9959           // the same.  This particular case is a bit difficult since:
9960           // 1) It is passed as a string to the diagnostic printer.
9961           // 2) The diagnostic printer only attempts to find a better
9962           //    name for types, not decls.
9963           // Ideally, this should folded into the diagnostic printer.
9964           S.Diag(Templated->getLocation(),
9965                  diag::note_ovl_candidate_non_deduced_mismatch_qualified)
9966               << FirstTN.getAsTemplateDecl() << SecondTN.getAsTemplateDecl();
9967           return;
9968         }
9969       }
9970     }
9971 
9972     if (TakingCandidateAddress && isa<FunctionDecl>(Templated) &&
9973         !checkAddressOfCandidateIsAvailable(S, cast<FunctionDecl>(Templated)))
9974       return;
9975 
9976     // FIXME: For generic lambda parameters, check if the function is a lambda
9977     // call operator, and if so, emit a prettier and more informative
9978     // diagnostic that mentions 'auto' and lambda in addition to
9979     // (or instead of?) the canonical template type parameters.
9980     S.Diag(Templated->getLocation(),
9981            diag::note_ovl_candidate_non_deduced_mismatch)
9982         << FirstTA << SecondTA;
9983     return;
9984   }
9985   // TODO: diagnose these individually, then kill off
9986   // note_ovl_candidate_bad_deduction, which is uselessly vague.
9987   case Sema::TDK_MiscellaneousDeductionFailure:
9988     S.Diag(Templated->getLocation(), diag::note_ovl_candidate_bad_deduction);
9989     MaybeEmitInheritedConstructorNote(S, Found);
9990     return;
9991   case Sema::TDK_CUDATargetMismatch:
9992     S.Diag(Templated->getLocation(),
9993            diag::note_cuda_ovl_candidate_target_mismatch);
9994     return;
9995   }
9996 }
9997 
9998 /// Diagnose a failed template-argument deduction, for function calls.
9999 static void DiagnoseBadDeduction(Sema &S, OverloadCandidate *Cand,
10000                                  unsigned NumArgs,
10001                                  bool TakingCandidateAddress) {
10002   unsigned TDK = Cand->DeductionFailure.Result;
10003   if (TDK == Sema::TDK_TooFewArguments || TDK == Sema::TDK_TooManyArguments) {
10004     if (CheckArityMismatch(S, Cand, NumArgs))
10005       return;
10006   }
10007   DiagnoseBadDeduction(S, Cand->FoundDecl, Cand->Function, // pattern
10008                        Cand->DeductionFailure, NumArgs, TakingCandidateAddress);
10009 }
10010 
10011 /// CUDA: diagnose an invalid call across targets.
10012 static void DiagnoseBadTarget(Sema &S, OverloadCandidate *Cand) {
10013   FunctionDecl *Caller = cast<FunctionDecl>(S.CurContext);
10014   FunctionDecl *Callee = Cand->Function;
10015 
10016   Sema::CUDAFunctionTarget CallerTarget = S.IdentifyCUDATarget(Caller),
10017                            CalleeTarget = S.IdentifyCUDATarget(Callee);
10018 
10019   std::string FnDesc;
10020   OverloadCandidateKind FnKind =
10021       ClassifyOverloadCandidate(S, Cand->FoundDecl, Callee, FnDesc);
10022 
10023   S.Diag(Callee->getLocation(), diag::note_ovl_candidate_bad_target)
10024       << (unsigned)FnKind << CalleeTarget << CallerTarget;
10025 
10026   // This could be an implicit constructor for which we could not infer the
10027   // target due to a collsion. Diagnose that case.
10028   CXXMethodDecl *Meth = dyn_cast<CXXMethodDecl>(Callee);
10029   if (Meth != nullptr && Meth->isImplicit()) {
10030     CXXRecordDecl *ParentClass = Meth->getParent();
10031     Sema::CXXSpecialMember CSM;
10032 
10033     switch (FnKind) {
10034     default:
10035       return;
10036     case oc_implicit_default_constructor:
10037       CSM = Sema::CXXDefaultConstructor;
10038       break;
10039     case oc_implicit_copy_constructor:
10040       CSM = Sema::CXXCopyConstructor;
10041       break;
10042     case oc_implicit_move_constructor:
10043       CSM = Sema::CXXMoveConstructor;
10044       break;
10045     case oc_implicit_copy_assignment:
10046       CSM = Sema::CXXCopyAssignment;
10047       break;
10048     case oc_implicit_move_assignment:
10049       CSM = Sema::CXXMoveAssignment;
10050       break;
10051     };
10052 
10053     bool ConstRHS = false;
10054     if (Meth->getNumParams()) {
10055       if (const ReferenceType *RT =
10056               Meth->getParamDecl(0)->getType()->getAs<ReferenceType>()) {
10057         ConstRHS = RT->getPointeeType().isConstQualified();
10058       }
10059     }
10060 
10061     S.inferCUDATargetForImplicitSpecialMember(ParentClass, CSM, Meth,
10062                                               /* ConstRHS */ ConstRHS,
10063                                               /* Diagnose */ true);
10064   }
10065 }
10066 
10067 static void DiagnoseFailedEnableIfAttr(Sema &S, OverloadCandidate *Cand) {
10068   FunctionDecl *Callee = Cand->Function;
10069   EnableIfAttr *Attr = static_cast<EnableIfAttr*>(Cand->DeductionFailure.Data);
10070 
10071   S.Diag(Callee->getLocation(),
10072          diag::note_ovl_candidate_disabled_by_function_cond_attr)
10073       << Attr->getCond()->getSourceRange() << Attr->getMessage();
10074 }
10075 
10076 static void DiagnoseOpenCLExtensionDisabled(Sema &S, OverloadCandidate *Cand) {
10077   FunctionDecl *Callee = Cand->Function;
10078 
10079   S.Diag(Callee->getLocation(),
10080          diag::note_ovl_candidate_disabled_by_extension);
10081 }
10082 
10083 /// Generates a 'note' diagnostic for an overload candidate.  We've
10084 /// already generated a primary error at the call site.
10085 ///
10086 /// It really does need to be a single diagnostic with its caret
10087 /// pointed at the candidate declaration.  Yes, this creates some
10088 /// major challenges of technical writing.  Yes, this makes pointing
10089 /// out problems with specific arguments quite awkward.  It's still
10090 /// better than generating twenty screens of text for every failed
10091 /// overload.
10092 ///
10093 /// It would be great to be able to express per-candidate problems
10094 /// more richly for those diagnostic clients that cared, but we'd
10095 /// still have to be just as careful with the default diagnostics.
10096 static void NoteFunctionCandidate(Sema &S, OverloadCandidate *Cand,
10097                                   unsigned NumArgs,
10098                                   bool TakingCandidateAddress) {
10099   FunctionDecl *Fn = Cand->Function;
10100 
10101   // Note deleted candidates, but only if they're viable.
10102   if (Cand->Viable) {
10103     if (Fn->isDeleted() || S.isFunctionConsideredUnavailable(Fn)) {
10104       std::string FnDesc;
10105       OverloadCandidateKind FnKind =
10106         ClassifyOverloadCandidate(S, Cand->FoundDecl, Fn, FnDesc);
10107 
10108       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_deleted)
10109         << FnKind << FnDesc
10110         << (Fn->isDeleted() ? (Fn->isDeletedAsWritten() ? 1 : 2) : 0);
10111       MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
10112       return;
10113     }
10114 
10115     // We don't really have anything else to say about viable candidates.
10116     S.NoteOverloadCandidate(Cand->FoundDecl, Fn);
10117     return;
10118   }
10119 
10120   switch (Cand->FailureKind) {
10121   case ovl_fail_too_many_arguments:
10122   case ovl_fail_too_few_arguments:
10123     return DiagnoseArityMismatch(S, Cand, NumArgs);
10124 
10125   case ovl_fail_bad_deduction:
10126     return DiagnoseBadDeduction(S, Cand, NumArgs,
10127                                 TakingCandidateAddress);
10128 
10129   case ovl_fail_illegal_constructor: {
10130     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_illegal_constructor)
10131       << (Fn->getPrimaryTemplate() ? 1 : 0);
10132     MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
10133     return;
10134   }
10135 
10136   case ovl_fail_trivial_conversion:
10137   case ovl_fail_bad_final_conversion:
10138   case ovl_fail_final_conversion_not_exact:
10139     return S.NoteOverloadCandidate(Cand->FoundDecl, Fn);
10140 
10141   case ovl_fail_bad_conversion: {
10142     unsigned I = (Cand->IgnoreObjectArgument ? 1 : 0);
10143     for (unsigned N = Cand->Conversions.size(); I != N; ++I)
10144       if (Cand->Conversions[I].isBad())
10145         return DiagnoseBadConversion(S, Cand, I, TakingCandidateAddress);
10146 
10147     // FIXME: this currently happens when we're called from SemaInit
10148     // when user-conversion overload fails.  Figure out how to handle
10149     // those conditions and diagnose them well.
10150     return S.NoteOverloadCandidate(Cand->FoundDecl, Fn);
10151   }
10152 
10153   case ovl_fail_bad_target:
10154     return DiagnoseBadTarget(S, Cand);
10155 
10156   case ovl_fail_enable_if:
10157     return DiagnoseFailedEnableIfAttr(S, Cand);
10158 
10159   case ovl_fail_ext_disabled:
10160     return DiagnoseOpenCLExtensionDisabled(S, Cand);
10161 
10162   case ovl_fail_inhctor_slice:
10163     // It's generally not interesting to note copy/move constructors here.
10164     if (cast<CXXConstructorDecl>(Fn)->isCopyOrMoveConstructor())
10165       return;
10166     S.Diag(Fn->getLocation(),
10167            diag::note_ovl_candidate_inherited_constructor_slice)
10168       << (Fn->getPrimaryTemplate() ? 1 : 0)
10169       << Fn->getParamDecl(0)->getType()->isRValueReferenceType();
10170     MaybeEmitInheritedConstructorNote(S, Cand->FoundDecl);
10171     return;
10172 
10173   case ovl_fail_addr_not_available: {
10174     bool Available = checkAddressOfCandidateIsAvailable(S, Cand->Function);
10175     (void)Available;
10176     assert(!Available);
10177     break;
10178   }
10179   }
10180 }
10181 
10182 static void NoteSurrogateCandidate(Sema &S, OverloadCandidate *Cand) {
10183   // Desugar the type of the surrogate down to a function type,
10184   // retaining as many typedefs as possible while still showing
10185   // the function type (and, therefore, its parameter types).
10186   QualType FnType = Cand->Surrogate->getConversionType();
10187   bool isLValueReference = false;
10188   bool isRValueReference = false;
10189   bool isPointer = false;
10190   if (const LValueReferenceType *FnTypeRef =
10191         FnType->getAs<LValueReferenceType>()) {
10192     FnType = FnTypeRef->getPointeeType();
10193     isLValueReference = true;
10194   } else if (const RValueReferenceType *FnTypeRef =
10195                FnType->getAs<RValueReferenceType>()) {
10196     FnType = FnTypeRef->getPointeeType();
10197     isRValueReference = true;
10198   }
10199   if (const PointerType *FnTypePtr = FnType->getAs<PointerType>()) {
10200     FnType = FnTypePtr->getPointeeType();
10201     isPointer = true;
10202   }
10203   // Desugar down to a function type.
10204   FnType = QualType(FnType->getAs<FunctionType>(), 0);
10205   // Reconstruct the pointer/reference as appropriate.
10206   if (isPointer) FnType = S.Context.getPointerType(FnType);
10207   if (isRValueReference) FnType = S.Context.getRValueReferenceType(FnType);
10208   if (isLValueReference) FnType = S.Context.getLValueReferenceType(FnType);
10209 
10210   S.Diag(Cand->Surrogate->getLocation(), diag::note_ovl_surrogate_cand)
10211     << FnType;
10212 }
10213 
10214 static void NoteBuiltinOperatorCandidate(Sema &S, StringRef Opc,
10215                                          SourceLocation OpLoc,
10216                                          OverloadCandidate *Cand) {
10217   assert(Cand->Conversions.size() <= 2 && "builtin operator is not binary");
10218   std::string TypeStr("operator");
10219   TypeStr += Opc;
10220   TypeStr += "(";
10221   TypeStr += Cand->BuiltinParamTypes[0].getAsString();
10222   if (Cand->Conversions.size() == 1) {
10223     TypeStr += ")";
10224     S.Diag(OpLoc, diag::note_ovl_builtin_unary_candidate) << TypeStr;
10225   } else {
10226     TypeStr += ", ";
10227     TypeStr += Cand->BuiltinParamTypes[1].getAsString();
10228     TypeStr += ")";
10229     S.Diag(OpLoc, diag::note_ovl_builtin_binary_candidate) << TypeStr;
10230   }
10231 }
10232 
10233 static void NoteAmbiguousUserConversions(Sema &S, SourceLocation OpLoc,
10234                                          OverloadCandidate *Cand) {
10235   for (const ImplicitConversionSequence &ICS : Cand->Conversions) {
10236     if (ICS.isBad()) break; // all meaningless after first invalid
10237     if (!ICS.isAmbiguous()) continue;
10238 
10239     ICS.DiagnoseAmbiguousConversion(
10240         S, OpLoc, S.PDiag(diag::note_ambiguous_type_conversion));
10241   }
10242 }
10243 
10244 static SourceLocation GetLocationForCandidate(const OverloadCandidate *Cand) {
10245   if (Cand->Function)
10246     return Cand->Function->getLocation();
10247   if (Cand->IsSurrogate)
10248     return Cand->Surrogate->getLocation();
10249   return SourceLocation();
10250 }
10251 
10252 static unsigned RankDeductionFailure(const DeductionFailureInfo &DFI) {
10253   switch ((Sema::TemplateDeductionResult)DFI.Result) {
10254   case Sema::TDK_Success:
10255   case Sema::TDK_NonDependentConversionFailure:
10256     llvm_unreachable("non-deduction failure while diagnosing bad deduction");
10257 
10258   case Sema::TDK_Invalid:
10259   case Sema::TDK_Incomplete:
10260     return 1;
10261 
10262   case Sema::TDK_Underqualified:
10263   case Sema::TDK_Inconsistent:
10264     return 2;
10265 
10266   case Sema::TDK_SubstitutionFailure:
10267   case Sema::TDK_DeducedMismatch:
10268   case Sema::TDK_DeducedMismatchNested:
10269   case Sema::TDK_NonDeducedMismatch:
10270   case Sema::TDK_MiscellaneousDeductionFailure:
10271   case Sema::TDK_CUDATargetMismatch:
10272     return 3;
10273 
10274   case Sema::TDK_InstantiationDepth:
10275     return 4;
10276 
10277   case Sema::TDK_InvalidExplicitArguments:
10278     return 5;
10279 
10280   case Sema::TDK_TooManyArguments:
10281   case Sema::TDK_TooFewArguments:
10282     return 6;
10283   }
10284   llvm_unreachable("Unhandled deduction result");
10285 }
10286 
10287 namespace {
10288 struct CompareOverloadCandidatesForDisplay {
10289   Sema &S;
10290   SourceLocation Loc;
10291   size_t NumArgs;
10292   OverloadCandidateSet::CandidateSetKind CSK;
10293 
10294   CompareOverloadCandidatesForDisplay(
10295       Sema &S, SourceLocation Loc, size_t NArgs,
10296       OverloadCandidateSet::CandidateSetKind CSK)
10297       : S(S), NumArgs(NArgs), CSK(CSK) {}
10298 
10299   bool operator()(const OverloadCandidate *L,
10300                   const OverloadCandidate *R) {
10301     // Fast-path this check.
10302     if (L == R) return false;
10303 
10304     // Order first by viability.
10305     if (L->Viable) {
10306       if (!R->Viable) return true;
10307 
10308       // TODO: introduce a tri-valued comparison for overload
10309       // candidates.  Would be more worthwhile if we had a sort
10310       // that could exploit it.
10311       if (isBetterOverloadCandidate(S, *L, *R, SourceLocation(), CSK))
10312         return true;
10313       if (isBetterOverloadCandidate(S, *R, *L, SourceLocation(), CSK))
10314         return false;
10315     } else if (R->Viable)
10316       return false;
10317 
10318     assert(L->Viable == R->Viable);
10319 
10320     // Criteria by which we can sort non-viable candidates:
10321     if (!L->Viable) {
10322       // 1. Arity mismatches come after other candidates.
10323       if (L->FailureKind == ovl_fail_too_many_arguments ||
10324           L->FailureKind == ovl_fail_too_few_arguments) {
10325         if (R->FailureKind == ovl_fail_too_many_arguments ||
10326             R->FailureKind == ovl_fail_too_few_arguments) {
10327           int LDist = std::abs((int)L->getNumParams() - (int)NumArgs);
10328           int RDist = std::abs((int)R->getNumParams() - (int)NumArgs);
10329           if (LDist == RDist) {
10330             if (L->FailureKind == R->FailureKind)
10331               // Sort non-surrogates before surrogates.
10332               return !L->IsSurrogate && R->IsSurrogate;
10333             // Sort candidates requiring fewer parameters than there were
10334             // arguments given after candidates requiring more parameters
10335             // than there were arguments given.
10336             return L->FailureKind == ovl_fail_too_many_arguments;
10337           }
10338           return LDist < RDist;
10339         }
10340         return false;
10341       }
10342       if (R->FailureKind == ovl_fail_too_many_arguments ||
10343           R->FailureKind == ovl_fail_too_few_arguments)
10344         return true;
10345 
10346       // 2. Bad conversions come first and are ordered by the number
10347       // of bad conversions and quality of good conversions.
10348       if (L->FailureKind == ovl_fail_bad_conversion) {
10349         if (R->FailureKind != ovl_fail_bad_conversion)
10350           return true;
10351 
10352         // The conversion that can be fixed with a smaller number of changes,
10353         // comes first.
10354         unsigned numLFixes = L->Fix.NumConversionsFixed;
10355         unsigned numRFixes = R->Fix.NumConversionsFixed;
10356         numLFixes = (numLFixes == 0) ? UINT_MAX : numLFixes;
10357         numRFixes = (numRFixes == 0) ? UINT_MAX : numRFixes;
10358         if (numLFixes != numRFixes) {
10359           return numLFixes < numRFixes;
10360         }
10361 
10362         // If there's any ordering between the defined conversions...
10363         // FIXME: this might not be transitive.
10364         assert(L->Conversions.size() == R->Conversions.size());
10365 
10366         int leftBetter = 0;
10367         unsigned I = (L->IgnoreObjectArgument || R->IgnoreObjectArgument);
10368         for (unsigned E = L->Conversions.size(); I != E; ++I) {
10369           switch (CompareImplicitConversionSequences(S, Loc,
10370                                                      L->Conversions[I],
10371                                                      R->Conversions[I])) {
10372           case ImplicitConversionSequence::Better:
10373             leftBetter++;
10374             break;
10375 
10376           case ImplicitConversionSequence::Worse:
10377             leftBetter--;
10378             break;
10379 
10380           case ImplicitConversionSequence::Indistinguishable:
10381             break;
10382           }
10383         }
10384         if (leftBetter > 0) return true;
10385         if (leftBetter < 0) return false;
10386 
10387       } else if (R->FailureKind == ovl_fail_bad_conversion)
10388         return false;
10389 
10390       if (L->FailureKind == ovl_fail_bad_deduction) {
10391         if (R->FailureKind != ovl_fail_bad_deduction)
10392           return true;
10393 
10394         if (L->DeductionFailure.Result != R->DeductionFailure.Result)
10395           return RankDeductionFailure(L->DeductionFailure)
10396                < RankDeductionFailure(R->DeductionFailure);
10397       } else if (R->FailureKind == ovl_fail_bad_deduction)
10398         return false;
10399 
10400       // TODO: others?
10401     }
10402 
10403     // Sort everything else by location.
10404     SourceLocation LLoc = GetLocationForCandidate(L);
10405     SourceLocation RLoc = GetLocationForCandidate(R);
10406 
10407     // Put candidates without locations (e.g. builtins) at the end.
10408     if (LLoc.isInvalid()) return false;
10409     if (RLoc.isInvalid()) return true;
10410 
10411     return S.SourceMgr.isBeforeInTranslationUnit(LLoc, RLoc);
10412   }
10413 };
10414 }
10415 
10416 /// CompleteNonViableCandidate - Normally, overload resolution only
10417 /// computes up to the first bad conversion. Produces the FixIt set if
10418 /// possible.
10419 static void CompleteNonViableCandidate(Sema &S, OverloadCandidate *Cand,
10420                                        ArrayRef<Expr *> Args) {
10421   assert(!Cand->Viable);
10422 
10423   // Don't do anything on failures other than bad conversion.
10424   if (Cand->FailureKind != ovl_fail_bad_conversion) return;
10425 
10426   // We only want the FixIts if all the arguments can be corrected.
10427   bool Unfixable = false;
10428   // Use a implicit copy initialization to check conversion fixes.
10429   Cand->Fix.setConversionChecker(TryCopyInitialization);
10430 
10431   // Attempt to fix the bad conversion.
10432   unsigned ConvCount = Cand->Conversions.size();
10433   for (unsigned ConvIdx = (Cand->IgnoreObjectArgument ? 1 : 0); /**/;
10434        ++ConvIdx) {
10435     assert(ConvIdx != ConvCount && "no bad conversion in candidate");
10436     if (Cand->Conversions[ConvIdx].isInitialized() &&
10437         Cand->Conversions[ConvIdx].isBad()) {
10438       Unfixable = !Cand->TryToFixBadConversion(ConvIdx, S);
10439       break;
10440     }
10441   }
10442 
10443   // FIXME: this should probably be preserved from the overload
10444   // operation somehow.
10445   bool SuppressUserConversions = false;
10446 
10447   unsigned ConvIdx = 0;
10448   ArrayRef<QualType> ParamTypes;
10449 
10450   if (Cand->IsSurrogate) {
10451     QualType ConvType
10452       = Cand->Surrogate->getConversionType().getNonReferenceType();
10453     if (const PointerType *ConvPtrType = ConvType->getAs<PointerType>())
10454       ConvType = ConvPtrType->getPointeeType();
10455     ParamTypes = ConvType->getAs<FunctionProtoType>()->getParamTypes();
10456     // Conversion 0 is 'this', which doesn't have a corresponding argument.
10457     ConvIdx = 1;
10458   } else if (Cand->Function) {
10459     ParamTypes =
10460         Cand->Function->getType()->getAs<FunctionProtoType>()->getParamTypes();
10461     if (isa<CXXMethodDecl>(Cand->Function) &&
10462         !isa<CXXConstructorDecl>(Cand->Function)) {
10463       // Conversion 0 is 'this', which doesn't have a corresponding argument.
10464       ConvIdx = 1;
10465     }
10466   } else {
10467     // Builtin operator.
10468     assert(ConvCount <= 3);
10469     ParamTypes = Cand->BuiltinParamTypes;
10470   }
10471 
10472   // Fill in the rest of the conversions.
10473   for (unsigned ArgIdx = 0; ConvIdx != ConvCount; ++ConvIdx, ++ArgIdx) {
10474     if (Cand->Conversions[ConvIdx].isInitialized()) {
10475       // We've already checked this conversion.
10476     } else if (ArgIdx < ParamTypes.size()) {
10477       if (ParamTypes[ArgIdx]->isDependentType())
10478         Cand->Conversions[ConvIdx].setAsIdentityConversion(
10479             Args[ArgIdx]->getType());
10480       else {
10481         Cand->Conversions[ConvIdx] =
10482             TryCopyInitialization(S, Args[ArgIdx], ParamTypes[ArgIdx],
10483                                   SuppressUserConversions,
10484                                   /*InOverloadResolution=*/true,
10485                                   /*AllowObjCWritebackConversion=*/
10486                                   S.getLangOpts().ObjCAutoRefCount);
10487         // Store the FixIt in the candidate if it exists.
10488         if (!Unfixable && Cand->Conversions[ConvIdx].isBad())
10489           Unfixable = !Cand->TryToFixBadConversion(ConvIdx, S);
10490       }
10491     } else
10492       Cand->Conversions[ConvIdx].setEllipsis();
10493   }
10494 }
10495 
10496 /// PrintOverloadCandidates - When overload resolution fails, prints
10497 /// diagnostic messages containing the candidates in the candidate
10498 /// set.
10499 void OverloadCandidateSet::NoteCandidates(
10500     Sema &S, OverloadCandidateDisplayKind OCD, ArrayRef<Expr *> Args,
10501     StringRef Opc, SourceLocation OpLoc,
10502     llvm::function_ref<bool(OverloadCandidate &)> Filter) {
10503   // Sort the candidates by viability and position.  Sorting directly would
10504   // be prohibitive, so we make a set of pointers and sort those.
10505   SmallVector<OverloadCandidate*, 32> Cands;
10506   if (OCD == OCD_AllCandidates) Cands.reserve(size());
10507   for (iterator Cand = begin(), LastCand = end(); Cand != LastCand; ++Cand) {
10508     if (!Filter(*Cand))
10509       continue;
10510     if (Cand->Viable)
10511       Cands.push_back(Cand);
10512     else if (OCD == OCD_AllCandidates) {
10513       CompleteNonViableCandidate(S, Cand, Args);
10514       if (Cand->Function || Cand->IsSurrogate)
10515         Cands.push_back(Cand);
10516       // Otherwise, this a non-viable builtin candidate.  We do not, in general,
10517       // want to list every possible builtin candidate.
10518     }
10519   }
10520 
10521   std::stable_sort(Cands.begin(), Cands.end(),
10522             CompareOverloadCandidatesForDisplay(S, OpLoc, Args.size(), Kind));
10523 
10524   bool ReportedAmbiguousConversions = false;
10525 
10526   SmallVectorImpl<OverloadCandidate*>::iterator I, E;
10527   const OverloadsShown ShowOverloads = S.Diags.getShowOverloads();
10528   unsigned CandsShown = 0;
10529   for (I = Cands.begin(), E = Cands.end(); I != E; ++I) {
10530     OverloadCandidate *Cand = *I;
10531 
10532     // Set an arbitrary limit on the number of candidate functions we'll spam
10533     // the user with.  FIXME: This limit should depend on details of the
10534     // candidate list.
10535     if (CandsShown >= 4 && ShowOverloads == Ovl_Best) {
10536       break;
10537     }
10538     ++CandsShown;
10539 
10540     if (Cand->Function)
10541       NoteFunctionCandidate(S, Cand, Args.size(),
10542                             /*TakingCandidateAddress=*/false);
10543     else if (Cand->IsSurrogate)
10544       NoteSurrogateCandidate(S, Cand);
10545     else {
10546       assert(Cand->Viable &&
10547              "Non-viable built-in candidates are not added to Cands.");
10548       // Generally we only see ambiguities including viable builtin
10549       // operators if overload resolution got screwed up by an
10550       // ambiguous user-defined conversion.
10551       //
10552       // FIXME: It's quite possible for different conversions to see
10553       // different ambiguities, though.
10554       if (!ReportedAmbiguousConversions) {
10555         NoteAmbiguousUserConversions(S, OpLoc, Cand);
10556         ReportedAmbiguousConversions = true;
10557       }
10558 
10559       // If this is a viable builtin, print it.
10560       NoteBuiltinOperatorCandidate(S, Opc, OpLoc, Cand);
10561     }
10562   }
10563 
10564   if (I != E)
10565     S.Diag(OpLoc, diag::note_ovl_too_many_candidates) << int(E - I);
10566 }
10567 
10568 static SourceLocation
10569 GetLocationForCandidate(const TemplateSpecCandidate *Cand) {
10570   return Cand->Specialization ? Cand->Specialization->getLocation()
10571                               : SourceLocation();
10572 }
10573 
10574 namespace {
10575 struct CompareTemplateSpecCandidatesForDisplay {
10576   Sema &S;
10577   CompareTemplateSpecCandidatesForDisplay(Sema &S) : S(S) {}
10578 
10579   bool operator()(const TemplateSpecCandidate *L,
10580                   const TemplateSpecCandidate *R) {
10581     // Fast-path this check.
10582     if (L == R)
10583       return false;
10584 
10585     // Assuming that both candidates are not matches...
10586 
10587     // Sort by the ranking of deduction failures.
10588     if (L->DeductionFailure.Result != R->DeductionFailure.Result)
10589       return RankDeductionFailure(L->DeductionFailure) <
10590              RankDeductionFailure(R->DeductionFailure);
10591 
10592     // Sort everything else by location.
10593     SourceLocation LLoc = GetLocationForCandidate(L);
10594     SourceLocation RLoc = GetLocationForCandidate(R);
10595 
10596     // Put candidates without locations (e.g. builtins) at the end.
10597     if (LLoc.isInvalid())
10598       return false;
10599     if (RLoc.isInvalid())
10600       return true;
10601 
10602     return S.SourceMgr.isBeforeInTranslationUnit(LLoc, RLoc);
10603   }
10604 };
10605 }
10606 
10607 /// Diagnose a template argument deduction failure.
10608 /// We are treating these failures as overload failures due to bad
10609 /// deductions.
10610 void TemplateSpecCandidate::NoteDeductionFailure(Sema &S,
10611                                                  bool ForTakingAddress) {
10612   DiagnoseBadDeduction(S, FoundDecl, Specialization, // pattern
10613                        DeductionFailure, /*NumArgs=*/0, ForTakingAddress);
10614 }
10615 
10616 void TemplateSpecCandidateSet::destroyCandidates() {
10617   for (iterator i = begin(), e = end(); i != e; ++i) {
10618     i->DeductionFailure.Destroy();
10619   }
10620 }
10621 
10622 void TemplateSpecCandidateSet::clear() {
10623   destroyCandidates();
10624   Candidates.clear();
10625 }
10626 
10627 /// NoteCandidates - When no template specialization match is found, prints
10628 /// diagnostic messages containing the non-matching specializations that form
10629 /// the candidate set.
10630 /// This is analoguous to OverloadCandidateSet::NoteCandidates() with
10631 /// OCD == OCD_AllCandidates and Cand->Viable == false.
10632 void TemplateSpecCandidateSet::NoteCandidates(Sema &S, SourceLocation Loc) {
10633   // Sort the candidates by position (assuming no candidate is a match).
10634   // Sorting directly would be prohibitive, so we make a set of pointers
10635   // and sort those.
10636   SmallVector<TemplateSpecCandidate *, 32> Cands;
10637   Cands.reserve(size());
10638   for (iterator Cand = begin(), LastCand = end(); Cand != LastCand; ++Cand) {
10639     if (Cand->Specialization)
10640       Cands.push_back(Cand);
10641     // Otherwise, this is a non-matching builtin candidate.  We do not,
10642     // in general, want to list every possible builtin candidate.
10643   }
10644 
10645   std::sort(Cands.begin(), Cands.end(),
10646             CompareTemplateSpecCandidatesForDisplay(S));
10647 
10648   // FIXME: Perhaps rename OverloadsShown and getShowOverloads()
10649   // for generalization purposes (?).
10650   const OverloadsShown ShowOverloads = S.Diags.getShowOverloads();
10651 
10652   SmallVectorImpl<TemplateSpecCandidate *>::iterator I, E;
10653   unsigned CandsShown = 0;
10654   for (I = Cands.begin(), E = Cands.end(); I != E; ++I) {
10655     TemplateSpecCandidate *Cand = *I;
10656 
10657     // Set an arbitrary limit on the number of candidates we'll spam
10658     // the user with.  FIXME: This limit should depend on details of the
10659     // candidate list.
10660     if (CandsShown >= 4 && ShowOverloads == Ovl_Best)
10661       break;
10662     ++CandsShown;
10663 
10664     assert(Cand->Specialization &&
10665            "Non-matching built-in candidates are not added to Cands.");
10666     Cand->NoteDeductionFailure(S, ForTakingAddress);
10667   }
10668 
10669   if (I != E)
10670     S.Diag(Loc, diag::note_ovl_too_many_candidates) << int(E - I);
10671 }
10672 
10673 // [PossiblyAFunctionType]  -->   [Return]
10674 // NonFunctionType --> NonFunctionType
10675 // R (A) --> R(A)
10676 // R (*)(A) --> R (A)
10677 // R (&)(A) --> R (A)
10678 // R (S::*)(A) --> R (A)
10679 QualType Sema::ExtractUnqualifiedFunctionType(QualType PossiblyAFunctionType) {
10680   QualType Ret = PossiblyAFunctionType;
10681   if (const PointerType *ToTypePtr =
10682     PossiblyAFunctionType->getAs<PointerType>())
10683     Ret = ToTypePtr->getPointeeType();
10684   else if (const ReferenceType *ToTypeRef =
10685     PossiblyAFunctionType->getAs<ReferenceType>())
10686     Ret = ToTypeRef->getPointeeType();
10687   else if (const MemberPointerType *MemTypePtr =
10688     PossiblyAFunctionType->getAs<MemberPointerType>())
10689     Ret = MemTypePtr->getPointeeType();
10690   Ret =
10691     Context.getCanonicalType(Ret).getUnqualifiedType();
10692   return Ret;
10693 }
10694 
10695 static bool completeFunctionType(Sema &S, FunctionDecl *FD, SourceLocation Loc,
10696                                  bool Complain = true) {
10697   if (S.getLangOpts().CPlusPlus14 && FD->getReturnType()->isUndeducedType() &&
10698       S.DeduceReturnType(FD, Loc, Complain))
10699     return true;
10700 
10701   auto *FPT = FD->getType()->castAs<FunctionProtoType>();
10702   if (S.getLangOpts().CPlusPlus17 &&
10703       isUnresolvedExceptionSpec(FPT->getExceptionSpecType()) &&
10704       !S.ResolveExceptionSpec(Loc, FPT))
10705     return true;
10706 
10707   return false;
10708 }
10709 
10710 namespace {
10711 // A helper class to help with address of function resolution
10712 // - allows us to avoid passing around all those ugly parameters
10713 class AddressOfFunctionResolver {
10714   Sema& S;
10715   Expr* SourceExpr;
10716   const QualType& TargetType;
10717   QualType TargetFunctionType; // Extracted function type from target type
10718 
10719   bool Complain;
10720   //DeclAccessPair& ResultFunctionAccessPair;
10721   ASTContext& Context;
10722 
10723   bool TargetTypeIsNonStaticMemberFunction;
10724   bool FoundNonTemplateFunction;
10725   bool StaticMemberFunctionFromBoundPointer;
10726   bool HasComplained;
10727 
10728   OverloadExpr::FindResult OvlExprInfo;
10729   OverloadExpr *OvlExpr;
10730   TemplateArgumentListInfo OvlExplicitTemplateArgs;
10731   SmallVector<std::pair<DeclAccessPair, FunctionDecl*>, 4> Matches;
10732   TemplateSpecCandidateSet FailedCandidates;
10733 
10734 public:
10735   AddressOfFunctionResolver(Sema &S, Expr *SourceExpr,
10736                             const QualType &TargetType, bool Complain)
10737       : S(S), SourceExpr(SourceExpr), TargetType(TargetType),
10738         Complain(Complain), Context(S.getASTContext()),
10739         TargetTypeIsNonStaticMemberFunction(
10740             !!TargetType->getAs<MemberPointerType>()),
10741         FoundNonTemplateFunction(false),
10742         StaticMemberFunctionFromBoundPointer(false),
10743         HasComplained(false),
10744         OvlExprInfo(OverloadExpr::find(SourceExpr)),
10745         OvlExpr(OvlExprInfo.Expression),
10746         FailedCandidates(OvlExpr->getNameLoc(), /*ForTakingAddress=*/true) {
10747     ExtractUnqualifiedFunctionTypeFromTargetType();
10748 
10749     if (TargetFunctionType->isFunctionType()) {
10750       if (UnresolvedMemberExpr *UME = dyn_cast<UnresolvedMemberExpr>(OvlExpr))
10751         if (!UME->isImplicitAccess() &&
10752             !S.ResolveSingleFunctionTemplateSpecialization(UME))
10753           StaticMemberFunctionFromBoundPointer = true;
10754     } else if (OvlExpr->hasExplicitTemplateArgs()) {
10755       DeclAccessPair dap;
10756       if (FunctionDecl *Fn = S.ResolveSingleFunctionTemplateSpecialization(
10757               OvlExpr, false, &dap)) {
10758         if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn))
10759           if (!Method->isStatic()) {
10760             // If the target type is a non-function type and the function found
10761             // is a non-static member function, pretend as if that was the
10762             // target, it's the only possible type to end up with.
10763             TargetTypeIsNonStaticMemberFunction = true;
10764 
10765             // And skip adding the function if its not in the proper form.
10766             // We'll diagnose this due to an empty set of functions.
10767             if (!OvlExprInfo.HasFormOfMemberPointer)
10768               return;
10769           }
10770 
10771         Matches.push_back(std::make_pair(dap, Fn));
10772       }
10773       return;
10774     }
10775 
10776     if (OvlExpr->hasExplicitTemplateArgs())
10777       OvlExpr->copyTemplateArgumentsInto(OvlExplicitTemplateArgs);
10778 
10779     if (FindAllFunctionsThatMatchTargetTypeExactly()) {
10780       // C++ [over.over]p4:
10781       //   If more than one function is selected, [...]
10782       if (Matches.size() > 1 && !eliminiateSuboptimalOverloadCandidates()) {
10783         if (FoundNonTemplateFunction)
10784           EliminateAllTemplateMatches();
10785         else
10786           EliminateAllExceptMostSpecializedTemplate();
10787       }
10788     }
10789 
10790     if (S.getLangOpts().CUDA && Matches.size() > 1)
10791       EliminateSuboptimalCudaMatches();
10792   }
10793 
10794   bool hasComplained() const { return HasComplained; }
10795 
10796 private:
10797   bool candidateHasExactlyCorrectType(const FunctionDecl *FD) {
10798     QualType Discard;
10799     return Context.hasSameUnqualifiedType(TargetFunctionType, FD->getType()) ||
10800            S.IsFunctionConversion(FD->getType(), TargetFunctionType, Discard);
10801   }
10802 
10803   /// \return true if A is considered a better overload candidate for the
10804   /// desired type than B.
10805   bool isBetterCandidate(const FunctionDecl *A, const FunctionDecl *B) {
10806     // If A doesn't have exactly the correct type, we don't want to classify it
10807     // as "better" than anything else. This way, the user is required to
10808     // disambiguate for us if there are multiple candidates and no exact match.
10809     return candidateHasExactlyCorrectType(A) &&
10810            (!candidateHasExactlyCorrectType(B) ||
10811             compareEnableIfAttrs(S, A, B) == Comparison::Better);
10812   }
10813 
10814   /// \return true if we were able to eliminate all but one overload candidate,
10815   /// false otherwise.
10816   bool eliminiateSuboptimalOverloadCandidates() {
10817     // Same algorithm as overload resolution -- one pass to pick the "best",
10818     // another pass to be sure that nothing is better than the best.
10819     auto Best = Matches.begin();
10820     for (auto I = Matches.begin()+1, E = Matches.end(); I != E; ++I)
10821       if (isBetterCandidate(I->second, Best->second))
10822         Best = I;
10823 
10824     const FunctionDecl *BestFn = Best->second;
10825     auto IsBestOrInferiorToBest = [this, BestFn](
10826         const std::pair<DeclAccessPair, FunctionDecl *> &Pair) {
10827       return BestFn == Pair.second || isBetterCandidate(BestFn, Pair.second);
10828     };
10829 
10830     // Note: We explicitly leave Matches unmodified if there isn't a clear best
10831     // option, so we can potentially give the user a better error
10832     if (!std::all_of(Matches.begin(), Matches.end(), IsBestOrInferiorToBest))
10833       return false;
10834     Matches[0] = *Best;
10835     Matches.resize(1);
10836     return true;
10837   }
10838 
10839   bool isTargetTypeAFunction() const {
10840     return TargetFunctionType->isFunctionType();
10841   }
10842 
10843   // [ToType]     [Return]
10844 
10845   // R (*)(A) --> R (A), IsNonStaticMemberFunction = false
10846   // R (&)(A) --> R (A), IsNonStaticMemberFunction = false
10847   // R (S::*)(A) --> R (A), IsNonStaticMemberFunction = true
10848   void inline ExtractUnqualifiedFunctionTypeFromTargetType() {
10849     TargetFunctionType = S.ExtractUnqualifiedFunctionType(TargetType);
10850   }
10851 
10852   // return true if any matching specializations were found
10853   bool AddMatchingTemplateFunction(FunctionTemplateDecl* FunctionTemplate,
10854                                    const DeclAccessPair& CurAccessFunPair) {
10855     if (CXXMethodDecl *Method
10856               = dyn_cast<CXXMethodDecl>(FunctionTemplate->getTemplatedDecl())) {
10857       // Skip non-static function templates when converting to pointer, and
10858       // static when converting to member pointer.
10859       if (Method->isStatic() == TargetTypeIsNonStaticMemberFunction)
10860         return false;
10861     }
10862     else if (TargetTypeIsNonStaticMemberFunction)
10863       return false;
10864 
10865     // C++ [over.over]p2:
10866     //   If the name is a function template, template argument deduction is
10867     //   done (14.8.2.2), and if the argument deduction succeeds, the
10868     //   resulting template argument list is used to generate a single
10869     //   function template specialization, which is added to the set of
10870     //   overloaded functions considered.
10871     FunctionDecl *Specialization = nullptr;
10872     TemplateDeductionInfo Info(FailedCandidates.getLocation());
10873     if (Sema::TemplateDeductionResult Result
10874           = S.DeduceTemplateArguments(FunctionTemplate,
10875                                       &OvlExplicitTemplateArgs,
10876                                       TargetFunctionType, Specialization,
10877                                       Info, /*IsAddressOfFunction*/true)) {
10878       // Make a note of the failed deduction for diagnostics.
10879       FailedCandidates.addCandidate()
10880           .set(CurAccessFunPair, FunctionTemplate->getTemplatedDecl(),
10881                MakeDeductionFailureInfo(Context, Result, Info));
10882       return false;
10883     }
10884 
10885     // Template argument deduction ensures that we have an exact match or
10886     // compatible pointer-to-function arguments that would be adjusted by ICS.
10887     // This function template specicalization works.
10888     assert(S.isSameOrCompatibleFunctionType(
10889               Context.getCanonicalType(Specialization->getType()),
10890               Context.getCanonicalType(TargetFunctionType)));
10891 
10892     if (!S.checkAddressOfFunctionIsAvailable(Specialization))
10893       return false;
10894 
10895     Matches.push_back(std::make_pair(CurAccessFunPair, Specialization));
10896     return true;
10897   }
10898 
10899   bool AddMatchingNonTemplateFunction(NamedDecl* Fn,
10900                                       const DeclAccessPair& CurAccessFunPair) {
10901     if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn)) {
10902       // Skip non-static functions when converting to pointer, and static
10903       // when converting to member pointer.
10904       if (Method->isStatic() == TargetTypeIsNonStaticMemberFunction)
10905         return false;
10906     }
10907     else if (TargetTypeIsNonStaticMemberFunction)
10908       return false;
10909 
10910     if (FunctionDecl *FunDecl = dyn_cast<FunctionDecl>(Fn)) {
10911       if (S.getLangOpts().CUDA)
10912         if (FunctionDecl *Caller = dyn_cast<FunctionDecl>(S.CurContext))
10913           if (!Caller->isImplicit() && !S.IsAllowedCUDACall(Caller, FunDecl))
10914             return false;
10915 
10916       // If any candidate has a placeholder return type, trigger its deduction
10917       // now.
10918       if (completeFunctionType(S, FunDecl, SourceExpr->getLocStart(),
10919                                Complain)) {
10920         HasComplained |= Complain;
10921         return false;
10922       }
10923 
10924       if (!S.checkAddressOfFunctionIsAvailable(FunDecl))
10925         return false;
10926 
10927       // If we're in C, we need to support types that aren't exactly identical.
10928       if (!S.getLangOpts().CPlusPlus ||
10929           candidateHasExactlyCorrectType(FunDecl)) {
10930         Matches.push_back(std::make_pair(
10931             CurAccessFunPair, cast<FunctionDecl>(FunDecl->getCanonicalDecl())));
10932         FoundNonTemplateFunction = true;
10933         return true;
10934       }
10935     }
10936 
10937     return false;
10938   }
10939 
10940   bool FindAllFunctionsThatMatchTargetTypeExactly() {
10941     bool Ret = false;
10942 
10943     // If the overload expression doesn't have the form of a pointer to
10944     // member, don't try to convert it to a pointer-to-member type.
10945     if (IsInvalidFormOfPointerToMemberFunction())
10946       return false;
10947 
10948     for (UnresolvedSetIterator I = OvlExpr->decls_begin(),
10949                                E = OvlExpr->decls_end();
10950          I != E; ++I) {
10951       // Look through any using declarations to find the underlying function.
10952       NamedDecl *Fn = (*I)->getUnderlyingDecl();
10953 
10954       // C++ [over.over]p3:
10955       //   Non-member functions and static member functions match
10956       //   targets of type "pointer-to-function" or "reference-to-function."
10957       //   Nonstatic member functions match targets of
10958       //   type "pointer-to-member-function."
10959       // Note that according to DR 247, the containing class does not matter.
10960       if (FunctionTemplateDecl *FunctionTemplate
10961                                         = dyn_cast<FunctionTemplateDecl>(Fn)) {
10962         if (AddMatchingTemplateFunction(FunctionTemplate, I.getPair()))
10963           Ret = true;
10964       }
10965       // If we have explicit template arguments supplied, skip non-templates.
10966       else if (!OvlExpr->hasExplicitTemplateArgs() &&
10967                AddMatchingNonTemplateFunction(Fn, I.getPair()))
10968         Ret = true;
10969     }
10970     assert(Ret || Matches.empty());
10971     return Ret;
10972   }
10973 
10974   void EliminateAllExceptMostSpecializedTemplate() {
10975     //   [...] and any given function template specialization F1 is
10976     //   eliminated if the set contains a second function template
10977     //   specialization whose function template is more specialized
10978     //   than the function template of F1 according to the partial
10979     //   ordering rules of 14.5.5.2.
10980 
10981     // The algorithm specified above is quadratic. We instead use a
10982     // two-pass algorithm (similar to the one used to identify the
10983     // best viable function in an overload set) that identifies the
10984     // best function template (if it exists).
10985 
10986     UnresolvedSet<4> MatchesCopy; // TODO: avoid!
10987     for (unsigned I = 0, E = Matches.size(); I != E; ++I)
10988       MatchesCopy.addDecl(Matches[I].second, Matches[I].first.getAccess());
10989 
10990     // TODO: It looks like FailedCandidates does not serve much purpose
10991     // here, since the no_viable diagnostic has index 0.
10992     UnresolvedSetIterator Result = S.getMostSpecialized(
10993         MatchesCopy.begin(), MatchesCopy.end(), FailedCandidates,
10994         SourceExpr->getLocStart(), S.PDiag(),
10995         S.PDiag(diag::err_addr_ovl_ambiguous)
10996           << Matches[0].second->getDeclName(),
10997         S.PDiag(diag::note_ovl_candidate)
10998           << (unsigned)oc_function_template,
10999         Complain, TargetFunctionType);
11000 
11001     if (Result != MatchesCopy.end()) {
11002       // Make it the first and only element
11003       Matches[0].first = Matches[Result - MatchesCopy.begin()].first;
11004       Matches[0].second = cast<FunctionDecl>(*Result);
11005       Matches.resize(1);
11006     } else
11007       HasComplained |= Complain;
11008   }
11009 
11010   void EliminateAllTemplateMatches() {
11011     //   [...] any function template specializations in the set are
11012     //   eliminated if the set also contains a non-template function, [...]
11013     for (unsigned I = 0, N = Matches.size(); I != N; ) {
11014       if (Matches[I].second->getPrimaryTemplate() == nullptr)
11015         ++I;
11016       else {
11017         Matches[I] = Matches[--N];
11018         Matches.resize(N);
11019       }
11020     }
11021   }
11022 
11023   void EliminateSuboptimalCudaMatches() {
11024     S.EraseUnwantedCUDAMatches(dyn_cast<FunctionDecl>(S.CurContext), Matches);
11025   }
11026 
11027 public:
11028   void ComplainNoMatchesFound() const {
11029     assert(Matches.empty());
11030     S.Diag(OvlExpr->getLocStart(), diag::err_addr_ovl_no_viable)
11031         << OvlExpr->getName() << TargetFunctionType
11032         << OvlExpr->getSourceRange();
11033     if (FailedCandidates.empty())
11034       S.NoteAllOverloadCandidates(OvlExpr, TargetFunctionType,
11035                                   /*TakingAddress=*/true);
11036     else {
11037       // We have some deduction failure messages. Use them to diagnose
11038       // the function templates, and diagnose the non-template candidates
11039       // normally.
11040       for (UnresolvedSetIterator I = OvlExpr->decls_begin(),
11041                                  IEnd = OvlExpr->decls_end();
11042            I != IEnd; ++I)
11043         if (FunctionDecl *Fun =
11044                 dyn_cast<FunctionDecl>((*I)->getUnderlyingDecl()))
11045           if (!functionHasPassObjectSizeParams(Fun))
11046             S.NoteOverloadCandidate(*I, Fun, TargetFunctionType,
11047                                     /*TakingAddress=*/true);
11048       FailedCandidates.NoteCandidates(S, OvlExpr->getLocStart());
11049     }
11050   }
11051 
11052   bool IsInvalidFormOfPointerToMemberFunction() const {
11053     return TargetTypeIsNonStaticMemberFunction &&
11054       !OvlExprInfo.HasFormOfMemberPointer;
11055   }
11056 
11057   void ComplainIsInvalidFormOfPointerToMemberFunction() const {
11058       // TODO: Should we condition this on whether any functions might
11059       // have matched, or is it more appropriate to do that in callers?
11060       // TODO: a fixit wouldn't hurt.
11061       S.Diag(OvlExpr->getNameLoc(), diag::err_addr_ovl_no_qualifier)
11062         << TargetType << OvlExpr->getSourceRange();
11063   }
11064 
11065   bool IsStaticMemberFunctionFromBoundPointer() const {
11066     return StaticMemberFunctionFromBoundPointer;
11067   }
11068 
11069   void ComplainIsStaticMemberFunctionFromBoundPointer() const {
11070     S.Diag(OvlExpr->getLocStart(),
11071            diag::err_invalid_form_pointer_member_function)
11072       << OvlExpr->getSourceRange();
11073   }
11074 
11075   void ComplainOfInvalidConversion() const {
11076     S.Diag(OvlExpr->getLocStart(), diag::err_addr_ovl_not_func_ptrref)
11077       << OvlExpr->getName() << TargetType;
11078   }
11079 
11080   void ComplainMultipleMatchesFound() const {
11081     assert(Matches.size() > 1);
11082     S.Diag(OvlExpr->getLocStart(), diag::err_addr_ovl_ambiguous)
11083       << OvlExpr->getName()
11084       << OvlExpr->getSourceRange();
11085     S.NoteAllOverloadCandidates(OvlExpr, TargetFunctionType,
11086                                 /*TakingAddress=*/true);
11087   }
11088 
11089   bool hadMultipleCandidates() const { return (OvlExpr->getNumDecls() > 1); }
11090 
11091   int getNumMatches() const { return Matches.size(); }
11092 
11093   FunctionDecl* getMatchingFunctionDecl() const {
11094     if (Matches.size() != 1) return nullptr;
11095     return Matches[0].second;
11096   }
11097 
11098   const DeclAccessPair* getMatchingFunctionAccessPair() const {
11099     if (Matches.size() != 1) return nullptr;
11100     return &Matches[0].first;
11101   }
11102 };
11103 }
11104 
11105 /// ResolveAddressOfOverloadedFunction - Try to resolve the address of
11106 /// an overloaded function (C++ [over.over]), where @p From is an
11107 /// expression with overloaded function type and @p ToType is the type
11108 /// we're trying to resolve to. For example:
11109 ///
11110 /// @code
11111 /// int f(double);
11112 /// int f(int);
11113 ///
11114 /// int (*pfd)(double) = f; // selects f(double)
11115 /// @endcode
11116 ///
11117 /// This routine returns the resulting FunctionDecl if it could be
11118 /// resolved, and NULL otherwise. When @p Complain is true, this
11119 /// routine will emit diagnostics if there is an error.
11120 FunctionDecl *
11121 Sema::ResolveAddressOfOverloadedFunction(Expr *AddressOfExpr,
11122                                          QualType TargetType,
11123                                          bool Complain,
11124                                          DeclAccessPair &FoundResult,
11125                                          bool *pHadMultipleCandidates) {
11126   assert(AddressOfExpr->getType() == Context.OverloadTy);
11127 
11128   AddressOfFunctionResolver Resolver(*this, AddressOfExpr, TargetType,
11129                                      Complain);
11130   int NumMatches = Resolver.getNumMatches();
11131   FunctionDecl *Fn = nullptr;
11132   bool ShouldComplain = Complain && !Resolver.hasComplained();
11133   if (NumMatches == 0 && ShouldComplain) {
11134     if (Resolver.IsInvalidFormOfPointerToMemberFunction())
11135       Resolver.ComplainIsInvalidFormOfPointerToMemberFunction();
11136     else
11137       Resolver.ComplainNoMatchesFound();
11138   }
11139   else if (NumMatches > 1 && ShouldComplain)
11140     Resolver.ComplainMultipleMatchesFound();
11141   else if (NumMatches == 1) {
11142     Fn = Resolver.getMatchingFunctionDecl();
11143     assert(Fn);
11144     if (auto *FPT = Fn->getType()->getAs<FunctionProtoType>())
11145       ResolveExceptionSpec(AddressOfExpr->getExprLoc(), FPT);
11146     FoundResult = *Resolver.getMatchingFunctionAccessPair();
11147     if (Complain) {
11148       if (Resolver.IsStaticMemberFunctionFromBoundPointer())
11149         Resolver.ComplainIsStaticMemberFunctionFromBoundPointer();
11150       else
11151         CheckAddressOfMemberAccess(AddressOfExpr, FoundResult);
11152     }
11153   }
11154 
11155   if (pHadMultipleCandidates)
11156     *pHadMultipleCandidates = Resolver.hadMultipleCandidates();
11157   return Fn;
11158 }
11159 
11160 /// \brief Given an expression that refers to an overloaded function, try to
11161 /// resolve that function to a single function that can have its address taken.
11162 /// This will modify `Pair` iff it returns non-null.
11163 ///
11164 /// This routine can only realistically succeed if all but one candidates in the
11165 /// overload set for SrcExpr cannot have their addresses taken.
11166 FunctionDecl *
11167 Sema::resolveAddressOfOnlyViableOverloadCandidate(Expr *E,
11168                                                   DeclAccessPair &Pair) {
11169   OverloadExpr::FindResult R = OverloadExpr::find(E);
11170   OverloadExpr *Ovl = R.Expression;
11171   FunctionDecl *Result = nullptr;
11172   DeclAccessPair DAP;
11173   // Don't use the AddressOfResolver because we're specifically looking for
11174   // cases where we have one overload candidate that lacks
11175   // enable_if/pass_object_size/...
11176   for (auto I = Ovl->decls_begin(), E = Ovl->decls_end(); I != E; ++I) {
11177     auto *FD = dyn_cast<FunctionDecl>(I->getUnderlyingDecl());
11178     if (!FD)
11179       return nullptr;
11180 
11181     if (!checkAddressOfFunctionIsAvailable(FD))
11182       continue;
11183 
11184     // We have more than one result; quit.
11185     if (Result)
11186       return nullptr;
11187     DAP = I.getPair();
11188     Result = FD;
11189   }
11190 
11191   if (Result)
11192     Pair = DAP;
11193   return Result;
11194 }
11195 
11196 /// \brief Given an overloaded function, tries to turn it into a non-overloaded
11197 /// function reference using resolveAddressOfOnlyViableOverloadCandidate. This
11198 /// will perform access checks, diagnose the use of the resultant decl, and, if
11199 /// requested, potentially perform a function-to-pointer decay.
11200 ///
11201 /// Returns false if resolveAddressOfOnlyViableOverloadCandidate fails.
11202 /// Otherwise, returns true. This may emit diagnostics and return true.
11203 bool Sema::resolveAndFixAddressOfOnlyViableOverloadCandidate(
11204     ExprResult &SrcExpr, bool DoFunctionPointerConverion) {
11205   Expr *E = SrcExpr.get();
11206   assert(E->getType() == Context.OverloadTy && "SrcExpr must be an overload");
11207 
11208   DeclAccessPair DAP;
11209   FunctionDecl *Found = resolveAddressOfOnlyViableOverloadCandidate(E, DAP);
11210   if (!Found)
11211     return false;
11212 
11213   // Emitting multiple diagnostics for a function that is both inaccessible and
11214   // unavailable is consistent with our behavior elsewhere. So, always check
11215   // for both.
11216   DiagnoseUseOfDecl(Found, E->getExprLoc());
11217   CheckAddressOfMemberAccess(E, DAP);
11218   Expr *Fixed = FixOverloadedFunctionReference(E, DAP, Found);
11219   if (DoFunctionPointerConverion && Fixed->getType()->isFunctionType())
11220     SrcExpr = DefaultFunctionArrayConversion(Fixed, /*Diagnose=*/false);
11221   else
11222     SrcExpr = Fixed;
11223   return true;
11224 }
11225 
11226 /// \brief Given an expression that refers to an overloaded function, try to
11227 /// resolve that overloaded function expression down to a single function.
11228 ///
11229 /// This routine can only resolve template-ids that refer to a single function
11230 /// template, where that template-id refers to a single template whose template
11231 /// arguments are either provided by the template-id or have defaults,
11232 /// as described in C++0x [temp.arg.explicit]p3.
11233 ///
11234 /// If no template-ids are found, no diagnostics are emitted and NULL is
11235 /// returned.
11236 FunctionDecl *
11237 Sema::ResolveSingleFunctionTemplateSpecialization(OverloadExpr *ovl,
11238                                                   bool Complain,
11239                                                   DeclAccessPair *FoundResult) {
11240   // C++ [over.over]p1:
11241   //   [...] [Note: any redundant set of parentheses surrounding the
11242   //   overloaded function name is ignored (5.1). ]
11243   // C++ [over.over]p1:
11244   //   [...] The overloaded function name can be preceded by the &
11245   //   operator.
11246 
11247   // If we didn't actually find any template-ids, we're done.
11248   if (!ovl->hasExplicitTemplateArgs())
11249     return nullptr;
11250 
11251   TemplateArgumentListInfo ExplicitTemplateArgs;
11252   ovl->copyTemplateArgumentsInto(ExplicitTemplateArgs);
11253   TemplateSpecCandidateSet FailedCandidates(ovl->getNameLoc());
11254 
11255   // Look through all of the overloaded functions, searching for one
11256   // whose type matches exactly.
11257   FunctionDecl *Matched = nullptr;
11258   for (UnresolvedSetIterator I = ovl->decls_begin(),
11259          E = ovl->decls_end(); I != E; ++I) {
11260     // C++0x [temp.arg.explicit]p3:
11261     //   [...] In contexts where deduction is done and fails, or in contexts
11262     //   where deduction is not done, if a template argument list is
11263     //   specified and it, along with any default template arguments,
11264     //   identifies a single function template specialization, then the
11265     //   template-id is an lvalue for the function template specialization.
11266     FunctionTemplateDecl *FunctionTemplate
11267       = cast<FunctionTemplateDecl>((*I)->getUnderlyingDecl());
11268 
11269     // C++ [over.over]p2:
11270     //   If the name is a function template, template argument deduction is
11271     //   done (14.8.2.2), and if the argument deduction succeeds, the
11272     //   resulting template argument list is used to generate a single
11273     //   function template specialization, which is added to the set of
11274     //   overloaded functions considered.
11275     FunctionDecl *Specialization = nullptr;
11276     TemplateDeductionInfo Info(FailedCandidates.getLocation());
11277     if (TemplateDeductionResult Result
11278           = DeduceTemplateArguments(FunctionTemplate, &ExplicitTemplateArgs,
11279                                     Specialization, Info,
11280                                     /*IsAddressOfFunction*/true)) {
11281       // Make a note of the failed deduction for diagnostics.
11282       // TODO: Actually use the failed-deduction info?
11283       FailedCandidates.addCandidate()
11284           .set(I.getPair(), FunctionTemplate->getTemplatedDecl(),
11285                MakeDeductionFailureInfo(Context, Result, Info));
11286       continue;
11287     }
11288 
11289     assert(Specialization && "no specialization and no error?");
11290 
11291     // Multiple matches; we can't resolve to a single declaration.
11292     if (Matched) {
11293       if (Complain) {
11294         Diag(ovl->getExprLoc(), diag::err_addr_ovl_ambiguous)
11295           << ovl->getName();
11296         NoteAllOverloadCandidates(ovl);
11297       }
11298       return nullptr;
11299     }
11300 
11301     Matched = Specialization;
11302     if (FoundResult) *FoundResult = I.getPair();
11303   }
11304 
11305   if (Matched &&
11306       completeFunctionType(*this, Matched, ovl->getExprLoc(), Complain))
11307     return nullptr;
11308 
11309   return Matched;
11310 }
11311 
11312 
11313 
11314 
11315 // Resolve and fix an overloaded expression that can be resolved
11316 // because it identifies a single function template specialization.
11317 //
11318 // Last three arguments should only be supplied if Complain = true
11319 //
11320 // Return true if it was logically possible to so resolve the
11321 // expression, regardless of whether or not it succeeded.  Always
11322 // returns true if 'complain' is set.
11323 bool Sema::ResolveAndFixSingleFunctionTemplateSpecialization(
11324                       ExprResult &SrcExpr, bool doFunctionPointerConverion,
11325                       bool complain, SourceRange OpRangeForComplaining,
11326                                            QualType DestTypeForComplaining,
11327                                             unsigned DiagIDForComplaining) {
11328   assert(SrcExpr.get()->getType() == Context.OverloadTy);
11329 
11330   OverloadExpr::FindResult ovl = OverloadExpr::find(SrcExpr.get());
11331 
11332   DeclAccessPair found;
11333   ExprResult SingleFunctionExpression;
11334   if (FunctionDecl *fn = ResolveSingleFunctionTemplateSpecialization(
11335                            ovl.Expression, /*complain*/ false, &found)) {
11336     if (DiagnoseUseOfDecl(fn, SrcExpr.get()->getLocStart())) {
11337       SrcExpr = ExprError();
11338       return true;
11339     }
11340 
11341     // It is only correct to resolve to an instance method if we're
11342     // resolving a form that's permitted to be a pointer to member.
11343     // Otherwise we'll end up making a bound member expression, which
11344     // is illegal in all the contexts we resolve like this.
11345     if (!ovl.HasFormOfMemberPointer &&
11346         isa<CXXMethodDecl>(fn) &&
11347         cast<CXXMethodDecl>(fn)->isInstance()) {
11348       if (!complain) return false;
11349 
11350       Diag(ovl.Expression->getExprLoc(),
11351            diag::err_bound_member_function)
11352         << 0 << ovl.Expression->getSourceRange();
11353 
11354       // TODO: I believe we only end up here if there's a mix of
11355       // static and non-static candidates (otherwise the expression
11356       // would have 'bound member' type, not 'overload' type).
11357       // Ideally we would note which candidate was chosen and why
11358       // the static candidates were rejected.
11359       SrcExpr = ExprError();
11360       return true;
11361     }
11362 
11363     // Fix the expression to refer to 'fn'.
11364     SingleFunctionExpression =
11365         FixOverloadedFunctionReference(SrcExpr.get(), found, fn);
11366 
11367     // If desired, do function-to-pointer decay.
11368     if (doFunctionPointerConverion) {
11369       SingleFunctionExpression =
11370         DefaultFunctionArrayLvalueConversion(SingleFunctionExpression.get());
11371       if (SingleFunctionExpression.isInvalid()) {
11372         SrcExpr = ExprError();
11373         return true;
11374       }
11375     }
11376   }
11377 
11378   if (!SingleFunctionExpression.isUsable()) {
11379     if (complain) {
11380       Diag(OpRangeForComplaining.getBegin(), DiagIDForComplaining)
11381         << ovl.Expression->getName()
11382         << DestTypeForComplaining
11383         << OpRangeForComplaining
11384         << ovl.Expression->getQualifierLoc().getSourceRange();
11385       NoteAllOverloadCandidates(SrcExpr.get());
11386 
11387       SrcExpr = ExprError();
11388       return true;
11389     }
11390 
11391     return false;
11392   }
11393 
11394   SrcExpr = SingleFunctionExpression;
11395   return true;
11396 }
11397 
11398 /// \brief Add a single candidate to the overload set.
11399 static void AddOverloadedCallCandidate(Sema &S,
11400                                        DeclAccessPair FoundDecl,
11401                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
11402                                        ArrayRef<Expr *> Args,
11403                                        OverloadCandidateSet &CandidateSet,
11404                                        bool PartialOverloading,
11405                                        bool KnownValid) {
11406   NamedDecl *Callee = FoundDecl.getDecl();
11407   if (isa<UsingShadowDecl>(Callee))
11408     Callee = cast<UsingShadowDecl>(Callee)->getTargetDecl();
11409 
11410   if (FunctionDecl *Func = dyn_cast<FunctionDecl>(Callee)) {
11411     if (ExplicitTemplateArgs) {
11412       assert(!KnownValid && "Explicit template arguments?");
11413       return;
11414     }
11415     // Prevent ill-formed function decls to be added as overload candidates.
11416     if (!dyn_cast<FunctionProtoType>(Func->getType()->getAs<FunctionType>()))
11417       return;
11418 
11419     S.AddOverloadCandidate(Func, FoundDecl, Args, CandidateSet,
11420                            /*SuppressUsedConversions=*/false,
11421                            PartialOverloading);
11422     return;
11423   }
11424 
11425   if (FunctionTemplateDecl *FuncTemplate
11426       = dyn_cast<FunctionTemplateDecl>(Callee)) {
11427     S.AddTemplateOverloadCandidate(FuncTemplate, FoundDecl,
11428                                    ExplicitTemplateArgs, Args, CandidateSet,
11429                                    /*SuppressUsedConversions=*/false,
11430                                    PartialOverloading);
11431     return;
11432   }
11433 
11434   assert(!KnownValid && "unhandled case in overloaded call candidate");
11435 }
11436 
11437 /// \brief Add the overload candidates named by callee and/or found by argument
11438 /// dependent lookup to the given overload set.
11439 void Sema::AddOverloadedCallCandidates(UnresolvedLookupExpr *ULE,
11440                                        ArrayRef<Expr *> Args,
11441                                        OverloadCandidateSet &CandidateSet,
11442                                        bool PartialOverloading) {
11443 
11444 #ifndef NDEBUG
11445   // Verify that ArgumentDependentLookup is consistent with the rules
11446   // in C++0x [basic.lookup.argdep]p3:
11447   //
11448   //   Let X be the lookup set produced by unqualified lookup (3.4.1)
11449   //   and let Y be the lookup set produced by argument dependent
11450   //   lookup (defined as follows). If X contains
11451   //
11452   //     -- a declaration of a class member, or
11453   //
11454   //     -- a block-scope function declaration that is not a
11455   //        using-declaration, or
11456   //
11457   //     -- a declaration that is neither a function or a function
11458   //        template
11459   //
11460   //   then Y is empty.
11461 
11462   if (ULE->requiresADL()) {
11463     for (UnresolvedLookupExpr::decls_iterator I = ULE->decls_begin(),
11464            E = ULE->decls_end(); I != E; ++I) {
11465       assert(!(*I)->getDeclContext()->isRecord());
11466       assert(isa<UsingShadowDecl>(*I) ||
11467              !(*I)->getDeclContext()->isFunctionOrMethod());
11468       assert((*I)->getUnderlyingDecl()->isFunctionOrFunctionTemplate());
11469     }
11470   }
11471 #endif
11472 
11473   // It would be nice to avoid this copy.
11474   TemplateArgumentListInfo TABuffer;
11475   TemplateArgumentListInfo *ExplicitTemplateArgs = nullptr;
11476   if (ULE->hasExplicitTemplateArgs()) {
11477     ULE->copyTemplateArgumentsInto(TABuffer);
11478     ExplicitTemplateArgs = &TABuffer;
11479   }
11480 
11481   for (UnresolvedLookupExpr::decls_iterator I = ULE->decls_begin(),
11482          E = ULE->decls_end(); I != E; ++I)
11483     AddOverloadedCallCandidate(*this, I.getPair(), ExplicitTemplateArgs, Args,
11484                                CandidateSet, PartialOverloading,
11485                                /*KnownValid*/ true);
11486 
11487   if (ULE->requiresADL())
11488     AddArgumentDependentLookupCandidates(ULE->getName(), ULE->getExprLoc(),
11489                                          Args, ExplicitTemplateArgs,
11490                                          CandidateSet, PartialOverloading);
11491 }
11492 
11493 /// Determine whether a declaration with the specified name could be moved into
11494 /// a different namespace.
11495 static bool canBeDeclaredInNamespace(const DeclarationName &Name) {
11496   switch (Name.getCXXOverloadedOperator()) {
11497   case OO_New: case OO_Array_New:
11498   case OO_Delete: case OO_Array_Delete:
11499     return false;
11500 
11501   default:
11502     return true;
11503   }
11504 }
11505 
11506 /// Attempt to recover from an ill-formed use of a non-dependent name in a
11507 /// template, where the non-dependent name was declared after the template
11508 /// was defined. This is common in code written for a compilers which do not
11509 /// correctly implement two-stage name lookup.
11510 ///
11511 /// Returns true if a viable candidate was found and a diagnostic was issued.
11512 static bool
11513 DiagnoseTwoPhaseLookup(Sema &SemaRef, SourceLocation FnLoc,
11514                        const CXXScopeSpec &SS, LookupResult &R,
11515                        OverloadCandidateSet::CandidateSetKind CSK,
11516                        TemplateArgumentListInfo *ExplicitTemplateArgs,
11517                        ArrayRef<Expr *> Args,
11518                        bool *DoDiagnoseEmptyLookup = nullptr) {
11519   if (!SemaRef.inTemplateInstantiation() || !SS.isEmpty())
11520     return false;
11521 
11522   for (DeclContext *DC = SemaRef.CurContext; DC; DC = DC->getParent()) {
11523     if (DC->isTransparentContext())
11524       continue;
11525 
11526     SemaRef.LookupQualifiedName(R, DC);
11527 
11528     if (!R.empty()) {
11529       R.suppressDiagnostics();
11530 
11531       if (isa<CXXRecordDecl>(DC)) {
11532         // Don't diagnose names we find in classes; we get much better
11533         // diagnostics for these from DiagnoseEmptyLookup.
11534         R.clear();
11535         if (DoDiagnoseEmptyLookup)
11536           *DoDiagnoseEmptyLookup = true;
11537         return false;
11538       }
11539 
11540       OverloadCandidateSet Candidates(FnLoc, CSK);
11541       for (LookupResult::iterator I = R.begin(), E = R.end(); I != E; ++I)
11542         AddOverloadedCallCandidate(SemaRef, I.getPair(),
11543                                    ExplicitTemplateArgs, Args,
11544                                    Candidates, false, /*KnownValid*/ false);
11545 
11546       OverloadCandidateSet::iterator Best;
11547       if (Candidates.BestViableFunction(SemaRef, FnLoc, Best) != OR_Success) {
11548         // No viable functions. Don't bother the user with notes for functions
11549         // which don't work and shouldn't be found anyway.
11550         R.clear();
11551         return false;
11552       }
11553 
11554       // Find the namespaces where ADL would have looked, and suggest
11555       // declaring the function there instead.
11556       Sema::AssociatedNamespaceSet AssociatedNamespaces;
11557       Sema::AssociatedClassSet AssociatedClasses;
11558       SemaRef.FindAssociatedClassesAndNamespaces(FnLoc, Args,
11559                                                  AssociatedNamespaces,
11560                                                  AssociatedClasses);
11561       Sema::AssociatedNamespaceSet SuggestedNamespaces;
11562       if (canBeDeclaredInNamespace(R.getLookupName())) {
11563         DeclContext *Std = SemaRef.getStdNamespace();
11564         for (Sema::AssociatedNamespaceSet::iterator
11565                it = AssociatedNamespaces.begin(),
11566                end = AssociatedNamespaces.end(); it != end; ++it) {
11567           // Never suggest declaring a function within namespace 'std'.
11568           if (Std && Std->Encloses(*it))
11569             continue;
11570 
11571           // Never suggest declaring a function within a namespace with a
11572           // reserved name, like __gnu_cxx.
11573           NamespaceDecl *NS = dyn_cast<NamespaceDecl>(*it);
11574           if (NS &&
11575               NS->getQualifiedNameAsString().find("__") != std::string::npos)
11576             continue;
11577 
11578           SuggestedNamespaces.insert(*it);
11579         }
11580       }
11581 
11582       SemaRef.Diag(R.getNameLoc(), diag::err_not_found_by_two_phase_lookup)
11583         << R.getLookupName();
11584       if (SuggestedNamespaces.empty()) {
11585         SemaRef.Diag(Best->Function->getLocation(),
11586                      diag::note_not_found_by_two_phase_lookup)
11587           << R.getLookupName() << 0;
11588       } else if (SuggestedNamespaces.size() == 1) {
11589         SemaRef.Diag(Best->Function->getLocation(),
11590                      diag::note_not_found_by_two_phase_lookup)
11591           << R.getLookupName() << 1 << *SuggestedNamespaces.begin();
11592       } else {
11593         // FIXME: It would be useful to list the associated namespaces here,
11594         // but the diagnostics infrastructure doesn't provide a way to produce
11595         // a localized representation of a list of items.
11596         SemaRef.Diag(Best->Function->getLocation(),
11597                      diag::note_not_found_by_two_phase_lookup)
11598           << R.getLookupName() << 2;
11599       }
11600 
11601       // Try to recover by calling this function.
11602       return true;
11603     }
11604 
11605     R.clear();
11606   }
11607 
11608   return false;
11609 }
11610 
11611 /// Attempt to recover from ill-formed use of a non-dependent operator in a
11612 /// template, where the non-dependent operator was declared after the template
11613 /// was defined.
11614 ///
11615 /// Returns true if a viable candidate was found and a diagnostic was issued.
11616 static bool
11617 DiagnoseTwoPhaseOperatorLookup(Sema &SemaRef, OverloadedOperatorKind Op,
11618                                SourceLocation OpLoc,
11619                                ArrayRef<Expr *> Args) {
11620   DeclarationName OpName =
11621     SemaRef.Context.DeclarationNames.getCXXOperatorName(Op);
11622   LookupResult R(SemaRef, OpName, OpLoc, Sema::LookupOperatorName);
11623   return DiagnoseTwoPhaseLookup(SemaRef, OpLoc, CXXScopeSpec(), R,
11624                                 OverloadCandidateSet::CSK_Operator,
11625                                 /*ExplicitTemplateArgs=*/nullptr, Args);
11626 }
11627 
11628 namespace {
11629 class BuildRecoveryCallExprRAII {
11630   Sema &SemaRef;
11631 public:
11632   BuildRecoveryCallExprRAII(Sema &S) : SemaRef(S) {
11633     assert(SemaRef.IsBuildingRecoveryCallExpr == false);
11634     SemaRef.IsBuildingRecoveryCallExpr = true;
11635   }
11636 
11637   ~BuildRecoveryCallExprRAII() {
11638     SemaRef.IsBuildingRecoveryCallExpr = false;
11639   }
11640 };
11641 
11642 }
11643 
11644 static std::unique_ptr<CorrectionCandidateCallback>
11645 MakeValidator(Sema &SemaRef, MemberExpr *ME, size_t NumArgs,
11646               bool HasTemplateArgs, bool AllowTypoCorrection) {
11647   if (!AllowTypoCorrection)
11648     return llvm::make_unique<NoTypoCorrectionCCC>();
11649   return llvm::make_unique<FunctionCallFilterCCC>(SemaRef, NumArgs,
11650                                                   HasTemplateArgs, ME);
11651 }
11652 
11653 /// Attempts to recover from a call where no functions were found.
11654 ///
11655 /// Returns true if new candidates were found.
11656 static ExprResult
11657 BuildRecoveryCallExpr(Sema &SemaRef, Scope *S, Expr *Fn,
11658                       UnresolvedLookupExpr *ULE,
11659                       SourceLocation LParenLoc,
11660                       MutableArrayRef<Expr *> Args,
11661                       SourceLocation RParenLoc,
11662                       bool EmptyLookup, bool AllowTypoCorrection) {
11663   // Do not try to recover if it is already building a recovery call.
11664   // This stops infinite loops for template instantiations like
11665   //
11666   // template <typename T> auto foo(T t) -> decltype(foo(t)) {}
11667   // template <typename T> auto foo(T t) -> decltype(foo(&t)) {}
11668   //
11669   if (SemaRef.IsBuildingRecoveryCallExpr)
11670     return ExprError();
11671   BuildRecoveryCallExprRAII RCE(SemaRef);
11672 
11673   CXXScopeSpec SS;
11674   SS.Adopt(ULE->getQualifierLoc());
11675   SourceLocation TemplateKWLoc = ULE->getTemplateKeywordLoc();
11676 
11677   TemplateArgumentListInfo TABuffer;
11678   TemplateArgumentListInfo *ExplicitTemplateArgs = nullptr;
11679   if (ULE->hasExplicitTemplateArgs()) {
11680     ULE->copyTemplateArgumentsInto(TABuffer);
11681     ExplicitTemplateArgs = &TABuffer;
11682   }
11683 
11684   LookupResult R(SemaRef, ULE->getName(), ULE->getNameLoc(),
11685                  Sema::LookupOrdinaryName);
11686   bool DoDiagnoseEmptyLookup = EmptyLookup;
11687   if (!DiagnoseTwoPhaseLookup(SemaRef, Fn->getExprLoc(), SS, R,
11688                               OverloadCandidateSet::CSK_Normal,
11689                               ExplicitTemplateArgs, Args,
11690                               &DoDiagnoseEmptyLookup) &&
11691     (!DoDiagnoseEmptyLookup || SemaRef.DiagnoseEmptyLookup(
11692         S, SS, R,
11693         MakeValidator(SemaRef, dyn_cast<MemberExpr>(Fn), Args.size(),
11694                       ExplicitTemplateArgs != nullptr, AllowTypoCorrection),
11695         ExplicitTemplateArgs, Args)))
11696     return ExprError();
11697 
11698   assert(!R.empty() && "lookup results empty despite recovery");
11699 
11700   // If recovery created an ambiguity, just bail out.
11701   if (R.isAmbiguous()) {
11702     R.suppressDiagnostics();
11703     return ExprError();
11704   }
11705 
11706   // Build an implicit member call if appropriate.  Just drop the
11707   // casts and such from the call, we don't really care.
11708   ExprResult NewFn = ExprError();
11709   if ((*R.begin())->isCXXClassMember())
11710     NewFn = SemaRef.BuildPossibleImplicitMemberExpr(SS, TemplateKWLoc, R,
11711                                                     ExplicitTemplateArgs, S);
11712   else if (ExplicitTemplateArgs || TemplateKWLoc.isValid())
11713     NewFn = SemaRef.BuildTemplateIdExpr(SS, TemplateKWLoc, R, false,
11714                                         ExplicitTemplateArgs);
11715   else
11716     NewFn = SemaRef.BuildDeclarationNameExpr(SS, R, false);
11717 
11718   if (NewFn.isInvalid())
11719     return ExprError();
11720 
11721   // This shouldn't cause an infinite loop because we're giving it
11722   // an expression with viable lookup results, which should never
11723   // end up here.
11724   return SemaRef.ActOnCallExpr(/*Scope*/ nullptr, NewFn.get(), LParenLoc,
11725                                MultiExprArg(Args.data(), Args.size()),
11726                                RParenLoc);
11727 }
11728 
11729 /// \brief Constructs and populates an OverloadedCandidateSet from
11730 /// the given function.
11731 /// \returns true when an the ExprResult output parameter has been set.
11732 bool Sema::buildOverloadedCallSet(Scope *S, Expr *Fn,
11733                                   UnresolvedLookupExpr *ULE,
11734                                   MultiExprArg Args,
11735                                   SourceLocation RParenLoc,
11736                                   OverloadCandidateSet *CandidateSet,
11737                                   ExprResult *Result) {
11738 #ifndef NDEBUG
11739   if (ULE->requiresADL()) {
11740     // To do ADL, we must have found an unqualified name.
11741     assert(!ULE->getQualifier() && "qualified name with ADL");
11742 
11743     // We don't perform ADL for implicit declarations of builtins.
11744     // Verify that this was correctly set up.
11745     FunctionDecl *F;
11746     if (ULE->decls_begin() + 1 == ULE->decls_end() &&
11747         (F = dyn_cast<FunctionDecl>(*ULE->decls_begin())) &&
11748         F->getBuiltinID() && F->isImplicit())
11749       llvm_unreachable("performing ADL for builtin");
11750 
11751     // We don't perform ADL in C.
11752     assert(getLangOpts().CPlusPlus && "ADL enabled in C");
11753   }
11754 #endif
11755 
11756   UnbridgedCastsSet UnbridgedCasts;
11757   if (checkArgPlaceholdersForOverload(*this, Args, UnbridgedCasts)) {
11758     *Result = ExprError();
11759     return true;
11760   }
11761 
11762   // Add the functions denoted by the callee to the set of candidate
11763   // functions, including those from argument-dependent lookup.
11764   AddOverloadedCallCandidates(ULE, Args, *CandidateSet);
11765 
11766   if (getLangOpts().MSVCCompat &&
11767       CurContext->isDependentContext() && !isSFINAEContext() &&
11768       (isa<FunctionDecl>(CurContext) || isa<CXXRecordDecl>(CurContext))) {
11769 
11770     OverloadCandidateSet::iterator Best;
11771     if (CandidateSet->empty() ||
11772         CandidateSet->BestViableFunction(*this, Fn->getLocStart(), Best) ==
11773             OR_No_Viable_Function) {
11774       // In Microsoft mode, if we are inside a template class member function then
11775       // create a type dependent CallExpr. The goal is to postpone name lookup
11776       // to instantiation time to be able to search into type dependent base
11777       // classes.
11778       CallExpr *CE = new (Context) CallExpr(
11779           Context, Fn, Args, Context.DependentTy, VK_RValue, RParenLoc);
11780       CE->setTypeDependent(true);
11781       CE->setValueDependent(true);
11782       CE->setInstantiationDependent(true);
11783       *Result = CE;
11784       return true;
11785     }
11786   }
11787 
11788   if (CandidateSet->empty())
11789     return false;
11790 
11791   UnbridgedCasts.restore();
11792   return false;
11793 }
11794 
11795 /// FinishOverloadedCallExpr - given an OverloadCandidateSet, builds and returns
11796 /// the completed call expression. If overload resolution fails, emits
11797 /// diagnostics and returns ExprError()
11798 static ExprResult FinishOverloadedCallExpr(Sema &SemaRef, Scope *S, Expr *Fn,
11799                                            UnresolvedLookupExpr *ULE,
11800                                            SourceLocation LParenLoc,
11801                                            MultiExprArg Args,
11802                                            SourceLocation RParenLoc,
11803                                            Expr *ExecConfig,
11804                                            OverloadCandidateSet *CandidateSet,
11805                                            OverloadCandidateSet::iterator *Best,
11806                                            OverloadingResult OverloadResult,
11807                                            bool AllowTypoCorrection) {
11808   if (CandidateSet->empty())
11809     return BuildRecoveryCallExpr(SemaRef, S, Fn, ULE, LParenLoc, Args,
11810                                  RParenLoc, /*EmptyLookup=*/true,
11811                                  AllowTypoCorrection);
11812 
11813   switch (OverloadResult) {
11814   case OR_Success: {
11815     FunctionDecl *FDecl = (*Best)->Function;
11816     SemaRef.CheckUnresolvedLookupAccess(ULE, (*Best)->FoundDecl);
11817     if (SemaRef.DiagnoseUseOfDecl(FDecl, ULE->getNameLoc()))
11818       return ExprError();
11819     Fn = SemaRef.FixOverloadedFunctionReference(Fn, (*Best)->FoundDecl, FDecl);
11820     return SemaRef.BuildResolvedCallExpr(Fn, FDecl, LParenLoc, Args, RParenLoc,
11821                                          ExecConfig);
11822   }
11823 
11824   case OR_No_Viable_Function: {
11825     // Try to recover by looking for viable functions which the user might
11826     // have meant to call.
11827     ExprResult Recovery = BuildRecoveryCallExpr(SemaRef, S, Fn, ULE, LParenLoc,
11828                                                 Args, RParenLoc,
11829                                                 /*EmptyLookup=*/false,
11830                                                 AllowTypoCorrection);
11831     if (!Recovery.isInvalid())
11832       return Recovery;
11833 
11834     // If the user passes in a function that we can't take the address of, we
11835     // generally end up emitting really bad error messages. Here, we attempt to
11836     // emit better ones.
11837     for (const Expr *Arg : Args) {
11838       if (!Arg->getType()->isFunctionType())
11839         continue;
11840       if (auto *DRE = dyn_cast<DeclRefExpr>(Arg->IgnoreParenImpCasts())) {
11841         auto *FD = dyn_cast<FunctionDecl>(DRE->getDecl());
11842         if (FD &&
11843             !SemaRef.checkAddressOfFunctionIsAvailable(FD, /*Complain=*/true,
11844                                                        Arg->getExprLoc()))
11845           return ExprError();
11846       }
11847     }
11848 
11849     SemaRef.Diag(Fn->getLocStart(), diag::err_ovl_no_viable_function_in_call)
11850         << ULE->getName() << Fn->getSourceRange();
11851     CandidateSet->NoteCandidates(SemaRef, OCD_AllCandidates, Args);
11852     break;
11853   }
11854 
11855   case OR_Ambiguous:
11856     SemaRef.Diag(Fn->getLocStart(), diag::err_ovl_ambiguous_call)
11857       << ULE->getName() << Fn->getSourceRange();
11858     CandidateSet->NoteCandidates(SemaRef, OCD_ViableCandidates, Args);
11859     break;
11860 
11861   case OR_Deleted: {
11862     SemaRef.Diag(Fn->getLocStart(), diag::err_ovl_deleted_call)
11863       << (*Best)->Function->isDeleted()
11864       << ULE->getName()
11865       << SemaRef.getDeletedOrUnavailableSuffix((*Best)->Function)
11866       << Fn->getSourceRange();
11867     CandidateSet->NoteCandidates(SemaRef, OCD_AllCandidates, Args);
11868 
11869     // We emitted an error for the unvailable/deleted function call but keep
11870     // the call in the AST.
11871     FunctionDecl *FDecl = (*Best)->Function;
11872     Fn = SemaRef.FixOverloadedFunctionReference(Fn, (*Best)->FoundDecl, FDecl);
11873     return SemaRef.BuildResolvedCallExpr(Fn, FDecl, LParenLoc, Args, RParenLoc,
11874                                          ExecConfig);
11875   }
11876   }
11877 
11878   // Overload resolution failed.
11879   return ExprError();
11880 }
11881 
11882 static void markUnaddressableCandidatesUnviable(Sema &S,
11883                                                 OverloadCandidateSet &CS) {
11884   for (auto I = CS.begin(), E = CS.end(); I != E; ++I) {
11885     if (I->Viable &&
11886         !S.checkAddressOfFunctionIsAvailable(I->Function, /*Complain=*/false)) {
11887       I->Viable = false;
11888       I->FailureKind = ovl_fail_addr_not_available;
11889     }
11890   }
11891 }
11892 
11893 /// BuildOverloadedCallExpr - Given the call expression that calls Fn
11894 /// (which eventually refers to the declaration Func) and the call
11895 /// arguments Args/NumArgs, attempt to resolve the function call down
11896 /// to a specific function. If overload resolution succeeds, returns
11897 /// the call expression produced by overload resolution.
11898 /// Otherwise, emits diagnostics and returns ExprError.
11899 ExprResult Sema::BuildOverloadedCallExpr(Scope *S, Expr *Fn,
11900                                          UnresolvedLookupExpr *ULE,
11901                                          SourceLocation LParenLoc,
11902                                          MultiExprArg Args,
11903                                          SourceLocation RParenLoc,
11904                                          Expr *ExecConfig,
11905                                          bool AllowTypoCorrection,
11906                                          bool CalleesAddressIsTaken) {
11907   OverloadCandidateSet CandidateSet(Fn->getExprLoc(),
11908                                     OverloadCandidateSet::CSK_Normal);
11909   ExprResult result;
11910 
11911   if (buildOverloadedCallSet(S, Fn, ULE, Args, LParenLoc, &CandidateSet,
11912                              &result))
11913     return result;
11914 
11915   // If the user handed us something like `(&Foo)(Bar)`, we need to ensure that
11916   // functions that aren't addressible are considered unviable.
11917   if (CalleesAddressIsTaken)
11918     markUnaddressableCandidatesUnviable(*this, CandidateSet);
11919 
11920   OverloadCandidateSet::iterator Best;
11921   OverloadingResult OverloadResult =
11922       CandidateSet.BestViableFunction(*this, Fn->getLocStart(), Best);
11923 
11924   return FinishOverloadedCallExpr(*this, S, Fn, ULE, LParenLoc, Args,
11925                                   RParenLoc, ExecConfig, &CandidateSet,
11926                                   &Best, OverloadResult,
11927                                   AllowTypoCorrection);
11928 }
11929 
11930 static bool IsOverloaded(const UnresolvedSetImpl &Functions) {
11931   return Functions.size() > 1 ||
11932     (Functions.size() == 1 && isa<FunctionTemplateDecl>(*Functions.begin()));
11933 }
11934 
11935 /// \brief Create a unary operation that may resolve to an overloaded
11936 /// operator.
11937 ///
11938 /// \param OpLoc The location of the operator itself (e.g., '*').
11939 ///
11940 /// \param Opc The UnaryOperatorKind that describes this operator.
11941 ///
11942 /// \param Fns The set of non-member functions that will be
11943 /// considered by overload resolution. The caller needs to build this
11944 /// set based on the context using, e.g.,
11945 /// LookupOverloadedOperatorName() and ArgumentDependentLookup(). This
11946 /// set should not contain any member functions; those will be added
11947 /// by CreateOverloadedUnaryOp().
11948 ///
11949 /// \param Input The input argument.
11950 ExprResult
11951 Sema::CreateOverloadedUnaryOp(SourceLocation OpLoc, UnaryOperatorKind Opc,
11952                               const UnresolvedSetImpl &Fns,
11953                               Expr *Input, bool PerformADL) {
11954   OverloadedOperatorKind Op = UnaryOperator::getOverloadedOperator(Opc);
11955   assert(Op != OO_None && "Invalid opcode for overloaded unary operator");
11956   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(Op);
11957   // TODO: provide better source location info.
11958   DeclarationNameInfo OpNameInfo(OpName, OpLoc);
11959 
11960   if (checkPlaceholderForOverload(*this, Input))
11961     return ExprError();
11962 
11963   Expr *Args[2] = { Input, nullptr };
11964   unsigned NumArgs = 1;
11965 
11966   // For post-increment and post-decrement, add the implicit '0' as
11967   // the second argument, so that we know this is a post-increment or
11968   // post-decrement.
11969   if (Opc == UO_PostInc || Opc == UO_PostDec) {
11970     llvm::APSInt Zero(Context.getTypeSize(Context.IntTy), false);
11971     Args[1] = IntegerLiteral::Create(Context, Zero, Context.IntTy,
11972                                      SourceLocation());
11973     NumArgs = 2;
11974   }
11975 
11976   ArrayRef<Expr *> ArgsArray(Args, NumArgs);
11977 
11978   if (Input->isTypeDependent()) {
11979     if (Fns.empty())
11980       return new (Context) UnaryOperator(Input, Opc, Context.DependentTy,
11981                                          VK_RValue, OK_Ordinary, OpLoc);
11982 
11983     CXXRecordDecl *NamingClass = nullptr; // lookup ignores member operators
11984     UnresolvedLookupExpr *Fn
11985       = UnresolvedLookupExpr::Create(Context, NamingClass,
11986                                      NestedNameSpecifierLoc(), OpNameInfo,
11987                                      /*ADL*/ true, IsOverloaded(Fns),
11988                                      Fns.begin(), Fns.end());
11989     return new (Context)
11990         CXXOperatorCallExpr(Context, Op, Fn, ArgsArray, Context.DependentTy,
11991                             VK_RValue, OpLoc, FPOptions());
11992   }
11993 
11994   // Build an empty overload set.
11995   OverloadCandidateSet CandidateSet(OpLoc, OverloadCandidateSet::CSK_Operator);
11996 
11997   // Add the candidates from the given function set.
11998   AddFunctionCandidates(Fns, ArgsArray, CandidateSet);
11999 
12000   // Add operator candidates that are member functions.
12001   AddMemberOperatorCandidates(Op, OpLoc, ArgsArray, CandidateSet);
12002 
12003   // Add candidates from ADL.
12004   if (PerformADL) {
12005     AddArgumentDependentLookupCandidates(OpName, OpLoc, ArgsArray,
12006                                          /*ExplicitTemplateArgs*/nullptr,
12007                                          CandidateSet);
12008   }
12009 
12010   // Add builtin operator candidates.
12011   AddBuiltinOperatorCandidates(Op, OpLoc, ArgsArray, CandidateSet);
12012 
12013   bool HadMultipleCandidates = (CandidateSet.size() > 1);
12014 
12015   // Perform overload resolution.
12016   OverloadCandidateSet::iterator Best;
12017   switch (CandidateSet.BestViableFunction(*this, OpLoc, Best)) {
12018   case OR_Success: {
12019     // We found a built-in operator or an overloaded operator.
12020     FunctionDecl *FnDecl = Best->Function;
12021 
12022     if (FnDecl) {
12023       Expr *Base = nullptr;
12024       // We matched an overloaded operator. Build a call to that
12025       // operator.
12026 
12027       // Convert the arguments.
12028       if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(FnDecl)) {
12029         CheckMemberOperatorAccess(OpLoc, Args[0], nullptr, Best->FoundDecl);
12030 
12031         ExprResult InputRes =
12032           PerformObjectArgumentInitialization(Input, /*Qualifier=*/nullptr,
12033                                               Best->FoundDecl, Method);
12034         if (InputRes.isInvalid())
12035           return ExprError();
12036         Base = Input = InputRes.get();
12037       } else {
12038         // Convert the arguments.
12039         ExprResult InputInit
12040           = PerformCopyInitialization(InitializedEntity::InitializeParameter(
12041                                                       Context,
12042                                                       FnDecl->getParamDecl(0)),
12043                                       SourceLocation(),
12044                                       Input);
12045         if (InputInit.isInvalid())
12046           return ExprError();
12047         Input = InputInit.get();
12048       }
12049 
12050       // Build the actual expression node.
12051       ExprResult FnExpr = CreateFunctionRefExpr(*this, FnDecl, Best->FoundDecl,
12052                                                 Base, HadMultipleCandidates,
12053                                                 OpLoc);
12054       if (FnExpr.isInvalid())
12055         return ExprError();
12056 
12057       // Determine the result type.
12058       QualType ResultTy = FnDecl->getReturnType();
12059       ExprValueKind VK = Expr::getValueKindForType(ResultTy);
12060       ResultTy = ResultTy.getNonLValueExprType(Context);
12061 
12062       Args[0] = Input;
12063       CallExpr *TheCall =
12064         new (Context) CXXOperatorCallExpr(Context, Op, FnExpr.get(), ArgsArray,
12065                                           ResultTy, VK, OpLoc, FPOptions());
12066 
12067       if (CheckCallReturnType(FnDecl->getReturnType(), OpLoc, TheCall, FnDecl))
12068         return ExprError();
12069 
12070       if (CheckFunctionCall(FnDecl, TheCall,
12071                             FnDecl->getType()->castAs<FunctionProtoType>()))
12072         return ExprError();
12073 
12074       return MaybeBindToTemporary(TheCall);
12075     } else {
12076       // We matched a built-in operator. Convert the arguments, then
12077       // break out so that we will build the appropriate built-in
12078       // operator node.
12079       ExprResult InputRes = PerformImplicitConversion(
12080           Input, Best->BuiltinParamTypes[0], Best->Conversions[0], AA_Passing);
12081       if (InputRes.isInvalid())
12082         return ExprError();
12083       Input = InputRes.get();
12084       break;
12085     }
12086   }
12087 
12088   case OR_No_Viable_Function:
12089     // This is an erroneous use of an operator which can be overloaded by
12090     // a non-member function. Check for non-member operators which were
12091     // defined too late to be candidates.
12092     if (DiagnoseTwoPhaseOperatorLookup(*this, Op, OpLoc, ArgsArray))
12093       // FIXME: Recover by calling the found function.
12094       return ExprError();
12095 
12096     // No viable function; fall through to handling this as a
12097     // built-in operator, which will produce an error message for us.
12098     break;
12099 
12100   case OR_Ambiguous:
12101     Diag(OpLoc,  diag::err_ovl_ambiguous_oper_unary)
12102         << UnaryOperator::getOpcodeStr(Opc)
12103         << Input->getType()
12104         << Input->getSourceRange();
12105     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, ArgsArray,
12106                                 UnaryOperator::getOpcodeStr(Opc), OpLoc);
12107     return ExprError();
12108 
12109   case OR_Deleted:
12110     Diag(OpLoc, diag::err_ovl_deleted_oper)
12111       << Best->Function->isDeleted()
12112       << UnaryOperator::getOpcodeStr(Opc)
12113       << getDeletedOrUnavailableSuffix(Best->Function)
12114       << Input->getSourceRange();
12115     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, ArgsArray,
12116                                 UnaryOperator::getOpcodeStr(Opc), OpLoc);
12117     return ExprError();
12118   }
12119 
12120   // Either we found no viable overloaded operator or we matched a
12121   // built-in operator. In either case, fall through to trying to
12122   // build a built-in operation.
12123   return CreateBuiltinUnaryOp(OpLoc, Opc, Input);
12124 }
12125 
12126 /// \brief Create a binary operation that may resolve to an overloaded
12127 /// operator.
12128 ///
12129 /// \param OpLoc The location of the operator itself (e.g., '+').
12130 ///
12131 /// \param Opc The BinaryOperatorKind that describes this operator.
12132 ///
12133 /// \param Fns The set of non-member functions that will be
12134 /// considered by overload resolution. The caller needs to build this
12135 /// set based on the context using, e.g.,
12136 /// LookupOverloadedOperatorName() and ArgumentDependentLookup(). This
12137 /// set should not contain any member functions; those will be added
12138 /// by CreateOverloadedBinOp().
12139 ///
12140 /// \param LHS Left-hand argument.
12141 /// \param RHS Right-hand argument.
12142 ExprResult
12143 Sema::CreateOverloadedBinOp(SourceLocation OpLoc,
12144                             BinaryOperatorKind Opc,
12145                             const UnresolvedSetImpl &Fns,
12146                             Expr *LHS, Expr *RHS, bool PerformADL) {
12147   Expr *Args[2] = { LHS, RHS };
12148   LHS=RHS=nullptr; // Please use only Args instead of LHS/RHS couple
12149 
12150   OverloadedOperatorKind Op = BinaryOperator::getOverloadedOperator(Opc);
12151   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(Op);
12152 
12153   // If either side is type-dependent, create an appropriate dependent
12154   // expression.
12155   if (Args[0]->isTypeDependent() || Args[1]->isTypeDependent()) {
12156     if (Fns.empty()) {
12157       // If there are no functions to store, just build a dependent
12158       // BinaryOperator or CompoundAssignment.
12159       if (Opc <= BO_Assign || Opc > BO_OrAssign)
12160         return new (Context) BinaryOperator(
12161             Args[0], Args[1], Opc, Context.DependentTy, VK_RValue, OK_Ordinary,
12162             OpLoc, FPFeatures);
12163 
12164       return new (Context) CompoundAssignOperator(
12165           Args[0], Args[1], Opc, Context.DependentTy, VK_LValue, OK_Ordinary,
12166           Context.DependentTy, Context.DependentTy, OpLoc,
12167           FPFeatures);
12168     }
12169 
12170     // FIXME: save results of ADL from here?
12171     CXXRecordDecl *NamingClass = nullptr; // lookup ignores member operators
12172     // TODO: provide better source location info in DNLoc component.
12173     DeclarationNameInfo OpNameInfo(OpName, OpLoc);
12174     UnresolvedLookupExpr *Fn
12175       = UnresolvedLookupExpr::Create(Context, NamingClass,
12176                                      NestedNameSpecifierLoc(), OpNameInfo,
12177                                      /*ADL*/PerformADL, IsOverloaded(Fns),
12178                                      Fns.begin(), Fns.end());
12179     return new (Context)
12180         CXXOperatorCallExpr(Context, Op, Fn, Args, Context.DependentTy,
12181                             VK_RValue, OpLoc, FPFeatures);
12182   }
12183 
12184   // Always do placeholder-like conversions on the RHS.
12185   if (checkPlaceholderForOverload(*this, Args[1]))
12186     return ExprError();
12187 
12188   // Do placeholder-like conversion on the LHS; note that we should
12189   // not get here with a PseudoObject LHS.
12190   assert(Args[0]->getObjectKind() != OK_ObjCProperty);
12191   if (checkPlaceholderForOverload(*this, Args[0]))
12192     return ExprError();
12193 
12194   // If this is the assignment operator, we only perform overload resolution
12195   // if the left-hand side is a class or enumeration type. This is actually
12196   // a hack. The standard requires that we do overload resolution between the
12197   // various built-in candidates, but as DR507 points out, this can lead to
12198   // problems. So we do it this way, which pretty much follows what GCC does.
12199   // Note that we go the traditional code path for compound assignment forms.
12200   if (Opc == BO_Assign && !Args[0]->getType()->isOverloadableType())
12201     return CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
12202 
12203   // If this is the .* operator, which is not overloadable, just
12204   // create a built-in binary operator.
12205   if (Opc == BO_PtrMemD)
12206     return CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
12207 
12208   // Build an empty overload set.
12209   OverloadCandidateSet CandidateSet(OpLoc, OverloadCandidateSet::CSK_Operator);
12210 
12211   // Add the candidates from the given function set.
12212   AddFunctionCandidates(Fns, Args, CandidateSet);
12213 
12214   // Add operator candidates that are member functions.
12215   AddMemberOperatorCandidates(Op, OpLoc, Args, CandidateSet);
12216 
12217   // Add candidates from ADL. Per [over.match.oper]p2, this lookup is not
12218   // performed for an assignment operator (nor for operator[] nor operator->,
12219   // which don't get here).
12220   if (Opc != BO_Assign && PerformADL)
12221     AddArgumentDependentLookupCandidates(OpName, OpLoc, Args,
12222                                          /*ExplicitTemplateArgs*/ nullptr,
12223                                          CandidateSet);
12224 
12225   // Add builtin operator candidates.
12226   AddBuiltinOperatorCandidates(Op, OpLoc, Args, CandidateSet);
12227 
12228   bool HadMultipleCandidates = (CandidateSet.size() > 1);
12229 
12230   // Perform overload resolution.
12231   OverloadCandidateSet::iterator Best;
12232   switch (CandidateSet.BestViableFunction(*this, OpLoc, Best)) {
12233     case OR_Success: {
12234       // We found a built-in operator or an overloaded operator.
12235       FunctionDecl *FnDecl = Best->Function;
12236 
12237       if (FnDecl) {
12238         Expr *Base = nullptr;
12239         // We matched an overloaded operator. Build a call to that
12240         // operator.
12241 
12242         // Convert the arguments.
12243         if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(FnDecl)) {
12244           // Best->Access is only meaningful for class members.
12245           CheckMemberOperatorAccess(OpLoc, Args[0], Args[1], Best->FoundDecl);
12246 
12247           ExprResult Arg1 =
12248             PerformCopyInitialization(
12249               InitializedEntity::InitializeParameter(Context,
12250                                                      FnDecl->getParamDecl(0)),
12251               SourceLocation(), Args[1]);
12252           if (Arg1.isInvalid())
12253             return ExprError();
12254 
12255           ExprResult Arg0 =
12256             PerformObjectArgumentInitialization(Args[0], /*Qualifier=*/nullptr,
12257                                                 Best->FoundDecl, Method);
12258           if (Arg0.isInvalid())
12259             return ExprError();
12260           Base = Args[0] = Arg0.getAs<Expr>();
12261           Args[1] = RHS = Arg1.getAs<Expr>();
12262         } else {
12263           // Convert the arguments.
12264           ExprResult Arg0 = PerformCopyInitialization(
12265             InitializedEntity::InitializeParameter(Context,
12266                                                    FnDecl->getParamDecl(0)),
12267             SourceLocation(), Args[0]);
12268           if (Arg0.isInvalid())
12269             return ExprError();
12270 
12271           ExprResult Arg1 =
12272             PerformCopyInitialization(
12273               InitializedEntity::InitializeParameter(Context,
12274                                                      FnDecl->getParamDecl(1)),
12275               SourceLocation(), Args[1]);
12276           if (Arg1.isInvalid())
12277             return ExprError();
12278           Args[0] = LHS = Arg0.getAs<Expr>();
12279           Args[1] = RHS = Arg1.getAs<Expr>();
12280         }
12281 
12282         // Build the actual expression node.
12283         ExprResult FnExpr = CreateFunctionRefExpr(*this, FnDecl,
12284                                                   Best->FoundDecl, Base,
12285                                                   HadMultipleCandidates, OpLoc);
12286         if (FnExpr.isInvalid())
12287           return ExprError();
12288 
12289         // Determine the result type.
12290         QualType ResultTy = FnDecl->getReturnType();
12291         ExprValueKind VK = Expr::getValueKindForType(ResultTy);
12292         ResultTy = ResultTy.getNonLValueExprType(Context);
12293 
12294         CXXOperatorCallExpr *TheCall =
12295           new (Context) CXXOperatorCallExpr(Context, Op, FnExpr.get(),
12296                                             Args, ResultTy, VK, OpLoc,
12297                                             FPFeatures);
12298 
12299         if (CheckCallReturnType(FnDecl->getReturnType(), OpLoc, TheCall,
12300                                 FnDecl))
12301           return ExprError();
12302 
12303         ArrayRef<const Expr *> ArgsArray(Args, 2);
12304         const Expr *ImplicitThis = nullptr;
12305         // Cut off the implicit 'this'.
12306         if (isa<CXXMethodDecl>(FnDecl)) {
12307           ImplicitThis = ArgsArray[0];
12308           ArgsArray = ArgsArray.slice(1);
12309         }
12310 
12311         // Check for a self move.
12312         if (Op == OO_Equal)
12313           DiagnoseSelfMove(Args[0], Args[1], OpLoc);
12314 
12315         checkCall(FnDecl, nullptr, ImplicitThis, ArgsArray,
12316                   isa<CXXMethodDecl>(FnDecl), OpLoc, TheCall->getSourceRange(),
12317                   VariadicDoesNotApply);
12318 
12319         return MaybeBindToTemporary(TheCall);
12320       } else {
12321         // We matched a built-in operator. Convert the arguments, then
12322         // break out so that we will build the appropriate built-in
12323         // operator node.
12324         ExprResult ArgsRes0 =
12325             PerformImplicitConversion(Args[0], Best->BuiltinParamTypes[0],
12326                                       Best->Conversions[0], AA_Passing);
12327         if (ArgsRes0.isInvalid())
12328           return ExprError();
12329         Args[0] = ArgsRes0.get();
12330 
12331         ExprResult ArgsRes1 =
12332             PerformImplicitConversion(Args[1], Best->BuiltinParamTypes[1],
12333                                       Best->Conversions[1], AA_Passing);
12334         if (ArgsRes1.isInvalid())
12335           return ExprError();
12336         Args[1] = ArgsRes1.get();
12337         break;
12338       }
12339     }
12340 
12341     case OR_No_Viable_Function: {
12342       // C++ [over.match.oper]p9:
12343       //   If the operator is the operator , [...] and there are no
12344       //   viable functions, then the operator is assumed to be the
12345       //   built-in operator and interpreted according to clause 5.
12346       if (Opc == BO_Comma)
12347         break;
12348 
12349       // For class as left operand for assignment or compound assigment
12350       // operator do not fall through to handling in built-in, but report that
12351       // no overloaded assignment operator found
12352       ExprResult Result = ExprError();
12353       if (Args[0]->getType()->isRecordType() &&
12354           Opc >= BO_Assign && Opc <= BO_OrAssign) {
12355         Diag(OpLoc,  diag::err_ovl_no_viable_oper)
12356              << BinaryOperator::getOpcodeStr(Opc)
12357              << Args[0]->getSourceRange() << Args[1]->getSourceRange();
12358         if (Args[0]->getType()->isIncompleteType()) {
12359           Diag(OpLoc, diag::note_assign_lhs_incomplete)
12360             << Args[0]->getType()
12361             << Args[0]->getSourceRange() << Args[1]->getSourceRange();
12362         }
12363       } else {
12364         // This is an erroneous use of an operator which can be overloaded by
12365         // a non-member function. Check for non-member operators which were
12366         // defined too late to be candidates.
12367         if (DiagnoseTwoPhaseOperatorLookup(*this, Op, OpLoc, Args))
12368           // FIXME: Recover by calling the found function.
12369           return ExprError();
12370 
12371         // No viable function; try to create a built-in operation, which will
12372         // produce an error. Then, show the non-viable candidates.
12373         Result = CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
12374       }
12375       assert(Result.isInvalid() &&
12376              "C++ binary operator overloading is missing candidates!");
12377       if (Result.isInvalid())
12378         CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
12379                                     BinaryOperator::getOpcodeStr(Opc), OpLoc);
12380       return Result;
12381     }
12382 
12383     case OR_Ambiguous:
12384       Diag(OpLoc,  diag::err_ovl_ambiguous_oper_binary)
12385           << BinaryOperator::getOpcodeStr(Opc)
12386           << Args[0]->getType() << Args[1]->getType()
12387           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
12388       CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args,
12389                                   BinaryOperator::getOpcodeStr(Opc), OpLoc);
12390       return ExprError();
12391 
12392     case OR_Deleted:
12393       if (isImplicitlyDeleted(Best->Function)) {
12394         CXXMethodDecl *Method = cast<CXXMethodDecl>(Best->Function);
12395         Diag(OpLoc, diag::err_ovl_deleted_special_oper)
12396           << Context.getRecordType(Method->getParent())
12397           << getSpecialMember(Method);
12398 
12399         // The user probably meant to call this special member. Just
12400         // explain why it's deleted.
12401         NoteDeletedFunction(Method);
12402         return ExprError();
12403       } else {
12404         Diag(OpLoc, diag::err_ovl_deleted_oper)
12405           << Best->Function->isDeleted()
12406           << BinaryOperator::getOpcodeStr(Opc)
12407           << getDeletedOrUnavailableSuffix(Best->Function)
12408           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
12409       }
12410       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
12411                                   BinaryOperator::getOpcodeStr(Opc), OpLoc);
12412       return ExprError();
12413   }
12414 
12415   // We matched a built-in operator; build it.
12416   return CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
12417 }
12418 
12419 ExprResult
12420 Sema::CreateOverloadedArraySubscriptExpr(SourceLocation LLoc,
12421                                          SourceLocation RLoc,
12422                                          Expr *Base, Expr *Idx) {
12423   Expr *Args[2] = { Base, Idx };
12424   DeclarationName OpName =
12425       Context.DeclarationNames.getCXXOperatorName(OO_Subscript);
12426 
12427   // If either side is type-dependent, create an appropriate dependent
12428   // expression.
12429   if (Args[0]->isTypeDependent() || Args[1]->isTypeDependent()) {
12430 
12431     CXXRecordDecl *NamingClass = nullptr; // lookup ignores member operators
12432     // CHECKME: no 'operator' keyword?
12433     DeclarationNameInfo OpNameInfo(OpName, LLoc);
12434     OpNameInfo.setCXXOperatorNameRange(SourceRange(LLoc, RLoc));
12435     UnresolvedLookupExpr *Fn
12436       = UnresolvedLookupExpr::Create(Context, NamingClass,
12437                                      NestedNameSpecifierLoc(), OpNameInfo,
12438                                      /*ADL*/ true, /*Overloaded*/ false,
12439                                      UnresolvedSetIterator(),
12440                                      UnresolvedSetIterator());
12441     // Can't add any actual overloads yet
12442 
12443     return new (Context)
12444         CXXOperatorCallExpr(Context, OO_Subscript, Fn, Args,
12445                             Context.DependentTy, VK_RValue, RLoc, FPOptions());
12446   }
12447 
12448   // Handle placeholders on both operands.
12449   if (checkPlaceholderForOverload(*this, Args[0]))
12450     return ExprError();
12451   if (checkPlaceholderForOverload(*this, Args[1]))
12452     return ExprError();
12453 
12454   // Build an empty overload set.
12455   OverloadCandidateSet CandidateSet(LLoc, OverloadCandidateSet::CSK_Operator);
12456 
12457   // Subscript can only be overloaded as a member function.
12458 
12459   // Add operator candidates that are member functions.
12460   AddMemberOperatorCandidates(OO_Subscript, LLoc, Args, CandidateSet);
12461 
12462   // Add builtin operator candidates.
12463   AddBuiltinOperatorCandidates(OO_Subscript, LLoc, Args, CandidateSet);
12464 
12465   bool HadMultipleCandidates = (CandidateSet.size() > 1);
12466 
12467   // Perform overload resolution.
12468   OverloadCandidateSet::iterator Best;
12469   switch (CandidateSet.BestViableFunction(*this, LLoc, Best)) {
12470     case OR_Success: {
12471       // We found a built-in operator or an overloaded operator.
12472       FunctionDecl *FnDecl = Best->Function;
12473 
12474       if (FnDecl) {
12475         // We matched an overloaded operator. Build a call to that
12476         // operator.
12477 
12478         CheckMemberOperatorAccess(LLoc, Args[0], Args[1], Best->FoundDecl);
12479 
12480         // Convert the arguments.
12481         CXXMethodDecl *Method = cast<CXXMethodDecl>(FnDecl);
12482         ExprResult Arg0 =
12483           PerformObjectArgumentInitialization(Args[0], /*Qualifier=*/nullptr,
12484                                               Best->FoundDecl, Method);
12485         if (Arg0.isInvalid())
12486           return ExprError();
12487         Args[0] = Arg0.get();
12488 
12489         // Convert the arguments.
12490         ExprResult InputInit
12491           = PerformCopyInitialization(InitializedEntity::InitializeParameter(
12492                                                       Context,
12493                                                       FnDecl->getParamDecl(0)),
12494                                       SourceLocation(),
12495                                       Args[1]);
12496         if (InputInit.isInvalid())
12497           return ExprError();
12498 
12499         Args[1] = InputInit.getAs<Expr>();
12500 
12501         // Build the actual expression node.
12502         DeclarationNameInfo OpLocInfo(OpName, LLoc);
12503         OpLocInfo.setCXXOperatorNameRange(SourceRange(LLoc, RLoc));
12504         ExprResult FnExpr = CreateFunctionRefExpr(*this, FnDecl,
12505                                                   Best->FoundDecl,
12506                                                   Base,
12507                                                   HadMultipleCandidates,
12508                                                   OpLocInfo.getLoc(),
12509                                                   OpLocInfo.getInfo());
12510         if (FnExpr.isInvalid())
12511           return ExprError();
12512 
12513         // Determine the result type
12514         QualType ResultTy = FnDecl->getReturnType();
12515         ExprValueKind VK = Expr::getValueKindForType(ResultTy);
12516         ResultTy = ResultTy.getNonLValueExprType(Context);
12517 
12518         CXXOperatorCallExpr *TheCall =
12519           new (Context) CXXOperatorCallExpr(Context, OO_Subscript,
12520                                             FnExpr.get(), Args,
12521                                             ResultTy, VK, RLoc,
12522                                             FPOptions());
12523 
12524         if (CheckCallReturnType(FnDecl->getReturnType(), LLoc, TheCall, FnDecl))
12525           return ExprError();
12526 
12527         if (CheckFunctionCall(Method, TheCall,
12528                               Method->getType()->castAs<FunctionProtoType>()))
12529           return ExprError();
12530 
12531         return MaybeBindToTemporary(TheCall);
12532       } else {
12533         // We matched a built-in operator. Convert the arguments, then
12534         // break out so that we will build the appropriate built-in
12535         // operator node.
12536         ExprResult ArgsRes0 =
12537             PerformImplicitConversion(Args[0], Best->BuiltinParamTypes[0],
12538                                       Best->Conversions[0], AA_Passing);
12539         if (ArgsRes0.isInvalid())
12540           return ExprError();
12541         Args[0] = ArgsRes0.get();
12542 
12543         ExprResult ArgsRes1 =
12544             PerformImplicitConversion(Args[1], Best->BuiltinParamTypes[1],
12545                                       Best->Conversions[1], AA_Passing);
12546         if (ArgsRes1.isInvalid())
12547           return ExprError();
12548         Args[1] = ArgsRes1.get();
12549 
12550         break;
12551       }
12552     }
12553 
12554     case OR_No_Viable_Function: {
12555       if (CandidateSet.empty())
12556         Diag(LLoc, diag::err_ovl_no_oper)
12557           << Args[0]->getType() << /*subscript*/ 0
12558           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
12559       else
12560         Diag(LLoc, diag::err_ovl_no_viable_subscript)
12561           << Args[0]->getType()
12562           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
12563       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
12564                                   "[]", LLoc);
12565       return ExprError();
12566     }
12567 
12568     case OR_Ambiguous:
12569       Diag(LLoc,  diag::err_ovl_ambiguous_oper_binary)
12570           << "[]"
12571           << Args[0]->getType() << Args[1]->getType()
12572           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
12573       CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args,
12574                                   "[]", LLoc);
12575       return ExprError();
12576 
12577     case OR_Deleted:
12578       Diag(LLoc, diag::err_ovl_deleted_oper)
12579         << Best->Function->isDeleted() << "[]"
12580         << getDeletedOrUnavailableSuffix(Best->Function)
12581         << Args[0]->getSourceRange() << Args[1]->getSourceRange();
12582       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
12583                                   "[]", LLoc);
12584       return ExprError();
12585     }
12586 
12587   // We matched a built-in operator; build it.
12588   return CreateBuiltinArraySubscriptExpr(Args[0], LLoc, Args[1], RLoc);
12589 }
12590 
12591 /// BuildCallToMemberFunction - Build a call to a member
12592 /// function. MemExpr is the expression that refers to the member
12593 /// function (and includes the object parameter), Args/NumArgs are the
12594 /// arguments to the function call (not including the object
12595 /// parameter). The caller needs to validate that the member
12596 /// expression refers to a non-static member function or an overloaded
12597 /// member function.
12598 ExprResult
12599 Sema::BuildCallToMemberFunction(Scope *S, Expr *MemExprE,
12600                                 SourceLocation LParenLoc,
12601                                 MultiExprArg Args,
12602                                 SourceLocation RParenLoc) {
12603   assert(MemExprE->getType() == Context.BoundMemberTy ||
12604          MemExprE->getType() == Context.OverloadTy);
12605 
12606   // Dig out the member expression. This holds both the object
12607   // argument and the member function we're referring to.
12608   Expr *NakedMemExpr = MemExprE->IgnoreParens();
12609 
12610   // Determine whether this is a call to a pointer-to-member function.
12611   if (BinaryOperator *op = dyn_cast<BinaryOperator>(NakedMemExpr)) {
12612     assert(op->getType() == Context.BoundMemberTy);
12613     assert(op->getOpcode() == BO_PtrMemD || op->getOpcode() == BO_PtrMemI);
12614 
12615     QualType fnType =
12616       op->getRHS()->getType()->castAs<MemberPointerType>()->getPointeeType();
12617 
12618     const FunctionProtoType *proto = fnType->castAs<FunctionProtoType>();
12619     QualType resultType = proto->getCallResultType(Context);
12620     ExprValueKind valueKind = Expr::getValueKindForType(proto->getReturnType());
12621 
12622     // Check that the object type isn't more qualified than the
12623     // member function we're calling.
12624     Qualifiers funcQuals = Qualifiers::fromCVRMask(proto->getTypeQuals());
12625 
12626     QualType objectType = op->getLHS()->getType();
12627     if (op->getOpcode() == BO_PtrMemI)
12628       objectType = objectType->castAs<PointerType>()->getPointeeType();
12629     Qualifiers objectQuals = objectType.getQualifiers();
12630 
12631     Qualifiers difference = objectQuals - funcQuals;
12632     difference.removeObjCGCAttr();
12633     difference.removeAddressSpace();
12634     if (difference) {
12635       std::string qualsString = difference.getAsString();
12636       Diag(LParenLoc, diag::err_pointer_to_member_call_drops_quals)
12637         << fnType.getUnqualifiedType()
12638         << qualsString
12639         << (qualsString.find(' ') == std::string::npos ? 1 : 2);
12640     }
12641 
12642     CXXMemberCallExpr *call
12643       = new (Context) CXXMemberCallExpr(Context, MemExprE, Args,
12644                                         resultType, valueKind, RParenLoc);
12645 
12646     if (CheckCallReturnType(proto->getReturnType(), op->getRHS()->getLocStart(),
12647                             call, nullptr))
12648       return ExprError();
12649 
12650     if (ConvertArgumentsForCall(call, op, nullptr, proto, Args, RParenLoc))
12651       return ExprError();
12652 
12653     if (CheckOtherCall(call, proto))
12654       return ExprError();
12655 
12656     return MaybeBindToTemporary(call);
12657   }
12658 
12659   if (isa<CXXPseudoDestructorExpr>(NakedMemExpr))
12660     return new (Context)
12661         CallExpr(Context, MemExprE, Args, Context.VoidTy, VK_RValue, RParenLoc);
12662 
12663   UnbridgedCastsSet UnbridgedCasts;
12664   if (checkArgPlaceholdersForOverload(*this, Args, UnbridgedCasts))
12665     return ExprError();
12666 
12667   MemberExpr *MemExpr;
12668   CXXMethodDecl *Method = nullptr;
12669   DeclAccessPair FoundDecl = DeclAccessPair::make(nullptr, AS_public);
12670   NestedNameSpecifier *Qualifier = nullptr;
12671   if (isa<MemberExpr>(NakedMemExpr)) {
12672     MemExpr = cast<MemberExpr>(NakedMemExpr);
12673     Method = cast<CXXMethodDecl>(MemExpr->getMemberDecl());
12674     FoundDecl = MemExpr->getFoundDecl();
12675     Qualifier = MemExpr->getQualifier();
12676     UnbridgedCasts.restore();
12677   } else {
12678     UnresolvedMemberExpr *UnresExpr = cast<UnresolvedMemberExpr>(NakedMemExpr);
12679     Qualifier = UnresExpr->getQualifier();
12680 
12681     QualType ObjectType = UnresExpr->getBaseType();
12682     Expr::Classification ObjectClassification
12683       = UnresExpr->isArrow()? Expr::Classification::makeSimpleLValue()
12684                             : UnresExpr->getBase()->Classify(Context);
12685 
12686     // Add overload candidates
12687     OverloadCandidateSet CandidateSet(UnresExpr->getMemberLoc(),
12688                                       OverloadCandidateSet::CSK_Normal);
12689 
12690     // FIXME: avoid copy.
12691     TemplateArgumentListInfo TemplateArgsBuffer, *TemplateArgs = nullptr;
12692     if (UnresExpr->hasExplicitTemplateArgs()) {
12693       UnresExpr->copyTemplateArgumentsInto(TemplateArgsBuffer);
12694       TemplateArgs = &TemplateArgsBuffer;
12695     }
12696 
12697     for (UnresolvedMemberExpr::decls_iterator I = UnresExpr->decls_begin(),
12698            E = UnresExpr->decls_end(); I != E; ++I) {
12699 
12700       NamedDecl *Func = *I;
12701       CXXRecordDecl *ActingDC = cast<CXXRecordDecl>(Func->getDeclContext());
12702       if (isa<UsingShadowDecl>(Func))
12703         Func = cast<UsingShadowDecl>(Func)->getTargetDecl();
12704 
12705 
12706       // Microsoft supports direct constructor calls.
12707       if (getLangOpts().MicrosoftExt && isa<CXXConstructorDecl>(Func)) {
12708         AddOverloadCandidate(cast<CXXConstructorDecl>(Func), I.getPair(),
12709                              Args, CandidateSet);
12710       } else if ((Method = dyn_cast<CXXMethodDecl>(Func))) {
12711         // If explicit template arguments were provided, we can't call a
12712         // non-template member function.
12713         if (TemplateArgs)
12714           continue;
12715 
12716         AddMethodCandidate(Method, I.getPair(), ActingDC, ObjectType,
12717                            ObjectClassification, Args, CandidateSet,
12718                            /*SuppressUserConversions=*/false);
12719       } else {
12720         AddMethodTemplateCandidate(
12721             cast<FunctionTemplateDecl>(Func), I.getPair(), ActingDC,
12722             TemplateArgs, ObjectType, ObjectClassification, Args, CandidateSet,
12723             /*SuppressUsedConversions=*/false);
12724       }
12725     }
12726 
12727     DeclarationName DeclName = UnresExpr->getMemberName();
12728 
12729     UnbridgedCasts.restore();
12730 
12731     OverloadCandidateSet::iterator Best;
12732     switch (CandidateSet.BestViableFunction(*this, UnresExpr->getLocStart(),
12733                                             Best)) {
12734     case OR_Success:
12735       Method = cast<CXXMethodDecl>(Best->Function);
12736       FoundDecl = Best->FoundDecl;
12737       CheckUnresolvedMemberAccess(UnresExpr, Best->FoundDecl);
12738       if (DiagnoseUseOfDecl(Best->FoundDecl, UnresExpr->getNameLoc()))
12739         return ExprError();
12740       // If FoundDecl is different from Method (such as if one is a template
12741       // and the other a specialization), make sure DiagnoseUseOfDecl is
12742       // called on both.
12743       // FIXME: This would be more comprehensively addressed by modifying
12744       // DiagnoseUseOfDecl to accept both the FoundDecl and the decl
12745       // being used.
12746       if (Method != FoundDecl.getDecl() &&
12747                       DiagnoseUseOfDecl(Method, UnresExpr->getNameLoc()))
12748         return ExprError();
12749       break;
12750 
12751     case OR_No_Viable_Function:
12752       Diag(UnresExpr->getMemberLoc(),
12753            diag::err_ovl_no_viable_member_function_in_call)
12754         << DeclName << MemExprE->getSourceRange();
12755       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
12756       // FIXME: Leaking incoming expressions!
12757       return ExprError();
12758 
12759     case OR_Ambiguous:
12760       Diag(UnresExpr->getMemberLoc(), diag::err_ovl_ambiguous_member_call)
12761         << DeclName << MemExprE->getSourceRange();
12762       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
12763       // FIXME: Leaking incoming expressions!
12764       return ExprError();
12765 
12766     case OR_Deleted:
12767       Diag(UnresExpr->getMemberLoc(), diag::err_ovl_deleted_member_call)
12768         << Best->Function->isDeleted()
12769         << DeclName
12770         << getDeletedOrUnavailableSuffix(Best->Function)
12771         << MemExprE->getSourceRange();
12772       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
12773       // FIXME: Leaking incoming expressions!
12774       return ExprError();
12775     }
12776 
12777     MemExprE = FixOverloadedFunctionReference(MemExprE, FoundDecl, Method);
12778 
12779     // If overload resolution picked a static member, build a
12780     // non-member call based on that function.
12781     if (Method->isStatic()) {
12782       return BuildResolvedCallExpr(MemExprE, Method, LParenLoc, Args,
12783                                    RParenLoc);
12784     }
12785 
12786     MemExpr = cast<MemberExpr>(MemExprE->IgnoreParens());
12787   }
12788 
12789   QualType ResultType = Method->getReturnType();
12790   ExprValueKind VK = Expr::getValueKindForType(ResultType);
12791   ResultType = ResultType.getNonLValueExprType(Context);
12792 
12793   assert(Method && "Member call to something that isn't a method?");
12794   CXXMemberCallExpr *TheCall =
12795     new (Context) CXXMemberCallExpr(Context, MemExprE, Args,
12796                                     ResultType, VK, RParenLoc);
12797 
12798   // Check for a valid return type.
12799   if (CheckCallReturnType(Method->getReturnType(), MemExpr->getMemberLoc(),
12800                           TheCall, Method))
12801     return ExprError();
12802 
12803   // Convert the object argument (for a non-static member function call).
12804   // We only need to do this if there was actually an overload; otherwise
12805   // it was done at lookup.
12806   if (!Method->isStatic()) {
12807     ExprResult ObjectArg =
12808       PerformObjectArgumentInitialization(MemExpr->getBase(), Qualifier,
12809                                           FoundDecl, Method);
12810     if (ObjectArg.isInvalid())
12811       return ExprError();
12812     MemExpr->setBase(ObjectArg.get());
12813   }
12814 
12815   // Convert the rest of the arguments
12816   const FunctionProtoType *Proto =
12817     Method->getType()->getAs<FunctionProtoType>();
12818   if (ConvertArgumentsForCall(TheCall, MemExpr, Method, Proto, Args,
12819                               RParenLoc))
12820     return ExprError();
12821 
12822   DiagnoseSentinelCalls(Method, LParenLoc, Args);
12823 
12824   if (CheckFunctionCall(Method, TheCall, Proto))
12825     return ExprError();
12826 
12827   // In the case the method to call was not selected by the overloading
12828   // resolution process, we still need to handle the enable_if attribute. Do
12829   // that here, so it will not hide previous -- and more relevant -- errors.
12830   if (auto *MemE = dyn_cast<MemberExpr>(NakedMemExpr)) {
12831     if (const EnableIfAttr *Attr = CheckEnableIf(Method, Args, true)) {
12832       Diag(MemE->getMemberLoc(),
12833            diag::err_ovl_no_viable_member_function_in_call)
12834           << Method << Method->getSourceRange();
12835       Diag(Method->getLocation(),
12836            diag::note_ovl_candidate_disabled_by_function_cond_attr)
12837           << Attr->getCond()->getSourceRange() << Attr->getMessage();
12838       return ExprError();
12839     }
12840   }
12841 
12842   if ((isa<CXXConstructorDecl>(CurContext) ||
12843        isa<CXXDestructorDecl>(CurContext)) &&
12844       TheCall->getMethodDecl()->isPure()) {
12845     const CXXMethodDecl *MD = TheCall->getMethodDecl();
12846 
12847     if (isa<CXXThisExpr>(MemExpr->getBase()->IgnoreParenCasts()) &&
12848         MemExpr->performsVirtualDispatch(getLangOpts())) {
12849       Diag(MemExpr->getLocStart(),
12850            diag::warn_call_to_pure_virtual_member_function_from_ctor_dtor)
12851         << MD->getDeclName() << isa<CXXDestructorDecl>(CurContext)
12852         << MD->getParent()->getDeclName();
12853 
12854       Diag(MD->getLocStart(), diag::note_previous_decl) << MD->getDeclName();
12855       if (getLangOpts().AppleKext)
12856         Diag(MemExpr->getLocStart(),
12857              diag::note_pure_qualified_call_kext)
12858              << MD->getParent()->getDeclName()
12859              << MD->getDeclName();
12860     }
12861   }
12862 
12863   if (CXXDestructorDecl *DD =
12864           dyn_cast<CXXDestructorDecl>(TheCall->getMethodDecl())) {
12865     // a->A::f() doesn't go through the vtable, except in AppleKext mode.
12866     bool CallCanBeVirtual = !MemExpr->hasQualifier() || getLangOpts().AppleKext;
12867     CheckVirtualDtorCall(DD, MemExpr->getLocStart(), /*IsDelete=*/false,
12868                          CallCanBeVirtual, /*WarnOnNonAbstractTypes=*/true,
12869                          MemExpr->getMemberLoc());
12870   }
12871 
12872   return MaybeBindToTemporary(TheCall);
12873 }
12874 
12875 /// BuildCallToObjectOfClassType - Build a call to an object of class
12876 /// type (C++ [over.call.object]), which can end up invoking an
12877 /// overloaded function call operator (@c operator()) or performing a
12878 /// user-defined conversion on the object argument.
12879 ExprResult
12880 Sema::BuildCallToObjectOfClassType(Scope *S, Expr *Obj,
12881                                    SourceLocation LParenLoc,
12882                                    MultiExprArg Args,
12883                                    SourceLocation RParenLoc) {
12884   if (checkPlaceholderForOverload(*this, Obj))
12885     return ExprError();
12886   ExprResult Object = Obj;
12887 
12888   UnbridgedCastsSet UnbridgedCasts;
12889   if (checkArgPlaceholdersForOverload(*this, Args, UnbridgedCasts))
12890     return ExprError();
12891 
12892   assert(Object.get()->getType()->isRecordType() &&
12893          "Requires object type argument");
12894   const RecordType *Record = Object.get()->getType()->getAs<RecordType>();
12895 
12896   // C++ [over.call.object]p1:
12897   //  If the primary-expression E in the function call syntax
12898   //  evaluates to a class object of type "cv T", then the set of
12899   //  candidate functions includes at least the function call
12900   //  operators of T. The function call operators of T are obtained by
12901   //  ordinary lookup of the name operator() in the context of
12902   //  (E).operator().
12903   OverloadCandidateSet CandidateSet(LParenLoc,
12904                                     OverloadCandidateSet::CSK_Operator);
12905   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(OO_Call);
12906 
12907   if (RequireCompleteType(LParenLoc, Object.get()->getType(),
12908                           diag::err_incomplete_object_call, Object.get()))
12909     return true;
12910 
12911   LookupResult R(*this, OpName, LParenLoc, LookupOrdinaryName);
12912   LookupQualifiedName(R, Record->getDecl());
12913   R.suppressDiagnostics();
12914 
12915   for (LookupResult::iterator Oper = R.begin(), OperEnd = R.end();
12916        Oper != OperEnd; ++Oper) {
12917     AddMethodCandidate(Oper.getPair(), Object.get()->getType(),
12918                        Object.get()->Classify(Context), Args, CandidateSet,
12919                        /*SuppressUserConversions=*/false);
12920   }
12921 
12922   // C++ [over.call.object]p2:
12923   //   In addition, for each (non-explicit in C++0x) conversion function
12924   //   declared in T of the form
12925   //
12926   //        operator conversion-type-id () cv-qualifier;
12927   //
12928   //   where cv-qualifier is the same cv-qualification as, or a
12929   //   greater cv-qualification than, cv, and where conversion-type-id
12930   //   denotes the type "pointer to function of (P1,...,Pn) returning
12931   //   R", or the type "reference to pointer to function of
12932   //   (P1,...,Pn) returning R", or the type "reference to function
12933   //   of (P1,...,Pn) returning R", a surrogate call function [...]
12934   //   is also considered as a candidate function. Similarly,
12935   //   surrogate call functions are added to the set of candidate
12936   //   functions for each conversion function declared in an
12937   //   accessible base class provided the function is not hidden
12938   //   within T by another intervening declaration.
12939   const auto &Conversions =
12940       cast<CXXRecordDecl>(Record->getDecl())->getVisibleConversionFunctions();
12941   for (auto I = Conversions.begin(), E = Conversions.end(); I != E; ++I) {
12942     NamedDecl *D = *I;
12943     CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(D->getDeclContext());
12944     if (isa<UsingShadowDecl>(D))
12945       D = cast<UsingShadowDecl>(D)->getTargetDecl();
12946 
12947     // Skip over templated conversion functions; they aren't
12948     // surrogates.
12949     if (isa<FunctionTemplateDecl>(D))
12950       continue;
12951 
12952     CXXConversionDecl *Conv = cast<CXXConversionDecl>(D);
12953     if (!Conv->isExplicit()) {
12954       // Strip the reference type (if any) and then the pointer type (if
12955       // any) to get down to what might be a function type.
12956       QualType ConvType = Conv->getConversionType().getNonReferenceType();
12957       if (const PointerType *ConvPtrType = ConvType->getAs<PointerType>())
12958         ConvType = ConvPtrType->getPointeeType();
12959 
12960       if (const FunctionProtoType *Proto = ConvType->getAs<FunctionProtoType>())
12961       {
12962         AddSurrogateCandidate(Conv, I.getPair(), ActingContext, Proto,
12963                               Object.get(), Args, CandidateSet);
12964       }
12965     }
12966   }
12967 
12968   bool HadMultipleCandidates = (CandidateSet.size() > 1);
12969 
12970   // Perform overload resolution.
12971   OverloadCandidateSet::iterator Best;
12972   switch (CandidateSet.BestViableFunction(*this, Object.get()->getLocStart(),
12973                                           Best)) {
12974   case OR_Success:
12975     // Overload resolution succeeded; we'll build the appropriate call
12976     // below.
12977     break;
12978 
12979   case OR_No_Viable_Function:
12980     if (CandidateSet.empty())
12981       Diag(Object.get()->getLocStart(), diag::err_ovl_no_oper)
12982         << Object.get()->getType() << /*call*/ 1
12983         << Object.get()->getSourceRange();
12984     else
12985       Diag(Object.get()->getLocStart(),
12986            diag::err_ovl_no_viable_object_call)
12987         << Object.get()->getType() << Object.get()->getSourceRange();
12988     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
12989     break;
12990 
12991   case OR_Ambiguous:
12992     Diag(Object.get()->getLocStart(),
12993          diag::err_ovl_ambiguous_object_call)
12994       << Object.get()->getType() << Object.get()->getSourceRange();
12995     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args);
12996     break;
12997 
12998   case OR_Deleted:
12999     Diag(Object.get()->getLocStart(),
13000          diag::err_ovl_deleted_object_call)
13001       << Best->Function->isDeleted()
13002       << Object.get()->getType()
13003       << getDeletedOrUnavailableSuffix(Best->Function)
13004       << Object.get()->getSourceRange();
13005     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
13006     break;
13007   }
13008 
13009   if (Best == CandidateSet.end())
13010     return true;
13011 
13012   UnbridgedCasts.restore();
13013 
13014   if (Best->Function == nullptr) {
13015     // Since there is no function declaration, this is one of the
13016     // surrogate candidates. Dig out the conversion function.
13017     CXXConversionDecl *Conv
13018       = cast<CXXConversionDecl>(
13019                          Best->Conversions[0].UserDefined.ConversionFunction);
13020 
13021     CheckMemberOperatorAccess(LParenLoc, Object.get(), nullptr,
13022                               Best->FoundDecl);
13023     if (DiagnoseUseOfDecl(Best->FoundDecl, LParenLoc))
13024       return ExprError();
13025     assert(Conv == Best->FoundDecl.getDecl() &&
13026              "Found Decl & conversion-to-functionptr should be same, right?!");
13027     // We selected one of the surrogate functions that converts the
13028     // object parameter to a function pointer. Perform the conversion
13029     // on the object argument, then let ActOnCallExpr finish the job.
13030 
13031     // Create an implicit member expr to refer to the conversion operator.
13032     // and then call it.
13033     ExprResult Call = BuildCXXMemberCallExpr(Object.get(), Best->FoundDecl,
13034                                              Conv, HadMultipleCandidates);
13035     if (Call.isInvalid())
13036       return ExprError();
13037     // Record usage of conversion in an implicit cast.
13038     Call = ImplicitCastExpr::Create(Context, Call.get()->getType(),
13039                                     CK_UserDefinedConversion, Call.get(),
13040                                     nullptr, VK_RValue);
13041 
13042     return ActOnCallExpr(S, Call.get(), LParenLoc, Args, RParenLoc);
13043   }
13044 
13045   CheckMemberOperatorAccess(LParenLoc, Object.get(), nullptr, Best->FoundDecl);
13046 
13047   // We found an overloaded operator(). Build a CXXOperatorCallExpr
13048   // that calls this method, using Object for the implicit object
13049   // parameter and passing along the remaining arguments.
13050   CXXMethodDecl *Method = cast<CXXMethodDecl>(Best->Function);
13051 
13052   // An error diagnostic has already been printed when parsing the declaration.
13053   if (Method->isInvalidDecl())
13054     return ExprError();
13055 
13056   const FunctionProtoType *Proto =
13057     Method->getType()->getAs<FunctionProtoType>();
13058 
13059   unsigned NumParams = Proto->getNumParams();
13060 
13061   DeclarationNameInfo OpLocInfo(
13062                Context.DeclarationNames.getCXXOperatorName(OO_Call), LParenLoc);
13063   OpLocInfo.setCXXOperatorNameRange(SourceRange(LParenLoc, RParenLoc));
13064   ExprResult NewFn = CreateFunctionRefExpr(*this, Method, Best->FoundDecl,
13065                                            Obj, HadMultipleCandidates,
13066                                            OpLocInfo.getLoc(),
13067                                            OpLocInfo.getInfo());
13068   if (NewFn.isInvalid())
13069     return true;
13070 
13071   // Build the full argument list for the method call (the implicit object
13072   // parameter is placed at the beginning of the list).
13073   SmallVector<Expr *, 8> MethodArgs(Args.size() + 1);
13074   MethodArgs[0] = Object.get();
13075   std::copy(Args.begin(), Args.end(), MethodArgs.begin() + 1);
13076 
13077   // Once we've built TheCall, all of the expressions are properly
13078   // owned.
13079   QualType ResultTy = Method->getReturnType();
13080   ExprValueKind VK = Expr::getValueKindForType(ResultTy);
13081   ResultTy = ResultTy.getNonLValueExprType(Context);
13082 
13083   CXXOperatorCallExpr *TheCall = new (Context)
13084       CXXOperatorCallExpr(Context, OO_Call, NewFn.get(), MethodArgs, ResultTy,
13085                           VK, RParenLoc, FPOptions());
13086 
13087   if (CheckCallReturnType(Method->getReturnType(), LParenLoc, TheCall, Method))
13088     return true;
13089 
13090   // We may have default arguments. If so, we need to allocate more
13091   // slots in the call for them.
13092   if (Args.size() < NumParams)
13093     TheCall->setNumArgs(Context, NumParams + 1);
13094 
13095   bool IsError = false;
13096 
13097   // Initialize the implicit object parameter.
13098   ExprResult ObjRes =
13099     PerformObjectArgumentInitialization(Object.get(), /*Qualifier=*/nullptr,
13100                                         Best->FoundDecl, Method);
13101   if (ObjRes.isInvalid())
13102     IsError = true;
13103   else
13104     Object = ObjRes;
13105   TheCall->setArg(0, Object.get());
13106 
13107   // Check the argument types.
13108   for (unsigned i = 0; i != NumParams; i++) {
13109     Expr *Arg;
13110     if (i < Args.size()) {
13111       Arg = Args[i];
13112 
13113       // Pass the argument.
13114 
13115       ExprResult InputInit
13116         = PerformCopyInitialization(InitializedEntity::InitializeParameter(
13117                                                     Context,
13118                                                     Method->getParamDecl(i)),
13119                                     SourceLocation(), Arg);
13120 
13121       IsError |= InputInit.isInvalid();
13122       Arg = InputInit.getAs<Expr>();
13123     } else {
13124       ExprResult DefArg
13125         = BuildCXXDefaultArgExpr(LParenLoc, Method, Method->getParamDecl(i));
13126       if (DefArg.isInvalid()) {
13127         IsError = true;
13128         break;
13129       }
13130 
13131       Arg = DefArg.getAs<Expr>();
13132     }
13133 
13134     TheCall->setArg(i + 1, Arg);
13135   }
13136 
13137   // If this is a variadic call, handle args passed through "...".
13138   if (Proto->isVariadic()) {
13139     // Promote the arguments (C99 6.5.2.2p7).
13140     for (unsigned i = NumParams, e = Args.size(); i < e; i++) {
13141       ExprResult Arg = DefaultVariadicArgumentPromotion(Args[i], VariadicMethod,
13142                                                         nullptr);
13143       IsError |= Arg.isInvalid();
13144       TheCall->setArg(i + 1, Arg.get());
13145     }
13146   }
13147 
13148   if (IsError) return true;
13149 
13150   DiagnoseSentinelCalls(Method, LParenLoc, Args);
13151 
13152   if (CheckFunctionCall(Method, TheCall, Proto))
13153     return true;
13154 
13155   return MaybeBindToTemporary(TheCall);
13156 }
13157 
13158 /// BuildOverloadedArrowExpr - Build a call to an overloaded @c operator->
13159 ///  (if one exists), where @c Base is an expression of class type and
13160 /// @c Member is the name of the member we're trying to find.
13161 ExprResult
13162 Sema::BuildOverloadedArrowExpr(Scope *S, Expr *Base, SourceLocation OpLoc,
13163                                bool *NoArrowOperatorFound) {
13164   assert(Base->getType()->isRecordType() &&
13165          "left-hand side must have class type");
13166 
13167   if (checkPlaceholderForOverload(*this, Base))
13168     return ExprError();
13169 
13170   SourceLocation Loc = Base->getExprLoc();
13171 
13172   // C++ [over.ref]p1:
13173   //
13174   //   [...] An expression x->m is interpreted as (x.operator->())->m
13175   //   for a class object x of type T if T::operator->() exists and if
13176   //   the operator is selected as the best match function by the
13177   //   overload resolution mechanism (13.3).
13178   DeclarationName OpName =
13179     Context.DeclarationNames.getCXXOperatorName(OO_Arrow);
13180   OverloadCandidateSet CandidateSet(Loc, OverloadCandidateSet::CSK_Operator);
13181   const RecordType *BaseRecord = Base->getType()->getAs<RecordType>();
13182 
13183   if (RequireCompleteType(Loc, Base->getType(),
13184                           diag::err_typecheck_incomplete_tag, Base))
13185     return ExprError();
13186 
13187   LookupResult R(*this, OpName, OpLoc, LookupOrdinaryName);
13188   LookupQualifiedName(R, BaseRecord->getDecl());
13189   R.suppressDiagnostics();
13190 
13191   for (LookupResult::iterator Oper = R.begin(), OperEnd = R.end();
13192        Oper != OperEnd; ++Oper) {
13193     AddMethodCandidate(Oper.getPair(), Base->getType(), Base->Classify(Context),
13194                        None, CandidateSet, /*SuppressUserConversions=*/false);
13195   }
13196 
13197   bool HadMultipleCandidates = (CandidateSet.size() > 1);
13198 
13199   // Perform overload resolution.
13200   OverloadCandidateSet::iterator Best;
13201   switch (CandidateSet.BestViableFunction(*this, OpLoc, Best)) {
13202   case OR_Success:
13203     // Overload resolution succeeded; we'll build the call below.
13204     break;
13205 
13206   case OR_No_Viable_Function:
13207     if (CandidateSet.empty()) {
13208       QualType BaseType = Base->getType();
13209       if (NoArrowOperatorFound) {
13210         // Report this specific error to the caller instead of emitting a
13211         // diagnostic, as requested.
13212         *NoArrowOperatorFound = true;
13213         return ExprError();
13214       }
13215       Diag(OpLoc, diag::err_typecheck_member_reference_arrow)
13216         << BaseType << Base->getSourceRange();
13217       if (BaseType->isRecordType() && !BaseType->isPointerType()) {
13218         Diag(OpLoc, diag::note_typecheck_member_reference_suggestion)
13219           << FixItHint::CreateReplacement(OpLoc, ".");
13220       }
13221     } else
13222       Diag(OpLoc, diag::err_ovl_no_viable_oper)
13223         << "operator->" << Base->getSourceRange();
13224     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Base);
13225     return ExprError();
13226 
13227   case OR_Ambiguous:
13228     Diag(OpLoc,  diag::err_ovl_ambiguous_oper_unary)
13229       << "->" << Base->getType() << Base->getSourceRange();
13230     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Base);
13231     return ExprError();
13232 
13233   case OR_Deleted:
13234     Diag(OpLoc,  diag::err_ovl_deleted_oper)
13235       << Best->Function->isDeleted()
13236       << "->"
13237       << getDeletedOrUnavailableSuffix(Best->Function)
13238       << Base->getSourceRange();
13239     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Base);
13240     return ExprError();
13241   }
13242 
13243   CheckMemberOperatorAccess(OpLoc, Base, nullptr, Best->FoundDecl);
13244 
13245   // Convert the object parameter.
13246   CXXMethodDecl *Method = cast<CXXMethodDecl>(Best->Function);
13247   ExprResult BaseResult =
13248     PerformObjectArgumentInitialization(Base, /*Qualifier=*/nullptr,
13249                                         Best->FoundDecl, Method);
13250   if (BaseResult.isInvalid())
13251     return ExprError();
13252   Base = BaseResult.get();
13253 
13254   // Build the operator call.
13255   ExprResult FnExpr = CreateFunctionRefExpr(*this, Method, Best->FoundDecl,
13256                                             Base, HadMultipleCandidates, OpLoc);
13257   if (FnExpr.isInvalid())
13258     return ExprError();
13259 
13260   QualType ResultTy = Method->getReturnType();
13261   ExprValueKind VK = Expr::getValueKindForType(ResultTy);
13262   ResultTy = ResultTy.getNonLValueExprType(Context);
13263   CXXOperatorCallExpr *TheCall =
13264     new (Context) CXXOperatorCallExpr(Context, OO_Arrow, FnExpr.get(),
13265                                       Base, ResultTy, VK, OpLoc, FPOptions());
13266 
13267   if (CheckCallReturnType(Method->getReturnType(), OpLoc, TheCall, Method))
13268     return ExprError();
13269 
13270   if (CheckFunctionCall(Method, TheCall,
13271                         Method->getType()->castAs<FunctionProtoType>()))
13272     return ExprError();
13273 
13274   return MaybeBindToTemporary(TheCall);
13275 }
13276 
13277 /// BuildLiteralOperatorCall - Build a UserDefinedLiteral by creating a call to
13278 /// a literal operator described by the provided lookup results.
13279 ExprResult Sema::BuildLiteralOperatorCall(LookupResult &R,
13280                                           DeclarationNameInfo &SuffixInfo,
13281                                           ArrayRef<Expr*> Args,
13282                                           SourceLocation LitEndLoc,
13283                                        TemplateArgumentListInfo *TemplateArgs) {
13284   SourceLocation UDSuffixLoc = SuffixInfo.getCXXLiteralOperatorNameLoc();
13285 
13286   OverloadCandidateSet CandidateSet(UDSuffixLoc,
13287                                     OverloadCandidateSet::CSK_Normal);
13288   AddFunctionCandidates(R.asUnresolvedSet(), Args, CandidateSet, TemplateArgs,
13289                         /*SuppressUserConversions=*/true);
13290 
13291   bool HadMultipleCandidates = (CandidateSet.size() > 1);
13292 
13293   // Perform overload resolution. This will usually be trivial, but might need
13294   // to perform substitutions for a literal operator template.
13295   OverloadCandidateSet::iterator Best;
13296   switch (CandidateSet.BestViableFunction(*this, UDSuffixLoc, Best)) {
13297   case OR_Success:
13298   case OR_Deleted:
13299     break;
13300 
13301   case OR_No_Viable_Function:
13302     Diag(UDSuffixLoc, diag::err_ovl_no_viable_function_in_call)
13303       << R.getLookupName();
13304     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
13305     return ExprError();
13306 
13307   case OR_Ambiguous:
13308     Diag(R.getNameLoc(), diag::err_ovl_ambiguous_call) << R.getLookupName();
13309     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args);
13310     return ExprError();
13311   }
13312 
13313   FunctionDecl *FD = Best->Function;
13314   ExprResult Fn = CreateFunctionRefExpr(*this, FD, Best->FoundDecl,
13315                                         nullptr, HadMultipleCandidates,
13316                                         SuffixInfo.getLoc(),
13317                                         SuffixInfo.getInfo());
13318   if (Fn.isInvalid())
13319     return true;
13320 
13321   // Check the argument types. This should almost always be a no-op, except
13322   // that array-to-pointer decay is applied to string literals.
13323   Expr *ConvArgs[2];
13324   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
13325     ExprResult InputInit = PerformCopyInitialization(
13326       InitializedEntity::InitializeParameter(Context, FD->getParamDecl(ArgIdx)),
13327       SourceLocation(), Args[ArgIdx]);
13328     if (InputInit.isInvalid())
13329       return true;
13330     ConvArgs[ArgIdx] = InputInit.get();
13331   }
13332 
13333   QualType ResultTy = FD->getReturnType();
13334   ExprValueKind VK = Expr::getValueKindForType(ResultTy);
13335   ResultTy = ResultTy.getNonLValueExprType(Context);
13336 
13337   UserDefinedLiteral *UDL =
13338     new (Context) UserDefinedLiteral(Context, Fn.get(),
13339                                      llvm::makeArrayRef(ConvArgs, Args.size()),
13340                                      ResultTy, VK, LitEndLoc, UDSuffixLoc);
13341 
13342   if (CheckCallReturnType(FD->getReturnType(), UDSuffixLoc, UDL, FD))
13343     return ExprError();
13344 
13345   if (CheckFunctionCall(FD, UDL, nullptr))
13346     return ExprError();
13347 
13348   return MaybeBindToTemporary(UDL);
13349 }
13350 
13351 /// Build a call to 'begin' or 'end' for a C++11 for-range statement. If the
13352 /// given LookupResult is non-empty, it is assumed to describe a member which
13353 /// will be invoked. Otherwise, the function will be found via argument
13354 /// dependent lookup.
13355 /// CallExpr is set to a valid expression and FRS_Success returned on success,
13356 /// otherwise CallExpr is set to ExprError() and some non-success value
13357 /// is returned.
13358 Sema::ForRangeStatus
13359 Sema::BuildForRangeBeginEndCall(SourceLocation Loc,
13360                                 SourceLocation RangeLoc,
13361                                 const DeclarationNameInfo &NameInfo,
13362                                 LookupResult &MemberLookup,
13363                                 OverloadCandidateSet *CandidateSet,
13364                                 Expr *Range, ExprResult *CallExpr) {
13365   Scope *S = nullptr;
13366 
13367   CandidateSet->clear(OverloadCandidateSet::CSK_Normal);
13368   if (!MemberLookup.empty()) {
13369     ExprResult MemberRef =
13370         BuildMemberReferenceExpr(Range, Range->getType(), Loc,
13371                                  /*IsPtr=*/false, CXXScopeSpec(),
13372                                  /*TemplateKWLoc=*/SourceLocation(),
13373                                  /*FirstQualifierInScope=*/nullptr,
13374                                  MemberLookup,
13375                                  /*TemplateArgs=*/nullptr, S);
13376     if (MemberRef.isInvalid()) {
13377       *CallExpr = ExprError();
13378       return FRS_DiagnosticIssued;
13379     }
13380     *CallExpr = ActOnCallExpr(S, MemberRef.get(), Loc, None, Loc, nullptr);
13381     if (CallExpr->isInvalid()) {
13382       *CallExpr = ExprError();
13383       return FRS_DiagnosticIssued;
13384     }
13385   } else {
13386     UnresolvedSet<0> FoundNames;
13387     UnresolvedLookupExpr *Fn =
13388       UnresolvedLookupExpr::Create(Context, /*NamingClass=*/nullptr,
13389                                    NestedNameSpecifierLoc(), NameInfo,
13390                                    /*NeedsADL=*/true, /*Overloaded=*/false,
13391                                    FoundNames.begin(), FoundNames.end());
13392 
13393     bool CandidateSetError = buildOverloadedCallSet(S, Fn, Fn, Range, Loc,
13394                                                     CandidateSet, CallExpr);
13395     if (CandidateSet->empty() || CandidateSetError) {
13396       *CallExpr = ExprError();
13397       return FRS_NoViableFunction;
13398     }
13399     OverloadCandidateSet::iterator Best;
13400     OverloadingResult OverloadResult =
13401         CandidateSet->BestViableFunction(*this, Fn->getLocStart(), Best);
13402 
13403     if (OverloadResult == OR_No_Viable_Function) {
13404       *CallExpr = ExprError();
13405       return FRS_NoViableFunction;
13406     }
13407     *CallExpr = FinishOverloadedCallExpr(*this, S, Fn, Fn, Loc, Range,
13408                                          Loc, nullptr, CandidateSet, &Best,
13409                                          OverloadResult,
13410                                          /*AllowTypoCorrection=*/false);
13411     if (CallExpr->isInvalid() || OverloadResult != OR_Success) {
13412       *CallExpr = ExprError();
13413       return FRS_DiagnosticIssued;
13414     }
13415   }
13416   return FRS_Success;
13417 }
13418 
13419 
13420 /// FixOverloadedFunctionReference - E is an expression that refers to
13421 /// a C++ overloaded function (possibly with some parentheses and
13422 /// perhaps a '&' around it). We have resolved the overloaded function
13423 /// to the function declaration Fn, so patch up the expression E to
13424 /// refer (possibly indirectly) to Fn. Returns the new expr.
13425 Expr *Sema::FixOverloadedFunctionReference(Expr *E, DeclAccessPair Found,
13426                                            FunctionDecl *Fn) {
13427   if (ParenExpr *PE = dyn_cast<ParenExpr>(E)) {
13428     Expr *SubExpr = FixOverloadedFunctionReference(PE->getSubExpr(),
13429                                                    Found, Fn);
13430     if (SubExpr == PE->getSubExpr())
13431       return PE;
13432 
13433     return new (Context) ParenExpr(PE->getLParen(), PE->getRParen(), SubExpr);
13434   }
13435 
13436   if (ImplicitCastExpr *ICE = dyn_cast<ImplicitCastExpr>(E)) {
13437     Expr *SubExpr = FixOverloadedFunctionReference(ICE->getSubExpr(),
13438                                                    Found, Fn);
13439     assert(Context.hasSameType(ICE->getSubExpr()->getType(),
13440                                SubExpr->getType()) &&
13441            "Implicit cast type cannot be determined from overload");
13442     assert(ICE->path_empty() && "fixing up hierarchy conversion?");
13443     if (SubExpr == ICE->getSubExpr())
13444       return ICE;
13445 
13446     return ImplicitCastExpr::Create(Context, ICE->getType(),
13447                                     ICE->getCastKind(),
13448                                     SubExpr, nullptr,
13449                                     ICE->getValueKind());
13450   }
13451 
13452   if (auto *GSE = dyn_cast<GenericSelectionExpr>(E)) {
13453     if (!GSE->isResultDependent()) {
13454       Expr *SubExpr =
13455           FixOverloadedFunctionReference(GSE->getResultExpr(), Found, Fn);
13456       if (SubExpr == GSE->getResultExpr())
13457         return GSE;
13458 
13459       // Replace the resulting type information before rebuilding the generic
13460       // selection expression.
13461       ArrayRef<Expr *> A = GSE->getAssocExprs();
13462       SmallVector<Expr *, 4> AssocExprs(A.begin(), A.end());
13463       unsigned ResultIdx = GSE->getResultIndex();
13464       AssocExprs[ResultIdx] = SubExpr;
13465 
13466       return new (Context) GenericSelectionExpr(
13467           Context, GSE->getGenericLoc(), GSE->getControllingExpr(),
13468           GSE->getAssocTypeSourceInfos(), AssocExprs, GSE->getDefaultLoc(),
13469           GSE->getRParenLoc(), GSE->containsUnexpandedParameterPack(),
13470           ResultIdx);
13471     }
13472     // Rather than fall through to the unreachable, return the original generic
13473     // selection expression.
13474     return GSE;
13475   }
13476 
13477   if (UnaryOperator *UnOp = dyn_cast<UnaryOperator>(E)) {
13478     assert(UnOp->getOpcode() == UO_AddrOf &&
13479            "Can only take the address of an overloaded function");
13480     if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn)) {
13481       if (Method->isStatic()) {
13482         // Do nothing: static member functions aren't any different
13483         // from non-member functions.
13484       } else {
13485         // Fix the subexpression, which really has to be an
13486         // UnresolvedLookupExpr holding an overloaded member function
13487         // or template.
13488         Expr *SubExpr = FixOverloadedFunctionReference(UnOp->getSubExpr(),
13489                                                        Found, Fn);
13490         if (SubExpr == UnOp->getSubExpr())
13491           return UnOp;
13492 
13493         assert(isa<DeclRefExpr>(SubExpr)
13494                && "fixed to something other than a decl ref");
13495         assert(cast<DeclRefExpr>(SubExpr)->getQualifier()
13496                && "fixed to a member ref with no nested name qualifier");
13497 
13498         // We have taken the address of a pointer to member
13499         // function. Perform the computation here so that we get the
13500         // appropriate pointer to member type.
13501         QualType ClassType
13502           = Context.getTypeDeclType(cast<RecordDecl>(Method->getDeclContext()));
13503         QualType MemPtrType
13504           = Context.getMemberPointerType(Fn->getType(), ClassType.getTypePtr());
13505         // Under the MS ABI, lock down the inheritance model now.
13506         if (Context.getTargetInfo().getCXXABI().isMicrosoft())
13507           (void)isCompleteType(UnOp->getOperatorLoc(), MemPtrType);
13508 
13509         return new (Context) UnaryOperator(SubExpr, UO_AddrOf, MemPtrType,
13510                                            VK_RValue, OK_Ordinary,
13511                                            UnOp->getOperatorLoc());
13512       }
13513     }
13514     Expr *SubExpr = FixOverloadedFunctionReference(UnOp->getSubExpr(),
13515                                                    Found, Fn);
13516     if (SubExpr == UnOp->getSubExpr())
13517       return UnOp;
13518 
13519     return new (Context) UnaryOperator(SubExpr, UO_AddrOf,
13520                                      Context.getPointerType(SubExpr->getType()),
13521                                        VK_RValue, OK_Ordinary,
13522                                        UnOp->getOperatorLoc());
13523   }
13524 
13525   // C++ [except.spec]p17:
13526   //   An exception-specification is considered to be needed when:
13527   //   - in an expression the function is the unique lookup result or the
13528   //     selected member of a set of overloaded functions
13529   if (auto *FPT = Fn->getType()->getAs<FunctionProtoType>())
13530     ResolveExceptionSpec(E->getExprLoc(), FPT);
13531 
13532   if (UnresolvedLookupExpr *ULE = dyn_cast<UnresolvedLookupExpr>(E)) {
13533     // FIXME: avoid copy.
13534     TemplateArgumentListInfo TemplateArgsBuffer, *TemplateArgs = nullptr;
13535     if (ULE->hasExplicitTemplateArgs()) {
13536       ULE->copyTemplateArgumentsInto(TemplateArgsBuffer);
13537       TemplateArgs = &TemplateArgsBuffer;
13538     }
13539 
13540     DeclRefExpr *DRE = DeclRefExpr::Create(Context,
13541                                            ULE->getQualifierLoc(),
13542                                            ULE->getTemplateKeywordLoc(),
13543                                            Fn,
13544                                            /*enclosing*/ false, // FIXME?
13545                                            ULE->getNameLoc(),
13546                                            Fn->getType(),
13547                                            VK_LValue,
13548                                            Found.getDecl(),
13549                                            TemplateArgs);
13550     MarkDeclRefReferenced(DRE);
13551     DRE->setHadMultipleCandidates(ULE->getNumDecls() > 1);
13552     return DRE;
13553   }
13554 
13555   if (UnresolvedMemberExpr *MemExpr = dyn_cast<UnresolvedMemberExpr>(E)) {
13556     // FIXME: avoid copy.
13557     TemplateArgumentListInfo TemplateArgsBuffer, *TemplateArgs = nullptr;
13558     if (MemExpr->hasExplicitTemplateArgs()) {
13559       MemExpr->copyTemplateArgumentsInto(TemplateArgsBuffer);
13560       TemplateArgs = &TemplateArgsBuffer;
13561     }
13562 
13563     Expr *Base;
13564 
13565     // If we're filling in a static method where we used to have an
13566     // implicit member access, rewrite to a simple decl ref.
13567     if (MemExpr->isImplicitAccess()) {
13568       if (cast<CXXMethodDecl>(Fn)->isStatic()) {
13569         DeclRefExpr *DRE = DeclRefExpr::Create(Context,
13570                                                MemExpr->getQualifierLoc(),
13571                                                MemExpr->getTemplateKeywordLoc(),
13572                                                Fn,
13573                                                /*enclosing*/ false,
13574                                                MemExpr->getMemberLoc(),
13575                                                Fn->getType(),
13576                                                VK_LValue,
13577                                                Found.getDecl(),
13578                                                TemplateArgs);
13579         MarkDeclRefReferenced(DRE);
13580         DRE->setHadMultipleCandidates(MemExpr->getNumDecls() > 1);
13581         return DRE;
13582       } else {
13583         SourceLocation Loc = MemExpr->getMemberLoc();
13584         if (MemExpr->getQualifier())
13585           Loc = MemExpr->getQualifierLoc().getBeginLoc();
13586         CheckCXXThisCapture(Loc);
13587         Base = new (Context) CXXThisExpr(Loc,
13588                                          MemExpr->getBaseType(),
13589                                          /*isImplicit=*/true);
13590       }
13591     } else
13592       Base = MemExpr->getBase();
13593 
13594     ExprValueKind valueKind;
13595     QualType type;
13596     if (cast<CXXMethodDecl>(Fn)->isStatic()) {
13597       valueKind = VK_LValue;
13598       type = Fn->getType();
13599     } else {
13600       valueKind = VK_RValue;
13601       type = Context.BoundMemberTy;
13602     }
13603 
13604     MemberExpr *ME = MemberExpr::Create(
13605         Context, Base, MemExpr->isArrow(), MemExpr->getOperatorLoc(),
13606         MemExpr->getQualifierLoc(), MemExpr->getTemplateKeywordLoc(), Fn, Found,
13607         MemExpr->getMemberNameInfo(), TemplateArgs, type, valueKind,
13608         OK_Ordinary);
13609     ME->setHadMultipleCandidates(true);
13610     MarkMemberReferenced(ME);
13611     return ME;
13612   }
13613 
13614   llvm_unreachable("Invalid reference to overloaded function");
13615 }
13616 
13617 ExprResult Sema::FixOverloadedFunctionReference(ExprResult E,
13618                                                 DeclAccessPair Found,
13619                                                 FunctionDecl *Fn) {
13620   return FixOverloadedFunctionReference(E.get(), Found, Fn);
13621 }
13622